Subzero installation verification program for IMS
BMC Subsystem Optimizer for zEnterprise (Subzero) provides an Installation Verification Program (IVP) that you can use to ensure the product is installed and set up correctly in your IBM IMS Transaction Manager (TM) Resource Adapter (IMS TM) environment. The IVP transaction, named BRD4, runs as an online IMS transaction that accesses and updates your IBM DB2 database.
With the IVP, you can verify that the transaction can access both a locally connected and remotely connected (via Subzero) DB2 database without changing the program or the IMS transaction definitions. For example, you can run the IMS IVP transaction while locally connected to a DB2 subsystem and then again after enabling Subzero to connect to a remote DB2 subsystem.
Supported databases
The Subzero installation verification program (IVP) works with the DB2 IVP that IBM supplies in job DSNTEJ1 in the DSNSAMP library. The Subzero IVP updates the dsn8vvr.DEPT and dsn8vvr.EMP tables.
Sample library members
The following members of the sample library contain programs and JCL for assembling and defining the installation verification program.
Member | Contents |
|---|---|
BRDIV$D | Documentation on how to use the IVP |
BRDIVAL4 | JCL to pre-process, assemble and link the IVP |
BRDIVBN4 | JCL to run the DB2 BIND command |
BRDIVP4G | Sample IMS Gen card for the BRD4 transaction |
BRDIVP4P | Sample IMS Program Specification Block (PSB) for the BRD4 Transaction |
BRDIVP4 | Assembler program that issues the DB2 database SQL requests |
As indicated in the sample library members, you will need to modify the JCL to accommodate your environmental requirements:
- Job card
- BMC Subsystem Optimizer for zEnterprise high-level qualifiers (HLQs) and data set names
- DB2 version number, HLQ and subsystem ID (SSID)
Prepare your IMS system for the IVP
- Add the IVP transaction and application to your IMS system. Using the sample provided in BRDIVP4G, you will need to modify your IMS system definition parameters.
- Perform an IMS MODBLKS gen.
- Using BRDIVP4P, perform a PSB gen.
- Perform an ACB gen.
- Copy both MODBLKS and ACB libraries to the inactive libraries defined to your IMS system.
- Perform an IMS Online Change for both MODBLKS and ACBLIB.
Prepare the IVP
- Edit and run the JCL in BRDIVAL4. This will assemble and link the IVP program.
- On every DB2 system that the Subzero IVP will run, edit and run the JCL in member BRDIVBN4.