Migrate CAIENF from an external ENF MUF (XMUF) to an internal ENF MUF (IMUF)

Products

• COMMON SERVICES FOR Z/OS

Issue/Introduction

We received a recommendation that the best practice is to execute ENF using an IMUF instead of our current setup which uses an external XMUF. 

We found this information related to IMUF in the Common Services r15.0 documentation:  
Imbedded Multi-User Facility (IMUF) Option

Our current environment has a Datacom r15.1 MUF used for Jobtrac, ENF, and all other Broadcom products that need it.

Is there some documentation or article that specifically lists the steps to follow to migrate a CAIENF executing with an external MUF to an IMUF, and all the considerations, risks that it would imply? 

  

 

 

Environment

Release : 15.0
Component: ENF

Resolution

Listing the steps  necessary to migrate from an ENF XMUF environment to IMUF environment.  However, in this case it is also necessary
to create a separate MUF for ENF as the current MUF is shared between ENF and other products which should not be done.                        

Use the following steps in order to accomplish the migration 
         NOTE: (STEP1 is not necessary if the current external MUF is exclusively used by ENF)

1. Create the exclusive MUF for ENF
   • Run the necessary steps found in the Datacom INSTJCL library
   • Customize and Submit member AXRIM01 to load Datacom PC routine
   • Customize and Submit member AXCUSNEW to ASSEMBLE/LINK CUSTOM modules to the CUSTOM libraries
   • Customize and Submit member AXNEW01 to allocate all the MUF instance datasets and the databases
   • Customize and Submit member AD15STRT to start the new MUF. Run with the default AXDATIN1 and AXDATIN2 values.
   • Customize and INSTJCL member AXIVP01 to execute the sample SQL driver program for the CA Datacom/AD  product.
   • Customize and Submit CA Common Services CAW0JCL member AW1ID001 to customize this new MUF for use by ENF
     
     
2. Change the ENF proc from ENFXMUF to ENFIMUF
   • EDIT the Common Services CAW0PROC ENFIMUF member to include both the necessary CCS libraries as well as the
     MUF (Datacom) libraries that define the exclusive ENF MUF. The Datacom libraries will point to the current MUF or the newly created MUF from Step1.  
     You will notice that ENFIMUF includes Datacom DD names that are not needed in the ENFXMUF proc but ARE necessary in order to use ENFIMUF
3. Complete the migration
   • Shut down the current ENF task which is using ENFXMUF.
   • Edit the ENF parms by adding the IMUF parm.
   • Edit the ENFIMUF proc to enable its use in place of the current ENFXMUF proc.
   • Start ENFIMUF.
   • Once ENFIMUF is running successfully, consider removing the ENF definitions from the original external MUF
     and clean up the old ENF database libraries from the Datacom start job.

Additional Information

Refer to the section Customize Datacom/AD for CAIENF in the Common Services r15.0 Documentation

Refer to Method 2 detailed in CA ENF MUF upgrade to Datacom/AD 15.1 from AD 14.0 or 15.0

Refer to the use of AWI1D001 in the creation process if a new MUF is necessary as listed in

When to use AW1IMPRT vs AW1ID001 when installing a new release of CAIENF for Event Recording