IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 131)

CEMT INQUIRE STREAMNAME
CEMT INQUIRE STREAMNAME
Function: Retrieve information about currently connected
MVS log streams.
Description: The INQUIRE STREAMNAME command
allows you to inquire on the currently connected MVS log
streams.
Input: Press the Clear key to clear the screen. There are
two ways of commencing this transaction:
Type CEMT INQUIRE STREAMNAME (the minimum
abbreviation is CEMT I STR ). You get a display that lists
the current status.
Type CEMT INQUIRE STREAMNAME ( CEMT I STR ) followed by
as many of the other attributes as are necessary to limit
the range of information that you require. So, for
example, if you enter
cemt i str fai sys , the resulting
display will show you the details of only those
streamnames that are failed and that are the system log.
You can then tab to the highlighted or blank fields and
overtype them with the required values.
┌ ┐ ─ALl─
─ ─ ─CEMT Inquire STReamname ─ ─ ─ ─┴ ┴ ───── ────────
─ ─ ── ─ ─ ─(value) ─ ─┬ ┬ ───────────────── ───────────
└ ┘ ─ ─Usecount(value)
─ ─ ─┬ ┬ ──────── ─ ─┬ ┬ ────────── ─
├ ┤ ─Failed─ ├ ┤ ─Syslog───
└ ┘ ─Ok───── └ ┘ ─Nosyslog─
( value)
specifies an MVS system logger log stream name. The
name can be a specific LSN of up to 26 characters in
length.
ALl
is the default.
Sample screen
IN STRE
STATUS:
RESULTS
Str(BELL.CICSHT61.DFHLOG ) Use( 1) Ok Sys
Figure 106. CEMT INQUIRE STREAMNAME screen
If you place the cursor against a specific entry in the list and
press ENTER, CICS displays an expanded format as shown
in Figure 107.
IN STRE
RESULT
Streamname(BELL.CICSHT61.DFHLOG)
Usecount(
1)
Status(Ok)
Systemlog(Syslog)
Figure 107. The expanded display of an individual entry
Displayed fields
Status
displays the status of the log stream. The values are:
Ok No errors have been detected
Failed
The MVS system logger has detected a problem
with the specified log stream.
STReamname( value)
indicates that this panel relates to a STREAMNAME
inquiry and displays an MVS system logger log stream
name.
Systemlog
displays whether this log stream is the system log. The
values are:
Syslog
The log stream is the system log.
Nosyslog
The log stream is not the system log.
Usecount( value)
displays the number of CICS journal names and forward
recovery logs that are currently using the log stream.
The use count is always at least 1, because CICS does
not maintain any information about a log stream that no
longer has any users, in which case an INQUIRE
STREAMNAME command returns an ERROR condition.
If the log stream name refers to the CICS system log,
the use count is always 1. This is so even when user
application programs write recovery records to the CICS
system log.
Chapter 11. Master terminal CEMT 113