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. FF APAR FROM HPIC V3R1 - PK14105. . 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 2 users ( FMID=H1J0320 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR includes following APAR of * * HPIC V3R1: * * - PK14105 * * * * This APAR also corrects following * * problem of HPIC V3R2: * * - HPIC V3R2 Create Image Copy function * * abends S002 ( ABEND002 ) RSN18, in * * creating more than 1 logical copy * * data set. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR includes following APAR fix from IMS High Performance Image Copy for z/OS version 3 release 1: PK14105 fixes following problem: HPIC V3R2 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 V3R2 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 V3R2 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. This APAR also corrects following problem of HPIC V3R2: HPIC V3R2 Create Image Copy function abends S002 ( ABEND002 ) RSN18, in creating more than 1 logical copy data set. Because LRECL of logical copy is incorrect.
Problem conclusion
IMS High Performance Image Copy for z/OS Version 3 Release 2 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. Also, FABJCRC1 has been modified to set LRECL value correctly when logical copies are to be created. FABJDRQS has been modified to use FABJCMP4 correctly when type-A image copy process under IMS Parallel Reorganization for z/OS Version 3 Release 1 with INDEXBLD=YES is requested. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 2 User's Guide SC18-7617-01 ( SC18761701 ) should be changed as follows: 2.3.5.6 COMPRTN= : routine | is the name of the compression routine. HPIC provides four | 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 | |---------------------+-------------------------------------| : : : : : : |---------------------+-------------------------------------| | 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 four 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. | : 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 installation: - The amount of CPU time available - The compression ratio allowable | 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 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. 10.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 | | |-----+--------+--------------+--------------| : : : : : : : : : : : : | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP1 | | | | FABJCMP1 | | |-----+--------+--------------+--------------| : : : : : : : : : : : : | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP2 | | | | FABJCMP2 | | |-----+--------+--------------+--------------| : : : : : : : : : : : : | |-----+--------+--------------+--------------| | | Y |FABJCMP3|Logical copy |Compressed by | | | | | | FABJCMP3 | | |-----+--------+--------------+--------------| | | | Y |FABJCMP4|Logical copy |Compressed by | | | | | | | FABJCMP4 | |-------------+-----+--------+--------------+--------------| |Compressed by| - | - |Physical copy |Compressed by | | FABJCMP3 | | | | FABJCMP3 | | |-----+--------+--------------+--------------| : : : : : : : : : : : : | |-----+--------+--------------+--------------| | | 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 | +----------------------------------------------------------+ 11.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
PK16007
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
320
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-11-30
Closed date
2005-12-05
Last modified date
2006-01-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK09807
Modules/Macros
FABJCMP4 FABJCRC1 FABJDRQS FABJLINK H1J0320J
| SC18761701 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R320 PSY UK09807
UP05/12/09 P F512
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":"320","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020