z/OSVersion 2 Release 3

JES3 Customization

IBM

SA32-1006-30

Note

Before using this information and the product it supports, read the information in “Notices” on page637.

This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise 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 withIBM Corp.

Contents

List of Figures..................................................................................................xxxixList of Tables....................................................................................................... xli

About this document..........................................................................................xliiiWho Should Use This Document.............................................................................................................. xliiiHow to Use This Document...................................................................................................................... xliiiWhere to Find More Information..............................................................................................................xliii

How to send your comments to IBM.....................................................................xlvIf you have a technical problem................................................................................................................ xlv

Summary of changes..........................................................................................xlviSummary of changes for z/OS Version 2 Release 3 (V2R3).................................................................... xlviSummary of changes for z/OS Version 2 Release 2 (V2R2).................................................................... xlviz/OS Version 2 Release 1 summary of changes......................................................................................xlvii

Chapter 1. JES3 Dynamic support programs and installation exit routines...............1Introduction................................................................................................................................................. 1Options for Executing User-written Programs............................................................................................ 1User-written Dynamic Support Programs................................................................................................... 2

Assembling and Link-editing a DSP....................................................................................................... 2Adding a DSP to JES3............................................................................................................................. 3Starting and Stopping a DSP.................................................................................................................. 4

Securing Your Installation Exits and DSPs.................................................................................................. 4Types of security calls in JES3............................................................................................................... 5Issuing a Security Call in JES3............................................................................................................... 7

Installation-Written Job Validation and Job Restart Routines................................................................... 8Overview of JES3 Validation/restart Processing................................................................................... 8Writing Your Own Validation/restart Routine.........................................................................................9Example of the Use of Some Fields in Validation................................................................................ 12

Installation Exit Routines.......................................................................................................................... 14Sample Command Exit (IATSMX01)..........................................................................................................15Sample MPF Exit (IATSMX02) — JES3 IAT6850 Message Processing.....................................................15Sample Command Exit (IATSMX03) — Command prefix management................................................... 16Determining the JES3 Release Level.........................................................................................................16Programming Conventions for Writing DSPs and Installation Exits......................................................... 18

Register Usage......................................................................................................................................20DSP Initialization and Termination Requirements.............................................................................. 21Module Loading.................................................................................................................................... 23ASAVE Linkage and Save Area Use...................................................................................................... 24Table-Referencing Techniques............................................................................................................ 24Restrictions on MVS Services Available to DSPs and Installation Exit Routines................................25JES3 Function Synchronization........................................................................................................... 26I/O for Tape, Unit Record, and BSC RJP Devices.................................................................................26Storage Management........................................................................................................................... 27Making Entries in the JES3 Trace Table...............................................................................................27Enqueuing and Locks........................................................................................................................... 28Accessing Spool-Resident Control Blocks...........................................................................................28Managing SWA (Scheduler Work Area) Control Blocks....................................................................... 29Conventions for Communicating with the System Operators.............................................................31Message processing............................................................................................................................. 33Routing Messages to a JES3 Global Address Space Exit (Installation Exits 69 and 70)....................37

iii

Choosing the appropriate macro to issue a message......................................................................... 38Guidelines for Issuing Multiline Messages.......................................................................................... 39Writing Installation Modifications for APPC/MVS................................................................................39

Testing a DSP or Installation Exit.............................................................................................................. 40Executing a DSP Under the Auxiliary Task................................................................................................ 40Executing a DSP or Installation Exit Routine in a C/I FSS Address Space............................................... 42Adding and Modifying the DEVICE Initialization Statement.....................................................................45

IATDEVA (Adding a DEVICE Statement).............................................................................................. 45IATDEVC (Modifying a DEVICE Statement)..........................................................................................46

Modifying Routines in an Output Writer FSS Address Space....................................................................49SNA/NJE Networking.................................................................................................................................49

Using Installation Exits to Modify Network Data.................................................................................50Format of NJE Header User Section.................................................................................................... 51

