Detector collection ended because of storage shortage

book

Article ID: 52138

calendar_today

Updated On:

Products

CA RC/Migrator CA Endevor SCM Interface DB2 Administration CA RC Compare for DB2 for z/OS CA RC Extract for DB2 for z/OS CA RC/Query CA RC Secure for DB2 for z/OS CA RC Update for DB2 for z/OS CA Bind Analyzer for DB2 for z/OS CA Detector CA SQL-Ease for DB2 for z/OS CA Sysview Performance Management Option for DB2 for z/OS CA Database Detector for DB2 for z/OS CA Plan Analyzer for DB2 for z/OS CA Subsystem Analyzer for DB2 for z/OS CA Database Analyzer for DB2 for z/OS CA Fast Unload for DB2 for z/OS CA Fast Check for DB2 for z/OS CA Fast Index for DB2 for z/OS CA Fast Load for DB2 for z/OS CA Rapid Reorg for DB2 for z/OS

Issue/Introduction

Description:

Upgraded Detector from r11.5 to r12 and now Xmanager r12 output gets an error message related to storage shortage:

PDT0171 DETECTOR COLLECTION INTERVAL END FORCED DUE TO XMANAGER STORAGE SHORTAGE, DB2=ssid

Solution:

Although Xmanager r12 works with 64-bit storage above the bar, it is still possible to get error message PDT0171 if the Xmanager JCL startup does not have the appropriate parameters.

For example, with r11.5 the Xmanager JCL had REGION=32M and it started up without problem, now with r12 this value is not valid. With Xmanager r12 and REGION=32M you have to define the storage above the bar with parameter MEMLIMIT. MEMLIMIT can be explicitly set in the Xmanager JCL and should be at least 2G.

//XMANAGER EXEC PGM=PXMINICC,MEMLIMIT=xG

With REGION=0M then MEMLIMIT defaults to NOLIMIT. But MEMLIMIT=NOLIMIT is not recommended. If there is a problem allocating storage in the Xmanager address space then you will encounter problems because a lot of storage above the bar (64-bits) might be allocated without sense. So the recommended values are REGION=0M and MEMLIMIT a value between 2G and 4G.

For example in a large installation, 2G may not be enough and it is possible that PXM0372 message can be issued under normal conditions.

PXM0372 XMANAGER REGION INUSE HAS REACHED SHORTAGE THRESHOLD FOR type

Additionally you can specify values for CUSH64(low,high), CUSH64 controls Xmanager monitoring of 64-bits storage usage. With a value of MEMLIMIT under 4G, CUSH64(20,50) should be fine.
When the high limit is reached, you should see PXM0372 message issued and both CA Detector and CA Subsystems Analyzer will terminate active collections. When the low limit is reached, you should see PXM0371 and PXM0370 messages and Xmanager will shut itself down.

Keep in mind as well the storage for REGION and MEMLIMIT parameters can be restricted by a IEFUSI exit> Values in this exit have to be set accordingly and allow Xmanager to work with 64-bits storage.

Environment

Release:
Component: PXM