CEMT INQUIRE JOURNALNAME

Show the status of the CICS® system log and general logs.

Description

You can use the INQUIRE JOURNALNAME command to inquire on the status of the CICS system log and general logs. It replaces the INQUIRE JOURNALNUM command.

Input

Press the CLEAR key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE JOURNALNAME (or suitable abbreviations for the keywords). The resulting display lists the current status.
  • Type CEMT INQUIRE JOURNALNAME (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 jo sm, the resulting display shows the details of only those logs that are of SMF log stream type.
(value)
Specifies one or more journal names.

To inquire on journals defined with a numeric identifier in the range 1 - 99, specify journal name DFHJnn, where nn is the journal number.

To inquire on the system log, specify DFHLOG.

To inquire on the log-of-logs, specify DFHLGLOG.

ALL
The default.

Sample screen

Figure 1. CEMT INQUIRE JOURNALNAME screen
  IN JOUR
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Journaln(DFHJ02  ) Smf Ena
   Journaln(DFHLGLOG) Mvs Ena
      Str(CICSHT##.CICSHTA1.DFHLGLOG  )
   Journaln(DFHLOG  ) Mvs Ena
      Str(CICSHT##.CICSHTA1.DFHLOG    )
   Journaln(DFHSHUNT) Mvs Ena
      Str(CICSHT##.CICSHTA1.DFHSHUNT  )
Note: Blank fields on the screen indicate that a value does not apply or is negative; that is, it begins with No.

If you place the cursor against a specific entry in the list, CICS displays an expanded format as shown in Figure 2.

Figure 2. The expanded display
  IN JOUR
  RESULT - OVERTYPE TO MODIFY
    Journalname(DFHLOG)
    Type(Smf)
    Status( Enabled )
    Action(              )
    Streamname(CICSHT##.CICSHTA1.DFHLOG)

CEMT INQUIRE JOURNALNAME

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE JOURNALNAME ALL( value)MVSSMFDUMMYENABALEDDISABLEDFAILEDFLUSHRESETSTREAMNAME( value)

Displayed fields

ACTION (value)
Specifies the action you want CICS to take for the specified journal name. The values are:
FLUSH
The log buffers are written out to the log stream, but the journal is not closed.

You can use this option to ensure that all current records are written out to the log stream before the stream is processed using a batch utility.

RESET
The journal is disabled but can be re-enabled by the SET JOURNALNAME RESET command.
JOURNALNAME (value)
Indicates that this panel relates to a journal name inquiry and displays a 1- to 8-character journal name.
STATUS
Displays the status of the journal. The values are as follows:
ENABLED
The journal is installed and available for use.
DISABLED
The journal has been disabled by a CEMT, or EXEC CICS, SET JOURNALNAME(…) command. It cannot be used until it is re-enabled by the STATUS(ENABLED) or ACTION(RESET) options on a SET JOURNALNAME command.
FAILED
The journal has experienced a log stream failure. It cannot be used until it is re-enabled by the STATUS(ENABLED) or ACTION(RESET) options on a SET JOURNALNAME command, or following the next CICS restart. The log stream should be deleted from the MVS™ system logger inventory before being used again.
Note: You can reset STATUS with ENABLED or DISABLED.
STREAMNAME (value)
Displays the MVS log stream name associated with the journal. CICS displays 8 blanks (X'40') if the journal is defined with a type of DUMMY or SMF.
TYPE
Displays the type of log stream. The possible types are as follows:
MVS
Records for journals defined with this journal model are written to an MVS log stream.
SMF
Records for journals defined with this journal model are written to the MVS SMF data set.
DUMMY
Records for journals defined with this journal model are not written to any log stream.