ADS field descriptor

After the header, the ADS descriptor contains a variable number of field descriptors.

Each field descriptor has the following format:

Offset
Hex

Type

Len

Name

(0)

STRUCTURE

42

ADS-FIELD-DESCRIPTOR

(0)

CHARACTER

32

ADSD-FIELD-NAME

(20)

HALFWORD

2

ADSD-FIELD-NAME-LEN

(22)

HALFWORD

2

ADSD-OCCURS-INDEX

(24)

HALFWORD

2

ADSD-FIELD-OFFSET

(26)

HALFWORD

2

ADSD-FIELD-DATA-LEN

(28)

CHARACTER

1

ADSD-FIELD-JUSTIFY

(29)

CHARACTER

1

ADSD-FIELD-FILL-CHAR

(2A)

CHARACTER

ADSD-NEXT-FIELD

ADSD-FIELD-NAME
The unsuffixed field name padded with blanks on the right.
ADSD-FIELD-NAME-LEN
The number of characters in the field name.
ADSD-OCCURS-INDEX
When OCCURS is specified for a field definition there is a separate field descriptor for each element of the array, and ADSD-OCCURS-INDEX indicates the array index for the particular field. If OCCURS is not specified, then ADSD-OCCURS-INDEX is 0.
ADSD-FIELD-OFFSET
The offset of the field within the ADS. The offset is to the beginning of the (fullword) length field, and you must add 2 (for the length field) + 1 (for the 3270 attribute) + ADSD-ATTRIBUTE-NUMBER to obtain the offset of the data part of the field.
ADSD-FIELD-DATA-LEN
The length of the field in the ADS.
ADSD-FIELD-JUSTIFY
A 1-character field indicating whether the data is to be justified left 'L' or right 'R' if the supplied length is less than the length in the ADS.
ADSD-FIELD-FILL-CHAR
The character (blank or '0') to be used to pad the remainder of the field in the ADS.
ADSD-NEXT-FIELD
The next field descriptor. The address of ADSD-NEXT-FIELD can be used to update a pointer for the field descriptor.


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