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.

19.1.2. PLUS ATREAD Procedures Buffers and Tables<br />

SAR$ ATREAD<br />

All buffers and tables must be provided by the calling program. The type definitions for<br />

the buffers and tables, and definitions for the default buffer and table lengths, are<br />

contained in the element SAR$DEFN in the <strong>SYSLIB</strong> file (SYS$LIB$*<strong>SYSLIB</strong>) or<br />

SYS$*RLIB$. They may be obtained with the COPY statement. The buffers and tables<br />

for the ATREAD function are similar to the buffers and tables for the READ and WRITE<br />

functions. See 17.1.2 and 18.1.2 for details on the buffers and tables.<br />

The default buffer and table lengths are listed in Table 19–1.<br />

Table 19–1. SAR$: PLUS ATREAD Buffer and Table<br />

Length Defaults<br />

Identifier Value<br />

SAR_IO_BUFFER_WORD_LENGTH 448<br />

SAR_IMAGE_BUFFER_WORD_LENGTH 63<br />

SAR_TEXT_BUFFER_BYTE_LENGTH 132<br />

SAR_ATTRIBUTE_TABLE_WORD_LENGTH 40<br />

SAR_SELECT_LIST_BYTE_LENGTH 4<br />

The buffer and table type definitions are listed in Table 19–2.<br />

Table 19–2. SAR$: PLUS ATREAD Buffer and Table<br />

Type Definitions<br />

Identifier Type<br />

SAR_IO_BUFFER 448 words logical locatable<br />

SAR_IMAGE_BUFFER 63 words logical locatable<br />

SAR_TEXT_BUFFER 132 ASCII characters locatable<br />

SAR_ATTRIBUTE_TABLE 40 words logical locatable<br />

SAR_SELECT_LIST 4 bytes logical locatable<br />

The element SAR$DEFN also contains other definitions necessary to SAR$.<br />

7833 1733–004 19–7

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

Saved successfully!

Ooh no, something went wrong!