z/OSVersion 2 Release 4

MVS Programming: AuthorizedAssembler Services Reference, Volume 2(EDT-IXG)

IBM

SA23-1373-40

Note

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

This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.

Last updated: 2020-10-26© Copyright International Business Machines Corporation 1988, 2020.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

Figures............................................................................................................. xlvii

Tables............................................................................................................... xlix

About this document.............................................................................................lvWho should use this document...................................................................................................................lvHow to use this document.......................................................................................................................... lvz/OS information..........................................................................................................................................lv

How to send your comments to IBM.....................................................................lviiIf you have a technical problem................................................................................................................ lvii

Summary of changes............................................................................................lixSummary of changes for z/OS MVS Programming: Authorized Assembler Services Reference EDT-

IXG for Version 2 Release 4 (V2R4)...................................................................................................... lixSummary of changes for z/OS Version 2 Release 3................................................................................... lxSummary of changes for z/OS Version 2 Release 2 (V2R2), as updated December, 2015..................... lxi

Chapter 1. Using the services.................................................................................1Compatibility of MVS macros.......................................................................................................................1Addressing mode (AMODE)......................................................................................................................... 2Address space control (ASC) mode.............................................................................................................3

ALET qualification...................................................................................................................................3User parameters.....................................................................................................................................4

Telling the system about the execution environment ................................................................................5Specifying a macro version number............................................................................................................ 6

How to request a macro version using PLISTVER................................................................................. 6Register use..................................................................................................................................................7Handling return codes and reason codes....................................................................................................8

Handling program errors........................................................................................................................ 8Handling environmental and system errors.......................................................................................... 9

Using X-macros............................................................................................................................................ 9Macro forms............................................................................................................................................... 10

Conventional list form macros............................................................................................................. 10Alternative list form macros.................................................................................................................11

Coding the macros..................................................................................................................................... 11Continuation lines.................................................................................................................................13

Coding the callable services...................................................................................................................... 14Including equate (EQU) statements.................................................................................................... 14Link-editing linkage-assist routines.....................................................................................................15

Service summary....................................................................................................................................... 15

Chapter 2. EDTINFO — Obtain eligible device table information.............................27Description................................................................................................................................................. 27

Environment......................................................................................................................................... 27Programming requirements................................................................................................................. 27Restrictions...........................................................................................................................................27Input register information....................................................................................................................27Output register information................................................................................................................. 27

iii

Performance implications.................................................................................................................... 28Syntax................................................................................................................................................... 28Parameters........................................................................................................................................... 29Return and reason codes..................................................................................................................... 29Example................................................................................................................................................ 30

EDTINFO - List form...................................................................................................................................30Syntax................................................................................................................................................... 30Parameters........................................................................................................................................... 31

EDTINFO - Execute form........................................................................................................................... 31Syntax................................................................................................................................................... 31Parameters........................................................................................................................................... 32

EDTINFO - Modify form............................................................................................................................. 32Syntax................................................................................................................................................... 32Parameters........................................................................................................................................... 33

Chapter 3. ENFREQ — Listen for system events..................................................... 35Description................................................................................................................................................. 35

Environment......................................................................................................................................... 35Programming requirements................................................................................................................. 35Restrictions...........................................................................................................................................35Input register information....................................................................................................................36Output register information................................................................................................................. 36Performance implications.................................................................................................................... 36

LISTEN option............................................................................................................................................ 36Syntax................................................................................................................................................... 36Parameters........................................................................................................................................... 38ENF event codes and meanings...........................................................................................................43Return codes........................................................................................................................................ 60Example 1.............................................................................................................................................62Example 2.............................................................................................................................................63

DELETE option............................................................................................................................................63Syntax................................................................................................................................................... 63Parameters........................................................................................................................................... 64Return and reason codes..................................................................................................................... 64

ENFREQ ACTION=LISTEN - List form....................................................................................................... 65Syntax................................................................................................................................................... 65Parameters........................................................................................................................................... 66

ENFREQ ACTION=LISTEN - Execute form................................................................................................ 66Syntax................................................................................................................................................... 66Parameters........................................................................................................................................... 68

ENFREQ ACTION=DELETE - List form.......................................................................................................68Syntax................................................................................................................................................... 68Parameters........................................................................................................................................... 69

ENFREQ ACTION=DELETE - Execute form................................................................................................69Syntax................................................................................................................................................... 69Parameters........................................................................................................................................... 70

Chapter 4. ENQ — Request control of a serially reusable resource......................... 71Description................................................................................................................................................. 71

