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.

16.1.2. MASM Interface<br />

SAR$–Symbolic Access Routines<br />

The S$ARFIPDEF PROC generates the EQUFs defining the packet fields of the file<br />

information packet (FIP). The element SAR$PROCS contains this PROC. S$ARFIPDEF<br />

also equates the current packet version and word length of the FIP to labels<br />

FIP$CURVER and FIP$PWLEN, respectively. FIP$PWLEN is defined by the<br />

S$ARFIPDEF PROC (current length is nine words).<br />

Calling Format<br />

S$ARFIPDEF x-reg,b-reg,dispflg<br />

Parameters<br />

x-reg<br />

b-reg<br />

dispflg<br />

The X-register to be attached to the file information packet EQUFs. If it is omitted,<br />

no X-register is attached to the EQUFs.<br />

The B-register to be attached to the file information packet EQUFs. If it is omitted,<br />

no B-register is attached to the EQUFs.<br />

A flag to display a table of file information packet EQUFs. If it is set to 'D', the field<br />

names are displayed. Otherwise the field names are not displayed.<br />

Example<br />

$ASCII<br />

$INCLUDE ‘MAXR$’<br />

S$ARFIPDEF X7,,‘D’<br />

This PROC call generates the EQUFs using X7 and no B-register, and displays the file<br />

information packet fields.<br />

16.1.2.1. FIP Field Descriptions<br />

The following fields of the FIP are set by the calling program:<br />

FIP$VER<br />

The FIP data structure version. The current version is equal to label FIP$CURVER,<br />

defined by the S$ARFIPDEF PROC.<br />

7833 1733–004 16–7

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

Saved successfully!

Ooh no, something went wrong!