Sclm Manual

Version 4 of ISPF and SCLMAn Implementation Guide

Document Number GG24-4407-00

September 1994

International Technical Support OrganizationPoughkeepsie Center

Take Note!

Before using this information and the product it supports, be sure to read the general information underSpecial Notices on page xxi.

First Edition (September 1994)This edition applies to Version 4 Release 1 of the licensed program Interactive System Productivity Facility (ISPF)(5655-042) for MVS.Order publications through your IBM representative or the IBM branch office serving your locality. Publicationsare not stocked at the address given below.

An ITSO Technical Bulletin Evaluation Form for reader's feedback appears facing Chapter 1. If the form has beenremoved, comments may be addressed to:

IBM Corporation, International Technical Support OrganizationDept. H52 Mail Station P099522 South RoadPoughkeepsie, New York 12601-5400

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

Copyright International Business Machines Corporation 1994. All rights reserved.Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure issubject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

AbstractThis document is unique in its detailed coverage of the new facilities availablewith Version 4 Release 1 of ISPF. Part 1 is a short introduction. Part 2 isdevoted to the basics of ISPF. Besides a general description of these facilities, itprovides guidance in implementing the various elements of user interfaces indifferent user environments and gives scenarios for installing and starting theGraphical User Interface (GUI) using APPC or TCP/IP with OS2 and CM/2.Part 3 is entirely devoted to SCLM in Version 4 Release 1 and offers an in-depthcoverage of the implementation details whereas the use of SCLM in relation toprogramming activities and disciplines is not considered relevant within theframework of this document and is, therefore, not discussed.

A diskette with examples and a set of transparencies for an SCLM workshop isfound in the back of the book.

The document is written for the experienced system programmer, but also lessexperienced users may get inspiration to use ISPF Version 4 Release 1 in aproductive manner. Some knowledge of ISPF Version 3 Release 5 is, however,assumed.

(312 pages)

Copyright IBM Corp. 1994 iii

iv ISPF/SCLM V4 Guide

ContentsAbstract . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

Special Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiiiHow This Document is Organized . . . . . . . . . . . . . . . . . . . . . . . . xxiiiRelated Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvInternational Technical Support Organization Publications . . . . . . . . . . . xxvAcknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi

Part 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Part 2. ISPF Version 4 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 1. Technical Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.1 New Functions in ISPF Version 4 Release 1 . . . . . . . . . . . . . . . . . . 51.2 Usability Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2.1 ISPF Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.1.1 Settings panel Action bars . . . . . . . . . . . . . . . . . . . . . . . 61.2.1.2 Jump from Leader Dots . . . . . . . . . . . . . . . . . . . . . . . . . 71.2.1.3 Edit PRINTDS Command . . . . . . . . . . . . . . . . . . . . . . . . 71.2.1.4 Action Bar Pull-downs . . . . . . . . . . . . . . . . . . . . . . . . . . 81.2.1.5 Point & Shoot Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.2.1.6 Long Message in Pop-Up . . . . . . . . . . . . . . . . . . . . . . . . 9

1.2.2 Member Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.2.3 Reflists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.2.4 The View Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.2.4.1 Using the Create and Replace Commands . . . . . . . . . . . . . 141.2.5 Color Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

1.2.5.1 Edit Hilite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.2.5.2 Language Sensitive Editing . . . . . . . . . . . . . . . . . . . . . . 15

1.2.6 ISPF Command Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.2.7 VSAM Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

1.2.7.1 Building a VSAM Profile Data Set . . . . . . . . . . . . . . . . . . . 221.2.7.2 Using a VSAM Profile Data Set . . . . . . . . . . . . . . . . . . . . 231.2.7.3 Changing the VSAM Profile Data Set . . . . . . . . . . . . . . . . . 24

1.2.8 Data Set List Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.2.8.1 Usage of Option 3.4 Data Set List . . . . . . . . . . . . . . . . . . . 241.2.8.2 Examples of Dsname Levels . . . . . . . . . . . . . . . . . . . . . . 25

1.2.9 Multivolume Data Set Support . . . . . . . . . . . . . . . . . . . . . . . 271.2.9.1 Usage of Multivolume Data Sets . . . . . . . . . . . . . . . . . . . 281.2.9.2 Hints and Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

1.2.10 Display Message ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291.2.10.1 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

1.2.11 Forward Retrieve and Retrieve Pop-up . . . . . . . . . . . . . . . . . 301.2.11.1 RETF - Forward Retrieve . . . . . . . . . . . . . . . . . . . . . . . 301.2.11.2 RETP - Retrieve Pop-Up . . . . . . . . . . . . . . . . . . . . . . . . 31

1.3 LIBDEF Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321.3.1 LIBDEF Stack Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

1.3.1.1 Command Procedure Format . . . . . . . . . . . . . . . . . . . . . 33

Copyright IBM Corp. 1994 v

1.3.1.2 Call Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331.3.1.3 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331.3.1.4 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

1.3.2 Dialog Query LIBDEF Facility . . . . . . . . . . . . . . . . . . . . . . . . 351.3.2.1 Command Procedure Format . . . . . . . . . . . . . . . . . . . . . 351.3.2.2 Call Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351.3.2.3 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361.3.2.4 Hints and Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

1.3.3 LIBDEF Display Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361.3.3.1 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

1.3.4 LIBDEF Search Order for ISPLLIB . . . . . . . . . . . . . . . . . . . . . 371.4 Graphical User Interface (GUI) Applications with ISPF . . . . . . . . . . . . 37

Chapter 2. User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.1 Action Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

2.1.1 How are the Action Bars Constructed? . . . . . . . . . . . . . . . . . . 392.1.2 Customizing Action Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

2.1.2.1 Removing Action Bars . . . . . . . . . . . . . . . . . . . . . . . . . 422.1.2.2 Changing Action Bars . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.2 Keylists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482.2.1 Using Dialog under SETTINGS . . . . . . . . . . . . . . . . . . . . . . . 492.2.2 Using DTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552.2.3 Global Function Keys Setting . . . . . . . . . . . . . . . . . . . . . . . . 582.2.4 Function Key Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

2.2.4.1 Tailoring Function Key Definition Display . . . . . . . . . . . . . . 592.2.4.2 Display Function Keys in Different Forms . . . . . . . . . . . . . . 60

2.3 Referral Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612.3.1 Creating a Personal Data Set List . . . . . . . . . . . . . . . . . . . . . 632.3.2 Shared List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652.3.3 Fast Path to the Referral List Function . . . . . . . . . . . . . . . . . . 662.3.4 Function Keys for Accessing Referral Lists . . . . . . . . . . . . . . . . 67

2.4 Point-and-Shoot Text Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692.4.1.1 Changing to Noninput Fields . . . . . . . . . . . . . . . . . . . . . . 692.4.1.2 Changing Colors of Point-and-Shoot Fields . . . . . . . . . . . . . 70

2.5 Color Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712.5.1 Colors Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712.5.2 Edit Hilite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

2.5.2.1 Enhanced Edit Coloring . . . . . . . . . . . . . . . . . . . . . . . . . 722.5.2.2 Language Processing Limitation . . . . . . . . . . . . . . . . . . . 742.5.2.3 Turning off the Highlight Features . . . . . . . . . . . . . . . . . . . 742.5.2.4 The HILITE Command/Dialog . . . . . . . . . . . . . . . . . . . . . 74

2.6 Status Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752.6.1 Session and Function Keys Status . . . . . . . . . . . . . . . . . . . . . 762.6.2 Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772.6.3 User Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802.6.4 User Point-and-Shoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812.6.5 None . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

2.7 Modifications to ISPF Objects . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Chapter 3. 3270 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853.1 IBM 3270 Hardware Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . 85

3.1.1 Action Bar Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . 863.1.1.1 Learn New Habits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 873.1.1.2 Remove the Action Bar . . . . . . . . . . . . . . . . . . . . . . . . . 873.1.1.3 Remove Ability to Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 87

vi ISPF/SCLM V4 Guide

3.1.1.4 Placing Command Line at the Top . . . . . . . . . . . . . . . . . . 883.1.1.5 Use F24=CRETRIEVE . . . . . . . . . . . . . . . . . . . . . . . . . . 883.1.1.6 Remove Action Bar from Edit and View . . . . . . . . . . . . . . . 88

3.1.2 Point & Shoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883.1.3 PF Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

3.2 IBM 3270 OS/2 - CM/2 Emulated Terminals . . . . . . . . . . . . . . . . . . 893.2.1 CM Mouse with ISPF 4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

3.2.1.1 Using CM Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903.3 CM Mouse BDF and MMM Files . . . . . . . . . . . . . . . . . . . . . . . . . 92

3.3.1.1 Button Definition File, ISPF41.BDF . . . . . . . . . . . . . . . . . . 923.3.1.2 General Mouse Menu, ISPF41.MMM . . . . . . . . . . . . . . . . . 943.3.1.3 Edit and View Mouse Menu, ISPFE41.MMM . . . . . . . . . . . . . 95

Chapter 4. Graphical User Interface (GUI) . . . . . . . . . . . . . . . . . . . . . 974.1.1 How to Use this Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

