PM12237: 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 failure reason.
  

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 provides the fixes for the    *
  *                      following problems as a forward fit for *
  *                      PM12055 of HP Image Copy V4R1:          *
  *                      - When HP Image Copy under IMS Database *
  *                        Recovery Facility or IMS Recovery     *
  *                        Solution Pack 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 the other 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 or IMS *
  *                        Recovery Solution Pack 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 or IMS Recovery     *
  *                        Solution Pack detects the             *
  *                        authorization status error, an        *
  *                        infinite loop occurs.                 *
  *                      - HP Image Copy under IMS Database      *
  *                        Recovery Facility or IMS Recovery     *
  *                        Solution Pack encounters unexpected   *
  *                        ABEND U300 ( ABENDU300 ).             *
  *                                                              *
  *                      This APAR also fixes the following      *
  *                      problem:                                *
  *                      - HP Image Copy under IMS Database      *
  *                        Recovery Facility or IMS Recovery     *
  *                        Solution Pack encounters ABEND        *
  *                        S30A ( ABENDS30A ) with RSN=24.       *
  *                      - HP Image Copy under IMS Recovery      *
  *                        Solution Pack encounters unexpected   *
  *                        ABEND U3916 ( ABENDU3916 ).           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the fixes for the following problems as a
  forward fit for PM12055 of HP Image Copy V4R1:
  - When HP Image Copy under IMS Database Recovery Facility or IMS
    Recovery Solution Pack ends with RC=08 and RSN=03, any
    diagnostic messages aren't issued. HP Image Copy should
    provide some new messages for analyzing 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
    the other 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 or IMS Recovery Solution Pack
    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 or IMS Recovery Solution Pack.
  
  - When HP Image Copy under IMS Database Recovery Facility or IMS
    Recovery Solution Pack 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 or IMS
    Recovery Solution Pack encounters unexpected ABEND U300
    ( ABENDU300 ) because HP Image Copy refers an incorrect area
    and misjudges the condition of user ABEND.
  
  This APAR also fixes the following problem:
  - HP Image Copy under IMS Database Recovery Facility or IMS
    Recovery Solution Pack encounters ABEND S30A ( ABENDS30A )
    with RSN=24 when the ABEND SD37 ( ABENDD37 ) occurs in the
    CLOSE macro for output image copy data set. The cause of the
    problem is HP Image Copy continues processing and attempt to
    free output image copy buffer by using the FREEPOOL macro. The
    FREEPOOL macro issues FREEMAIN macro even if the output image
    copy buffer is already freed.
  
  - HP Image Copy under IMS Recovery Solution Pack encounters
    unexpected ABEND U3916 ( ABENDU3916 ) when HP Image Copy
    unallocates the SYSPRINT DD which is dynamically allocated and
    is opened by IMS Recovery Solution Pack.
  

Problem conclusion

• FABJMSGC and FABJNTFS have been modified to issue some
  new diagnostic messages.
  
  FABJAPIM has been modified as follows:
  - Issue some new diagnostic messages.
  - Delete unallocation logic of SYSPRINT DD.
  
  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.
  
  FABJCP40 has been modified to refer a correct area to avoid
  unexpected user ABEND.
  
  FABJDRQS has been modified as follows:
  - Pass the correct return code to IMS Database Recovery Facility
    or IMS Recovery Solution Pack. FABJDRQS has also been modified
    to avoid the infinite loop.
  - Add the bypass logic of FREEMAIN macro to be freed output
    image copy buffer in the FREEPOOL macro.
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-00 ( SC19275600 ) should be changed as
  follows:
  
  Add the following sections.
  
  6.0 Troubleshooting
      Messages and codes
      Messages
    | 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.
  
    | 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.
  
    | 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.
  
    | 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:

  UK57884

Modules/Macros

• FABJAPIM FABJCP40 FABJDPUT FABJDRQS FABJMSGC
  FABJNTFC FABJNTFI FABJNTFS FABJTERM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK57884

     UP10/06/15 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.