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
Hex

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).


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