A fix is available
APAR status
Closed as new function.
Error description
This APAR enables IPR Unload Utility to run with the JCL for IMS HD Reorganization Unload Utility (DFSURGU0).
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users IMS Parallel Reorganization * * for z/OS Version 3 Release 2 (FMID=H25N320) * * who are to run IPR Unload utility * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables the IPR Unload * * utility to run by JCL that is written * * for IMS HD Reorganization Unload * * (DFSURGU0). * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables the IPR Unload utility to run by JCL that is written for IMS HD Reorganization Unload (DFSURGU0) to run the IPR Unload utility. To use the new function, APAR PK59509 for IMS High Performance Unload for z/OS, Version 1 Release 2 (FMID=H1IN120) is required. How to use the new function is described in the "3.7.3.1 Steps to run the JCL for IMS HD Reorganization Unload" in the documentation change below.
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: ================================================================ 3.0 The IPR Unload utility 3.7 JCL requirements |3.7.3 Using JCL for IMS HD Reorganization Unload | | You can use a JCL that is written for IMS HD Reorganization | Unload (DFSURGU0) to run the IPR Unload utility. ================================================================ |3.7.3.1 Steps to run the JCL for IMS HD Reorganization Unload | |To use a JCL that is written for IMS HD Reorganization |Unload (DFSURGU0), you need to do the following steps: | | Step 1. Put the DFSISVI0 module in STEPLIB | Create a copy of the load module FABHSVI0 as the name | DFSISVI0 in a library concatenated to STEPLIB DD. | FABHSVI0 is a member of the IMS High Performance Unload | load module library. | | Step 2. Modify the Installation Default Option Table | (HPSCOPTI) | Add the JCLTYPE=DFS option in the Installation Default | Option Table (HPSCOPTI) as below. | HPSCOPT START | HPSCOPT UNLOAD,JCLTYPE=DFS | HPSCOPT END | If the system default DECOMPRESS=NO is not acceptable, | add the DECOMPRESS=YES option here. You can add the other | options to change the system default. | For details, see "6.0 Setting installation default options", | and "3.8.3.5 DECOMPRESS control statement". | | Step 3. Modify an unload JCL | In an unload JCL stream, modify the STEPLIB DD statement | so that the load module libraries of IMS Parallel | Reorganization and IMS High Performance Unload. | If you want to use the optional functions of the IPR Unload | utility, add the HPSIN DD statement and control statements | listed in the "3.8 Control statements". | For the sample JCL stream, see "3.11.4 Example 4: Unloading | using JCL for IMS HD Reorganization Unload". | | Step 4. Run the unload JCL | Submit the unload JCL stream. If the above steps are done | correctly, the IPR Unload utility is invoked from the | the DFSISVI0 exit and the HPSU3003I message is shown. | When the JCLTYPE=DFS option or the HPSIN DD statement is not | found, the FABHURG1 unload utility may be invoked. | ================================================================ |3.7.3.2 EXEC statement and DD statements | | For the sample of JCL streams, see "3.11.4 Example 4: | Unloading using JCL for IMS HD Reorganization Unload". | | EXEC statement | The parameters ULU and DFSURGU0 must be specified. | | DD statements | STEPLIB DD | Add the SHPSLMD0 libraries of IMS Parallel Reorganization | and IMS High Performance Unload to this DD statements. | The DFSISVI0 member must be placed in a library. | SYSIN DD | This optional statement defines the input control | statement data set for IMS HD Reorganization Unload | (DFSURGU0). | HPSIN DD | This optional statement defines the input control | statement data set for the IPR Unload utility. | For details, see "Control statements" in topic 3.8. | SYSPRINT DD | This required statement defines the main output data set | for reports and statistics instead of HPSOUT DD. | DFSURGU1 DD | This required statement defines the primary output data | set instead of SYSUT2 DD. | DFSURGU2 DD | This optional statement defines the secondary output data | set instead of SYSUT3 DD. | database DD | The DD statements for database data sets are optional. | If the DD statements are not present for a non-partitioned | database, dynamic allocation will be done by using | the DFSMDA member if one is present in STEPLIB or IMSDALIB. | | For the other optional data set, see "3.7.2 DD statements". | | Note: The DFSUCKPT DD statement and the DFSURSRT DD statement | are not supported. | ================================================================ |3.7.3.3 Restrictions | |- The restrictions in listed in "3.3 Restrictions" apply | to this processing. |- Media manager is not used to read VSAM database data sets | even if all concatenations of the JOBLIB/STEPLIB are | APF-authorized. |- The following functions of IMS HD Reorganization unload | (DFSURGU0) is not supported. | - DFSUCKPT DD for checkpoint function | - DFSURSRT DD for restart function | - IMS SB (sequential buffering) |- If MIGRATE or FALLBACK is specified in the SYSIN data set, | the FABHURG1 unload utility of IMS High Performance Unload | will be invoked instead of the IPR Unload utility. |- As system default, the compressed segment data is written | to the unload data set without expanding it. If the system | default is not acceptable, use the DECOMPRESS=YES option. | For the details, see "3.8.3.5 DECOMPRESS control statement". ================================================================ 3.8.3.5 DECOMPRESS control statement : | Note: The default value of the DECOMPRESS control statement | can be changed. For details, see "6.6 Setting installation | default options". ================================================================ |3.11.4 Example 4: Unloading using JCL for IMS HD | Reorganization Unload | | You can use a JCL that is written for IMS HD Reorganization | Unload (DFSURGU0) to run the IPR Unload utility. | For the details, see "Using JCL for IMS HD Reorganization | Unload." | | Figure XX shows an example of a JCL stream. | | //UNLOAD EXEC PGM=DFSRRC00,PARM='ULU,DFSURGU0,DBSAMP04' | //STEPLIB DD DSN=IPR.SHPSLMD0,DISP=SHR IPR library | // DD DSN=HPU.SHPSLMD0,DISP=SHR HP Unload library | // DD DSN=IMS.SDFSRESL,DISP=SHR | // DD DSN=USER.MDALIB,DISP=SHR | // DD DSN=USER.PGMLIB,DISP=SHR | //SYSPRINT DD SYSOUT=A | //SYSUDUMP DD SYSOUT=A | //DFSRESLB DD DSN=IMS.SDFSRESL,DISP=SHR | //IMS DD DSN=IMS.DBDLIB,DISP=SHR | //DFSURGU1 DD DSN=DBSAMP04.UNLOAD,DISP=(NEW,PASS) | // SPACE=(CYL,(20,10)) | //HPSIN DD * | DECOMPRESS=YES | OUTPUT=,,(MYEXIT1,B) | /* | Figure XX. Sample JCL stream based on the JCL for IMS HD | Reorganization Unload | | In this example, the OUTPUT control statement is coded | in the HPSIN DD data set to use a Type-B user exit routine. | Because the user exit refers to the segment data, | the DECOMPRESS=YES control statement is also coded to expand | the compressed segment data. | If DECOMPRESS=YES is already specified in the Installation | Default Option Table (HPSCOPTI), the option is not needed | here. | If any optional functions are not used, the HPSIN DD statement | is not needed. ================================================================ 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|_ _|,O|_ _|,S|_ _|,T|_ | | |_UNLOAD_|______|_.._|______|_|______|_|______|_| : S: _ NO_____ |__DECOMPRESS=__|_YES _|_______________________________| T: |__JCLTYPE=___DFS________________________________________| : - UNLOAD identifies the IPR Unload utility | - DECODEDBD, PARTINFO, STATREP, CHECKREC, ITKBLOAD, ITKBSRVR, DECOMPRESS, and JCLTYPE for the unload utility | For details of the JCLTYPE option, see "3.7.3.1 Steps to | run the JCL for IMS HD Reorganization Unload". - APISET and PCBLIST for API function : ================================================================ 10.0 Messages and codes 10.3.5 HPSU messages ---------------------------------------------------------------- | HPSU3003I DFSISVI0 EXIT IS CALLED AND IPR UNLOAD UTILITY IS | BEING INVOKED | Explanation: This message notifies the user that the IMS exit | DFSISVI0 is called, and the IPR Unload utility will be | invoked by IMS batch region controller as the unload program. | System Action: IMS continues processing. Unload function is | provided by the IPR Unload utility. | Programmer Response: None. ---------------------------------------------------------------- | HPSU3004I DFSISVI0 EXIT IS CALLED BUT IPR UNLOAD UTILITY | CANNOT BE INVOKED | Explanation: This message notifies the user that the IMS exit | DFSISVI0 is called but the IPR Unload utility cannot be | invoked because of one of the following reasons: | - DFSUCKPT DD or DFSURSRT DD is coded | - An unknown option other than PARTITION, MIGRATE, and | FALLBACK is coded in the SYSIN data set. | System Action: IMS continues the processing and IMS HD unload | utility (DFSURGU0) will be invoked. | Programmer Response: None. ---------------------------------------------------------------- | HPSU3110E IPR IS NOT INSTALLED OR NOT IN REQUIRED LEVEL | Explanation: To run the IPR Unload utility by the JCL | for IMS HD Reorganization Unload (DFSURGU0), the library of | IMS Parallel Reorganization V3.2 or later is required. | However, it is not found or the maintenance level is not | enough. | System Action: The IPR Unload ends abnormally. | Programmer Response: Install IPR or apply the required | maintenance to IPR. ================================================================
APAR Information
APAR number
PK59511
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2008-01-17
Closed date
2008-02-21
Last modified date
2008-03-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK33930
Modules/Macros
HPSCOPT HPSCOPTD HPSCOPTS HPSGOPTU
| SC18922803 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R320 PSY UK33930
UP08/02/23 P F802
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"320","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023