Coding Considerations for Installation Exits in 31-Bit Addressing Mode................................................ 52Adding an Installation Exit.........................................................................................................................52Installation Exits........................................................................................................................................ 53Return Codes for JES3 Installation Exits.................................................................................................. 53Installation of JES3 Installation Exits....................................................................................................... 55Installation Exits Listed by JES3 Function................................................................................................ 55CSECT Name: IATUX03 (Examine/Modify Converter/Interpreter Text Created from JCL)..................... 57

Environment......................................................................................................................................... 57Linkage Conventions............................................................................................................................ 57Information Supplied on Entry.............................................................................................................57Programming Considerations...............................................................................................................58Refresh Status...................................................................................................................................... 58Information Supplied on Exit............................................................................................................... 58

CSECT Name: IATUX04 (Examine the Job Information).......................................................................... 58Environment......................................................................................................................................... 59Linkage Conventions............................................................................................................................ 59Information Supplied on Entry.............................................................................................................59Programming Considerations...............................................................................................................59Refresh Status...................................................................................................................................... 59Information Supplied on Exit............................................................................................................... 59

CSECT Name: IATUX05 (Examine the Step Information).........................................................................60Environment......................................................................................................................................... 60Linkage Conventions............................................................................................................................ 60Information Supplied on Entry.............................................................................................................60Programming Considerations...............................................................................................................61Refresh Status...................................................................................................................................... 61Information Supplied on Exit............................................................................................................... 61

CSECT Name: IATUX06 (Examine the DD Statement Information)......................................................... 61Environment......................................................................................................................................... 61Linkage Conventions............................................................................................................................ 61Information Supplied on Entry.............................................................................................................62Programming Considerations...............................................................................................................62Refresh Status...................................................................................................................................... 62Information Supplied on Exit............................................................................................................... 62

CSECT Name: IATUX07 (Examine/Substitute Unit Type and Volume Serial Information)......................63Environment......................................................................................................................................... 63Linkage Conventions............................................................................................................................ 63Information Supplied on Entry.............................................................................................................63Programming Considerations...............................................................................................................63Refresh Status...................................................................................................................................... 64Information Supplied on Exit............................................................................................................... 64

CSECT Name: IATUX08 (Examine Setup Information).............................................................................64Environment......................................................................................................................................... 65Linkage Conventions............................................................................................................................ 65Information Supplied on Entry.............................................................................................................65

iv

Programming Considerations...............................................................................................................65Refresh Status...................................................................................................................................... 65Information Supplied on Exit............................................................................................................... 65

CSECT Name: IATUX09 (Examine Final Job Status, JST, and JVT)..........................................................66Environment......................................................................................................................................... 66Linkage Conventions............................................................................................................................ 66Information Supplied on Entry.............................................................................................................66Programming Considerations...............................................................................................................67Refresh Status...................................................................................................................................... 67Information Supplied on Exit............................................................................................................... 67

CSECT Name: IATUX10 (Generate a Message).........................................................................................68Environment......................................................................................................................................... 68Linkage Conventions............................................................................................................................ 68Information Supplied on Entry.............................................................................................................68Programming Considerations...............................................................................................................68Refresh Status...................................................................................................................................... 68Information Supplied on Exit............................................................................................................... 68

CSECT Name: IATUX11 (Inhibit Printing of the LOCATE Request/Response)......................................... 69Environment......................................................................................................................................... 69Linkage Conventions............................................................................................................................ 69Information Supplied on Entry.............................................................................................................69Programming Considerations...............................................................................................................70Refresh Status...................................................................................................................................... 70Information Supplied on Exit............................................................................................................... 70

CSECT Name: IATUX14 (Validate Fields in Spool Control Blocks During a JES3 Restart)...................... 71Environment......................................................................................................................................... 71Linkage Conventions............................................................................................................................ 71Information Supplied on Entry.............................................................................................................71Programming Considerations...............................................................................................................72Refresh Status...................................................................................................................................... 72Information Supplied on Exit............................................................................................................... 72

CSECT Name: IATUX15 (Scan an Initialization Statement)......................................................................73Environment......................................................................................................................................... 73Linkage Conventions............................................................................................................................ 73Information Supplied on Entry.............................................................................................................73Programming Considerations...............................................................................................................73Refresh Status...................................................................................................................................... 74Information Supplied on Exit............................................................................................................... 74

