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

PIPE KEEP
Examples
152 Programming: Pipes
The command is invoked with the same authority as the pipe command
that specified the command string. Be careful when composing the
command because neither authority nor syntax is checked until the time of
invocation.
Example: Accumulating Data
In the following examples, data is accumulated about a resource prior to an action:
IF MSGID=’IST950I’ & TEXT = . ’NCP44’ . THEN
EXEC(CMD(’PIPE SAFE * | KEEP NCP44 600 APPEND’))
ROUTE(ONE NETOP1);
* Keep messages until no message has been received
for ten minutes
* Note that all references to keep NCP44 must be
invoked on the same opid
IF MSGID=’IST6778A’ & TEXT = . ’NCP44’ . THEN
EXEC(CMD(’CHKNCP NCP44’));
* Another message causes us to examine the history...
Where CHKNCP begins as follows:
/* CHKNCP REXX */
parse arg keepName /* Keep names are case sensitive */
’PIPE (NAME CHKNCP1)’,
’| KEEP’ keepName ’SEIZE’, /* empty, not copy, the Keep */
’| TAKE LAST 2’, /* to examine PART of the history */
’| EDIT IFRAUGMT OPDT 1’, /* we need times of the two events*/
’| STEM timeOfEvents.’
... examine times in stem var
Example: Operator Logoff Actions
In a user-written REXX procedure, you can use
’PIPE SAFE * | EDIT MSGSENDER | VAR targetOP’
to determine the source of the current message.
/* Use AUTO1 to take action related to other tasks logging off */
’PIPE (NAME SETLOGOF)’
’| LITERAL /any text here/’,
’| KEEP LOGOFF * ENDCMD /EXCMD AUTO1, myRexx/’
Example: Using Global Keep
To use a global keep, you can use
IF MSGID=’IST950I’ & TEXT = . ’NCP44’ . THEN
EXEC(CMD(’PIPE SAFE * | KEEP GLOBAL /NCP44/ 600 APPEND’))
ROUTE(ONE NETOP1);
Note that references to KEEP GLOBAL /NCP44/ do not need to be invoked on the
same opid
IF "MSGID’’IST6778A & TEXT=.’NCP44’ THEN
EXEC(CMD(’CHKNCP NCP44’));
Where CHKNCP begins as follows:
/* CHKNCP REXX */
parse arg keepName /* Keep names are case sensitive */
’PIPE (NAME CHKNCP1)’,
’| KEEP’ GLOBAL keepName ’SEIZE’, /* empty, not copy, the Keep */