Sharing a CIS server with DB2 and IMS products


If you have installed a CIS server for a DB2 product (for example, SmartDBA Database Performance for DB2), and a CIS server for an IMS product (for example, BMA AMI Database Advisor for IMS), you can merge the two CIS servers into a single CIS server and a single started task procedure.

The single CIS server will then work with both products.

To merge multiple products into one CIS server

  1. Locate the #CIS member that the Installation System created in the CIS sample library.
  2. Copy the #CIS member to your system procedure library and give the new member the name that you selected for the startup member during installation.
  3. Ensure that the new CIS load library (hlq.XLINK) is first in the STEPLIB concatenation.
  4. Add the older versions of the following files in concatenation order after the newer versions:

    • Application load library
    • Configuration file (see the following figure for an example)
    • Content file (see the next figure for an example)
    Warning

    Note

    The content files and the configuration files must be ordered from the newest products and files to the oldest products and files.

    HTPPARM  DD  DISP=SHR,DSN=HLQ.XXCNFG <--new CIS configuration library
             DD  DISP=SHR,DSN=hlq.IMCNFG <--from merged IMS install
             DD  DISP=SHR,DSN=hlq.productCodeCNFG <--from nonmerged IMS install
                                                  (1 library for each IMS product
                                                  that has a CONFIG library)
             DD  DISP=SHR,DSN=hlq.CONFIG <---from new DFD install
             DD  DISP=SHR,DSN=hlq.CONFIG <---from existing SPD install
    Warning

    Note

    Use only the files that you currently have in the concatenation.

    The following figure shows an example of a consolidated started task procedure for the CIS server. The product application load library, content file, and configuration file are the newer versions.

     //CISOZ487 PROC CISENV=CISTCENV, <Member of CNFLIB with STDENV script
    //   CMNENV=CISCMNEV,           <Common Env member
    //   JZOSLIB='SYS1.SIEALNKE',   <JZOS launcher PDSE LIB
    //   REGSIZE='0M'               <Max region
    //*
    //*
    // EXPORT SYMLIST=*
    //*
    //   SET  CISHLQ1='MVSDPT.DTOZI487.RTE'
    //   SET  CISHLQ2='MVSDPT.DTOZI487.RTE'
    //   SET  JAVAHOME='/shrd/java17/J17.0_64'
    //   SET  CISHOME='/home/mvsdpt/DTOZI487/bmc/rte'
    //   SET  CNFGLIB1=&CISHLQ1..UBMCSAMP
    //   SET  CNFGLIB2=&CISHLQ2..BMCSAMP
    //   SET  CONTPDS1=MVSDPT.DTOZI487.RTE.BMCCONT
    //   SET  CONTPDS=MVSDPT.DTOZI487.RTE.BMCCONT
    //   SET  ROOT='/home/mvsdpt/DTOZI487/bmc/rte'
    //   SET  PCODE='icm'
    //   SET  CONTMBR=IMSUIJAR
    //REFRGUI EXEC PGM=BPXBATCH,REGION=0M
    //STDOUT   DD SYSOUT=*
    //STDERR   DD SYSOUT=*
    //STDPARM  DD *,SYMBOLS=JCLONLY
    sh cd &ROOT/static;
    md5 "//'&CONTPDS.(&CONTMBR)'" > &PCODE..md5.new;
    cmp &PCODE..md5.new &PCODE..md5;
    status=$?;
    if [ $status -ne 0 ];
    then;
      echo "Refreshing static content &CONTPDS.(&CONTMBR)";
      tso -t "oput '&CONTPDS.(&CONTMBR)' '&PCODE..jar' BINARY";
      jar -xvf &PCODE..jar;
      rm &PCODE..jar;
      rm &PCODE..md5;
      mv &PCODE..md5.new &PCODE..md5;
    else;
      echo "Static content unchanged.";
      rm &PCODE..md5.new;
    fi;
    /*
    //CISSRVR EXEC PGM=CALJVM64,REGION=&REGSIZE,TIME=1440
    //MAINARGS DD *,SYMBOLS=JCLONLY
    'org.springframework.boot.loader.launch.JarLauncher'
    //STEPLIB  DD DISP=SHR,
    //            DSN=&JZOSLIB
    //         DD DISP=SHR,
    //            DSN=CEE.SCEERUN
    //         DD DISP=SHR,
    //            DSN=MVSDPT.DTOZI487.RTE.UBMCLIB
    //         DD DSN=MVSDPT.DTOZI487.RTE.BMCLINK,
    //            DISP=SHR
    //         DD DSN=MVSDPT.DTOZI487.RTE.BMCLIB,
    //            DISP=SHR
    //RRLOG    DD SYSOUT=*
    //SYSOUT   DD SYSOUT=*
    //STDOUT   DD SYSOUT=*
    //STDERR   DD SYSOUT=*
    //HTPPARM  DD DISP=SHR,DSN=MVSDPT.DTOZI487.RTE.UBMCCNFG
    //         DD DSN=MVSDPT.DTOZI487.RTE.BMCCNFG,
    //            DISP=SHR
    //STDENV   DD *,SYMBOLS=JCLONLY               < STDENV shell script
    CIS_INSTALL_PATH=&CISHOME
    JAVA_HOME=&JAVAHOME
    //         DD DISP=SHR,
    //            DSN=&CNFGLIB1(&CMNENV)
    //         DD DISP=SHR,
    //            DSN=&CNFGLIB2(&CISENV)
    //         DD DISP=SHR,
    //            DSN=&CNFGLIB1
    //         DD DISP=SHR,
    //            DSN=&CNFGLIB2
  5. Restart the CIS server address space.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Database Advisor for IMS 3.2