Recursion within a task-related user exit program...........290
Purging tasks ........................290
Using CICS services in your task-related user exit program .......291
Using channels and containers .................292
Assembler programs and LEASM ................292
Wait states in your task-related user exit program ..........292
Work areas .........................292
Coding a program to be invoked by the CICS SPI ..........293
Coding a program to be invoked by the CICS syncpoint manager.....293
Coding a program to be invoked by the CICS task manager.......297
Coding a program to be invoked at CICS termination .........298
Using EDF with your task-related user exit program ..........301
Administering the adapter ....................302
What you must do before using the adapter.............303
Tracing a task-related user exit program ..............304
Chapter 3. The user exit programming interface (XPI) .........305
Overview of the XPI ......................305
Making an XPI call .......................308
Setting up the XPI environment .................312
XPI register usage ......................312
The XPI copy books .....................313
Reentrancy considerations resulting from XPI calls ..........313
Global user exit XPI examples, showing the use of storage ........313
An example showing how to build a parameter list incrementally .....318
XPI syntax ..........................319
Directory domain XPI functions ..................321
The BIND_LDAP call .....................321
The END_BROWSE_RESULTS call................323
The FLUSH_LDAP_CACHE call .................323
The FREE_SEARCH_RESULTS call ...............324
The GET_ATTRIBUTE_VALUE call ................325
The GET_NEXT_ATTRIBUTE call ................326
The GET_NEXT_ENTRY call ..................327
The SEARCH_LDAP call....................328
The START_BROWSE_RESULTS call ...............329
The UNBIND_LDAP call ....................330
Dispatcher XPI functions .....................331
Synchronization protocols for SUSPEND and RESUME processing ....331
The ADD_SUSPEND call ...................334
The SUSPEND call ......................335
The RESUME call ......................339
The DELETE_SUSPEND call ..................340
The WAIT_MVS call .....................340
The CHANGE_PRIORITY call ..................344
Dump control XPI functions ....................345
The SYSTEM_DUMP call ...................345
The TRANSACTION_DUMP call .................347
Enqueue domain XPI functions ..................349
The ENQUEUE function ....................349
The DEQUEUE function ....................350
Kernel domain XPI functions ...................351
The START_PURGE_PROTECTION function ............351
The STOP_PURGE_PROTECTION function ............351
Nesting purge protection calls ..................352
Loader XPI functions ......................352
Contents v