A fix is available
APAR status
Closed as program error.
Error description
Currently, the CHANGE.DBDS DBD(xxxxxxxx) DDN(xxxxxxx) NORECOV commands are issued regardless of the RECOV_NEEDED flag status in RECON. The command should be issued only if RECOV_NEEDED flag is ON.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Index Builder for z/OS, * * Version 3 Release 1 (FMID=H22O310) * **************************************************************** * PROBLEM DESCRIPTION: This APAR changes the followings: * * * * 1. CHANGE.DBDS DBD(xxxxxxxx) * * DDN(xxxxxxx) NORECOV commands are * * issued based on the RECOV_NEEDED * * flag status. * * 2. The IMS DD dynamic concatenation is * * disabled. The IMS Index Builder * * load library is no longer needed to * * be concatenated to the IMS DD. * * 3. The PROGMON control statement is * * added for monitoring the progress of * * the secondary index loading process. * * * * And the following problem is fixed: * * * * 4. ABENDS0C4 at IIUBDBD+2982 when * * BLD_PRIMARY and BLD_SECONDARY is * * specified for HIDAM. * **************************************************************** * RECOMMENDATION: * **************************************************************** The changes described in the problem description field are added. After applying this APAR, the DBRC command CHANGE.DBDS DBD(xxxxxxxx) DDN(xxxxxxx) NORECOV is issued based on the status of the DBRC RECOV_NEEDED flag for each index and whether 'DBAUTH YES,RECOV' control statement is specified.
Problem conclusion
======================== = Documentation Change = ======================== IBM IMS Index Builder for z/OS, V3R1, User's Guide (SC18-9101-06) should be changed as follows: ================================================================ (D indicates the line to be deleted. I indicates the line to be added.) ---------------------------------------------------------------- > Using Index Builder >> JCL and input control statements >>> IMS Index Builder JCL >>>> DD statements IMS DD statement This DD statement is used to access the involved databases. The file points to one or more libraries that contain the DBDs of the physical database and its indexes. D The IMS Index Builder load library can be concatenated D to provide the generic IMS Index Builder reusable PSBs. D Otherwise, IMS Index Builder will dynamically concatenate D the IMS Index Builder load library to IMS DD if the Index D builder load library is in the STEPLIB concatenation. D If seven or more libraries are concatenated to IMS DD, D the IMS Index Builder load library must be concatenated D to the IMS DD. D Because IMS Index Builder might dynamically reallocate D the libraries allocated in the IMS DD statement, this DD D statement must not contain temporary data sets. This statement is required. ---------------------------------------------------------------- >>> IMS Index Builder input control statements >>>> Optional control statements >>>>> PROGMON control statement | The PROGMON control statement specifies the interval of | the WTO IIUB119I messages for monitoring the load process | of each secondary index. | If this statement is not specified, the default value 0 | is used. | | +---------------------------------------------------------+ | | .---- 0 ---. | | | >>- PROGMON --+- nnnnnn -+------------------------>< | | +---------------------------------------------------------+ | | PROGMON | Specifies that this is a PROGMON statement. | nnnnnn | Is the interval number of the loaded records, in the range | of 0 - 999999. | If you specify 0, the IIUB119I message is not shown. | | Tips: | - You can override the default value in the runtime | parameters module. See the explanation of the IIURDFLT | PROGMON entry in Defining runtime parameters. ---------------------------------------------------------------- >> Defining runtime parameters Figure 1. Example of an IMS Index Builder runtime parameters module (Part 2 of 2) : * DC CL52'IIURDFLT MAXTASKS 02' | * DC CL52'IIURDFLT PROGMON 100000' | IIURDFLT PROGMON entry | Use the IIURDFLT PROGMON entry to specify the interval of | the WTO IIUB119I messages for monitoring the load process | of each secondary index. | For details, see PROGMON control statement. ---------------------------------------------------------------- > Troubleshooting >> IMS Index Builder messages | IIUB119I INDEX DBD|PART =xxxxxxxx- n,nnn,nnn,nnn RECORDS | LOADED *COMPLETED* | | Explanation: This WTO message shows the number of loaded index | records for an index or a partition for monitoring the process. | System action: Processing continues. | User response: None. This message is informational. --------------------------------------------------------------- ================ End of Documentation Change ===================
Temporary fix
Comments
APAR Information
APAR number
PI65714
Reported component name
IMS INDEX BUILD
Reported component ID
5655E2400
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-07-12
Closed date
2016-08-18
Last modified date
2016-09-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI40179
Modules/Macros
IIUBDAPI IIUBDBD IIUBE352 IIUBIBCD IIUBMSGS IIUBSCTL IIUBSTMS IIUDRVRX IIUNDXRC IIUPDBRC IIUPRLNT IIUSCA25 IIUSE35P IIUSIBCD IIUSMP10
SC18910106 |
Fix information
Fixed component name
IMS INDEX BUILD
Fixed component ID
5655E2400
Applicable component levels
R310 PSY UI40179
UP16/08/20 P F608
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":"SSCX89M","label":"IMS Index Builder"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 September 2016