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

• Optional parameters (described in 19.2.1.2)
SA$OCHART
SA$LINESPA
Calling Format
S$ARATREAD atrpkt
error return
end-of-file return
normal return
SAR$ ATREAD
where atrpkt is a label identifying the starting address of the ATREAD packet and data
area.
Returns
error
If S$ARATREAD takes the error return, A1 contains the call status code, A2 contains
the I/O status code, and A3 contains the substatus code. These status codes are
also returned in the packet fields SA$CALLST, SA$IOSTAT, and SA$SUBSTAT,
respectively. See 19.2.4 for an explanation of the status codes.
end-of-file
normal
If S$ARATREAD takes the end-of-file return, the ATREAD request encountered an
end-of-file condition. A1 contains the call status code, A2 contains the I/O status
code, and A3 contains the substatus code. These status codes are also returned in
the packet fields SA$CALLST, SA$IOSTAT, and SS$SUBSTAT, respectively.
If S$ARATREAD takes the normal return, the ATREAD call was successful. The
following information is returned by ATREAD to the caller:
• Character text
The address of the character text and the length in 9-bit bytes (characters) are
returned in the fields SA$ITEXTB and SA$TEXTLEN, respectively.
• Character type
The character set type of the image read is returned in the field SA$ICHART.
• Attributes
The address of the attribute table and the number of entries are returned in the
fields SA$IATTRT and SA$NUMATTR, respectively.
7833 1733–004 19–21