DATACOM requirement of CAMASTER

Products

• Datacom
• DATACOM - AD
• COMMON SERVICES FOR Z/OS

Issue/Introduction

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 Datacom isn't defined to utilize XCF communications, it is also possible for the Multi-User Facility (MUF) to come up and run successfully even though CAMASTER isn't initialized. 

Resolution

It is recommended 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 Datacom are running in a different LPAR than the Multi-User Facility, the jobs will not run.

DBPCCPR, supports Datacom/DB and Datacom/AD 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, Datacom/DB Database and System Administration Guide for 14.0, pages 165-166.

Even though it is recommended that 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.

  Example of possible errors:

  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

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, CAMASTER should be initialized prior to running CAIRIM.