A fix is available
APAR status
Closed as new function.
Error description
With this option FPA INDEXBLD synchronizes the primary DEDB database and its secondary index databases that are suppressed by index maintenance via the index suppresion option for BMP regions. Keyword: Fast Path Advanced
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of HPFPU Fast Path Advanced Tool * * in Fast Path Solution Pack Version 1 Release * * 2 (FMID: HAHQ120) * **************************************************************** * PROBLEM DESCRIPTION: FPA INDEXBLD adds support for * * re-synchronize option. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. For example, when a DEDB is updated via the index suppression option for BMP regions, its secondary index databases are not updated. Then the DEDB and its secondary index databases are out of synchronization. With this option FPA INDEXBLD synchronizes the primary DEDB database and its secondary index databases. FPA INDEXBLD with this option runs against online areas. In the other hand secondary index databases are re-synchronized with short outage. The new Secondary Index Resync report is stored in the IMS Tools Knowledge Base repository. If you will store reports in the IMS Tools KB repository, see the Configuring IMS Tools Knowledge Base topic in IMS Fast Path Solution Pack, Overview and Customization. 2. hpfp.SHFPJCL0(HFPCITKB) is modified to be consistent with other products.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS Fast Path Solution Pack for z/OS Version 1 Release 2 IMS High Performance Fast Path Utilities User's Guide (SC19-3287-00). For the documentation changes made by this APAR, see http://www-01.ibm.com/support/docview.wss?uid=swg27023880. 2.10.7 Examples for the Build Index function The following example have been added: The following figure shows example JCL statement for resynchronizing the DEDB areas and all secondary index databases. In this example: - RECON data sets are allocated dynamically by using the DFSMDA members in the IMSDALIB DD data set. - The input ADS is dynamically allocated. The allocation information (DD name and DS name of the ADS) is obtained from DBRC. - The secondary index database data sets to be updated are dynamically allocated. The allocation information (DD name and DS name of the secondary index database data sets) is obtained from DFSMDA members in the IMSDALIB DD data set. //HFP EXEC PGM=HFPMAIN0 //STEPLIB DD DISP=SHR,DSN=HPFP.SHFPLMD0 // DD DISP=SHR,DSN=TOSI.SFOILOAD // DD DISP=SHR,DSN=IMSVS.SDFSRESL // DD DISP=SHR,DSN=IMSVS.PGMLIB //IMSACB DD DISP=SHR,DSN=IMSVS.ACBLIB //IMS DD DISP=SHR,DSN=IMSVS.DBDLIB //IMSDALIB DD DISP=SHR,DSN=IMSVS.MDALIB //HFPSYSIN DD * GLOBAL DBRC=YES, TOIXCFGRP=XCFGP INDEXBLD DBD=DEDBJN22, IAREA=ALL, INDEXDBD=ALL, IDXPROC=RESYNC, TOICTL=DBR // Figure xx. Resynchronizing the DEDB areas and all secondary index databases. 2.11 Command reference for FPA 2.11.4 FPA keywords The following keywords have been added: IDXPROC Use the IDXPROC keyword to specify whether to build secondary index databases or to synchronize a primary DEDB database and its secondary index databases. IDXPROC is an optional keyword for the INDEXBLD command. Related keywords: None. Format: IDXPROC=parameter parameter Specify one of the following parameters: BUILD Builds secondary index databases. RESYNC Synchronizes a primary DEDB database and its secondary index databases after suppressing index maintenance for BMP regions Default: IDXPROC=BUILD Site default support: Supported. TOICTL Use the TOICTL keyword to specify whether the IMS Tools Online System Interface is to be used to stop the secondary index databases. If you do not specify IDXPROC=RESYNC, this keyword is ignored. TOICTL is an optional keyword for the INDEXBLD command. Related keywords: None. Format: TOICTL=parameter parameter Specify one of the following parameters: DBR Indicates that /DBRECOVERY command is to be issued to stop the secondary index databases. DBD Indicates that /DBDUMP command is to be issued to stop the secondary index databases. Default: TOICTL=DBR Site default support: Supported. TOINUM Use the TOINUM keyword to specify the number that FPA retry issuing the command to retrieve the response from the IMS Tools Online System Interface. If you do not specify IDXPROC=RESYNC, this keyword is ignored. TOITIME is an optional keyword for the GLOBAL command. Related keywords: None. Format: TOITIME=parameter parameter Specify the number that FPA retry issuing the command. Specify an integer value in the range of 1-100. Default: TOINUM=10 Site default support: Supported. TOITIME Use the TOITIME keyword to specify the time value that is used to retrieve the response from the IMS Tools Online System Interface. If you do not specify IDXPROC=RESYNC, this keyword is ignored. TOITIME is an optional keyword for the GLOBAL command. Related keywords: TOINUM Format: TOITIME=parameter parameter Specify, in seconds, the maximum allowable time until FPA detects the stop of a database. If the program does not receive response from the IMS Tools Online System Interface within the specified time, FPA retry issuing the command up to the number that is specified in TOINUM. If all else fails, HFPX0103E message is issued. The number you specify must be an integer value in the range of 1 - 100. Default: TOITIME=30 Site default support: Supported. TOIXCFGRP Use the TOIXCFGRP keyword to identify the XCF group that the IMS Tools Online System Interface uses to interface with FPA. If you do not specify IDXPROC=RESYNC, this keyword is ignored. TOIXCFGRP is an optional keyword for the GLOBAL command. Related keywords: None. Format: TOIXCFGRP=parameter parameter Specify the XCF group name. The group name is a 1-5 alphanumeric character string that the IMS Tools Online System Interface prefixes with the characters "TOI", to produce the XCF group name. Default: TOIXCFGRP=*NO Site default support: Supported. 7.1.3 Messages New messages HFPX0101I, HFPX0102I, HFPX0103E, HFPX0104W, HFPX0105E and HFPX0107E are added.
APAR Information
APAR number
PM54862
Reported component name
IMS FP SOLUTION
Reported component ID
5655W1400
Reported release
120
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2011-12-21
Closed date
2012-03-27
Last modified date
2012-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK77384
Modules/Macros
FPXBTOA0 HAHQ120J HFPBLIN0 HFPBLMN0 HFPBLRI0 HFPBLRO0 HFPBLRS0 HFPBLSI0 HFPBLVS0 HFPBRCP0 HFPBRIN0 HFPBRMN0 HFPBRNS0 HFPBRSC0 HFPBRSD0 HFPBRTR0 HFPBRVR0 HFPBSTM0 HFPCCDT0 HFPCDEF0 HFPCFNL0 HFPCITKB HFPCTSK0 HFPFAAL0 HFPFEST0 HFPFIXL0 HFPFMAN0 HFPFSIT0 HFPFTSK0 HFPFXCI0 HFPGHKI0 HFPGPRS0 HFPJAIO0 HFPJINI0 HFPLCC20 HFPLCC40 HFPLINI0 HFPLMAN0 HFPLSIR0 HFPRCDB0 HFPTAAL0 HFPTOMN0 HFPUMVT0 HFPUROB0 HFPWMTB0 HFPWMTX0 HFPXMAN0 HFPXTIT0 HFPXTMN0 HFPXTOI0 HFPXTRM0 HFPXTRS0 HFPY0610 HFPY2910
| SC19328700 |
Fix information
Fixed component name
IMS FP SOLUTION
Fixed component ID
5655W1400
Applicable component levels
R120 PSY UK77384
UP12/03/28 P F203
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":"1.2.0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCV35A","label":"IMS Fast Path Solution Pack"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.2.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 April 2012