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

SOR–Symbolic Output Routine
25.3. Output Fieldata Image
The SOR$ and SORA$ routines translate into ASCII a Fieldata image from a location
specified by the calling program and write it to the symbolic output element.
Calling Sequence
L A0,(image-length,image-location)
LMJ X11,SOR$ (or SORA$)
error return
normal return
where:
image-length
The length in words of the symbolic image to output.
image-location
The address of the symbolic image to output.
If this is the first call to output an image, SOR calls SDFO to write the SDF Label control
record. If the SOR$ entry point is called, SOR checks for and suppresses words of
Fieldata spaces at the end of the image. If the SORA$ entry point is called, there is no
space suppression. If this is the first call to SOR$ or SORA$, SOR prints the following
informational message:
SOR: Fieldata symbolic output in not allowed; output is in ASCII.
SOR then translates the Fieldata image to ASCII. The buffer that SOR uses for the
translation is 63 words long, so if the Fieldata image is 42 words or less, SOR translates
the image and then calls SDFO to write it. If the Fieldata image is more than 42 words,
the entire image cannot be translated and written at once. In this case, SOR calls SDFO
to write the first 63 words of the translated image; then continues by translating the next
part of the Fieldata image and calling SDFO to write it as an SDF Continuation control
record, octal code 051. SOR continues writing Continuation control records until the
entire Fieldata image has been translated and written.
To write a Fieldata image to the symbolic output element in Fieldata, the calling program
can use the SORNM$ or SORNMA$ calls described in 25.4. Note also that SOR can be
configured so that the SOR$ and SORA$ entry points write Fieldata images with no
translation to ASCII.
The SOR error returns described for SORASC$ and SORASCA$ in 25.2 also apply to
SOR$ and SORA$.
25–4 7833 1733–004