Updates to IMS Database Solution Pack: Overview and Customization V1.2

Product documentation


Abstract

Updates that apply to IMS Database Solution Pack: Overview and Customization V1.2 (SC19-3284-00)

Content

The most recent update is listed first.



Update 3
Date of change: September 2012
Change description: Documentation changes by APAR PM64743. This APAR is for IMS Library Integrity Utilities. This APAR changes the behavior of the Integrity Checker utility not to issue messages when a global option module is not found in the STEPLIB concatenation.
Topics: Changes apply to the following multiple topics.

>> 3.11 Activating Integrity Checker

The description for activating Integrity Checker has been updated as follows:

...

Before you begin

...
If you have deactivated Integrity Checker by following the instructions in "3.12.1 Deactivating LIU that is installed as a component of IMS Tools solution pack", the DSPCRTR0 alias name must be restored before activating Integrity Checker. Complete the steps in "3.13 Reactivating Integrity Checker after deactivation" before proceeding with these steps.

Procedure
  1. Create global option modules.
  2. Estimate the size of the LICON data set.
  3. Define and initialize the LICON data set.
  4. Register DMB information.
  5. Add DD statements to JCL and procedures of DBRC, IMS batch application, IMS utility, and IMS Tools.
  6. Configure the members of the IMS PROCLIB data set (required if BPE-based DBRC is used).
  7. Set up security for the LICON data set (optional step).
  8. Serialize the LICON data set (optional step).
  9. Restart IMS online and run IMS batch application, IMS utility, and IMS Tools jobs.

---------------------------------------
>>> 3.11.5 Adding DD statements to DBRC and DLIBATCH procedures

The title of this topic has been changed as follows:

Adding DD statements to JCL and procedures of DBRC, IMS batch application, IMS utility, and IMS Tools

The content of this topic has been changed as follows:

You must add DD statements to JCL and cataloged procedures for all the jobs in which you want to activate Integrity Checker. These JCL and procedures include those for DBRC, IMS batch application, IMS utility, and IMS Tools jobs that update IMS databases.

Procedure
Add the DD statements to the following cataloged procedures:
  • Online DBRC procedure for a non-BPE-based DBRC region or for a BPE-based DBRC region
  • Any cataloged procedure used for DL/I batch jobs including utility jobs

Important: To keep the integrity, ensure that all JCL and procedures that have the possibility of changing databases meet the following STEPLIB DD requirements.

Add the following DD statements:

STEPLIB DD
    First, you must add the load module data sets that contain the global option module and the LIU load module library to the STEPLIB concatenation.

    The LIU load module library must be concatenated before the IMS load module library. The load module library must be APF-authorized.

    Next, if you want Integrity Checker to detect changes in the logic of IMS user exits, which are randomizing routines, the segment edit/compression exit routines, and the HALDB partition selection exit routines, you must include the exit load modules in the STEPLIB concatenation. Integrity Checker does not check the user exit load modules in the LPA, ELPA, or LNKLST.

...
---------------------------------------
>>> 3.11.6 Configure the members of the IMS PROCLIB data set

The title of this topic has been changed as follows:

Configure the members of the IMS PROCLIB data set (required if BPE-based DBRC is used)

---------------------------------------
>>> 3.11.9 Restarting IMS online or running the batch job

The title of this topic has been changed as follows:

Restart IMS online and run IMS batch application, IMS utility, and IMS Tools jobs

The content of this topic has been changed as follows:

When you have done all the steps, you are ready to restart IMS online and to activate the DMB verification process.

Procedure
  1. Restart IMS online, and run IMS batch application jobs, IMS utility jobs, and IMS Tools jobs.
  2. Confirm that the DMB verification process is activated by locating the following WTO message:
    FABL0114I LIU INTEGRITY CHECKER ACTIVATED. IMS VERSION IS version


---------------------------------------
The following new topics have been added after "3.11 Activating Integrity Checker":

(Topic 3.12) Deactivating Integrity Checker

You can deactivate Integrity Checker if you do not want to use the DMB verification function.

