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

PIPE INSTORE
PIPE INSTORE
Syntax
INSTORE:
Synonyms
INSTORE ddname.membername COMMON
LOCAL
NOREPLACE
REPLACE
Stage Operands Synonym
REPLACE REPL
NOREPLACE NOREPL
NOCRYPTO
CRYPTO
Command Description
The INSTORE stage adds, deletes, or replaces in-storage members. The members
are then read from storage rather than the disk by DSIDKS disk services or any
NetView process based on DSIDKS such as BROWSE or the < stage.
Streams
140 Programming: Pipes
If INSTORE is the first stage, the named member is unloaded from storage and
usage is reverted to reading it from disk. Otherwise, the input message lines are
used to load the named member into storage. The member is not read from disk
before loading. To read a member before loading it, place the < stage before
INSTORE.
Note that the STRIP stage can save storage. For example, STRIP TRAILING results
in the data being loaded without trailing blanks, which are then padded back to a
minimum of 80 characters when the data is read. Null input message lines become
blank lines when accessed. If no messages are input, the member is not found by
DSIDKS FIND processes. See the INSTORE examples section for coding samples.
Stream Type Number Supported
Input 2
Output 2
Primary and secondary I/O streams can be defined. The primary input stream
loads, unloads, or replaces in-storage members and its output to the primary
output stream is unchanged. A secondary input stream can be defined if the
pipeline application requires the ability to monitor the data being read into
INSTORE. If INSTORE detects a message on its secondary input stream, it
terminates with return code 12 and the data is not loaded.
If a secondary output stream is defined, a signed, ten digit decimal return code is
written to the secondary output.
+0000000000 member loaded or unloaded successfully
+0000000008 member already loaded and REPLACE not specified
+0000000012 INSTORE terminated by secondary input request