Environment......................................................................................................................................... 71Programming requirements................................................................................................................. 72Restrictions...........................................................................................................................................72Input register information....................................................................................................................72Output register information................................................................................................................. 72Performance implications.................................................................................................................... 73Syntax................................................................................................................................................... 73Parameters........................................................................................................................................... 75

iv

ABEND codes........................................................................................................................................79Return and reason codes..................................................................................................................... 79Example 1.............................................................................................................................................83Example 2.............................................................................................................................................83

ENQ - List form...........................................................................................................................................83Syntax................................................................................................................................................... 83Parameters........................................................................................................................................... 85

ENQ - Execute form................................................................................................................................... 85Syntax................................................................................................................................................... 85Parameters........................................................................................................................................... 87

Chapter 5. ESPIE — Extended SPIE...................................................................... 89Description................................................................................................................................................. 89

Environment......................................................................................................................................... 89Programming requirements................................................................................................................. 90Restrictions...........................................................................................................................................90Performance implications.................................................................................................................... 90ABEND codes........................................................................................................................................90

ESPIE SET option....................................................................................................................................... 90Input register information....................................................................................................................90Output register information................................................................................................................. 90Syntax................................................................................................................................................... 91Parameters........................................................................................................................................... 91Return and reason codes..................................................................................................................... 93Example................................................................................................................................................ 93

ESPIE SET - List form.................................................................................................................................93Syntax................................................................................................................................................... 93Parameters........................................................................................................................................... 94Example................................................................................................................................................ 94

ESPIE SET - Execute form......................................................................................................................... 94Syntax................................................................................................................................................... 94Parameters........................................................................................................................................... 95Example................................................................................................................................................ 95

ESPIE RESET option...................................................................................................................................95Input register information....................................................................................................................95Output register information................................................................................................................. 95Syntax................................................................................................................................................... 96Parameters........................................................................................................................................... 96Return and reason codes..................................................................................................................... 97Example................................................................................................................................................ 97

ESPIE TEST option..................................................................................................................................... 97Input register information....................................................................................................................97Output register information................................................................................................................. 97Syntax................................................................................................................................................... 97Parameters........................................................................................................................................... 98Return and reason codes..................................................................................................................... 98Example................................................................................................................................................ 99

Chapter 6. ESTAE and ESTAEX — Specify task abnormal exit extended............... 101Description...............................................................................................................................................101

Environment....................................................................................................................................... 102Programming requirements...............................................................................................................102Restrictions........................................................................................................................................ 102Input register information................................................................................................................. 102Output register information............................................................................................................... 102Performance implications..................................................................................................................103Syntax................................................................................................................................................. 103

v

Parameters......................................................................................................................................... 104ABEND codes..................................................................................................................................... 108Return and reason codes................................................................................................................... 108Example 1...........................................................................................................................................110Example 2...........................................................................................................................................110Example 3...........................................................................................................................................110Example 4...........................................................................................................................................110Example 5...........................................................................................................................................110

ESTAEX - Specify task abnormal exit extended..................................................................................... 110Environment....................................................................................................................................... 110Programming requirements...............................................................................................................111Restrictions........................................................................................................................................ 111Syntax................................................................................................................................................. 111Parameters......................................................................................................................................... 112ABEND codes..................................................................................................................................... 112Return and reason codes................................................................................................................... 112Example..............................................................................................................................................114

ESTAE and ESTAEX - List form................................................................................................................ 114Syntax................................................................................................................................................. 114Parameters......................................................................................................................................... 115

ESTAE or ESTAEX - Execute form........................................................................................................... 116Syntax................................................................................................................................................. 116Parameters......................................................................................................................................... 118

Chapter 7. ETCON — Connect entry table............................................................ 119Description...............................................................................................................................................119

Related macros.................................................................................................................................. 119Environment....................................................................................................................................... 119Programming requirements...............................................................................................................119Restrictions........................................................................................................................................ 119Input register information................................................................................................................. 120Output register information............................................................................................................... 120Performance implications..................................................................................................................120Syntax................................................................................................................................................. 120Parameters......................................................................................................................................... 121ABEND codes..................................................................................................................................... 121Return codes...................................................................................................................................... 121Examples............................................................................................................................................ 122

ETCON - List form.................................................................................................................................... 122Syntax................................................................................................................................................. 122Parameters......................................................................................................................................... 122

ETCON - Execute form.............................................................................................................................123Syntax................................................................................................................................................. 123Parameters......................................................................................................................................... 123

