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.

20.1.2. SAR$ PLUS COM Procedure Buffers and Tables<br />

SAR$ COM<br />

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

the buffers and tables and the 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$. This element is obtained with the COPY statement. The buffers and<br />

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

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

for the COM function, the image buffer is not used if the input and output images do not<br />

have character attributes.<br />

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

Table 20–1. SAR$: PLUS COM Buffer and Table Length<br />

Defaults<br />

Identifier Value<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 20–2.<br />

Table 20–2. SAR$: PLUS COM Buffer and Table Type Definitions<br />

Identifier Type<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 20–7

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

Saved successfully!

Ooh no, something went wrong!