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

SAR$ WRITE
Initial Condition
The calling program may set the following optional parameter in the WRITE packet to an
appropriate value before calling S$ARCLOSO:
SW$ELTCDT
This parameter is described in 18.2.1.2.
Calling Format
S$ARCLOSO wpkt
error return
normal return
where wpkt is a label identifying the starting address of the WRITE packet and data area.
Returns
If S$ARCLOSO 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$ARCLOSO takes the normal return, the output is successfully closed.
18.2.4. Status Lists for MASM WRITE Procedures
The WRITE procedure call status codes listed in Table 18–6 may be returned to the
calling program in the SW$CALLST field of the WRITE packet. These call status codes
are for SW$CURVER = 2 or above.
Table 18–6. SAR$: WRITE Procedure SW$CALLST Codes
Octal Code Status
0 Normal return from SAR$.
01 An outdated WRITE packet version is being used.
02 An invalid WRITE packet version is being used.
03 The value for SW$IMGBUF is zero; an address must be given for the output
image buffer.
04 The SW$IMGBUFL is zero; a length must be given for the output image
buffer.
05 The value for SW$FIPADDR is zero; a file information packet must be given
for this output file type.
06 An invalid value is specified for SW$OUTFILT.
07 An invalid value is specified for SW$LNUMFMT.
010 An invalid value is specified for SW$UNTRFLG.
18–32 7833 1733–004