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

PIPE CZR
Syntax
CZR
►► CZR TIME STCKvalue
CzID decimalCzID
Alternate syntax
CZR
►► CZR TIME STCKvalue
CzID decimalCzID
1
count
1
count direction
Command Description
The CZR stage retrieves messages from the Canzlog database. Messages retrieved
are identical with the original message at the time it was logged. Use the CZR
stage in conjunction with the CNMECZFS command, so that filtering can be
applied prior to message identification. The CZR stage returns only messages that
match the current filter established by CNMECZFS; the input time or message
identifier serves as a starting point for a search of Canzlog data for messages
matching the filter.
Streams
If a secondary output is defined and connected, a single line is written there at the
completion of operations. This single line consists of three numbers, as follows:
1. Number of messages actually produced by CZR on its primary output
2. The Canzlog database ID (CzID) of the next message from which your search
can resume, if you want to continue the search. If the search reached the end of
data, a minus one (-1) is returned.
3. A zero (0), if all requested messages were produced; otherwise an indication of
how much time the search consumed in units of 0.004096 seconds.
Stream Type Number Supported
Input 1
Output 2
−
+
PIPE CZR
Termination Conditions
CZR terminates when any of these conditions is met:
v When its primary output stream is disconnected.
v When the time for searching defined by DEFAULTS CZBRWAIT has expired.
v When the last record in the direction indicated has been examined.
►◄
►◄
Chapter 2. Pipeline Stages and Syntax 65