PI42707: RACF FAILURE FOR IC DATASET BUT RC=0

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RACF failure for IC dataset but RC=0.
  

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: IMS HP Image Copy does not detect RACF  *
  *                      permission error for output image copy  *
  *                      data set name that is allocated by      *
  *                      dynamic allocation, when Image Copy     *
  *                      function creates the image copy data    *
  *                      set on TAPE by using ICOUT= keyword.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IMS HP Image Copy does not detect RACF permission error for
  output image copy data set name that is allocated by dynamic
  allocation, when Image Copy function creates the image copy
  data set on TAPE by using ICOUT= keyword.
  When the output device is tape, the CLOSE macro confirms the
  process of the physical close of the data set, but it does not
  confirm the output data set permission of RACF is not checked.
  It is done at the catalog process in OS process. CLOSE macro
  returns RC=0 if image copy data set does not have any trouble
  physically, so IMS HP Image Copy can not detect RACF permission
  error. IMS HP Image Copy checks image copy data set catalog
  status after all image copy data set creation process, and
  indicate non-zero RC is set if CATLGERROR=nn on HPSRETCD control
  card and data set is not cataloged. IMS HP Image Copy recommends
  to set nn>8 as CATLGERROR= on HPSRETCD control card, if your
  image copy data set is created on TAPE.
  

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
    HPSRETCD control statement
      CATLGERROR=
  |   If the output image copy data set is not cataloged in the
  |   system, IMS HP Image Copy returns the return code
  |   specified by this parameter. nn is from 0 - 99. The
      default value is 0.
      Note: This parameter is effective only for the Image Copy
            function. If you specify a value higher than 8 for
            this parameter:
            - IMS HP Image Copy will not register the IC record
              that has been detected as a catalog failure to the
              RECON.
            - IMS HP Image Copy will not process the remaining
              DBDSs, which are not yet processed.
  
  Part 6. Troubleshooting
  Chapter 20. Messages and codes Messages
  | FABJ0305W CREATED IMAGE COPY DATA SET IS NOT CATALOGED.
  |
  | Explanation: The image copy data set is not cataloged to the
  | system.
  |
  | System action: IMS HP Image Copy continues processing.
  | If CATLGERR=nn parameter in HPSRETCD DD is specified, IMS HP
  | Image Copy will change Job Step Return Code to nn.
  |
  | User response: Correct the error and rerun the job.
  
  | FABJ0306I DSN : xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx
  |
  | Explanation: This message displays supplemental explanation
  | of the message which appears before this.
  |
  | System action: Not applicable.
  | User response: None.
  |
  | FABJ3973E CATALOG SEARCH INTERFACE IS INCOMPLETED. RC=nn
  | RSN=xx
  |
  | Explanation: IMS HP Image Copy received non-zero return
  | code from the Catalog Search interface module.
  |
  | System action: Program FABJMAIN issued a user error abend code
  | of 3973.
  | User response: Contact IBM Software Support.
  |
  The new module FABJCCAT has been added to check the catalog
  status of image copy data sets.
  
  Following macros and modules have been modified that IMS HP
  Image Copy checks image copy data set catalog status after all
  image copy data set creation process, and indicate non-zero RC
  is set if CATLGERROR=nn on HPSRETCD control card and data set
  is not cataloged.
    FABJDFCA FABJDFCB FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC9 FABJDMPA
    FABJDMPB FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP9 FABJDPSA FABJDPSB
    FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS9 FABJFCDA FABJFCDB FABJFCD2
    FABJFCD3 FABJFCD4 FABJFCD9 FABJMSGC FABJOFL1 FABJDFCN FABJDMPN
    FABJDPSN FABJDSSB FABJFCDN FABJMAP1 FABJLINK H1J0420J
  Following modules have been re-assembled:
    FABJRFCA FABJRFCB FABJRFC2 FABJRFC3 FABJRFC4 FABJRFC9 FABJFCAI
    FABJFCCM FABJFCCA FABJFCCB FABJFCC2 FABJFCC3 FABJFCC4 FABJFCC9
    FABJOFL0 FABJFCCN FABJRFCN
  

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:

  UI28694

Modules/Macros

• FABJCCAT FABJDFCA FABJDFCB FABJDFC2 FABJDFC3
  FABJDFC4 FABJDFC9 FABJDMPA FABJDMPB FABJDMP2 FABJDMP3 FABJDMP4
  FABJDMP9 FABJDPSA FABJDPSB FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS9
  FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCC2 FABJFCC3 FABJFCC4
  FABJFCC9 FABJFCDA FABJFCDB FABJFCD2 FABJFCD3 FABJFCD4 FABJFCD9
  FABJLINK FABJMSGC FABJOFL0 FABJOFL1 FABJRFCA FABJRFCB FABJRFC2
  FABJRFC3 FABJRFC4 FABJRFC9 H1J0420J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI28694

     UP15/06/23 P F506

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.