Chapter 8. ETCRE — Create entry table............................................................... 125Description...............................................................................................................................................125

Related macros.................................................................................................................................. 125Environment....................................................................................................................................... 125Programming requirements...............................................................................................................125Restrictions........................................................................................................................................ 125Input register information................................................................................................................. 125Output register information............................................................................................................... 126Performance implications..................................................................................................................126Syntax................................................................................................................................................. 126Parameters......................................................................................................................................... 127ABEND codes..................................................................................................................................... 127

vi

Return codes...................................................................................................................................... 127Example..............................................................................................................................................127

Chapter 9. ETDEF — Create an entry table descriptor (ETD)................................. 129Description...............................................................................................................................................129

Related macros.................................................................................................................................. 129Environment....................................................................................................................................... 129Programming requirements...............................................................................................................129Restrictions........................................................................................................................................ 130Register information.......................................................................................................................... 130Performance implications..................................................................................................................130TYPE=INITIAL, TYPE=ENTRY, and TYPE=FINAL parameters..........................................................130Syntax for TYPE=INITIAL, TYPE=ENTRY, and TYPE=FINAL............................................................ 130Parameters for TYPE=INITIAL, TYPE=ENTRY, and TYPE=FINAL.................................................... 132TYPE=SET parameter.........................................................................................................................135Syntax for TYPE=SET......................................................................................................................... 135Parameters for TYPE=SET................................................................................................................. 137ABEND codes..................................................................................................................................... 137Return and reason codes................................................................................................................... 138Example..............................................................................................................................................138

Chapter 10. ETDES — Destroy entry table........................................................... 139Description...............................................................................................................................................139

Related macros.................................................................................................................................. 139Environment....................................................................................................................................... 139Programming requirements...............................................................................................................139Restrictions........................................................................................................................................ 139Input register information................................................................................................................. 139Output register information............................................................................................................... 139Performance implications..................................................................................................................140Syntax................................................................................................................................................. 140Parameters......................................................................................................................................... 140ABEND codes..................................................................................................................................... 141Return codes...................................................................................................................................... 141Examples............................................................................................................................................ 141

ETDES - List form.....................................................................................................................................141Syntax................................................................................................................................................. 141Parameters......................................................................................................................................... 142

ETDES - Execute form..............................................................................................................................142Syntax................................................................................................................................................. 142Parameters......................................................................................................................................... 143

Chapter 11. ETDIS — Disconnect entry table.......................................................145Description...............................................................................................................................................145

Related macros.................................................................................................................................. 145Environment....................................................................................................................................... 145Programming requirements...............................................................................................................145Restrictions........................................................................................................................................ 145Input register information................................................................................................................. 145Output register information............................................................................................................... 145Performance implications..................................................................................................................146Syntax................................................................................................................................................. 146Parameters......................................................................................................................................... 146ABEND codes..................................................................................................................................... 147Return codes...................................................................................................................................... 147Examples............................................................................................................................................ 147

vii

Chapter 12. EVENTS — Wait for one or more events to complete..........................149Description...............................................................................................................................................149

Environment....................................................................................................................................... 149Programming requirements...............................................................................................................150Restrictions........................................................................................................................................ 150Input register information................................................................................................................. 150Output register information............................................................................................................... 150Performance implications..................................................................................................................150Syntax................................................................................................................................................. 150Parameters......................................................................................................................................... 151ABEND codes..................................................................................................................................... 152Return and reason codes................................................................................................................... 152Example 1...........................................................................................................................................153Example 2...........................................................................................................................................153

Chapter 13. EXTRACT — Extract TCB information................................................155Description...............................................................................................................................................155

Environment....................................................................................................................................... 155Programming requirements...............................................................................................................155Restrictions........................................................................................................................................ 155Performance implications..................................................................................................................155Syntax................................................................................................................................................. 156Parameters......................................................................................................................................... 156ABEND codes..................................................................................................................................... 157Return and reason codes................................................................................................................... 158Example 1...........................................................................................................................................158Example 2...........................................................................................................................................158Example 3...........................................................................................................................................158

EXTRACT - List form................................................................................................................................ 158Syntax................................................................................................................................................. 158Parameters......................................................................................................................................... 159

EXTRACT - Execute form.........................................................................................................................159Syntax................................................................................................................................................. 159Parameters......................................................................................................................................... 160

Chapter 14. FESTAE — Fast extended STAE........................................................ 161Description...............................................................................................................................................161

