+ All Categories
Home > Documents > Version 2 Release 3 z/OS - IBM...This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and...

Version 2 Release 3 z/OS - IBM...This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and...

Date post: 22-May-2020
Category:
Upload: others
View: 22 times
Download: 0 times
Share this document with a friend
1496
z/OS Version 2 Release 3 MVS Programming: Authorized Assembler Services Reference, Volume 2 (EDT-IXG) IBM SA23-1373-30
Transcript
  • z/OSVersion 2 Release 3

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

    IBM

    SA23-1373-30

  • Note

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

    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-03-26© 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................................................................................................... xlviiList of Tables......................................................................................................xlixAbout this document............................................................................................liii

    Who should use this document..................................................................................................................liiiHow to use this document..........................................................................................................................liiiz/OS information.........................................................................................................................................liii

    How to send your comments to IBM......................................................................livIf you have a technical problem................................................................................................................. liv

    Summary of changes.............................................................................................lvSummary of changes for z/OS Version 2 Release 3....................................................................................lvSummary of changes for z/OS Version 2 Release 2 (V2R2), as updated December, 2015......................lviSummary of changes for z/OS Version 2 Release 2...................................................................................lviSummary of changes for z/OS Version 2 Release 1, as updated February 2015.................................... lviiz/OS Version 2 Release 1 summary of changes.......................................................................................lviii

    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................................................................................................................. 28Performance implications.................................................................................................................... 28Syntax................................................................................................................................................... 28Parameters........................................................................................................................................... 29Return and reason codes..................................................................................................................... 29

    iii

  • Example................................................................................................................................................ 30EDTINFO - List form...................................................................................................................................30

    Syntax................................................................................................................................................... 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...........................................................................................................42Return codes........................................................................................................................................ 57Example 1.............................................................................................................................................59Example 2.............................................................................................................................................60

    DELETE option............................................................................................................................................61Syntax................................................................................................................................................... 61Parameters........................................................................................................................................... 61Return and reason codes..................................................................................................................... 62

    ENFREQ ACTION=LISTEN - List form........................................................................................................62Syntax................................................................................................................................................... 62Parameters........................................................................................................................................... 64

    ENFREQ ACTION=LISTEN - Execute form................................................................................................ 64Syntax................................................................................................................................................... 64Parameters........................................................................................................................................... 65

    ENFREQ ACTION=DELETE - List form....................................................................................................... 66Syntax................................................................................................................................................... 66Parameters........................................................................................................................................... 66

    ENFREQ ACTION=DELETE - Execute form................................................................................................66Syntax................................................................................................................................................... 67Parameters........................................................................................................................................... 67

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

    Environment......................................................................................................................................... 69Programming requirements................................................................................................................. 70Restrictions...........................................................................................................................................70Input register information....................................................................................................................70Output register information................................................................................................................. 70Performance implications.................................................................................................................... 71Syntax................................................................................................................................................... 71Parameters........................................................................................................................................... 73ABEND codes........................................................................................................................................77Return and reason codes..................................................................................................................... 77Example 1.............................................................................................................................................81Example 2.............................................................................................................................................81

    iv

  • ENQ - List form...........................................................................................................................................81Syntax................................................................................................................................................... 81Parameters........................................................................................................................................... 83

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

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

    Environment......................................................................................................................................... 87Programming requirements................................................................................................................. 88Restrictions...........................................................................................................................................88Performance implications.................................................................................................................... 88ABEND codes........................................................................................................................................88

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

    ESPIE SET - List form.................................................................................................................................91Syntax................................................................................................................................................... 91Parameters........................................................................................................................................... 92Example................................................................................................................................................ 92

    ESPIE SET - Execute form......................................................................................................................... 92Syntax................................................................................................................................................... 92Parameters........................................................................................................................................... 93Example................................................................................................................................................ 93

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

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

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

    Environment....................................................................................................................................... 100Programming requirements...............................................................................................................100Restrictions........................................................................................................................................ 100Input register information..................................................................................................................100Output register information............................................................................................................... 100Performance implications..................................................................................................................101Syntax................................................................................................................................................. 101Parameters......................................................................................................................................... 102ABEND codes..................................................................................................................................... 106Return and reason codes................................................................................................................... 106Example 1...........................................................................................................................................108

    v

  • Example 2...........................................................................................................................................108Example 3...........................................................................................................................................108Example 4...........................................................................................................................................108Example 5...........................................................................................................................................108

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

    ESTAE and ESTAEX - List form.................................................................................................................112Syntax................................................................................................................................................. 112Parameters......................................................................................................................................... 113

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

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

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

    ETCON - List form.................................................................................................................................... 120Syntax................................................................................................................................................. 120Parameters......................................................................................................................................... 120

    ETCON - Execute form............................................................................................................................. 121Syntax................................................................................................................................................. 121Parameters......................................................................................................................................... 121

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

    Related macros.................................................................................................................................. 123Environment....................................................................................................................................... 123Programming requirements...............................................................................................................123Restrictions........................................................................................................................................ 123Input register information..................................................................................................................123Output register information............................................................................................................... 124Performance implications..................................................................................................................124Syntax................................................................................................................................................. 124Parameters......................................................................................................................................... 125ABEND codes..................................................................................................................................... 125Return codes...................................................................................................................................... 125Example..............................................................................................................................................125

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

    vi

  • Description...............................................................................................................................................127Related macros.................................................................................................................................. 127Environment....................................................................................................................................... 127Programming requirements...............................................................................................................127Restrictions........................................................................................................................................ 128Register information...........................................................................................................................128Performance implications..................................................................................................................128TYPE=INITIAL, TYPE=ENTRY, and TYPE=FINAL parameters.......................................................... 128Syntax................................................................................................................................................. 128Parameters......................................................................................................................................... 130TYPE=SET parameter.........................................................................................................................133Syntax................................................................................................................................................. 133Parameters......................................................................................................................................... 135ABEND codes..................................................................................................................................... 135Return and reason codes................................................................................................................... 136Example..............................................................................................................................................136

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

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

    ETDES - List form..................................................................................................................................... 139Syntax................................................................................................................................................. 139Parameters......................................................................................................................................... 140

    ETDES - Execute form..............................................................................................................................140Syntax................................................................................................................................................. 140Parameters......................................................................................................................................... 141

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

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

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

    Environment....................................................................................................................................... 147Programming requirements...............................................................................................................148

    vii

  • Restrictions........................................................................................................................................ 148Input register information..................................................................................................................148Output register information............................................................................................................... 148Performance implications..................................................................................................................148Syntax................................................................................................................................................. 148Parameters......................................................................................................................................... 149ABEND codes..................................................................................................................................... 150Return and reason codes................................................................................................................... 151Example 1...........................................................................................................................................151Example 2...........................................................................................................................................151

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

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

    EXTRACT - List form................................................................................................................................ 156Syntax................................................................................................................................................. 156Parameters......................................................................................................................................... 157

    EXTRACT - Execute form......................................................................................................................... 157Syntax................................................................................................................................................. 157Parameters......................................................................................................................................... 158

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

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

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

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

    Environment....................................................................................................................................... 167Programming requirements...............................................................................................................168Restrictions........................................................................................................................................ 168Input register information for SVC entry........................................................................................... 168Output register information for SVC entry.........................................................................................169Input register information for BRANCH=YES.................................................................................... 169Output register information for BRANCH=YES..................................................................................169

    viii

  • Input register information for BRANCH=(YES,GLOBAL)................................................................... 170Output register information for BRANCH=(YES,GLOBAL).................................................................170Performance implications..................................................................................................................171Syntax................................................................................................................................................. 171Parameters......................................................................................................................................... 172ABEND codes..................................................................................................................................... 175Return and reason codes................................................................................................................... 175Example 1...........................................................................................................................................176Example 2...........................................................................................................................................176Example 3...........................................................................................................................................176Example 4...........................................................................................................................................176Example 5...........................................................................................................................................177

    FREEMAIN - List form..............................................................................................................................177Parameters......................................................................................................................................... 178

    FREEMAIN - Execute form...................................................................................................................... 178Parameters......................................................................................................................................... 179

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

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

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

    GETDSAB - List form................................................................................................................................204Syntax................................................................................................................................................. 204Parameters......................................................................................................................................... 204

    GETDSAB - Execute form........................................................................................................................ 204Syntax................................................................................................................................................. 205Parameters......................................................................................................................................... 205

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

    Environment....................................................................................................................................... 207Programming requirements...............................................................................................................209Restrictions........................................................................................................................................ 209Input register information for SVC entry........................................................................................... 209Output register information for SVC entry.........................................................................................209Input register information for BRANCH=YES.................................................................................... 210Output register information for BRANCH=YES..................................................................................210Input register information for BRANCH=(YES,GLOBAL)................................................................... 212Output register information for BRANCH=(YES,GLOBAL).................................................................212Performance implications..................................................................................................................213Syntax................................................................................................................................................. 213Parameters......................................................................................................................................... 215ABEND codes..................................................................................................................................... 221Return and reason codes................................................................................................................... 221Example 1...........................................................................................................................................223

    ix

  • Example 2...........................................................................................................................................223Example 3...........................................................................................................................................223Example 4...........................................................................................................................................223Example 5...........................................................................................................................................223

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

    Environment....................................................................................................................................... 225Programming requirements...............................................................................................................225Restrictions........................................................................................................................................ 225Input register information..................................................................................................................226Output register information............................................................................................................... 226Performance implications..................................................................................................................226Syntax................................................................................................................................................. 227Parameters......................................................................................................................................... 228ABEND codes..................................................................................................................................... 231Return and reason codes................................................................................................................... 231

    GQSCAN - List form................................................................................................................................. 233Parameters......................................................................................................................................... 235

    GQSCAN - Execute form.......................................................................................................................... 235Parameters......................................................................................................................................... 237

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

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

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

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

    x

  • Return codes...................................................................................................................................... 245Example..............................................................................................................................................246

    GTRACE DATA - List form.........................................................................................................................246Syntax................................................................................................................................................. 246Parameters......................................................................................................................................... 247

    GTRACE DATA - Execute form................................................................................................................. 247Syntax................................................................................................................................................. 247Parameters......................................................................................................................................... 248

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

    Environment....................................................................................................................................... 249Programming requirements...............................................................................................................249Input register information..................................................................................................................250Output register information............................................................................................................... 250Performance implications..................................................................................................................251Syntax................................................................................................................................................. 251Parameters......................................................................................................................................... 252ABEND codes..................................................................................................................................... 256Return and reason codes................................................................................................................... 256Example..............................................................................................................................................258

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

    Environment....................................................................................................................................... 261Programming Requirements..............................................................................................................262Restrictions........................................................................................................................................ 262Input Register Information................................................................................................................ 262Output Register Information..............................................................................................................262Performance Implications................................................................................................................. 263Syntax................................................................................................................................................. 263Parameters......................................................................................................................................... 265ABEND Codes..................................................................................................................................... 268Return and Reason Codes..................................................................................................................268Example..............................................................................................................................................272

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

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

    Read and write services for ESO hiperspaces........................................................................................ 282Environment....................................................................................................................................... 282Programming requirements...............................................................................................................282Restrictions........................................................................................................................................ 282Input register information..................................................................................................................283Output register information............................................................................................................... 283Performance implications..................................................................................................................283Syntax................................................................................................................................................. 284

    xi

  • Parameters......................................................................................................................................... 285ABEND codes..................................................................................................................................... 287Return and reason codes................................................................................................................... 288

    HSPSERV - List form................................................................................................................................ 288Syntax................................................................................................................................................. 288Parameters......................................................................................................................................... 289

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

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

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

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

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

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

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

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

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

    Environment....................................................................................................................................... 305Programming requirements...............................................................................................................305Restrictions........................................................................................................................................ 305

    xii

  • Input register information..................................................................................................................305Output register information............................................................................................................... 305Performance implications..................................................................................................................306Syntax................................................................................................................................................. 306Parameters......................................................................................................................................... 306ABEND codes..................................................................................................................................... 306Return and reason codes................................................................................................................... 306

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

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

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

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

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

    Environment....................................................................................................................................... 331Programming requirements...............................................................................................................332Restrictions........................................................................................................................................ 332Input register information..................................................................................................................332Output register information............................................................................................................... 332Performance implications..................................................................................................................333Syntax................................................................................................................................................. 333Parameters......................................................................................................................................... 335ABEND codes..................................................................................................................................... 339Return and reason codes................................................................................................................... 343

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

    Environment....................................................................................................................................... 345Programming requirements...............................................................................................................345

    xiii

  • Restrictions........................................................................................................................................ 346Input register information..................................................................................................................346Output register information............................................................................................................... 346Performance implications..................................................................................................................346Syntax................................................................................................................................................. 346Parameters......................................................................................................................................... 347ABEND codes..................................................................................................................................... 350Return and reason codes................................................................................................................... 350Example..............................................................................................................................................351

    IARSUBSP - List form.............................................................................................................................. 352Parameters......................................................................................................................................... 352

    IARSUBSP - Execute form....................................................................................................................... 352

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

    Environment....................................................................................................................................... 355Programming requirements...............................................................................................................356Restrictions........................................................................................................................................ 356Input register information..................................................................................................................356Output register information............................................................................................................... 356Performance implications..................................................................................................................357Syntax................................................................................................................................................. 357Parameters..........................................................................................................................


Recommended