CA Datacom DB00501E RC 43 (002) CXXNAME change

Products

• Datacom
• DATACOM - AD
• CIS
• COMMON SERVICES FOR Z/OS
• 90S SERVICES
• DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS
• COMMON PRODUCT SERVICES COMPONENT
• Common Services
• CA ECOMETER SERVER COMPONENT FOC
• EASYTRIEVE REPORT GENERATOR FOR COMMON SERVICES
• INFOCAI MAINTENANCE
• IPC
• UNICENTER JCLCHECK COMMON COMPONENT
• Mainframe VM Product Manager
• CHORUS SOFTWARE MANAGER
• CA ON DEMAND PORTAL
• CA Service Desk Manager - Unified Self Service
• PAM CLIENT FOR LINUX ON MAINFRAME
• MAINFRAME CONNECTOR FOR LINUX ON MAINFRAME
• GRAPHICAL MANAGEMENT INTERFACE
• WEB ADMINISTRATOR FOR TOP SECRET
• Xpertware

Issue/Introduction

After changing the CXX name the following  MUF error occurs:

DB00501E - OPEN ERROR - RETURN CODE 43 (002) CXX=cxx_new_name (IXX01006) CXXLINK=cxx_old_name

 

 

Cause

The RC 43 (002) indicates the database file is linked to a different CXX. Datacom keeps a connection between the CXX and the database files using the CXX name. In the above error message, the files is linked to a CXX named cxx_old_name  but the CXX is named cxx_new_name.

Environment

Release:
Component: DB

Resolution

To link a file to the new CXX name run DBUTLTY with the LINK function, all files for all DBIDs defined in the CXX need to be linked, use the following syntax:

LINK DBID=1-5000

The Datacom MUF must be active to run this. Note any areas defined as VIRTUAL will fail to link and this is OK. 
A temporary change to the MUF startup is needed if DBID 1006 is used.  In the MUF startup parameters remove the 1006 at the end of the CBS card. Add it back after running the LINK and restart the MUF.
Sample JCL:

//LINK EXEC PGM=DBUTLTY,REGION=6M 
//STEPLIB  DD DISP=SHR,DSN=DATACOM.CUSLIB 
//         DD DISP=SHR,DSN=DATACOM.CABDLOAD  (for Datacom/AD use CAAXLOAD) 
//SYSPRINT DD SYSOUT=* 
//SYSOUT   DD SYSOUT=* 
//SYSPUNCH DD DUMMY 
//CXX      DD DSN=DSN=DATACOM.CXX,DISP=SHR 
//SYSIN    DD * 
LINK DBID=1-5000 
/* 

Additional Information

See DocOps sections Return Code 43 and LINK (Link to the CXX)