4.1.1.1 Support Software Limitations . . . . . . . . . . . . . . . . . . . . . 974.2 Getting Ready for GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

4.2.1 Some Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984.2.2 Establishing Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . 98

4.2.2.1 For the Experienced User . . . . . . . . . . . . . . . . . . . . . . . . 984.2.3 IBM TCP/IP for OS/2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994.2.4 APPC for IBM CM/2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

4.2.4.1 On the MVS Host Side . . . . . . . . . . . . . . . . . . . . . . . . 1034.2.4.2 At Your Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . 103

4.2.5 IBM TCP/IP for DOS and Windows . . . . . . . . . . . . . . . . . . . . 1074.3 Downloading GUI to Your Workstation . . . . . . . . . . . . . . . . . . . . 110

4.3.1 Using TCP/IP File Transfer Protocol . . . . . . . . . . . . . . . . . . . 1104.3.2 Alternative download Methods . . . . . . . . . . . . . . . . . . . . . . 112

4.4 Starting the Workstation Server . . . . . . . . . . . . . . . . . . . . . . . . 1124.4.1 OS/2 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

4.4.1.1 Building an Icon for OS/2 . . . . . . . . . . . . . . . . . . . . . . . 1134.4.2 DOS/Windows Environment . . . . . . . . . . . . . . . . . . . . . . . . 114

4.5 Connecting the MVS Host in GUI . . . . . . . . . . . . . . . . . . . . . . . 1144.5.1 From the Ready Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . 1144.5.2 From within ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1154.5.3 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

4.5.3.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1154.5.3.2 TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164.5.3.3 APPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

4.6 Running GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164.6.1 Interacting with GUI Panels . . . . . . . . . . . . . . . . . . . . . . . . 117

4.6.1.1 Host Session Keys Versus PC keys . . . . . . . . . . . . . . . . . 1174.6.1.2 Getting Around . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1174.6.1.3 Residual 3270 Session . . . . . . . . . . . . . . . . . . . . . . . . 1184.6.1.4 Split Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1184.6.1.5 TSO Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1184.6.1.6 Workstation Commands . . . . . . . . . . . . . . . . . . . . . . . . 1184.6.1.7 Window Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1194.6.1.8 GUI Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

4.7 Performance Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1204.7.1 OS/2 Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1204.7.2 DOS/Windows Environment . . . . . . . . . . . . . . . . . . . . . . . . 1204.7.3 Network Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

4.8 ISPF GUI Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1214.8.1 GUI Applications with ISPF? . . . . . . . . . . . . . . . . . . . . . . . . 121

Contents vii

4.8.2 Why Use ISPF C/S for GUI? . . . . . . . . . . . . . . . . . . . . . . . . 1214.8.3 Writing ISPF GUI Applications . . . . . . . . . . . . . . . . . . . . . . . 123

4.8.3.1 Making an Application Display in GUI Mode . . . . . . . . . . . 1234.8.3.2 Specifying the Title Bar Text . . . . . . . . . . . . . . . . . . . . . 1244.8.3.3 GUI Panel Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1254.8.3.4 Window Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1254.8.3.5 Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1264.8.3.6 Enter Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1264.8.3.7 CUA Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1274.8.3.8 Action Bars and Pull-down Menus . . . . . . . . . . . . . . . . . 1284.8.3.9 Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1294.8.3.10 Pop-up Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 1294.8.3.11 Pop-up Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 1294.8.3.12 Push Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1314.8.3.13 Checkboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1334.8.3.14 User-driven Applications . . . . . . . . . . . . . . . . . . . . . . 1344.8.3.15 SELECT WSCMD service . . . . . . . . . . . . . . . . . . . . . . 1354.8.3.16 What is not Supported? . . . . . . . . . . . . . . . . . . . . . . . 136

4.9 Sample GUI Application - Calculator . . . . . . . . . . . . . . . . . . . . . 1364.9.1.1 The CALCDEMO REXX EXEC . . . . . . . . . . . . . . . . . . . . . 1364.9.1.2 The CALCD Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . 1404.9.1.3 The CALCH Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . 1424.9.1.4 The CALCD Panel DTL . . . . . . . . . . . . . . . . . . . . . . . . 1434.9.1.5 The CALCH Panel DTL . . . . . . . . . . . . . . . . . . . . . . . . 145

Chapter 5. Miscellaneous Discussion . . . . . . . . . . . . . . . . . . . . . . . 1475.1 Modifying ISPF Configuration Table (ISRCNFIG) . . . . . . . . . . . . . . 1475.2 ISPF and the Future . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

5.2.1 From Icon to ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1485.2.2 Taming TSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1485.2.3 Splitting Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1495.2.4 Expanding Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Part 3. Software Configuration and Library Manager . . . . . . . . . . . . . . . . . . . . . 151

Chapter 6. SCLM Concepts and Terminology . . . . . . . . . . . . . . . . . . 1536.1.1 Software Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536.1.2 Library Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536.1.3 Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.1.4 Project Definintion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.1.5 Project Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.1.6 Language Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.1.7 Architecture Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.1.8 Build . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556.1.9 Promote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556.1.10 Scope of Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556.1.11 Versioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556.1.12 Component Changes of SCLM 4.1 . . . . . . . . . . . . . . . . . . . 1566.1.13 SCLM Workshop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Chapter 7. Install, Implement and Understand SCLM Product Sample . . . . 1577.1 SCLM Project Manager Scenario . . . . . . . . . . . . . . . . . . . . . . . 157

7.1.1 What the SCLM Project Manager has to Do . . . . . . . . . . . . . . 1587.1.2 Understand the Sample Environment . . . . . . . . . . . . . . . . . . 159

viii ISPF/SCLM V4 Guide

7.1.3 Prepare Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . 1597.1.4 Prepare and Understand the Sample Project . . . . . . . . . . . . . 1607.1.5 Preparing the Example Project Data . . . . . . . . . . . . . . . . . . . 160

7.2 Development Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1617.2.1 Sample Seen from a Developer's Point of View . . . . . . . . . . . . 161

Chapter 8. Project Organization . . . . . . . . . . . . . . . . . . . . . . . . . . 1638.1.1 Security Scheme for Project Data Sets . . . . . . . . . . . . . . . . . 1648.1.2 Alternate Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1658.1.3 Authorization Codes (AC) . . . . . . . . . . . . . . . . . . . . . . . . . 1658.1.4 Data Set Management . . . . . . . . . . . . . . . . . . . . . . . . . . . 1658.1.5 Organization of Production Data Sets . . . . . . . . . . . . . . . . . . 166

8.1.5.1 Solution 1: Enterprise Projects Physically Separated . . . . . . 1668.1.5.2 Solution 2: Enterprise Projects Concatenated . . . . . . . . . . . 1668.1.5.3 Solution 3: One Enterprise Project with many Subprojects . . . 1678.1.5.4 Solution 4: Many Subprojects under one Roof . . . . . . . . . . 1678.1.5.5 Solution 5: Combination of Choice . . . . . . . . . . . . . . . . . 168

8.1.6 Combination of Developer Data Sets . . . . . . . . . . . . . . . . . . 1688.1.6.1 Solution 1: One Group in many SCLM Projects . . . . . . . . . . 1688.1.6.2 Solution 2: One or many Developers in one Group . . . . . . . 169

8.1.7 Hierarchy Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . 1698.1.8 Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

8.1.8.1 Create Project View Prototype . . . . . . . . . . . . . . . . . . . . 171

Chapter 9. Role Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1739.1 Interactive Test - A Must . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

9.1.1.1 SCLM Project Manager . . . . . . . . . . . . . . . . . . . . . . . . 1749.1.1.2 SW Developer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1749.1.1.3 SW Team Leader . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1749.1.1.4 SW Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1749.1.1.5 SW Configurators . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Chapter 10. Method Management . . . . . . . . . . . . . . . . . . . . . . . . . 179

Chapter 11. Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18111.1.1 RACF Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

11.1.1.1 Program Class Protection . . . . . . . . . . . . . . . . . . . . . . 18111.1.2 Authorization Code (AC) - Protection . . . . . . . . . . . . . . . . . . 18111.1.3 Backup Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18211.1.4 ABARS Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . 18311.1.5 Backup Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18311.1.6 Restore Project Data Sets . . . . . . . . . . . . . . . . . . . . . . . . 18311.1.7 Prevention Security Concept . . . . . . . . . . . . . . . . . . . . . . . 184

11.1.7.1 Backup when Promoting to Production . . . . . . . . . . . . . . 18411.1.7.2 Save Previous Release . . . . . . . . . . . . . . . . . . . . . . . 18411.1.7.3 Recover Previous Release . . . . . . . . . . . . . . . . . . . . . 18511.1.7.4 Backup of Changes . . . . . . . . . . . . . . . . . . . . . . . . . . 18611.1.7.5 SCLM Promote-Verify-Exit REXX . . . . . . . . . . . . . . . . . . 18711.1.7.6 Promote-Verify-Exit MET#P11 . . . . . . . . . . . . . . . . . . . . 18711.1.7.7 SCLMISP - Interface to ISPF Services . . . . . . . . . . . . . . . 190

11.1.8 Dual Account and Audit Data Sets . . . . . . . . . . . . . . . . . . . 19011.1.9 Change Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

