IBM Support

Updates to IMS Library Integrity Utilities V2.2 User's Guide

Product Documentation


Abstract

Updates that apply to IMS Library Integrity Utilities V2.2 User's Guide (SC19-3979-04).

Content

The most recent updates appear at the top of the list. 

Update 5

Date of change: July 2019

Change description: Documentation changes by APAR PH09134. This APAR enhances the Catalog Manager utility. The function to validate IMS control blocks in the IMS catalog and the IMS directory has been enhanced to support the IMS directory staging data set (APAR PH09134). By this enhancement, the algorithm for validating the time stamps of ACBs in the ACB libraries and in the IMS directory and instances in the IMS catalog database has changed. Also, the format of the IMS Catalog Validation report has been changed.

Topics: Changes apply to multiple topics.

---------- 

Topic: IMS Library Integrity Utilities overview > What does IMS Library Integrity Utilities do? 

This topic has been updated as follows:

Catalog Manager utility

The Catalog Manager utility provides the capabilities to ensure that the IMS catalog and the IMS directory are maintained correctly and to analyze DBDs and PSBs in the IMS directory.

  • Time stamp validation — checks DBDs and PSBs in the IMS catalog to ensure that they are maintained correctly. It checks the time stamps of DBDs and PSBs in the IMS catalog, the IMS directory, and ACB libraries to ensure that they are consistent.
  • ...

---------- 

Topic: IMS Library Integrity Utilities overview > Functional enhancements in IMS Library Integrity Utilities Version 2 > Functional enhancements in Version 2 Release 2

A new item has been added to the Catalog Manager utility section:

Catalog Manager utility

  • APAR PH09134 enhances the validate function to support ACBs in the IMS directory staging data set. The validate function can check the time stamps of ACBs in the IMS directory staging data set to ensure the consistency of the ACBs in the IMS directory staging data set.
  • ...

---------- 


The following topics have been updated.

Catalog Manager utility
 Catalog Manager utility overview
 Catalog Manager utility restrictions
 JCL requirements for the Catalog Manager utility
 Control statements for the Catalog Manager utility
 Example: Validating DBDs and PSBs
 Output from the validate function
 Output from the compare function
 Output from the convert function

The following PDF contains the updated contents:

PDF icon

Note: Page, figure, table, and cross-reference numbers in this PDF extract might not match your current user guide version. Use this documentation extract for content update purposes only. Change bar markings on the left side of the page indicate the new or changed information. This information will be included in any future refreshes of the entire user guide.


Update 4

Date of change: June 2019

Change description: Documentation changes by APAR PH12126. New messages for the Catalog Manager utility have been added.

Topic: Troubleshooting > IMS Library Integrity Utilities messages > FABN messages

The following new messages have been added:

FABN0088I VERSION PARAMETER OF DBD STATEMENT IS DECODED FROM THE ACTIVE ACB DATA SETS OF THE IMS DIRECTORY. [EXIT PARAMETERS OF DBD AND SEGM STATEMENTS ARE DECODED FROM THE ACTIVE ACB DATA SETS OF THE IMS DIRECTORY.]

Explanation: The following parameters were decoded from an active ACB in the IMS directory:

  • The VERSION parameter of the DBD statement
  • The EXIT parameter of the DBD and SEGM statements

This happens when the utility tries to decode DBDs in the IMS directory staging data set and the PSB that refers to the DBD does not exist in the IMS directory staging data set.

When the utility decodes a DBD and it detects missing parameters, it looks for the PSB that refers to the DBD to supplement the missing parameters. Because a staging data set does not store all the PSBs – it stores modified PSBs only – if the utility cannot find the relevant PSB in the staging data set, it looks for the PSB in the active ACB data sets of the IMS directory and uses the information in the active ACB to supplement the missing parameters.

Note: VERSION and EXIT parameters are supplemented only if the organization of the database is DEDB or MSDB.

System action: The Catalog Manager utility continues processing.

User response: None. This message is informational.

FABN0089I SENSEG STATEMENT IS DECODED FROM THE ACTIVE ACB DATA SETS OF THE  IMS DIRECTORY.

Explanation: The SENSEG statement is decoded from an active ACB in the IMS directory. This happens when the utility tries to decode DBDs in the IMS directory staging data set and the PSB that refers to the DBD does not exist in the IMS directory staging data set.