About this task
The DMB verification process is activated by the existence of a global option module. Before the DMB verification process is activated, if a program runs with DBRC active (DBRC=Y), a module of Integrity Checker runs in the background to determine whether a global option module exists. To turn off Integrity Checker completely, complete the following procedure.

    (Topic 3.12.1) Deactivating LIU that is installed as a component of IMS Tools solution pack

    If IMS Library Integrity Utilities is installed as a component of IMS Database Solution Pack, all the product load modules are contained in the same data set. In such an environment, complete the following procedure to deactivate Integrity Checker.

    Before you begin
    If the LIU load module data set has been merged to the IMS RESLIB (SDFSRESL) data set, the following procedure cannot be applied. You must restore or reinstall the IMS RESLIB.

    Procedure
    1. Delete the alias name DSPCRTR0, which is defined to the LIU FABLRTR0 load module. You can delete the alias name by completing the following steps:
      1. Delete the DSPCRTR0 alias name from the load module data set by running the IEHPROGM program.
      2. Delete the DSPCRTR0 alias name from SMP by using the JCLIN and UCLIN commands.
      You can use the JCL example provided in Figure x1 to run these two steps. The JCL example consists of three job steps. The first job step deletes the alias from the load module data set. The second and the third job steps delete the alias from the SMP definition.

      When the job ends, confirm that the return codes from the three job steps are zero.

      Tip: If you do not want to change your SMP definition, you can omit the second and the third job steps. However, if you omit these job steps, alias DSPCRTR0 is recreated whenever you apply an IMS Library Integrity Utilities PTF in the future. Therefore, every time you apply an IMS Library Integrity Utilities PTF, you must run the first job step to delete the alias.

    2. If you have done the steps in "3.11 Activating Integrity Checker", complete these additional steps:
      1. Remove the global option module from the STEPLIB concatenation in DBRC JCL, IMS batch application JCL, IMS utility JCL, and IMS Tools JCL. 
      2. If you use BPE-based DBRC, remove the FABLBIN0 parameter from the EXITS= statement.


    Figure x1. Removing the alias name DSPCRTR0


(Topic 3.13) Reactivating Integrity Checker after deactivation

If you removed the alias name DSPCRTR0 while deactivating Integrity Checker, but if you want to use Integrity Checker again, you must restore the DSPCRTR0 alias before reactivating Integrity Checker.

About this task
This task is required only if you removed the alias name DSPCRTR0 by completing the steps in "3.12.1 Deactivating LIU that is installed as a component of IMS Tools solution pack" and if you want to reactivate Integrity Checker.

Procedure
Restore the alias name DSPCRTR0. You can restore the alias name by completing the following steps:
  1. Add the DSPCRTR0 alias name by link-editing the FABLRTR0 load module.
  2. Add the DSPCRTR0 alias name to SMP by using the JCLIN and UCLIN commands.

You can use the JCL example provided in Figure x2 to run these two steps. When the job ends, confirm that the return codes from the three job steps are zero.

After restoring the DSPCRTR0 alias name, follow the instructions in "3.11 Activating Integrity Checker" to activate the DMB verification process.

Figure x2. Restoring the alias DSPCRTR0



Update 2
Date of change: February 2012
Change description: Documentation changes by APAR PM56609. This APAR updates the sample JCL (provided by APAR PM53934) for registering IMS DB Solution Pack products and reports to the IMS Tools Base repository.
Topic:
> 3.0 Customizing IMS Database Solution Pack
>> 3.6 Configuring Tools Base
>>> 3.6.3 Configuring IMS Tools Knowledge Base

...

Procedure

For instructions for configuring IMS Tools Knowledge Base, see the topic "IMS Tools KB administrator reference" in the Tools Base IMS Tools Knowledge Base User's Guide.

To register the IMS Tools products and reports, run the HKTAPRA0 program of Tools Base. In the SYSIN DD of HKTAPRA0, you must add the ADDPROD statements to specify the products to be registered. For example, the following statement can be used to register the Database Sensor component and its reports:
ADDPROD TABLE=BBESITKB,REPLACE=YES

For instructions for running the HKTAPRA0 program, see "Registering products and reports" in the IMS Tools Base IMS Tools Knowledge Base User's Guide.

IMS Database Solution Pack provides a sample JCL (HPSAITKB JCL in the SHPSSAMP data set) that you can use to register the IMS Database Solution Pack products and reports to IMS Tools Knowledge Base. This JCL contains ADDPROD statements for the products that can participate in the IMS Tools Knowledge Base environment. Use this JCL when you register the products and reports while configuring IMS Tools Knowledge Base. You can use this JCL even if any of the products are already defined because the REPLACE option is specified.

The following figure shows the HPSAITKB JCL.


