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

SIR$–Symbolic Input/Output Routine
The following table lists SIR$ source output operations in greater detail. The columns of
the table list the P option, the Q option, and both the P and the Q options. Note that the
"neither P nor Q option" case is discussed later in this section. There are separate rows
in the table for input images in Fieldata, ASCII, ASCII-like CCSs, the 22 "other" CCSs, and
the illegal CCS. The input image may originate in either the runstream or the source
input. The intersection of the columns and rows is the SIR$ source output action with
this combination of options and input image CCS type.
Input Image Type
P Option
Fieldata Unchanged
Fieldata image
ASCII Translated to
Fieldata image
ASCII-like Translated to
Fieldata image
"Other CCS" Error; image
not written
Illegal CCS Error; image
not written
Q Option
Translated to
ASCII_ISO
image
Unchanged
ASCII image
Unchanged
ASCII-like
image
Error; image
not written
Error; image
not written
P and Q
Options
Unchanged
Fieldata image
Unchanged
ASCII image
Unchanged
ASCII-like
image
Unchanged
image in
"other" CCS
Error; image
not written
In summary, when the P option is specified, the source output contains only Fieldata
images; when the Q option is specified, the source output can contain images in ASCII
and any of the 39 ASCII-like CCSs; and when both the P and the Q options are specified,
the source output can contain images in any of the 63 legal CCSs.
When neither the P nor the Q option is specified, the CCS of source output images
depends on the presence of the I option.
When the I option is specified, both the P and the Q option are assumed. Runstream
images in all 63 legal CCSs can be written unchanged to the source output. The "P and
Q options" column of the preceding table lists the SIR$ source output action for the
runstream image types listed in the rows.
When the I option is not specified, the CCS of the source output image is determined as
follows:
• When a source input image is written to the source output, it is written unchanged
and retains its CCS.
• When a runstream image following a -n line-change statement is written to the
source output, the CCS of the output image is based on the CCS of source input
image n, as shown in the table that follows.
• When a runstream image following a -n,m line-change statement is written to the
source output, the CCS of the output image is based on the CCS of source input
image m, as shown in the table that follows.
23–8 7833 1733–004