The field element table structure – IBM SC33-1683-02 User Manual

Page 61

Advertising
background image

UERCPURG

Task purged during XPI call.

XPI calls

All can be used.

The field element table structure

The

field element table contains one or more elements which provide information

about each “field of interest” passed to the exit. A “field of interest” is a field which
has been defined as VALIDN=USEREXIT in the map source file used to create the
mapset referenced in the mapping operation.

Each field element has the following structure:

BMXMAPST

is an 8-byte area which contains the name of the mapset associated with this
field. If terminal or alternate suffixes are used with mapset names in your CICS
installation, the mapset name may have a suffix appended to the name
specified in the mapping request.

BMXMAP

is a 7-byte area which contains the name of the map associated with this field.

BMXFDFB

is a one-byte field copied from the field specification in the map load module. It
contains indicators as follows:

X'80'

CASE=MIXED

X'40'

Group field entry

X'20'

Group field descriptor

X'10'

ATTRB=DET

X'08'

JUSTIFY=ZERO

X'04'

JUSTIFY=RIGHT

X'02'

INITIAL,XINIT, or GINIT specified

X'01'

Named field (DSECT entry exists)

BMXMAPLN

is a halfword binary value which contains the field length defined in the
LENGTH option of the DFHMDF macro.

BMXACTLN

is a halfword binary value which contains the actual length of the data received
or transmitted in this field.

BMXDATA

is the address of the field data.

In the XBMIN exit, BMXDATA points into a work area which BMS has obtained
for input mapping purposes. When the exit returns control, this work area is
copied to the application data structure associated with this map.

In the XBMOUT exit, BMXDATA points into a terminal input/output area (TIOA)
in which BMS has generated an output datastream. When the exit returns

Basic Mapping Support exits

Chapter 1. Global user exit programs

29

|
|

|
|

|

|
|
|
|

|

|
|
|
|
|

|
|

|
|
|

||

||

||

||

||

||

||

||

|
|
|

|
|
|

|
|

|
|
|

|
|

Advertising