Basic Mapping Support Exits Xbmin And Xbmout - IBM SC34-6814-04 Customization Manual

XPI calls
API and SPI calls
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:
"The Application Associated Data sample exit program" on page 18

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
v At least one USEREXIT field has been returned in the inbound datastream and
Using XBMIN, you can:
v Analyze each field defined as VALIDN=USEREXIT mapped to the application on
v Use the mapset name, map name, and field length defined in the map, and the
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
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
34
Customization Guide
UERCNORM
Continue processing.
All can be used.
All can be used, except for:
v EXEC CICS ABEND
v EXEC CICS PERFORM SHUTDOWN
VALIDN=USEREXIT.
has been mapped into the application data structure.
this request
actual length of field data returned in the inbound datastream
VALIDN=USEREXIT.
the outbound datastream