When the utility decodes a PSB and it detects a missing SENSEG statement, it looks for the DBD that the PSB refers to to supplement the missing statement. Because a staging data set does not store all the DBDs – it stores modified DBDs only – if the utility cannot find the relevant DBD in the staging data set, it looks for the DBD in the active ACB data sets of the IMS directory and uses the information in the active ACB to supplement the missing SENSEG statement.

Note: The SENSEG statement is supplemented only when the PSB has a DB PCB for an MSDB.

System action: The Catalog Manager utility continues processing.

User response: None. This message is informational.

---------- 

Topic: Troubleshooting > IMS Library Integrity Utilities messages > FABX messages

The following new message has been added:

FABX0013I THE DECODED SOURCE CONTAINS STATEMENTS THAT WERE SUPPLEMENTED FROM THE ACTIVE ACB DATA SETS OF THE IMS DIRECTORY.

Explanation: The following parameters and statements were decoded from active ACBs in the IMS directory:

  • The VERSION parameter of the DBD statement
  • The EXIT parameter of the DBD and SEGM statements
  • The SENSEG statement

This happens when the utility tries to decode a DBD or PSB in the IMS directory staging data set and the PSB that refers to the DBD or the DBD that the PSB refers to does not exist in the IMS directory staging data set.

When the utility decodes a DBD or PSB and it detects missing parameters, it looks for the PSB that refers to the DBD or the DBD that the PSB refers to to supplement the missing parameters. Because a staging data set does not store all the DBDs and PSBs – it stores modified DBDs and PSBs only – if the utility cannot find the relevant DBD or PSB in the staging data set, it looks for the DBD or PSB in the active ACB data sets of the IMS directory and uses the information in the active ACB to supplement the missing parameters.

System action: The Catalog Manager utility continues processing.

User response: None. This message is informational.



Update 3

Date of change: April 2019

Change description: Documentation change by APAR PH08167.

Topic: DBD/PSB/ACB Compare utility > Output from the DBD/PSB/ACB Compare utility > SYSPRINT data set > Block-level compare reports

Table "Sections in DBD Compare reports" has been updated as follows:

Table. Sections in DBD Compare reports

(Table 16 in PDF)

 Section  Description
 DIR  ...
 ...  ...

 DXVECT

 ...

 DXSRET

 DXFMCT

 DXFDTT

 ...

 Metadata information for DBD
 ...


Update 2

Date of change: April 2019

Change description: Documentation change by APAR PH06728.

Topic: Troubleshooting > IMS Library Integrity Utilities messages > FABX messages

The following new message has been added:

FABX0528E THE PARAMETER FOR keyword MUST CONSIST ONLY OF ALPHANUMERIC CHARACTERS, $, #, @, %, AND *.

Explanation: The parameter specified for the indicated keyword contains one or more unsupported characters.

System action: The Catalog Manager utility ends with a return code of 8.

User response: Correct the parameter and rerun the job.

----------

Message FABX0537E has been modified as follows:

FABX0537E IMS CATALOG IS NOT DEFINED TO THE IMS.

FABX0537E THE IMS MANAGEMENT OF ACBS IS NOT ENABLED. IMS DIRECTORY IS NOT DEFINED TO THE IMS.

FABX0537E  [ACBLIB | DBDLIB] IS NOT DEFINED TO THE IMS.

Explanation: The requested function requires the IMS catalog, IMS directory, DBD library, or ACB library. However, none of these were found in the specified IMS subsystem.

System action: IMS Library Integrity Utilities ends with a return code of 12.

User response: Select the correct IMS ID.


Update 1

Date of change: November 2018

Change description: Documentation changes by APAR PH04670. This APAR enhances the Catalog Manager utility to support BMP regions.

Topic: Catalog Manager utility > JCL requirements for the Catalog Manager utility

This topic has been updated as follows:

DD statements

STEPLIB DD or JOBLIB DD

Required input data set. Specify the LIU load module library data set, which contains the Catalog Manager utility, and the IMS.SDFSRESL data set. Specify the SGLXLOAD library of IMS Tools Base V1.6 or later when you use the compare function or the convert function.