11.1.9.1 Non-Key Groups for Staging QA Pull-Up . . . . . . . . . . . . . 19111.1.9.2 Use of Primary Non-Key Groups in an SCLM Hierarchy . . . . 192

11.1.10 PDF Edit Outside SCLM . . . . . . . . . . . . . . . . . . . . . . . . . 192

Contents ix

11.1.10.1 PDF Configuration Table for Edit Control . . . . . . . . . . . . 19311.1.10.2 Technical Implementation . . . . . . . . . . . . . . . . . . . . . 193

Chapter 12. Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19512.1 Vertical Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

12.1.1 Development, Maintenance and Fix in Parallel . . . . . . . . . . . . 19512.1.1.1 Fix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

12.1.2 Multiple Releases, Globals, Locals and Maintenance in Parallel . 19712.1.3 Keep Architecture Definitions Separate . . . . . . . . . . . . . . . . 198

12.2 Horizontal Source Versioning . . . . . . . . . . . . . . . . . . . . . . . . . 20012.2.1 Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20012.2.2 Recording the Versioning . . . . . . . . . . . . . . . . . . . . . . . . . 20012.2.3 Retrieve a Recorded/Versioned Part . . . . . . . . . . . . . . . . . . 201

Chapter 13. What is Configuration Management? . . . . . . . . . . . . . . . . 20313.1 Why Configuration Management? . . . . . . . . . . . . . . . . . . . . . . 20313.2 Trends Driving Configuration Management . . . . . . . . . . . . . . . . . 20313.3 Build Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20413.4 Change Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20513.5 Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20513.6 Imperatives for AD Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . 20513.7 SCLM Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20513.8 SCLM Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20613.9 SCLM Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

13.9.1 Access Control and Delimitation . . . . . . . . . . . . . . . . . . . . 20613.9.2 Integrity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20613.9.3 Consistency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20613.9.4 User Exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20613.9.5 Example of a REXX CCV Routine . . . . . . . . . . . . . . . . . . . . 20713.9.6 REXX CCV-Routine in FLMCNTRL . . . . . . . . . . . . . . . . . . . . 20713.9.7 Example of a REXX BUILD Translator . . . . . . . . . . . . . . . . . 20713.9.8 Invocation REXX Procedure from FLMCNTRL Macro . . . . . . . . 209

Chapter 14. Change and Problem Management . . . . . . . . . . . . . . . . . 21114.1.1 Implementation of CCV Example . . . . . . . . . . . . . . . . . . . . 211

Chapter 15. Delivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Chapter 16. Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21516.1 Notification at Promote with TSO Send . . . . . . . . . . . . . . . . . . . 21516.2 SCLM Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21616.3 Check Predecessor Account Data with MET#PRE . . . . . . . . . . . . . 216

Chapter 17. Verification Management . . . . . . . . . . . . . . . . . . . . . . . 21917.1 Verified by Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

17.1.1.1 Promote Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21917.2 Verified by Architecture Definition . . . . . . . . . . . . . . . . . . . . . . 21917.3 Verified by Include Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . 21917.4 Non-SCLM-Verified Include Objects . . . . . . . . . . . . . . . . . . . . . 219

Chapter 18. Meta Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22118.1 Simple Meta-project Implementation . . . . . . . . . . . . . . . . . . . . 22118.2 Create Complex Documentation with REXX MET#XREF . . . . . . . . . 222

18.2.1 REXX MET#XREF to Create Bookmaster Index Tags . . . . . . . . 22318.3 Complex Meta-project Implementation . . . . . . . . . . . . . . . . . . . 227

x ISPF/SCLM V4 Guide

18.3.1 Language Definition ASMPROJ (Member @ASMPRJ) . . . . . . . 22818.3.2 REXX Program MET#B01 to Pack Compile List Output . . . . . . . 22918.3.3 REXX Program MET#B02 to Make Test Project Definition . . . . . 23018.3.4 Language Definition ASMPROJT (Member @ASMPRJT) . . . . . . 23118.3.5 Language Definition LKEDPROJ (Member @LKEDPRJ) . . . . . . . 23218.3.6 REXX Program MET#P21 (Promote-Copy-Exit) to Copy Project

Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23318.3.7 Architecture Definition ASMPROJ - Example . . . . . . . . . . . . . 236

Chapter 19. Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23919.1.1 PDS-E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23919.1.2 Coding with Select Statements . . . . . . . . . . . . . . . . . . . . . 23919.1.3 Submit to Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23919.1.4 Establish an Own Class for Batch Jobs . . . . . . . . . . . . . . . . 23919.1.5 Output Load Module in Non-SCLM Data Set . . . . . . . . . . . . . 239

19.1.5.1 Reason . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23919.1.5.2 Solution 1 - Output Loadmodule with Linkage Editor . . . . . . 24019.1.5.3 Solution 2 - Copy Translator as REXX Procedure . . . . . . . . 24219.1.5.4 Solution 3 - Promote Exit Invocation of IEBCOPY . . . . . . . . 242

19.1.6 Link-edit with Parts from Non-SCLM Data Set . . . . . . . . . . . . 24419.1.7 Block Sizes for Link Editor . . . . . . . . . . . . . . . . . . . . . . . . 244

19.1.7.1 Block Size Override . . . . . . . . . . . . . . . . . . . . . . . . . 24519.1.8 ISPF Option 3.2, BLKSIZE = 0 . . . . . . . . . . . . . . . . . . . . . . 24519.1.9 DASD Management with DFHSM . . . . . . . . . . . . . . . . . . . . 24519.1.10 Single Archdef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24519.1.11 Unwanted Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24519.1.12 VSAM Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . 24619.1.13 Create Dependencies for Calls . . . . . . . . . . . . . . . . . . . . . 247

19.1.13.1 Language Definition @CIC1CPY - Create Copy . . . . . . . . 24719.1.13.2 Archdef to Create COPY from EXEC CICS . . . . . . . . . . . 24719.1.13.3 Input Part WEFP023P Associated with Language CIC1CPY . 24719.1.13.4 Output Part WEFP023 from Language CIC1CPY after Build . 24719.1.13.5 Invocation COPY Member . . . . . . . . . . . . . . . . . . . . . 248

19.2 Language with CICS Preprocessor and Compile List Packing . . . . . 24819.2.1 Architecture Definition Examples . . . . . . . . . . . . . . . . . . . . 248

19.2.1.1 HL Part AQQQQQQQ . . . . . . . . . . . . . . . . . . . . . . . . . 24819.2.1.2 LEC Part LQQQQQQQ for Target Environment CICS . . . . . . 24819.2.1.3 LEC Part MQQQQQQQ for C/370 Prelink (CICS) . . . . . . . . 24819.2.1.4 CC Part QQQQQQQ for Target Environment CICS . . . . . . . 248

19.2.2 Language Definition @LKEDC - Binder for CICS . . . . . . . . . . . 24819.2.3 Language Definition @CPRLK - C Prelink . . . . . . . . . . . . . . . 24919.2.4 Language Definition @CCP - C Precompile/CICS

Translate/Compile/Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Chapter 20. Workstation Connection . . . . . . . . . . . . . . . . . . . . . . . . 25320.1 Workstation for OS/2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25320.2 AD/Cycle WorkStation Platform/2 . . . . . . . . . . . . . . . . . . . . . . 253

20.2.1 New Functions with Release 1.2 . . . . . . . . . . . . . . . . . . . . . 25320.2.1.1 Installation and Maintenance Utility . . . . . . . . . . . . . . . . 25420.2.1.2 Service Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 25420.2.1.3 Mapping File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

20.3 ISPF Version 4.1 Client/Server Front End . . . . . . . . . . . . . . . . . . 25420.4 LAN Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Chapter 21. Diskette Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

Contents xi

21.1.1 Project Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25721.1.2 Language Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . 25721.1.3 REXX Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25821.1.4 Assembler Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . 25821.1.5 Job Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25821.1.6 Architecture Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . 25921.1.7 FOILS in LIST3820 Format . . . . . . . . . . . . . . . . . . . . . . . . 259

Chapter 22. Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26122.1.1 ANSI/IEEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26122.1.2 ISO9000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Chapter 23. SCLM Translator Interfaces . . . . . . . . . . . . . . . . . . . . . 26323.1.1.1 ITIRC KEYWORDS . . . . . . . . . . . . . . . . . . . . . . . . . . 263

23.1.2 Before We Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26323.1.3 Basic Skills . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26323.1.4 FLMTRNSL Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26323.1.5 Conditional Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . 26423.1.6 TSO Address Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26523.1.7 CALLMETH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26523.1.8 FLMALLOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26623.1.9 DDNAME Substitution List . . . . . . . . . . . . . . . . . . . . . . . . 26723.1.10 Refer Back without DDNAME Substitution List . . . . . . . . . . . 26823.1.11 Refer Back with DDNAME Substitution List . . . . . . . . . . . . . 26823.1.12 Refer Back with IEBGENER Bridge . . . . . . . . . . . . . . . . . . 26923.1.13 PORDER and Parameter Lists . . . . . . . . . . . . . . . . . . . . . 270