CSECT Name: IATUX17 (Define Set of Scheduler Elements)................................................................... 74Environment......................................................................................................................................... 74Linkage Conventions............................................................................................................................ 74Information Supplied on Entry.............................................................................................................74Programming Considerations...............................................................................................................75Refresh Status...................................................................................................................................... 75Information Supplied on Exit............................................................................................................... 75

CSECT Name: IATUX18 (Command Modification and Authority Validation)........................................... 75Notes on Usage.....................................................................................................................................76Environment......................................................................................................................................... 76Linkage Conventions............................................................................................................................ 76Information Supplied on Entry.............................................................................................................76Programming Considerations...............................................................................................................77Refresh Status...................................................................................................................................... 77Information Supplied on Exit............................................................................................................... 77

CSECT Name: IATUX19 (Examine/Modify Temporary OSE).....................................................................77Environment......................................................................................................................................... 78Linkage Conventions............................................................................................................................ 78Information Supplied on Entry.............................................................................................................78Programming Considerations...............................................................................................................78

v

Refresh Status...................................................................................................................................... 78Information Supplied on Exit............................................................................................................... 79

CSECT Name: IATUX20 (Create and Write Job Headers for Job Output)................................................ 79Environment......................................................................................................................................... 79Linkage Conventions............................................................................................................................ 80Information Supplied on Entry.............................................................................................................80Programming Considerations...............................................................................................................80Refresh Status...................................................................................................................................... 81Information Supplied on Exit............................................................................................................... 81

CSECT Name: IATUX21 (Create and Write Data Set Headers for Output Data Sets).............................. 81Environment......................................................................................................................................... 82Linkage Conventions............................................................................................................................ 82Information Supplied on Entry.............................................................................................................82Programming Considerations...............................................................................................................82Refresh Status...................................................................................................................................... 83Information Supplied on Exit............................................................................................................... 83

CSECT Name: IATUX22 (Examine/Alter the Forms Alignment)............................................................... 83Environment......................................................................................................................................... 83Linkage Conventions............................................................................................................................ 84Information Supplied on Entry.............................................................................................................84Programming Considerations...............................................................................................................84Refresh Status...................................................................................................................................... 85Information Supplied on Exit............................................................................................................... 85

CSECT Name: IATUX23 (Create and Write Job Trailers for Job Output)..................................................85Environment......................................................................................................................................... 85Linkage Conventions............................................................................................................................ 85Information Supplied on Entry.............................................................................................................85Programming Considerations...............................................................................................................86Refresh Status...................................................................................................................................... 86Information Supplied on Exit............................................................................................................... 87

CSECT Name: IATUX24 (Examine the Net Id and the Devices Requested).............................................87Environment......................................................................................................................................... 87Linkage Conventions............................................................................................................................ 87Information Supplied on Entry.............................................................................................................87Programming Considerations...............................................................................................................88Refresh Status...................................................................................................................................... 88Information Supplied on Exit............................................................................................................... 88

CSECT Name: IATUX25 (Examine/Modify Volume Serial Number)......................................................... 88Environment......................................................................................................................................... 88Linkage Conventions............................................................................................................................ 88Information Supplied on Entry.............................................................................................................89Programming Considerations...............................................................................................................89Refresh Status...................................................................................................................................... 89Information Supplied on Exit............................................................................................................... 89

CSECT Name: IATUX26 (Examine MVS Scheduler Control Blocks)......................................................... 90Environment......................................................................................................................................... 90Linkage Conventions............................................................................................................................ 90Information Supplied on Entry.............................................................................................................90Programming Considerations...............................................................................................................91Refresh Status...................................................................................................................................... 91Information Supplied on Exit............................................................................................................... 91

CSECT Name: IATUX27 (Examine/Alter the JDAB, JCT, and JMR)...........................................................91Environment......................................................................................................................................... 91Linkage Conventions............................................................................................................................ 92Information Supplied on Entry.............................................................................................................92Programming Considerations...............................................................................................................92Refresh Status...................................................................................................................................... 92Information Supplied on Exit............................................................................................................... 92

vi

