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:
- The MVS logger physically deletes the data in the log stream that the CICS log tail deletion process has marked for deletion.
- 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.
- Minimize the amount of data that is offloaded to auxiliary storage.
- 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.
- INITSIZE
- SIZE
For information about the CPC support for different CFLEVELs and the function in each CFLEVEL, see CF levels.
- INITSIZE
- AVGBUFSIZE
- SIZE
- LOWOFFLOAD
- STG_SIZE
You must base your calculations on the journaling requirements of your applications.
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 |
- Size of staging data set (STG_SIZE)
- DASD speed
- DASD contention