(SYSLIB) Programming Reference Manual - Public Support Login ...

SAR$ ATREAD
• Attributes
The address of the attribute table and the number of entries are returned in the
fields INPUT_ATTRIBUTE_TABLE_ADDRESS and NUMBER_OF_INPUT
ATTRIBUTES, respectively.
SAR_ATREAD does not space-fill the input text buffer if the input character text length is
less than the length of the input text buffer. If the input character text length is greater
than the length of the input text buffer, then SAR_ATREAD truncates the character text
and returns an error status to the calling program.
If an end-of-file condition is encountered by SAR_ATREAD, the CALL_STATUS field of
the ATREAD packet is set to status S'End_of_file'.
If the status returned from SAR_ATREAD is not S'Normal' or S'End_of_file', then an
error has occurred and CALL_STATUS contains the status code. See 19.1.4 for a list of
ATREAD function status codes.
Note: SAR$ may expand the line width if necessary. The line width may be reset to
the print device default by calling the SAR_RESTORE_ATREAD procedure. The
expansion of the line width is to allow for the additional bytes required in the ASCII/ISO
with embedded shift-coded KANJI and ACD character types, and for transmitting large
data records, such as a full screen of characters.
19–10 7833 1733–004