28.11.2012 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

PIPE DROP<br />

PIPE DROP<br />

Syntax<br />

DROP:<br />

DROP<br />

Synonyms<br />

FIRST<br />

LAST<br />

1<br />

count<br />

MSGS<br />

LINES<br />

Stage Operands Synonym<br />

MSGS MSG<br />

LINES LINE<br />

Command Description<br />

The DROP stage enables you to specify how many messages or lines are to be<br />

discarded from the primary output stream. When the specified number of<br />

messages or lines are read from the input stream and discarded, all other messages<br />

or lines are copied to the primary output stream.<br />

Streams<br />

72 <strong>Programming</strong>: <strong>Pipes</strong><br />

Discarded messages or lines are passed to the secondary output stream, if<br />

connected.<br />

Stream Type Number Supported<br />

Input 1<br />

Output 2<br />

Termination Conditions<br />

DROP terminates when the input stream or both output streams disconnect.<br />

Operand Descriptions<br />

count<br />

Specifies the number of messages or lines on the input stream to be discarded.<br />

Valid values are in the range of 1 - 10,000,000. The default is 1.<br />

FIRST|LAST<br />

Specifies whether the messages or lines dropped are the first or last messages<br />

or lines in the stream. The default is FIRST.<br />

LINES<br />

Specifies that count is the number of lines within the input stream to be<br />

dropped. If LINES is not specified, DROP discards the number of messages<br />

indicated by count.<br />

MSGS<br />

Specifies that count is the number of messages within the input stream to be<br />

dropped.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!