Environment....................................................................................................................................... 161Programming requirements...............................................................................................................161Restrictions........................................................................................................................................ 161Input register information................................................................................................................. 162Output register information............................................................................................................... 162Performance implications..................................................................................................................162Syntax................................................................................................................................................. 162Parameters......................................................................................................................................... 163ABEND codes..................................................................................................................................... 164Return codes...................................................................................................................................... 164Example..............................................................................................................................................165

Chapter 15. FRACHECK — Check user's authorization (for RACF Release 1.8.1 orearlier).......................................................................................................... 167

Chapter 16. FREEMAIN — Free virtual storage.................................................... 169Description...............................................................................................................................................169

Environment....................................................................................................................................... 169

viii

Programming requirements...............................................................................................................170Restrictions........................................................................................................................................ 170Input register information for SVC entry........................................................................................... 170Output register information for SVC entry.........................................................................................171Input register information for BRANCH=YES....................................................................................171Output register information for BRANCH=YES................................................................................. 171Input register information for BRANCH=(YES,GLOBAL)...................................................................172Output register information for BRANCH=(YES,GLOBAL)................................................................ 172Performance implications..................................................................................................................173Syntax................................................................................................................................................. 173Parameters......................................................................................................................................... 174ABEND codes..................................................................................................................................... 177Return and reason codes................................................................................................................... 177Example 1...........................................................................................................................................178Example 2...........................................................................................................................................178Example 3...........................................................................................................................................178Example 4...........................................................................................................................................178Example 5...........................................................................................................................................178

FREEMAIN - List form..............................................................................................................................179Parameters......................................................................................................................................... 180

FREEMAIN - Execute form...................................................................................................................... 180Parameters......................................................................................................................................... 181

Chapter 17. FXECNTRL — Maintain Function Exploitation and Enablement.......... 183

Chapter 18. GETDSAB — Accessing the DSAB chain............................................ 201Description...............................................................................................................................................201

Environment....................................................................................................................................... 201Programming requirements...............................................................................................................201Restrictions........................................................................................................................................ 201Register information.......................................................................................................................... 202Performance implications..................................................................................................................202Syntax................................................................................................................................................. 202Parameters......................................................................................................................................... 203Return and reason codes................................................................................................................... 204Example 1...........................................................................................................................................205Example 2...........................................................................................................................................205Example 3...........................................................................................................................................205Example 4...........................................................................................................................................205

GETDSAB - List form................................................................................................................................206Syntax................................................................................................................................................. 206Parameters......................................................................................................................................... 206

GETDSAB - Execute form........................................................................................................................ 206Syntax................................................................................................................................................. 206Parameters......................................................................................................................................... 207

Chapter 19. GETMAIN — Allocate virtual storage................................................ 209Description...............................................................................................................................................209

Environment....................................................................................................................................... 209Programming requirements...............................................................................................................211Restrictions........................................................................................................................................ 211Input register information for SVC entry........................................................................................... 211Output register information for SVC entry.........................................................................................211Input register information for BRANCH=YES....................................................................................212Output register information for BRANCH=YES................................................................................. 213Input register information for BRANCH=(YES,GLOBAL)...................................................................214Output register information for BRANCH=(YES,GLOBAL)................................................................ 214

ix

Performance implications..................................................................................................................215Syntax................................................................................................................................................. 215Parameters......................................................................................................................................... 217ABEND codes..................................................................................................................................... 223Return and reason codes................................................................................................................... 224Example 1...........................................................................................................................................225Example 2...........................................................................................................................................225Example 3...........................................................................................................................................225Example 4...........................................................................................................................................225Example 5...........................................................................................................................................226

Chapter 20. GQSCAN — Extract information from global resource serializationqueue............................................................................................................ 227Description...............................................................................................................................................227

Environment....................................................................................................................................... 227Programming requirements...............................................................................................................227Restrictions........................................................................................................................................ 227Input register information................................................................................................................. 228Output register information............................................................................................................... 228Performance implications..................................................................................................................228Syntax................................................................................................................................................. 229Parameters......................................................................................................................................... 230ABEND codes..................................................................................................................................... 233Return and reason codes................................................................................................................... 233

GQSCAN - List form................................................................................................................................. 235Parameters......................................................................................................................................... 237

GQSCAN - Execute form.......................................................................................................................... 237Parameters......................................................................................................................................... 239

Chapter 21. GTRACE — GTF trace recording........................................................ 241Description...............................................................................................................................................241GTRACE TEST.......................................................................................................................................... 241

