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

SAR$ WRITE
IMAGE_BYTE_LENGTH
PLUS Attribute: 18-integer
The length in bytes of the image written out by the SAR_WRITE procedure. For
images written to SDF files or elements, the length does not include the image
control word or the length of the line number records. For images written to
symbiont files, the length is the number of bytes transferred by the SYMB$ request.
IMAGE_ADDRESS_SECTOR
PLUS Attribute: 24-bit integer
The mass storage sector address to which the SDF image was written. This field is
undefined if output file type is not an SDF file or element. If a line number control
record (type 053) is written with the data record, this address is the sector address
of the line number control record corresponding to the data record.
IMAGE_ADDRESS_WORD_OFFSET
PLUS Attribute: 6-bit integer
The word offset into the mass storage sector address that the SDF image was
written to. This field is undefined if output file type is not an SDF file or element.
IMAGE_ADDRESS
PLUS Attribute: word machine integer
A one word combination of IMAGE_ADDRESS_SECTOR and
IMAGE_ADDRESS_WORD_OFFSET, contained in bits 13 to 36 and in bits 1 to 6,
respectively. (Bit 1 is the leftmost bit of the word.)
18.1.2. Buffers and Tables for PLUS WRITE Procedures
The SAR$ WRITE function requires that the following buffers and table be supplied by
the calling program:
• Output buffer
The output buffer is used to write to mass storage files. The calling program never
needs to access the output buffer, but it must provide it to SAR$. If the calling
program is using both the READ and WRITE functions of SAR$, then it cannot use
the same I/O buffer for both functions. The calling program must provide a separate
input and output buffer for each function.
18–10 7833 1733–004