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

PIPE DUPLICAT
PIPE DUPLICAT
Syntax
Synonyms
DUPLICAT:
DUPLICAT
1
number
*
Stage Name Synonym
DUPLICAT DUP
Command Description
DUPLICAT copies messages in the input stream and writes the copied messages to
the output stream.
Streams
74 Programming: Pipes
The copies are marked as "copy" (IFRAUCPY on) rather than "primary" (IFRAUPRI
off). The message text is unchanged.
Stream Type Number Supported
Input 1
Output 1
Termination Conditions
DUPLICAT terminates when the input stream or the output stream disconnects.
Operand Descriptions
number
Specifies the number of copies to make in addition to the original message. If
number is zero (0), then the input message is written to the output stream and
no additional copies are made. If number is −1, no additional copies are made
and the input message is discarded from the pipeline.
Number must be −1 or greater. The default is 1.
* An asterisk (*) indicates that DUPLICAT is to make copies indefinitely.
Examples
See also “Example: Discover TSO Stacks Serving a User” on page 242 for an
example of how to use the asterisk (*) DUPLICAT option.
Example: Creating Four Consecutive Utilization Reports
In the following example, AUTO1 executes 4 TASKUTIL commands and returns
the results to the console.