DROP:
 
         .- FIRST-.  .- 1-----.  .- MSGS--.
|--DROP--+--------+--+--------+--+--------+---------------------|
         '- LAST--'  '- count-'  '- LINES-'
 

Stage Operands	Synonym
MSGS	MSG
LINES	LINE

The DROP stage enables you to specify how many messages or lines are to be discarded from the primary output stream. When the specified number of messages or lines are read from the input stream and discarded, all other messages or lines are copied to the primary output stream.

Discarded messages or lines are passed to the secondary output stream, if connected.

Stream Type	Number Supported
Input	1
Output	2

DROP terminates when the input stream or both output streams disconnect.

count

Specifies the number of messages or lines on the input stream to be discarded. Valid values are in the range of 1 - 10 000 000. The default is 1.

FIRST|LAST

Specifies whether the messages or lines dropped are the first or last messages or lines in the stream. The default is FIRST.

LINES

Specifies that count is the number of lines within the input stream to be dropped. If LINES is not specified, DROP will discard the number of messages indicated by count.

MSGS

Specifies that count is the number of messages within the input stream to be dropped.

DROP cannot be the first stage.

---

[ Top of Page | Previous Page | Next Page ]