IBM Support

Updates to IMS High Performance Prefix Resolution for zOS V3.1

Product Documentation


Abstract

Updates to IMS High Performance Prefix Resolution for z/OS V3.1 User’s Guide (SC18-9230-05)

Content

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

Update 1

Date of change: June 2018

Change description: Documentation changes by APAR PI98020. This APAR enhances IMS HP Prefix Resolution to support IMS managed ACBs for the concurrent prefix update function and the stand-alone prefix update function.

Topics: Changes apply to multiple topics.

Topics:

The following two tables have been updated as follows:

Tables:

  • DD statements for Concurrent Prefix Update
  • DD statements for Stand-Alone Prefix Update

DDNAME

Use

Format

Need

Description

JOBLIB/STEPLIB

Input

 

Required

Points to the IMS.SDFSRESL, which contains the IMS nucleus and required action modules, and to the IMS HP Prefix Resolution load library, which contains the FABYMAIN main load module.

One of these DD statements is required.

When you specify HPPRBH=NO:

  • IMS.SDFSRESL must be concatenated behind the DD statement that contains the IMS HP Prefix Resolution load library.
  • If JOBLIB or STEPLIB is not authorized by having unauthorized libraries that are concatenated to IMS.SDFSRESL, the DFSRESLB DD statement must be included.

 

image-20180627145213-1To run a Prefix Update job in an IMS-managed ACBs environment, the name of the SGLXLOAD library of Tools Base must also be specified on the STEPLIB DD statement. image-20180627145213-2

...

DFSVSAMP

Input

LRECL=80

Optional

image-20180627145213-3DFSACBPD

Input

LRECL=80

Optional

Defines the control statement data set to be used in an IMS-managed ACBs environment. This DD statement is optional. STAGING is the only valid keyword.

 

When the IMS management of ACBs is enabled, IMS retrieves DBDs from the IMS catalog. If you unload a database and make offline changes to the database definition, you can reload either the active changes from the IMS catalog directory data sets or the pending changes from the catalog staging data sets. By default, IMS HP Prefix Resolution obtains active database definitions from the IMS catalog directory. To override the default behavior and obtain pending ACBs from the staging data sets in the IMS catalog, specify the keyword STAGING on the DFSACBPD DD statement.

 

When the IMS management of ACBs is not enabled, the DFSACBPD DD statement is ignored. image-20180627145213-4

FABYIN

...

IMS

Input

 

image-20180627145213-5Optional

Defines the library that contains the DBDs that describe the database that was loaded, reorganized, or both. The data set must reside on a direct-access device.

 

If the IMS management of ACBs is enabled and the high-level qualifier of the bootstrap data set of the IMS directory can be obtained from DBRC or the IMSCATHLQ statement in the FABYIN DD statement, the IMS DD statement is ignored. image-20180627145213-6

IMSDALIB

image-20180627145213-7PROCLIB

Input

 

Optional

Points to the IMS.PROCLIB data set. If you specify DFSDF=xxx in the FABYIN DD statement, you must also specify this DD statement and the DFSDFxxx member must exist in the IMS.PROCLIB data set. image-20180627145213-8

INDXWKnn

       

...

       

Topics:

Descriptions for the following control statements have been updated as follows:

DBRC

...

image-20180627145213-9

DFSDF

DFSDF specifies the suffix of the DFSDFxxx member in the IMS.PROCLIB data set. The member with this suffix must exist in a data set specified in the PROCLIB DD statement. If the member contains the ACBMGMT=CATALOG parameter in the CATALOG section, IMS managed ACBs is enabled.

This control statement is required only when IMS HP Prefix Resolution uses IMS managed ACBs through the DFSDFxxx member. This DD statement is not required if IMS HP Prefix Resolution refers to the DBD libraries or if you enable the IMS management of ACBs with the IMS Catalog Definition exit routine (DFS3CDX0).

image-20180627145213-10

*NO

