Previous Topic: FilesNext Topic: Multiple Systems


Upgrades

Starting with CAIENF Version 12.0, the CAS9DB utility is no longer used. For the CAIENF releases before Version 12.0, the CAIENF database was mandatory and the CAS9DB utility initialized and populated the database with the DCM definitions. With CAIENF Version 12.0 and above, the database is now optional and only required if the event recording is desired. For more information, see CAIENF Customization Considerations.

If the event recording is turned on, the database is only used for event data. The database no longer houses DCM information. CAIENF now directly loads and reads the DCM modules as part of CAIENF startup. CAIENF Parameters now tell CAIENF which DCMs to load and interrogate. A new CAIDCM DD statement points at the data sets that hold the product DCMs.

The following table provides the CCS Version 12.0 and above equivalent of old CAS9DB functions:

CAS9DB DBIN Statement

CAIENF Version 12.0 and Above Equivalent

INST DB(ENFDB) DCM(xxxxxxxx)

CAIENF Parameter control statement:

DCM(xxxxxxxx)

and in CAIENF Procedure:

//CAIDCM DD DSN=hlq.CAIDCM,…

// DD DSN=hlq.product.llq

ALTER DB(ENFDB)

EVENT(xxxxxxxx) OPT(A,R,P)

RETPD(nn)

CAIENF Parameter control statements:

EVENT(xxxxxxxx,ACT)

EVENT(xxxxxxxx,REC)

EVENT(xxxxxxxx,RP=n)

EVENT(xxxxxxxx,PURGE=Y)

LIST DB(*) DETAIL

Use the new CAS9DCMR utility for DCM event information.

Use the CASQL003 sample job in the CAW0JCL data set to obtain recorded event record counts.

QUERY DB(*) SELECT ……

CA Datacom/AD DBSQLPR utility.

See CASQL001, 002, 003 CAW0JCL data set sample members.

INST DB(ENFDB) DCM(xxxxxxxx)

REPLACE

Use CAS9DCMR utility SYSPUNCH output data set DROP TABLE statements as input to CAW0JCL member CASQL004. Run CAW0JCL member CADB001 and CASQL004 with CAIENF down, but with an external MUF active.

Some products require an updated level of their DCM to be compatible with CAIENF Version 12.0 and above. The CCS cover letter supplies CA Technologies product PTF numbers or higher product release numbers that must be in place to run with CAIENF Version 12.0 and above. If these PTFs have not been applied, they can be applied before upgrading to CAIENF Version 14.0.

If you do not have your previous release CAIENF CAS9DB database initialization jobs, a utility is available to interrogate the output of a CAS9DB LIST DB(*) DETAIL report. The utility also creates the appropriate CAIENF ENFPARM statements. The CAS9DB report must run while you are running the previous release of CAIENF.

To obtain a CCS Version 11.0 detail listing, use the following JCL:

//CAS9DB   EXEC PGM=CAS9DB,REGION=4096K,TIME=1440
//STEPLIB  DD DSN=YOUR.COMMON.SERVICES.R11.CAILIB,DISP=SHR   => Update
//DBOUT    DD DISP=(NEW,CATLG),                                    
//         DSN=YOUR.R11.ENFDB.LISTING,                 => UPDATE
//         UNIT=3390,VOL=SER=??????,SPACE=(CYL,(1,1)),             
//         DCB=(RECFM=FBA,LRECL=133,BLKSIZE=6118)                  
//DBIN     DD *
  LIST DB(*) DETAIL
/*                                

After you have obtained a detail listing, see the CCS SAMPJCL member ENFUTIL for instructions on how to edit the ENFUTIL JCL. The output from the ENFUTIL job can be placed within the member or data set referenced by the ENFPARMS DD in your CAIENF startup procedure.