Journalname: Resource statistics

You can retrieve Journalname statistics by using the EXEC CICS EXTRACT STATISTICS JOURNALNAME command. They are mapped by the DFHLGRDS DSECT. These statistics fields contain the resource data that is collected by the log manager domain.

For more information about logging and journaling, see CICS logging and journaling. 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.

Table 1. Journalname: Resource statistics
DFHSTUP name Field name Description
Journal Name LGRJNLNAME The journal name.

Reset characteristic: not reset
Journal Type LGRJTYPE The type of journal: MVS, SMF, or dummy.

Reset characteristic: not reset
Log Stream Name LGRSTREAM The log stream name that is associated with the journal. Only journals that are 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 The total number of times that a journal record was written to the journal.

Reset characteristic: reset to zero
Bytes Written LGRBYTES The total number of bytes written to the journal.

Reset characteristic: reset to zero
Buffer Flushes LGRBUFLSH The total number of times that a journal block was written to the log stream (in the case of a journal that is defined as type MVS), or to the System Management Facility (in the case of a journal that is defined as type SMF).
Journal blocks are flushed in the following circumstances:
  • An application executes an EXEC CICS WRITE JOURNALNAME or EXEC CICS WRITE JOURNALNUM command with the WAIT option.
  • An application executes an EXEC CICS WAIT JOURNALNAME or EXEC CICS WAIT JOURNALNUM command.
  • The journal buffer is full. This applies only to journals defined as type SMF (journals that are 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