Error IXG261E SHORTAGE OF DIRECTORY EXTENT RECORDS when writing to log streams

Products

• SYSVIEW Performance Management

Issue/Introduction

An error message similar to the following may appear when SYSVIEW is attempting to write records to a log stream:

IXG261E SHORTAGE OF DIRECTORY EXTENT RECORDS TOTAL: 50 IN-USE: 43 AVAILABLE: 7 error message.

 

Environment

z?OS

Cause

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 two ways:

1. Formatting a new LOGR couple data set.
   
   
2. Freeing log data set directory extents from existing log streams.

 

Resolution

You can manage the number of data set directory extents using the DSEXTENT parameter in the LOGR couple data set format utility IXCL1DSU. If you have log streams that require more than 168 DASD log data sets, increase the value of DSEXTENT. Each additional directory extent specified goes into a common pool available to any log stream in the sysplex. System logger allocates these directory extents as needed when a log stream runs out of DASD log data set directory space. Each directory extent allows a log stream to extend by 168 additional log data sets.

Additional Information

The z/OS 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.