CSECT Name: IATUX28 (Examine the JOB JCL Statement).....................................................................92Environment......................................................................................................................................... 93Linkage Conventions............................................................................................................................ 93Information Supplied on Entry.............................................................................................................93Programming Considerations...............................................................................................................93Refresh Status...................................................................................................................................... 93Information Supplied on Exit............................................................................................................... 93

CSECT Name: IATUX29 (Examine the Accounting Information)..............................................................94Dependencies.......................................................................................................................................94Environment......................................................................................................................................... 95Linkage Conventions............................................................................................................................ 95Information Supplied on Entry.............................................................................................................95Programming Considerations...............................................................................................................95Restrictions...........................................................................................................................................95Refresh Status...................................................................................................................................... 96Information Supplied on Exit............................................................................................................... 96

CSECT Name: IATUX30 (Examine Authority Level for TSO/E Terminal Commands)...............................96Environment......................................................................................................................................... 97Linkage Conventions............................................................................................................................ 97Information Supplied on Entry.............................................................................................................97Programming Considerations...............................................................................................................97Refresh Status...................................................................................................................................... 98Information Supplied on Exit............................................................................................................... 98

CSECT Name: IATUX32 (Override the DYNALDSN Initialization Statement)...........................................99Environment....................................................................................................................................... 100Linkage Conventions.......................................................................................................................... 100Information Supplied on Entry.......................................................................................................... 100Programming Considerations............................................................................................................ 100Refresh Status.................................................................................................................................... 100Information Supplied on Exit.............................................................................................................100

CSECT Name: IATUX33 (Modify JCL EXEC Statement and JES3 Control Statement)...........................101Environment....................................................................................................................................... 101Linkage Conventions.......................................................................................................................... 101Information Supplied on Entry.......................................................................................................... 101Programming Considerations............................................................................................................ 102Refresh Status.................................................................................................................................... 102Information Supplied on Exit.............................................................................................................102

CSECT Name: IATUX34 (Modify JCL DD Statement)..............................................................................102Environment....................................................................................................................................... 103Linkage Conventions.......................................................................................................................... 103Information Supplied on Entry.......................................................................................................... 103Programming Considerations............................................................................................................ 103Refresh Status.................................................................................................................................... 103Information Supplied on Exit.............................................................................................................103

CSECT Name: IATUX35 (Validity Check Network Commands).............................................................. 104Notes on Usage.................................................................................................................................. 104Environment....................................................................................................................................... 104Linkage Conventions.......................................................................................................................... 104Information Supplied on Entry.......................................................................................................... 104Programming Considerations............................................................................................................ 105Refresh Status.................................................................................................................................... 105Information Supplied on Exit.............................................................................................................105

CSECT Name: IATUX36 (Collect Accounting Information).....................................................................106Environment....................................................................................................................................... 106Linkage Conventions.......................................................................................................................... 106Information Supplied on Entry.......................................................................................................... 106Programming Considerations............................................................................................................ 107Refresh Status.................................................................................................................................... 107

vii

Information Supplied on Exit.............................................................................................................107CSECT Name: IATUX37 (Modify the JES3 Networking Data Set Header for Local Execution)............. 107

Environment....................................................................................................................................... 107Linkage Conventions.......................................................................................................................... 108Information Supplied on Entry.......................................................................................................... 108Programming Considerations............................................................................................................ 108Refresh Status.................................................................................................................................... 108Information Supplied on Exit.............................................................................................................108

CSECT Name: IATUX38 (Change the SYSOUT Class and Destination for Networking Data Sets)........ 109Environment....................................................................................................................................... 109Linkage Conventions.......................................................................................................................... 109Information Supplied on Entry.......................................................................................................... 109Programming Considerations............................................................................................................ 109Refresh Status.................................................................................................................................... 111Information Supplied on Exit.............................................................................................................111Setting Flags.......................................................................................................................................111

CSECT Name: IATUX39 (Modify the Data Set Header for a SYSOUT Data Set)..................................... 112Environment....................................................................................................................................... 112Linkage Conventions.......................................................................................................................... 112Information Supplied on Entry.......................................................................................................... 112Programming Considerations:........................................................................................................... 113Refresh Status.................................................................................................................................... 113Information Supplied on Exit.............................................................................................................113

