18.08.2013 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

SAR$ ATREAD<br />

19.2.1.3. Information Returned by ATREAD Procedures<br />

The following fields of the ATREAD packet contain values returned by the SAR$<br />

ATREAD procedures to the calling program:<br />

SA$STATUS<br />

The ATREAD function status word; it contains the call status in H2, the substatus in<br />

S1, and the I/O status in S3.<br />

SA$CALLST<br />

The status code of the INITIALIZE-ATREAD or ATREAD procedure call. See Table<br />

19–6 for an explanation of the octal status codes.<br />

SA$SUBSTAT<br />

This field contains additional information for particular call status codes.<br />

SA$IOSTAT<br />

The status of any I/O operations performed by the ATREAD procedures. See Table<br />

19–7 for the octal status codes.<br />

SA$SYMBST<br />

The status word returned from an ER SYMB$ request. See the SYMB$ section,<br />

Exec ER <strong>Programming</strong> <strong>Reference</strong> <strong>Manual</strong> for further details on the SYMB$ status<br />

word.<br />

SA$RECBUFL<br />

The recommended buffer or table length when an invalid length is specified or when<br />

an overflow occurs.<br />

SA$OIMGLEN<br />

The length in bytes of the image written out by ATREAD.<br />

SA$TEXTLEN<br />

The length in 9-bit bytes of the character text returned in the text buffer.<br />

SA$NUMATTR<br />

The number of attributes returned in the attribute table.<br />

19–16 7833 1733–004

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!