Logstreams Report

Figure 88 shows the format of the Logstream Global Report. This report is produced using the EXEC CICS® COLLECT STATISTICS STREAMNAME command. The statistics data is mapped by the DFHLGGDS DSECT. The field headings and contents are described in Table 212. For more information about logstreams, see Logging and journaling: performance considerations.

Figure 88. The Logstream Global Report
Applid IYK2Z1V2  Sysid CJB2  Jobname CI07CJB2    Date 12/17/2004  Time 08:44:37     CICS 6.4.0      PAGE    80
 
Logstream - Global
 
   Activity Keypoint Frequency (AKPFREQ). . . . . :         5,000
   Activity Keypoints Taken . . . . . . . . . . . :             0
   Average time between Activity Keypoints. . . . :      00:00:00   (Since Last Statistics Reset)

   Logstream Deferred Force Interval (LGDFINT). . :             5ms

Table 212. Fields in the Logstream Global Report
Field Heading Description
Activity Keypoint Frequency (AKPFREQ) The current activity keypoint trigger value, which is the number of logging operations between the taking of keypoints.

Source field: EXEC CICS INQUIRE STREAMNAME

Activity Keypoints Taken The number of activity keypoints taken.

Source field: EXEC CICS INQUIRE STREAMNAME()

Average time between Activity Keypoints The average time between the taking of activity keypoints.
Logstream Deferred Force Interval (LGDFINT) The current logstream deferred force interval.

Source field: EXEC CICS INQUIRE STREAMNAME

Figure 89 shows the format of the Logstream System Logs Report. This report is produced using a combination of the EXEC CICS INQUIRE STREAMNAME and EXEC CICS COLLECT STATISTICS STREAMNAME commands. The statistics data is mapped by the DFHLGSDS DSECT. The field headings and contents are described in Table 213.

Figure 89. The Logstream System Logs Report
Applid IYK2Z1V1  Sysid CJB2  Jobname CI07CJB2    Date 12/17/2004  Time 08:44:37     CICS 6.4.0      PAGE    81
 
Logstream - System Logs
 
System log - DFHLOG

  Logstream Name . . . . . . . . . . . . . :  CBAKER.IYK2Z1V1.DFHLOG          Logstream Status . . . . . . . . . . . . :          OK

  DASD Only. . . . . . . . . . . . . . . . :  YES                             Retention Period (days). . . . . . . . . :           0
  Coupling Facility Structure Name . . . . :                                  Auto Delete. . . . . . . . . . . . . . . :          NO

  Logstream Writes . . . . . . . . . . . . :           2                      Maximum Block Length . . . . . . . . . . :      65,532
  Logstream Writes per second. . . . . . . :        0.00
  Average Bytes per Logstream Write. . . . :         797

  Logstream Deletes (Tail Trims) . . . . . :           1

  Logstream Query Requests . . . . . . . . :           4

  Logstream Browse Starts. . . . . . . . . :           0
  Logstream Browse Reads . . . . . . . . . :           0
  Logstream Buffer Appends . . . . . . . . :           5
  Logstream Buffer Full Waits. . . . . . . :           0

  Logstream Force Waits. . . . . . . . . . :           0                      Logstream Current Force Waiters. . . . . :           0
  Logstream Retry Errors . . . . . . . . . :           0                      Logstream Peak Force Waiters . . . . . . :           0

------------------------------------------------------------------------------------------------------------------------------------

System log - DFHSHUNT

  Logstream Name . . . . . . . . . . . . . :  CBAKER.IYK2Z1V1.DFHSHUNT        Logstream Status . . . . . . . . . . . . :          OK

  DASD Only. . . . . . . . . . . . . . . . :  YES                             Retention Period (days). . . . . . . . . :           0
  Coupling Facility Structure Name . . . . :                                  Auto Delete. . . . . . . . . . . . . . . :          NO

  Logstream Writes . . . . . . . . . . . . :           0                      Maximum Block Length . . . . . . . . . . :      65,532
  Logstream Writes per second. . . . . . . :        0.00
  Average Bytes per Logstream Write. . . . :           0

  Logstream Deletes (Tail Trims) . . . . . :           1

  Logstream Query Requests . . . . . . . . :           1

  Logstream Browse Starts. . . . . . . . . :           0
  Logstream Browse Reads . . . . . . . . . :           0
  Logstream Buffer Appends . . . . . . . . :           0
  Logstream Buffer Full Waits. . . . . . . :           0

  Logstream Force Waits. . . . . . . . . . :           0                      Logstream Current Force Waiters. . . . . :           0
  Logstream Retry Errors . . . . . . . . . :           0                      Logstream Peak Force Waiters . . . . . . :           0

