DFS4901E THE LOAD FOR DFSMDA MEMBER name FAILED FOR IMS CATALOG HLQ. REASON=reason_text

Explanation

When IMS attempted to access the IMS directory data sets of the IMS catalog, an error occurred when IMS attempted to retrieve the high-level qualifier of the IMS directory data sets from an IMSCATHLQ DFSMDA member.

In the message text:
name
The name of the IMSCATHLQ DFSMDA macro statement that defines the high-level qualifier of the IMS directory data sets.

If the error occurred when the IMS Catalog Library Builder utility (DFS3LU00) was running, the name that is displayed in the message is the value that is specified on the IMSCATHLQ control statement in the utility JCL. The name that is specified on the IMSCATHLQ control statement must match the name that is specified on the DDNAME parameter of the IMSCATHLQ DFSMDA member that contains the HLQ of the IMS directory data sets.

If the error occurred when an application program attempted to access a GSAM database, the name that is displayed is the alias name of the IMS catalog with HLQ appended. IMS uses this value to retrieve the IMSCATHLQ DFSMDA member that defines the HLQ of the IMS directory data sets. The alias name is specified in either the CATALOG section of the DFSDFxxx PROCLIB member or in the DFS3CDX0 exit routine.

reason_text
The reason can be one of the following strings:
GETMAIN FAILURE
A request for storage failed.
DFSMDA MEMBER NOT FOUND
A DFSMDA member that matches the MDA member name displayed in the message text could not be found.
BLDL ERROR
An error occurred during a BLDL macro call for the DFSMDA member.
INVALID DFSMDA MEMBER
The DFSMDA member that is identified in the message text contains an error. Check the DFSMDA statements that define the member.
LOAD ERROR
An error occurred while attempting to load the DFSMDA member.
BSDS FAILED OPEN
The boot strap data set of the IMS directory failed to open.
BSDS FAILED ALLOC
The boot strap data set of the IMS directory failed to allocate.

System action

The process terminates abnormally.

Output destination of message

The message is sent to the z/OS® system console.

System programmer response

Correct the error and resubmit the job.

Module

DFS3LU00, DFS3LU10, DFS3LU20, DFS3DF00, DFS3DF10