Journalname statistics

This section contains the following statistics:

Journalname: Resource statistics

These statistics fields contain the resource data collected by the log manager domain. For more information on logging and journaling, see Logging and journaling: performance considerations, and Interpreting journalname and log stream statistics. Note that for the system logs DFHLOG and DFHSHUNT, CICS® does not use the journal for writing purposes, but writes directly to the log stream. So for these journals, 'N/A' appears in the report under the headings 'Write requests', 'Bytes written' and 'Buffer flushes'.

These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS JOURNALNAME command, and are mapped by the DFHLGRDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.

Table 76. Journalname: Resource statistics
DFHSTUP name Field name Description
Journal Name LGRJNLNAME is the journal name.

Reset characteristic: not reset

 

Journal Type LGRJTYPE is the type of journal: MVS™, SMF, or dummy.

Reset characteristic: not reset

 

Log Stream Name LGRSTREAM is the log stream name associated with the journal. Only journals defined as type MVS have associated log streams. The same log stream can be associated with more than one journal.

Reset characteristic: not reset

 

Write Requests LGRWRITES is the total number of times that a journal record was written to the journal.

Reset characteristic: reset to zero

 

Bytes Written LGRBYTES is the total number of bytes written to the journal.

Reset characteristic: reset to zero

 

Buffer Flushes LGRBUFLSH is the total number of times that a journal block was written to the log stream (in the case of a journal defined as type MVS), or to the System Management Facility (in the case of a journal defined as type SMF).

Journal blocks are flushed in the following circumstances:

  • An application executes an EXEC CICS WRITE JOURNALNAME (or JOURNALNUM) command with the WAIT option.
  • An application executes an EXEC CICS WAIT JOURNALNAME (or JOURNALNUM) command.
  • The journal buffer is full. This applies only to journals defined as type SMF (journals defined as type MVS use log stream buffers).
  • The log stream buffer is full. This applies only to journals defined as type MVS.

Reset characteristic: reset to zero

 

Journalname: Summary resource statistics

Summary statistics are not available online.

These statistics fields contain the journalname summary resource data. For the system logs DFHLOG and DFHSHUNT, CICS does not use the journal for writing purposes, but writes directly to the log stream. So for these journals, 'N/A' appears in the summary report under the headings 'Write requests', 'Bytes written' and 'Buffer flushes'.

Table 77. Journalname: Summary resource statistics
DFHSTUP name Description

 

Journal Name is the journal name.

 

Journal Type is the journal type:
  • MVS
  • SMF
  • dummy

 

Log Stream Name is the name of the log stream associated with the journal.

 

Write Requests is the total number of times that a journal record was written to the journal.

 

Bytes Written is the total number of bytes written.

 

Buffer Flushes is the total number of times that a journal block was written to the log stream (in the case of a journal defined as type MVS), or to the System Management Facility (in the case of a journal defined as type SMF).

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting journalname and log stream statistics
DFH0STAT reports for these statistics
Journalnames Report
[[ Contents Previous Page | Next Page Index ]]