Interactive System Productivity Facility (ISPF) Planning and Customizing OS/390 V ersion 2 Release 10.0 SC28-1298-04 Interactive System Productivity Facility (ISPF) Planning and Customizing OS/390 V ersion 2 Release 10.0 SC28-1298-04 Note Before using this document, read the general information under “Notices” on page 329. Fifth Edition (September 2000) This edition applies to ISPF for Version 2 Release 10 of the licensed program OS/390 (program number 5647-A01) and to all subsequent releases and modifications until otherwise indicated in new editions. Order publications by phone or fax. IBM Software Manufacturing Solutions takes publication orders between 8:30 a.m. and 7:00 p.m. eastern standard time (EST). The phone number is (800) 879-2755. The fax number is (800) 284-4721. You can also order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. A form for comments appears at the back of this publication. If the form has been removed, and you have ISPF-specific comments, address your comments to: International Business Machines Corporation Software Reengineering Department G7IA / Building 503 Research Triangle Park, NC 27709-9990 FAX (United States & Canada): 1+800+227-5088 IBMLink (United States customers only): CIBMORCF@RALVM17 IBM Mail Exchange:
[email protected] Internet:
[email protected] If you would like a reply, be sure to include your name, address, telephone number, or FAX number. Make sure to include the following in your comment or note: Title and order number of this book Page number or topic related to your comment The ISPF development team maintains a site on the World-Wide Web. The URL for the site is: http://www.software.ibm.com/ad/ispf © Copyright International Business Machines Corporation 1984, 2000. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Preface . . . . . . . . . . . . . . vii About This Book . . . . Who Should Use This Book . What Is in This Book . . . . . . . . . . . . . . . . . . . . . . . . . vii . vii . vii Chapter 3. Customizing DM . . . . . . 53 Changing the Default Name for the ISPF Client/Server Component Download Data Set . . Setup ISPF GUI for TSO Line Mode Support . . SMF Command Accounting . . . . . . . . Preallocation of List/Log Data Sets to SYSOUT . Specifying the Maximum Number of Split Screens Setting ISPF Site-Wide Defaults . . . . . . . Customizing Command Tables . . . . . . . Application Command Table . . . . . . User Command Table . . . . . . . . . Site Command Table . . . . . . . . . System Command Table . . . . . . . . Program Control Facility Modifications . . . . Creating ISPF Terminal Translation Tables . . . Uppercase Character Translation Table . . . Lowercase Character Translation Table . . . Valid Terminal Output Translation Table . . . Generic String Master Translation Table . . . Alphabetic Character Translation Tables . . . Collating Sequence Translation Table . . . . Specifying Terminal Types . . . . . . . Creating ISPF Code Page Translation Tables . . Base Code Pages for Terminals . . . . . . ISPCCSID Translation Load Modules . . . . Adding Translation Tables for Extended Code Page Support . . . . . . . . . . . . Displaying Square Brackets Used in C Programs . ISPEXEC Processing . . . . . . . . . . ISPF-to-APL2 Terminal Type Mappings . . . . Load APL2 Workspace. . . . . . . . . . Tailoring ISPF Defaults . . . . . . . . . ISPF Installation-Wide Exits . . . . . . . . How to Install the Installation-Wide Exits . . Exit Macros . . . . . . . . . . . . How to Use the Macros to Define ISPXDT . . Sample ISPXDT Definition . . . . . . . Exit Parameter List . . . . . . . . . . Error Processing . . . . . . . . . . . Exit 1: ISPF Session Initialization Exit. . . . Exit 2: ISPF Session Termination Exit . . . . Exit 3: SELECT Service Start Exit . . . . . Exit 4: Select Service End Exit . . . . . . Exit 5: TSO Command Start Exit . . . . . Exit 6: TSO Command End Exit . . . . . Exit 7: LIBDEF Service Exit . . . . . . . Exit 8: RESERVE Exit . . . . . . . . . Exit 9: RELEASE Exit . . . . . . . . . Exit 10: Logical Screen Start Exit . . . . . Exit 11: Logical Screen End Exit . . . . . Exit 12: ISPF Service Start Exit. . . . . . Exit 13: ISPF Service End Exit . . . . . . Exit 14: SWAP Exit . . . . . . . . . Exit 15: DISPLAY Service Exit . . . . . . Exit 16: Log, List, and Temporary Data Set Allocation Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 53 54 57 58 58 58 59 59 59 60 60 60 61 61 61 62 63 63 64 73 75 75 | | | | | | | | | | Summary of Changes . . . . . . . . ix ISPF Product Changes . . . . . . . . . . . ix ISPF DM Component Changes . . . . . . . . x ISPF PDF Component Changes . . . . . . . . xii ISPF SCLM Component Changes . . . . . . . xiii ISPF Client/Server Component Changes . . . . xiv ISPF User Interface Considerations . . . . . . xiv ISPF Migration Considerations. . . . . . . . xiv ISPF Profiles . . . . . . . . . . . . . xv Year 2000 Support for ISPF . . . . . . . . xv What’s in the OS/390 V2R10.0 ISPF library? . . . . . . . . . . . . . . xvii OS/390 V2R10.0 ISPF . . . . . . . . . . xvii Elements and Features in OS/390 . . . xix Chapter 1. OS/390 V2R10.0 ISPF Planning . . . . . . . . . . . . . . 1 Hardware and Software Requirements . . . . . . Migrating from Previous Releases to OS/390 V2R10.0 ISPF . . . . . . . . . . . . . . . . . SAS/C Considerations . . . . . . . . . . . Software Configuration and Library Manager (SCLM) Migrating from Previous Versions of SCLM . . . Maintenance Considerations . . . . . . . . . Load Module Search Order . . . . . . . . . TSO Logon Procedure . . . . . . . . . . . 1 1 3 3 4 5 6 6 Chapter 2. Customizing ISPF . . . . . . 9 Improving ISPF Performance . . . . . . . . Use Virtual I/O . . . . . . . . . . . Remove or Tailor Edit Functions . . . . . . Remove Action Bars from ISPF Panels . . . Remove Scrollable Areas From ISPF Panels . . Preprocess All ISPF Panels . . . . . . . Add Load Modules to the Pageable Link-Pack Area (LPA) . . . . . . . . . . . . Allocate Execution Data Sets. . . . . . . Create an Exit Program to Disable Generic High-Level Qualifiers . . . . . . . . . Preallocate ISPF Temporary Data Sets. . . . Allocating Optional Image ISPF Library . . . . Customizing the Primary Options Menu Panel for OS/390 . . . . . . . . . . . . . . . Using the OS/390 Sample Panels . . . . . Customizing Action Bars . . . . . . . . . Invoking the ISPDTLC Conversion Utility . . . 9 . 9 . 9 . 10 . 11 . 11 . 13 . 36 . 37 . 39 . 42 . . . . 42 43 45 46 . 76 . 82 . 82 . 82 . 83 . 83 . 84 . 86 . 86 . 88 . 90 . 91 . 92 . 92 . 93 . 93 . 95 . 96 . 98 . 98 . 100 . 101 . 101 . 102 . 102 . 103 . 104 . 104 . 106 © Copyright IBM Corp. 1984, 2000 iii Customizing the ISPF TSO Command Table (ISPTCM). . . . . . . . . . . . . . Sample ISPTCM Definition . . . . . . . ISPTCM Usage Notes . . . . . . . . . Alternate Option 7.1 Panels. . . . . . . ISPF Language Support . . . . . . . . . Changing the Session Language Default Value . . . . . 108 110 111 112 113 113 Chapter 4. Customizing PDF . . . . . 117 Edit Mode Defaults . . . . . . . . . . . Site Wide Edit Profile Initialization . . . . . Creating a ZDEFAULT profile . . . . . . . Action Bars and Extended Color in Edit . . . Edit Backup and Recovery . . . . . . . . Data Set Allocation Defaults for the Outlist Utility Using the Hardcopy Utility with DBCS Support Foreground Compress Procedure . . . . . . . SCLM Batch Considerations . . . . . . . . Using the Library Management Facility (LMF) . . Tailoring the Size of the Link Pack Area (LPA) for LMF . . . . . . . . . . . . . . Installing LMF as a User SVC . . . . . . . Using the LMF to Update Data Sets . . . . . LMF Migration Utility for the LMF Control File (Data Set) . . . . . . . . . . . . . Creating PDF Translation Tables . . . . . . . Translation Table for Valid Data Set Name Characters . . . . . . . . . . . . . Translation Table for Invalid Data Set Name Characters . . . . . . . . . . . . . Translation Table for Hexadecimal Characters Translation Table for Numeric Characters . . . Translation Table for Alphanumeric Characters Translation Table for Edit Terminal Output Characters . . . . . . . . . . . . . Translation Table for Generic String Characters Translation Table for Generic String Special Characters . . . . . . . . . . . . . Translation Table for Uppercase Characters . . Translation Table for Lowercase Characters . . Generic String Master Translation Table . . . ISPF and PDF Terminal Translation Table Relationship . . . . . . . . . . . . . PDF Foreground and Batch Customizing . . . . Foreground Processing Panels and CLISTs. . . Batch Processing Panels, CLISTs, and Skeletons ISRSCAN and ISRLEMX Programs . . . . . Customizing Edit and Browse Panels . . . . . Customizing Member List Panels . . . . . . . IBM Products Option . . . . . . . . . . . The ISPF Configuration Table . . . . . . . . Using the ISPF Configuration Utility Before Installation is Complete . . . . . . . . . The ISPF Configuration Utility . . . . . . Sample Configuration Table Keyword File . . . ISPF Configuration Table Fields . . . . . . ISPDFLTA and ISRCONFG Keywords Mapped PDF Installation-Wide Exits . . . . . . . . Data Set List Filter Exit . . . . . . . . . Data Set Allocation Exit . . . . . . . . . Activity Monitoring Exits . . . . . . . . 117 118 118 119 119 120 121 122 122 124 125 125 126 127 129 129 130 130 130 131 131 131 132 133 133 133 135 135 136 151 170 175 181 184 185 186 187 214 222 257 263 264 265 269 Exit 1: BROWSE Primary Command Start . . Exit 2: BROWSE Primary Command End . . Exit 3: EDIT Primary Command Start . . . Exit 4: EDIT Primary Command End . . . Exit 5: EDIT Macro Start. . . . . . . . Exit 6: EDIT Macro End . . . . . . . . Exit 7: EDIT Line Command Start . . . . Exit 8: EDIT Line Command End . . . . . Exit 9: Library/Data Set Utility Sub-function Start . . . . . . . . . . . . . . Exit 10: Library/Data Set Utility Sub-function End . . . . . . . . . . . . . . Exit 11: Data Set List Utility Line Command Start . . . . . . . . . . . . . . Exit 12: Data Set List Utility Line Command End . . . . . . . . . . . . . . Data Set List Line Command Exit . . . . Print Utility Exit . . . . . . . . . . Print Utility Exit on ISPF Termination and LOG/LIST Commands . . . . . . . . Compress Request Exit . . . . . . . . Data Set Name Change Exit . . . . . . Member List Filter Exit . . . . . . . . Member List Built-in Line Command Exit . . . . . . . . . . 270 270 270 270 271 271 271 271 . 272 . 272 . 272 . 273 . 274 . 275 . . . . . 277 279 281 283 285 Appendix A. Library Management Facility SVC and Address Space . . . 287 Simultaneous Started Tasks . . . . . . . . ABENDs Caused by Incorrect SVC Installation . RACF Considerations for LMF Exits . . . . . . 287 . 287 . 287 Appendix B. ISPF Data Set Integrity Enqueue, Member Name Enqueue and Message Queue Enqueue . . . . . . 289 Serializing with Non-ISPF TSO and BATCH . . ISPF Data Set Integrity Enqueue . . . . . . Member Name Enqueue. . . . . . . . . ISPF GUI TSO Linemode/TPUT/TGET Message Queue Enqueue . . . . . . . . . . . Workstation File Name Enqueue . . . . . . SCLM VSAM Enqueue . . . . . . . . . . 289 . 289 . 290 . 290 . 290 . 291 Appendix C. Dialog Development Model Listings . . . . . . . . . . . 293 DM and PDF Services in CLIST Commands . . DM and PDF Services in COBOL Programs . . DM and PDF Services in EXEC Commands . . DM and PDF Services in FORTRAN Programs . Message Format . . . . . . . . . . . Panel Formats and Statements . . . . . . . DM and PDF Services in PL/I Programs . . . File Tailoring Control Statements . . . . . . DM and PDF Services in Pascal Programs . . . DM and PDF Services in TSO/REXX Commands SCLM Architecture Definition Formats . . . . SCLM Project Definition Macros and Templates ISPF Dialog Tag Language Models . . . . . DM and PDF Services in C/370 Programs . . . Dialog Tag Language Models . . . . . . . . . . . . . . . . . . . . 293 295 298 300 303 303 306 309 309 312 315 315 315 316 319 | | iv OS/390 V2R10.0 ISPF Planning and Customizing Appendix D. Programming Interface Macros For Customers . . . . . . . 323 Appendix E. ISPF Data Set Descriptions . . . . . . . . . . . . 325 Notices . . . . . . . . . . . . . . 329 Programming Interface Information . Trademarks . . . . . . . . . . . . . . . . . . 330 . 330 Index . . . . . . . . . . . . . . . 331 Contents v vi OS/390 V2R10.0 ISPF Planning and Customizing Preface This book provides planning and customizing information for the Interactive System Productivity Facility (ISPF) product. ISPF assists in program development. It is designed to take advantage of the characteristics of IBM display terminals, and to increase programmer productivity in an interactive environment. About This Book This manual contains detailed information you need to: v Plan, install, and customize ISPF under MVS/System Product with the Time Sharing Option Extensions (TSO/E) v Select installation options v Modify the distributed release It also provides information about tailoring menus, options, and the online tutorial. Who Should Use This Book ISPF Planning and Customizing is designed for system programmers or other people whose responsibilities include installing and tailoring ISPF. You should be familiar with MVS, ISPF concepts and terminology as described in the ISPF Dialog Developer’s Guide and Reference and with the System Modification Program Extended (SMP/E). What Is in This Book This publication contains four chapters and four appendixes: v “Chapter 1. OS/390 V2R10.0 ISPF Planning” on page 1 describes planning procedures you need to know before installing ISPF. It also identifies the hardware and software requirements for running ISPF. v “Chapter 2. Customizing ISPF” on page 9 describes how to modify items that affect both the DM and PDF components to suit the needs of your installation. v “Chapter 3. Customizing DM” on page 53 describes how to modify items that affect the DM function of ISPF to suit the needs of your installation. v “Chapter 4. Customizing PDF” on page 117 describes how to modify the distributed release of PDF to suit the needs of your installation. v “Appendix A. Library Management Facility SVC and Address Space” on page 287 explains how to accommodate more than one started task under LMF and provides a list of common abend codes associated with attempts to use LMF under inappropriate conditions. v “Appendix B. ISPF Data Set Integrity Enqueue, Member Name Enqueue and Message Queue Enqueue” on page 289 explains how ISPF ensures data integrity. v “Appendix C. Dialog Development Model Listings” on page 293 lists all of the models shipped with PDF, any qualifiers, a short description, and the internal member name in the SKELS library shipped with PDF. v “Appendix D. Programming Interface Macros For Customers” on page 323 lists the macros provided by ISPF as programming interfaces. © Copyright IBM Corp. 1984, 2000 vii viii OS/390 V2R10.0 ISPF Planning and Customizing | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Summary of Changes OS/390 V2R10.0 ISPF contains the following changes and enhancements: v ISPF Product and Library Changes v ISPF Dialog Manager Component Changes v ISPF PDF Component Changes v ISPF SCLM Component Changes v ISPF Client/Server Component Changes ISPF Product Changes Changes to the ZENVIR variable. Characters 1 through 8 contain the product name and sequence number in the format ISPF x.y, where x.y indicates: v