IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

PIPE QSAM
PIPE QSAM
Syntax
QSAM:
QSAM
Synonyms
(DD)
(DSN)
data_set_name
data_definition_name APPEND
Stage Name Synonym
QSAM (read) <
QSAM (write) >
Note: The < and > synonyms for QSAM read and write can only be used when <
and > are immediately followed by a data set name enclosed in quotation
marks. The < synonym has additional functionality as the < (from disk)
stage. See “PIPE < (From Disk) ” on page 278 and “PIPE > (To Disk) ” on
page 281 for more information.
Command Description
The QSAM stage reads and writes from dynamically allocated data definition
names or data sets. Other devices are also supported when allocated for Physical
Sequential access.
Streams
196 Programming: Pipes
The QSAM stage can be used with either a data definition name defined by the
ALLOCATE command, or a fully qualified data set name. If desired, a data set
name can be enclosed in single quotation marks. The quotation marks are ignored.
When specified as a first stage to read a file, QSAM reads from the data definition
name or data set. When not specified as a first stage, QSAM writes to the data
definition name or data set. The messages received on the input stream are passed
to the output stream.
Stream Type Number Supported
Input 1
Output 2
Termination Conditions
When specified as a first stage to read a file, the QSAM stage terminates when
end-of-file is reached or when the output stream is disconnected. When not a first
stage, QSAM terminates when the input stream is disconnected.
A signed 10-digit decimal return code is written to the secondary output stream if
the secondary stream is connected.