Customize CA Datacom/AD for CAIENF

After installing CA Datacom®/AD or deploying CA Datacom/AD on another LPAR image, you can optionally customize CA Datacom/AD for CAIENF.
ccsfzos15
After installing CA Datacom®/AD or deploying CA Datacom/AD on another LPAR image, you can optionally customize CA Datacom/AD for CAIENF.
If you want CAIENF to record events, you must have installed the version of CA Datacom/AD shipped with this version of CCS and must perform the steps in this procedure.
APF authorize two CA Datacom/AD load libraries, CAAXLOAD and CUSLIB after you complete the CA Datacom/AD installation. These load libraries are used to customize CA Datacom/AD for CAIENF.
Before you perform any CA Datacom/AD customization procedures for CAIENF, consider:
  • A CA Datacom/AD Multi-User Facility (MUF) must be running on the system where the JCL associated with the procedure executes.
  • A CA Datacom/AD MUF can execute in its own address space or under the CAIENF address space.
  • To customize CA Datacom/AD for CAIENF or resolve CA Datacom/AD for CAIENF customization issues, the CA Datacom/AD MUF must be running with its own address space and CAIENF must be down or started in a separate address space from the CA Datacom/AD MUF with the control option NODB.
  • Save your Datacom/AD MUF startup JCL even if you decide to use a CAIENF internal MUF (see ENFIMUF in the following topics). There are database maintenance occasions when you bring up the MUF while CAIENF is down.
Customize an Existing CA Datacom/AD for CAIENF
If you installed the release of CA Datacom/AD being shipped with this version of CCS from a prior version of CAIENF, then import the version of the CAIENF plan for this release into your existing CA Datacom/AD environment.
Do not perform these steps until you are ready to implement the version of CAIENF for this release.
Follow these steps:
  1. Shut down older version of CAIENF.
  2. If not started, start DATACOM/AD external to CAIENF.
  3. IMPORT the New CAIENF plan into DATACOM/AD by editing and submitting CAW0JCL member AW1IMPRT.
  4. IPL the system.
  5. Start the new release of CAIENF.
Customize a New CA Datacom/AD for CAIENF
Follow these steps:
  1. Modify and submit member, AW1ID001 to install the CAIENF database definitions into CA Datacom/AD and allocate the CAIENF database data sets.
    • Specify CA Datacom/AD data set prefix.
    • Specify CAIENF database data set volume.
    • Specify the unit type for the volume specified.
    • Specify space for the CAIENF database index, IXX700.
      Approximate 3390 CYL Index space
      A = ( 30 x #total recorded events) /3036 B = A + (A x .05) / 12 Cyls = (B / 15) + 1
    • Specify space for the CAIENF database data area, ENF700.
      Approximate 3390 CYL Area space
      Cyls = #total number of events / 3600 Approximate 3380 CYL Area space Cyls = #total number of events / 3000
  2. Update the CAIENF procedure.
    CAW0PROC contains three CAIENF procedures; ENF, ENFXMUF, and ENFIMUF. Select the procedure that applies to the requirements for your site.
    ENF:
    Use the JCL found in this procedure to not record events or install CA Datacom/AD.
    ENFXMUF:
    Use the JCL found in this procedure to record events. CA Datacom/AD is installed and the MUF is external (runs in its own address space) to CAIENF.
    ENFIMUF:
    Use the JCL found in this procedure to record events. CA Datacom/AD is installed and the MUF is internal (runs under the CAIENF address space) to CAIENF.
    For ENFXMUF and ENFIMUF:
    • Set the parameter values for ADSHLQ and ADHLQ to the CA Datacom/AD CAAXLOAD and CUSLIB data set name prefixes.
    • Update the CAIENF input parameters that DD ENFPARMS references to include control option statements RECORD(YES) and EVENT(
      event-name
      ,RECORD). There is an EVENT control option statement for each EVENT to be recorded.
      The Control Options that pertain to the recording of events are:
      RECORD(NO|YES) EVENT(
      event-name
      ,RECORD)| EVENT(
      event-name
      ,NOREC)
    • If the CA Datacom/AD MUF is to execute under the CAIENF address space, update the CAIENF input parameters that DD ENFPARMS references to include control option IMUF
  3. Start or restart CAIENF.
    CAIENF dynamically creates the EVENT tables to record events and CAIENF system tables to record miscellaneous supportive data.
    The EVENT tables are created when CAIENF initializes with RECORD(YES) specified.
    If RECORD(YES) is specified and the DATACOM/AD MUF is not available, CAIENF shuts down.