A fix is available
APAR status
Closed as new function.
Error description
The CHKTRAIL control statement and the installation default options are provided. The CHKTRAIL statement is provided in order to select the behavior when the trailer record is not found in the *HD or *SH format of the unload data set.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM IMS High Performance Load * * for z/OS Version 2 Release 1 (FMID=H1IM210) * **************************************************************** * PROBLEM DESCRIPTION: The CHKTRAIL statement and installation * * default options are provided. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the following new functions: 1. CHKTRAIL control statement is provided to select the behavior of HP Load when a trailer record is not found in the unload data set. If you have not applied PK64733 for the purpose of receiving RC=16 in case of missing trailer record, apply this APAR and specify CHKTRAIL=YES,ERROR. If you do not want to change your JCL, specify the statement as the installation default. 2. Installation default option is provided for the following control statements: CHKTRAIL, CHKUPDT, HPIO, ILDSBLD, OADSPR, PARTINIT, and WF1REC This APAR also fixes the following problem: If LRECL of VSAM DBDS is not large enough to store the maximum size of segment, HP Load ends without error, even though the reloaded database cannot be used. This APAR makes HP Load to ABEND and issue an error message in such a situation.
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IMS High Performance Load for z/OS Version 2 Release 1 User's Guide SC18-9222-03 ( SC18922203 ) should be changed as follows: ================================================================ (The following section should be added.) 2.2.3.x CHKTRAIL control statement Specifies whether to check if a trailer record exists in the *HD or *SH format of the unload data set. This control statement is optional. If you do not explicitly specify this control statement, CHKTRAIL=YES,WARN will be used. __________________________________________________________ | | | _,WARN__ | | _YES_|_,ERROR_|_ | | >>__CHKTRAIL=__|_NO_____________|_____________________>< | | | |__________________________________________________________| YES Specifies that the existence of the trailer record is checked. WARN Specifies IMS HP Load to continue processing, setting the job step return code to 4 when a trailer record is not found in the unload data set. If you specify only CHKTRAIL=YES, CHKTRAIL=YES,WARN is assumed. ERROR Specifies IMS HP Load to end with return code 16 when a trailer record is not found in the unload data set. NO Specifies that the existence of trailer record not be checked. IMS HP Load will continue processing even if a trailer record does not exist in the unload data set. Note: The default value of the CHKTRAIL control statement can be changed. For details, see "Setting installation default options" in topic X.0. (The following section should be added.) X.0 Setting installation default option You can change the default values for some options by creating an Installation Default Option Table (HPSROPTI) for your site. This chapter contains product-sensitive programming interface information. To understand the restrictions associated with this type of material, see "Programming interface" in topic APPENDIX_1.4.1. Subtopics: - X.1 How run-time options are determined - X.2 Creating an Installation Default Option Table (HPSROPTI) - X.3 HPSROPTG sample JCL stream - X.4 How to code HPSROPT macro statements (The following section should be added.) X.1 How run-time options are determined ---------- Product-sensitive programming interface ------------- Figure XXX illustrates how the values of the run-time options are determined. The sources that determine those values are placed in order of priority; that is, an option in a higher position in the figure overrides one in a lower position. +------------------------------------------------------+ | Run-time options values | +------------------------------------------------------+ A A A | | | +-------------------------------------+ | | | Parameter values specified in FRRIN | | | +-------------------------------------+ | | A | | | | | +----------------------------------------------+ | | Installation Default Option Table (HPSROPTI) | | +----------------------------------------------+ | A | | | +------------------------------------------------------+ | System Default Option Table (HPSROPTS) | +------------------------------------------------------+ Figure XXX. How run-time options are determined |-------- End of Product-sensitive programming interface ------| (The following section should be added.) X.2 Creating an Installation Default Option Table (HPSROPTI) ---------- Product-sensitive programming interface ------------- You can create an Installation Default Option Table (HPSROPTI) to change the default values of some options. If you link-edit HPSROPTI to your IMS HP Load load module library, the default values specified in HPSROPTI apply to all IMS HP Load jobs that use the library. To do this, the following steps are required: 1. Copy the sample JCL stream HPSROPTG from the sample library. (see "HPSROPTG sample JCL stream" in topic X.3). 2. Modify the HPSROPT macro statements in the copied JCL stream. (see "How to code HPSROPT macro statements" in topic X.4). 3. Submit the JCL stream to assemble the HPSROPT macro statements and link-edit the module HPSROPTI into the IMS HP Load load module library or a user library. The options that can be changed by creating an HPSROPTI are described in "How to code HPSROPT macro statements" in topic X.4. |-------- End of Product-sensitive programming interface ------| (The following section should be added.) X.3 HPSROPTG sample JCL stream ---------- Product-sensitive programming interface ------------- You can use the JCL stream HPSROPTG as a sample when you create your HPSROPTI. HPSROPTG is provided as a member of the HPS.SHPSSAMP library. It assembles the user-specified HPSROPT macro statements and link-edits the output of the assembly into the HPS.SHPSLMD0 load module library to build the module HPSROPTI. |-------- End of Product-sensitive programming interface ------| X.4 How to code HPSROPT macro statements ---------- Product-sensitive programming interface ------------- The installation default options are specified by coding a set of HPSROPT macro statements. These statements are assembler language macro instructions and therefore are subject to the rules contained in the High Level Assembler Programmer's Guide. The general syntax of the HPSROPT macro statement is as follows: _____________________________________________________________ | | | >>__HPSROPT__ _START______ ______________________________>< | | |_END________| | | |_RELOAD_____| | | | |_____________________________________________________________| _____________________________________________________________ | | | RELOAD: | | <_,_____________________________________________ | | |_RELOAD_ _____________________________________________ |__|| | |_ ________________________________________ __| | | | | _WARN__ | | | | | | _(_YES__,__|_ERROR_|__)__ | | | | | |_CHKTRAIL=__|_NO______________________|_| | | | |_ _______________________________________ ___| | | | | _NO______________________ | | | | | | | _ABEND_ | | | | | | |_CHKUPDT=__|_(_YES__,__|_WARN__|__)__|_| | | | |_ ________________ __________________________| | | | |_HPIO=__ _NO__ _| | | | | |_YES_| | | | |_ __________________________ ________________| | | | | _C__________ | | | | | |_ILDSBLD=__|_YES________|_| | | | | |_(YES,DSPR)_| | | | | |_NO_________| | | | |_ __________________ ________________________| | | | | _NO__ | | | | | |_OADSPR=__|_YES_|_| | | | |_ _______________________________________ ___| | | | | _NO_____________________ | | | | | | | _,PINITON_ | | | | | | |_PARTINIT=__|_(_YES__|__________|__)_|_| | | | | |_,UNLOAD__| | | | |_ __________________ ________________________| | | | _YES_ | | | |_WF1REC=__|_NO__|_| | | | |_____________________________________________________________| You must specify a set of HPSROPT macro statements in the following sequence: 1. An HPSROPT macro statement specifying START as the first positional parameter. 2. An HPSROPT macro statement specifying RELOAD as the first positional parameter, plus keywords and their parameters. 3. An HPSROPT macro statement specifying END as the first positional parameter. The option keywords supported for the RELOAD parameter are as follows: - CHKTRAIL, CHKUPDT, HPIO, ILDSBLD, OADSPR, PARTINIT, and WF1REC. Example : When using the following HPSROPT macros, change the default value as follows: - Change the default value of the CHKTRAIL option to (YES,ERROR). - Change the default value of the OADSPR option to YES. HPSROPT START HPSROPT RELOAD,CHKTRAIL=(YES,ERROR),OADSPR=YES HPSROPT END |-------- End of Product-sensitive programming interface ------| APPENDIX1.3.3.1 High Performance Load messages HPSR0038I INSTALLATION DEFAULT OPTIONS TABLE HPSROPTI (LV.nn) IS FOUND Explanation: The installation default options table (HPSROPTI) is found. HPSROPTI was generated with the HPSROPT macro of level nn. The default values in this table override the values in the system default option table (HPSROPTS). System Action: IMS HP Load continues processing. Programmer Response: None. Problem Determination: None. HPSR3678E THE RECORD SIZE IS NOT LARGE ENOUGH TO CONTAIN THE LONGEST SEGMENT. DDN:ddname Explanation: The record size for the database data set is not large enough to contain the longest segment in the database plus the IMS overhead required. System Action: IMS HP Load issues a user 3678 abend and a dump. Programmer Response: Correct the record size of the database data set. The recommended record size is provided in the output listing of DBD generation. Problem Determination: None. HPSR3679E OVERFLOW RECORD SIZE CANNOT BE LESS THAN PRIME RECORD SIZE. Explanation: Logical record lengths in the overflow data set must be equal to or greater than the logical record length in the primary data set. System Action: IMS HP Load issues a user 3679 abend and a dump. Programmer Response: Correct the logical record lengths of database data sets. Problem Determination: None. ==================== END OF DOC-CHANGE ========================= ž**** PE10/05/24 FIX IN ERROR. SEE APAR PM13853 FOR DESCRIPTION ž**** PE15/11/09 FIX IN ERROR. SEE APAR PI52163 FOR DESCRIPTION
APAR Information
APAR number
PK88818
Reported component name
IMS HIGH PERF L
Reported component ID
5655E0700
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-06-12
Closed date
2009-08-03
Last modified date
2015-12-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK48947
Modules/Macros
BBESAPI BBESGLBL BBESREGC FABFLINK HPSCOPTD HPSCRR01 HPSCZRIO HPSRAA00 HPSRAC0A HPSRAC0B HPSRAC07 HPSRAC08 HPSRAC09 HPSRAI00 HPSRAL00 HPSRANRA HPSRANRB HPSRANR7 HPSRANR8 HPSRANR9 HPSRAP0A HPSRAP0B HPSRAP07 HPSRAP08 HPSRAP09 HPSRAS00 HPSRAT00 HPSRAULA HPSRAULB HPSRAUL7 HPSRAUL8 HPSRAUL9 HPSRBFRM HPSRBITM HPSRCILA HPSRCILB HPSRCIL7 HPSRCIL8 HPSRCIL9 HPSRCMPA HPSRCMPB HPSRCMP7 HPSRCMP8 HPSRCMP9 HPSRCVUH HPSRDBSI HPSRDHDR HPSRDSCT HPSRDSPC HPSRE15A HPSRE35A HPSRFCA0 HPSRGTI0 HPSRGVT0 HPSRHALA HPSRHALB HPSRHAL7 HPSRHAL8 HPSRHAL9 HPSRHDBA HPSRHDBB HPSRHDB7 HPSRHDB8 HPSRHDB9 HPSRHDLA HPSRHDLB HPSRHDLD HPSRHDL7 HPSRHDL8 HPSRHDL9 HPSRHIDA HPSRHIDB HPSRHID7 HPSRHID8 HPSRHID9 HPSRHRPA HPSRHRPB HPSRHRP7 HPSRHRP8 HPSRHRP9 HPSRHSLA HPSRHSLB HPSRHSLD HPSRHSL7 HPSRHSL8 HPSRHSL9 HPSRHTBL HPSRIT10 HPSRIT20 HPSRLGSA HPSRLGSB HPSRLGS7 HPSRLGS8 HPSRLGS9 HPSRMAIN HPSRMSGT HPSRNDBA HPSRNDBB HPSRNDB7 HPSRNDB8 HPSRNDB9 HPSROPT HPSROPTA HPSROPTG HPSROPTS HPSROSAM HPSROVIO HPSRPC00 HPSRPDBA HPSRPDBB HPSRPDBD HPSRPDB7 HPSRPDB8 HPSRPDB9 HPSRPIDA HPSRPIDB HPSRPID7 HPSRPID8 HPSRPID9 HPSRPI00 HPSRPTRA HPSRPTRB HPSRPTR7 HPSRPTR8 HPSRPTR9 HPSRRCBM HPSRRC00 HPSRRIO0 HPSRRLDA HPSRRLDB HPSRRLDM HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRPRA HPSRRPRB HPSRRPR7 HPSRRPR8 HPSRRPR9 HPSRRRIN HPSRRRI0 HPSRRRI9 HPSRRR01 HPSRRTI0 HPSRRXRT HPSRRXST HPSRSQEA HPSRSQEB HPSRSQE7 HPSRSQE8 HPSRSQE9 HPSRSRT0 HPSRSTMT HPSRTE00 HPSRTRCA HPSRTRCB HPSRTRC7 HPSRTRC8 HPSRTRC9 HPSRVSAM H1IM210J
| SC18922203 |
Fix information
Fixed component name
IMS HIGH PERF L
Fixed component ID
5655E0700
Applicable component levels
R210 PSY UK48947
UP09/08/06 P F908
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":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89F","label":"IMS HP Load"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2015