version 2 release 4 z/os · 2019-07-23 · z/os version 2 release 4 mvs programming: sysplex...

1662
z/OS Version 2 Release 4 MVS Programming: Sysplex Services Reference IBM SA38-0658-40

Upload: others

Post on 03-Aug-2020

9 views

Category:

Documents


0 download

TRANSCRIPT

  • z/OSVersion 2 Release 4

    MVS Programming:Sysplex Services Reference

    IBM

    SA38-0658-40

  • Note

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

    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-09-21© Copyright International Business Machines Corporation 1994, 2020.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

  • Contents

    Figures............................................................................................................... xxi

    Tables.............................................................................................................. xxiii

    About this information......................................................................................xxviiWho should use this information............................................................................................................xxviiWhere to find more information............................................................................................................. xxvii

    How to send your comments to IBM................................................................... xxixIf you have a technical problem.............................................................................................................. xxix

    Summary of changes......................................................................................... xxxiSummary of changes for z/OS Version 2 Release 4................................................................................xxxiSummary of changes for z/OS Version 2 Release 3................................................................................xxxiSummary of changes.............................................................................................................................. xxxii

    Chapter 1. How to read syntax diagrams................................................................ 1Symbols........................................................................................................................................................1Syntax items.................................................................................................................................................1Syntax examples.......................................................................................................................................... 2

    Chapter 2. Specifying a Macro Version Number.......................................................3How to Request a Macro Version.................................................................................................................3General Considerations When Using PLISTVER..........................................................................................3

    Chapter 3. IHABLDP — Build Dump Parameter List Service..................................... 5Description................................................................................................................................................... 5Environment................................................................................................................................................. 6Programming Requirements........................................................................................................................6Restrictions.................................................................................................................................................. 6Input Register Information..........................................................................................................................6Output Register Information....................................................................................................................... 6Performance Implications........................................................................................................................... 7Understanding IHABLDP Version Support.................................................................................................. 7Syntax...........................................................................................................................................................7Parameter Descriptions............................................................................................................................... 8ABEND Codes.............................................................................................................................................12Return and Reason Codes......................................................................................................................... 12

    Chapter 4. IXCARM — Request Automatic Restart Management Services...............13Description................................................................................................................................................. 13Environment...............................................................................................................................................13Programming Requirements..................................................................................................................... 13Restrictions................................................................................................................................................ 14Input Register Information........................................................................................................................14Output Register Information..................................................................................................................... 14Performance Implications......................................................................................................................... 15Understanding IXCARM Version Support..................................................................................................15

    iii

  • Syntax.........................................................................................................................................................15Parameter Descriptions............................................................................................................................. 17ABEND Codes.............................................................................................................................................23Return and Reason Codes......................................................................................................................... 23Example......................................................................................................................................................47

    Chapter 5. IXCCFCM — Coupling Facility Configuration Management..................... 49Description................................................................................................................................................. 49Recovery Manager Concepts..................................................................................................................... 49Environment...............................................................................................................................................49Restrictions................................................................................................................................................ 50Input Register Information........................................................................................................................50Output Register Information..................................................................................................................... 50Programming Requirements..................................................................................................................... 50Performance Implications......................................................................................................................... 50Syntax Diagram.......................................................................................................................................... 51Parameter Descriptions............................................................................................................................. 51Return and Reason Codes......................................................................................................................... 52

    Chapter 6. IXCCREAT — Define a Member to XCF.................................................. 55Description................................................................................................................................................. 55Environment...............................................................................................................................................55Programming Requirements..................................................................................................................... 55Restrictions................................................................................................................................................ 55Input Register Information........................................................................................................................56Output Register Information..................................................................................................................... 56Performance Implications......................................................................................................................... 56Syntax Diagram.......................................................................................................................................... 56Parameter Descriptions............................................................................................................................. 57ABEND Codes.............................................................................................................................................59Return and Reason Codes......................................................................................................................... 59Example......................................................................................................................................................65

    Chapter 7. IXCDELET — Change an XCF Member's State to Not-Defined.................67Description................................................................................................................................................. 67Environment...............................................................................................................................................67Programming Requirements..................................................................................................................... 67Restrictions................................................................................................................................................ 67Input Register Information........................................................................................................................67Output Register Information..................................................................................................................... 67Performance Implications......................................................................................................................... 68Syntax Diagram.......................................................................................................................................... 68Parameter Descriptions............................................................................................................................. 68ABEND Codes.............................................................................................................................................69Return and Reason Codes......................................................................................................................... 69Example......................................................................................................................................................72

    Chapter 8. IXCJOIN — Place an XCF Member in the Active State........................... 73Description................................................................................................................................................. 73Environment...............................................................................................................................................73Programming Requirements..................................................................................................................... 74Restrictions................................................................................................................................................ 74Input Register Information........................................................................................................................74Output Register Information..................................................................................................................... 74Performance Implications......................................................................................................................... 75Understanding IXCJOIN Version Support.................................................................................................75Syntax Diagram.......................................................................................................................................... 75

    iv

  • Parameter Descriptions............................................................................................................................. 76ABEND Codes.............................................................................................................................................84Return and Reason Codes......................................................................................................................... 84Example......................................................................................................................................................92

    Chapter 9. IXCLEAVE — Place an XCF Member in the Not-Defined State................ 95Description................................................................................................................................................. 95Environment...............................................................................................................................................95Programming Requirements..................................................................................................................... 95Restrictions................................................................................................................................................ 95Input Register Information........................................................................................................................95Output Register Information..................................................................................................................... 95Performance Implications......................................................................................................................... 96Syntax Diagram.......................................................................................................................................... 96Parameter Descriptions............................................................................................................................. 96ABEND Codes.............................................................................................................................................98Return and Reason Codes......................................................................................................................... 98Example................................................................................................................................................... 102

    Chapter 10. IXCMG — Obtain Tuning and Capacity Planning Data........................ 103Description...............................................................................................................................................103Environment.............................................................................................................................................103Programming Requirements................................................................................................................... 104Restrictions..............................................................................................................................................104Input Register Information..................................................................................................................... 104Output Register Information................................................................................................................... 104Performance Implications.......................................................................................................................104Understanding IXCMG version support.................................................................................................. 104Syntax Diagram........................................................................................................................................105Parameter Descriptions...........................................................................................................................106ABEND Codes...........................................................................................................................................109Return and Reason Codes....................................................................................................................... 110Example................................................................................................................................................... 116

    Chapter 11. IXCMOD — Modify Status-Checking Interval.....................................117Description...............................................................................................................................................117Environment.............................................................................................................................................117Programming Requirements................................................................................................................... 117Restrictions..............................................................................................................................................117Input Register Information..................................................................................................................... 117Output Register Information................................................................................................................... 117Performance Implications.......................................................................................................................118Syntax Diagram........................................................................................................................................118Parameter Descriptions...........................................................................................................................118ABEND Codes...........................................................................................................................................120Return and Reason Codes....................................................................................................................... 120Example................................................................................................................................................... 123

    Chapter 12. IXCMSGC — XCF Message Control.................................................... 125Description...............................................................................................................................................125Environment.............................................................................................................................................125Programming Requirements................................................................................................................... 125Restrictions..............................................................................................................................................126Input Register Information..................................................................................................................... 126Output Register Information................................................................................................................... 126Understanding IXCMSGC Version Support............................................................................................. 126Syntax Diagram........................................................................................................................................127

    v

  • Parameter Descriptions...........................................................................................................................129ABEND Codes...........................................................................................................................................139Return and Reason Codes....................................................................................................................... 139

    Chapter 13. IXCMSGI — Receive a Message from Another Member in the XCFGroup............................................................................................................ 147

    Chapter 14. IXCMSGIX — Receive a Message from Another Member in the XCFGroup............................................................................................................ 149Description...............................................................................................................................................149Environment.............................................................................................................................................149Programming Requirements................................................................................................................... 150Restrictions..............................................................................................................................................150Input Register Information..................................................................................................................... 151Output Register Information................................................................................................................... 151Performance Implications.......................................................................................................................151Understanding IXCMSGIX Version Support............................................................................................151Syntax Diagram........................................................................................................................................152Parameter Descriptions...........................................................................................................................154ABEND Codes...........................................................................................................................................159Return and Reason Codes....................................................................................................................... 159Example................................................................................................................................................... 171

    Chapter 15. IXCMSGO — Send a Message to Another Member in the XCF Group... 173

    Chapter 16. IXCMSGOX — Send a Message to Another Member in the XCF Group. 175Description...............................................................................................................................................175Environment.............................................................................................................................................176Programming Requirements................................................................................................................... 177Restrictions..............................................................................................................................................178Input Register Information..................................................................................................................... 178Output Register Information................................................................................................................... 178Performance Implications.......................................................................................................................179Understanding IXCMSGOX Version Support...........................................................................................179Syntax Diagram........................................................................................................................................180Parameter Descriptions...........................................................................................................................183ABEND Codes...........................................................................................................................................196Return and reason codes.........................................................................................................................196Example................................................................................................................................................... 219

    Chapter 17. IXCNOTE — XCF Note Pad Interface................................................. 221Description...............................................................................................................................................221Environment.............................................................................................................................................222Programming Requirements................................................................................................................... 224Restrictions..............................................................................................................................................224Input Register Information..................................................................................................................... 225Output Register Information................................................................................................................... 225Performance Implications.......................................................................................................................226Understanding IXCNOTE Version Support..............................................................................................226Syntax...................................................................................................................................................... 226Parameters.............................................................................................................................................. 229

    Parameters Common to All Requests............................................................................................... 229Parameters for REQUEST=NOTEPAD................................................................................................ 232Parameters for REQUEST=CONNECTION......................................................................................... 237Parameters for REQUEST=NOTE....................................................................................................... 242Parameters for REQUEST=NOTES.....................................................................................................246

    vi

  • ABEND Codes...........................................................................................................................................250Return and Reason Codes....................................................................................................................... 250Examples..................................................................................................................................................274

    Chapter 18. IXCQUERY — Obtain XCF Information.............................................. 275Description...............................................................................................................................................275Environment.............................................................................................................................................276Programming Requirements................................................................................................................... 276Restrictions..............................................................................................................................................277Input Register Information..................................................................................................................... 277Output Register Information................................................................................................................... 277Performance Implications.......................................................................................................................278Understanding IXCQUERY Version Support........................................................................................... 278Syntax Diagram........................................................................................................................................278Parameter descriptions........................................................................................................................... 280Return and reason codes.........................................................................................................................288Example................................................................................................................................................... 296

    Chapter 19. IXCQUIES — Place an XCF Member in a Quiesced State.................... 299Description...............................................................................................................................................299Environment.............................................................................................................................................299Programming Requirements................................................................................................................... 299Restrictions..............................................................................................................................................299Input Register Information..................................................................................................................... 299Output Register Information................................................................................................................... 299Performance Implications.......................................................................................................................300Syntax Diagram........................................................................................................................................300Parameter Descriptions...........................................................................................................................300ABEND Codes...........................................................................................................................................302Return and Reason Codes....................................................................................................................... 302Example................................................................................................................................................... 306

    Chapter 20. IXCRECV— Receive Client/Server Information................................. 307Description...............................................................................................................................................307Environment.............................................................................................................................................307Programming Requirements................................................................................................................... 307Restrictions..............................................................................................................................................308Input Register Information..................................................................................................................... 308Output Register Information................................................................................................................... 308Performance Implications.......................................................................................................................308Understanding IXCRECV Version Support.............................................................................................. 308Syntax...................................................................................................................................................... 308Parameters.............................................................................................................................................. 309ABEND Codes...........................................................................................................................................314Return and Reason Codes....................................................................................................................... 314Example................................................................................................................................................... 320

    Chapter 21. IXCREQ — Format a Request for the XCF Server............................... 321Description...............................................................................................................................................321Environment.............................................................................................................................................321Programming Requirements................................................................................................................... 321Restrictions..............................................................................................................................................321Input Register Information..................................................................................................................... 322Output Register Information................................................................................................................... 322Performance Implications.......................................................................................................................322Syntax...................................................................................................................................................... 322Parameters.............................................................................................................................................. 322

    vii

  • ABEND Codes...........................................................................................................................................325Return and Reason Codes....................................................................................................................... 325Example................................................................................................................................................... 329

    Chapter 22. IXCSEND — Send Client/Server Requests and Responses................. 331Description...............................................................................................................................................331Environment.............................................................................................................................................331Programming Requirements................................................................................................................... 332Restrictions..............................................................................................................................................332Input Register Information..................................................................................................................... 332Output Register Information................................................................................................................... 332Performance Implications.......................................................................................................................333Understanding IXCSEND Version Support..............................................................................................333Syntax...................................................................................................................................................... 333Parameters.............................................................................................................................................. 336ABEND Codes...........................................................................................................................................347Return and Reason Codes....................................................................................................................... 347Examples..................................................................................................................................................365

    Chapter 23. IXCSETUS — Update the User State Field......................................... 367Description...............................................................................................................................................367Environment.............................................................................................................................................367Programming Requirements................................................................................................................... 367Restrictions..............................................................................................................................................367Input Register Information..................................................................................................................... 368Output Register Information................................................................................................................... 368Performance Implications.......................................................................................................................368Understanding IXCSETUS Version Support............................................................................................ 368Syntax Diagram........................................................................................................................................368Parameter Descriptions...........................................................................................................................369ABEND Codes...........................................................................................................................................371Return and Reason Codes....................................................................................................................... 371Example................................................................................................................................................... 377

    Chapter 24. IXCSRVR — Define a Server to XCF...................................................379Description...............................................................................................................................................379Environment.............................................................................................................................................379Programming Requirements................................................................................................................... 380Restrictions..............................................................................................................................................380Input Register Information..................................................................................................................... 380Output Register Information................................................................................................................... 381Performance Implications.......................................................................................................................381Syntax...................................................................................................................................................... 381Parameters.............................................................................................................................................. 382ABEND Codes...........................................................................................................................................388Return and Reason Codes....................................................................................................................... 388Example................................................................................................................................................... 396

    Chapter 25. IXCSYSCL — Notify the System that Cleanup Has Completed............397Description...............................................................................................................................................397Environment.............................................................................................................................................397Programming Requirements................................................................................................................... 397Restrictions..............................................................................................................................................397Input Register Information..................................................................................................................... 397Output Register Information................................................................................................................... 397Performance Implications.......................................................................................................................398Understanding IXCSYSCL Version Support.............................................................................................398

    viii

  • Syntax Diagram........................................................................................................................................398Parameter Descriptions...........................................................................................................................399ABEND Codes...........................................................................................................................................400Return and Reason Codes....................................................................................................................... 400Example................................................................................................................................................... 404

    Chapter 26. IXCTERM — Terminate a Member of an XCF Group............................413Description...............................................................................................................................................413Environment.............................................................................................................................................413Programming Requirements................................................................................................................... 414Restrictions..............................................................................................................................................414Input Register Information..................................................................................................................... 414Output Register Information................................................................................................................... 414Performance Implications.......................................................................................................................414Syntax Diagram........................................................................................................................................415Parameter Descriptions...........................................................................................................................415ABEND Codes...........................................................................................................................................416Return and Reason Codes....................................................................................................................... 416Example................................................................................................................................................... 420

    Chapter 27. IXLADUPX — Synchronize an asynchronously duplexed structure.....421Description...............................................................................................................................................421Environment.............................................................................................................................................421Programming requirements.................................................................................................................... 421Restrictions..............................................................................................................................................421Input register information....................................................................................................................... 422Output register information.....................................................................................................................422Performance implications....................................................................................................................... 422Understanding IXLADUPX version support.............................................................................................422Syntax diagram........................................................................................................................................ 423Parameter descriptions........................................................................................................................... 423Return and reason codes ........................................................................................................................425

    Chapter 28. IXLALTER — Alter a Coupling Facility Structure................................ 429Description...............................................................................................................................................429Environment.............................................................................................................................................430Input Register Information..................................................................................................................... 430Output Register Information................................................................................................................... 431Programming Requirements................................................................................................................... 431Performance Implications.......................................................................................................................431Understanding IXLALTER Version Support.............................................................................................431Syntax Diagram........................................................................................................................................432Parameter Descriptions...........................................................................................................................432Return and reason codes.........................................................................................................................435

    Chapter 29. IXLAXISN....................................................................................... 441Environment.............................................................................................................................................441Input Register Information..................................................................................................................... 441Output Register Information................................................................................................................... 441Programming Requirements................................................................................................................... 442Performance Implications.......................................................................................................................442Understanding IXLAXISN Version Support.............................................................................................442Syntax diagram........................................................................................................................................ 442Parameter Descriptions...........................................................................................................................443Return and reason codes.........................................................................................................................445

    Chapter 30. IXLCACHE — Cache Services............................................................451

    ix

  • Description...............................................................................................................................................451Environment.............................................................................................................................................452Programming Requirements................................................................................................................... 453Restrictions..............................................................................................................................................454Input Register Information..................................................................................................................... 454Output Register Information................................................................................................................... 454Performance Implications.......................................................................................................................455Understanding IXLCACHE Version Support............................................................................................ 455

    Chapter 31. IXLCACHE REQUEST=CASTOUT_DATA............................................ 457Description...............................................................................................................................................457Syntax Diagram........................................................................................................................................457Parameter Descriptions...........................................................................................................................459ABEND Codes...........................................................................................................................................466Return and Reason Codes....................................................................................................................... 466

    Chapter 32. IXLCACHE REQUEST=CASTOUT_DATALIST..................................... 479Description...............................................................................................................................................479Syntax Diagram........................................................................................................................................480Parameter Descriptions...........................................................................................................................482ABEND Codes...........................................................................................................................................489Return and Reason Codes....................................................................................................................... 489

    Chapter 33. IXLCACHE REQUEST=CROSS_INVAL............................................... 501Description...............................................................................................................................................501Syntax Diagram........................................................................................................................................501Parameter Descriptions...........................................................................................................................503ABEND Codes...........................................................................................................................................508Return and Reason Codes....................................................................................................................... 508

    Chapter 34. IXLCACHE REQUEST=CROSS_INVALLIST........................................ 517Description...............................................................................................................................................517Syntax Diagram........................................................................................................................................517Parameter Descriptions...........................................................................................................................519ABEND Codes...........................................................................................................................................525Return and Reason Codes....................................................................................................................... 525

    Chapter 35. IXLCACHE REQUEST=DELETE_NAME...............................................537Description...............................................................................................................................................537Syntax Diagram........................................................................................................................................537Parameter Descriptions...........................................................................................................................539ABEND Codes...........................................................................................................................................546Return and Reason Codes....................................................................................................................... 546

    Chapter 36. IXLCACHE REQUEST=DELETE_NAMELIST........................................555Description...............................................................................................................................................555Syntax Diagram........................................................................................................................................556Parameter Descriptions...........................................................................................................................558ABEND Codes...........................................................................................................................................567Return and Reason Codes....................................................................................................................... 567

    Chapter 37. IXLCACHE REQUEST=PROCESS_REFLIST........................................579Description...............................................................................................................................................579Syntax Diagram........................................................................................................................................579Parameter Descriptions...........................................................................................................................581ABEND Codes...........................................................................................................................................586

    x

  • Return and Reason Codes....................................................................................................................... 586

    Chapter 38. IXLCACHE REQUEST=READ_COCLASS.............................................597Description...............................................................................................................................................597Syntax Diagram........................................................................................................................................597Parameter Descriptions...........................................................................................................................599ABEND Codes...........................................................................................................................................607Return and Reason Codes....................................................................................................................... 607

    Chapter 39. IXLCACHE REQUEST=READ_COSTATS.............................................619Description...............................................................................................................................................619Syntax Diagram........................................................................................................................................619Parameter Descriptions...........................................................................................................................621ABEND Codes...........................................................................................................................................627Return and Reason Codes....................................................................................................................... 627

    Chapter 40. IXLCACHE REQUEST=READ_DATA.................................................. 639Description...............................................................................................................................................639Syntax Diagram........................................................................................................................................639Parameter Descriptions...........................................................................................................................641ABEND Codes...........................................................................................................................................650Return and Reason Codes....................................................................................................................... 650

    Chapter 41. IXLCACHE REQUEST=READ_DIRINFO............................................. 665Description...............................................................................................................................................665Syntax Diagram........................................................................................................................................665Parameter Descriptions...........................................................................................................................667ABEND Codes...........................................................................................................................................675Return and Reason Codes....................................................................................................................... 675

    Chapter 42. IXLCACHE REQUEST=READ_STGSTATS........................................... 687Description...............................................................................................................................................687Syntax Diagram........................................................................................................................................687Parameter Descriptions...........................................................................................................................688ABEND Codes...........................................................................................................................................691Return and Reason Codes....................................................................................................................... 691

    Chapter 43. IXLCACHE REQUEST=REG_NAMELIST............................................. 699Description...............................................................................................................................................699Syntax Diagram........................................................................................................................................699Parameter Descriptions...........................................................................................................................701ABEND Codes...........................................................................................................................................706Return and Reason Codes....................................................................................................................... 706

    Chapter 44. IXLCACHE REQUEST=RESET_REFBIT.............................................. 717Description...............................................................................................................................................717Syntax Diagram........................................................................................................................................717Parameter Descriptions...........................................................................................................................719ABEND Codes...........................................................................................................................................723Return and Reason Codes....................................................................................................................... 723

    Chapter 45. IXLCACHE REQUEST=SET_RECLVCTR..............................................731Description...............................................................................................................................................731Syntax Diagram........................................................................................................................................731Parameter Descriptions...........................................................................................................................732ABEND Codes...........................................................................................................................................736

    xi

  • Return and Reason Codes....................................................................................................................... 736

    Chapter 46. IXLCACHE REQUEST=UNLOCK_CASTOUT........................................ 745Description...............................................................................................................................................745Syntax Diagram........................................................................................................................................745Parameter Descriptions...........................................................................................................................747ABEND Codes...........................................................................................................................................753Return and Reason Codes....................................................................................................................... 753

    Chapter 47. IXLCACHE REQUEST=UNLOCK_CO_NAME........................................765Description...............................................................................................................................................765Syntax Diagram........................................................................................................................................765Parameter Descriptions...........................................................................................................................766ABEND Codes...........................................................................................................................................770Return and Reason Codes....................................................................................................................... 770

    Chapter 48. IXLCACHE REQUEST=WRITE_DATA................................................ 779Description...............................................................................................................................................779Syntax Diagram........................................................................................................................................780Parameter Descriptions...........................................................................................................................783ABEND Codes...........................................................................................................................................795Return and Reason Codes....................................................................................................................... 795

    Chapter 49. IXLCACHE REQUEST=WRITE_DATALIST......................................... 809Description...............................................................................................................................................809Syntax Diagram........................................................................................................................................810Parameter Descriptions...........................................................................................................................812ABEND Codes...........................................................................................................................................820Return and Reason Codes....................................................................................................................... 820

    Chapter 50. IXLCONN — Connect to a coupling facility structure..........................835Description...............................................................................................................................................835Environment.............................................................................................................................................836Restrictions..............................................................................................................................................837Input register information....................................................................................................................... 837Output register information.....................................................................................................................837Programming requirements.................................................................................................................... 838Performance implications....................................................................................................................... 838Understanding IXLCONN version support.............................................................................................. 838Syntax diagram........................................................................................................................................ 839Parameter descriptions........................................................................................................................... 843

    Parameters common to all structure types.......................................................................................843Parameters for TYPE=CACHE............................................................................................................ 859Parameters for TYPE=LIST................................................................................................................ 862Parameters for TYPE=LOCK...............................................................................................................867

    Return and reason codes for the IXLCONN macro................................................................................. 871

    Chapter 51. IXLCSP — XES Structure Computation Service................................. 889Description...............................................................................................................................................889Environment.............................................................................................................................................889Programming Requirements................................................................................................................... 889Input Register Information..................................................................................................................... 889Output Register Information................................................................................................................... 890Performance Implications.......................................................................................................................890Understanding IXLCSP version support..................................................................................................890Syntax diagram........................................................................................................................................ 891

    xii

  • Parameter descriptions........................................................................................................................... 893ABEND Codes...........................................................................................................................................902Return and Reason Codes....................................................................................................................... 902

    Chapter 52. IXLDISC — Disconnecting from a Coupling Facility Structure............ 911Description...............................................................................................................................................911Environment.............................................................................................................................................911Restrictions..............................................................................................................................................911Input Register Information..................................................................................................................... 911Output Register Information................................................................................................................... 912Programming Requirements................................................................................................................... 912Performance Implications.......................................................................................................................912Understanding IXLDISC Version Support............................................................................................... 912Syntax Diagram........................................................................................................................................912Parameter Descriptions...........................................................................................................................913Return and Reason Codes....................................................................................................................... 915

    Chapter 53. IXLEERSP — Responding to an Event............................................... 919Description...............................................................................................................................................919Environment.............................................................................................................................................919Restrictions..............................................................................................................................................920Input Register Information..................................................................................................................... 920Output Register Information................................................................................................................... 920Programming Requirements................................................................................................................... 920Performance Implications.......................................................................................................................920Understanding IXLEERSP Version Support.............................................................................................920Syntax Diagram........................................................................................................................................921Parameter Descriptions...........................................................................................................................921Return and Reason Codes....................................................................................................................... 924

    Chapter 54. IXLFCOMP — Wait for Completion or Obtain Status of an IXLLIST orIXLCACHE Request........................................................................................ 931Description...............................................................................................................................................931Environment.............................................................................................................................................931Programming Requirements................................................................................................................... 932Restrictions..............................................................................................................................................932Input Register Information..................................................................................................................... 932Output Register Information................................................................................................................... 932Performance Implications.......................................................................................................................933Syntax Diagram........................................................................................................................................933Parameter Descriptions...........................................................................................................................933ABEND Codes...........................................................................................................................................934Return and Reason Codes....................................................................................................................... 934

    Chapter 55. IXLFORCE — Deleting a Persistent Structure or Failed Connection.... 937Description...............................................................................................................................................937Environment.............................................................................................................................................938Restrictions..............................................................................................................................................938Input Register Information..................................................................................................................... 938Output Register Information................................................................................................................... 938Programming Requirements................................................................................................................... 939Performance Implications.......................................................................................................................939Syntax Diagram........................................................................................................................................939Parameter Descriptions...........................................................................................................................940Return and Reason Codes....................................................................................................................... 942

    xiii

  • Chapter 56. IXLLIST — List Services................................................................... 947Description...............................................................................................................................................947Environment.............................................................................................................................................948Programming Requirements................................................................................................................... 949Restrictions..............................................................................................................................................949Input Register Information..................................................................................................................... 950Output Register Information................................................................................................................... 950Performance Implications.......................................................................................................................950Understanding IXLLIST Version Support................................................................................................ 950

    Coding Equivalent Functions............................................................................................................. 951

    Chapter 57. IXLLIST REQUEST=DELETE............................................................. 953Description...............................................................................................................................................953Syntax Diagram........................................................................................................................................953Parameter Descriptions...........................................................................................................................956ABEND Codes...........................................................................................................................................967Return and Reason Codes....................................................................................................................... 967

    Chapter 58. IXLLIST REQUEST=DELETE_ENTRYLIST.......................................... 981Description...............................................................................................................................................981Syntax Diagram........................................................................................................................................981Parameter Descriptions...........................................................................................................................983ABEND Codes...........................................................................................................................................991Return and Reason Codes....................................................................................................................... 991

    Chapter 59. IXLLIST REQUEST=DELETE_MULT................................................. 1003Description.............................................................................................................................................1003Syntax Diagram......................................................................................................................................1003Parameter Descriptions.........................................................................................................................1005ABEND Codes........................................................................................................................................ 1011Return and Reason Codes.....................................................................................................................1011

    Chapter 60. IXLLIST REQUEST=DEQ_EVENTQ.................................................. 1021Description.............................................................................................................................................1021Syntax Diagram......................................................................................................................................1021Parameter Descriptions.........................................................................................................................1022ABEND Codes........................................................................................................................................ 1027Return and Reason Codes.....................................................................................................................1027

    Chapter 61. IXLLIST REQUEST=LOCK...............................................................1037Description.............................................................................................................................................1037Syntax Diagram......................................................................................................................................1037Parameter Descriptions.........................................................................................................................1039ABEND Codes........................................................................................................................................ 1043Return and Reason Codes.....................................................................................................................1043

    Chapter 62. IXLLIST REQUEST=MONITOR_EVENTQ..........................................1051Description.............................................................................................................................................1051Syntax Diagram......................................................................................................................................1051Parameter Descriptions.........................................................................................................................1052ABEND Codes........................................................................................................................................ 1056Return and Reason Codes.....................................................................................................................1056

    Chapter 63. IXLLIST REQUEST=MONITOR_LIST............................................... 1065Description.............................................................................................................................................1065

    xiv

  • Syntax Diagram......................................................................................................................................1065Parameter Descriptions.........................................................................................................................1067ABEND Codes........................................................................................................................................ 1070Return and Reason Codes.....................................................................................................................1070

    Chapter 64. IXLLIST REQUEST=MONITOR_SUBLIST......................................... 1079Description.............................................................................................................................................1079Syntax Diagram......................................................................................................................................1079Parameter Descriptions.........................................................................................................................1080ABEND Codes........................................................................................................................................ 1083Return and Reason Codes.....................................................................................................................1084

    Chapter 65. IXLLIST REQUEST=MONITOR_SUBLISTS....................................... 1091Description.............................................................................................................................................1091Syntax Diagram......................................................................................................................................1091Parameter Descriptions.........................................................................................................................1093ABEND Codes........................................................................................................................................ 1099Return and Reason Codes.....................................................................................................................1099

    Chapter 66. IXLLIST REQUEST