PK61486: FABJ3922E RECEIVED BUT RC=0. ALLOW USER TO CHANGE RETURN CODE IF CATALOG FAILURE OCCURS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• FABJ3922E was received but RC=0.  This APAR will provide
  support for return code handling for catalog failure.  The user
  can change the HPIC return code if catalog failure occurs.
  NOTIFY.IC will occur if RC=8, but not if RC>8.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC stacking process for Image Copy    *
  *                      function ends with CC=0, even if        *
  *                      CATALOG macro failed and message        *
  *                      FABJ3922E ( MSGFABJ3922E ) is issued.   *
  *                      HPIC will provide new option of Image   *
  *                      Copy function which allows user to      *
  *                      change return code of HPIC in detecting *
  *                      catalog failure.                        *
  *                                                              *
  *                      Also, this APAR fixes following         *
  *                      problems:                               *
  *                      - HPIC Create Image Copy function does  *
  *                        not support the 3rd-7th stacked image *
  *                        copy data set, when input data set is *
  *                        the Fast Recovery image copy format.  *
  *                      - HPIC abnormally ends with S0C4        *
  *                        ( ABEND0C4 ) when control statement   *
  *                        error is detected in HPSRETCD or      *
  *                        FABJDRSN.                             *
  *                      - The sentence of message FABJ0001E     *
  *                        ( MSGFABJ0001E ) is printed           *
  *                        incorrectly, when control statement   *
  *                        error is detected in HPSRETCD.        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC stacking process for Image Copy function ends with CC=0,
  even if CATALOG macro failed and message FABJ3922E
  ( MSGFABJ3922E ) is issued.
  HPIC will provide new option of Image Copy function which allows
  user to change return code of HPIC in detecting catalog failure.
  A new keyword CATLGERROR= is added to (HPIC) statement of
  HPSRETCD.
  
  Also, this APAR fixes following problems:
  - HPIC Create Image Copy function does not support the 3rd-7th
    stacked image copy data set, when input data set is the Fast
    Recovery image copy format. Because HPIC does not open the DD
    of the 3rd-7th output image copy.
  - HPIC abnormally ends with S0C4 ( ABEND0C4 ) when control
    statement error is detected in HPSRETCD or FABJDRSN. Because
    FABJXCR FUNC=TERM is called and issued CPOOL macro even if it
    is unnecessary.
  - The sentence of message FABJ0001E ( MSGFABJ0001E ) is printed
    incorrectly, when control statement error is detected in
    HPSRETCD.
  

Problem conclusion

