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

Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
What this book is about . . . . . . . . . . . . . . . . . . . . . xvii
Who this book is for . . . . . . . . . . . . . . . . . . . . . . . xvii
What you need to know to understand this book . . . . . . . . . . . . xvii
How to use this book . . . . . . . . . . . . . . . . . . . . . . xvii
Notes on terminology . . . . . . . . . . . . . . . . . . . . . . xvii
Syntax notation and conventions used in this book . . . . . . . . . . . xviii
Summary of changes . . . . . . . . . . . . . . . . . . . . . . xix
Changes for CICS Transaction Server for z/OS, Version 3 Release 2 . . . . . xix
Changes for CICS Transaction Server for z/OS, Version 3 Release 1 . . . . . xix
Changes for CICS Transaction Server for z/OS, Version 2 Release 3 . . . . . xx
Part 1. Customizing with user exit programs . . . . . . . . . . . . . . . . . . 1
Chapter 1. Global user exit programs . . . . . . . . . . . . . . . . 3
Writing global user exit programs
. . . . . . . . . . . . . . . . . . 3
Register conventions . . . . . . . . . . . . . . . . . . . . . . 3
31-bit addressing implications . . . . . . . . . . . . . . . . . . . 4
Using CICS services . . . . . . . . . . . . . . . . . . . . . . 4
Using channels and containers
. . . . . . . . . . . . . . . . . . 5
Assembler programs and LEASM . . . . . . . . . . . . . . . . . 6
EDF and global user exits . . . . . . . . . . . . . . . . . . . . 6
The global work area . . . . . . . . . . . . . . . . . . . . . . 6
Making trace entries . . . . . . . . . . . . . . . . . . . . . . 6
Parameters passed to the global user exit program . . . . . . . . . . . 7
Returning values to CICS . . . . . . . . . . . . . . . . . . . . 10
Restrictions on the use of fields as programming interfaces
. . . . . . . 11
Exit programs and the CICS storage protection facility . . . . . . . . . 11
Errors in user exit programs . . . . . . . . . . . . . . . . . . . 12
Defining, enabling, and disabling an exit program . . . . . . . . . . . . 12
Viewing active global user exits . . . . . . . . . . . . . . . . . . . 13
Invoking more than one exit program at a single exit . . . . . . . . . . . 13
Invoking a single exit program at more than one exit . . . . . . . . . . . 14
Making programs threadsafe . . . . . . . . . . . . . . . . . . . . 14
Sample global user exit programs . . . . . . . . . . . . . . . . . . 15
Basic sample and example programs . . . . . . . . . . . . . . . 15
Sample programs for specific exits . . . . . . . . . . . . . . . . 18
Alphabetical list of global user exit points . . . . . . . . . . . . . . . 25
Global user exit points by functional area . . . . . . . . . . . . . . . 32
Activity keypoint program exit XAKUSER . . . . . . . . . . . . . . 32
Application Associated Data exit, XAPADMGR, in the AP domain . . . . . 33
Basic Mapping Support exits XBMIN and XBMOUT . . . . . . . . . . 34
Bridge facility exit XFAINTU . . . . . . . . . . . . . . . . . . . 38
Data tables management exits XDTRD, XDTAD, and XDTLC . . . . . . . 40
DBCTL interface control program exit XXDFA
. . . . . . . . . . . . 45
DBCTL tracking program exits XXDFB and XXDTO . . . . . . . . . . 46
Dispatcher domain exits XDSBWT and XDSAWT . . . . . . . . . . . 47
DL/I interface program exits XDLIPRE and XDLIPOST . . . . . . . . . 48
Dump domain exits XDUREQ, XDUREQC, XDUCLSE, and XDUOUT. . . . 53
Enqueue EXEC interface program exits XNQEREQ and XNQEREQC. . . . 60
EXEC interface program exits XEIIN, XEIOUT, XEISPIN, and XEISPOUT
67
File control domain exits, XFCFRIN and XFCFROUT . . . . . . . . . . 72
© Copyright IBM Corp. 1977, 2011 iii