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

Section 19
SAR$ ATREAD
19.1. ATREAD Function/PLUS 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 PLUS. All SAR$ data
structure definitions and procedure calls are contained in definition elements and may be
obtained with the PLUS COPY statement.
19.1.1. ATREAD Packet Data Structure Description
The SAR$ ATREAD function requires an ATREAD packet data structure for the
SAR_INITIALIZE_ATREAD and SAR_ATREAD procedure calls.
The type definition for this data structure is contained in the element SAR$ATRPKTD in
the SYSLIB file (SYS$LIB$*SYSLIB) or SYS$*RLIB$. It may be obtained with the COPY
statement. The identifier for the ATREAD packet data structure type is
SAR_ATREAD_PACKET.
The calling program must provide storage space for the ATREAD packet data structure,
plus any necessary buffers and tables, since SAR$ does not have any D-bank storage.
The length of the ATREAD packet is equal to the constant
SAR_ATREAD_PACKET_WORD_LENGTH, defined in the element SAR$ATRPKTD
(current length is 29 words). SAR_ATREAD_PACKET is defined as LOCATABLE.
The calling program places information in the ATREAD packet data structure and passes
the address of the data structure to SAR$ through the procedure calls.
7833 1733–004 19–1