A fix is available
APAR status
Closed as new function.
Error description
IPR Unload Utility supports IBM IMS Tools Knowledge Base for z/OS.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS High Performance Unload for * * z/OS Version 1 Release 2 (FMID=H1IN120) * * who use IMS Parallel Reorganization for z/OS * * Version 3 Release 2 (FMID=H25N320). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables IPR Unload utility * * to store the statistics reports * * to the Output repository of * * IMS Tools Knowledge Base for z/OS. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables the IPR Unload utility to store several reports to the Output repository of IMS Tools Knowledge Base for z/OS. To add the new options to the installation default option table, APAR PK57505 for IMS Parallel Reorganization for z/OS Version 3 Release 2 is required.
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IBM IMS Parallel Reorganization for z/OS User's Guide (SC18-9228-03) should be changed as follows: ================================================================ 1.0 IMS Parallel Reorganization overview 1.3 Major features and benefits 1.3.6 Support for IMS Tools Knowledge Base : | The Output repository is supported by IPR Driver, IPR Unload | utility, and IPR Reload utility. | For the details, see "2.7.8.19 ITKBSRVR control statement", | "3.1.x Supporting IMS Tools Knowledge Base", and | "4.1.x Support for IMS Tools Knowledge Base ================================================================ 3.0 The IPR Unload utility 3.1 Program functions |3.1.6a Supporting IMS Tools Knowledge Base | | Several IPR Unload reports can be stored in the IMS Tools | Knowledge Base repository using by the ITKBSRVR=serverName | control statement. For details, see "3.8.3.x ITKBSRVR control | statement". For that, you need to set up the environment | with the following steps : | 1. Install the IBM IMS Tools Knowledge Base product. | 2. Set up an IMS Tools KB server. | 3. Add IMS High Performance Unload to the registry of | the IMS Tools KB server. | 4. If needed, register the RECON. | 5. Confirm that IMS Tools KB server is properly | initialized before you run IPR Reload utility jobs. | | For detailed procedures, see IMS Tools Knowledge Base for | z/OS User's Guide. ================================================================ 3.7 JCL requirements 3.7.2 DD statements STEPLIB DD Points to the following libraries: : - The library that contains DFSMDA members for dynamic allocation of data sets (optional). If you specify this library on the IMSDALIB DD statement, it is highly recommended that you remove the library from the STEPLIB concatenation. | - IMS Tools Knowledge Base load module library (optional). | If ITKBSRVR=svrName is specified and ITKBLOAD=libName is | not specified, this library is needed. : ================================================================ 3.8 Control statements 3.8.3 Control statements for unload function (The new control statements, ITKBLOAD and ITKBSRVR are added.) Table 18. Control statements for unload function +-----------+---------------+--------+-----------------------+ |Keyword |Acceptable |Default | Description | | | Values | | | +-----------+---------------+--------+-----------------------+ : : : : : +-----------+---------------+--------+-----------------------+ | |ITKBLOAD |lib_name or |*NO |Specifies the library | | | | *NO | |name of IMS Tools KB. | | | | | |See "ITKBLOAD control | | | | | |statement" | | +-----------+---------------+--------+-----------------------+ | |ITKBSRVR |server_name or |*NO |Specifies the name of | | | |*NO | |the IMS Tools KB | | | | | |server. | | | | | |See "ITKBSRVR control | | | | | |statement" | | +-----------+---------------+--------+-----------------------+ : : : : : ================================================================ |3.8.3.6a ITKBLOAD control statement | | ITKBLOAD specifies the name of the load module library for | IMS Tools Knowledge Base. | This control statement is used only when ITKBSRVR=serverName | is specified. If you do not explicitly specify this control | statement, ITKBLOAD=*NO will be used and IPR Unload utility | attempts to load an IMS Tools KB module from the STEPLIB | libraries. | +-------------------------------------------------------+ | | __ *NO ___ | | | >>__ITKBLOAD=_____|__libName__|___________________>< | | | | | +-------------------------------------------------------+ | *NO | The IMS Tools KB modules are loaded from the private | library or the system library of the job. | libName | specifies the name of the IMS Tools KB load module data set | that is to be used by the IPR Unload utility. | | Notes: | 1. When all the STEPLIB libraries are APF-authorized, | this library also needs to be APF-authorized. | 2. You can add this option to the installation default | option table. For details, see "Setting installation | default options" in topic 6.0. ================================================================ |3.8.3.6b ITKBSRVR control statement | | ITKBSRVR specifies the name of the IMS Tools KB server. | This control statement is optional. If you do not explicitly | specify this control statement, ITKBSRVR=*NO will be used. | +-------------------------------------------------------+ | | __ *NO _______ | | | >>__ITKBSRVR=_____|__serverName__|_________________>< | | | | | +-------------------------------------------------------+ | *NO | IPR Unload utility does not store reports in the IMS Tool | KB Output repository. | | serverName | IPR Unload utility stores several reports in | the IMS Tools KB Output repository of the specified server. | | If ITKBSRVR=serverName is specified, IPR Unload utility | attempts to connect to the server and then to store the | following reports in the Output repository of IMS Tools | Knowledge Base: | - Environment | - HPSIN Control Statements | - DBD Summary | - HALDB Partitions Processed | - Segment Count Summary | - Segment Statistics | - HDAM Root Addressable Area Statistics | - HDAM RAP Chain I/O Summary report | - Distribution of Database Record Sizes | - HISAM Statistics | - Data Set Statistics | - HALDB Partition Definition | - Largest Database Records report | Several reports are not produced if STATREP=NO is specified. | For details, see "STATREP control statements." | | Notes: | 1. ITKBSRVR=serverName requires that an appropriate version | of IMS Tools Knowledge Base is installed and the server | is started. For the details, see "Software requirements" | in topic 1.2.1 and "Supporting IMS Tools Knowledge Base" | in topic 3.1.x. | 2. You can add this option to the installation default option | table. For details, see "Setting installation default | options" in topic 6.0. ================================================================ 6.0 Setting installation default options 6.4 How to code HPSCOPT macro statements : The general syntax of the HPSCOPT macro statement is as follows: >>__HPSCOPT __........ | | _|,C|_ _|,J|_ _|,N|_ _|,O|_ | | |_UNLOAD_|______|_.._|______|_|______|_|______|_| : N: _*NO_____ |__ITKBLOAD=__|_libName_|_______________________________| O: _*NO________ |__ITKBSRVR=__|_serverName_|____________________________| : - UNLOAD identifies the IPR Unload utility | - DECODEDBD, PARTINFO, STATREP, CHECKREC, ITKBLOAD, | and ITKBSRVR for the unload utility - APISET and PCBLIST for API function : ================================================================ 10.0 Messages and codes 10.1.2 The IPR Unload return codes (In Table 56, the reason code X'0080' for RC=04 is added.) | X'0080' : One or more error occur in the ITKB Output | Repository processing. ================================================================ 10.3 Messages 10.3.5 HPSU messages ---------------------------------------------------------------- |HPSU3551I OUTPUT REPOSITORY PROCESSING IS TERMINATED |Explanation: This is an information message showing that |the connection to IMS Tools KB Output Repository is terminated. |System Action: The IPR Unload continues processing. |Programmer Response: None ---------------------------------------------------------------- |HPSU3555W GETMAIN FAILED FOR ITKB TEMPORARY WORK STORAGE |Explanation: An error occurred in the GETMAIN macro to store |reports in temporary. |System Action: The IPR Unload continues processing. Some of |reports will not be stored in the IMS Tools KB Output |repository. |Programmer Response: Make sure that sufficient virtual storage |is available. ---------------------------------------------------------------- |HPSU3556I APF AUTHORIZATION CHECK FAILED (DD: ddname, | REASON: nn) (See the explanation of HPSG0117I.) ---------------------------------------------------------------- |HPSU3561W THE ACCESS TO OUTPUT REPOSITORY WAS CANCELED. | REASON: reason (See the explanation of HPSG2211W.) ---------------------------------------------------------------- |HPSU3562W ERROR OCCURRED IN ACCESSING OUTPUT REPOSITORY | FUNC: function RC: rc RSN: rsn (See the explanation of HPSG2212W.) ---------------------------------------------------------------- |HPSU3563W ERROR OCCURRED IN ACCESSING OUTPUT REPOSITORY | FUNC: function RC: rc RSN: rsn (See the explanation of HPSG2213W.) ---------------------------------------------------------------- |HPSU3564W DBD:dbdname PART:partname REPORT:report-name (See the explanation of HPSG2214W.) ---------------------------------------------------------------- |HPSU3570W RECON ENTRY WAS NOT FOUND IN ITKB (See the explanation of HPSG2220W.) ---------------------------------------------------------------- |HPSU3571W ITKB SERVER NAME WAS INCORRECT (See the explanation of HPSG2221W.) ---------------------------------------------------------------- |HPSU3572W THE PRODUCT HP UNLOAD WAS NOT DEFINED IN ITKB |Explanation: IMS High Performance Unload (HP Unload) was not |defined in the IMS Tools Knowledge Base information management |environment as a product that can store reports to the IMS |Tools KB Output repository. |System Action: Processing continues, but no reports produced |by HP Unload are stored to the IMS Tools KB Output repository. |Programmer Response: If you want to store reports to the IMS |Tools KB Output repository, register the High Performance |Unload product by the IMS Tools KB product administration |utility. For the details, see IMS Tools Knowledge Base User's |Guide. ---------------------------------------------------------------- |HPSU3573W THE REPORT WAS NOT DEFINED IN ITKB (See the explanation of HPSG2223W.) ================================================================
APAR Information
APAR number
PK57504
Reported component name
IMS HIGHPERF UN
Reported component ID
5655E0600
Reported release
120
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2007-12-03
Closed date
2007-12-18
Last modified date
2011-01-28
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK32443
Modules/Macros
FABHLINK FABHRTI0 FABHTCB FABHTCBU FABH001 FABH060 HPSCCPYR HPSCOPTD HPSCRPTH HPSCRR07 HPSUAPF0 HPSUFCB0 HPSUGITB HPSUGITD HPSUGIT0 HPSUGVT0 HPSUHFCB HPSUHTBL HPSUIT10 HPSUIT20 HPSUMAIN HPSUMSGS HPSUMSGT HPSURPTH HPSURR07 HPSUSTMT HPSUTE00 HPSU015 HPSU015A H1IN120J
Fix information
Fixed component name
IMS HIGHPERF UN
Fixed component ID
5655E0600
Applicable component levels
R120 PSY UK32443
UP07/12/27 P F712
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":"1.2.0"}]
Document Information
Modified date:
20 October 2020