AKPFREQ

The AKPFREQ parameter specifies the number of write requests to the CICS® system log stream output buffer required before CICS writes an activity keypoint.

AKPFREQ={4000|number}
4000
This is the default. You are recommended to allow AKPFREQ to assume its default value.
number
Start of changenumber can be 0 (zero) or any value in the range 50 through 65535. You cannot specify a number in the range 1 - 49. End of change
If you specify AKPFREQ=0, no activity keypoints are written, with the following consequences:
  • The CICS system log automatic deletion mechanism does not work so efficiently in this situation. The average system log occupancy would merely increase, maybe dramatically for some users. Without efficient automatic deletion, the log stream spills on to secondary storage, and from there onto tertiary storage (unless you control the size of the log stream yourself).
  • Emergency restarts are not prevented, but the absence of activity keypoints on the system log affects the performance of emergency restarts because CICS must read backwards through the entire log stream.
  • Backout-while-open (BWO) support is seriously affected, because without activity keypointing, tie-up records are not written to the forward recovery logs and the data set recovery point is not updated. Therefore, for forward recovery to take place, all forward recovery logs must be kept since the data set was first opened for update after the last image copy. For more information about the effect of AKPFREQ=0 on BWO, see Effect of disabling activity keypointing.
  • Start of changeReplication support is affected, because without activity keypointing, tie-up records are not written to replication logs. This can affect the performance of the replication engine.End of change

For more information about activity keypointing, see Setting the activity keypoint frequency.



dfha2_akpfreq.html | Timestamp icon Last updated: Thursday, 27 June 2019