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

PIPE CZR
66 Programming: Pipes
Operand Descriptions
count
The number of messages wanted. CZR continues to search for messages in the
direction indicated.
CzID
Indicates that Canzlog database ID is supplied as a starting point. The
association of a CzID with a message can last from a few minutes to a few
hours, depending on usage. Your usage of the CzID is limited to values
obtained during a program run, as from the secondary output of a previous
invocation of the CZR stage, and continuing without any wait or suspension.
decimalCzID
A CzID obtained from a previous invocation, from examination of a message
using CzID edit stage, or from a DISPMSG display. Be careful to use fresh
(meaning recently obtained) numbers, as all CzIDs expire at some point. Use
this with CzID keyword
direction
A plus sign (+) or a minus sign (-) indicating the direction of search. The CZR
stage searches for messages matching the current filter. Because of the search,
the input time or CzID can be approximate. The default minus (-) means to
search UP toward older messages. A plus sign (+) means search DOWN
toward more recent messages.
STCKvalue
A store-clock value in EBCDIC, where CZR should begin to search for your
message. Use this with the TIME keyword. If fewer than 16 characters are
given, the value is padded on the right with zeroes. CZR can extrapolate from
FFFFFFFF to give you the most recent message, but when searching upward
(with plus sign), use a date that is within the range of the available data to
avoid I/O errors.
TIME
Indicates that a time in STCK format is supplied as a starting point. Note that
times in U.S. standard format can be converted to STCK format using the edit
orders DTS and C2X together. Be careful not to specify a time earlier than any
record in the Canzlog data, because this causes an error.
Command Description
Requested messages are output on the primary output stream. If a secondary
output is connected, a message with three numbers is displayed, indicating
v The number of messages returned.
v A CzID that can be used to continue search in the same direction.
v An indication of how long the operation took in units of about 1/244 seconds
(more precisely, 1.048576/256 second units). The number returned can be less
than the number requested due to RESET, excessive errors (skipped segments),
or excessive time. The suggested starting point for continued search can be
minus one (-1); this means that there are no more messages in the indicated
direction.
Usage Notes
A CzID is a direct index to a message and is the fastest way to locate a message.
Depending on system demands, CzIDs might be stable for several hours or for
only several seconds. If a wait occurs between obtaining a CzID and its use, or if
an unexpected message is obtained, start your search again using the last known
good store-clock value.