When CAIRIM runs, the Program Call PC Routine, DBPCCPR initializes and then DBPCSPR initializes. If CAMASTER does not initialize successfully BEFORE CAIRIM begins, it is possible for DBPCCPR to be successful, but DBPCSPR to fail. If CA Datacom isn't defined to utilize XCF communications, it IS possible for the Multi-User Facility (MUF) to come up and run successfully even though CAMASTER isn't initialized.
CA recommends that CAMASTER be initialized prior to running CAIRIM to initialize the Program Call PC routine, DBPCSPR. DBPCSPR runs in the CAMASTER address space to support special requirements, such as XCF communications, RRS for two-phase processing, running DBUTLTY from a non-APF authorized library. If CAMASTER fails to initialize, then DBPCSPR will fail to initialize and if the applications using CA Datacom are running in a different LPAR than the Multi-User Facility, the jobs will not run.
DBPCCPR, supports Datacom/DB and Datacom/AD 14.0 normal MUF requirements. CAIRIM installs DBPCCPR during the IPL process, or later. If
DBPCCPR is not installed at the time of the first MUF execution, MUF dynamically does the install from the STEPLIB/JOBLIB that MUF is using.
DBPCCPR supports all MUF functions, basic DBUTLTY functions, and MUF user interface requirements.
Reference materials, CA Datacom/DB Database and System Administration Guide for 14.0, pages 165-166.
Even though CA recommends the CAMASTER be initialized prior to running CAIRIM to initialize both Program Call PC routine programs, DBPCCPR and DBPCSPR, it is possible for MUF to come up successfully if the applications using Datacom/AD are run locally and not in another LPAR.
See an example of errors you can get if this is the scenario:
DB90150I - DATACOM DBCR4PR 2011/03/18-1055 14.0 DB90154I - DATACOM DBPCCPR 2012/06/25-1213 14.0 RO47507 DB90151I - DATACOM INITIALIZATION SUCCESSFUL CAS9130I - MODULE DBCR4PR COMPLETE, RC=00 DB90150I - DATACOM DBCR4PR 2011/03/18-1055 14.0 DB90154I - DATACOM DBPCSPR 2012/06/25-1213 14.0 RO47507 DB90155E - ERROR DEFINE RETCODE -036 RSNCODE 632 DB90152E - DATACOM PARM SYNTAX ERROR (D) DB90153E - DATACOM INITIALIZATION FAILED CAS9140E - INIT ERROR: CADATACOM VER BD14, INIT ROUTINE RC=0008
Therefore, because most applications that use Datacom/DB or Datacom/AD communicate via XCF or likely will need the capability of residing in another LPAR than the MUF, we recommend that CAMASTER be initialized prior to running CAIRIM.