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

Usage Notes
PIPE < (From Disk)
8. BNJPNL2
9. DSILIST
10. DSIOPEN
11. DSIASRC
12. DSIARPT
ddname
Specifies the name of a standard NetView DDNAME, such as DSIPARM or
DSICLD, from where to read the member. See the BROWSE command help for
a list of valid DDNAMEs. When ddname is not specified, the default is
DSIPARM. When specifying ddname, a period (.) is used to separate it from
the member name. Do not use spaces before or after the period.
member
Specifies the 1- to 8-character name of the member or file to be read (parameter
synonyms are not supported). This name is a member of the data set
concatenation associated with the ddname being used.
INCL
Specifies that %INCLUDE statements are expanded when the member or file is
read, and that "data REXX" statements, if present, are executed.
Note: Data REXX files are special REXX programs that send data to an
environment external to the data REXX program. For more information
on data REXX, see IBM Tivoli NetView for z/OS Customization Guide and
IBM Tivoli NetView for z/OS Programming: REXX and the NetView
Command List Language.
DISKONLY
Indicates that any member loaded by the INSTORE stage is ignored.
dsname
When specified as a fully qualified data set name within single quotes, this
stage is processed as a QSAM (read) stage. See the help for the QSAM (read)
stage (“PIPE QSAM” on page 196) instead of this "From Disk" help text for
details on how QSAM (read) processing works.
v The < (From Disk) stage must be the first stage.
v Access security for the < (From Disk) stage is provided through the READSEC
command. See the IBM Tivoli NetView for z/OS Security Reference for information
about the READSEC command.
v The < (From Disk) stage utilizes one or more QSAM read operations. The
NetView program uses the QSAM GET macro to perform these operations. Refer
to the appropriate QSAM documentation for more information.
v If the NetView program is running under z/OS 1.10 or earlier and if a QSAM
read is performed on a newly allocated data set that is not managed by SMS
before any write, the read might return residual data from the previously
deleted data set. If this previously deleted data set had a different record size,
the QSAM read fails with message
DWO970I QSAM : GET FAILED WITH RETURN CODE 1006
Message DWO050E is also logged.
To avoid these problems, you can perform one of the following processes:
– Write a blank line to the data set first before doing any read
– Have the data set managed by SMS
– Start the NetView program under z/OS release 1.11
Chapter 2. Pipeline Stages and Syntax 279