The Application Data Structure (ADS)

The symbolic map generated by the BMS macros is also known as the application data structure (ADS).

Physical maps produced by CICS® Transaction Server for z/OS® , Version 1.2 and above, also include an ADS descriptor in the output load module. This is provided to allow interpretation of the BMS Application Data Structure (the structure used by the application program for the data in SEND and RECEIVE MAP requests), without requiring your program to include the relevant DSECT or copybook at compile time.

The ADS descriptor contains a header with general information about the map, and a field descriptor for every field that appears in the ADS (corresponding to every named field in the map definition macro). It can be located in the mapset from an offset field in DFHMAPDS.

The ADS descriptor is generated for all maps. You can choose to map the long or short form of the ADS by specifying the DSECT=ADS|ADSL option. The default is ADS,the short (normal) form. The long form of the ADS aligns all fields on 4-byte boundaries and is required for some interfaces with other products, such as WebSphere® MQ.

Map sets generated with CICS releases before CICS Transaction Server for z/OS , Version 1.2 do not contain the ADS descriptor.

The format of the ADS descriptor is contained in the following copybooks:

Table 1. ADS descriptor copybooks
Language Copybook
Assembler DFHBRARD
C DFHBRARH
PL/I DFHBRARL
COBOL DFHBRARO

For further information about the ADS descriptor, see the CICS External Interfaces Guide .

If you need to reassemble maps but have no access to the source, a utility program DFHBMSUP is provided in CICS Transaction Server for z/OS , Version 1.2 (and above) to re-create BMS macro source from a mapset load module.



dfhp3kz.html | Timestamp icon Last updated: Monday, 5 June 2017