IXG312E offload of CICS logstream delayed due to a backup on the same VOLUME

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.

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

Related information

IXG messages

Product Alias/Synonym

CICS/TS CICS TS CICS Transaction Server

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

CICS Transaction Server
Logger Domain

Software version:

3.1, 3.2, 4.1, 4.2, 5.1

Operating system(s):

z/OS

Reference #:

1157576

Modified date:

2014-02-18

Translate my page

Machine Translation

Content navigation