CSECT Name: IATUX40 (Modify Job Header for a Network Stream Containing a Job).........................113Environment....................................................................................................................................... 113Linkage Conventions.......................................................................................................................... 114Programming Considerations............................................................................................................ 114Information Supplied on Entry.......................................................................................................... 114Refresh Status.................................................................................................................................... 114Information Supplied on Exit.............................................................................................................114

CSECT Name: IATUX41 (Determine the Disposition of a Job that Exceeds the Job JCL Limit)............115Environment....................................................................................................................................... 115Linkage Conventions.......................................................................................................................... 115Information Supplied on Entry.......................................................................................................... 115Programming Considerations............................................................................................................ 116Refresh Status.................................................................................................................................... 116Information Supplied on Exit.............................................................................................................116

CSECT Name: IATUX42 (TSO Interactive Data Transmission Facility Screening and Notification)...... 116Environment....................................................................................................................................... 117Linkage Conventions.......................................................................................................................... 117Information Supplied on Entry.......................................................................................................... 117Programming Considerations............................................................................................................ 117Refresh Status.................................................................................................................................... 118Information Supplied on Exit.............................................................................................................118

CSECT Name: IATUX43 (Modify Job Header for a Network Stream Containing SYSOUT Data)........... 119Environment....................................................................................................................................... 119Linkage Conventions.......................................................................................................................... 119Information Supplied on Entry.......................................................................................................... 119Programming Considerations............................................................................................................ 120Refresh Status.................................................................................................................................... 120Information Supplied on Exit.............................................................................................................120

CSECT Name: IATUX44 (Modify JCL Statements)..................................................................................120Environment....................................................................................................................................... 120Linkage Conventions.......................................................................................................................... 120Information Supplied on Entry.......................................................................................................... 120Programming Considerations............................................................................................................ 121Refresh Status.................................................................................................................................... 121Information Supplied on Exit.............................................................................................................121

viii

CSECT Name: IATUX45 (Change Job Information for Data Sets Processed by an Output Writer FSS)122Environment....................................................................................................................................... 122Linkage Conventions.......................................................................................................................... 122Information Supplied on Entry.......................................................................................................... 122Programming Considerations............................................................................................................ 122Refresh Status.................................................................................................................................... 123Information Supplied on Exit.............................................................................................................123

CSECT Name: IATUX46 (Select Processors Eligible for C/I Processing)............................................... 124Environment....................................................................................................................................... 124Linkage Conventions.......................................................................................................................... 124Information Supplied on Entry.......................................................................................................... 124Programming Considerations............................................................................................................ 125Refresh Status.................................................................................................................................... 125Information Supplied on Exit.............................................................................................................125

CSECT Name: IATUX48 (Override Operator Modification of Output Data Sets)....................................126Environment....................................................................................................................................... 126Linkage Conventions.......................................................................................................................... 126Information Supplied on Entry.......................................................................................................... 126Programming Considerations............................................................................................................ 126Refresh Status.................................................................................................................................... 126Information Supplied on Exit.............................................................................................................127

CSECT Name: IATUX49 (Override the Address Space Selected for C/I Processing)............................ 127Environment....................................................................................................................................... 127Linkage Conventions.......................................................................................................................... 127Information Supplied on Entry.......................................................................................................... 127Programming Considerations............................................................................................................ 128Refresh Status.................................................................................................................................... 128Information Supplied on Exit.............................................................................................................129

CSECT Name: IATUX50 (JES3 Unknown BSID Modifier Exit)................................................................ 129Environment....................................................................................................................................... 129Linkage Conventions.......................................................................................................................... 129Information Supplied on Entry.......................................................................................................... 129Programming Considerations............................................................................................................ 130Refresh Status.................................................................................................................................... 130Information Supplied on Exit.............................................................................................................130

