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

18.2.1.3. Information Returned by WRITE Procedures
SAR$ WRITE
The following fields of the WRITE packet contain values returned by the SAR$ WRITE
procedures to the calling program:
SW$STATUS
The WRITE function status word; it contains the call status in H2, the substatus in
T1, and the I/O status in S3 of the word.
SW$CALLST
The status of the current open-output, write, or close-input procedure call. See Table
18–6 for an explanation of the octal status codes.
SW$IOSTAT
The status of any I/O operations performed by SAR$. See Table 18–7 for the octal
status codes.
SW$SYMBDT
The status word returned from an ER SYMB$ request. See the SYMB$ section,
Exec ER Programming Reference Manual for further details on the SYMB$ status
word.
SW$RECBUFL
The recommended buffer or table length when an invalid length is specified or when
an overflow occurs.
SW$IMGBLEN
The length in bytes of the image written out by the 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 SMB$ request.
SW$IMGSEC
The mass storage sector address that the SDF image was written to. This field is a
full word containing the sector address in S3 to S6 and the field SW$IMGWO in S1.
SW$IMGSEC is undefined if the 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.
SW$IMGWO
The word offset into the sector address (SW$IMGSEC) that the SDF image was
written to. This field is contained in S1 of SW$IMGSEC. SW$IMGWO is undefined
if the output file type is not an SDF file or element.
7833 1733–004 18–27