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

PIPE HOLE
PIPE HOLE
Syntax
HOLE:
HOLE
Command Description
The HOLE stage discards the contents of the pipeline. Also, you can use it to
determine whether a command has correlated output.
Streams
Use HOLE as a first stage to start a pipeline. Using HOLE in this way enables a
stage that cannot normally be used as a first stage to start a pipeline by placing the
stage immediately after HOLE.
Stream Type Number Supported
Input 1
Output 1
Termination Conditions
HOLE terminates when the input stream disconnects.
Operand Descriptions
This stage has no operand descriptions.
Usage Notes
Examples
138 Programming: Pipes
v Only commands that produce correlated output can be used effectively with the
PIPE command. You can use the HOLE stage to determine whether a command
produces correlated output. Code the command you want to test in a PIPE
command and follow it with the HOLE stage:
PIPE NETV your_command_name | HOLE
If the command produces correlated output, the output from the command
enters the pipeline and is discarded by the HOLE stage. If you do not see the
usual output from the command, you know that the command produces
correlated output and can be used effectively with the PIPE command.
v See “PIPE NETVIEW ” on page 167 for a list of some commands for which
command and response correlation is supported.
Example: Waiting 5 Seconds
The following command waits 5 seconds.
PIPE CORRWAIT 5
| HOLE