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

SAR$ ATREAD
S$ARATREAD does not space-fill the input text buffer when 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, S$ARATREAD truncates the character
text and returns an error status to the calling program.
Note: SAR$ may expand the line width, if necessary. The line width may be reset to
the print device default by calling the S$ARRSATR (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.2.3.3. Reset ATREAD Procedure Call (S$ARRSATR)
The S$ARRSATR PROC restores the caller's environment, if it was changed by
S$ARATREAD. Specifically, if S$ARATREAD changed the print line width, S$ARRSATR
will reset the print line width to the device default.
There are no required packet parameters for the S$ARRSATR PROC call. However,
S$ARRSATR expects that a prior call to the S$ARINITATR PROC was made.
Calling format
S$ARRSATR atrpkt
error return
normal return
where atrpkt is a label identifying the start address of the ATREAD packet and data area.
Returns
If S$ARRSATR takes the normal return, the call was successful.
If S$ARRSATR takes the error return, A1 contains the call status code. This status code
is also returned in the packet field SA$CALLST. See 19.2.4 for an explanation of the
status codes.
19–22 7833 1733–004