Chapter 24. Translator Building Blocks, #LANG, #MACLIB, ... . . . . . . . . 273

Chapter 25. SCLM Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28125.1.1 TSO SCLM Batch Job - An Example . . . . . . . . . . . . . . . . . . 28125.1.2 REXX Program with ISPF Variables Example . . . . . . . . . . . . . 282

Chapter 26. Workshop Foils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28526.1 Project Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28526.2 Project Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28626.3 SCLM Project Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28626.4 Partitioned Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28726.5 Data Base Structure for Project prjid . . . . . . . . . . . . . . . . . . . . 28726.6 Define Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28826.7 Define Protection Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . 28826.8 Project Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28926.9 Project View for Parallel Maintenance . . . . . . . . . . . . . . . . . . . 289

26.9.1.1 Concatenation Solution . . . . . . . . . . . . . . . . . . . . . . . 28926.10 Method PLIO - an Example . . . . . . . . . . . . . . . . . . . . . . . . . . 29026.11 Method Example PORDER . . . . . . . . . . . . . . . . . . . . . . . . . . 29026.12 Method Example GOODRC . . . . . . . . . . . . . . . . . . . . . . . . . . 29126.13 Method Example DD STATEMENTS . . . . . . . . . . . . . . . . . . . . . 29126.14 Method Example for Translator MBS . . . . . . . . . . . . . . . . . . . . 29226.15 Method Example for Translator PMO . . . . . . . . . . . . . . . . . . . . 29226.16 Method Example for Translator BHC . . . . . . . . . . . . . . . . . . . . 29326.17 Method Example for Multiple Translators . . . . . . . . . . . . . . . . . 29326.18 Method Example for Translator DEF1 and DEF2 . . . . . . . . . . . . . 29426.19 Method Example for Translator with Parameters . . . . . . . . . . . . 29426.20 Method Example for Translator with Option List . . . . . . . . . . . . . 295

xii ISPF/SCLM V4 Guide

26.21 The Promote Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29526.22 Create / Change a Part . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29626.23 SCLM Edit Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29626.24 Draw Down Part FLM01EQU . . . . . . . . . . . . . . . . . . . . . . . . . 29726.25 Architecture Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29726.26 Some Archdef Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 29826.27 Archdefs of SCLM Sample . . . . . . . . . . . . . . . . . . . . . . . . . . 29826.28 Build an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29926.29 Build of Archdef FLM01SB1 . . . . . . . . . . . . . . . . . . . . . . . . . 30026.30 Build with Plan FLM01AP1 . . . . . . . . . . . . . . . . . . . . . . . . . . 30026.31 Language Definitions Versus Architecture Definitions . . . . . . . . . . 30126.32 PROMOTE an Application . . . . . . . . . . . . . . . . . . . . . . . . . . 30126.33 PROMOTE with Source Part . . . . . . . . . . . . . . . . . . . . . . . . . 30226.34 PROMOTE with Plan FLM01AP1 . . . . . . . . . . . . . . . . . . . . . . . 30226.35 Multiple Releases in Parallel . . . . . . . . . . . . . . . . . . . . . . . . 30326.36 Tips and Conclusions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30326.37 SCLM Invocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30426.38 SCLM Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30426.39 Conversion Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30526.40 Pilot Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30526.41 Authorization Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30526.42 Export / Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30626.43 SCLM and Test Methods - Scenario . . . . . . . . . . . . . . . . . . . . 30626.44 SCLM and Methods with Test Options . . . . . . . . . . . . . . . . . . . 307

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

Contents xiii

xiv ISPF/SCLM V4 Guide

Figures1. ISPF Settings Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62. Local Print Command Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83. Action Bar Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94. Long Message in Pop-Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95. Member Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106. RefList Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117. Reference Data Set List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118. Library List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129. Reference Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

10. View Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1411. View Warning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1412. Edit COBOL Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1613. Edit Color Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1714. Edit Language Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1715. Compilers Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1816. Foreground Selection Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . 1917. ISPF Command Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2018. VSAM Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2119. IDCAMS Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2120. VSAM Panel with Functions Pull-down . . . . . . . . . . . . . . . . . . . . 2221. Profile Member Name Panel . . . . . . . . . . . . . . . . . . . . . . . . . . 2322. Using a VSAM Profile Data Set . . . . . . . . . . . . . . . . . . . . . . . . . 2323. Changing the Name of a Profile Data Set . . . . . . . . . . . . . . . . . . . 2424. Catalog Search Warning Panel . . . . . . . . . . . . . . . . . . . . . . . . . 2525. Data Set List Color Change Utility . . . . . . . . . . . . . . . . . . . . . . . 2626. Data Set List Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2627. Allocate a New Data Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2728. Multivolume Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2829. Long Message for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3030. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3131. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3232. ISPF Primary Option Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 4133. ISPF Settings Panel (ISPISMMN) . . . . . . . . . . . . . . . . . . . . . . . . 4234. First ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4335. Second ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4336. Third ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4437. ISPF Editor with Action Bars OFF . . . . . . . . . . . . . . . . . . . . . . . 4538. First ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4739. Second ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4740. Third ISPDTLC Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4841. ISPF Settings Panel with Function Keys Pull-down . . . . . . . . . . . . . 4942. Keylist Utility Panel (ISPKLUP) . . . . . . . . . . . . . . . . . . . . . . . . . 5043. Keylist Utility with Function Action Bar Pull-down (ISPKLUP) . . . . . . . 5144. Keylist Create Panel (ISPKLUCR) . . . . . . . . . . . . . . . . . . . . . . . 5145. Default Key Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5246. Keylist Change Panel (ISPKLUCH) . . . . . . . . . . . . . . . . . . . . . . . 5347. Keylist Utility with Delete Keylist Confirmation Pop-Up (ISPKLUP) . . . . 5448. Keylist Utility Browse Panel (ISPKLUB) . . . . . . . . . . . . . . . . . . . . 5449. Keylist Utility with Change Keylist Action Bar Pull-down (ISPKLUP) . . . 5550. ISREDM01 Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5751. PF Key Definitions and Labels Panel . . . . . . . . . . . . . . . . . . . . . 58

Copyright IBM Corp. 1994 xv

52. Tailor Function Key Definition Display Panel (ISPOPFA) . . . . . . . . . . 5953. Reflist Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6254. Referral List Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6255. Personal Data Set List Panel (ISRPDSNL) . . . . . . . . . . . . . . . . . . 6356. Reference Data Set List Panel (ISRDSNL) . . . . . . . . . . . . . . . . . . 6457. Reference Data Set List Open Panel (ISRPLTAB) . . . . . . . . . . . . . . 6558. Defining Function Key to Issue Referral List Commands . . . . . . . . . 6759. Example of a Personal Data Set List . . . . . . . . . . . . . . . . . . . . . 6860. Defining Function Key to Speed Up Selection Personal List Entry . . . . 6961. CUA Attribute Change Utility Panel Positioned on the Point-Shoot Panel

