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

PIPE PERSIST
Syntax
PERSIST:
PERSIST minutes
MINUTES
DISPLAY
ROUTE label:
COMMAND cmd
TRAP
tText
Command Description
The PERSIST stage specifies the disposition for correlated output after a pipeline
ends.
Operand Descriptions
PIPE PERSIST
minutes
Specifies the number of minutes that the PERSIST condition is active following
the completion of the pipeline in which it is found. The range is 0 - 100,000.
MINUTES
Optional parameter, used only for readability.
DISPLAY
Indicates that the correlated output is to be displayed on the console of the
task where the pipeline ran. The output messages can be automated.
ROUTE
Indicates that the correlated output is to be sent to the specified task.
label:
Specifies a valid label that can be used by the ROUTE stage.
COMMAND
Indicates that the specified command is to be run under the task where the
pipeline ran.
cmd
Specifies the command to be processed.
The command is invoked once for each message received by the PERSIST
stage. When the command is invoked, the newly-received message becomes
the current message and is available to the command through the use of pipe
stage SAFE * or REXX functions such as MSGID.
TRAP
Specifies that messages are to be added to the message queue of the REXX
procedure which called the pipeline containing the PERSIST TRAP stage. Such
messages satisfy a REXX WAIT FOR MESSAGES command and are accessible
to a MSGREAD command.
See the sample usage of PERSIST TRAP under option 13 in sample CNMS1101.
tText
Specifies optional text to be written to the message queue as a last message at
the time the persist completes. Note that MVS commands and the VTAM
VARY command do not generally give an indication of completion. For these
Chapter 2. Pipeline Stages and Syntax 179