A fix is available
APAR status
Closed as new function.
Error description
This APAR enables HDPC to support IMS Catalog database.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: IBM IMS High Performance Pointer Checker for * * z/OS Version 3 Release 1 (FMID=HPC2310) * * users who run HD Pointer Checker (HDPC). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables HDPC to support IMS * * Catalog database in HDPC stand-alone * * jobs. * * * * Additionally, this APAR corrects the * * problem that HDPC gets ABEND0C4 in * * CSECT FABPALLC when you specify ILDS * * data sets. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables HDPC to support IMS Catalog database in HDPC stand-alone jobs. When an IMS Catalog database is registered in RECON and an alias is not defined for the IMS Catalog database, you can run HDPC for the IMS Catalog database in the same manner as HALDB. When an IMS Catalog database is not registered in RECON or an alias is defined for the IMS Catalog database, you must additionally do the following to run HDPC for the IMS Catalog database: - You must specify the DFSDF= parameter in parentheses of PARM= on the EXEC statement. DFSDF= specifies the 3-character suffix of the DFSDFxxx member of the IMS.PROCLIB that contains the unregistered IMS catalog databases name or the alias name. Alternatively, you must specify the library that contains the Catalog Definition exit routine (DFS3CDX0) to STEPLIB DD. - If you specify the DFSDF= parameter in parentheses of PARM= on the EXEC statement, you must specify the IMS PROCLIB data set that contains the DFSDFxxx member to PROCLIB DD in HDPC job steps. - If an IMS Catalog database is not registered in RECON, you must specify the IMS catalog partition definition data set to DFSHDBSC DD in HDPC job steps. If DFSHDBSC data set is allocated dynamically by DFSMDA macro, you can omit DFSHDBSC DD. In this case, you must specify the library that contains the DFSMDA member for DFSHDBSC data set. For more details about how to code HDPC JCLs, see the documentation changes. DB Segment Restructure (DBSR) and IMS Database Repair Facility (DBRF) do not support IMS Catalog databases. Additionally, this APAR corrects the problem that HDPC gets ABEND0C4 in CSECT FABPALLC around offset X'5B6' when you specify ILDS data sets to process HALDBs in an HDPC job step.
Problem conclusion
Temporary fix
Comments
Documentation Changes: Note: The section numbers are those of the BookManager (BKMGR) book. The documentation is modified as follows: ============================================================== IMS High Performance Pointer Checker for z/OS, V3R1, User's Guide (SC19240101) ============================================================== >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 2.0 HD Pointer Checker >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -------------------------------------------------------------- 2.2 Operating instructions for the HD Pointer Checker processor 2.2.1 Job control language 2.2.1.1 FABPMAIN JCL 2.2.1.1.1 EXEC statement -------------------------------------------------------------- <<The description has been changed as follows:>> : The following are parameters in parentheses of PARM=: region Specifies an IMS region type. ... : psbname Specifies the PSB name that contains the PCB of the processing databases. The PSB name must be defined as a PSB with LANG=ASSEM, LANG=COBOL, or LANG=PL/I. It must refer directly or indirectly to all input databases. The PSB, in which less than 2,500 of database data sets are referred to, can be used in the HD Pointer Checker run. |When you run HDPC for an IMS Catalog database, specify the IMS |Catalog PSB DFSCP000, DFSCP001, or DFSCP002 provided by IMS. It is required if DLI or DBB is specified in the region parameter. It is not required if ULU is specified in the region parameter. <<The following Considerations have been added:>> |Considerations for HD Pointer Checker for IMS Catalog database: |- When you run HD Pointer Checker for either an IMS catalog |database that is not registered in the RECON data set or an |IMS catalog database that an alias name is defined for, specify |the DFSDF= parameter in parentheses of the PARM= parameter on |the EXEC statement. DFSDF= specifies the 3-character suffix xxx |of the DFSDFxxx member of the IMS.PROCLIB data set that |contains the names of your unregistered IMS catalog databases. |For example: |// EXEC PGM=DFSRRC00, |// PARM=(DLI,FABPMAIN,psbname,,,,,,,,,,,dbrc,N,,,,,,,, |// ,,,,'DFSDF=xxx') |- If you specify the library that contains the Catalog |Definition exit routine (DFS3CDX0) to the STEPLIB DD statement, |the DFSDF=xxx parameter can be omitted. |- When you run HD Pointer Checker in a ULU region with DBRC=N |for an IMS catalog database that is not registered in the RECON |data set,specify a DBD name DFSCD000 for the IMS Catalog |database. |For example: |// EXEC PGM=DFSRRC00, |// PARM=(ULU,FABPMAIN,dbdname,,,,,,,,,,,N,N,,,,,,,, |// ,,,,'DFSDF=xxx') -------------------------------------------------------------- 2.2.1.1.2 DD statements -------------------------------------------------------------- <<The description of STEPLIB DD has been changed as follows:>> STEPLIB DD <<The following library has been add to the STEPLIB DD:>> | - The library that contains the Catalog Definition exit | routine (optional) <<The following DD statements have been added:>> |DFSHDBSC DD |This optional input data set is the IMS catalog partition |definition data set. When you run HD Pointer Checker for an |IMS catalog database that is not registered in the RECON data |set, you must specify the data set that the IMS catalog |database is defined in. If the DFSHDBSC data set is allocated |dynamically by DFSMDA macro, this DD statement can be omitted. |PROCLIB DD |This optional input data set is the IMS PROCLIB data set. When |you specify the DFSDF=xxx parameter in parentheses of the |PARM= on the EXEC statement, you must specify the IMS PROCLIB |data set that contains the DFSDFxxx member. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 6.0 DB Segment Restructure >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -------------------------------------------------------------- 6.1 Overview of DB Segment Restructure 6.1.5 Restrictions and considerations -------------------------------------------------------------- <<The following restriction is added:>> |DB Segment Restructure does not support IMS Catalog databases. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 8.0 Troubleshooting >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -------------------------------------------------------------- 8.1 Messages and codes 8.1.1 HD Pointer Checker 8.1.1.3 Messages -------------------------------------------------------------- <<The following messages are changed:>> FABP2062E DBD NAME SPECIFIED IN "DB" PARAMETER NOT FOUND IN DMB Problem Determination: You may have entered the dbdname incorrectly on your control statement. It is also possible that you used the wrong PSB name on the EXEC statement PARM. (You can also get this error by running HD Pointer Checker under a different release of IMS than the one used to install IMS HP Pointer Checker.) |If the processing database is an IMS Catalog database and the |dbdname is an alias name of the IMS Catalog database, the |Catalog Definition exit routine (DFS3CDX0) is not found in the |STEPLIB DD and DFSDF=xxx is not specified on the EXEC statement | of the HD Pointer job step. If this error resulted when an unrelated database was encountered on a control statement, remove the DATABASE statements that are not logically related to the first DATABASE statement. Put these statements, if related to each other, in a separate job and run it separately. FABP2098E DBRC IS REQUIRED TO PROCESS HALDB DB: dbdname |Explanation: If the processing database is a HALDB or an IMS |Catalog database that is registered in the RECON data set, DBRC should be activated. However, DBRC was not active. |This error message also appears if the processing database is |an unregistered IMS Catalog database, and if the Catalog |Definition exit routine (DFS3CDX0) is not found in the STEPLIB |DD and |DFSDF=xxx is not specified on the EXEC statement. |User Response: If the processing database is a HALDB or an IMS |Catalog database that is registered in the RECON data set, |specify Y for the 14th parameter on the EXEC statement of the HD Pointer job step. For example, //HDPCPRO EXEC PGM=DFSRRC00, // PARM='ULU,FABPMAIN,,,,,,,,,,,,Y,N' |If the processing database is an unregistered IMS Catalog |database, specify the library containing the Catalog Definition |exit routine (DFS3CDX0), which the unregistered IMS catalog |database names are defined in, to the STEPLIB DD statement. |Alternatively, specify DFSDF=xxx for the 27th parameter on the |EXEC statement of the HD Pointer job step. DFSDF= specifies the |3-character suffix xxx of the DFSDFxxx member that specifies |the unregistered IMS catalog database names. |For example: |//HDPCPRO EXEC PGM=DFSRRC00, |// PARM=(DLI,FABPMAIN,,,,,,,,,,,,N,N,,,,,,,,,,,,'DFSDF=xxx') FABP3996E UNABLE TO BUILD CONTROL BLOCKS FOR DBD: dbdname Explanation: ... System Action: ... User Response: Make sure that a valid DBD or RECON data set exists for the named database. |If the processing database is an IMS Catalog database that is |registered in the RECON data set, specify Y for the 14th |parameter on the EXEC statement of the HD Pointer job step. |For example, |//HDPCPRO EXEC PGM=DFSRRC00, |// PARM='ULU,FABPMAIN,,,,,,,,,,,,Y,N' |If the processing database is an IMS Catalog database that is |not registered in the RECON data set, specify the library |containing the Catalog Definition exit routine (DFS3CDX0), |which the unregistered IMS catalog database names are defined |in, to the STEPLIB DD statement or specify DFSDF=xxx for the |27th parameter on the EXEC statement of the HD Pointer job |step. DFSDF= specifies the 3-character suffix xxx of the |DFSDFxxx member that specifies the unregistered IMS catalog |database names. |For example, |//HDPCPRO EXEC PGM=DFSRRC00, |// PARM=(ULU,FABPMAIN,dbdname,,,,,,,,,,,N,N,,,,,,,, |// ,,,,'DFSDF=xxx') |Then correct the error and rerun the job. <<The following messages has been added:>> |FABP3865E THE IMS CATALOG PSB IS REQUIRED TO PROCESS IMS |CATALOG: dbdnama |Explanation: HD Pointer Checker attempted to process the IMS |Catalog database in a DLI or DBB region. But, the IMS Catalog |PSB was not specified in parentheses of the PARM= parameter |on the EXEC statement. You must specify the IMS Catalog PSB |DFSCP000, DFSCP001, or DFSCP002 provided by IMS. |System Action: HD Pointer Checker issues a USER 3865 abend. |User Response: Specify the IMS Catalog PSB DFSCP000, |DFSCP001, or DFSCP002 provided by IMS and rerun the job. |Problem Determination: None.
APAR Information
APAR number
PM64745
Reported component name
IMS POINTER CHE
Reported component ID
5655E0900
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2012-05-16
Closed date
2012-06-01
Last modified date
2012-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK79246
Modules/Macros
FABPADBS FABPALLC FABPIBLK FABPLBLX FABPMSGT FABPPSDA FABPUHTC
| SC19240101 |
Fix information
Fixed component name
IMS POINTER CHE
Fixed component ID
5655E0900
Applicable component levels
R310 PSY UK79246
UP12/06/05 P F206
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1.0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89G","label":"IMS HP Pointer Checker"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2012