Element (ISPOPT1X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7062. Colors Pull-down on the ISPF Settings Panel Action Bar (ISPISMMN) . . 7163. Status Pull-down on the ISPF Primary Option Menu . . . . . . . . . . . . 7564. ISPF Primary Option Menu Status Area - Session View . . . . . . . . . . 7665. ISPF Primary Option Menu Status Area - Function Keys View . . . . . . 7666. ISPF Primary Option Menu Status Area - Calendar View . . . . . . . . . 7767. Option Pull-down on the ISPF Status Pop-Up Window . . . . . . . . . . . 7868. ISPF Calendar Note Pad panel (ISPCALNP) . . . . . . . . . . . . . . . . . 7869. Variables Panel (ISPYVPN) . . . . . . . . . . . . . . . . . . . . . . . . . . . 7970. Calendar Colors Panel (ISPCALGC) . . . . . . . . . . . . . . . . . . . . . . 8071. User View Customization Panel (ISPSAMUS) . . . . . . . . . . . . . . . . 8072. ISPF Primary Option Menu Status Area - User Status View . . . . . . . . 8173. User Point-and-Shoot Customization Panel (ISPSAMUP) . . . . . . . . . 8274. ISPF Primary Option Menu Status Area - User Point-and-Shoot View . . 8275. ISPF 4.1 Primary Option Menu . . . . . . . . . . . . . . . . . . . . . . . . . 8676. CM Mouse General Use Pop-Up Menu . . . . . . . . . . . . . . . . . . . . 9277. ISPF Workstation Server Icon . . . . . . . . . . . . . . . . . . . . . . . . . . 9778. TCP/IP Network Configuration Panel . . . . . . . . . . . . . . . . . . . . 10079. TCP/IP Routing Configuration Panel . . . . . . . . . . . . . . . . . . . . . 10180. TCP/IP AutoStart Configuration Panel . . . . . . . . . . . . . . . . . . . . 10181. TCP/IP Services FTP User Configuration Panel . . . . . . . . . . . . . . 10282. Communications Manager Configuration Definition . . . . . . . . . . . . 10483. Communications Manager Profile List . . . . . . . . . . . . . . . . . . . 10584. Communications Manager Local Node Characteristics . . . . . . . . . 10585. Communications Manager Local LU Definition . . . . . . . . . . . . . . 10686. TCP/IP for DOS CUSTOM.EXE Main Panel . . . . . . . . . . . . . . . . . 10787. NDIS Interface Configuration Panel . . . . . . . . . . . . . . . . . . . . . 10888. Routing Information Configuration Panel . . . . . . . . . . . . . . . . . . 10889. Auto-Start Configuration Panel . . . . . . . . . . . . . . . . . . . . . . . . 10990. FTP User Data Configuration Panel . . . . . . . . . . . . . . . . . . . . . 10991. Choosing a download Method (Option 3.7) . . . . . . . . . . . . . . . . . 11192. Downloading GUI Using FTP . . . . . . . . . . . . . . . . . . . . . . . . . 11193. ISPF Server Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11294. Settings Window for Workstation Icon . . . . . . . . . . . . . . . . . . . . 11395. Initiating a GUI Session from Within ISPF . . . . . . . . . . . . . . . . . . 11596. ISPF Primary Option Menu in GUI . . . . . . . . . . . . . . . . . . . . . . 11797. ISPF Command Shell GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . 11998. ISPF Settings Panel in 3270 Mode Displayed on a 327x Emulator . . . 12299. ISPF Settings Panel in GUI Mode Display Using ISPF C/S . . . . . . . . 123100. Initiate GUI Session Panel Showing GUI Window Frame Option . . . . 126101. A Message Generated from a .TYPE=NOTIFY Message Definition

Displayed Using ISPF C/S . . . . . . . . . . . . . . . . . . . . . . . . . . . 130102. A Message Generated from a .TYPE=WARNING Message Definition

Displayed Using ISPF C/S . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

xvi ISPF/SCLM V4 Guide

103. A Message Generated from a .TYPE=ACTION Message DefinitionDisplayed Using ISPF C/S . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

104. A Message Generated from a .TYPE=CRITICAL Message DefinitionDisplayed Using ISPF C/S . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

105. Sample Calculator in Decimal Mode . . . . . . . . . . . . . . . . . . . . 140106. Sample Calculator in Hexadecimal Mode . . . . . . . . . . . . . . . . . 142107. Configuration and Change Management (CCM) . . . . . . . . . . . . . . 163108. Many Enterprise Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . 166109. Load Modules Concatenated for Production . . . . . . . . . . . . . . . . 166110. Prjviews Combine Data Sets Physically . . . . . . . . . . . . . . . . . . . 167111. Many Separated Projects under one Roof . . . . . . . . . . . . . . . . . 167112. Many Subprojects Combined by Choice . . . . . . . . . . . . . . . . . . 168113. Private Level - User IDs Defined in Project View . . . . . . . . . . . . . 168114. Private Level - User IDs not Defined in Project View . . . . . . . . . . . 169115. Backup Scenario - Archive of Four Releases Back . . . . . . . . . . . . 185116. Backup Scenario - Inversed Archive Hierarchy to Restore Last Release 186117. Backup Scenario - Alternate Project Definition for Backup Group . . . 187118. Backup Scenario - REXX Program Call in FLMCNTRL Macro . . . . . . 187119. Pull-up for Better Quality Assurance . . . . . . . . . . . . . . . . . . . . 191120. Fixes are Integrated Immediately to PROD . . . . . . . . . . . . . . . . . 196121. Fix Load Data Sets, Preconcatenated . . . . . . . . . . . . . . . . . . . . 196122. Non-Key Group APPLY Preconcatenate PROD . . . . . . . . . . . . . . 196123. Concatenate Fixes, Integrate Maintenance, Control Development . . . 197124. Archdefs must be Fulfilled . . . . . . . . . . . . . . . . . . . . . . . . . . . 198125. REXX MET#CCV1 Obliges a CCV Number . . . . . . . . . . . . . . . . . 207126. FLMCNTRL Macro Implementation of REXX CCV-Program . . . . . . . 207127. REXX BUILDX1 to Demonstrate a REXX Build Translator . . . . . . . . 208128. REXX BUILDX1 to Demonstrate a REXX Build Procedure . . . . . . . . 208129. Example to Invoke REXX Program through FLMCNTRL Macro . . . . . 209130. REXX BUILDX1C to Demonstrate a REXX Build Procedure . . . . . . . 209131. SW Delivery - Project View . . . . . . . . . . . . . . . . . . . . . . . . . . 213132. Hierarchy SCLM Meta Project . . . . . . . . . . . . . . . . . . . . . . . . 221133. 3 Level Meta Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227134. Hierarchy Complex SCLM Meta Project . . . . . . . . . . . . . . . . . . 227135. Sample SCLM Language with Output Directed To NON-SCLM Data Set 241136. Translator Sample Embedding Copy Procedure . . . . . . . . . . . . . . 242137. Copy Procedure as Translator . . . . . . . . . . . . . . . . . . . . . . . . 242138. Promote Exit MET#P12 for IEBCOPYing PSB and DBD . . . . . . . . . . 242139. REXX Promote Exit MET#P12 . . . . . . . . . . . . . . . . . . . . . . . . . 243140. IEFBR14 as a Translator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264141. Conditional Translator Execution . . . . . . . . . . . . . . . . . . . . . . . 265142. IKJEFTSR Sample Interface . . . . . . . . . . . . . . . . . . . . . . . . . . 266143. Refer Back without DDname Substitution List . . . . . . . . . . . . . . . 268144. Refer Back with DDname Substitution List . . . . . . . . . . . . . . . . . 269145. Refer Back with IEBGENER Bridge . . . . . . . . . . . . . . . . . . . . . . 270146. PORDER and the Parameter List . . . . . . . . . . . . . . . . . . . . . . . 271147. #LANG Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273148. #MACLIB Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274149. #ASM Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274150. #CICS Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275151. #APPEND Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275152. EXXx SCLMAPND to Concatenate Build Translator Listings . . . . . . . 276153. @LANG Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Figures xvii

xviii ISPF/SCLM V4 Guide

Tables1. DTL List of Panels and Imbedded DTL Source Files . . . . . . . . . . . . 462. Default Key Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523. Valid Point-and-Shoot Change Values . . . . . . . . . . . . . . . . . . . . . 704. DFLTCOLR Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1485. JCL and Definitions of SCLM Sample Project . . . . . . . . . . . . . . . 1596. Architecture Definitions of Sample Project . . . . . . . . . . . . . . . . . 1607. Program Sources of Example Project . . . . . . . . . . . . . . . . . . . . 1608. Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1739. Table of Projects, Views and Roles . . . . . . . . . . . . . . . . . . . . . 176

10. Dual Control Data Sets: . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Copyright IBM Corp. 1994 xix

xx ISPF/SCLM V4 Guide

Special NoticesThis publication is intended to help the ISPF system programmer to customizeand implement ISPF Version 4 Release 1 such that the users may get themaximum benefit of its new functions with as little change as possible. Theinformation in this publication is not intended as the specification of anyprogramming interfaces that are provided by Interactive System ProductivityFacility Version 4 Release 1. See the PUBLICATIONS section of the IBMProgramming Announcement for Interactive System Productivity Facility Version4 Release 1 for more information about what publications are considered to beproduct documentation.

References in this publication to IBM products, programs or services do notimply that IBM intends to make these available in all countries in which IBMoperates. Any reference to an IBM product, program, or service is not intendedto state or imply that only IBM's product, program, or service may be used. Anyfunctionally equivalent program that does not infringe any of IBM's intellectualproperty rights may be used instead of the IBM product, program or service.

Information in this book was developed in conjunction with use of the equipmentspecified, and is limited in application to those specific hardware and softwareproducts and levels.

IBM may have patents or pending patent applications covering subject matter inthis document. The furnishing of this document does not give you any license tothese patents. You can send license inquiries, in writing, to the IBM Director ofLicensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594, USA.

The information contained in this document has not been submitted to anyformal IBM test and is distributed AS IS. The use of this information or theimplementation of any of these techniques is a customer responsibility anddepends on the customer's ability to evaluate and integrate them into thecustomer's operational environment. While each item may have been reviewedby IBM for accuracy in a specific situation, there is no guarantee that the sameor similar results will be obtained elsewhere. Customers attempting to adaptthese techniques to their own environments do so at their own risk.

Reference to PTF numbers that have not been released through the normaldistribution process does not imply general availability. The purpose ofincluding these reference numbers is to alert IBM customers to specificinformation relative to the implementation of the PTF when it becomes availableto each customer according to the normal IBM PTF distribution process.

The following terms, which are denoted by an asterisk (*) in this publication, aretrademarks of the International Business Machines Corporation in the UnitedStates and/or other countries:

Common User Access CUAIBM OS/2Personal System/2 Presentation ManagerPS/2

Copyright IBM Corp. 1994 xxi

xxii ISPF/SCLM V4 Guide

PrefaceThis document discusses the new user interface made available with or widelyimplemented in Interactive System Productivity Facility Version 4 Release 1. Thedocument contains a detailed description of this user interface and of the newSCLM functions as they are implemented in ISPF Version 4.

The document is intended for system programmers preparing and customizingISPF for their users as well as for those users who perform their customizationindividually. It the intention of this document to increase the user acceptance ofISPF Version 4 Release 1 and to assist the users in exploiting the new facilitiesto the maximum possible degree.

How This Document is OrganizedThe document is organized in three parts as follows:

Part 1, Introduction contains a general introduction to the content of thedocument

Part 2, ISPF Version 4 Basics discusses the new facilities of ISPF Version 4excluding SCLM and contains the following chapters:

Chapter 1, Technical OverviewProvides an overview of the various new facilities as well as those facilitiesthat have been fully implemented in ISPF Version 4Chapter 2, User InterfaceA detailed description of the new user interface in ISPF Version 4Chapter 3, 3270 EnvironmentA discussion of the user interface in relation to an IBM 3270 environmentChapter 4, Graphical User Interface (GUI)A detailed step-by-step guide in implementing a TCP/IP or APPC connectionbetween a workstation and the hostChapter 5, Miscellaneous DiscussionDiscusses various miscellaneous topics .

Part 3, Software Configuration and Library Manager discusses SCLM in ISPFVersion 4 exclusively and contains the following chapters:

Chapter 6, SCLM Concepts and TerminologyThis chapter explains the concepts of and some specific terms associatedwith SCLMChapter 7, Install, Implement and Understand SCLM Product SampleProvides guidance installing the SCLM Product SampleChapter 8, Project OrganizationDiscusses project organizationChapter 9, Role Management

Copyright IBM Corp. 1994 xxiii

Testing techniques are discussed in this chapterChapter 10, Method ManagementDiscusses methods in an SCLM frameworkChapter 11, SecurityThis chapter discuses security implementations with SCLMChapter 12, Version ControlDiscusses version control in SCLMChapter 13, What is Configuration Management?An introduction to configuration management in SCLMChapter 14, Change and Problem ManagementThis chapter introduces change and problem management in an SCLMframeworkChapter 15, DeliveryExplains software delivery in SCLMChapter 16, CommunicationThis chapter provides an example of how fix notification can be implementedwith SCLMChapter 17, Verification ManagementVerification techniques are discussed in this chapterChapter 18, Meta ProjectThis chapter discusses a Meta-Project of managing SCLM with SCLMChapter 19, OptimizationVarious optimization methods are discussed in this chapterChapter 20, Workstation ConnectionThis chapter discussed the use of workstations with SCLM projectsChapter 21, Diskette MaterialProvides a description of the SCLM workshop material that can be found onthe diskette that comes with this bookChapter 22, StandardsThis chapter provides a list of the various standards that exist for softwaredevelopmentChapter 23, SCLM Translator InterfacesProvides a description of the SCLM translator interfacesChapter 24, Translator Building Blocks, #LANG, #MACLIB, ...Provides a description of the SCLM translator building blocksChapter 25, SCLM InvocationThis chapter provides an example of SCLM batch invocation and a REXXexec under ISPF using SCLM variablesChapter 26, Workshop Foils

xxiv ISPF/SCLM V4 Guide

Provides a collection of foils to be used with an SCLM implementationworkshop. Fullsize foils are found on the diskette in the back of this book

Related PublicationsThe publications listed in this section are considered particularly suitable for amore detailed discussion of the topics covered in this document.

TCP/IP for MVS V3R1 Performance Tuning Guide, SC31-7188-00IBM TCP/IP for OS2 V2 Installation and Administration, SC31-6075-04IBM TCP/IP for DOS V2.1.1 Installation and Administration, SC31-7047-01Systems Application Architecture, Common User Access, SC26-4583ISPF Master Index, SC34-4448ISPF Getting Started, SC34-4440ISPF Planning and Customizing, SC34-4443ISPF Examples, SC34-4451ISPF User's Guide, SC34-4484ISPF Services Guide, SC34-4485ISPF Dialog Developer's Guide and Reference, SC34-4486ISPF Dialog Tag Language Guide and Reference, SC34-4441ISPF Library Management Facility, SC34-4449ISPF SCLM Developer's Guide, SC34-4469ISPF SCLM Project Manager's Guide, SC34-4470ISPF SCLM Reference, SC34-4471ISPF Edit and Edit Macros, SC34-4446ISPF Reference Summary, SC34-4445ISPF Messages and Codes, SC34-4450MVS/DFP 3.3: Linkage Editor and Loader, SC26-4564

International Technical Support Organization PublicationsSCLM WSP/2 Usage Guide, GG24-3538

A complete list of International Technical Support Organization publications, witha brief description of each, may be found in:

Bibliography of International Technical Support Organization TechnicalBulletins, GG24-3070.

To get listings of ITSO technical bulletins (redbooks) online, VNET users maytype:TOOLS SENDTO WTSCPOK TOOLS REDBOOKS GET REDBOOKS CATALOG

Preface xxv

How to Order ITSO Technical Bulletins (Redbooks)IBM employees in the USA may order ITSO books and CD-ROMs usingPUBORDER. Customers in the USA may order by calling 1-800-879-2755 or byfaxing 1-800-284-4721. Visa and Master Cards are accepted. Outside theUSA, customers should contact their IBM branch office.

Customers may order hardcopy redbooks individually or in customized sets,called GBOFs, which relate to specific functions of interest. IBM employeesand customers may also order redbooks in online format on CD-ROMcollections, which contain the redbooks for multiple products.

AcknowledgmentsThe advisor for this project was:Erik P. OlsenInternational Technical Support Organization, Poughkeepsie Center

The authors of this document are:

Minsani Mariani IBM IndonesiaDeirdre Errity IBM UKMatt Nuttall IBM CanadaHartmut Singhofen IBM Germany

This publication is the result of a residency conducted at the InternationalTechnical Support Organization, Poughkeepsie Center.

Thanks to the following people for the invaluable advice and guidance providedin the production of this document:

Dick Bittinger IBM, ISPF DevelopmentEdward Chatelain IBM, ISPF DevelopmentAndy Gibson Loral Federal Systems - Air Traffic Control, MarylandRobin Glisson IBM, ISPF DevelopmentRobert Haimowitz IBM, ITSO Poughkeepsie CenterMarvin Knight IBM, ISPF DevelopmentBob Leah IBM, ISPF DevelopmentKit Lo IBM, ISPF DevelopmentKule Manning IBM, ISPF DevelopmentScott McAllister IBM, ISPF DevelopmentDoug Nadel IBM, ISPF DevelopmentMichael Petersen IBM, ISPF Development

xxvi ISPF/SCLM V4 Guide

Part 1. IntroductionInteractive System Productivity Facility (ISPF) Version 4 Release 1 constitutes amajor enhancement to previous versions of ISPF. Although the packaging, byand large, is the same as previous versions, ISPF and ISPF/PDF is now onesingle product. In this document we will refer to ISPF as the commondenominator for both products and use the term PDF to designate the functionspreviously known as ISPF/PDF.

The functional enhancements to ISPF are mainly in the area of useability.Although keylists were introduced long ago, it was not till ISPF Version 4Release 1 that they were used all over ISPF. Same can be said about actionbars. Both these elements are required by the Common User Access (CUA)definitions and since ISPF Version 4 Release 1 were to include a PS/2-basedGraphical User Interface (GUI), CUA was commonly adopted by ISPF.Part 2 of this document addresses these changes and innovations. Particularlythe users of PDF will experience a change in the way they navigate within PDFand the way each individual panel is treated. The traditional power users whohave learned to use PDF blindfold, will see their pace reduced for a while untilthey learn the new panel structure and find ways to use it to their benefit. Manya times will they type an ISPF command over the action bar and see a pull downpop up when they press the Enter key. Hopefully this document will demonstratehow the workplace can be accommodated to take advantage of several of thenew dialog elements so the user won't feel compelled to try to revert to thestructures of previous ISPF versions.

Chapter 1 will walk you through the innovations and enhancements of the entireISPF product.

Chapter 2 will concentrate on the specific enhancements to the user interface,the human factors, that have been made available with this version. Thefunctions and features are discussed without regard to useability. The variousways of working with the functions are explained; command interfaces, dialog(action bar) interfaces and programming interfaces. Please refer to this sectionwhen reading the following two chapters.

Chapter 3 deals with the particular workplace that the IBM 3270 offers. Thediscussion is divided between the nonprogrammable 3270 hardware terminalsand the OS/2 emulated (through CM/2) 3270 terminals. For thenonprogrammable terminals, only the options available with ISPF may be used.However, quite a few is available to the user, who also with this workstation willexperience a freedom in choice of ISPF possibilities. The programmableworkstation offers a much larger degree of freedom in that the workstation inaddition to the pure ISPF possibilities also may be programmed to benefit fromthe features that ISPF provides. Besides working with CM/2, also the licensedprogram CMmouse is discussed, and examples of how to utilize it are given.

Finally Chapter 4 discusses the biggest innovation in ISPF Version 4 Release 1,namely, GUI. Both the various ways of installing and activating it and theusability for the user is discussed.

Copyright IBM Corp. 1994 1

Part 3 deals entirely with the IBM Software Configuration and Library Manager(SCLM). SCLM is a software complex which aids the development of softwareapplications, it:

Simplifies and reduces development and maintenance effortControls the movement of application componentsMaintains complete software configurationProvides auditabilityCan be customized to an organization's culture.

With the appropriate level of ISPF/PDF installed, a customer already has thecapability to use SCLM and its facilities; SCLM is available as an integral part ofISPF/PDF (from level 3.1).SCLM has two major functions:1. Software Configuration

Using SCLM facilities, it is possible to define how the total application can bebuilt from a number of predefined source libraries. It is possible to:

quantify the impacts of changes to the systemverify the completeness of those changes andrebuild the system following those changes.

For example, if an include structure is changed currently in a project with nosoftware configurator facilities, all the source libraries should be scanned tosee where else that structure is used and to remember to rebuild (recompileor reassemble) all those affected source members. In an SCLMenvironment, this could be under SCLM control, so that when the includestructure is changed it will not be possible to handover other sourcemembers using that structure without rebuilding them.Source modules can be permanently t ied to other source modules orgenerated outputs and SCLM will ensure that when updates are made tothese components they will always be promoted together.

2. Library MaintenanceIn conjunction with controlling how the application is built from the sourcecreated, SCLM will also control how that source is developed. Once thelibrary structure and development hierarchy have been defined to SCLM, itwill control what happens to the new or updated source code during thedevelopment.For example, when a module is updated for a particular development, SCLMwill lock that source member so that any other developer will know that it isbeing worked upon. This helps to avoid developing conflicting copies of thesame source or losing pieces of simultaneously developed versions.

2 ISPF/SCLM V4 Guide

Part 2. ISPF Version 4 Basics


Chapter 1. Technical Overview

1.1 New Functions in ISPF Version 4 Release 1ISPF Version 4 Release 1 has many of the functions we have become familiarwith in previous versions of the product, but it has a new look and has enteredthe Client-Server world. ISPF 4.1 provides a wide range of functions, and thissection will explore and discuss some of the differences between ISPF V3 andISPF V4.1.

We can still control and format the information displayed on our terminals, andwe hope to give you some hints and tips to enable you to navigate around ISPFV4.1 with ease. One of the things that allows ease of use is that ISPF V4.1 nowconforms to Common User Access (CUA) guidelines. We now have Menu,Utilities and Help available on all panels, thus allowing you to access some ofthe basic functions by using the Action bar pull-downs.

The aim of this section of the book is to give you a good understanding of themajor changes in ISPF V4.1.

1.2 Usability EnhancementsIt is important to emphasize that all of the modifications to the ISPF/PDFinterface are additions. They do not replace the existing methods of using theproduct or navigating through it. You will be able to use the ISPF/PDF productalmost the same as in previous versions. Some changes and additions arediscussed below.

1.2.1 ISPF SettingsIn ISPF V4.1 the former ISPF Parms panels have been consolidated into fewerpanels. This enables you to view most of the settings at once rather thanjumping from panel to panel. The ISPF Settings panel, as shown in Figure 1 onpage 6, contains settings from the 0.1 (Terminal Characteristics), 0.4 (DisplayCharacteristics), 0.6 (Print Graphics Parameters) and 0.9 (Dialog Test Option) aswell as a new display characteristic settings.

By selecting 0 from the Primary Options Menu or using the SETTINGS linecommand from any panel, the panel shown in Figure 1 on page 6 will bedisplayed. You can also invoke the settings panel from the settings choice onthe Menu pull-down, where it is available.

Note: The default for ISPF V4.1 is to have the command line placement at thebottom of each logical screen. However, if your current application profile tablespecifies ASIS, the ISPF V4.1 default will not override it.


Figure 1. ISPF Settings Panel

In ISPF V4.1 you can select a pull-down choice from the Action bar that appearsat the top of the ISPF Settings Panel. The choices are:

1.2.1.1 Settings panel Action barsLog/List1. Log data set defaults2. List data set defaults3. List data set characteristics4. JCL

Function Keys1. Global PF Key settings2. Keylist settings3. Tailor function key display4. Show all function keys5. Show partial function keys6. Remove function key display7. Disable keylists8. Enable keylists

Colors1. Global colors2. CUA attributes3. Point-and-Shoot

Environ1. Environ settings


GUI1. Start GUI2. GUI panel settings

Temporary1. Message identifier2. Panel identifier

Help1. Settings2. Options3. Terminal characteristics4. Print Graphics parameters5. General6. Log/List action bar7. Function keys action bar8. Color action bar9. Environ action bar

10. GUI action bar11. Temporary action bar

The following features can all be activated from the ISPF Settings Panel.Jump from leader dotsEdit PRINTDS CommandTab to Action Bar Pull-downsTab to Point & Shoot FieldsLong Message in Pop-Up

1.2.1.2 Jump from Leader DotsThe jump function allows you to enter =x (where x is an option number) withoutgoing all the way from the panel you are working in to the Primary Options Menuto select option x.

You can still jump from field prompts that have the ===>, but in ISPF V4.1 thereis also the possibility of jumping from field prompts that have leader dots,(leader dots are display as . . ., i.e. dots with one intervening blank).To enable the jump function from leader dots, enter a slash in front of thechoice on the Settings panel.

1.2.1.3 Edit PRINTDS CommandBy entering a slash in front of the Edit PRINTDS Command choice on theSettings panel, you will intercept the local print request. It is then possible tomodify the statements before the command is processed. You do this from thepanel shown in Figure 2 on page 8.

Chapter 1. Technical Overview 7

Figure 2. Local Print Command Edit

1.2.1.4 Action Bar Pull-downsPerhaps the most obvious change in ISPF V4.1 is your exposure to Action Barpull-downs. These pull-downs were available in ISPF V3 but were not widelyused. The pull-downs will vary depending on which panel you are viewing butallow you to do many of the functions that you previously achieved by issuingseveral line commands on several screens. These pull-downs can be activatedby using your keyboard.

The home key can bring the cursor to the first action on the action bar and thetab-key can move it forward or backward on the action bar. Of course, this isonly true if the action bar choices are tab-able and on top of the screen; theymay be relocated in split-screen mode. In Figure 3 on page 9 you can see anexample of what the Help Action bar pull-down looks like.

By using the Action bar pull-downs, you can perform another function withouthaving to end the present function. For example, if you are editing a data setand want to allocate another data set, in ISPF 4.1, from your edit session, selectthe option 2 (Data set) from the Utilities pull-down on the Edit panel action bar.ISPF suspends your edit session and displays the Data Set Utility panel. Whenyou have allocated the new data set and end the function, ISPF V4.1 takes youdirectly back to your edit session.


Figure 3. Action Bar Pull-down

1.2.1.5 Point & Shoot FieldsPoint-and-Shoot fields are cursor sensitive. When you select a field, the actiondescribed in that field is performed. For example, from the Primary OptionMenu, if you place the cursor at the Utilities selection and press Enter, you arebrought to the Utilities Selection Panel. In Version 3 this is not the case. Hadyou placed the cursor at the Utilities selection, once you press the Enter buttonthe cursor is moved back to the command line and a message of ENTEROPTION is given.

Point-and-Shoot fields allow quick command entry. When you point (by placingthe cursor over the desired area) and shoot (using the Enter key), the field isactivated for selection.

Be careful if you have entered a command on the command line as thiscommand will be processed before any Point-and-Shoot command.

1.2.1.6 Long Message in Pop-UpWhen the HELP command is entered, the long message pop-up displays anexplanation of the error. For short messages, a one-line explanation isdisplayed in the top righthand corner of your screen, but by requesting help for asecond time, the explanation is displayed in a pop-up window. You can see thisin Figure 4.

Figure 4. Long Message in Pop-Up


1.2.2 Member Selection ListThe fields for the member selection are also point-and-shoot enabled. Datawithin the columns can be sorted by pointing and shooting on the columnnames.

Figure 5. Member Selection List

1. Select a column (such as date changed) by placing the cursor over thepoint-and-shoot field and pressing Enter. Then the data sets are sorted indate changed order with the most recently changed data set at the top of thelist, as you can see in Figure 5.

2. To resort the member list by the Name column, place the cursor over anentry in the Name column and press Enter.

1.2.3 ReflistsA feature of the View Option allows you to recall data sets and libraries that youhave most recently accessed. In order to add a data set to the list, type the dataset name in the Other Partitioned or Sequential Data Set Name field. To add alibrary, enter a library in the Library field. Whenever ISPF references a data set,such as in a Move/Copy operation, data sets will be added.

1. Select the RefList Action from the Action Bar, as shown in Figure 6 onpage 11.

2. Select 1 from the RefList pull-down.

The Reference Data Set List will display data sets which have been accessedduring this ISPF session. You can see an example of working with this list fromthe View function in Figure 7 on page 11. By selecting one of the data sets inthe reference list, you may View it without actually having to type in the data setname on the View panel.


Figure 6. RefList Pull-down

Figure 7. Reference Data Set List

A library list is a list of libraries that have been accessed during your ISPFsession. Libraries accessed are dynamically appended to the library referencelist for later use.

1. Press PF3 from Reference Data Set List Panel.2. Move the cursor to the RefList Action Bar options, and press Enter.3. Select Option 2, Reference Library List, and press Enter.


You may now view these lists, as shown in Figure 8 on page 12 and make aselection and either execute or retrieve the data set or library stored.

Figure 8. Library List

As well as the Reference List action there is the Reference Mode action. Thisindicates whether you would like to either Execute the View of the referenceentry or Retrieve the data sets or library entries onto the View or Edit EntryPanel. In Execute mode, the data set or library would be viewed or edited. InRetrieve mode, the data set or library name entries would be placed into theappropriate fields on the view or edit screen, where they could be edited ifdesired. See Figure 9 on page 13.


Figure 9. Reference Mode

1.2.4 The View FacilityThe new View facility from the Primary Option Menu, shown in Figure 10 onpage 14, allows you to view or browse source data or output listings. If youselect the View Option, you can update existing datasets using Edit commands,but any changes you make to the data are not saved. This safeguards againstunintentional changes being made.

Browse can be enabled from the View Entry Panel, but the View function is muchmore powerful. It provides all the facilities you would expect from Edit butdoesn't issue an exclusive enqueue against the dataset, and so allows severalusers to process the same data set or member simultaneously.

You can now View, Browse or Edit a dataset without leaving your currentsession. View, Browse and Edit are now primary commands. So now if you arebrowsing a member and decide you wish to make some changes to this memberafter all, you type edit and the member name on the command line, and you aretaken into the Edit panel for this particular member.

If you wish to Edit a member of a different library, type edit on the command lineand press Enter, and the Edit Entry Panel will be brought up.

1. From the Primary Options Menu, select Option 1, and you will be presentedwith the View Entry Panel, as shown in Figure 10 on page 14.


Figure 10. View Entry Panel

1.2.4.1 Using the Create and Replace CommandsIf you wish to save the changes you have made, you must create a new member,in which to save your changes. The End command will terminate the Viewfunction and no changes are saved.

Figure 11. View Warning

Alternatively, you may wish to save your changes to the same member, so inorder to do this, you would use the replace primary command. The panel shownin Figure 11 will be presented to you when you try to save your changes.

NoteIf you submit a job for background execution in browse mode and this dataset is edited and saved by another user, the job submitted will be theupdated data set which will not be what you had intended. You cansafeguard against this happening by submitting the job from view.


1.2.5 Color Usage

1.2.5.1 Edit HiliteUse of the facilities of the editor is unchanged. However, as part of the supportfor language sensitive coloring, a new edit primary and macro command calledhilite has been added. Valid synonyms are hi and hilight. Operands of thehilite command are:Reset Resets defaults (auto, on, find and cursor on)On Sets coloring on and turns logic offOff Sets coloring off (except cursor highlighting)Auto Lets ISPF/PDF determine the languageDefault Highlights the data in one colorParen Turns on parenthesis matching. When parenthesis matching is active,

only comments are colored. All other code is shown in the defaultcolor. Note that extra parenthesis highlighting is always active whenhighlighting is active.

Logic Turns on both IF and DO logic matchingDOLOGIC highlights logical blocks (DO/END, {}, etc.)IFLOGIC highlights IF/ELSE pairsNOLOGIC is the same as ON

Do is the default. When logic matching is active, only comments arespecially colored. All other code, other than logic keywords, is shownin the default color.

Find Toggles highlighting find strings.Cursor Toggles highlighting of the phrase with the cursor.Disabled Turns off all HILITE features. The disabled status is not stored in your

edit profile, therefore you must re-enter the operand every time yougo into the editor.

Search Finds the first unmatched END, ELSE, } or ). To use search you musthave had the logic enabled. The search for mismatches only occursfor lines above the last displayed line, so you may have to scroll tothe bottom of the file before issuing the hi search command.

