IBM SC34-6814-04 User Manual

Page of 953
UERCNORM
Continue processing.
XPI calls
All can be used.
API and SPI calls
All can be used, except for:
v
EXEC CICS ABEND
v
EXEC CICS PERFORM SHUTDOWN
Sample exit program, DFH$APAD
CICS provides a sample global user exit program, DFH$APAD, for use at the
XAPADMGR exit point. The exit program is invoked, if enabled, when non-system
tasks for which no input Origin Descriptor Record is provided are attached.
DFH$APAD performs the following processing:
v
Provides addressability to the associated data provided as input to the exit.
v
Chooses a field from this data and places it in the output buffer.
v
Adds a field to the user correlation data in the output buffer.
Related concepts
Basic Mapping Support exits XBMIN and XBMOUT
The XBMIN exit allows you to intercept a RECEIVE MAP request after BMS has
successfully processed the request. The XBMOUT exit allows you to intercept a
SEND MAP request after BMS has successfully processed the request; or, if
cumulative mapping is in progress, on completion of each page of output.
The XBMIN exit is called, if enabled, when all the following are true:
v
A RECEIVE MAP command has been successfully processed.
v
The map referenced in the command contains at least one field specified as
VALIDN=USEREXIT.
v
At least one USEREXIT field has been returned in the inbound datastream and
has been mapped into the application data structure.
Using XBMIN, you can:
v
Analyze each field defined as VALIDN=USEREXIT mapped to the application on
this request
v
Use the mapset name, map name, and field length defined in the map, and the
actual length of field data returned in the inbound datastream
v
Modify the data in each field.
The XBMOUT exit is called, if enabled, when all the following are true:
v
A SEND MAP command has been successfully processed.
v
The map referenced in the command contains at least one field specified as
VALIDN=USEREXIT.
v
At least one USEREXIT field has been generated in the outbound datastream.
Using XBMOUT, you can:
v
Analyze each field defined as VALIDN=USEREXIT which has been generated in
the outbound datastream
34
Customization Guide