CSECT Name: IATUX57 (Select a Single WTO Routing Code for JES3)................................................. 130Environment....................................................................................................................................... 131Linkage Conventions.......................................................................................................................... 131Programming Considerations............................................................................................................ 131Control Blocks Accessed by this Exit.................................................................................................131Information Supplied on Entry.......................................................................................................... 131Usage Notes....................................................................................................................................... 131Other Considerations:........................................................................................................................ 132Refresh Status.................................................................................................................................... 132Information Supplied on Exit.............................................................................................................132

CSECT Name: IATUX58 (Modify security information before JES3 security processing)..................... 132Environment....................................................................................................................................... 133Linkage Conventions.......................................................................................................................... 133Information Supplied on Entry.......................................................................................................... 133Programming Considerations............................................................................................................ 133Refresh Status.................................................................................................................................... 139Information Supplied on Exit.............................................................................................................139

CSECT Name: IATUX59 (Modify Security Information After JES3 Security Processing)...................... 140Environment....................................................................................................................................... 140Linkage Conventions.......................................................................................................................... 140Information Supplied on Entry.......................................................................................................... 140Programming Considerations............................................................................................................ 140Refresh Status.................................................................................................................................... 146

ix

Information Supplied on Exit.............................................................................................................146CSECT Name: IATUX60 (Determine Action to Take When a TSO User Is Unable to Receive a Data

Set)......................................................................................................................................................147Environment....................................................................................................................................... 147Linkage Conventions.......................................................................................................................... 147Information Supplied on Entry.......................................................................................................... 147Programming Considerations............................................................................................................ 147Refresh Status.................................................................................................................................... 147Information Supplied on Exit.............................................................................................................148

CSECT Name: IATUX61 (Cancel Jobs Going on the MDS Error Queue)................................................. 148Environment....................................................................................................................................... 148Linkage Conventions.......................................................................................................................... 148Information supplied on entry...........................................................................................................148Programming Considerations............................................................................................................ 149Refresh Status.................................................................................................................................... 149Information Supplied on Exit.............................................................................................................149

CSECT Name: IATUX62 (Verify a Mount Request)..................................................................................150Environment....................................................................................................................................... 150Linkage Conventions.......................................................................................................................... 150Information Supplied on Entry.......................................................................................................... 150Programming Considerations............................................................................................................ 151Refresh Status.................................................................................................................................... 151Information Supplied on Exit.............................................................................................................151

CSECT Name: IATUX63 (Provide SSI Subsystem Installation String Information)............................... 152Environment....................................................................................................................................... 152Linkage Conventions.......................................................................................................................... 152Information Supplied on Entry.......................................................................................................... 152Programming Considerations............................................................................................................ 152Refresh Status.................................................................................................................................... 153Information Supplied on Exit.............................................................................................................153

CSECT Name: IATUX66 (Determine Transmission Priority for a SNA/NJE Stream).............................. 154Environment....................................................................................................................................... 154Linkage Conventions.......................................................................................................................... 154Information Supplied on Entry.......................................................................................................... 154Programming Considerations............................................................................................................ 154Refresh Status.................................................................................................................................... 155Information Supplied on Exit.............................................................................................................155

CSECT Name: IATUX67 (Determine Action When Remote Data Set Is Rejected by RACF).................. 156Environment....................................................................................................................................... 156Linkage Conventions.......................................................................................................................... 156Information Supplied on Entry.......................................................................................................... 156Programming Considerations............................................................................................................ 157Refresh Status.................................................................................................................................... 157Information Supplied on Exit.............................................................................................................157

CSECT Name: IATUX68 (Modify Local NJE Job Trailers)........................................................................158Environment....................................................................................................................................... 158Linkage Conventions.......................................................................................................................... 158Programming Considerations............................................................................................................ 158Information Supplied on Entry.......................................................................................................... 158Refresh Status.................................................................................................................................... 159Information Supplied on Exit.............................................................................................................159

CSECT NAME: IATUX69 (Determine If a Message is to be Sent to the JES3 Global Address Space)...159Environment....................................................................................................................................... 160Information Supplied on Entry.......................................................................................................... 160Programming Considerations............................................................................................................ 161Refresh Status.................................................................................................................................... 161Information Supplied on Exit.............................................................................................................161

CSECT NAME: IATUX70 (Perform Additional Message Processing)...................................................... 162

x

