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

18.2.2. MASM WRITE Procedures Buffers and Tables
SAR$ WRITE
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$ARWPDEF PROC.
These lengths and labels are listed in Table 18–5. These definitions simplify the creation
of required buffers and tables for the calling program.
Table 18–5. SAR$: MASM WRITE Buffer and Table
Lengths
Label Value
SW$OUTBUFDL (Output buffer word length) 448
SW$IMGBUFDL (Image buffer word length) 63
SW$TEXBUFDL (Text buffer byte length) 132
SW$ATTRIBDL (Attribute table word length) 40
18.2.3. WRITE Procedures Called from MASM
The procedures for the WRITE function are
• S$AROPENO (open output)
• S$ARWRITE (write an image)
• S$ARCLOSO (close output)
The calling sequences for these procedures are generated by MASM PROCs, contained
in the SYSLIB file (SYS$LIB$*SYSLIB) or SYS$*RLIB$.
18.2.3.1. Open-Output Procedure Call (S$AROPENO)
The WRITE packet and data area must be initialized before any images are written out.
The S$AROPENO PROC performs the WRITE packet initialization.
Initial Conditions
The calling program sets the following parameters in the WRITE packet to appropriate
values before calling S$AROPENO:
• Required parameters (described in 18.2.1.1)
SW$PKTVER
SW$OUTBUFL
W$FIPADDR
W$IMGBUF
W$OUTBUF
W$IMGBUFL
7833 1733–004 18–29