Table 213. Fields in the Logstream System Logs Report
Field Heading Description
Logstream Name The name of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME()

Logstream Status The current status of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME() STATUS()

DASD Only Indicates the type of logstream. If set to 'YES', the logstream is of type DASDONLY. If set to 'NO', the log stream is of type coupling facility (CF).

Source field: LGSDONLY

Retention Period (days) The logstream retention period (in days) that the data must be kept before it can be physically deleted by the MVS™ Logger.

Source field: LGSRETPD

Coupling Facility Structure Name The coupling facility (CF) structure name for the logstream. The structure name is only applicable to coupling facility type logstreams.

Source field: LGSSTRUC

Auto Delete The log data auto delete indicator. If set to 'YES' the MVS Logger automatically deletes the data as it matures beyond the retention period, irrespective of any logstream delete calls. If set to 'NO', the data is only deleted when a logstream delete call is issued and the data has matured beyond the retention period.

Source field: LGSAUTOD

Logstream Writes The number of write (IXGWRITE) requests issued to this logstream.

Source field: LGSWRITES

Maximum Block Length The maximum block size allowed by the MVS Logger for the logstream.

Source field: LGSMAXBL

Logstream Writes per second The number of logstream writes per second for this logstream.

Source field: (LGSWRITES / ELAPSED-SECONDS)

Average Bytes per Logstream Write The average number of bytes written to this logstream per write request.

Source field: (LGSBYTES / LGSWRITES)

Logstream Deletes (Tail Trims) The number of delete (IXGDELET) requests issued to this logstream.

Source field: LGSDELETES

Logstream Query Requests The number of query requests issued for this logstream.

Source field: LGSQUERIES

Logstream Browse Starts The number of browse start requests issued for this logstream.

Source field: LGSBRWSTRT

Logstream Browse Reads The number of browse read requests issued for this logstream.

Source field: LGSBRWREAD

Logstream Buffer Appends The number of occasions on which a journal record was successfully appended to the current log stream buffer.

Source field: LGSBUFAPP

Logstream Buffer Full Waits The number of times buffer full has occurred for this logstream.

Source field: LGSBUFWAIT

Logstream Force Waits The total number of tasks suspending whilst requesting a flush of the logstream buffer currently in use.

Source field: LGSTFCWAIT

Logstream Current Force Waiters The current number of force waiters for this logstream.

Source field:

Logstream Retry Errors The number of occasions on which MVS system logger retryable errors occurred when a block of data was being written to the log stream.

Source field: LGSRTYERRS

Logstream Peak Force Waiters The peak number of force waiters for this logstream.

Source field: LGSPKFWTRS

Figure 90 shows the format of the Logstreams Resource Report. This report is produced using a combination of the EXEC CICS INQUIRE STREAMNAME and EXEC CICS COLLECT STATISTICS STREAMNAME commands. The statistics data is mapped by the DFHLGSDS DSECT. The field headings and contents are described in Table 214.

Figure 90. The Logstreams Resource Report
Applid IYK2Z1V2  Sysid CJB2  Jobname CI07CJB2    Date 12/17/2004  Time 08:44:37     CICS 6.4.0      PAGE    60
 
Logstreams - Resource
 
                                Use           Sys                     Max Block  DASD   Retention   Auto   Stream   Browse   Browse
  Logstream Name               Count  Status  Log  Structure Name      Length    Only    Period    Delete  Deletes  Starts    Reads 
 
  CBAKER.IYK2Z1V2.DFHJ04           1    OK    NO                         32,000  YES           21   YES        N/A      N/A      N/A
  CBAKER.IYK2Z1V2.DFHJ05           2    OK    NO                         48,000  YES           14   YES        N/A      N/A      N/A
  CBAKER.IYK2Z1V2.DFHJ06           2    OK    NO   LOG_GENERAL_001       64,000  NO             0   NO         N/A      N/A      N/A
  CBAKER.IYK2Z1V2.DFHJ08           1    OK    NO   LOG_GENERAL_001       64,000  NO             0   NO         N/A      N/A      N/A
  CBAKER.IYK2Z1V2.DFHLOG           1    OK    YES  LOG_GENERAL_005       64,000  NO             0   NO           0       46        0
  CBAKER.IYK2Z1V2.DFHSHUNT         1    OK    YES  LOG_GENERAL_006       64,000  NO             0   NO           0        0        0

