z/OS Version 2 Release 3 ISPF Services Guide IBM SC19-3626-30 Note Before using this information and the product it supports, read the information in “Notices” on page 395. 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................................................................................................................ 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 3 (V2R3).................................................................. xxvii Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................xxviii Summary of changes for z/OS Version 2 Release 1 (V2R1)..................................................................xxviii What's in the z/OS V2R3 ISPF 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..........................................................................................11 Call invocation return code variables...................................................................................................11 Return code of 12 or higher................................................................................................................. 12 System variables used to format error messages............................................................................... 12 Return codes from I/O and command routines...................................................................................13 A summary of the ISPF services................................................................................................................13 Display services....................................................................................................................................14 File tailoring services............................................................................................................................14 Library access services........................................................................................................................ 14 PDF component services......................................................................................................................16 Table services.......................................................................................................................................16 Variable services.................................................................................................................................. 17 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................................................................................................................23 Call invocation format.......................................................................................................................... 24 Parameters........................................................................................................................................... 24 Dialog-supplied routines......................................................................................................................25 Return codes........................................................................................................................................ 26 Example................................................................................................................................................ 27 BROWSE—browse a data set.....................................................................................................................27 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.........................................................................................................................