IXG261E
SHORTAGE OF DIRECTORY EXTENT RECORDS TOTAL numTotal IN USE: numInuse AVAILABLE: numAvail

Explanation

System logger has detected a shortage of log data set directory extent records in the active LOGR couple data set for PRODUCTION group log streams. System logger might eventually fail log stream offloads if it cannot obtain a log data set directory extent required to process the offload. The system issues this message if the number of in-use log data set directory extent records in the active LOGR couple data set exceeds 85 percent of the total number of log data set directory extent records in the LOGR couple data set. The counts in the message are the values that existed when the condition was detected. These do not reflect the real time record counts in the current couple data set.

In the message text:
numTotal
is the total number of log data set directory extent records formatted in the active primary LOGR couple data set.
numInuse
is the number of log data set directory extent records currently in use in the active primary LOGR couple data set.
numAvail
is the number of log data set directory extent records available for use in the active primary LOGR couple data set.

System action

The system logger will continue processing. This condition can proceed in one of two directions:
  1. Shortage is relieved

    This means that the number of in-use log data set directory extent records has dropped below 80 percent of the total formatted in the active primary LOGR couple data set for the PRODUCTION group.

    This could happen either as a result of system activity resulting in a number of log data set directory extent records being freed from log streams, thus increasing the available pool for the PRODUCTION group or because a new LOGR couple data set was brought into the sysplex as the primary LOGR couple data set and this LOGR couple data set was formatted with a larger number of log data set directory extent records.

    The shortage could also be relieved if the activities of TEST group log streams are reduced by deleting TEST group log streams or by reducing the retention period for log data associated with TEST group log streams.

    If this storage is relieved, this message will be deleted (DOMed).

  2. Shortage becomes critical

    This means that the number of in-use log data set directory extent records has exceeded 95 percent of the total formatted in the active primary LOGR couple data set.

    If this occurs, the system will issue message IXG262A to notify you of the critical shortage.

Operator response

Notify the system programmer.

System programmer response

You must increase the pool of available log data set directory extent records in the active primary LOGR couple data set. You can increase the available pool in one of the following two ways:
  1. Formatting a new LOGR couple data set.

    You can format a new LOGR couple data set and increase the number of log data set directory extent records through the DSEXTENT keyword on the couple data set format utility. As help in determining the number of additional log data set directory extent records to specify, this message includes the total number of log data set directory extent records that are formatted in active primary LOGR couple data set, numTotal, the number of currently in-use log data set directory extent records, numInuse, and the number of currently available log data set directory extent records, numAvail.

    To relieve the shortage, you must reduce the number of in-use log data set directory extent records to below 80 percent of the total formatted.

  2. Freeing log data set directory extents from existing log streams.
    You can also relieve the shortage by freeing log data set directory extent records being consumed by existing log stream definitions. You can free log data set directory extent records in two different ways:
    1. Deleting log stream definitions.

      If you can identify unnecessary log stream definitions that are consuming log data set directory extents, deleting the log stream definition will immediately free the log data set directory extents associated with that log stream back into the available pool.

      As an aid in detecting unnecessary log stream definitions, check the log stream GROUP attribute. You can delete TEST group log streams before you delete PRODUCTION group log streams.

    2. Reducing the retention period for log data.

      If you can identify log streams that are defined with excessive retention periods and these log streams are consuming log data set directory extent records, you can free up log data set directory extent records by reducing the retention period, thus increasing the available pool.

      For TEST group based log streams, you can make the retention period small so that the data can be quickly deleted, thus occupying less directory extent records.

      Note: System logger does not necessarily react immediately to reductions in the retention period. The rule for when system logger will process reductions in the retention period is upon the next log data set switch event for the log stream. This implies that the log stream must be connected and incurring sufficient write activity to force data set switch events.

      You can run a report of the log streams defined in the LOGR couple data set to help you identify candidates for cleanup. The report utility program is IXCMIAPU.

User response

None.

Programmer response

None.

Source

System logger (SCLOG)

Module

IXGA1SWT

Routing code

1

Descriptor code

11