PK60299: DRF ENDS WITH A RC00 WHILE NOTIFY.IC FAILS. VOLLIST IS NOT CORRECTLY GENERATED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR fixes two problems:
  - The DRF step ends with a RC00 while NOTIFY.IC fails.
  - The VOLLIST is not correctly generated.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 ( FMID=H1J0410 ) users   *
  *                 who use image copy function under            *
  *                 the Database Recovery Facility               *
  *                 (PID: 5655-N47 ) Version 3 Release 1.        *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC V4R1 under IMS Database Recovery   *
  *                      Facility has following 3 problems:      *
  *                      - NOTIFY.IC command has failed, because *
  *                        HPIC sets incorrect volume            *
  *                        information of the NOTIFY.IC command. *
  *                      - Even if NOTIFY.IC command has failed, *
  *                        HPIC returns RC=0 to DRF.             *
  *                      - ISO/ANSI control characters are       *
  *                        printed on DFSPRINT DD incorrectly.   *
  *                                                              *
  *                      HPIC V4R1 also has following problem:   *
  *                      - When 5 or more volume names are       *
  *                        specified in VOLSER= keyword of ICEIN *
  *                        GLOBAL statement, HPIC fails dynamic  *
  *                        allocation of the output image copy   *
  *                        data set.                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC V4R1 under IMS Database Recovery Facility has following
  3 problems:
  - NOTIFY.IC command has failed, because the volume information
    of image copy data set is not correct. HPIC does not receive
    the volume information from sub address space to master
    address space.
    This problem occurs on the following conditions:
      1. VOLSER() or VOLSER2() keyword is not specified in
         UTILGBL() global control statement and ADD command.
      2. Generated image copy data set resides on 5 or more
         volumes.
  - Even if NOTIFY.IC command has failed, HPIC returns RC=0 to
    DRF. HPIC overrides the return code of NOTIFY.IC command, and
    passes RC=0, which is not expected, to DRF.
  - ISO/ANSI control characters are printed on DFSPRINT DD
    incorrectly. Because HPIC has DCB which RECFM is not FBA, but
    FB.
  
  HPIC V4R1 also has following problem:
  - When 5 or more volume names are specified in VOLSER= keyword
    of ICEIN GLOBAL statement, HPIC fails dynamic allocation of
    the output image copy data set.
    Because HPIC considers wrong area to be volume names specified
    in VOLSER= keyword, and makes SVC99 request block incorrectly.
  
  +--------------------------------------------------------------+
  |APAR PK62129 is required to be applied to IMS Database        |
  |Recovery Facility for z/OS Version 3 Release 1.               |
  +--------------------------------------------------------------+
  

Problem conclusion

• FABJAPIM and FABJAPIP have been modified to pass return code to
  DRF correctly.
  FABJAPIM has also been modified to have correct DCB which RECFM
  is FBA.
  
  FABJDRQS, FABJMAS1 and FABJSAS2 have been modified to receive
  volume information of generated image copies from sub address
  space to master address space.
  
  FABJPARM has been modified to receive volume names specified in
  VOLSER= keyword correctly.
  

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:

  UK34630

Modules/Macros

• FABJAPIM FABJAPIP FABJDRQS FABJMAS1 FABJPARM
  FABJSAS2
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK34630

     UP08/03/19 P F803

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.