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

SIR$–Symbolic Input/Output Routine
The information for symbolic input and output elements or files (for example, their
names) is obtained from the entries in PARTBL. The information in PARTBL is usually
produced by the PREPRM and PREPRO (see 14.1.1) or PREPF$ (see 14.2) routines from
information specified on the processor call statement.
Some options placed on a processor call statement affect the SIR$ routine. These
options are listed in 23.1.
Depending on which options are specified, SIR$ is directed to
• Write images in Fieldata, ASCII, or without translation.
• Read and check sequence numbers.
• Create symbolic elements from the runstream.
• Update and produce new element cycles.
• List runstream line change statements and change images.
SIR$ reads, processes and writes system data format (SDF) images.
SDF data images from the source input element or file have implicit, sequential line
numbers, beginning with 1. The numbers on runstream correction images refer to the
source input line numbers.
SDF control images in the source input may be passed to the calling program, but the
control images do not have line numbers and do not affect the line numbering of the
source input data images.
See the Data Structures Programming Reference Manual for a description of SDF data
images and control images. See the ECL and FURPUR Reference Manual for a
description of runstream correction images.
Note the following CCS-related restrictions on runstream correction images:
• Runstream line change statements (-n and -n,m), partial line change statements
(-n- and -n,m-) and partial line change editing statements (c/new-data, c,d/new-data/,
/old-data/new-data and /old-data/new-data/) must be Fieldata, ASCII, or ASCII-like
images.
• Runstream partial line change statements (-n- and -n,m-) can only be used to edit
source input images that are Fieldata, ASCII or ASCII-like. That is, source input line n
(first format) or lines n through m (second format) must be Fieldata, ASCII, or
ASCII-like images.
• The CCS of a source input image does not change when it is edited by a partial line
change statement and partial line change editing statements.
• When the partial line change editing statements (c/new-data, c,d/new-data/,
/old-data/new-data, and /old-data/new-data/) are in a different ASCII-like CCS than the
source input image being edited, differences in the graphic representation of
characters may affect the results of SIR$ editing operations.
23–2 7833 1733–004