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

* REXX sample command list */
’PIPE LITERAL //’,
’| SAFE ABC’
The SAFE named ABC exists and contains one message. The message in the SAFE
has no associated message text.
Example: Passing Messages to a Second PIPE Command
The following example shows how a PIPE command can pass messages to a
second PIPE command using the default SAFE.
PIPE LITERAL /Message created by outer PIPE/
| NETVIEW PIPE (STAGESEP %) SAFE *
% LITERAL /Message created by inner pipe/
% COLLECT
% CONSOLE
| CONSOLE ONLY
The outer pipe generates a message and invokes the inner pipe. The inner pipe
reads the outer pipe's message, adds another message to it, COLLECTs both
messages into a multiline message and sends it to the outer pipe. The outer pipe
displays the multiline message with the CONSOLE ONLY stage.
Example: Passing Messages to a REXX command list
Issue a PIPE command, which invokes a REXX command. The REXX command
reads its default SAFE into the pipeline and displays it to the console.
PIPE LITERAL /Message created by PIPE/
| NETVIEW SHOWDFLT
| CONSOLE ONLY
/* SHOWDFLT REXX COMMAND LIST */
’PIPE SAFE *’,
’| LITERAL /Message created by SHOWDFLT/’,
’| COLLECT’,
’| CONSOLE’
In this example the PIPE command creates a message and calls the SHOWDFLT
command list. The SHOWDFLT command list reads the current message (passed
by invoking PIPE) into its pipeline. A second message is added and a multiline
message is created. The CONSOLE stage within the SHOWDFLT command list
passes the multiline message to the CONSOLE ONLY stage of the invoking PIPE
and the message is displayed.
Example: Using a Named SAFE as a Message Queue
A named SAFE (THISSAFE) is used as a message queue for command procedures
in a command procedure group. To begin, invoke the following SAFEEX1
command list:
/* SAFEEX1 REXX COMMAND LIST */
’PIPE LITERAL /Added by SAFEEX1/’,
’| SAFE THISSAFE’
’SAFEEX2’
’PIPE SAFE THISSAFE’,
’| COLLECT’,
’| CONSOLE CLEAR’
/* SAFEEX2 REXX COMMAND LIST */
’PIPE LITERAL /Added by SAFEEX2/’,
’| SAFE THISSAFE APPEND’
’SAFEEX3’
/* SAFEEX3 REXX COMMAND LIST */
’PIPE LITERAL /Added by SAFEEX3/’,
’| SAFE THISSAFE APPEND’
PIPE SAFE
Chapter 2. Pipeline Stages and Syntax 209