PI10566: INCORRECT DATA IN GLOBAL REPORT OF IMS HP IMAGE COPY V4.2, WHEN IT RUNS UNDER OTHER IMS TOOLS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Incorrect data value is printed in GLOBAL report of IMS HP Image
  Copy V4.2, when it runs under other IMS tools such as
  Reorganization Expert.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes following problems:     *
  *                      - VOLCNT keyword that controls the      *
  *                        volume count for image copy data set  *
  *                        can not be allowed to define as the   *
  *                        site default of IMS HP Image Copy.    *
  *                      - The parameter check for the range     *
  *                        of number for VOLCNT is incorrect.    *
  *                      - The GLOBAL Options Report shows       *
  *                        incorrect values for some keyword.    *
  *                      - The specification of DSNTYPE keyword  *
  *                        is ignored when IMS HP Image Copy     *
  *                        runs under IMS Online Reorganization  *
  *                        Facility.                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes following problems:
  - VOLCNT keyword that controls the volume count for image copy
    data set can not be allowed to define as the site default of
    IMS HP Image Copy. When IMS HP image Copy runs with the
    default count for large database data sets as the STACK,
    IMS HP Image Copy terminates with error and image copy data
    sets are not created.
  - The parameter check for the range of number for VOLCNT is
    incorrect. IMS HP Image Copy allocates image copy data sets
    dynamically with invalid value as volume counts. As the
    result, used volume count may be very small.
  - The GLOBAL Options Report shows incorrect values for some
    keyword. The reported value may not be different from actual
    value when running IMS HP Image Copy.
  - The specification of DSNTYPE keyword is ignored when IMS HP
    Image Copy runs under IMS Online Reorganization Facility, then
    the Large Format data sets can not be used for the dynamic
    allocation of image copy data sets.
  

Problem conclusion

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-01 ( SC19275601 ) should be changed as
  follows:
  
  Part 3. Running IMS HP Image Copy
  Chapter 9. IMS HP Image Copy control statements and keywords
    ICEIN control statement keywords
      Summary of ICEIN control statement keywords
         :
   Table 24. Summary of ICEIN keywords
   +----------+-------------------------------------------------+
   |Keyword   |Description                                      |
   +----------+-------------------------------------------------+
         :
   +----------+-------------------------------------------------+
  ||VOLCNT=   |The VOLCNT keyword specifies the number of output|
   |          |volumes used for the output image copy data set. |
   +----------+-------------------------------------------------+
         :
  
      Relation of keywords to ICEIN control statements
         :
    Table 25. Relation of keywords to ICEIN control statements
    +----------+------+-----+---+----+---+---+-------+--------
    |Keyword   |GLOBAL|GROUP|IC |CIC |RCV|CRC|Site   |
    |          |      |     |AIC|ACIC|   |   |default|
    |          |      |     |   |    |   |   |option |
    +----------+------+-----+---+----+---+---+-------+--------
         :
    +----------+------+-----+---+----+---+---+-------+--------
  | |VOLCNT=   |  O   |  O  | O | O  | - | O |   O   |
    +----------+------+-----+---+----+---+---+-------+--------
         :
    VOLCNT keyword
  
  | The VOLCNT keyword specifies the number of output volumes used
    for the output image copy data set.
  
    Statements that support this keyword
      GLOBAL statement
      GROUP statement
      IC/AIC statement
      CIC/ACIC statement
      CRC statement
    Site default option
  |   Supported
    Related keyword
      None.
    Format
     ___________________________________________________
    |                                                   |
    | VOLCNT=nnn                                        |
    |___________________________________________________|
  
    nnn Specifies the maximum number of volumes that an output
        image copy data set requires. The volume count is a
        decimal number from 1 through 255 for a tape data set and
        from 1 through 59 for a DASD data set.
  
  Delete following line.
  |     If you omit VOLCNT, '1' is used as the default.
  
    Default value
  |   None.
  | Notes:
  |   VOLCNT keyword is required when an output image copy data
  |   set will reside on 6 or more tape volumes. If you omit the
  |   VOLCNT keyword or if you specify 1 through 5, the system
  |   allows up to five volumes.
  |   For details, see the z/OS MVS JCL Reference.
         :
  
  Part 5. Working with other IMS tools
  Chapter 17. IMS Database Reorganization Expert and IMS
              Parallel Reorganization
         :
    Table 47. ICEIN control statement parameters for Image Copy
    process (IMS Database Reorganization Expert)
    +----------+-------+-------+-------+----------+-------+-----+
    |Keyword   |Used in|Can be |Can be |Acceptable|System |Topic|
    |          |...    |GLOBAL |IC AIC |values    |default|     |
    +----------+-------+-------+-------+----------+-------+-----+
         :
    +----------+-------+-------+-------+----------+-------+-----+
  | |VOLCNT=   |YES    |YES    |YES    |nnn       |None   |.....|
    +----------+-------+-------+-------+----------+-------+-----+
         :
  Chapter 18. IMS HP Fast Path Utilities
    IMS Fast Path Advanced Tool
         :
    Table 49. ICEIN control statement parameters for Image Copy
    process (IMS Fast Path Advanced Tool)
    +----------+-------+-------+-------+----------+-------+-----+
    |Keyword   |Used in|Can be |Can be |Acceptable|System |Topic|
    |          |...    |GLOBAL |IC AIC |values    |default|     |
    +----------+-------+-------+-------+----------+-------+-----+
         :
    +----------+-------+-------+-------+----------+-------+-----+
  | |VOLCNT=   |YES    |YES    |YES    |nnn       |None   |.....|
    +----------+-------+-------+-------+----------+-------+-----+
         :
    IMS Fast Path Online Tools
         :
    Table 51. ICEIN control statement parameters for Image Copy
    process (IMS Fast Path Online Tools)
    +----------+-------+-------+-------+----------+-------+-----+
    |Keyword   |Used in|Can be |Can be |Acceptable|System |Topic|
    |          |...    |GLOBAL |CIC    |values    |default|     |
    +----------+-------+-------+-------+----------+-------+-----+
         :
    +----------+-------+-------+-------+----------+-------+-----+
  | |VOLCNT=   |YES    |YES    |YES    |nnn       |None   |.....|
    +----------+-------+-------+-------+----------+-------+-----+
         :
  Chapter 19. IMS Online Reorganization Facility
         :
    Table 54. ICEIN control statement parameters for Image Copy
    process (IMS Online Reorganization Facility)
    +----------+-------+-------+-------+----------+-------+-----+
    |Keyword   |Used in|Can be |Can be |Acceptable|System |Topic|
    |          |...    |GLOBAL |IC AIC |values    |default|     |
    +----------+-------+-------+-------+----------+-------+-----+
         :
    +----------+-------+-------+-------+----------+-------+-----+
  | |DSNTYPE=  |YES    |YES    |NO     |BASIC     |BASIC  |.....|
  | |          |       |       |       |LARGE     |       |     |
    +----------+-------+-------+-------+----------+-------+-----+
         :
    +----------+-------+-------+-------+----------+-------+-----+
  | |VOLCNT=   |YES    |YES    |YES    |nnn       |None   |.....|
    +----------+-------+-------+-------+----------+-------+-----+
         :
  
  The following modules and macros are modified for this APAR:
    FABJGLRP FABJMAP1 FABJPARM FABJPRM2 FABJPRM3 FABJTGEN
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI15501

Modules/Macros

• FABJGLRP FABJPARM FABJPRM2 FABJPRM3 FABJTGEN
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI15501

     UP14/02/28 P F402

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.