z/OS Version 2 Release 3 TSO/E Programming Services IBM SA32-0973-30 Note Before using this information and the product it supports, read the information in “Notices” on page 515. 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-02-16 © Copyright International Business Machines Corporation 1988, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures..................................................................................................... xiii List of Tables.......................................................................................................xix About this document......................................................................................... xxiii Who should use this document............................................................................................................... xxiii How this document is organized............................................................................................................. xxiii How to use this document.......................................................................................................................xxiv Where to find more information............................................................................................................... xxv How to send your comments to IBM.................................................................. xxvii If you have a technical problem............................................................................................................. xxvii Summary of changes....................................................................................... xxviii Summary of changes for z/OS Version 2 Release 3 (V2R3)..................................................................xxviii Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................xxviii z/OS Version 2 Release 1 summary of changes....................................................................................xxviii Chapter 1. Introduction......................................................................................... 1 Programming using TSO/E........................................................................................................................... 1 Writing CLISTs.........................................................................................................................................1 Writing REXX Execs................................................................................................................................ 2 Writing servers........................................................................................................................................2 Writing command processors................................................................................................................ 2 Overview of TSO/E programming services.................................................................................................. 3 Invoking TSO/E service routines............................................................................................................ 5 Establishing a TSO/E environment outside of the TSO/E TMP and service routines............................5 Checking the syntax of subcommand names........................................................................................ 5 Checking the syntax of command and subcommand operands........................................................... 5 Communicating with the terminal user..................................................................................................5 Handling attention interruptions............................................................................................................5 Processing data sets...............................................................................................................................5 Analyzing return codes...........................................................................................................................6 Searching system lists............................................................................................................................6 Invoking commands, CLISTs, REXX execs and programs..................................................................... 7 Accessing CLIST and REXX variables.....................................................................................................7 Retrieving information from the names directory................................................................................. 7 Displaying printers for selection by the user......................................................................................... 7 Invoking an Information Center Facility application............................................................................. 7 Retrieving system messages issued during a console session............................................................. 7 Coding the macro instructions.....................................................................................................................7 Chapter 2. Considerations for using TSO/E services.............................................. 11 Determining the version and release of TSO/E installed.......................................................................... 11 General interface considerations.............................................................................................................. 11 AR mode............................................................................................................................................... 11 Primary mode....................................................................................................................................... 12 AMODE=24, RMODE=24...................................................................................................................... 12 AMODE=ANY, RMODE=24....................................................................................................................12 AMODE=31........................................................................................................................................... 12 Interface considerations for the TSO/E service routines....................................................................12 Summary of macro interfaces..............................................................................................................14 Interfacing with the TSO/E service routines............................................................................................. 15 iii The Command Processor parameter list............................................................................................. 15 Services that access data in the CPPL................................................................................................. 18 Chapter 3. Using the TSO/E Environment Service IKJTSOEV................................. 19 Overview of the TSO/E Environment Service............................................................................................ 19 When you should use the TSO/E Environment Service............................................................................ 19 Function of the TSO/E Environment Service............................................................................................. 20 TSO/E environment initialization - inside IKJTSOEV...........................................................................20 Capabilities available after initialization..............................................................................................20 Job step termination............................................................................................................................ 21 Restrictions and limitations on the use of TSO/E services..................................................................21 Summary of TSO/E services available under IKJTSOEV...........................................................................22 Syntax and parameter descriptions.......................................................................................................... 24 Invoking the TSO/E Environment Service................................................................................................. 24 Requirements and restrictions for invoking the TSO/E Environment Service.................................... 25 Return and reason codes from the TSO/E Environment Service..............................................................25 Examples using the TSO/E Environment Service......................................................................................27 COBOL...................................................................................................................................................27 Assembler.............................................................................................................................................30 JCL for COBOL and assembler program invocation............................................................................ 32 Chapter 4. Invoking TSO/E service routines with CALLTSSR.................................. 35 When to use the CALLTSSR macro instruction..........................................................................................35