Optionally, specify the following resources:

  • If you use the Catalog Definition exit routine (DFS3CDX0), specify the load module data set that contains the exit routine.
  • If you want the RECON data sets, IMS bootstrap data set, or the DFSHDBSC data set to be dynamically allocated, specify the MDA library.
  • If you use the SCI exit routine for your IMS environment, specify the load module data set that contains the exit routine.

DFSRESLB DD

Optional input data set. If you specify the DLI keyword in the FABXPPRM data set, you must specify this DD statement. Specify the IMS.SDFSRESL data set.

IMS DD

Optional input data set. If you specify the DLI keyword in the FABXPPRM data set, you must specify this DD statement. Specify the PSB and DBD libraries that contain the DBDs and PSBs for the IMS catalog.

DFSVSAMP DD

Optional input data set. If you specify the DLI keyword in the FABXPPRM data set, you must specify this DD statement. Specify the buffer pool parameters data set.

FABXPPRM DD

Optional input statement. If you do not use the Catalog Definition exit routine (DFS3CDX0), you must specify this DD statement. Specify the parameters for the IMS region controller DFSRRC00.

Catalog Manager runs as a z/OS batch job, and it invokes DFSRRC00 to issue DL/I calls to the IMS catalog database. The parameters in FABXPPRM DD are given to DFSRRC00.

The format of the parameters is the same as the DFS3PPRM DD statement for the ACB Generation and Catalog Populate utility (DFS3UACB). You can reuse the parameters that you specify in the DFS3PPRM data set.

Related reading: For more information, see the topic "ACB Generation and Catalog Populate utility (DFS3UACB)" in IMS System Utilities.

  • DL/I

The parameters must include the name of the DFSDFxxx PROCLIB member that contains the processing options for the IMS catalog. Here is an example of the parameters:

image-20181128094055-1

You can specify any value for the first, second, and third positional parameters because the Catalog Manager utility supplies appropriate values for these parameters.

The format of the parameter is the same as the DFS3PPRM DD statement for the ACB Generation and Catalog Populate utility (DFS3UACB). You can reuse the parameters that you specify in the DFS3PPRM data set.

Related reading: For more information, see the topic "ACB Generation and Catalog Populate utility (DFS3UACB)" in IMS System Utilities.

If you specify DLI and the IMS catalog is shared, you must specify IRLM support in the parameters. In the following example, the second Y and irlmid value indicate IRLM support:

image-20181128094118-2


You can specify the IMSPlex name and the group of DBRC instances that access the RECON data set to the FABXPPRM DD statement. Here is an example of the parameters:

image-20181128094131-3

If you specify the IMSPlex name and the group of DBRC instances on both the EXEC statement and the FABXPPRM DD statement, the parameters on the FABXPPRM DD statement are used.

If the Catalog Definition exit routine (DFS3CDX0) is used, you can omit the FABXPPRM DD statement. If DFS3CDX0 is not used and you omit the FABXPPRM DD statement, the Catalog Manager utility uses the following statement as the default:

image-20181128094147-4

  • BMP

If the IMS control region is active on the same LPAR as the Catalog Manager utility job, you can specify the BMP keyword. Here is an example of the parameters:

image-20181128094157-5                           

When you specify the BMP keyword in the FABXPPRM data set, the Catalog Manager utility behaves as follows:

  • Displays asterisks (***) for some fields (such as IMS ID, ALIAS) in the IMS Catalog Environment report.
  • If the IMS control region is inactive, issues message DFS690A.

For both DL/I and BMP, you can specify any value for the second and third positional parameters because the Catalog Manager utility uses the following values for these parameters.

  • The name of an internal LIU program for the second parameter.
  • DFSCP000 for the third parameter.

Publication Number

SC19-3979-04

Copyright Date

2018


Cross reference information
Product Component Platform Version Edition
IMS Tools IMS Database Solution Pack z/OS 2.2.0, 2.1.0
IMS Tools IMS Fast Path Solution Pack z/OS 1.3.0
IMS Tools IMS Database Utility Solution z/OS 2.1.0

Document information

More support for: IMS Tools

Component: IMS Library Integrity Utilities

Software version: 2.2.0

Operating system(s): z/OS

Reference #: 0742605

Modified date: 30 June 2019