Installing an Exit Routine................................................................................................................... 162Environment....................................................................................................................................... 162Information Supplied on Entry.......................................................................................................... 162Programming Considerations............................................................................................................ 164Refresh Status.................................................................................................................................... 164Information Supplied on Exit.............................................................................................................164

CSECT Name: IATUX71 (Modify a Tape Request Setup Message).........................................................164Environment....................................................................................................................................... 165Linkage Conventions.......................................................................................................................... 165Information Supplied on Entry.......................................................................................................... 165Programming Considerations............................................................................................................ 165Refresh Status.................................................................................................................................... 166Information Supplied on Exit.............................................................................................................166

CSECT Name: IATUX72 (Examine/Modify a Temporary OSE or an OSE Moved to Writer Queue)........ 166Environment....................................................................................................................................... 167Linkage Conventions.......................................................................................................................... 167Information Supplied on Entry.......................................................................................................... 167Programming Considerations............................................................................................................ 167Refresh Status.................................................................................................................................... 169Information Supplied on Exit.............................................................................................................169CSECT Name: IATUX73 (STT Record Deletion Disposition)............................................................. 169

Chapter 2. JES3 Macro instructions.................................................................... 173Introduction............................................................................................................................................. 173Coding Macro Instructions...................................................................................................................... 173

How to read syntax diagrams............................................................................................................ 173Meanings of Parameter Variables......................................................................................................175Rules for Continuation Lines..............................................................................................................176Rules for Register Usage....................................................................................................................177Rules for Addressing Mode................................................................................................................ 178

Executable macro instructions................................................................................................................178ERROR and NORMAL Parameters......................................................................................................181Dump Codes....................................................................................................................................... 181

ABACKR (Reposition Pointer in Multirecord File)................................................................................... 181Syntax................................................................................................................................................. 182Parameters......................................................................................................................................... 182Linkage............................................................................................................................................... 183Restrictions........................................................................................................................................ 183

ABLOCK (Add Record to a Multirecord File)............................................................................................183Syntax................................................................................................................................................. 183Parameters......................................................................................................................................... 183Linkage............................................................................................................................................... 184Restrictions........................................................................................................................................ 184

ABNCODE (Generate Global Symbol for Format Module)...................................................................... 184Syntax................................................................................................................................................. 184Parameters......................................................................................................................................... 185Linkage............................................................................................................................................... 185Restrictions........................................................................................................................................ 185

ABNCVDEC (Convert Data to Decimal)....................................................................................................185Syntax................................................................................................................................................. 185Parameters......................................................................................................................................... 185Linkage............................................................................................................................................... 186Restrictions........................................................................................................................................ 186

ABNCVHEX (Convert Data to Hexadecimal)........................................................................................... 186Syntax................................................................................................................................................. 186Parameters......................................................................................................................................... 186Linkage............................................................................................................................................... 186

xi

Restrictions........................................................................................................................................ 186ABNGET (Get Storage Address of a Specified Area)...............................................................................186

Syntax................................................................................................................................................. 187Parameters......................................................................................................................................... 187Linkage............................................................................................................................................... 187Restrictions........................................................................................................................................ 188

ABNPUT (Write a Line to the Dump Data Set).........................................................................................188Syntax................................................................................................................................................. 188Parameters......................................................................................................................................... 188Linkage............................................................................................................................................... 188Restrictions........................................................................................................................................ 188

ABNVRFY (Verify Specified Address)...................................................................................................... 188Syntax................................................................................................................................................. 188Parameters......................................................................................................................................... 188Linkage............................................................................................................................................... 189Restrictions........................................................................................................................................ 189

ACALL (Call a Routine)............................................................................................................................. 189Syntax................................................................................................................................................. 189Parameters......................................................................................................................................... 189Linkage............................................................................................................................................... 191Restrictions........................................................................................................................................ 191

ACLOSE (Close a Multirecord File).......................................................................................................... 191Syntax................................................................................................................................................. 191Parameters......................................................................................................................................... 191Linkage............................................................................................................................................... 192Restrictions........................................................................................................................................ 192

ACVX (Convert Binary Word to Hex)........................................................................................................192Syntax................................................................................................................................................. 192Linkage............................................................................................................................................... 192

