Guardian Procedure Calls Reference Manual (G06.25+)

Formatter Edit Descriptors
Guardian Procedure Calls Reference Manual—522629-013
F-9
Repeatable Edit Descriptors
The “|” character is used to denote the boundaries of the output field.
Repeatable Edit Descriptors
The following descriptions give the form, function, and requirements for each of the edit
descriptors that specify formatting of data fields. The following edit descriptors can be
preceded by an unsigned integer repeat factor to specify identical formatting for a
number of values in the data list.
The following descriptions of the operation of repeatable edit descriptors apply when
no decorations or modifiers are present.
The A Edit Descriptor
The A edit descriptor is used to move characters between the buffer and the data
element without conversion. This is normally used with ASCII data. The A edit
descriptor has one of the following forms:
A
w OR A
w an unsigned integer constant that specifies the width, in characters, of the field
and must not exceed 255. The field processed is the next
w characters
starting at the current position.
If
w is not present, the field width is equal to the actual number of bytes in the
associated data element, but cannot exceed 255. Values over 255 are
reduced to 255.
After the field is processed, the current position is advanced by w characters.
On output, the operation of the A edit descriptor is as follows:
1. The number of characters specified by
w, or the number of characters in the data
element, whichever is less, is moved to the external field. The transfer starts at the
left character of both the data element and the external field unless an RJ modifier
is affecting the descriptor, in which case the transferring of characters begins with
the right character of each.
2. If
w is less than the number of characters in the data element, the field overflow
condition is set.
3. If
w is greater than the number of characters in the data element, the remaining
characters in the external field are filled with spaces (unless another fill character is
specified by the FL modifier).