Other Highlights the data as a pseudo PLI language - limited CLIST supportis also provided.

1.2.5.2 Language Sensitive EditingThe ISPF editor now actively assists you in analyzing and building syntacticallycorrect source code through language sensitive highlighting.

Since you can customize the editor to define almost any language construct, theprogramming task is a less error-prone one.

You can force the editor to highlight the file according to the rules of thefollowing languages:


ASMBOOKCCOBOLDTLJCLPANELPASCALPLIREXX

1. Select a member from a data set list by placing the cursor over thepoint-and-shoot field and pressing Enter.

In living color, you will see several changes that make editing a data set aneasier task.

Figure 12. Edit COBOL Source

From within the View session, you may execute compiles and perform DialogTest functions. The Edit action allows you to enable language sensitive editingspecific to the file that is being edited.

1. From the panel shown in Figure 12, select the Edit action from the ActionBar.

2. Select 3 Hilite. See Figure 13 on page 17.


Figure 13. Edit Color Settings

1. Enter 1 for Automatic Language highlighting, shown in Figure 14.2. Enter 2 for Coloring.3. Exit from the Edit Colors screen to return to the View screen.

Figure 14. Edit Language Selection

Notice also that language reserved words, comment lines, literals and matchingparenthesis, operators, and special characters are highlighted and color-coded.

