iTP Active Transaction Pages (iTP ATP) Programmer's Guide

ATP Objects, Properties, and Methods
iTP Active Transaction Pages (iTP ATP) Programmer’s Guide—522292-002
4-29
atp.field Object
offset (read-only)
This property contains a number representing the byte offset of the field within the
application-message buffer. For subscripted items, the value is the offset of the first
instance. The first field has an offset of zero.
length (read-only)
This property gives the length in bytes of the field within the application message
buffer.
decimals (read-only)
This property gives the number of implied decimal places (COBOL "V" picture
option). The value can be a negative number for scaled numbers (COBOL "P"
picture option).
bit_offset (read-only)
This property gives the bit offset (starting at 0, maximum 15) of a DDL bit data
type.
bit_length (read-only)
This property gives the bit length (minimum 1, maximum 15) of a DDL bit data
type.
subscript_multipliers (read-only)
This property is an array of sizes, in bytes, of the enclosing repeating structures of
subscripted fields. Up to 7 subscripts are supported.
occurs_max (read only)
This property gives the maximum number of occurrences specified for a field. The
value is 1 for non-repeating fields. If a repeating field has subfields, the repeating
field has an occurs_max value other than 1; each subfield, however, has an
occurs_max value of 1 unless a given subfield is also specified as repeating,
giving a nested table.
fields (read-only)
This property is an array of the field objects owned by this field object. Fields own
the fields declared with a higher level number within an application message
structure. (If a field has fields in it, the contained fields have a higher level number
than the field that contains them.) In the C language, this concept corresponds to a
struct owning its elements; in COBOL, group data items own their elements.
field (read-only)
The value of this property is the name of a field object owned by this field object.
Thus, you can refer to a field within a field object by using either the name of the
field or an index into the fields array.