Sizing coupling facility log streams

You must work out the sizes of the CICS® primary and secondary system log streams, forward recovery logs, and user journals and autojournals.

  • Primary system log stream.
    Use the following guidelines when you size CICS primary system log stream, DFHLOG:
    • Minimize the amount of data that is offloaded to auxiliary storage.
      The MVS™ system logger begins the offload process when the high offload threshold (HIGHOFFLOAD) of the log stream is reached. The offload process has two steps:
      1. The MVS logger physically deletes the data in the log stream that the CICS log tail deletion process has marked for deletion.
      2. The MVS logger calculates how much data must be offloaded to auxiliary storage, based on the difference between HIGHOFFLOAD and LOWOFFLOAD, less the amount of data that was deleted since the last offload event.
      To minimize the amount of data offloaded from the CICS primary system log:
      • Define a suitably sized coupling facility structure.
      • Ensure that the log tail deletion process is working effectively. For detailed information about the log tail deletion process, see Log tail deletion.
    • Avoid structure full events.

      A structure full event occurs when the structure space of a log stream becomes full before the offloading of data has completed. For information about monitoring and avoiding structure full events, see CICS logging and journaling.

  • Secondary log stream.

    You must size the secondary system log stream, DFHSHUNT, to avoid structure full events. However, typically some data is offloaded from DFHSHUNT to auxiliary storage.

  • General logs.

    You must size forward recovery logs, user journals, and autojournals to avoid structure full events. However, because CICS does not delete data from these log streams, data is typically offloaded to auxiliary storage.

Setting attribute values for structure, log stream and system definitions

You can use the z Systems® Coupling Facility Structure Sizer tool (CFSizer) to calculate storage requirements for coupling facility log streams. CFSizer is a web-based application that communicates with a coupling facility at a current CFLEVEL to calculate storage requirements. See CFSizer.

You can use the CFSizer tool to calculate the following values:
  • INITSIZE
  • SIZE
For more information, see Structure size for system log usage.

For information about the CPC support for different CFLEVELs and the function in each CFLEVEL, see CF levels.

You can use the formulas provided in Structure size for system log usage to calculate the following values:
  • INITSIZE
  • AVGBUFSIZE
  • SIZE
  • LOWOFFLOAD
You can use the formula provided in Staging data set size calculation to calculate the following value:
  • STG_SIZE

You must base your calculations on the journaling requirements of your applications.

Table 1 summarizes how you decide on the values for various attributes on the structure definition, log stream definition, and system definition.
Table 1. How to decide on the values of attributes
Facility Attribute Method or Value
Structure INITSIZE Use CFSizer or the formula in INITSIZE calculation.
SIZE Use CFSizer or the formula in SIZE calculation.
AVGBUFSIZE Use the formula in AVGBUFSIZE calculation. Underestimate rather than overestimate.
MAXBUFSIZE 64 000
Primary system log stream (DFHLOG) HIGHOFFLOAD 80
LOWOFFLOAD Use the formula in LOWOFFLOAD calculation.
Secondary system log stream (DFHSHUNT) HIGHOFFLOAD 80
LOWOFFLOAD 0
General log stream HIGHOFFLOAD 80
LOWOFFLOAD 40 – 60
Log stream STG_SIZE Use the formula in Staging data set size calculation. Overestimate rather than underestimate.
CICS system AKPFREQ 4 000
Startup might take longer than you experienced when using earlier releases. This is partly caused by the allocation and formatting of the staging data sets. Increased startup time depends on factors that include the following:
  • Size of staging data set (STG_SIZE)
  • DASD speed
  • DASD contention
You can reduce startup time by avoiding large staging data sets.