1692
z/OS Version 2 Release 3 MVS Programming: Sysplex Services Reference IBM SA38-0658-30

Version 2 Release 3 z/OSfile/ieai700_v2r3.pdf · 2019-03-01 · z/OS Version 2 Release 3 MVS Programming: Sysplex Services Reference IBM SA38-0658-30

  • Upload
    others

  • View
    14

  • Download
    0

Embed Size (px)

Citation preview

  • z/OSVersion 2 Release 3

    MVS Programming:Sysplex Services Reference

    IBM

    SA38-0658-30

  • Note

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

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

    Last updated: 2019-02-16© Copyright International Business Machines Corporation 1994, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

  • Contents

    List of Figures..................................................................................................... xxiList of 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..........................................................................................xxxSummary of changes for z/OS Version 2 Release 3.................................................................................xxxSummary of changes................................................................................................................................ xxxSummary of changes for z/OS Version 2 Release 1 (V2R1) as updated March 2014........................... xxxiz/OS Version 2 Release 1 summary of changes......................................................................................xxxi

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

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

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

    Chapter 4. IXCARM — Request Automatic Restart Management Services............... 17Description................................................................................................................................................. 17Environment...............................................................................................................................................17Programming Requirements......................................................................................................................17Restrictions................................................................................................................................................ 18Input Register Information........................................................................................................................18Output Register Information..................................................................................................................... 18Performance Implications......................................................................................................................... 19Understanding IXCARM Version Support..................................................................................................19Syntax.........................................................................................................................................................19Parameter Descriptions............................................................................................................................. 21ABEND Codes.............................................................................................................................................27

    iii

  • Return and Reason Codes......................................................................................................................... 27Example......................................................................................................................................................51

    Chapter 5. IXCCFCM — Coupling Facility Configuration Management..................... 53Description................................................................................................................................................. 53Recovery Manager Concepts..................................................................................................................... 53Environment...............................................................................................................................................53Restrictions................................................................................................................................................ 54Input Register Information........................................................................................................................54Output Register Information..................................................................................................................... 54Programming Requirements......................................................................................................................54Performance Implications......................................................................................................................... 55Syntax Diagram.......................................................................................................................................... 55Parameter Descriptions............................................................................................................................. 57Return and Reason Codes......................................................................................................................... 58

    Chapter 6. IXCCREAT — Define a Member to XCF.................................................. 61Description................................................................................................................................................. 61Environment...............................................................................................................................................61Programming Requirements......................................................................................................................61Restrictions................................................................................................................................................ 61Input Register Information........................................................................................................................62Output Register Information..................................................................................................................... 62Performance Implications......................................................................................................................... 62Syntax Diagram.......................................................................................................................................... 62Parameter Descriptions............................................................................................................................. 64ABEND Codes.............................................................................................................................................65Return and Reason Codes......................................................................................................................... 66Example......................................................................................................................................................71

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

    Chapter 8. IXCJOIN — Place an XCF Member in the Active State............................81Description................................................................................................................................................. 81Environment...............................................................................................................................................81Programming Requirements......................................................................................................................82Restrictions................................................................................................................................................ 82Input Register Information........................................................................................................................82Output Register Information..................................................................................................................... 82Performance Implications......................................................................................................................... 83Understanding IXCJOIN Version Support.................................................................................................83Syntax Diagram.......................................................................................................................................... 83Parameter Descriptions............................................................................................................................. 85ABEND Codes.............................................................................................................................................92Return and Reason Codes......................................................................................................................... 92

    iv

  • Example................................................................................................................................................... 100

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

    Chapter 10. IXCMG — Obtain Tuning and Capacity Planning Data........................ 113Description...............................................................................................................................................113Environment.............................................................................................................................................113Programming Requirements................................................................................................................... 114Restrictions.............................................................................................................................................. 114Input Register Information......................................................................................................................114Output Register Information................................................................................................................... 114Performance Implications.......................................................................................................................115Understanding IXCMG version support.................................................................................................. 115Syntax Diagram........................................................................................................................................115Parameter Descriptions...........................................................................................................................116ABEND Codes...........................................................................................................................................120Return and Reason Codes....................................................................................................................... 120Example................................................................................................................................................... 127

    Chapter 11. IXCMOD — Modify Status-Checking Interval.....................................129Description...............................................................................................................................................129Environment.............................................................................................................................................129Programming Requirements................................................................................................................... 129Restrictions.............................................................................................................................................. 129Input Register Information......................................................................................................................130Output Register Information................................................................................................................... 130Performance Implications.......................................................................................................................130Syntax Diagram........................................................................................................................................130Parameter Descriptions...........................................................................................................................132ABEND Codes...........................................................................................................................................133Return and Reason Codes....................................................................................................................... 133Example................................................................................................................................................... 136

    Chapter 12. IXCMSGC — XCF Message Control.................................................... 137Description...............................................................................................................................................137Environment.............................................................................................................................................137Programming Requirements................................................................................................................... 137Restrictions.............................................................................................................................................. 138Input Register Information......................................................................................................................138Output Register Information................................................................................................................... 138Understanding IXCMSGC Version Support............................................................................................. 138Syntax Diagram........................................................................................................................................139Parameter Descriptions...........................................................................................................................142ABEND Codes...........................................................................................................................................152Return and Reason Codes....................................................................................................................... 152

    v

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

    Chapter 14. IXCMSGIX — Receive a Message from Another Member in the XCFGroup............................................................................................................ 163Description...............................................................................................................................................163Environment.............................................................................................................................................163Programming Requirements................................................................................................................... 164Restrictions.............................................................................................................................................. 164Input Register Information......................................................................................................................165Output Register Information................................................................................................................... 165Performance Implications.......................................................................................................................165Understanding IXCMSGIX Version Support............................................................................................165Syntax Diagram........................................................................................................................................166Parameter Descriptions...........................................................................................................................167ABEND Codes...........................................................................................................................................172Return and Reason Codes....................................................................................................................... 172Example................................................................................................................................................... 184

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

    Chapter 16. IXCMSGOX — Send a Message to Another Member in the XCF Group. 187Description...............................................................................................................................................187Environment.............................................................................................................................................188Programming Requirements................................................................................................................... 189Restrictions.............................................................................................................................................. 190Input Register Information......................................................................................................................190Output Register Information................................................................................................................... 190Performance Implications.......................................................................................................................191Understanding IXCMSGOX Version Support...........................................................................................191Syntax Diagram........................................................................................................................................192Parameter Descriptions...........................................................................................................................195ABEND Codes...........................................................................................................................................208Return and reason codes.........................................................................................................................208Example................................................................................................................................................... 231

    Chapter 17. IXCNOTE — XCF Note Pad Interface................................................. 233Description...............................................................................................................................................233Environment.............................................................................................................................................234Programming Requirements................................................................................................................... 236Restrictions.............................................................................................................................................. 236Input Register Information......................................................................................................................237Output Register Information................................................................................................................... 237Performance Implications.......................................................................................................................238Understanding IXCNOTE Version Support..............................................................................................238Syntax...................................................................................................................................................... 238Parameters...............................................................................................................................................241

    Parameters Common to All Requests................................................................................................241Parameters for REQUEST=NOTEPAD................................................................................................ 244Parameters for REQUEST=CONNECTION......................................................................................... 249Parameters for REQUEST=NOTE....................................................................................................... 254Parameters for REQUEST=NOTES..................................................................................................... 258

    ABEND Codes...........................................................................................................................................262Return and Reason Codes....................................................................................................................... 262Examples..................................................................................................................................................285

    vi

  • Chapter 18. IXCQUERY — Obtain XCF Information.............................................. 287Description...............................................................................................................................................287Environment.............................................................................................................................................288Programming Requirements................................................................................................................... 289Restrictions.............................................................................................................................................. 289Input Register Information......................................................................................................................289Output Register Information................................................................................................................... 289Performance Implications.......................................................................................................................290Understanding IXCQUERY Version Support............................................................................................290Syntax Diagram........................................................................................................................................291Parameter descriptions........................................................................................................................... 293Return and reason codes.........................................................................................................................301Example................................................................................................................................................... 309

    Chapter 19. IXCQUIES — Place an XCF Member in a Quiesced State.................... 311Description...............................................................................................................................................311Environment.............................................................................................................................................311Programming Requirements................................................................................................................... 311Restrictions.............................................................................................................................................. 311Input Register Information......................................................................................................................311Output Register Information................................................................................................................... 312Performance Implications.......................................................................................................................312Syntax Diagram........................................................................................................................................312Parameter Descriptions...........................................................................................................................314ABEND Codes...........................................................................................................................................315Return and Reason Codes....................................................................................................................... 315Example................................................................................................................................................... 319

    Chapter 20. IXCRECV— Receive Client/Server Information..................................321Description...............................................................................................................................................321Environment.............................................................................................................................................321Programming Requirements................................................................................................................... 321Restrictions.............................................................................................................................................. 322Input Register Information......................................................................................................................322Output Register Information................................................................................................................... 322Performance Implications.......................................................................................................................322Understanding IXCRECV Version Support.............................................................................................. 322Syntax...................................................................................................................................................... 323Parameters...............................................................................................................................................325ABEND Codes...........................................................................................................................................330Return and Reason Codes....................................................................................................................... 330Example................................................................................................................................................... 335

    Chapter 21. IXCREQ — Format a Request for the XCF Server................................337Description...............................................................................................................................................337Environment.............................................................................................................................................337Programming Requirements................................................................................................................... 337Restrictions.............................................................................................................................................. 338Input Register Information......................................................................................................................338Output Register Information................................................................................................................... 338Performance Implications.......................................................................................................................338Syntax...................................................................................................................................................... 338Parameters...............................................................................................................................................340ABEND Codes...........................................................................................................................................342Return and Reason Codes....................................................................................................................... 342Example................................................................................................................................................... 346

    vii

  • Chapter 22. IXCSEND — Send Client/Server Requests and Responses................. 347Description...............................................................................................................................................347Environment.............................................................................................................................................347Programming Requirements................................................................................................................... 348Restrictions.............................................................................................................................................. 348Input Register Information......................................................................................................................348Output Register Information................................................................................................................... 348Performance Implications.......................................................................................................................349Understanding IXCSEND Version Support..............................................................................................349Syntax...................................................................................................................................................... 349Parameters...............................................................................................................................................352ABEND Codes...........................................................................................................................................364Return and Reason Codes....................................................................................................................... 364Examples..................................................................................................................................................381

    Chapter 23. IXCSETUS — Update the User State Field......................................... 383Description...............................................................................................................................................383Environment.............................................................................................................................................383Programming Requirements................................................................................................................... 383Restrictions.............................................................................................................................................. 384Input Register Information......................................................................................................................384Output Register Information................................................................................................................... 384Performance Implications.......................................................................................................................384Understanding IXCSETUS Version Support............................................................................................ 384Syntax Diagram........................................................................................................................................385Parameter Descriptions...........................................................................................................................387ABEND Codes...........................................................................................................................................389Return and Reason Codes....................................................................................................................... 389Example................................................................................................................................................... 394

    Chapter 24. IXCSRVR — Define a Server to XCF...................................................397Description...............................................................................................................................................397Environment.............................................................................................................................................397Programming Requirements................................................................................................................... 398Restrictions.............................................................................................................................................. 398Input Register Information......................................................................................................................398Output Register Information................................................................................................................... 399Performance Implications.......................................................................................................................399Syntax...................................................................................................................................................... 399Parameters...............................................................................................................................................401ABEND Codes...........................................................................................................................................407Return and Reason Codes....................................................................................................................... 407Example................................................................................................................................................... 416

    Chapter 25. IXCSYSCL — Notify the System that Cleanup Has Completed............ 417Description...............................................................................................................................................417Environment.............................................................................................................................................417Programming Requirements................................................................................................................... 417Restrictions.............................................................................................................................................. 417Input Register Information......................................................................................................................418Output Register Information................................................................................................................... 418Performance Implications.......................................................................................................................418Understanding IXCSYSCL Version Support.............................................................................................418Syntax Diagram........................................................................................................................................418Parameter Descriptions...........................................................................................................................419ABEND Codes...........................................................................................................................................420

    viii

  • Return and Reason Codes....................................................................................................................... 420Example................................................................................................................................................... 424

    Chapter 26. IXCTERM — Terminate a Member of an XCF Group............................ 433Description...............................................................................................................................................433Environment.............................................................................................................................................433Programming Requirements................................................................................................................... 434Restrictions.............................................................................................................................................. 434Input Register Information......................................................................................................................434Output Register Information................................................................................................................... 434Performance Implications.......................................................................................................................435Syntax Diagram........................................................................................................................................435Parameter Descriptions...........................................................................................................................435ABEND Codes...........................................................................................................................................436Return and Reason Codes....................................................................................................................... 436Example................................................................................................................................................... 440

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

    Chapter 28. IXLALTER — Alter a Coupling Facility Structure................................ 449Description...............................................................................................................................................449Environment.............................................................................................................................................450Input Register Information......................................................................................................................451Output Register Information................................................................................................................... 451Programming Requirements................................................................................................................... 451Performance Implications.......................................................................................................................451Understanding IXLALTER Version Support............................................................................................. 452Syntax Diagram........................................................................................................................................452Parameter Descriptions...........................................................................................................................453Return and reason codes.........................................................................................................................455

    Chapter 29. IXLCACHE — Cache Services............................................................461Description...............................................................................................................................................461Environment.............................................................................................................................................463Programming Requirements................................................................................................................... 463Restrictions.............................................................................................................................................. 464Input Register Information......................................................................................................................464Output Register Information................................................................................................................... 464Performance Implications.......................................................................................................................465Understanding IXLCACHE Version Support............................................................................................ 465

    Chapter 30. IXLCACHE REQUEST=CASTOUT_DATA..............................................467Description...............................................................................................................................................467Syntax Diagram........................................................................................................................................467Parameter Descriptions...........................................................................................................................469ABEND Codes...........................................................................................................................................476

    ix

  • Return and Reason Codes....................................................................................................................... 477

    Chapter 31. IXLCACHE REQUEST=CASTOUT_DATALIST.......................................489Description...............................................................................................................................................489Syntax Diagram........................................................................................................................................490Parameter Descriptions...........................................................................................................................492ABEND Codes...........................................................................................................................................498Return and Reason Codes....................................................................................................................... 498

    Chapter 32. IXLCACHE REQUEST=CROSS_INVAL................................................ 511Description...............................................................................................................................................511Syntax Diagram........................................................................................................................................511Parameter Descriptions...........................................................................................................................513ABEND Codes...........................................................................................................................................517Return and Reason Codes....................................................................................................................... 517

    Chapter 33. IXLCACHE REQUEST=CROSS_INVALLIST......................................... 525Description...............................................................................................................................................525Syntax Diagram........................................................................................................................................525Parameter Descriptions...........................................................................................................................527ABEND Codes...........................................................................................................................................533Return and Reason Codes....................................................................................................................... 533

    Chapter 34. IXLCACHE REQUEST=DELETE_NAME............................................... 543Description...............................................................................................................................................543Syntax Diagram........................................................................................................................................543Parameter Descriptions...........................................................................................................................545ABEND Codes...........................................................................................................................................551Return and Reason Codes....................................................................................................................... 551

    Chapter 35. IXLCACHE REQUEST=DELETE_NAMELIST........................................ 561Description...............................................................................................................................................561Syntax Diagram........................................................................................................................................562Parameter Descriptions...........................................................................................................................564ABEND Codes...........................................................................................................................................572Return and Reason Codes....................................................................................................................... 572

    Chapter 36. IXLCACHE REQUEST=PROCESS_REFLIST.........................................585Description...............................................................................................................................................585Syntax Diagram........................................................................................................................................585Parameter Descriptions...........................................................................................................................587ABEND Codes...........................................................................................................................................593Return and Reason Codes....................................................................................................................... 593

    Chapter 37. IXLCACHE REQUEST=READ_COCLASS............................................. 603Description...............................................................................................................................................603Syntax Diagram........................................................................................................................................603Parameter Descriptions...........................................................................................................................605ABEND Codes...........................................................................................................................................613Return and Reason Codes....................................................................................................................... 613

    Chapter 38. IXLCACHE REQUEST=READ_COSTATS..............................................625Description...............................................................................................................................................625Syntax Diagram........................................................................................................................................625Parameter Descriptions...........................................................................................................................627ABEND Codes...........................................................................................................................................633

    x

  • Return and Reason Codes....................................................................................................................... 633

    Chapter 39. IXLCACHE REQUEST=READ_DATA................................................... 645Description...............................................................................................................................................645Syntax Diagram........................................................................................................................................645Parameter Descriptions...........................................................................................................................647ABEND Codes...........................................................................................................................................656Return and Reason Codes....................................................................................................................... 656

    Chapter 40. IXLCACHE REQUEST=READ_DIRINFO..............................................671Description...............................................................................................................................................671Syntax Diagram........................................................................................................................................671Parameter Descriptions...........................................................................................................................673ABEND Codes...........................................................................................................................................681Return and Reason Codes....................................................................................................................... 681

    Chapter 41. IXLCACHE REQUEST=READ_STGSTATS............................................ 693Description...............................................................................................................................................693Syntax Diagram........................................................................................................................................693Parameter Descriptions...........................................................................................................................694ABEND Codes...........................................................................................................................................698Return and Reason Codes....................................................................................................................... 698

    Chapter 42. IXLCACHE REQUEST=REG_NAMELIST............................................. 707Description...............................................................................................................................................707Syntax Diagram........................................................................................................................................707Parameter Descriptions...........................................................................................................................709ABEND Codes...........................................................................................................................................713Return and Reason Codes....................................................................................................................... 713

    Chapter 43. IXLCACHE REQUEST=RESET_REFBIT...............................................725Description...............................................................................................................................................725Syntax Diagram........................................................................................................................................725Parameter Descriptions...........................................................................................................................727ABEND Codes...........................................................................................................................................731Return and Reason Codes....................................................................................................................... 731

    Chapter 44. IXLCACHE REQUEST=SET_RECLVCTR.............................................. 739Description...............................................................................................................................................739Syntax Diagram........................................................................................................................................739Parameter Descriptions...........................................................................................................................741ABEND Codes...........................................................................................................................................744Return and Reason Codes....................................................................................................................... 744

    Chapter 45. IXLCACHE REQUEST=UNLOCK_CASTOUT......................................... 753Description...............................................................................................................................................753Syntax Diagram........................................................................................................................................753Parameter Descriptions...........................................................................................................................755ABEND Codes...........................................................................................................................................761Return and Reason Codes....................................................................................................................... 761

    Chapter 46. IXLCACHE REQUEST=UNLOCK_CO_NAME........................................ 773Description...............................................................................................................................................773Syntax Diagram........................................................................................................................................773Parameter Descriptions...........................................................................................................................775ABEND Codes...........................................................................................................................................778

    xi

  • Return and Reason Codes....................................................................................................................... 778

    Chapter 47. IXLCACHE REQUEST=WRITE_DATA................................................. 787Description...............................................................................................................................................787Syntax Diagram........................................................................................................................................788Parameter Descriptions...........................................................................................................................791ABEND Codes...........................................................................................................................................803Return and Reason Codes....................................................................................................................... 803

    Chapter 48. IXLCACHE REQUEST=WRITE_DATALIST.......................................... 817Description...............................................................................................................................................817Syntax Diagram........................................................................................................................................818Parameter Descriptions...........................................................................................................................820ABEND Codes...........................................................................................................................................827Return and Reason Codes....................................................................................................................... 827

    Chapter 49. IXLCONN — Connect to a coupling facility structure..........................843Description...............................................................................................................................................843Environment.............................................................................................................................................844Restrictions.............................................................................................................................................. 845Input register information....................................................................................................................... 845Output register information.....................................................................................................................845Programming requirements.................................................................................................................... 846Performance implications....................................................................................................................... 846Understanding IXLCONN version support.............................................................................................. 846Syntax diagram........................................................................................................................................ 847Parameter descriptions........................................................................................................................... 853

    Parameters common to all structure types.......................................................................................853Parameters for TYPE=CACHE............................................................................................................ 869Parameters for TYPE=LIST................................................................................................................ 872Parameters for TYPE=LOCK...............................................................................................................877

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

    Chapter 50. IXLCSP — XES Structure Computation Service................................. 897Description...............................................................................................................................................897Environment.............................................................................................................................................897Programming Requirements................................................................................................................... 897Input Register Information......................................................................................................................898Output Register Information................................................................................................................... 898Performance Implications.......................................................................................................................898Understanding IXLCSP version support..................................................................................................898Syntax diagram........................................................................................................................................ 899Parameter descriptions........................................................................................................................... 903ABEND Codes...........................................................................................................................................911Return and Reason Codes....................................................................................................................... 911

    Chapter 51. IXLDISC — Disconnecting from a Coupling Facility Structure............ 919Description...............................................................................................................................................919Environment.............................................................................................................................................919Restrictions.............................................................................................................................................. 919Input Register Information......................................................................................................................920Output Register Information................................................................................................................... 920Programming Requirements................................................................................................................... 920Performance Implications.......................................................................................................................920Understanding IXLDISC Version Support............................................................................................... 921Syntax Diagram........................................................................................................................................921Parameter Descriptions...........................................................................................................................921

    xii

  • Return and Reason Codes....................................................................................................................... 923

    Chapter 52. IXLEERSP — Responding to an Event............................................... 927Description...............................................................................................................................................927Environment.............................................................................................................................................927Restrictions.............................................................................................................................................. 928Input Register Information......................................................................................................................928Output Register Information................................................................................................................... 928Programming Requirements................................................................................................................... 928Performance Implications.......................................................................................................................928Understanding IXLEERSP Version Support.............................................................................................929Syntax Diagram........................................................................................................................................929Parameter Descriptions...........................................................................................................................930Return and Reason Codes....................................................................................................................... 933

    Chapter 53. IXLFCOMP — Wait for Completion or Obtain Status of an IXLLIST orIXLCACHE Request........................................................................................ 939Description...............................................................................................................................................939Environment.............................................................................................................................................939Programming Requirements................................................................................................................... 940Restrictions.............................................................................................................................................. 940Input Register Information......................................................................................................................940Output Register Information................................................................................................................... 940Performance Implications.......................................................................................................................941Syntax Diagram........................................................................................................................................941Parameter Descriptions...........................................................................................................................943ABEND Codes...........................................................................................................................................944Return and Reason Codes....................................................................................................................... 944

    Chapter 54. IXLFORCE — Deleting a Persistent Structure or Failed Connection.... 947Description...............................................................................................................................................947Environment.............................................................................................................................................948Restrictions.............................................................................................................................................. 948Input Register Information......................................................................................................................948Output Register Information................................................................................................................... 949Programming Requirements................................................................................................................... 949Performance Implications.......................................................................................................................949Syntax Diagram........................................................................................................................................949Parameter Descriptions...........................................................................................................................950Return and Reason Codes....................................................................................................................... 952

    Chapter 55. IXLLIST — List Services................................................................... 957Description...............................................................................................................................................957Environment.............................................................................................................................................958Programming Requirements................................................................................................................... 959Restrictions.............................................................................................................................................. 959Input Register Information......................................................................................................................960Output Register Information................................................................................................................... 960Performance Implications.......................................................................................................................960Understanding IXLLIST Version Support................................................................................................ 960

    Coding Equivalent Functions............................................................................................................. 961

    Chapter 56. IXLLIST REQUEST=DELETE..............................................................963Description...............................................................................................................................................963Syntax Diagram........................................................................................................................................963Parameter Descriptions...........................................................................................................................967

    xiii

  • ABEND Codes...........................................................................................................................................978Return and Reason Codes....................................................................................................................... 978

    Chapter 57. IXLLIST REQUEST=DELETE_ENTRYLIST.......................................... 991Description...............................................................................................................................................991Syntax Diagram........................................................................................................................................991Parameter Descriptions...........................................................................................................................994ABEND Codes........................................................................................................................................ 1002Return and Reason Codes..................................................................................................................... 1002

    Chapter 58. IXLLIST REQUEST=DELETE_MULT..................................................1015Description.............................................................................................................................................1015Syntax Diagram......................................................................................................................................1015Parameter Descriptions.........................................................................................................................1017ABEND Codes........................................................................................................................................ 1023Return and Reason Codes..................................................................................................................... 1023

    Chapter 59. IXLLIST REQUEST=DEQ_EVENTQ...................................................1033Description.............................................................................................................................................1033Syntax Diagram......................................................................................................................................1033Parameter Descriptions.........................................................................................................................1035ABEND Codes........................................................................................................................................ 1040Return and Reason Codes..................................................................................................................... 1040

    Chapter 60. IXLLIST REQUEST=LOCK............................................................... 1051Description.............................................................................................................................................1051Syntax Diagram......................................................................................................................................1051Parameter Descriptions.........................................................................................................................1053ABEND Codes........................................................................................................................................ 1057Return and Reason Codes..................................................................................................................... 1058

    Chapter 61. IXLLIST REQUEST=MONITOR_EVENTQ.......................................... 1065Description.............................................................................................................................................1065Syntax Diagram......................................................................................................................................1065Parameter Descriptions.........................................................................................................................1067ABEND Codes........................................................................................................................................ 1070Return and Reason Codes..................................................................................................................... 1070

    Chapter 62. IXLLIST REQUEST=MONITOR_LIST................................................1079Description.............................................................................................................................................1079Syntax Diagram......................................................................................................................................1079Parameter Descriptions.........................................................................................................................1081ABEND Codes........................................................................................................................................ 1084Return and Reason Codes..................................................................................................................... 1084

    Chapter 63. IXLLIST REQUEST=MONITOR_SUBLIST......................................... 1093Description.............................................................................................................................................1093Syntax Diagram......................................................................................................................................1093Parameter Descriptions.........................................................................................................................1095ABEND Codes........................................................................................................................................ 1098Return and Reason Codes..................................................................................................................... 1098

    Chapter 64. IXLLIST REQUEST=MONITOR_SUBLISTS....................................... 1107Description.............................................................................................................................................1107Syntax Diagram......................................................................................................................................1107Parameter Descriptions.........................................................................................................................1109

    xiv

  • ABEND Codes........................................................................................................................................ 1115Return and Reason Codes..................................................................................................................... 1115

    Chapter 65. IXLLIST REQUEST=MOVE.............................................................. 1127Description.............................................................................................................................................1127Syntax Diagram......................................................................................................................................1128Parameter Descriptions.........................................................................................................................1136ABEND Codes........................................................................................................................................ 1151Return and Reason Codes..................................................................................................................... 1151

    Chapter 66. IXLLIST REQUEST=READ...............................................................1167Description.............................................................................................................................................1167Syntax Diagram......................................................................................................................................1168Parameter Descriptions.....................................................