Environment....................................................................................................................................... 241Programming requirements...............................................................................................................242Restrictions........................................................................................................................................ 242Input register information................................................................................................................. 242Output register information............................................................................................................... 242Performance implications..................................................................................................................242Syntax................................................................................................................................................. 242Parameters......................................................................................................................................... 243ABEND codes..................................................................................................................................... 243Return codes...................................................................................................................................... 243

GTRACE QUERY....................................................................................................................................... 243Environment....................................................................................................................................... 243Programming requirements...............................................................................................................244Restrictions........................................................................................................................................ 244Input register information................................................................................................................. 244Output register information............................................................................................................... 244Performance implications..................................................................................................................244Syntax................................................................................................................................................. 244Parameters......................................................................................................................................... 244ABEND codes..................................................................................................................................... 245Return codes...................................................................................................................................... 245

GTRACE DATA..........................................................................................................................................245Environment....................................................................................................................................... 245Programming requirements...............................................................................................................245Restrictions........................................................................................................................................ 245

x

Input register information................................................................................................................. 245Output register information............................................................................................................... 246Performance implications..................................................................................................................246Syntax................................................................................................................................................. 246Parameters......................................................................................................................................... 247ABEND codes..................................................................................................................................... 247Return codes...................................................................................................................................... 247Example..............................................................................................................................................248

GTRACE DATA - List form........................................................................................................................ 248Syntax................................................................................................................................................. 248Parameters......................................................................................................................................... 249

GTRACE DATA - Execute form.................................................................................................................249Syntax................................................................................................................................................. 249Parameters......................................................................................................................................... 250

Chapter 22. HISMT — HIS multithreading service............................................... 251Description...............................................................................................................................................251

Environment....................................................................................................................................... 251Programming requirements...............................................................................................................251Input register information................................................................................................................. 252Output register information............................................................................................................... 252Performance implications..................................................................................................................253Syntax................................................................................................................................................. 253Parameters......................................................................................................................................... 254ABEND codes..................................................................................................................................... 258Return and reason codes................................................................................................................... 258Example..............................................................................................................................................260

Chapter 23. HISSERV macro — HISSERV Service................................................ 263Description...............................................................................................................................................263

Environment....................................................................................................................................... 263Programming Requirements..............................................................................................................264Restrictions........................................................................................................................................ 264Input Register Information................................................................................................................ 264Output Register Information..............................................................................................................264Performance Implications................................................................................................................. 265Syntax................................................................................................................................................. 265Parameters......................................................................................................................................... 267ABEND Codes..................................................................................................................................... 270Return and Reason Codes..................................................................................................................270Example..............................................................................................................................................274

Chapter 24. HSPSERV — Read from and write to a Hiperspace............................ 277Description...............................................................................................................................................277Read and write services for standard hiperspaces................................................................................ 277

Environment....................................................................................................................................... 277Programming requirements...............................................................................................................278Restrictions........................................................................................................................................ 278Input register information................................................................................................................. 278Output register information............................................................................................................... 278Performance implications..................................................................................................................279Syntax................................................................................................................................................. 280Parameters......................................................................................................................................... 281ABEND codes..................................................................................................................................... 283Return and reason codes................................................................................................................... 283

Read and write services for ESO hiperspaces........................................................................................ 284Environment....................................................................................................................................... 284

xi

Programming requirements...............................................................................................................284Restrictions........................................................................................................................................ 284Input register information................................................................................................................. 285Output register information............................................................................................................... 285Performance implications..................................................................................................................285Syntax................................................................................................................................................. 286Parameters......................................................................................................................................... 287ABEND codes..................................................................................................................................... 289Return and reason codes................................................................................................................... 290

HSPSERV - List form................................................................................................................................ 290Syntax................................................................................................................................................. 290Parameters......................................................................................................................................... 291

HSPSERV - Execute form.........................................................................................................................292Syntax................................................................................................................................................. 292Parameters......................................................................................................................................... 293

HSPSERV - Modify form...........................................................................................................................293Syntax................................................................................................................................................. 293Parameters......................................................................................................................................... 295

Chapter 25. IARBRVEA — Verify virtual storage access (AR mode).......................297Description...............................................................................................................................................297

Environment....................................................................................................................................... 297Programming requirements...............................................................................................................297Restrictions........................................................................................................................................ 297Input register information................................................................................................................. 297Output register information............................................................................................................... 298Performance implications..................................................................................................................298Syntax................................................................................................................................................. 298Parameters......................................................................................................................................... 298ABEND codes..................................................................................................................................... 298Return and reason codes................................................................................................................... 298

