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

• Optional parameters (described in 18.2.1.2)
SW$OUTRECT
SW$LNUMINT
SW$LNUMF3
SW$ICHART
SW$LNUMF1
SW$LNUMF4
SW$LINESPA
SW$LNUMF2
Calling Format
S$ARWRITE wpkt
error return
normal return
SAR$ WRITE
where wpkt is a label identifying the starting address of the WRITE packet and data area.
Returns
If S$ARWRITE 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$ARWRITE takes the normal return, the write was successful. The following fields of
the WRITE packet contain information returned by SAR$ to the calling program:
SW$IMGBLEN
SW$IMGSEC
SW$IMGWO
These parameters are described in 18.2.1.3.
Write Control Functions
The calling program may perform write control functions with the S$ARWRITE
procedure call. The calling program sets SW$OUTRECT to 3 (write control record),
places the control image in the text buffer, and calls S$ARWRITE. See "Print Control
Function," Exec ER Programming Reference Manual for details on the control images.
18.2.3.3. Close-Output Procedure Call (S$ARCLOSO)
The S$ARCLOSO PROC performs the necessary tasks to close the output operation.
If the output type is an SDF element, the element is added to the program file table of
contents.
7833 1733–004 18–31