Maintenance issue for BMC database products for IMS

BMC uses a single library to distribute the load modules for all of the BMC products for IMS. When you reinstall any database product for IMS, you automatically reinstall the other products at the same time.

A maintenance issue can arise if the following conditions are true:

• You are installing a new version, release, or maintenance level (v.r.mm) of one or more products from the most recent product image files.

• You have applied special maintenance (in the form of zaps and replacement load modules) for a product, and this product has the same v.r.mm for the most recent product image files as the v.r.mm that you already have installed.

Under these conditions, the zapped and replacement modules are back-leveled by the original, unmodified modules unless you take action to preserve the modified modules.

Actions to preserve modified modules

If you already have procedures in place to preserve your modified load modules, you do not need to take further action. If not, one method for preserving them is to use the DBUCOPY utility with the IEBCOPY utility.

DBUCOPY utility

The DBUCOPY utility produces a control statement data set that can be passed directly to the standard IEBCOPY utility.

SELECT control statements for the DBUCOPY utility let you provide masking values for the generic selection of modules. Generic selection of modules ensures that all relevant product modules are selected, even if new modules are added to the load library over time, and it reduces the effort of creating and maintaining JCL. BMC distributes the DBUCOPY utility in the load library of the installation media.

Sample DBUCOPY job

The following is a sample job for using the DBUCOPY utility:

// standard JOB statement
//*
//DELETE1  EXEC PGM=IEFBR14
//DD1      DD   DSN=TSOID.DBUCOPY.BRILIB,DISP=(MOD,DELETE,DELETE),
//             UNIT=SYSALLDA,SPACE=(TRK,(1,1))
//*
//DBUCOPY  EXEC PGM=DBUCOPY
//STEPLIB  DD   DISP=SHR,DSN=BMC.DBU.LOAD
//SYSPRINT DD   SYSOUT=*
//PDSIN    DD   DISP=SHR,DSN=BMC.DBU.LOAD
//COPYCRDS DD   DSN=&&COPYCC,UNIT=WORK,DISP=(,PASS),SPACE=(TRK,(1,1))
//BMCIN    DD   *
   COPY     INDD=((SYSUT1,R)),OUTDD=SYSUT2
   SELECT  MEMBER=(BRI*)
   SELECT  MEMBER=(CAP*)
   SELECT  MEMBER=(ICP*)
   SELECT  MEMBER=(IRM*)
   SELECT  MEMBER=(RVP*)
/*
//COPY2    EXEC PGM=IEBCOPY
//STEPLIB  DD   DISP=SHR,DSN=BMC.DBU.LOAD
//SYSPRINT DD   SYSOUT=*
//SYSUT1   DD   DISP=SHR,DSN=BMC.DBU.LOAD
//SYSUT2   DD   DSN=TSOID.DBUCOPY.BRILIB,DISP=(,CATLG,DELETE),
//           UNIT=SYSALLDA,SPACE=(TRK,(580,150,40),RLSE),
//           DCB=BMC.DBU.LOAD
//SYSIN    DD   DISP=(OLD,PASS),DSN=&&COPYCC

Sample job steps

This sample job performs the following steps:

• The DELETE1 step executes the IEFBR14 utility to delete the library that contains the existing product modules (if this library already exists).

• The DBUCOPY step executes the DBUCOPY utility to produce control statements for the IEBCOPY utility.

• The COPY2 step executes the IEBCOPY utility with the control statements that the DBUCOPY utility produces.

Sample utility actions

The DBUCOPY performs the following actions in this sample:

• It processes the PDSIN data set (the load library) to determine which members to select, based on the control statements in the BMCIN data set.

• It writes IEBCOPY control statements to the COPYCRDS data set.

• It handles the control statements in the BMCIN data set as follows:

  • It writes the COPY control statement, without modification, to the COPYCRDS output data set. This statement should refer to the DD names that you want the IEBCOPY utility to use for the input and output data sets in the COPY2 step.

  • For each SELECT statement, it selects members with names that match the value in parentheses. An asterisk matches any character (and any number of characters) in the position that it is coded. For example, the value BRI* selects all members with names that start with BRI. The sample includes the statements to select members for all Backup and Recovery products for IMS. You can delete or comment out SELECT statements that select members for products you do not use:

    • For BMC AMI Backup and Recovery for IMS , retain all statements.

    • For IMAGE COPY PLUS, retain the statement with the ICP* value.

    • For CHANGE ACCUMULATION PLUS, retain the statement with the CAP* value.

    • For RECOVERY PLUS for IMS, retain the statement with the RVP* value.

    • For RECOVERY MANAGER for IMS, retain the statement with the IRM* value.

Installation procedures

Typically, you would execute a job that is similar to the sample before starting the installation procedure. Then, after completing the installation procedure, you copy all modules from the IEBCOPY output data set to the new load library.