ADEBLOCK (Retrieve a Record from a Multirecord File).........................................................................192Syntax................................................................................................................................................. 193Parameters......................................................................................................................................... 193Linkage............................................................................................................................................... 194Restrictions........................................................................................................................................ 194

ADELETE (Delete a Module).................................................................................................................... 194Syntax................................................................................................................................................. 194Parameters......................................................................................................................................... 194Linkage............................................................................................................................................... 196Restrictions........................................................................................................................................ 196

ADEQ (Release a JES3 Resource)........................................................................................................... 196Syntax................................................................................................................................................. 196Parameters......................................................................................................................................... 196Linkage............................................................................................................................................... 196Restrictions........................................................................................................................................ 196

AENQ (Obtain a JES3 Resource)............................................................................................................. 196Syntax................................................................................................................................................. 197Parameters......................................................................................................................................... 197Linkage............................................................................................................................................... 197Restrictions........................................................................................................................................ 197

AGETBUF (Get Buffer from JSAM Buffer Pool)....................................................................................... 198Syntax................................................................................................................................................. 198Parameters......................................................................................................................................... 198Linkage............................................................................................................................................... 198Restrictions........................................................................................................................................ 198

AGETMAIN (Get a Contiguous Storage Area)..........................................................................................198Syntax................................................................................................................................................. 199Parameters......................................................................................................................................... 199Linkage............................................................................................................................................... 200

xii

Restrictions........................................................................................................................................ 200AJOBNUM (Find or Return Job Number)................................................................................................ 200

Syntax................................................................................................................................................. 201Parameters......................................................................................................................................... 201Linkage............................................................................................................................................... 203Restrictions........................................................................................................................................ 203

ALOAD (Load a Module into Storage)...................................................................................................... 203Syntax................................................................................................................................................. 203Parameters......................................................................................................................................... 203Linkage............................................................................................................................................... 205Restrictions........................................................................................................................................ 205

ALOCATE (Locate Space for a Logical Record)........................................................................................205Syntax................................................................................................................................................. 205Parameters......................................................................................................................................... 205Linkage............................................................................................................................................... 206Restrictions........................................................................................................................................ 206

ANOTE (Note Location in a Multirecord File).......................................................................................... 206Syntax................................................................................................................................................. 206Parameters......................................................................................................................................... 206Linkage............................................................................................................................................... 206Restrictions........................................................................................................................................ 206

AOPEN (Open a Multirecord File)............................................................................................................ 206Syntax................................................................................................................................................. 207Parameters......................................................................................................................................... 207Linkage............................................................................................................................................... 208Restrictions........................................................................................................................................ 208Usage Notes....................................................................................................................................... 208

AOPEND (Open a Multirecord Output File)............................................................................................. 209Syntax................................................................................................................................................. 209Parameters......................................................................................................................................... 209Linkage............................................................................................................................................... 210Restrictions........................................................................................................................................ 210

APOINT (Reposition in Multirecord File).................................................................................................210Syntax................................................................................................................................................. 210Parameters......................................................................................................................................... 210Linkage............................................................................................................................................... 211Restrictions........................................................................................................................................ 211

APURGE (Purge a Single Record File)..................................................................................................... 211Syntax................................................................................................................................................. 211Parameters......................................................................................................................................... 211Linkage............................................................................................................................................... 212Restrictions........................................................................................................................................ 212

APUTBUF (Return a JSAM Buffer to the JSAM Buffer Pool)................................................................... 212Syntax................................................................................................................................................. 212Parameters......................................................................................................................................... 212Linkage............................................................................................................................................... 213Restrictions........................................................................................................................................ 213

APUTMAIN (Release a Contiguous Storage Area).................................................................................. 213Syntax................................................................................................................................................. 213Parameters......................................................................................................................................... 213Linkage............................................................................................................................................... 214Restrictions........................................................................................................................................ 214

ARELEASE (Restore Spool Address in FDB)............................................................................................214Syntax................................................................................................................................................. 214Parameters......................................................................................................................................... 214Linkage............................................................................................................................................... 214Restrictions...................................................................................................