A fix is available
APAR status
Closed as new function.
Error description
Database versioning has been introduced as an IMS V13 enhancement. If database versioning is enabled in IMS DLI or DBB Batch region of an HP Unload job, the HSSR Engine supports only the current version of the database. If any other version is specified in PSB, all HSSR PCBs fall back to DL/I PCBs and all calls are processed by IMS DL/I.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS High Performance Unload for * * z/OS Version 1 Release 2 (FMID=H1IN120) * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables HP Unload API to * * support the IMS database versioning. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables HP Unload API to support the IMS database versioning with restrictions. If IMS database versioning is enabled and any database version other than the currenet version is specified, the performance decreases because the HSSR Engine passes the DL/I calls to the IMS's DL/I call handler. Certain control statements specified in the HSSROPT data set are ignored: BYINDEX, CO, DBSTATS, KEYCHECK, and SKERROR. And the BLDLLPCK control statement is activated. In this case MSGFABH0638W is issued: FABH0638W SPECIFIED DBVER IS NOT SUPPORTED. HSSR CALLS FALL BACK TO DL/I The HP Unload utilities (FABHURG1, FABHFSU, and IPR Unload utility) do not support any other than current version and MSGFABH0286E or MSGDFS3436E is issued. FABH0286E SPECIFIED DBVER IS NOT SUPPORTED FABH0659E SPECIFIED DBVER IS NOT SUPPORTED The IBM-provided catalog procedures ( FABHDLI, FABHDBB, or FABHULU ) have been modified as to add the parameters: RGSUF= and PARM1=. To enable the IMS catalog or IMS database versioning, the suffix of the DFSDFxxx member of IMS.PROCLIB is needed. Specify it as below: //HPUNLD EXEC FABHDLI,MBR=HSSRAPPL,PSB=PSBAPPL1,DBRC=Y, // PARM1='DFSDF=001' For the IPR Unload, a new parameter DFSDF= is added. //IPRUNLD EXEC PGM=HPSCMAIN, // PARM='FUNC=UL,APPL=(MYPGM,PSB0001,DLI),DBRC=Y, // DFSDF=001'
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS High Performance Unload for z/OS User's Guide Version 1 Release 2 Suffix 7 (SC27-0936-07) should be changed as follows: --------------------------------------------------------------- 2.1.2 Restrictions for IMS High Performance Unload Restrictions common to all HSSR applications The following restrictions apply to all HSSR application programs including the FABHURG1 utility and the FABHFSU utility: - Logical DBD is not supported. - A sensitive virtual logical child (LCHILD) is not supported. - Field sensitivity for an HSSR PCB is not supported. - For the restrictions of secondary index processing, see "Considerations for using a secondary index" in topic 2.1.3.5. |- If IMS database versioning is enabled and any database | version other than the current is specified, the HSSR Engine | passes the DL/I calls to the IMS's DL/I call handler. | Certain HPPSOPT control statements are ignored. For the | details, see the explanation of the FABH0638W message. | For the FABHURG1 utility and the FABHFSU utility, any | database version other than the current is not supported. - The following restrictions apply to HSSR calls: : Restrictions common to FABHURG1 and FABHFSU The following restrictions are common to FABHURG1 and FABHFSU: - The DBD that specifies the input database must be a physical DBD. |- If IMS database versioning is enabled, any version other than | the current is not supported. : --------------------------------------------------------------- 2.2 Basic job control language 2.2.1 Preparing the basic JCL : D 3. Modify the cataloged procedures for IMS DBRC SCI D registration. D D If the IMS DBRC SCI registration requires the IMSplex name D and the DBRC group identification, you must add the D appropriate parameters (IMSPLEX= or PARM1=) to the FABHULU, D FABHDLI, and FABHDBB catalog procedures as shown in the D following figure. D D //FABHULU PROC IMSDSN=IMSVS,DBTLMD='HPS.SHPSLMD0',SOUT='*', D // MBR=TEMPNAME,CTRL=DFSRRC00,DBD=,BUF=7, D // SPIE=0,TEST=0,EXCPVR=0,RST=0,PRLD=,SRCH=0, D // CKPTID=,MON=N,LOGA=0,FMTO=T,IMSID=,SWAP=,DBRC=, D // IRLM=,IRLMNM=,IMSPLEX=,PARM1= D //* D //G EXEC PGM=FABHX034,PARM=('&CTRL/ULU',&MBR,&DBD,&BUF, D // &SPIE&TEST&EXCPVR&RST,&PRLD,&SRCH,&CKPTID,&MON, D // &LOGA,&FMTO,&IMSID,&SWAP,&DBRC,&IRLM,&IRLMNM, D // ,,,,,,,,&IMSPLEX,,'&PARM1') D Figure 2. Adding IMSPLEX and PARM1 parameters to the FABHULU D procedure D D In the JCL that uses the FABHULU procedure, you can specify D the parameter values as shown in the following figure. D D //UNLOAD EXEC FABHULU, D // MBR=FABHFSU,DBD=PHDV0100,DBRC=Y, D // IRLM=Y,IMSPLEX=PLEX1,PARM1='DBRCGRP=001' D D Figure 3. Example of the parameter specification for the D FABHULU procedure --------------------------------------------------------------- 2.1.3.4 Considerations for HALDB Online Reorganization capable partitions : Because the DBSTATS control statement is ignored, the following reports are not printed: | - DB Statistics report - Randomizing Statistics report - DB Record Length Distribution report : --------------------------------------------------------------- 7.2 Messages and codes 7.2.4 Messages 7.2.4.1 FABH messages -------------------------------------------------------------- |FABH0638W SPECIFIED DBVER IS NOT SUPPORTED. HSSR CALLS FALL | BACK TO DL/I | |Explanation: IMS database versioning is enabled and the |specified database version is not the current level. The HSSR |engine does not support the version. HSSR Engine will pass |all of the following DL/I calls to IMS's DL/I call handler. |Certain control statements specified in the HSSROPT data set |are ignored: BYINDEX, CO, DBSTATS, KEYCHECK, and SKERROR. |And the BLDLLPCK control statement is activated. |System action: HSSR Engine continues processing. The |performance, however, decreases. |User Response: Change the PSB as follows: specify the |current level of the database. -------------------------------------------------------------- |FABH0286E SPECIFIED DBVER IS NOT SUPPORTED | |Explanation: IMS database versioning is enabled and the |specified database version is not the current level. |System action: FABHURG1 or FABHFSU ends abnormally. |User Response: Change the PSB as follows: specify the |current level. -------------------------------------------------------------- |FABH0659E SPECIFIED DBVER IS NOT SUPPORTED | |Explanation: IMS database versioning is enabled in the ULU |region and the specified database version is not the current |level. |System action: HSSR Engine ends abnormally. |User Response: Check whether 'DBVERSION=(YES,DBLEVEL=BASE)' |statement is coded in the DFSDFxxx member of the IMS.PROCLIB |data set. If so, remove it or specify the current level. ================= End of Documentation Change ================== ======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 Suffix 3 (SC19-1137-03) should be changed as follows: --------------------------------------------------------------- > Unloading a database >> IPR Unload utility >>> Restrictions and considerations for IPR Unload Restrictions - Database organization types other than HDAM, HIDAM, PHDAM, PHIDAM, HISAM, and SHISAM are not supported. |- If IMS database versioning is enabled, any version other | than the current is not supported. : --------------------------------------------------------------- > Unloading a database >> IPR Unload JCL statements >>> JCL requirements for IPR Unload >>>> EXEC statement Specify HPSCMAIN as the program name. The PARM= parameter keywords are as follows: : GSGNAME=name Specifies the name of the global service group (GSG). |DFSDF=ccc | Specifies the 3-character suffix of the DFSDFxxx member of | the IMS.PROCLIB data set. The PROCLIB DD statement is | required. --------------------------------------------------------------- > Unloading a database >> IPR Unload JCL statements >>> JCL requirements for IPR Unload >>>> DD statements (The PROCLIB DD statement is added.) Table 1. DD statements and record format for the IPR Unload utility | DDNAME: PROCLIB | Use: Input | Format: | Need: Optional | PROCLIB DD | Points to IMS.PROCLIB data set. | If DFSDF=ccc is specified in the EXEC statement, this DD | statement and the DFSDFccc member are required. --------------------------------------------------------------- > Unloading a database >> Application programming interface for IPR Unload utility >>> JCL requirements >>>> EXEC statement Optionally, you can specify the DBRC=, SWAP=, IRLM=, IRLMNM=, |GSGNAME=, IMSPLEX=, and DFSDF= parameters to specify the job step environment. For the details of these parameters, see IPR Unload JCL statements. --------------------------------------------------------------- > Unloading a database >> Application programming interface for IPR Unload utility >>> JCL requirements >>>> DD statements (The PROCLIB DD statement is added.) Table 1. JCL DD statements for HSSR application programs | DDNAME: PROCLIB | Use: Input | Format: | Need: Optional : | PROCLIB DD | See IPR Unload JCL statements. --------------------------------------------------------------- ================= End of Documentation Change ==================
APAR Information
APAR number
PI10157
Reported component name
IMS HIGHPERF UN
Reported component ID
5655E0600
Reported release
120
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2014-01-22
Closed date
2014-06-10
Last modified date
2014-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI18739
Modules/Macros
FABHA00 FABHA01 FABHA30 FABHC00 FABHDBB FABHDLI FABHFSU3 FABHGDL3 FABHGND FABHJCB FABHJCB0 FABHOPT FABHRTI0 FABHULU FABHURGA FABHURGB FABHURG2 FABHURG3 FABHURG8 FABHURG9 FABH001 FABH002 FABH003C FABH010A FABH010B FABH010C FABH0102 FABH0103 FABH0108 FABH0109 FABH020A FABH020B FABH020C FABH0202 FABH0203 FABH0208 FABH0209 FABH022 FABH041C FABH060C FABH070C FABH090C FABH091C FABH093C FABH250C FABH500C FABH512C FABH520C FABH550C FABH660C FABH662C HPSSSEHA HPSSSEHB HPSSSEH2 HPSSSEH3 HPSSSEH8 HPSSSEH9 HPSUFCB0 HPSUGITD HPSUGIT0 HPSUITKB HPSUMAIN HPSURIO0 HPSURMA0
| SC27093607 | SC19113703 |
Fix information
Fixed component name
IMS HIGHPERF UN
Fixed component ID
5655E0600
Applicable component levels
R120 PSY UI18739
UP14/06/17 P F406
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.
[{"Line of Business":{"code":"LOB10"},"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SSCX89K","label":"IMS Tools"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.2.0"}]
Document Information
Modified date:
14 December 2020