Table 214. Fields in the Logstreams Resource Report
Field Heading Description
Logstream Name The name of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME()

Use Count The current use count of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME() USECOUNT()

Status The current status of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME() STATUS()

Sys Log Indicates if the log stream forms part of the System Log.

Source field: LGSSYSLG

Structure Name The coupling facility (CF) structure name for the log stream. The structure name is only applicable to coupling facility type logstreams.

Source field: LGSSTRUC

Max Block Length The maximum block size allowed by the MVS Logger for the log stream.

Source field: LGSMAXBL

DASD Only Indicates the type of log stream. If set to 'YES' the log stream is of type DASDONLY. If set to 'NO' the log stream is of type coupling facility (CF).

Source field: LGSDONLY

Retention Period The log stream retention period (in days) that the data must be kept before it can be physically deleted by the MVS Logger.

Source field: LGSRETPD

Auto Delete The log data auto delete indicator. If set to 'YES' the MVS Logger automatically deletes the data as it matures beyond the retention period, irrespective of any logstream delete calls. If set to 'NO' the data is only deleted when a logstream delete call is issued and the data has matured beyond the retention period.

Source field: LGSAUTOD

Stream Deletes The number of delete (IXGDELET) requests issued for this logstream.

Source field: LGSDELETES

Browse Starts The number of browse start requests issued for this logstream.

Source field: LGSBRWSTRT

Browse Reads The number of browse read requests issued for this logstream.

Source field: LGSBRWREAD

Figure 91 shows the format of the Logstreams Requests Report. This report is produced using a combination of the EXEC CICS INQUIRE STREAMNAME and EXEC CICS COLLECT STATISTICS STREAMNAME commands. The statistics data is mapped by the DFHLGSDS DSECT. The field headings and contents are described in Table 215.

Figure 91. The Logstreams Requests Report
Applid IYK2Z1V3  Sysid CJB2  Jobname CI07CJB2    Date 12/17/2004  Time 08:44:137     CICS 6.4.0      PAGE     61
 
 
Logstreams - Requests
 
 
                                Write                        Average     Buffer      Buffer     Force   Current    Peak   Retry
  Logstream Name               Requests    Bytes Written      Bytes      Appends   Full Waits   Waits   Waiters  Waiters  Errors
  _______________________________________________________________________________________________________________________________
 
  CBAKER.IYK2Z1V3.DFHJ04              30           30,366       1,012          30           0        0        0        0        0
  CBAKER.IYK2Z1V3.DFHJ05              60           60,656       1,010          60           0        0        0        0        1
  CBAKER.IYK2Z1V3.DFHJ06              30           30,290       1,009          30           0        0        0        0        0
  CBAKER.IYK2Z1V3.DFHJ08               0                0           0           0           0        0        0        0        0
  CBAKER.IYK2Z1V3.DFHLOG              10            6,578         657          20           0        0        0        0        0
  CBAKER.IYK2Z1V3.DFHSHUNT             0                0           0           0           0        0        0        0        0
 

Table 215. Fields in the Logstreams Requests Report
Field Heading Description
Logstream Name The name of the logstream.

Source field: EXEC CICS INQUIRE STREAMNAME()

Write Requests The number of IXGWRITE requests issued to this logstream. IXGWRITE occurs, for example, when the logstream buffer is full, or when the application issues an EXEC CICS WRITE JOURNALNAME command with the WAIT option specified.

Source field: LGSWRITES

Bytes Written The number of bytes written to this logstream.

Source field: LGSBYTES

Average Bytes The average number of bytes written to this logstream per request.

Source field: (LGSBYTES / LGSWRITES)

Buffer Appends The number of occasions on which a journal record was successfully appended to the current logstream buffer.

Source field: LGSBUFAPP

Buffer Full Waits The number of times buffer full has occurred for this logstream.

Source field: LGSBUFWAIT

Force Waits The total number of force waits for this logstream.

Source field: LGSTFCWAIT

Peak Waiters The peak number of force waiters for this logstream.

Source field: LGSPKFWTRS

Retry Errors The number of occasions on which MVS logger retryable errors occurred when a block of data was being written to the log stream.

Source field: LGSRTYERRS

Related reference
Back to full list of DFH0STAT reports
The DFH0STAT reports
Interpreting these statistics
Interpreting journalname and log stream statistics
Full listing and DFHSTUP reports for these statistics
Logstream statistics
[[ Contents Previous Page | Next Page Index ]]