Front cover Implementing REXX Support in SDSF Harness the power of SDSF with the versatility of REXX Write powerful REXX code to manage your environment Access SDSF outside of your mainframe Lydia Parziale Ludvik Drobnic Dario Facchinetti Richard Levey Amy Miu ibm.com/redbooks International Technical Support Organization Implementing REXX Support in SDSF June 2007 SG24-7419-00 Note: Before using this information and the product it supports, read the information in “Notices” on page xi. First Edition (June 2007) This edition applies to z/OS Release 1 Version 9 with APAR PK43448 Note: This book is based on a pre-GA version of a product and might not apply when the product becomes generally available. We recommend that you consult the product documentation or follow-on versions of this book for more current information. © Copyright International Business Machines Corporation 2007. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures . ix Notices . xi Trademarks . xii Preface . xiii The team that wrote this book . xiv Become a published author . xv Comments welcome. xvi Introduction and overview. 1 The REXX with SDSF interface . 2 Telling SDSF to execute commands . 4 Panel display commands . 5 New capabilities of REXX with SDSF in z/OS V1.9 . 11 SDSF programming practices . 13 Host environment verses interactive environment . 13 Recommendations . 14 Tune the command processing. 16 Areas to consider . 16 Debugging tools . 17 VERBOSE parameter . 17 SDSF trace . 17 Running REXX executables . 21 TSO/E address spaces . 21 Batch non TSO/E address spaces . 28 UNIX System Services address spaces . 31 Chapter 1. Issuing a system command. 37 1.1 Command environment . 38 1.2 Considerations when issuing a system command in the host command environment . 38 1.2.1 Console name . 38 1.2.2 Console type . 39 1.2.3 Command authority. 39 1.2.4 Delay time limit . 39 1.3 Customization . 39 1.4 ISFEXEC operands . 40 1.4.1 System command . 40 © Copyright IBM Corp. 2007. All rights reserved. iii 1.4.2 Other optional parameters . 41 1.5 Command output. 41 1.6 REXX for SDSF system command executable samples. 41 1.6.1 Sample REXX exec - @SYSCMD . 42 1.6.2 Scenario 1 - Use the system-determined EMCS console . 58 1.6.3 Scenario 2 - Use an internal console . 59 1.6.4 Scenario 3 - Use a specific EMCS console. 60 1.6.5 Scenario 4 - Request for the initial command response . 61 1.6.6 Scenario 5 - Request for all command responses . 63 1.6.7 Scenario 6 - Confirm the execution of the system command . 67 1.6.8 Scenario 7 - Query for a started task status . 68 1.6.9 Scenario 8 - Query for a device status . 70 1.6.10 Scenario 9 - Reply to the system command generated WTOR . 72 1.6.11 Scenario 10 - Confirm the execution of the system command and reply to its WTOR . 74 1.6.12 Scenario 11 - Confirm the execution of the system command and the reply to the WTOR . 76 1.6.13 Scenario 12 - Suppress all outputs . 78 Chapter 2. Copying SYSOUT to a PDS . 81 2.1 Background and overview of this scenario . 82 2.2 Input to BUILDPDS . 83 2.3 Program flow . 84 2.3.1 Decoding the arguments . 85 2.3.2 Deleting and reallocating the PDS . 88 2.3.3 Interfacing with IBM z/OS System Display and Search Facility . 89 2.3.4 Writing the data to the PDS. 93 2.4 Suggestions for continued development . 96 Chapter 3. Bulk job update processor. 97 3.1 Scenario description . 98 3.1.1 Tasks that this scenario accomplishes . 98 3.1.2 Testing the scenario . 102 3.2 Programming the interface . 102 3.2.1 Program flow . 103 3.2.2 Retrieving SYSOUT information . 105 3.2.3 Generic filter processing . 111 3.2.4 Processing the CANCEL and OVERTYPE commands. 112 3.3 Processing the EXECUTE command . 115 3.3.1 A sample CLIST . 117 iv Implementing REXX Support in SDSF 3.4 Future development . 120 Chapter 4. SDSF support for the COBOL language. 123 4.1 Understanding the middleware between a REXX exec and another language . 124 4.2 The pieces of REXDRIVR and how they work together . 126 4.2.1 The REX4SDSF exec . 126 4.3 The REXDRIVR interface program . 128 4.3.1 Entry point REXDRIVR - REX4SDSF function processor. 128 4.3.2 The Application Program’s view of SDSF: The parameter list . 135 4.3.3 Entry point REXXSDSF - Application program service routine . 139 4.4 Entry point REXXDONE - REX4SDSF completion routine . 143 4.4.1 Entry point REXXFREE - storage release routine. 147 4.5 The application programs included in the additional materials . 147 4.6 The COBOL point of view . 148 4.7 Improving the interface . 151 Chapter 5. Searching for a message in SYSLOG . 153 5.1 Scenario description . 154 5.2 Solving the issue with REXX with SDSF . 154 5.3 The actual code. 154 5.3.1 Parameters . 154 5.3.2 Program flow . 155 5.3.3 Configuring the SDSF execution environment . 156 5.3.4 Obtaining the SYSLOG job names ..