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.

Section 17<br />

SAR$ READ<br />

17.1. READ Function/PLUS Interface<br />

The SAR$ READ procedures can be called directly from PLUS. These procedures are<br />

• SAR_OPEN_INPUT<br />

• SAR_READ<br />

• SAR_CLOSE_INPUT<br />

All SAR$ data structure definitions and procedure calls are contained in definition<br />

elements. These definitions and procedures may be obtained with the PLUS COPY<br />

statement.<br />

17.1.1. READ Packet Data Structure Description<br />

The SAR$ READ function requires a READ packet data structure for the<br />

SAR_OPEN_INPUT, SAR_READ, and SAR_CLOSE_INPUT procedure calls.<br />

The type definition for this data structure is contained in the element SAR$RPKTD in the<br />

<strong>SYSLIB</strong> file (SYS$*RLIB$ or SYS$LIB$*<strong>SYSLIB</strong>) and may be obtained with the COPY<br />

statement. The identifier for the READ packet data structure type is<br />

SAR_READ_PACKET.<br />

The calling program must provide storage space for the READ packet data structure plus<br />

any necessary buffers and tables, since SAR$ does not have any D-bank storage.<br />

The length of the READ packet is equal to the constant<br />

SAR_READ_PACKET_WORD_LENGTH, defined in the element SAR$RPKTD<br />

(current length is 36 words). SAR_READ_PACKET is defined as LOCATABLE.<br />

The calling program places information in the READ packet data structure and passes the<br />

address of the data structure to SAR$ through the procedure calls.<br />

7833 1733–004 17–1

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

Saved successfully!

Ooh no, something went wrong!