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

PIPE KEEP
million seconds (nearly 4 months) or the value can be indicated by an
asterisk, which means an indefinite timeout.
Note: When a message is input to the KEEP, the timeout period is
refreshed, even if a new timeout is not specified.
APPEND
Used when KEEP is not a first stage. APPEND indicates that messages
already stored are to remain. By default, the KEEP is emptied if KEEP is
not a first stage.
SEIZE Used when KEEP is a first stage. It indicates that messages are taken,
rather than copied from the KEEP. Use SEIZE to improve performance.
SPILL Used when KEEP is not a first stage. When the KEEP expires, SPILL
indicates to display messages in the KEEP. The messages are then subject
to automation and message traps. If the KEEP expires because of a
LOGOFF command or task termination, messages are routed to the
authorized receiver.
Usage Notes:
1. When no exit option is selected and the KEEP already exists, the
previous option remains in force. When the KEEP does not exist, the
default action is NOSPILL.
2. A task termination causes a timeout for a local keep. A global KEEP
does not expire when a task ends, but only when the NetView program
terminates.
NOSPILL
Used when KEEP is not a first stage. When the KEEP expires, NOSPILL
indicates to discard messages in the KEEP.
ENDCMD
Used when KEEP is not a first stage. If ENDCMD is specified, the
delimited string /cmd string/ (described below) is required. ENDCMD
specifies what is to happen when the keep expires. A local keep expires
when either a timeout occurs or when the task is terminated. A global keep
expires when the NetView program terminates.
When the keep expires, the specified command is invoked once for each
message in the keep. For a local keep, the commands run at the task where
the keep exists, For a global keep, the commands run at the task specified
in the CNMSTYLE statement endcmd.autotask. For each invocation, the
message being disposed is made to be the current message. Command
invocation is at low priority, meaning non-preemptive. However, if CMD
HIGH is specified as the first eight characters of the command string, then
it is queued at high priority and preempts other procedures.
When the local keep expires because a task ends, the command is invoked
only if it is EXCMD or DOM (neither EXCMD nor DOM synonyms is
honored, and no command is invoked if the NetView program is closing).
Note that a global KEEP expires when the NetView program ends
normally. A time period given by the CNMSTYLE statement
endcmd.close.leeway. If the NetView program ends because of an abend,
CLOSE ABEND, or system cancel command (abend), endcmd processing is
terminated.
/cmd string/
A delimited string used only with the ENDCMD option. This string defines
the command to be invoked with each message in the keep at termination.
Chapter 2. Pipeline Stages and Syntax 151