A fix is available
APAR status
Closed as program error.
Error description
HPIC compression routine returns Msg FABJ9008E ( MSGFABJ9008 ) for SDEP CI and IC process fails because compression routine mishandles SDEP CI. With this APAR, SDEP CI will not be compressed.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 3 Release 1 users ( FMID=H1J0310 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR fixes following problems: * * 1. HPIC V3R1 Image Copy function issues * * FABJ9008E ( MSGFABJ9008E ) for an * * SDEP CI and terminates ABEND U3933 * * ( ABENDU3933 ), when the input DEDB * * has SDEP segments and COMP=Y is * * specified in the ICEIN statement. * * This APAR provides a new compression * * routine FABJCMP4 that compresses all * * blocks in the database. * * * * 2. HPIC V3R1 Create Image Copy function * * compress a bitmap block of HALDB, * * when CRCTYPE=L and COMP=Y are * * specified in the ICEIN statement. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** HPIC V3R1 Image Copy function issues FABJ9008E ( MSGFABJ9008E ) for an SDEP CI and terminates ABEND U3933 ( ABENDU3933 ), when the input database is DEDB that has some SDEP segments and COMP=Y is specified in the ICEIN statement. Because HPIC regards the prefix of SDEP CI as the FSEAP and mishandles compress process as an error. HPIC V3R1 provides a new compression routine FABJCMP4. The new compression routine does repeating-characters compression of the z/OS program compression method. This routine does the block compress that does not distinguish between a data portion, free space, and unused space in the database. ***************************************************** ***** ATTENTION ***** ATTENTION ***** ATTENTION ***** ***************************************************** ** When you want to create an compressed image ** ** copy data set for DEDB that has an SDEP segment,** ** you MUST USE FABJCMP4. ** ** ** ** FABJCMP1, FABCMP2, and FABJCMP3 CAN NOT use ** ** DEDB that has an SDEP segment. ** ***************************************************** HPIC V3R1 Create Image Copy function compresses a bitmap block in 2nd CI of HALDB, when CRCTYPE=L, COMP=Y, and COMPRTN= FABJCMP1, FABJCMP2, or FABJCMP3 in ICEIN statement, Because CRC does not recognize a DB organization for the input image copy data set, HPIC mishandles the compress process for the second CI of HALDB at the re-compress process in the Logical Copy.
Problem conclusion
IMS High Performance Image Copy for z/OS Version 3 Release 1 provides a new compression routine FABJCMP4. ***************************************************** ***** ATTENTION ***** ATTENTION ***** ATTENTION ***** ***************************************************** ** When you want to create an compressed image ** ** copy data set for DEDB that has an SDEP segment,** ** you MUST USE FABJCMP4. ** ** ** ** FABJCMP1, FABCMP2, and FABJCMP3 CAN NOT use ** ** DEDB that has an SDEP segment. ** ***************************************************** FABJCRC1 has been modified to check DB organization for the input image copy data, and pass it to the compression routine at the re-compress time of the Logical Copy. FABJDPS7, FABJDPS8, and FABJDPS9 have been reassembled. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 1 User's Guide SC18-7617-00 ( SC18761700 ) should be changed as follows: 2.3.5.6 COMPRTN= : routine is the name of the compression routine. HPIC provides three | compression exit routines: FABJCMP1, FABJCMP2, FABJCMP3, and | FABJCMP4. Specify one of these compression routines to be called by the HPIC Image Copy function or the HPIC Create Image Copy function. If the COMP=Y keyword is specified without the COMPRTN= keyword, FABJCMP1 is used as the default. The same compression routine is automatically called by the HPIC Database Recovery function to decompress the compressed data. | Note: | When you want to create an compressed image | copy data set for DEDB that has an SDEP segment, | you MUST USE FABJCMP4. | | FABJCMP1, FABCMP2, and FABJCMP3 CAN NOT use | DEDB that has an SDEP segment. | HPIC provides the following compression routine. +-----------------------------------------------------------+ | Compression Routine | Compression Algorithm | |---------------------+-------------------------------------| | FABJCMP1 | Does repeated character compression.| | | Free space can also be compressed. | |---------------------+-------------------------------------| | FABJCMP2 | Does only free space compression. | | | Segmented data is not compressed. | |---------------------+-------------------------------------| | FABJCMP3 | Does the repeating-characters | | | compression of the z/OS program | | | compression method. | | | Free space can also be compressed. | | +-----------------------------------------------------------+ | | FABJCMP4 | Does the repeating-characters | | | | compression of the z/OS program | | | | compression method. | | | | This routine does the block compress| | | | that does not distinguish between | | | | a data portion, free space, and | | | | unused space in the database. | | +-----------------------------------------------------------+ : 2.3.6.1 SYSIN Control Statement for DFSUDMP0 : Position Description : 50-80 Comments can be placed in position 50 through 80. | Compression Routines: HPIC provides three compression exit | routines: | FABJCMP1, FABJCMP2, FABJCMP3, and FABJCMP4. Specify one of these compression routines to be called by FABJDMPx. If the compression routine name is not specified in the utility control statement (that is, position 39 is Y and position 40-47 is blank), FABJCMP1 is used as the default. The same compression routine is automatically called by FABJRDMx to decompress the compressed data. | Note: | When you want to create an compressed image | copy data set for DEDB that has an SDEP segment, | you MUST USE FABJCMP4. | | FABJCMP1, FABCMP2, and FABJCMP3 CAN NOT use | DEDB that has an SDEP segment. | FABJCMP1 does repeating-characters compression. Free space might also be compressed. FABJCMP2 does free-space compression. The segment data is not compressed. FABJCMP3 does repeating-characters compression of the z/OS program compression method. Free space might also be compressed. | FABJCMP4 | does repeating-characters compression of the z/OS program | compression method. | This routine does the block compress that does not | distinguish between a data portion, free space, and | unused space in the database. Selecting whether to compress your image copies and which compression routine to use depends on the following factors of your install ation: - The amount of CPU time available - The compression ratio allowable Generally, FABJCMP1 and FABJCMP3 use more CPU time than FABJCMP2, but FABJCMP3 achieves better compression and uses less CPU time than FABJCMP1. Note: If the image copy job uses the tape device featuring the IDRC compression, additional use of the compression routine might result in a lower compression rate. In such a case, do not use the FABJCMP1 compression routine. 9.1.2 Process Type When CRCTYPE=L is specified in the ICEIN control statement, the process type and the compressed format of an output data set are determined by the combination of the original image copy data set, the COMP= keyword, and the COMPRTN= keyword. +----------------------------------------------------------+ |Input IC |COMP=|COMPRTN=| Output Image Copy Data Set | |Data Set | | |--------------+--------------| |Format | | |Type processed|Type processed| |-------------+-----+--------+--------------+--------------| |Noncompressed| - | - |Physical copy |Noncompressed | | |-----+--------+--------------+--------------| | | N | - |Physical copy |Noncompressed | | |-----+--------+--------------+--------------| | | Y | - |Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP1|Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP2|Logical copy |Compressed by | | | | | | FABJCMP2 | | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP1 | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | N | - |Logical copy |Noncompressed | | |-----+--------+--------------+--------------| | | Y | - |Physical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP1|Physical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP2|Logical copy |Compressed by | | | | | | FABJCMP2 | | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP2 | | | | FABJCMP2 | | |-----+--------+--------------+--------------| | | N | - |Logical copy |Noncompressed | | |-----+--------+--------------+--------------| | | Y | - |Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP1|Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP2|Physical copy |Compressed by | | | | | | FABJCMP2 | | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP3 | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | N | - |Logical copy |Noncompressed | | |-----+--------+--------------+--------------| | | Y | - |Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP1|Logical copy |Compressed by | | | | | | FABJCMP1 | | |-----+--------+--------------+--------------| | | Y |FABJCMP2|Logical copy |Compressed by | | | | | | FABJCMP2 | | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Physical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | FABJCMP4 | | +----------------------------------------------------------+ | |Compressed by| - | - |Physical copy |Compressed by | | | FABJCMP4 | | | | FABJCMP4 | | | |-----+--------+--------------+--------------| | | | N | - |Logical copy |Noncompressed | | | |-----+--------+--------------+--------------| | | | Y | - |Logical copy |Compressed by | | | | | | | FABJCMP1 | | | |-----+--------+--------------+--------------| | | | Y |FABJCMP1|Logical copy |Compressed by | | | | | | | FABJCMP1 | | | |-----+--------+--------------+--------------| | | | Y |FABJCMP2|Logical copy |Compressed by | | | | | | | FABJCMP2 | | | |-----+--------+--------------+--------------| | | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | | FABJCMP3 | | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Physical copy |Compressed by | | | | | | | FABJCMP4 | +----------------------------------------------------------+ 10.1.3 Compression Routine Selection The following factors are important in selecting a compression method: - The amount of CPU time used - The compression ratio | Generally, FABJCMP1 FABJCMP3 and FABJCMP4 use more CPU time | than FABJCMP2, but FABJCMP3 achieves better compression and | uses less CPU time than FABJCMP1. | FABJCMP4 uses less CPU time than FABJCMP3, but FABJCMP3 | achieves better compression than FABJCMP4. Note: If the image copy job uses a tape device with the IDRC compression, the use of an additional compression routine might result in a lower compression rate. In such a case, do not use this compression routine.
Temporary fix
Comments
APAR Information
APAR number
PK14105
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-10-26
Closed date
2005-11-09
Last modified date
2005-12-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK08887
Modules/Macros
FABJCMP4 FABJCRC1 FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJLINK H1J0310J
SC18761700 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R310 PSY UK08887
UP05/11/11 P F511
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"310","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020