ENF fails to initialize and abends with a U0203 after issuing a CAS9312E message.

book

Article ID: 17923

calendar_today

Updated On:

Products

CA CIS CA Common Services for z/OS CA 90s Services CA Database Management Solutions for DB2 for z/OS CA Common Product Services Component CA Common Services CA Datacom/AD CA ecoMeter Server Component FOC CA Easytrieve Report Generator for Common Services CA Infocai Maintenance CA IPC Unicenter CA-JCLCheck Common Component CA Mainframe VM Product Manager CA Chorus Software Manager CA On Demand Portal CA Service Desk Manager - Unified Self Service CA PAM Client for Linux for zSeries CA Mainframe Connector for Linux on System z CA Graphical Management Interface CA Web Administrator for Top Secret CA CA- Xpertware CA Compress Data Compression for MVS CA Compress Data Compression for Fujitsu

Issue/Introduction

ENF fails at startup and can issue a CAS9312E message stating that a DCM cannot be loaded.      

 

 

 

 

 

 

 

Cause


ENF can fa
il at startup with a U0203 abend after issuing messages similar to the following:
CAS9214I - CA-ENF Command: DCM(DCMNAME)
CAS9312E - Load failed for DCM object "DCMNAME" - X'00000806'/X'00000004'
CAS9314E - DCM processing completed with error.
*CAS9203E - CA-ENF Initialization error - terminating
IEF450I jobname stepname - ABEND=S000 U0203 REASON=00000018

As evidenced by the X'00000806' return code, the failure is due to the fact that the DCM object named on the CAS9214I and CAS9312E messages cannot be found.

Environment

CA Common Services r14.1 or r15.0  using the ENF component.

Resolution

Beginning with CA Common Services for z/OS r12.0, the DCM statements are no longer stored in the ENF database. Due to this change, the DCM object names themselves are listed in the ENFPARM member found in your current cai.CAW0OPTN dataset listed on the //ENFPARM DD of the ENF proc.

The format of the parm is:



DCM(object,<ddname|*>)



and the default format is



DCM(object)



In order to access the DCMs needed for various CA Products and Solutions, a new DD statement //CAIDCM DD was added to the ENF proc and is now used to point to the DCM objects.



The CAS9312E message and subsequent S806 is commonly attributed to, and corrected by, one of the following reasons and corrective actions.  The CROSS-PLATFORM SCHEDULER FEEDBACK  DCM, CAL2DCM2 will be used as an example:



REASON #1
The required DCM is not found in the default dataset CAI.CAW0DCM defined on the //CAIDCM DDName.




CORRECTIVE ACTION
Either add the required DCM to the CAI.CAW0DCM library or concatenate the library where it is found to the //CAIDCM DDName. This would be used with the default form of the DCM parameter as listed above.



DCM(CAL2DCM2)



 




REASON #2 
The required DCM is found in a dataset that is either linklisted or named on the JOBLIB/STEPLIB card of your ENF procedure.




CORRECTIVE ACTION
If the required DCM is found in a linklisted library or one named named on the JOBLIB/STEPLIB card of your ENF procedure, you need to change the format of the DCM parm to DCM(CAL2DCM2,*). The ",*" will trigger ENF to look in the JOBLIB/STEPLIB concatenation and if not found there, search z/OS LNKLST/LPALST concatenation.





REASON #3 
The required DCM is found in a dataset that is not referenced in the ENF procedure, linklist, joblib or steplib.




CORRECTIVE ACTION
If the library is not referenced you can either copy the DCM or concatenate the library to the //CAIDCM DD as stated above. Another method is to add a unique DD name to the ENF proc to point to the necessary loadlib and change the format of the DCM parm by adding the DDName to the JCL. For example, you wish to use a DDName of XPSFBK. Change the parm to read DCM(CAL2DCM2,XPSFBK) and add the //XPSFBK DDName to the ENF procedure.

Additional Information

Please reference the current copies of the Common Services for z/OS r14.1 or r15.0 online documentation under the section labeled Configure DCM Statements for more details.  

Attachments

1558534759670TEC615749.zip get_app