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 20<br />

SAR$ COM<br />

20.1. SAR$ COM Function/PLUS Interface<br />

The SAR$ COM function writes a symbolic image to the operator's console, and<br />

optionally reads a symbolic image from the operator's console.<br />

The SAR$ COM procedure can be called directly from PLUS. All SAR$ data structure<br />

definitions and procedure calls are contained in definition elements and are obtained with<br />

the PLUS COPY statement.<br />

20.1.1. SAR$ COM Packet Data Structure Description<br />

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

procedure call. The type definition for this data structure is contained in the element<br />

SAR$COMPKTD in the <strong>SYSLIB</strong> file (SYS$LIB$*<strong>SYSLIB</strong>). This element may be obtained<br />

with the PLUS COPY statement. The identifier for the SAR$ COM packet data structure<br />

type is SAR_COM_PACKET.<br />

The calling program must provide storage space for the SAR$ COM packet data<br />

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

storage. The length of the SAR$ COM packet is equal to the constant<br />

SAR_COM_PACKET_WORD_LENGTH, defined in the element SAR$COMPKTD (current<br />

length is 25 words). The SAR_COM_PACKET data structure is defined as LOCATABLE.<br />

The calling program places information in the SAR$ COM packet data structure, and<br />

passes the address of the data structure to the SAR$ COM function through the<br />

procedure calls.<br />

20.1.1.1. Required Information for SAR$ COM Procedure<br />

The calling program must set the following fields of the SAR$ COM packet to<br />

appropriate values:<br />

PACKET_VERSION<br />

PLUS Attribute: 6-bit integer<br />

The SAR$ COM packet data structure version. The current version is equal to the<br />

constant SAR_COM_PACKET_CURRENT_VERSION defined in the element<br />

SAR$COMPKTD.<br />

7833 1733–004 20–1

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

Saved successfully!

Ooh no, something went wrong!