Technote (troubleshooting)
Problem(Abstract)
You receive message IXG311I followed by IXG312E every 60 seconds for a CICS logstream. In this case, the offload is being delayed because a job that backs up the pack containing the offload datasets is running. You want to know how you should reply to message IXG312E. You also want to know if there is a way to do a ADRDSSU backup without causing the logger delay.
Symptom
These are the messages that Logger writes to the console:
IXG301I SYSTEM LOGGER FAILED TO OFFLOAD DATA FOR LOG STREAM
IXG311I SYSTEM LOGGER CURRENT OFFLOAD HAS NOT PROGRESSED
DURING THE PAST 61 SECONDS FOR LOGSTREAM SYSCTS.LOGR.P.DFHLOG, STRUCTURE: NOT APPLICABLE* ALLOCATING DSN=IXGLOGR.SYSCTS.LOGR.P.DFHLOG.<SEQ#>
IXG312E OFFLOAD DELAYED FOR SYSCTS.LOGR.P.DFHLOG, REPLY "IGNORE", "MONITOR", "FAIL", "AUTOFAIL" OR "EXIT"
Following is the JCL that caused the enqueue. It is a backup of non-logger files that happen to be on the same volume as the logger files:
//STEPD010 EXEC PGM=ADRDSSU,REGION=4000K
//SYSPRINT DD SYSOUT=*
//DASD1 DD DISP=SHR,UNIT=DISK,VOL=SER=TSO002
//BACKUP DD DSN=SYS5O.LOGBKPP(+1),
// DISP=(,CATLG),UNIT=CART,DCB=(SYS5.MODEL.DSCB,TRTCH=COMP)
//SYSIN DD *
DUMP INDDNAME(DASD1) -
OUTDDNAME(BACKUP) -
DS (INC(CSCTEST.MSC.SMF*, -
CSCTEST.MSC.LOGR*, -
CSCTEST.SYSLOG, -
CSCTEST.JOBLST*)) -
ALLX -
TOL(ENQF
//*
Cause
The JCL being used for the backup was causing a physical dump which holds an enqueue on the VTOC and stops logger from accessing the volume.
Resolving the problem
Reply "MONITOR" to message IXG312E. MVS APAR OW57050 recommends this and states as a result 'The Logger Event Monitor continues to Monitor the Offload and takes no overt action. If the Offload Allocation is still not complete after another interval, another WTOR will be issued at that time'.
CICS will continue to write to the logstream as long as it is not full. When the backup completes the offload of the logstream will complete and everything continues as normal.
If the offload is not able to complete before the logstream full condition occurs CICS transactions that need to write to the logstream will hang until the offload is complete. Logger automatically retries the operation every 3 seconds while the temporary error condition persists. CICS displays message DFHLG0777 with logger return code X'08' with reason code X'860' (RC08 RSN860 RC 08 RSN 860) for structure full conditions or reason code X'865' (RSN 865 RSN865) for staging dataset full conditions.
Note you can not change the 60 second interval because it is internal to Logger.
If using ADRDSSU, you can do one of the following to bypass the hold on the VTOC and allow Logger to complete the offload:
- change the JCL to a logical dump by specifying LOGINDDNAME in place of INDDNAME
- code exit ADRUENQ which is documented in the DFSMS Installation Exits Guide
Product Alias/Synonym
CICS/TS CICS TS CICS Transaction Server
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.