z/OS Version 2 Release 3 ISPF Dialog Developer's Guide and Reference IBM SC19-3619-30 Note Before using this information and the product it supports, read the information in “Notices” on page 403. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-06-21 © Copyright International Business Machines Corporation 1980, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................. ix Tables................................................................................................................ xiii Preface................................................................................................................xv About this document.................................................................................................................................. xv Who should use this document..................................................................................................................xv What is in this document?.......................................................................................................................... xv How to read the syntax diagrams..............................................................................................................xvi z/OS information.................................................................................................xxi How to send your comments to IBM................................................................... xxiii If you have a technical problem.............................................................................................................. xxiii Summary of changes.......................................................................................... xxv Summary of changes for z/OS Version 2 Release 3 (V2R3).................................................................... xxv Summary of changes for z/OS Version 2 Release 2 (V2R2).................................................................... xxv Summary of changes for z/OS Version 2 Release 1 (V2R1).................................................................... xxv What's in the z/OS V2R3 ISPF library?.............................................................. xxvii Chapter 1. Introduction to ISPF............................................................................. 1 What is ISPF?............................................................................................................................................... 1 What is a dialog?.......................................................................................................................................... 1 Functions................................................................................................................................................ 2 Variables................................................................................................................................................. 2 Command tables.....................................................................................................................................2 Panel definitions..................................................................................................................................... 3 Message definitions................................................................................................................................3 File-tailoring skeletons...........................................................................................................................3 Tables......................................................................................................................................................3 What does a dialog do?................................................................................................................................ 3 Developing a dialog......................................................................................................................................4 How dialog elements interact......................................................................................................................5 Dialog variables............................................................................................................................................7 Chapter 2. Controlling ISPF sessions......................................................................9 Dialog control and data flow........................................................................................................................ 9 Processing a dialog...................................................................................................................................... 9 Starting a dialog......................................................................................................................................... 10 Syntax for issuing the ISPSTART command........................................................................................ 10 Using the ISPSTART command............................................................................................................ 19 Invoking a dialog from a selection panel.............................................................................................19 Invoking a dialog from a master application menu.............................................................................20 Controlling ISPF sessions..........................................................................................................................20 Using the SHRPROF system command................................................................................................21 SHRPROF command syntax and parameter descriptions...................................................................21 iii What the SELECT service does..................................................................................................................23 Invoking the SELECT service................................................................................................................24 Terminating a dialog.............................................................................................................................25 Return Codes from Terminating Dialogs..............................................................................................25 An example using the ZISPFRC return code....................................................................................... 27 ISPF test and trace modes........................................................................................................................ 28 Test modes........................................................................................................................................... 28 ISPF trace modes................................................................................................................................. 29 Invoking authorized programs...................................................................................................................29 Invoking TSO commands...........................................................................................................................29 Compiled REXX requirements................................................................................................................... 30 CLIST requirements...................................................................................................................................30 Attention exits...................................................................................................................................... 30 Using APL2................................................................................................................................................. 32 Invoking APL2.......................................................................................................................................32 Executing APL2 functions.................................................................................................................... 34 Invoking ISPF dialog services in the APL2 environment.....................................................................34 APL2 workspace as the ISPF function pool.........................................................................................34 Interface between ISPF and APL2.......................................................................................................35 Subtasking support....................................................................................................................................35 ESTAE restrictions......................................................................................................................................36 ISPF services in batch mode..................................................................................................................... 36 Command processors in the TSO batch environment.........................................................................36 Batch display facility for background panel processing......................................................................37 ISPF graphical