APAR status
Closed as new function.
Error description
Two issues: 1. The DEDB unloaded segment records file is generated by the FPA UNLOAD command. As the utility doesn't produce a DURDBDFN file, we must include a FABCUR5 step before the FABCUR7 step to create the UR7DBDFN file. FABCUR7 should accept the DMB member of the ACBLIB instead of the UR7DBDFN file. 2. The FPA RELOAD command doesn't need to use the DURDBDFN and DURSzzzO files. FABCUR6 generates these unnecessarily needed output files for FPA users. FABCUR6 will no longer generate the UR6DBDFN and DURSzzzO files if the DD statements for these files are not specified. These issues are implemented as a result of FITS requirement MR0811063020. This is a forward fit APAR of HPFPU V2R2 FPB APAR PK33272.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All DEDB Unload/Reload users of High * * Performance Fast Path Utilities FP Basic * * Tools Version 3 Release 1 (FMID: H31A310). * **************************************************************** * PROBLEM DESCRIPTION: Forward Fit APAR of HPFPU V2R2 PK33272. * * This APAR provides solutions for the * * following requirements for FPB DEDB * * FABCUR7/FABCUR6 (requirement number: * * MR0811063020): * * 1. FABCUR7 is allowed to specify ACBLIB * * DD or IMSACBA/IMACBB DD indicated by * * MODSTAT/MODSTAT2 DD instead of * * UR7DBDFN DD. * * 2. FABCUR6 is allowed to specify DUMMY * * on the UR6DBDFN/DURDzzzO/XDzzzzzO * * /DURDzzzE/XDzzzzzE/DURSzzzO * * /XSzzzzzO DD. It is also allowed not * * to specify these DD statements with * * a new control statement OUTDD=NO. * * 3. FABCUR6 site default macro FABCOP6M * * supports a new parameter OUTDD. * * 4. External macros(FABCOP6M and * * FABCOP9M) for FPB site default * * support had not been provided. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** Forward Fit APAR of HPFPU V2R2 PK33272. 1. ACBLIB DD or IMSACBA/IMACBB DD indicated by MODSTAT/MODSTAT2 DD is allowed to be specified instead of UR7DBDFN DD in the job step that includes a application that calls FABCUR7. ACBLIB DD or IMSACBA/IMACBB DD indicated by MODSTAT/MODSTAT2 DD has to be specified with a new control statement DBDNAME= that specifies the name of DEDB being processed. 2. The following DD statements in the job step that includes a application that calls FABCUR6 are allowed to be specified DUMMY. FABCUR6 is also allowed not to specify them with a new control statement OUTDD=NO option: UR6DBDFN DD: an output data set for the database definition record file generated by FABCUR6. DURDzzzO/XDzzzzzO: an output data set for all of the database segment record files generated by FABCUR6. DURDzzzE/XDzzzzzE: the second copy data set for DURDzzzO/XDzzzzzO. DURSzzzO/XSzzzzzO: an output data set that contains the SORT control statements for the segment data set associated with it. 3. FABCUR6 site default macro FABCOP6M supports a new parameter OUTDD. 4. External macros(FABCOP6M and FABCOP9M) for FPB site default support had not been provided.
Problem conclusion
Temporary fix
Comments
FABCUR7 (DEDB Unloaded Segment Data Set Retrieve utility) and FABCUR6 (DEDB Reload Segment Data Set Create utility) have been enhanced to suite to HPFP FPA UNLOAD/RELOAD tools. FPA RELOAD command function need not use DURDBDFN file and DURSzzzO sort file, so that FABCUR6 should be allowed not to specify UR6DBDFN DD and DURSzzzO/XSzzzzzO DD. FPA UNLOAD command function does not generate DURDBDFN file, so that FABCUR7 should be allowed to get DEDB definition information from ACBLIB DD instead of UR7DBDFN DD. FABCUR7X has been modified to prohibit specifying DUMMY against UR7PRINT DD. FABC7GCD has been modified to process a new control statement DBDNAME=. FABC7INI has been modified to get DEDB DMB from ACBLIB DD or IMSACBA/IMSACBB DD indicated by MODSTAT/MODSTAT2 DD instead of UR7DBDFN DD. FABC7BLK has been modified to add a DBDNAME save area in UR7CTL. FABC7MGT has been modified to add new message definitions. FABCUR6X has been modified to prohibit specifying DUMMY against UR6PRINT DD. FABC6GCD has been modified to process a new control statement OUTDD=. FABC6INI has been modified to handle DUMMY or not specification of FABCUR6 output files for OPEN processing. FABC6PUT has been modified to handle DUMMY or not specification of USR files for PUT processing. FABC6EOF has been modified to handle DUMMY or not specification of UR6DBDFN/SORT card files for PUT/CLOSE processing. FABC6BLK has been modified to add a OUTDD=YES|NO flag. FABC6MGT has been modified to add new message definitions. FABCOP6M has been modified to add a OUTDD parameter for FABCUR6 site default. FABCOP6M and FABCOP9M have been provided. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 2: Fast Path Basic Tools Version 3 Release 1 (SC18-9870-00) should be added and changed as follows: Chapter 16. DEDB Reload Segment Data Set Create utility - FABCUR6 Job control language (JCL) FABCUR6 is a called module. Table 36 shows the JCL DD statements required to be included in the job step: Table 36. FABCUR6 data sets +---------------+--------+-------------------+------------+ | DDNAME | Use | Format | Need | +---------------+--------+-------------------+------------+ | | UR6DBDFN | Output | Do not code DCB | Optional | +---------------+--------+-------------------+------------+ | | DURDzzz0 or | Output | Do not code DCB | Optional | | | XDzzzzz0 | | except BLKSIZE | | | | | | allowed | | +---------------+--------+-------------------+------------+ | | DURSzzzO or | Output | LRECL=80 | Optional | | | XSzzzzzO | | | | +---------------+--------+-------------------+------------+ UR6DBDFN DD Defines an output data set for the database definition record generated by FABCUR6. This contains the data extracted from the DMB that is used by the reload processor The data set must reside on a direct access device. Space requirements depend on the size of the DMB, but a two tracks are usually enough. Do not code DCB information in your JCL. | If OUTDD=NO is specified in UR6CTL DD,this DD does not | have to be provided. DURDzzzO or XDzzzzzO DD Defines an output data set for all of the database segment records produced for one or more of the areas defined in the DMB. The rules for supplying the DURDzzzO or the XDzzzzzO data sets are discussed in "FILECTL control statement". A DURDzzzO DD statement is for areas in the range from 1 to 999, and an XDzzzzzO DD statement is for areas in the range from 1 to 2048. If the area number of the unloaded area is greater than 999, you should provide the XDzzzzzO DD statement. The value of zzz or zzzzz is made up of right-justified digits, with leading zeros if needed. DCB attributes are calculated by FABCUR6. RECFM is VB, and the default block size is the maximum block size of the output device. A block size override may be specified on the DD statement. Do not code any other DCB parameters in your JCL. | If OUTDD=NO is specified in UR6CTL DD, this DD does not | have to be provided. DURSzzzO or XSzzzzzO DD Defines an output data set that contains the SORT control statement for the segment data set associated with it. There must be a DURSzzzO or XSzzzzzO data set for each DURDzzzO or XDzzzzzO data set. The data set must reside on a direct access device. This data set is required even if the corresponding DURDzzzO or XDzzzzzO dataset does not need to be sorted. A DURSzzzO DD statement is for area in the range from 1 to 999, and an XSzzzzzO DD statement is for areas in the range from 1 to 2048. If the area number of the unloaded area is greater than 999, you should provide the XSzzzzzO DD statement. The value of zzz or zzzzz is made up of right-justified digits, with leading zeros if needed. The space required is very small; one track suffices. The DCB information is hard-coded in FABCUR6. Do not code the DCB information in your JCL. | If OUTDD=NO is specified in UR6CTL DD, this DD does not | have to be provided. Input Control statements | OUTDD control statement | | The OUTDD statement specifies whether the DD statements for | output data sets are essential. | | +--------------------------------------------+ | | OUTDD={YES|NO} | | | --- | | +--------------------------------------------+ | | OUTDD= | This optional statement specifies whether the DD | statements for output data sets are essential. | | YES | Specifies that the DD statement for output data sets, | which is DURDzzzO,XDzzzzzO,DURSzzzO,XSzzzzzO, or | UR6DBDFN, is required. | This is the default value. | NO | Specifies that the DD statement for output data sets, | which is DURDzzzO,XDzzzzzO,DURSzzzO,XSzzzzzO, or | UR6DBDFN, is optional. ---------------------------------------------------------------- Chapter 17. DEDB Unloaded Segment Data Set Retrieve utility - FABCUR7 Job control language (JCL) | FABCUR7 is a called module. Table 39 shows the JCL DD statements required to be included in the job step: Table 39. FABCUR7 data sets +---------------+--------+-----------+------------+ | DDNAME | Use | Format | Need | +---------------+--------+-----------+------------+ | | ACBLIB | Input | PDS | Optional | | +---------------+--------+-----------+------------+ | | MODSTAT | Input | | Optional | | +---------------+--------+-----------+------------+ | | MODSTAT2 | Input | | Optional | | +---------------+--------+-----------+------------+ | | IMSACBA | Input | PDS | Optional | | +---------------+--------+-----------+------------+ | | IMSACBB | Input | PDS | Optional | +---------------+--------+-----------+------------+ | | UR7DBDFN | Input | | Optional | +---------------+--------+-----------+------------+ UR7DBDFN DD Defines a data set containing a formatted copy of a DMB. It is the DURDBDFN data set from FABCUR1. | Instead of the UR7DBDFN DD, you can specify ACBLIB DD | which define the ACB library containing the DMB. | ACBLIB DD | Defines the library containing the DMB for the database. | If UR7DBDFN DD is not specified, this DD must be provided. | If MODSTAT/MODSTAT2 DD is provided, this DD is not | necessary. | IMSACBA DD | Defines the library containing the DMB for the database. | If MODSTAT/MODSTAT2 DD is specified and if UR7DBDFN DD | is not specified, this DD must be provided. | IMSACBB DD | Defines the library containing the DMB for the database. | If MODSTAT/MODSTAT2 DD is specified and if UR7DBDFN DD | is not specified, this DD must be provided. | MODSTAT DD | Defines the MODSTAT data set. If this DD is specified, | the IMSACBA and IMSACBB DD must be specified instead of | the ACBLIB DD. | MODSTAT2 DD | Defines the MODSTAT2 data set. If this DD is specified, | the IMSACBA and IMSACBB DD must be specified instead of | the ACBLIB DD. Input Control statements | DBDNAME control statement | | The DBDNAME statement specifies the DBD name of the DEDB | for the unloaded segment records file. | There must be only one DBDNAME statement. | This statement is required if ACBLIB DD is specified | instead of UR7DBDFN DD. | If UR7DBDFN DD is specified, this statement is not | necessary. If specified, the UR7DBDFN file is validated | to make sure that the correct DURDBDFN file is provided. | | +--------------------------------------------+ | | DBDNAME=dbdname | | +--------------------------------------------+ | | DBDNAME= | This statement specifies the DEDB DBD name that is | used for: | | Validating the UR7DBDFN file. | Creating the Database Definition Record (DURDBDFN) | internally on the basis of a DEDB DMB when ACBLIB DD is | specified instead of UR7DBDFN DD. | | DBDNAME is an optional keyword. | | dbdname | Specifies the name of the DBD that is to be used. ---------------------------------------------------------------- Appendix O. FPB.Messages and codes FABC messages The following messages should be added as follows: | FABC0672E INVALID OUTDD= CONTROL CARD | - SYNTAX ERROR DETECTED | | Explanation: Self-explanatory. | System Action: Program FABCUR6 discards the control statement, | sets an internal error flag, and continues processing. | Programmer Response: See "Using FABCUR6" for details | on the syntax of the OUTDD control statement. | Correct the error, and rerun the job. ----------------------------------------------------------- | FABC0673E INVALID OUTDD= CONTROL CARD | - "OUTDD=" CONTROL CARD PREVIOUSLY SPECIFIED | | Explanation: Self-explanatory. | System Action: Program FABCUR6 discards the control statement, | sets an internal error flag, and continues processing. | Programmer Response: See "Using FABCUR6" for details | on the syntax of the OUTDD control statement. | Correct the error, and rerun the job. ----------------------------------------------------------- | FABC0717E INVALID DBDNAME= CONTROL CARD | - "DBDNAME=" CONTROL CARD PREVIOUSLY SPECIFIED | | Explanation: Self-explanatory. | System Action: Program FABCUR7 discards the control statement, | sets an internal error flag, and continues processing. | Programmer Response: See "Using FABCUR7" for details | on the syntax of the DBDNAME control statement. | Correct the error, and rerun the job. ----------------------------------------------------------- | FABC0718E INVALID DBDNAME= CONTROL CARD | - DBD NAME SPECIFIED TOO LONG | | Explanation: Self-explanatory. | System Action: Program FABCUR7 discards the control statement, | sets an internal error flag, and continues processing. | Programmer Response: See "Using FABCUR7" for details | on the syntax of the DBDNAME control statement. | Correct the error, and rerun the job. ----------------------------------------------------------- | FABC3834E DBDNAME CONTROL CARD/UR7DBDFN MISMATCH | CTL CARD DBDNAME xxxxxxxx | UR7DBDFN DBDNAME xxxxxxxx | | Explanation: Program FABCUR7 found that the DBD name specified | in the DBDNAME control statement and the one specified in the | UR7DBDFN DD data set do not match. | System action: FABCUR7 abends with a user code of 3890. | Programmer response: Check that the DBD name specified on the | DBDNAME control statement and the DBD name of the DURDBDFN | data set that is specified on the UR7DBDFN DD statement are | correct. Correct, if there are any errors, and rerun the job. The following messages should be changed as follows: FABC0659E - INVALID LRECL= CONTROL CARD | - "LRECL=" CONTROL CARD PREVIOUSLY SPECIFIED FABC0657E - INVALID AREA_INFORMATION_RECORD= CONTROL CARD | - "AREA_INFORMATION_RECORD=" CONTROL CARD | PREVIOUSLY SPECIFIED
APAR Information
APAR number
PK36966
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2007-01-05
Closed date
2007-01-15
Last modified date
2007-02-02
APAR is sysrouted FROM one or more of the following:
PK33272
APAR is sysrouted TO one or more of the following:
Modules/Macros
FABALINK FABCGDD FABCMDS0 FABCOP6J FABCOP6M FABCOP9M FABCUR6X FABCUR7X FABC6BLK FABC6EOF FABC6GCD FABC6INI FABC6MGT FABC6PUT FABC7AUD FABC7BLK FABC7EOF FABC7GCD FABC7GET FABC7INI FABC7MGT H31A310J UR67DCCI
| SC18987000 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R310 PSY UK21251
UP07/01/19 P F701
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 February 2007