(SYSLIB) Programming Reference Manual - Public Support Login ...

dispflg
A flag to display a table of the READ packet EQUFs. If it is set to ‘D’, the field
names are displayed; otherwise the field names are not displayed.
Example
$ASCII
$INCLUDE ‘MAXR$’
S$ARRPDEF X9,B2,’D’
SAR$ READ
The PROC call S$ARRPDEF of this example generates EQUFs using registers X9 and B2
and displays a description of each packet field.
17.2.2. Buffers and Tables for MASM READ Procedures
All buffers and tables must be provided by the calling program. The recommended
lengths for the buffers and tables are equated to labels in the S$ARRPDEF PROC.
These lengths and labels are listed in Table 17–5. These definitions simplify the creation
of required buffers and tables for the calling program.
Table 17–5. SAR$: MASM READ Buffer and Table Lengths
Label Value
SR$INPBUFDL (Input buffer word length) 448
SR$IMGBUFDL (Image buffer word length) 63
SR$TEXBUFDL (Text buffer byte length) 132
SR$ATTRIBDL (Attribute table word length) 40
SR$SELLSTDL (Select list byte length) 4
17.2.3. READ Procedures Called from MASM
The MASM procedures for the READ function are
• S$AROPENI (open input)
• S$ARREAD (read)
• S$ARCLOSI (close input)
The calling sequences for these procedures are generated by MASM PROCs, contained
in the SYSLIB file (SYS$LIB$*SYSLIB) or SYS$*RLIB$.
7833 1733–004 17–27