Notice that a string or line being edited is highlighted.


1. Move the cursor to the edit area of the source file.2. Place an asterisk on a line of code (any line other than a comment line).

Notice that the newly commented line takes on the highlighting of the othercommented lines.

1. Misspell a COBOL reserved word (XDENTIFICATION DIVISION, for example).Notice that the highlighted field of the reserved word changes with themisspelling to a nonhighlighted field. The cursor moves to highlight the firstcharacter string of the following line.

1. Remove a quote from a literal string.

Notice that text following the deleted quote takes on the highlighting of a literalstring.

1. Replace the quote to the literal string.

Notice that regular highlighting has returned.

Menu and Utilities Actions are available from this screen so that you can easilyaccess these functions while within the edit session. A new action, Compilers,allows you to perform compile functions while within the View session.

You may execute Compilers to compile this edited and unsaved member withouthaving made permanent changes to the source file. From within the View or Editsession, you may also access Dialog Test functions from the Action barpull-down. This enables quick testing while modifying a data set.

Figure 15. Compilers Pull-down

1. Begin to tab through the actions on the Action Bar.2. Select Compilers from the Action Bar, shown in Figure 15.


3. Enter 1 for Foreground Compilers.

Any of the foreground compilers, shown in Figure 16, can be selected.

Figure 16. Foreground Selection Panel