• FABJCRC0 has been modified to end HPIC Create Image Copy process
  with U3922 when catalog failure has been detected.
  
  FABJCRC1 has been modified to print message FABJ3922E and
  FABJ3917E when catalog failure has been detected.
  
  FABJDEMP, FABJDPUT and FABJDRQS have been modified to check the
  return code of FABJDOPN whether catalog failure has occurred or
  not.
  
  FABJDFCN has been modified to skip the succeeding process in
  detecting catalog failure and a value of CATLGERROR= keyword is
  higher than 8.
  
  FABJDMPN has been modified to avoid ending U3933 when catalog
  failure has occurred and a value of CATLGERROR= keyword is
  higher than 8.
  
  FABJDOPN has been modified to print message FABJ3917E when
  catalog failure has occurred.
  
  FABJDPSN has been modified to do following things in detecting
  catalog failure:
   - Skip the succeeding process if a value of CATLGERROR= keyword
     is higher than 8.
   - Handle the return code of HPIC according to specified value
     of CATLGERROR= keyword.
  
  FABJDSSB has been modified to add new parameter to FABJMDPN
  which informs whether a registration of output data set to RECON
  is needed or not in detecting catalog failure.
  
  FABJFCDN has been modified to do following things in detecting
  catalog failure:
   - Handle the return code of HPIC according to specified value
     of CATLGERROR= keyword.
   - Skip the registration of output data set to RECON if a value
     of CATLGERROR= keyword is higher than 8.
  
  FABJMAIN has been modified not to call FABJXCR FUNC=TERM if
  control statement error has occurred in HPSRETCD or FABJDRSN.
  
  FABJMDPN has been modified not to register output image copy
  data set to RECON if catalog error has detected and a value of
  CATLGERROR= keyword is higher than 8.
  
  FABJRETC has been modified to handle return code according to
  a value of CATLGERROR= keyword.
  
  FABJRETD and FABJRETT have been modified to add a new keyword
  CATLGERROR=.
  
  FABJRETP has been modified to print a correct sentence of
  message FABJ0001E.
  
  FABUITCT has been modified to add a new flag to inform that
  a value of CATLGERROR= keyword is higher than 8.
  
  The following modules have been reassembled.
   FABJAPIM FABJCMDB FABJCRC3 FABJDBAL FABJDCTL FABJDFCA FABJDFC7
   FABJDFC8 FABJDFC9 FABJDMPA FABJDMP7 FABJDMP8 FABJDMP9 FABJDPSA
   FABJDPS7 FABJDPS8 FABJDPS9 FABJDREQ FABJFCAI FABJFCCA FABJFCCM
   FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCD7 FABJFCD8 FABJFCD9
   FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAS1 FABJMDPA FABJMDP7
   FABJMDP8 FABJMDP9 FABJNTFC FABJNTFI FABJOFL0 FABJOFL1 FABJRETM
   FABJRFCA FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS2 FABJSTA
   FABJTERM FABJTOI  FABJUIC1 FABJXCR  FABJXHPC
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409 ( SC189409 ) should be changed as
  follows:
  
  3.0 Operating instructions
   3.3 Input for FABJMAIN
    3.3.2 HPSRETCD
     3.3.2.3 (HPIC) Statement
  
   The (HPIC) statement contains optional parameters, which are
   specified by the following keywords:
   :
    SPMNWARN=nn|4
    T2ERROR=nn|2
    TMSERROR=nn|8
  | CATLGERROR=nn|0
   :
   :
  | CATLGERROR=
  |  If HPIC detects a failure of CATALOG macro for the stack data
  |  set, HPIC returns the return code specified by this
  |  parameter. nn is 0 to 99. The default value is 0.
  |  Note:
  |  This parameter is effective for only Image Copy function.
  |  If you specify the value higher than 8 to this parameter;
  |  - HPIC will not register IC record which has been detected
  |    catalog failure to the RECON.
  |  - HPIC will not process the remaining DBDS which is not
  |    processed yet.
  
  
  A.3 Messages
   A.3.161 FABJ3922E
  
    FABJ3922E CATALOG FAILED FOR STACK DATA SET OF DD: ddname
  | DBD: dbdname  DDN/AREA: ddname   RC=nnnn R0=nnnnnnnn
  | R1=nnnnnnnn
  
    Explanation: Executing the CATALOG macro for the STACK data
    set DD: ddname failed.
  
  | System Action: In Image Copy process, program FABJMAIN
  | ignores this error and continues processing. In Create Image
  | Copy process, program FABJMAIN issues a user error abend code
  | of U3922.
  
    Programmer Response: Check the return code of the CATALOG
    macro by referring to the DFDSS CATALOG macro publications,
  | and catalog the image copy data set.
  

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:

  UK34953

Modules/Macros

• FABJAPIM FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3
  FABJDBAL FABJDCTL FABJDEMP FABJDFCA FABJDFCN FABJDFC7 FABJDFC8
  FABJDFC9 FABJDMPA FABJDMPN FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN
  FABJDPSA FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ
  FABJDRQS FABJDSSB FABJFCAI FABJFCCA FABJFCCM FABJFCCN FABJFCC7
  FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9
  FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA
  FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJNTFC FABJNTFI FABJOFL0
  FABJOFL1 FABJRETC FABJRETD FABJRETM FABJRETP FABJRETT FABJRFCA
  FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS2 FABJSTA
  FABJTERM FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK34953

     UP08/03/28 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.