PM12055: HPIC ISSUES MESSAGES FOR DIAGNOSTIC WHEN HPIC PROCESS UNDER DRF TERMINATES WITH RC=08,RSN=00000003

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HPIC under DRF terminates with RC=08, RSN=00000003, when IC    €
  data set can not register DBRC RECON with some reasons.
  HPIC issues new messages of DBRC registration fail reason.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the fixes for the    *
  *                      following problems:                     *
  *                      - When HP Image Copy under IMS Database *
  *                        Recovery Facility ends with RC=08 and *
  *                        RSN=03, any diagnostic messages       *
  *                        aren't issued.                        *
  *                      - When HP Image Copy detects I/O error  *
  *                        for one of dual image copy data sets  *
  *                        for DBDS or area and continues the    *
  *                        process with another IC data set, the *
  *                        following two problems occur:         *
  *                        - NOTIFY.IC command fails because of  *
  *                          the invalid VOLLIST keyword.        *
  *                        - The incorrect record count of IC    *
  *                          data set is printed in the Image    *
  *                          Copy Dump Process report.           *
  *                      - IMS Database Recovery Facility cannot *
  *                        report the correct return code of     *
  *                        the image copy process for each       *
  *                        database data set.                    *
  *                      - When HP Image Copy under IMS Database *
  *                        Recovery Facility detects the         *
  *                        authorization status error, an        *
  *                        infinite loop occurs.                 *
  *                      - HP Image Copy under IMS Database      *
  *                        Recovery Facility encounters          *
  *                        unexpected ABEND U300 ( ABENDU300 ).  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the fixes for the following problems:
  - When HP Image Copy under IMS Database Recovery Facility ends
    with RC=08 and RSN=03, any diagnostic messages aren't issued.
    HP Image Copy should provide some new messages for analysis
    the cause of the error.
  
  - When HP Image Copy detects I/O error for one of dual image
    copy data sets for DBDS or area and continues the process with
    another IC data set, the following two problems occur:
    - NOTIFY.IC command fails because of the invalid VOLLIST
      keyword. HP Image Copy should set the valid volume name into
      VOLLIST keyword.
    - The incorrect record count of IC data set is printed in the
      Image Copy Dump Process report, because saved record count
      is overwritten by the invalid number.
  
  - IMS Database Recovery Facility cannot report the correct
    return code of image copy process for each database data set.
    HP Image Copy should pass the correct return code of each
    database data set to IMS Database Recovery Facility.
  
  - When HP Image Copy under IMS Database Recovery Facility
    detects the authorization status error, an infinite loop
    occurs. This is caused by incorrect logic of error handling.
  
  - HP Image Copy under IMS Database Recovery Facility encounters
    unexpected ABEND U300 ( ABENDU300 ) because HP Image Copy
    refers an incorrect area and misjudges the condition of user
    ABEND.
  

Problem conclusion

• FABJAPIM, FABJMSGC and FABJNTFS have been modified to issue some
  new diagnostic messages.
  FABJDOPN has been modified to get the correct volume name for
  NOTIFY.IC command.
  FABJDPUT, FABJNTFC, FABJNTFI and FABJTERM have been modified to
  print the record count of IC data set correctly.
  FABJDRQS has been modified to pass the correct return code to
  IMS Database Recovery Facility. FABJDRQS has also been modified
  to avoid the infinite loop.
  FABJCP40 has been modified to refer a correct area to avoid
  unexpected user ABEND.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409-02 ( SC18940902 ) should be changed as
  follows:
  
  Add the following sections.
  
  12.0 Reference: Return codes, abend codes, and messages
   12.3 Messages
  
    12.3.x FABJ0231E
    | FABJ0231E  THE mmmmmm MACRO FAILED WITH RC=xxxxxxxx
    | RSN=yyyyyyyy
    |
    | Explanation: The mmmmmm macro failed with RC xxxxxxxx and
    | RSN yyyyyyyy.
    |
    | System action: IMS HP Image Copy stops the process.
    |
    | User response: Contact IBM Software Support.
  
    12.3.x FABJ0232E
    | FABJ0232E  INTERNAL ERROR OCCURRED - reason
    |
    | Explanation: An internal error has occurred during image
    | copy processing. The reason for the failure is listed in
    | 'reason'.
    |
    | System action: IMS HP Image Copy ends the process.
    |
    | User response: Contact IBM Software Support.
  
    12.3.x FABJ0233E
    | FABJ0233E  DBRC IMAGE COPY RECORD REGISTRATION PROCESS
    | FAILED. DBRC COMMAND RC=nn
    |
    | Explanation: DBRC command process for image copy
    | registration failed with RC=nn. Some of image copy data sets
    | are not registered in the DBRC RECON data sets.
    |
    | System action: IMS HP Image Copy ends the process with a
    | return code of 08.
    |
    | User response: Check the result of IMS DBRC command in the
    | SYSPRINT DD and determine the cause of the failure. Then
    | register image copy data set manually, if necessary. If the
    | cause of the failure can not be determined, contact IBM
    | Software Support.
  
    12.3.x FABJ0234I
    | FABJ0234I  TWO OUTPUT COPIES WERE ATTEMPTED BUT ONLY ONE
    | COPY WAS CREATED. DBD=dddddddd DDN/AREA=dddddddd
    |
    | Explanation: IMS HP Image Copy attempted to create two image
    | copies but some error occurred in one copy. IMS HP Image
    | Copy continued the dump process with only one output copy.
    |
    | System action: Continues the process and end with a return
    | code of 04.
    |
    | User response: See the DFSPRINT DD to get the further
    | information.
  

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:

  UK57330

Modules/Macros

• FABJAPIM FABJCP40 FABJDOPN FABJDPUT FABJDRQS
  FABJMSGC FABJNTFC FABJNTFI FABJNTFS FABJTERM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK57330

     UP10/06/02 P F006

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.