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.
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
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.
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
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.
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
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.
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
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 |