//HPSAITKB  JOB  <JOB CARD PARAMETERS>                        
//*-----------------------------------------------------------*
//* JOB NAME = HPSAITKB                                       *
//*-----------------------------------------------------------*
//*                                                           *
//*  LICENSED MATERIALS - PROPERTY OF IBM                     *
//*                                                           *
//*  5655-S77                                                 *
//*                                                           *
//*  Copyright IBM Corp. 2011 All Rights Reserved.            *
//*                                                           *
//*  US Government Users Restricted Rights - Use,             *
//*  duplication or disclosure restricted by GSA ADP          *
//*  Schedule Contract with IBM Corp.                         *
//*                                                           *
//*-----------------------------------------------------------*
//*                                                           *
//* Description: This JCL is used to register the products    *
//*              and reports of IMS Database Solution Pack    *
//*              to IMS Tools Knowledge Base(IMS Tools KB).   *
//*              This registration job need to be submitted   *
//*              to store the reports in the IMS Tools KB     *
//*              Output repository.                           *
//*                                                           *
//* Caution:     This is not a JCL procedure or               *
//*              a complete job.                              *
//*              You have to make modifications before        *
//*              submitting this job.                         *
//*                                                           *
//*  A) Make the following global changes for this job:       *
//*                                                           *
//*   1. Change the JOB card to meet your system's            *
//*      requirements.                                        *
//*                                                           *
//*   2. Change '$dbshlq' to a valid high-level qualifier of  *
//*      the IMS DB Solution Pack load module library.        *
//*         'CHANGE $dbshlq. your_dbs_hlq. all'               *
//*                                                           *
//*   3. Change '$itbhlq' to a valid high-level qualifier     *
//*      of the IBM Tools Base SHKTLOAD load module           *
//*      library.                                             *
//*         'CHANGE $itbhlq. your_itb_hlq. all'               *
//*                                                           *
//*   4. Change '$itkbsvr' to the server name, which is       *
//*      the XCF group name of your IMS Tools Knowledge       *
//*      Base server.                                         *
//*         'CHANGE $itkbsvr your_itkbsvr all'                *
//*                                                           *
//*   5. Delete the ADDPROD statements for the products which *
//*      you do not need to register.                         *
//*                                                           *
//*  B) Submit the job.                                       *
//*                                                           *
//*  C) Confirm that the job step return code is zero.        *
//*                                                           *
//*-----------------------------------------------------------*
//*-----------------------------------------------------------*
//*   REGISTRATION OF PRODUCTS/REPORTS TO IMS TOOLS KB        *
//*-----------------------------------------------------------*
//*                                                           *
//*   The following component, products, and their reports    *
//*   will be added to the IMS Tools Knowledge Base server    *
//*   that is identified by the EXEC parameter ITKBSRVR=.     *
//*   Delete the ADDPROD statements for the IMS Database      *
//*   Solution Pack V1R2 products that you did not install.   *
//*                                                           *
//*  TABLE=BBESITKB Database Sensor                           *
//*  TABLE=HPSGITKB Database Reorganization Expert            *
//*  TABLE=FABYTITK HP Prefix Resolution                      *
//*  TABLE=IIUTITKB Index Builder                             *
//*  TABLE=FABPITKB HP Pointer Checker                        *
//*  PRODUCTID=DU  HP Unload                                  *
//*  PRODUCTID=DL  HP Load                                    *
//*  PRODUCTID=DI  HP Image Copy                              *
//*                                                           *
//*-----------------------------------------------------------*
//ADDPROD  EXEC PGM=HKTAPRA0,PARM='ITKBSRVR=$itkbsvr'          
//STEPLIB  DD DISP=SHR,DSN=$dbshlq.SHPSLMD0   DB Solution Pack
//         DD DISP=SHR,DSN=$dbshlq.SIIULMOD   Index Builder    
//         DD DISP=SHR,DSN=$itbhlq.SHKTLOAD                    
//SYSPRINT DD SYSOUT=*                                          
//OUTRPT   DD SYSOUT=*                                          
//SYSIN    DD *                                                
  ADDPROD  TABLE=BBESITKB,REPLACE=YES                          
  ADDPROD  TABLE=HPSGITKB,REPLACE=YES                          
  ADDPROD  TABLE=FABYTITK,REPLACE=YES                          
  ADDPROD  TABLE=IIUTITKB,REPLACE=YES                          
  ADDPROD  TABLE=FABPITKB,REPLACE=YES                          
  ADDPROD  PRODUCTID=DU,RELEASE=010200,REPLACE=YES              
  ADDPROD  PRODUCTID=DL,RELEASE=020100,REPLACE=YES              
  ADDPROD  PRODUCTID=DI,RELEASE=040200,REPLACE=YES              
  LIST PRODUCTID=*,REPORTID=*                                  
/*                                                              





Update 1
Date of change: January 2012
Change description: Documentation changes by APAR PM53934. This APAR provides a sample JCL for registering IMS DB Solution Pack products and reports to IMS Tools Base repository.
Topic:
> 3.0 Customizing IMS Database Solution Pack
>> 3.6 Configuring Tools Base
>>> 3.6.3 Configuring IMS Tools Knowledge Base

The documentation changes by APAR PM53934 have been further modified by APAR PM56609. Please refer to the Update 2 section of this techdoc to view the documentation changes.

Publication number

SC19-3284-00

Copyright date

2000, 2011

Original publication date

2012/1/5

Rate this page:

(0 users)Average rating

Document information


More support for:

IMS Tools
IMS Database Solution Pack: Overview and Customization

Software version:

1.2.0

Operating system(s):

z/OS

Reference #:

7023863

Modified date:

2012-01-05

Translate my page

Machine Translation

Content navigation