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

SAR$ ATREAD
• Optional parameters (described in 19.2.1.2)
SA$ISLIST
SA$ISLISTL
SA$REQTYPE
SA$PCW
Note: It is recommended that the calling program zero-fill the ATREAD packet before
placing any parameters in the packet.
Calling Format
S$ARINITATR atrpkt
error return
normal return
where atrpkt is a label identifying the starting address of the ATREAD packet and data
area.
Returns
If S$ARINITATR 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.
If S$ARINITATR takes the normal return, the initialization of the ATREAD packet is
successful.
19.2.3.2. ATREAD Procedure Call (S$ARATREAD)
The S$ARATREAD PROC constructs an image from the output text and output
attributes, writes the image to the current output stream, reads an image from the
current input stream, and returns the character text and attributes of the image to the
calling program.
Initial Conditions
The calling program sets the following parameters in the ATREAD packet to appropriate
values before calling S$ARATREAD:
• Required parameters (described in 19.2.1.1)
SA$OTEXTB
SA$OATTRTL
SA$IATTRT
SA$OTEXTBL
SA$ITEXTB
SA$IATTRTL
SA$OATTRT
SA$ITEXTBL
19–20 7833 1733–004