PH09623: THIS APAR PROVIDES A NEW OPTIONAL KEYWORD 'IC_ERROR=STOP'

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides a new optional keyword 'IC_ERROR=STOP'. This
  option forces to stop all image copy processes if IMS HP Image
  Copy detects an error state in one of the database data set
  processes.
  

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 a new option         *
  *                      "IC_ERROR" which IMS HP Image Copy      *
  *                      forces to stop all image copy           *
  *                      processes in a step when an error       *
  *                      occurs in one of image copy             *
  *                      processes. The option applies only to   *
  *                      the image copy function that is run     *
  *                      by FABJMAIN program.                    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new option "IC_ERROR" which IMS HP Image
  Copy forces to stop all image copy processes in a step when an
  error occurs in one of image copy processes. The option applies
  only to the image copy function that is run by FABJMAIN program.
  
  IC_ERROR keyword specifies whether all image copy processes in
  a step stop forcibly or not when an error occurs one of the
  image copy processes.
  When IC_ERROR=STOP is specified with FASTIC=N or
  FASTIC=(opt,FDUMP) and one of the processes is in error,
  subtasks may end with ABEND S33E ( ABEND33E ) and IMS HP
  Image Copy terminates with ABEND U3988 ( ABENDU3988 ) if the
  ABEND S33E ( ABEND33E ) occurs.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Image Copy for z/OS Version 4
  Release 2 User's Guide (SC19-2756-02) should be changed as
  follows:
  
  Configuring IMS HP Image Copy > Customizing IMS HP Image Copy
  > Setting default values for the FABJMAIN program
  
  Supported keywords for the Site Default Generation utility
    The following keywords can be used for the Site Default
    Generation utility.
    :
    ICNMRULE
    ICOUT
  | IC_ERROR
    IDXSRCH
    IGNORCAT
    :
  
  Control statements and keywords > ICEIN control statement
  keywords
  
    Summary of ICEIN control statement keywords
    Table 23. Summary of ICEIN keywords
    +-----------+----------------------------------------------+
  | | IC_ERROR  | The IC_ERROR keyword specifieds whether the  |
  | |           | image copy processing of all database data   |
  | |           | set is stopped forcibly or not               |
  | |           | when an error occurs in the image copy       |
  | |           | process of FABJMAIN                          |
    +-----------+----------------------------------------------+
    Relation of keywords to ICEIN control statements
  
     Table 24. Relation of keywords to ICEIN control statements
    +--------+------+-----+---+----+---+---+-------+----------+
    |Keyword |GLOBAL|GROUP|IC |CIC |RCV|CRC|Site   |Related   |
    |        |      |     |   |    |   |   |default|keyword   |
    |        |      |     |   |    |   |   |option |          |
    +--------+------+-----+---+----+---+---+-------+----------+
  | |IC_ERROR|  O   | -   | - | -  | - | - | O     |RETCDDSN  |
  | |        |      |     |   |    |   |   |       |SHDW_ERROR|
    +--------+------+-----+---+----+---+---+-------+----------+
  
  |...+....1....+....2....+....3....+....4....+....5....+....6...>
  | IC_ERROR
  | The IC_ERROR keyword specifies whether IMS HP Image Copy
  | stops all image copy processes forcibly or not when an error
  | occurs in one of the image copy process.
  
  | Statements that support this keyword : GLOBAL statement
  | Site default option : Supported
  | Related keyword: RETCDDSN, SHDW_ERROR
  
  | Format:
  | IC_ERROR=CONT|STOP
  
  |     CONT : Image copy processing continues even if an error
  |            occurs in processes.
  |     STOP : Image copy processing of all database data set is
  |            stopped forcibly when an error occurs in one of
  |            the processes.
  
  | Default value:  IC_ERROR=CONT
  
  | Usage note:
  | - The process is continued even if IC_ERROR=STOP is
  |   specified and an error occurs in the process, when the
  |   return code for the cause of error is changed to less than
  |   8 by the Return Code Handling.
  | - If both IC_ERROR=STOP and SHDW_ERROR=STOP are specified,
  |   SHDW_ERROR=STOP is ignored.
  
  IMS HP Image Copy reports > GLOBAL Options report
  
    KEYWORD      DEFAULT   ACTIVE GLOBAL SETTING FOR THIS STEP
    -----------  --------  -----------------------------------
    :
  | IC_ERROR     CONT      CONT
  
  Troubleshooting > Messages and codes > Messages
  
  | FABJ4600E HPIC FORCES TO STOP IMAGE COPY PROCESSES
  | Explanation: Image copy processes are stopped forcibly
  |              because IC_ERROR=STOP is specified and an error
  |              occurs in one of the processes.
  | System action: All image copy processes terminate.
  | User response: Correct the error and rerun the job.
  

Problem conclusion

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:

  UI62213

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1
  FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL
  FABJDBC1 FABJDBCM FABJDBD2 FABJDBD3 FABJDBD4 FABJDBD5 FABJDBD9
  FABJDBDA FABJDBDB FABJDBF0 FABJDBLK FABJDBR2 FABJDBR3 FABJDBR4
  FABJDBR5 FABJDBR9 FABJDBRA FABJDBRB FABJDCTL FABJDDIM FABJDEMP
  FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC5 FABJDFC9 FABJDFCA FABJDFCB
  FABJDMP0 FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP5 FABJDMP9 FABJDMPA
  FABJDMPB FABJDOPN FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS5 FABJDPS9
  FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI
  FABJFCC2 FABJFCC3 FABJFCC4 FABJFCC5 FABJFCC9 FABJFCCA FABJFCCB
  FABJFCCM FABJFCD2 FABJFCD3 FABJFCD4 FABJFCD5 FABJFCD9 FABJFCDA
  FABJFCDB FABJFDMP FABJGDGB FABJGLRP FABJICDD FABJIDX2 FABJIDX3
  FABJIDX4 FABJIDX5 FABJIDX9 FABJIDXA FABJIDXB FABJINT1 FABJINT2
  FABJINT3 FABJIPRC FABJISDD FABJMAIN FABJMAS1 FABJMDP2 FABJMDP3
  FABJMDP4 FABJMDP5 FABJMDP9 FABJMDPA FABJMDPB FABJMRGE FABJMSGC
  FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1
  FABJORC2 FABJORC3 FABJORC4 FABJORC5 FABJORC9 FABJORCA FABJORCB
  FABJPARM FABJPRM2 FABJPRM3 FABJRCH2 FABJRCH3 FABJRCH4 FABJRCH5
  FABJRCH9 FABJRCHA FABJRCHB FABJRDB2 FABJRDB3 FABJRDB4 FABJRDB5
  FABJRDB9 FABJRDBA FABJRDBB FABJRETC FABJRETM FABJRFC2 FABJRFC3
  FABJRFC4 FABJRFC5 FABJRFC9 FABJRFCA FABJRFCB FABJRPT0 FABJRPT1
  FABJSAS1 FABJSAS2 FABJSDBK FABJSTA  FABJSTMD FABJTERM FABJTFSI
  FABJTGEN FABJTGET FABJTOI  FABJTOI2 FABJUIC1 FABJWCRD FABJXCR
  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI62213

     UP19/03/30 P F903

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.