IBM SC34-6814-04 - Manual (Page 7)

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