A fix is available
APAR status
Closed as new function.
Error description
FABHURG1 unload utility adds an option to insert one or more time stamp records to unload data sets. HP Load uses the record to check the time against DBRC.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM IMS High Performance * * Unload for OS/390 Release 1 (FMID=H1IN110) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides the CHECKREC control * * statement for FABHURG1. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the CHECKREC control statement. If 'CHECKREC YES' is specified in SYSIN DD, FABHURG1 Unload Utility writes the particular record for checking the content by High Performance Load (FMID=H1IM210).
Problem conclusion
Temporary fix
Comments
Documentation Change ==================== IMS High Performance Unload for OS/390 User's Guide (SC27093604) should be changed as follows: ================================================================ 1.4 Using FABHURG1 to Unload IMS Databases 1.4.7 Input 1.4.7.1 SYSIN data set (Add following control statement) |This optional control statement specifies whether |the particular record is written just behind the header record |in the unload data set. This record is used by IMS High |Performance Load to know certain status of the database |at unloading. | |This control statement is used only for *HD unload format. | | _____________________________________________________________ || | || 0........1.........2.........3.........4.........5......... | || 12345678901234567890123456789012345678901234567890123456... | || | || CHECKREC ddd | ||_____________________________________________________________| | |Position Description |1 Code the CHECKREC keyword to identify the statement. |10 Use one of the following keywords: | Keyword Description | YES The particular record is written. | NO The particular record is not written. This | is the default. 1.4.8 Output-SYSPRINT data set 1.4.8.3 FABHURG1 Unload Parameters report (Add the CHECKREC control statement in 'Figure 2. FABHURG1 Unload Parameters report') --------------------------------------------------------------- : UTILITY PARAMETERS USED FOR THIS EXECUTION ARE: REGION-TYPE=ULU PSBNAME=HDAMPART DBDNAME=HDAMPART PCB 1 FRMT *HD NO EXIT OFFS 0 ULEN 0 USEGMAX 0 DECY | CHECKREC NO --------------------------------------------------------------- ================================================================ 2.0 Customization and diagnosis 2.5 Setting site default options 2.5.2 Replacing the HSSR option table (FABHOPT) ____________________________________________________________ |Table 52. Options for which default values can be specified | |____________ ____________________________ __________________| | Keyword | Description | Related data set | |____________|____________________________|__________________| | : | : | : | |____________|____________________________|__________________| | URG1BUFNO | The default number of | N/A | | | buffers to be assigned to | | | | the DCBs for the output | | | | data sets to store the | | | | unloaded records. | | |____________|____________________________|__________________| | | URG1CHKRC | CHECKREC option for | SYSIN (for | | | | FABHURG1 (unload utility) | FABHURG1) | | |____________|____________________________|__________________| | FSUDEC | DEC option for FABHFSU | CARDIN (for | | | (unload utility) | FABHFSU) | |____________|____________________________|__________________| | : | : | : | 2.5.4 Coding the FABHTOPT macro ____________________________________________________________ | | | (label) FABHTOPT COMPAT= HPU|DBT|5787LAC | | : | | ,URG1BUFNO=nnn | | | ,URG1CHKRC=YES|NO | | ,FSUDEC=YES|NO | | : | |____________________________________________________________| Keyword Description COMPAT= This optional keyword specifies the basic setting of FABHTOPT. High Performance Unload provides three basic settings: HPU, DBT, and 5787LAC. The default basic setting is HPU. Table 53 shows the options to be set by the three basic settings: ____________________________________________________________ |Table 53. Basic settings of FABHTOPT options | |__________________ _________________________________________| | | COMPAT= | | |_____________ _____________ _____________| | Keyword | HPU | DBT | 5787LAC | |__________________|_____________|_____________|_____________| | : | : | : | : | |__________________|_____________|_____________|_____________| | URG1BUFNO= | defnum * | defnum * | defnum * | |__________________|_____________|_____________|_____________| | | URG1CHKRC= | NO | NO | NO | | |__________________|_____________|_____________|_____________| | FSUDEC= | YES | YES | YES | |__________________|_____________|_____________|_____________| | : | : | : | : | You can use the following keywords to override the values set by the basic settings: : : URG1BUFNO= This optional keyword specifies the default number of buffers to be assigned to the DCBs for ... | URG1CHKRC= This optional keyword specifies the default for | the CHECKREC option in SYSIN for the FABHURG1 | utility jobs. FSUDEC= This optional keyword specifies the default for the DEC option in CARDIN for the FABHFSU utility jobs. : : ================================================================ 4.0 Messages and Codes 4.4 Messages 4.4.2 Message Variables 4.4.2.1 FABH Messages (Add the following massages) --------------------------------------------------------------- |FABH0284E INCORRECT 'CHECKREC' OPTION |Explanation: An incorrect CHECKREC option is specified in SYSIN |data set. It must be either YES or NO. |System Action: FABHURG1 ends abnormally. |Programmer Response: Correct the error. --------------------------------------------------------------- |FABH2014E INCORRECT URG1CHKRC= PARAMETER IS SPECIFIED |Explanation: The value specified for the URG1CHKRC= keyword |parameter is incorrect. It must be either YES or NO. |System Action: The assembly of the option table ends with |return code 8. The option table is not replaced. |Programmer Response: Correct the error. --------------------------------------------------------------- ======================= End of Doc-Change ======================
APAR Information
APAR number
PK11534
Reported component name
IMS HIGHPERF UN
Reported component ID
5655E0600
Reported release
110
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-09-07
Closed date
2005-09-29
Last modified date
2005-10-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK07688
Modules/Macros
FABHDOPT FABHINI0 FABHOPT FABHTCB FABHTCBU FABHTGBL FABHTOPT FABHURG7 FABHURG8 FABHURG9 FABH000 HPSUFCB0 HPSUGTI0 HPSUHFCB HPSUHOUT HPSUSTMT HPSUURG7 HPSUURG8 HPSUURG9 HPSU015 HPSU015A
Fix information
Fixed component name
IMS HIGHPERF UN
Fixed component ID
5655E0600
Applicable component levels
R110 PSY UK07688
UP05/10/01 P F509
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":"110"}]
Document Information
Modified date:
20 October 2020