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

SAR$ ATREAD
The ATREAD procedure I/O status codes listed in Table 19–4 may be returned to the
caller in the IO_STATUS field of the ATREAD packet.
Table 19–4. SAR$: ATREAD Procedure IO_STATUS Status List
Octal Code Status
0 Normal I/O status.
01 to 040 See Table C–2, I/O Status Codes, Exec ER Programming Reference Manual
for an explanation of the I/O status codes.
19.2. ATREAD Function/MASM Interface
The SAR$ ATREAD function writes a symbolic image to the current output stream and
reads a symbolic image from the current input stream.
The SAR$ ATREAD procedures can be called directly from MASM. The SAR$ data
structure definitions and procedure calls are defined by MASM procedures (PROCs).
The element SAR$PROCS contains these PROCs.
19.2.1. ATREAD Packet and Data Area Description
The SAR$ READ function requires an ATREAD packet and data area for the INITIALIZE-
ATREAD and ATREAD calls.
The S$ARATRDEF PROC generates the EQUFs defining the ATREAD packet fields. The
word length of the MASM ATREAD packet and data area is at label SA$PKTWLEN
defined by the S$ARATRDEF PROC (the current length is 61 words).
19.2.1.1. Required Information for ATREAD Procedures
The calling program must set the following fields of the ATREAD packet to appropriate
values:
SA$PKTVER
The ATREAD packet data structure version. The current version is equal to the label
SA$CURVER defined by the S$ARATRDEF PROC.
SA$IMGBUF
The address of the image buffer which ATREAD uses to construct images to be
written out and to read input images into.
SA$IMGBUFL
The length in words of the image buffer.
7833 1733–004 19–13