Specifies IMS HP Prefix Resolution does not refer to the DFSDFxxx member in the PROCLIB data set.

sfx

Specifies the 3-character suffix of the DFSDFxxx member in the PROCLIB data set. 

image-20180627145213-11

...

HPPRBH

...

image-20180627145213-12

IMSCATHLQ

IMSCATHLQ specifies the high-level qualifier of the bootstrap data set of the IMS directory, which is an extension of the IMS catalog.

This control statement is required only when you run a Prefix Update job in an IMS-managed ACBs environment and IMS catalog database is not registered to DBRC.

If you do not specify this control statement, IMSCATHLQ=*NO is used.

image-20180627145213-13

*NO

Specifies to obtain the high-level qualifier of the bootstrap data set of the IMS directory from DBRC.

bsdshlq

Specifies the high-level qualifier of the bootstrap data set of the IMS directory.

image-20180627145213-14

Topic: Running HP Prefix Resolution > Concurrent Prefix Update > JCL example for Concurrent Prefix Update

 

A new example has been added as follows:

image-20180627145213-15

The following JCL example invokes Concurrent Prefix Update in an IMS managed ACBs environment.

In this example:

  • The name of the SGLXLOAD library of Tools Base is specified on the STEPLIB DD statement. 
  • The name of the IMS.PROCLIB data set in which the DFSDFCAT member exists is specified on the PROCLIB DD statement.     
  • DFSDF=CAT parameter is specified on the FABYIN DD statement. This parameter specifies the DFSDFCAT member that enables IMS managed ACBs.
  • The keyword STAGING is specified on the DFSACBPD DD statement. This keyword specifies to use pending changes in the staging data sets in the IMS catalog.
  • IMS DD is not specified because the database definition will be obtained from the IMS catalog staging data sets.

Change the bold values to meet your site requirements.

 

Figure 2.  Concurrent Prefix Update JCL for an IMS managed ACBs environment

image-20180627145213-16

 

image-20180627145213-17

Topic: Troubleshooting > Messages

The following new messages have been added:

image-20180627145213-18

FABY033I IMS MANAGED ACBS ENABLED: [ACTIVE | PENDING] DEFINITIONS ARE USED

IMS CATALOG HLQ: hlq

Explanation: IMS HP Prefix Resolution found that the IMS catalog is enabled and that the ACBs are managed by IMS.

  • ACTIVE indicates that the database information is retrieved from the IMS catalog directory data sets.
  • PENDING indicates that the database information is retrieved from the IMS catalog staging data sets.

System action: IMS HP Prefix Resolution continues processing by using the database definitions in the IMS catalog instead of the definitions in the DBDLIB that is specified by the IMS DD statement.

User response: None. This message is informational.

image-20180627145213-19

---

image-20180627145213-20

FABY3002A ERROR RETURNED FROM CATALOG API: FUNC=OPEN RC=rc RSN=rsn

Explanation: IMS HP Prefix Resolution received an error return code from IMS Tools Catalog Interface.  

System action: IMS HP Prefix Resolution issues a user 3002 abend and a dump.

User response: Contact IBM Software Support.

image-20180627145213-21

---

image-20180627145213-22

FABY3003A ERROR RETURNED FROM CATALOG API: FUNC=GET RC=rc RSN=rsn DBD=dbdname

Explanation: IMS HP Prefix Resolution received an error return code from IMS Tools Catalog Interface.  

System action: IMS HP Prefix Resolution issues a user 3003 abend and a dump.

User response: Contact IBM Software Support.

image-20180627145213-23

Publication Number

SC18-9230-05


Cross reference information
Product Component Platform Version Edition
IMS Tools IMS Database Solution Pack z/OS All Versions

Document information

More support for: IMS Tools

Component: IMS Database Solution Pack, IMS High Performance Prefix Resolution for z/OS

Software version: 1.3, All Versions

Operating system(s): z/OS

Reference #: 0715501

Modified date: 23 July 2018