ADS descriptor header
The ADS descriptor header contains general information about the map and a pointer to the first of a variable number of chained field descriptions.
Offset |
Type |
Len |
Name |
|---|---|---|---|
(0) |
STRUCTURE |
38 |
ADS-DESCRIPTOR |
(0) |
HALFWORD |
2 |
ADSD-LENGTH |
(2) |
CHARACTER |
4 |
ADSD-EYECATCHER |
(6) |
HALFWORD |
2 |
ADSD-MAP-INDEX |
(8) |
HALFWORD |
2 |
ADSD-FIELD-COUNT |
(A) |
HALFWORD |
2 |
ADSD-STRUCTURE-LENGTH |
(C) |
HALFWORD |
2 |
ADSD-ATTRIBUTE-NUMBER |
(E) |
CHARACTER |
12 |
ADSD-ATTRIBUTE-TYPE-CODES |
(1A) |
CHARACTER |
1 |
ADSD-MAP-JUSTIFY-HOR |
(1B) |
CHARACTER |
1 |
ADSD-MAP-JUSTIFY-VER |
(1C) |
HALFWORD |
2 |
ADSD-MAP-STARTING-LINE |
(1E) |
HALFWORD |
2 |
ADSD-MAP-STARTING-COLUMN |
(20) |
HALFWORD |
2 |
ADSD-MAP-LINES |
(22) |
HALFWORD |
2 |
ADSD-MAP-COLUMNS |
(24) |
CHARACTER |
1 |
ADSD-WRITE-CONTROL-CHARACTER |
(25) |
CHARACTER |
1 |
(reserved) |
(26) |
STRUCTURE |
ADSD-FIRST-FIELD |
- ADSD-LENGTH
- The length of the ADS descriptor.
- ADSD-EYECATCHER
- An eye-catcher ('ADSD') to identify this as an ADS descriptor.
- ADSD-MAP-INDEX
- The index number of the map within the mapset.
- ADSD-FIELD-COUNT
- The number of fields within the ADS; that is, the number of named fields in the map definition. A separate field is counted for each element of an array defined with the OCCURS parameter, but subfields of group fields (GRPNAME) are not counted. The field count may be zero, in which case there are no field descriptors following the header.
- ADSD-STRUCTURE-LENGTH
- The length of the application data structure.
- ADSD-ATTRIBUTE-NUMBER
- The number of extended attributes in fields used in the map; that is, the number of attributes specified in DSATTS in the map definition.
- ADSD-ATTRIBUTE-TYPE-CODES
- a 1-character code for the attribute types in each field, in order,
derived from DSATTS:
- C = COLOR
- P = PS
- H = HILIGHT
- V = VALIDN
- O = OUTLINE
- S = SOSI
- T = TRANSP
- ADSD-MAP-JUSTIFY-HOR
- The horizontal justification for the map, either L (LEFT) or R (RIGHT) from the JUSTIFY operand on the map definition.
- ADSD-MAP-JUSTIFY-VER
- The vertical justification for the map, from the JUSTIFY operand on the map definition. This can have the values F (FIRST), L (LAST), B (BOTTOM), or blank (no vertical JUSTIFY operand).
- ADSD-MAP-STARTING-LINE
- The starting line for the map, from the LINE operand on the DFHMDI macro, (LINE = NEXT gives a value of 255; LINE = SAME gives a value of 254.)
- ADSD-MAP-STARTING-COLUMN
- The starting column for the map, from the COLUMN operand on the DFHMDI macro. (COLUMN = NEXT gives a value of 255; COLUMN = SAME gives a value of 254.)
- ADSD-MAP-LINES
- The number of lines in the map from the SIZE operand.
- ADSD-MAP-COLUMNS
- The number of columns in the map from the SIZE operand.
- ADSD-WRITE-CONTROL-CHAR
- The 3270 encoded WCC derived from the CONTROL operand.
- ADSD-FIRST-FIELD
- The first field descriptor. The address of the first field descriptor in the ADSD (zero if ADSD-FIELD-COUNT is zero).