Chapter 26. IARBRVER — Verify virtual storage access (primary address space).. 301Description...............................................................................................................................................301

Environment....................................................................................................................................... 301Programming requirements...............................................................................................................301Restrictions........................................................................................................................................ 301Input register information................................................................................................................. 301Output register information............................................................................................................... 301Performance implications..................................................................................................................302Syntax................................................................................................................................................. 302Parameters......................................................................................................................................... 302ABEND codes..................................................................................................................................... 302Return and reason codes................................................................................................................... 302

Chapter 27. IARBRVKA — Verify virtual storage access....................................... 305Description...............................................................................................................................................305

Environment....................................................................................................................................... 305Programming requirements...............................................................................................................305Restrictions........................................................................................................................................ 305Input register information................................................................................................................. 305Output register information............................................................................................................... 305Performance implications..................................................................................................................306Syntax................................................................................................................................................. 306Parameters......................................................................................................................................... 306ABEND codes..................................................................................................................................... 306Return and reason codes................................................................................................................... 306

xii

Chapter 28. IARBRVKR — Replacement for the TPROT instruction.......................307Description...............................................................................................................................................307

Environment....................................................................................................................................... 307Programming requirements...............................................................................................................307Restrictions........................................................................................................................................ 307Input register information................................................................................................................. 307Output register information............................................................................................................... 307Performance implications..................................................................................................................308Syntax................................................................................................................................................. 308Parameters......................................................................................................................................... 308ABEND codes..................................................................................................................................... 308Return and reason codes................................................................................................................... 308

Chapter 29. IARCP64 — 64-bit cell pool services.................................................309Description...............................................................................................................................................309

Environment....................................................................................................................................... 309Programming requirements...............................................................................................................310Restrictions........................................................................................................................................ 310Input register information................................................................................................................. 310Output register information............................................................................................................... 310Performance implications..................................................................................................................312Syntax................................................................................................................................................. 312Parameters......................................................................................................................................... 315ABEND codes..................................................................................................................................... 323Return and reason codes................................................................................................................... 323Examples............................................................................................................................................ 324

Chapter 30. IARR2V — Convert a central storage address to a virtual storageaddress......................................................................................................... 327Description...............................................................................................................................................327

Environment....................................................................................................................................... 327Programming requirements...............................................................................................................327Restrictions........................................................................................................................................ 327Input register information................................................................................................................. 327Output register information............................................................................................................... 327Performance implications..................................................................................................................328Syntax................................................................................................................................................. 328Parameters......................................................................................................................................... 329ABEND codes..................................................................................................................................... 330Return and reason codes................................................................................................................... 331Example 1...........................................................................................................................................331Example 2...........................................................................................................................................332Example 3...........................................................................................................................................332Example 4...........................................................................................................................................332

Chapter 31. IARST64 — 64-bit storage services.................................................. 333Description...............................................................................................................................................333

Environment....................................................................................................................................... 333Programming requirements...............................................................................................................334Restrictions........................................................................................................................................ 334Input register information................................................................................................................. 334Output register information............................................................................................................... 334Performance implications..................................................................................................................335Syntax................................................................................................................................................. 335Parameters......................................................................................................................................... 337ABEND codes..................................................................................................................................... 341

xiii

Return and reason codes................................................................................................................... 345

Chapter 32. IARSUBSP — Create and delete a subspace..................................... 347Description...............................................................................................................................................347

Environment....................................................................................................................................... 347Programming requirements...............................................................................................................347Restrictions........................................................................................................................................ 348Input register information................................................................................................................. 348Output register information............................................................................................................... 348Performance implications..................................................................................................................348Syntax................................................................................................................................................. 348Parameters......................................................................................................................................... 349ABEND codes..................................................................................................................................... 352Return and reason codes................................................................................................................... 352Example..............................................................................................................................................353

IARSUBSP - List form.............................................................................................................................. 354Parameters......................................................................................................................................... 354

IARSUBSP - Execute form....................................................................................................................... 354

Chapter 33. IARVSERV — Request to share virtual storage.................................. 357Description...............................................................................................................................................357

Environment....................................................................................................................................... 357Programming requirements...............................................................................................................358Restrictions........................................................................................................................................ 358Input register information................................................................................................................. 358Output register information............................................................................................................... 358Performance implications..................................................................................................................359Syntax................................................................................................................................................. 359Parameters......................................................................................................................................... 360ABEND codes..................................................................................................................................... 362Return and reason codes............................................................................