1. Press PF3 to return to the View screen.2. Press PF3 to end (you will see the view warning screen, an example of which

is shown in Figure 11 on page 14).While in View mode, you may edit a data set but will be warned when you haverequested END. You may either end the View session without saving changes oruse editing commands to save the changes.

Another improvement to ISPF Version 4.1 is the ability to edit data wider than255 characters. This allows wide files to be edited in the same manner as otherfiles.

Also significant is that retrieval times for very large data set name lists from theData Set List Utility panel has been greatly improved.

1.2.6 ISPF Command ShellThe TSO command processor has been enhanced to save the ten most recentTSO commands that you have entered on this panel. These commands can beselected from ten point-and-shoot fields.

In Figure 17 on page 20, if you place the cursor, for example, at the firstcommand in the list and press Enter, then that command would be brought to thecommand input field and by subsequently pressing Enter once again, thecommand is issued (assuming that the default is retrieve, see Mode sectionbelow). This proves very useful for complex TSO commands you issue, as itsaves recoding and reduces the chances of syntax errors.


Figure 17. ISPF Command Shell

What happens when you select a command depends on the mode you specifyfrom the Mode pull-down on the action bar. The Mode pull-down offers youthree choices:

Retrieve Allows you to retrieve commands from the saved command area andplaces the command in the TSO Command field so that you can edit itbefore the command is executed. This is the default.

Execute Allows you to retrieve commands from the saved command area andexecute the command in one step.

Delete Allows you to delete commands from the saved command areawithout executing them. Place the cursor on the command to bedeleted and press Enter. The command will be blanked out. Thisallows you to delete a command if you are running with Update modeset off.

The list pull-down offers you two choices:

Update On Allows you to append new commands in the saved command areaautomatically.

Update Off New commands are not appended to the list automatically.

1.2.7 VSAM UtilitiesThe VSAM utility function will enable you to define or delete a VSAM data set orto issue the listcat command without using the IDCAMS command. The IDCAMScommand is now generated, alleviating the need to know the syntax of it. Thecommand will process in the foreground. When you build define, delete andlistcat commands, they are saved to a profile data set for later use.


Instructions for Defining a Cluster1. On the VSAM utilities panel, shown in Figure 18, enter 1 in the Define field

and 3 in the Data Type field.2. Press the Enter key twice - the generated IDCAMS statements are displayed

as shown in Figure 19.

Figure 18. VSAM Utilities

Figure 19. IDCAMS Statement

To process the command, type EXEC on the command line and press Enter.


You should get a message in the top righthand corner of your screen sayingReturn Code 0. If the command processes with a nonzero return code, you willbe presented with another panel where you can make the necessary changesand resubmit the command.Note: You should select the Browse errors only option on the Define Clusterpanel to browse the output from IDCAMS when

Documents

Sclm Manual