DFHLG0760    date time applid Log stream lsn not trimmed by keypoint processing. Number of keypoints since last trim occurred: trimnum. History point held by transaction: transid, task number: trannum.

Explanation

The CICS log manager has been unable to trim the tail of MVS logger log stream lsn, during an activity keypoint.

CICS will attempt to trim the system log log streams during activity keypoint processing, to delete redundant data from the oldest end of the log stream (the tail).

Note that this message is only issued if the primary system log stream (DFHLOG) fails to be trimmed during a keypoint operation. It is not issued if a trim does not occur for the secondary system log stream (DFHSHUNT). This is since a trim of the primary system log stream is considerably more likely to occur per keypoint, and hence failures to trim the primary system log stream should be recognized, and investigated if required.

System action

CICS continues processing.

User response

This is an informational message, but should be treated as a warning of a potential problem if the number of keypoints that have been unable to trim the primary system log stream continues to increase. Occasional keypoints that fail to trim DFHLOG are not unexpected events. However, if the message is issued by a number of sequential keypoints then this warrants further investigation.

The keypoint operation was unable to trim the tail of DFHLOG because the oldest log records on the log stream belong to a Unit Of Work (UOW) that is still required. This may be a validly long-running UOW; alternatively, it may be part of a long-running task executing an application that generates log records but does not issue syncpoint requests regularly enough.

This may be a transient phenomenon due to an atypical long-running UOW. Review the number of keypoints that have been unable to trim the log. Check what message CICS issues for log stream lsn at the next activity keypoint. Message DFHLG0743 indicates the log stream is now successfully trimmed. Another DFHLG0760 message indicates a long-running UOW still exists on the system. If the log stream still cannot be trimmed, use the CEMT INQUIRE UOW command to review the oldest UOWs on the system.

The transaction identifier and the task number of the task whose UOW relates to the oldest data on DFHLOG are also provided in the DFHLG0760 message. The CEMT INQUIRE TASK command may be used to review them.

It is also worthwhile reviewing how often CICS is performing activity keypoints (as defined by the AKPFREQ system definition parameter).

Note - it may be possible that the task whose UOW relates to the oldest data on DFHLOG is no longer present in the system, typically if it was executing under an open TCB and happened to complete its syncpoint while the keypoint task was determining the history point for the log stream. If this is the case then the message inserts for the transid and trannum will show as question marks (????). The log data for this completed UOW will be eligible for deletion at the next keypoint.

Module

DFHL2CHE

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. lsn
  5. trimnum
  6. transid
  7. trannum

Destination

CSMT



DFHLG0760.html | Timestamp icon Last updated: Sunday, 4 June 2017