z/OS 2.4 ISPF Services Guide IBM SC19-3626-40 Note Before using this information and the product it supports, read the information in “Notices” on page 399. This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2021-06-22 © Copyright International Business Machines Corporation 1980, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................ xv Tables................................................................................................................xvii Preface...............................................................................................................xix Who should use this document?............................................................................................................... xix What is in this document?......................................................................................................................... xix How to read the syntax diagrams..............................................................................................................xix z/OS information...............................................................................................xxiii How to send your comments to IBM.................................................................... xxv If you have a technical problem............................................................................................................... xxv Summary of changes........................................................................................ xxvii Summary of changes for z/OS Version 2 Release 4 (V2R4).................................................................. xxvii Summary of changes for z/OS Version 2 Release 3 (V2R3).................................................................. xxvii Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................xxviii What's in the library?........................................................................................ xxix Chapter 1. Introduction to ISPF services................................................................ 1 Description of the services.......................................................................................................................... 1 Using ISPQRY to test whether ISPF is active.............................................................................................. 1 Invoking the ISPF services.......................................................................................................................... 2 Load module search order......................................................................................................................2 Invoking services from command procedures...................................................................................... 3 Invoking ISPF services with program functions.................................................................................... 4 Return codes from services.......................................................................................................................11 Command invocation return code variable..........................................................................................12 Call invocation return code variables...................................................................................................12 Return code of 12 or higher................................................................................................................. 12 System variables used to format error messages............................................................................... 13 Return codes from I/O and command routines...................................................................................13 A summary of the ISPF services................................................................................................................14 Display services....................................................................................................................................14 File tailoring services............................................................................................................................14 Library access services........................................................................................................................ 14 PDF component services......................................................................................................................16 Table services.......................................................................................................................................17 Variable services.................................................................................................................................. 18 Miscellaneous services........................................................................................................................ 18 Chapter 2. Description of the ISPF services.......................................................... 21 ADDPOP—start pop-up window mode...................................................................................................... 21 Command invocation format................................................................................................................21 Call invocation format ......................................................................................................................... 21 Parameters........................................................................................................................................... 22 iii Return codes........................................................................................................................................ 22 Example................................................................................................................................................ 22 BRIF—Browse interface.............................................................................................................................23 Command invocation format................................................................................................................24 Call invocation format.......................................................................................................................... 24 Parameters........................................................................................................................................... 24 Dialog-supplied routines......................................................................................................................25 Return codes........................................................................................................................................ 27 Example................................................................................................................................................ 27 BROWSE—browse a data set.....................................................................................................................28 Command invocation format................................................................................................................28 Call invocation format.......................................................................................................................... 29 Parameters........................................................................................................................................... 29 Return codes........................................................................................................................................ 30 Example................................................................................................................................................ 31 CONTROL—set processing modes.............................................................................................................31 Command invocation format................................................................................................................32 Call invocation format.......................................................................................................................... 32 ADDPOP/REMPOP service in relation to CONTROL service................................................................ 33 Parameters........................................................................................................................................... 34 Return codes........................................................................................................................................ 38 Examples.............................................................................................................................................. 39 DIRLIST—directory list service ................................................................................................................. 39 Command invocation format................................................................................................................40 Call invocation format.........................................................................................................................