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

SAR$ WRITE
Empty symbiont output files may not be created by simply calling S$AROPENO followed
by S$ARCLOSO. An empty symbiont file may be created by setting SW$PCW to a
nonzero value when calling S$AROPENO, followed by a call to S$ARCLOSO. This will
cause a print control image to be generated, which will open the output file. If SW$PCW
is zero when creating an "empty" symbiont file, an error will occur during S$ARCLOSO.
18.2.1. WRITE Packet and Data Area Description
The SAR$ write function requires a WRITE packet and data area for the open-output,
write, and close-output calls. The S$ARWPDEF PROC generates the EQUFs defining
the packet fields. The word length of the MASM WRITE packet and data area is equal to
label SW$PKTWLEN defined by the S$ARWPDEF PROC (the current length is 70
words).
18.2.1.1. Required Information for WRITE Procedures
The calling program must set the following fields of the WRITE packet to appropriate
values:
SW$PKTVER
The WRITE packet data structure version. The current version is equal to the label
SW$CURVER, defined by the S$ARWPDEF PROC.
SW$FIPADDR
The address of the output file information packet. This packet is supplied by the
caller (see 16.1). Set this field to zero if SW$OUTFILT is 2, 3, or 6.
SW$OUTBUF
The address of the output buffer used to write images to the output file or element.
This field is defined only if output is to an SDF file or element. It is omitted if output
is to a symbiont file. Subsection 15.6.2 describes the output buffer.
SW$OUTBUFL
The length in words of the output buffer. It must be of length (28 * dpf * n), where
dpf is the disk prepping factor and n is a positive integer. This field is defined only if
output is to an SDF file or element. It is omitted if output is to a symbiont file.
SW$IMGBUF
The address of the output image buffer into which the SAR$ places the images to be
written out. Subsection 15.6.2 describes the image buffer.
SW$IMGBUFL
The length in words of the output image buffer.
18–22 7833 1733–004