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

PIPE SAFE
Syntax
SAFE
►►
SAFE
*
name APPEND
SEIZE
PIPE SAFE
Command Description
A SAFE is a place to store one or more messages associated with a command
procedure. The SAFE stage allows the user to read from or write to a default or
named SAFE. The messages in a SAFE retain their full message structure and
attributes.
If a multiline message created at 08:16:55 and colored red is stored in a safe, then
retrieved and displayed, the displayed message still has the multiline structure,
same time stamp, and is red. Moreover, a DOM that matched the original message
matches the retrieved copy.
The PIPE SAFE stage is similar to the PIPE KEEP stage; PIPE KEEP enables you to
define a task-global place to store messages and PIPE SAFE is a place to store one
or more messages associated with a command procedure. For information about
PIPE KEEP stage, see “PIPE KEEP” on page 150.
The types of SAFE are defined as follows:
default SAFE
The current message associated with a command procedure. For example,
when the automation table invokes a command procedure, the default
message is the automated message.
v The default SAFE is preserved as long as the command procedure runs.
v A default SAFE can contain at most one message.
named SAFE
A named area for a queue of messages associated with a command
procedure group. For example, a REXX command list can write messages
to a named SAFE, then call a second REXX command list which can read
from, or write to, that named SAFE using the PIPE command.
v A named SAFE is preserved as long as the command procedure group
runs.
v A named SAFE can contain any number of messages.
v A command procedure group can have any number of named SAFEs at
a given time.
When SAFE is a first stage, the specified SAFE is read into the pipeline. For a
named SAFE, this can cause multiple messages to be read into the pipeline.
When SAFE is not a first stage, the input messages are written to the specified
SAFE. For the default SAFE just one message is written and all messages are
copied to the output stream. For a named SAFE, each input message is written to
the SAFE and to the output stream.
►◄
Chapter 2. Pipeline Stages and Syntax 207