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.
You can then tab to the highlighted or blank fields and overtype them with the required values.
(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

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE STREAMNAME ALL( value)USECOUNT( value)OKFAILEDSYSLOGNOSYSLOG

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.