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

SAR$ WRITE
• Optional parameters (described in 18.2.1.2)
SW$OUTFILT
SW$UNTRFLG
SW$TRIMBF
SW$LNUMFMT
SW$SDFLBLF
SW$OCHART
SW$BRKPTF
Note: It is recommended that the calling program zero-fill the WRITE packet before
placing any parameters in the packet.
Calling Format
S$AROPENO wpkt
error return
normal return
where wpkt is a label identifying the starting address of the WRITE packet and data area.
Returns
If S$AROPENO takes the error return, A1 contains the call status code, A2 contains the
I/O status code, and A3 contains the substatus code. These status codes are also
returned in the packet fields SW$CALLST, SW$IOSTAT, and T1 of SW$STATUS,
respectively. See 18.2.4 for an explanation of the status codes.
If S$AROPENO takes the normal return, the initialization of the WRITE packet is
successful.
18.2.3.2. WRITE Procedure Call (S$ARWRITE)
The S$ARWRITE PROC writes images to the output file or element. Each call to
S$ARWRITE writes out one image. The calling program must supply the character text
of the image in the text buffer and the attributes for the text (if any) in the attribute table.
S$ARWRITE combines the text and attributes into the proper format and writes out the
image.
Initial Conditions
The calling program sets the following parameters in the WRITE packet to appropriate
values before calling S$ARWRITE:
• Required parameters (described in 18.2.1.1)
SW$TEXBUF
SW$ATTRIBL
SW$TEXBUFL
SW$ATTRIB
18–30 7833 1733–004