IMS region startup with ACF2 IMS interface gets message ACFDC014 LOAD FAILED FOR MODULE ACFDCXAM

Products

• ACF2
• ACF2 - DB2 Option
• ACF2 for zVM
• ACF2 - z/OS
• ACF2 - MISC
• PanApt
• PanAudit

Issue/Introduction

Starting an IMS region with ACF2 IMS interface gets message ACFDC014 LOAD FAILED FOR MODULE ACFDCXAM. 

 

Environment

Release:
Component: ACF2MS

Resolution

Message ACFDC014 LOAD FAILED FOR MODULE ACFDCXAM means that the ACF2 IMS interface was unable to load module ACFDCXAM.
ACFDCXAM is in the CAX1IMS steplib library.
This error will occur if this library is a PDS/E.
The ACF2 IMS interface uses the IMS MODULE macro to request the load of ACF2 IMS support routines.
The IMS IMODULE macro does not support the loading of modules from a PDS/E.
If CAX1IMS is currently a PDS/E you should copy it to a PDS.

Additional Information

You may experience IMS restart failures because when IMS came down, due to the ACF2VCXAM load failure, IMS lost track/access to its log files.

When IMS was restarted, it was restarted as an EMERGENCY start. 
EMERGENCY restarts attempt to locate the log files from the previous run. 
That is where/when IMS experienced its own failure and would not start. 
|Start IMS with COLDSTART. 
IMS would then create a new log file environment and things would work.