7.4 Handling Directory Full Condition

< Day Day Up >

When your installation receives message IXG261E and/or IXG262E, it means that the system logger has detected a shortage of log data set directory extent records in the active LOGR couple data set. In this situation, the system logger may eventually fail log stream offloads if it is unable to obtain a log data set directory extent required to process the offload.

Deleting offload data sets via IDCAMS does not help to solve this situation since the LOGR couple data set keeps track of all data sets. Deleting them (via IDCAMS, for example) will not cause the LOGR couple data set to be updated, and logger will still think the data sets exists, and report missing data if an attempt is then made to access the data mapped (from the contents of the LOGR couple data set) in those data sets.

To solve this situation you can either try to understand which log stream is generating the high number of offload data sets or enlarging the extend portion of the LOGR couple data set.

To determine which log stream is using all the directory entries, you can run the IXCMIAPU utility and then take the corrective action against the log stream, as described by the above referenced messages.

If this does not solve the situation, the following is a list of actions you can take to solve the problem:

Run the IXCMIAPU utility with the LIST option against the log streams to verify which log streams are generating the high amount of offload data sets that are using all the inventory entries. Check also if there is any anomaly in the definition of these log streams. Very often a wrong parameter is the cause of the elevated number of offload data sets being created. For example, a small value for LS_SIZE is very common to be found. This means very small offload data sets and if the log stream is generating a huge amount of data, this can cause many offload data sets being created using all the available directory entries.
Define a new LOGR CDS with a bigger DSEXTENT value that will allow new offload data sets to be allocated. This will give some time to the installation to recover.
The next action is to change the size of the LOGR couple data set with a larger DSEXTENT value, allowing for additional data sets to be defined for the log stream and make this new LOGR couple data set the active data set in the sysplex.
Fixed the problem with the log stream either deleting the log stream or updating the LOGR policy. This should fix the problem permanently.

Following is the procedure to define new LOGR couple data sets and to make them active in the sysplex. Before allocating the new data set, you can display the current allocation with the command D XCF,COUPLE,TYPE=LOGR or you can run the IXCMIAPU and look for the DSEXTENT field in the output display. This tells you how many extent are allocated in the current LOGR couple data set.

Example 7-10: Current LOGR couple data set allocation

 IXC358I  16.15.44  DISPLAY XCF 521 LOGR COUPLE DATA SETS PRIMARY    DSN: SYS1.XCF.LOGR01            VOLSER: #@$#X1     DEVN: 37AC            FORMAT TOD         MAXSYSTEM            12/11/2002 21:43:54        4            ADDITIONAL INFORMATION:             LOGR COUPLE DATA SET FORMAT LEVEL: HBB7705             LSR(200) LSTRR(120) DSEXTENT(10)             SMDUPLEX(1) ALTERNATE  DSN: SYS1.XCF.LOGR02            VOLSER: #@$#X2     DEVN: 37AD            FORMAT TOD         MAXSYSTEM            12/11/2002 21:43:58        4            ADDITIONAL INFORMATION:             LOGR COUPLE DATA SET FORMAT LEVEL: HBB7705             LSR(200) LSTRR(120) DSEXTENT(10)             SMDUPLEX(1) LOGR IN USE BY ALL SYSTEMS

At this point, you can use the IXCL1DSU utility to format a new LOGR CDS. Make sure the new CDS you format has the appropriate number of LSRs, LSTRRs, and a larger DSEXTENTs.

Once you have the new LOGR couple data set allocate, you can make this as the alternate LOGR couple data set in your installation by issuing the command SETXCF COUPLE,ACOUPLE=(new_dsname),TYPE=LOGR

If the addition of this couple data set is successful, then you can proceed and issue the SETXCF COUPLE,TYPE=LOGR,PSWITCH to switch control from the current primary to the new allocated one. Remember to allocate the new alternate since in this moment the installation is running without an alternate LOGR couple data set.

< Day Day Up >