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

Products

• Datacom/AD
• Common Services
• COMMON SERVICES FOR Z/OS

Issue/Introduction

• Many customers use the CAIENF component of r15.0 Common Services for z/OS to record events on behalf of other mainframe products. 
• In order to record successfully, Common Services requires a unique plan name to be stored in the Database.
  • Plan name reflects Common Services release in use 
  • r15.0  
• The CAW0JCL for each release has two members that can be used write the correct plan name to the ENF MUF
  • AW1ID001
  • AW1IMPRT 

Which member should be used to write the plan to the ENF MUF?

Environment

Product: Common Services for z/OS r15.0 
Component:  CAIENF 

Cause

Customers can be unsure of which job to use.

Resolution

• Major factor to determine the job to use 
  • Create new database for new release of CCS/ENF
    • AW1ID001
  • Reuse current database with new release of  CCS/ENF
    • AW1IMPRT
• AW1ID001 
  • Create new ENF MUF
    • Run necessary Datacom jobs to create new MUF for ENF
    • Run AW1ID001
      • 4 functions of AW1ID001
        • Install ENF DBID (0700) into new MUF 
        • Define the ENF MUF DBID (0700) to Datacom/AD
        • Validate the ENF DB definitions and initialize
        • Import the new ENF plan into the new database
• AW1IMPRT
  • Prior to taking any action with the current MUF before upgrade to CCS r15.0
    • Reuse current ENF MUF
  • 1 function
    • Import new ENF plan into existing MUF
    • No impact upon current plan 
      • Just adds new plan
      • Current plan not overlaid  or deleted 
  • Job can be run before initializing newer release of CCS/ENF 
    • Older release active (r14.1) and using MUF  
    • No action necessary other than to run AW1IMPRT  
  • If new release of CCS (r15.0) installed and active
    • Add the new plan before attempting to start ENF
      • ENF will fail if new plan not present
    • ENF cannot be using the MUF
      • If MUF started externally using Datacom
        • Start MUF externally using ADxxStart
        • Run AW1IMPRT
        • Start ENF
      • If ENF using ENFPARM of IMUF
        • Start MUF externally using ADxxSTRT
        • Run AW1IMPRT
        • Stop the MUF using ADxxSTOP 
        • Start ENF with IMUF

Additional Information

Refer to the Common Services for z/OS documentation for details on the setup of ENF for use with Datacom/AD