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

SIR$–Symbolic Input/Output Routine
Return Images in All CCSs
Symbolic images in the 22 "other" CCSs cannot be translated by SIR$ into Fieldata or
ASCII, so these images cannot be passed to the calling program using the GETSR$ or
GETAS$ entry points.
If bit 2 of A4 is set and the GETNM$ entry point is called to read a symbolic image, SIR$
passes images in Fieldata, ASCII, ASCII-like CCSs, and the 22 "other" legal CCSs to the
calling program without translation. SIR$ stores the CCS identifier of the image in S6 of
A0.
If bit 2 of A4 is clear or if the OPNSR$ initialization entry point is called, SIR$ does not
pass images in the 22 “other” CCSs to the calling program, but instead returns an error.
This ensures that only Fieldata, ASCII, and ASCII-like images are passed to a calling
program, unless the program has explicitly set bit 2 in A4 to indicate that it can handle
images in the 22 “other ” CCSs.
23.2.3. GETAS$–Get Symbolic Image in ASCII
The GETAS$ entry point is called to obtain the next input image from the source input or
the runstream and to pass the image to the calling program in ASCII. Input images in
Fieldata are translated to the ASCII_ISO CCS and passed to the calling program. Input
images in ASCII and ASCII-like CCSs are passed without change to the calling program.
An exception is that when the P option is either specified or assumed, requesting
Fieldata source output, lowercase alphabetics are changed to uppercase alphabetics
when the image is passed to the calling program. Input images in the 22 “other” CCSs
are not passed to the calling program, but instead result in an error return.
Calling Sequence
L A0,(buffer-length,buffer-addr)
LMJ X11,GETAS$
error return
end-of-file return
normal return
where:
buffer-length
The length in words of the buffer into which the symbolic input images are read.
buffer-addr
The address of the buffer into which symbolic input images are read.
7833 1733–004 23–13