CA Datacom DB00501E RC 43 (002) CXXNAME change

book

Article ID: 127519

calendar_today

Updated On:

Products

CA Datacom CA DATACOM - AD 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

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)