CEMT INQUIRE STREAMNAME
Retrieve information about currently connected MVS™ log streams.
Description
You can use the INQUIRE STREAMNAME command to inquire on the currently connected MVS log streams.
Input
Press the Clear key to clear the screen.
There are two ways to start this transaction:
- Type CEMT INQUIRE STREAMNAME (or suitable abbreviations for the keywords). The resulting display lists the current status.
- Type CEMT INQUIRE STREAMNAME (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i str fai sys, the resulting display shows the details of only those stream names that are failed and that are the system log.
- (value)
- Specifies an MVS system logger log stream name. The name can be a specific LSN of up to 26 characters.
- ALL
- The default.
Sample screen
Figure 1. CEMT INQUIRE STREAMNAME
screen
IN STRE
STATUS: RESULTS
Str(BELL.CICSHT61.DFHLOG ) Use(0000001) Ok Sys
If you place the cursor against a specific entry in the list and press ENTER, CICS® displays an expanded format, as shown in Figure 2.
Figure 2. The expanded display of an individual entry
IN STRE
RESULT
Streamname(BELL.CICSHT61.DFHLOG)
Usecount(0000001)
Status(Ok)
Systemlog(Syslog)
CEMT INQUIRE STREAMNAME .-ALL-----. >>-CEMT INQUIRE STREAMNAME--+---------+--+-----------------+----> '-(value)-' '-USECOUNT(value)-' >--+--------+--+----------+------------------------------------>< +-OK-----+ +-SYSLOG---+ '-FAILED-' '-NOSYSLOG-'
Displayed fields
- STATUS
- Displays
the status of the log stream. The values are as follows:
- 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 as follows:
- 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 true even when user application programs write recovery records to the CICS system log.
