PM15125: ADD NEW KEYWORD FOR HPIC TO STOP ALL PROCESSES IN THE JOBSTEP IFONE OF SHADOW CREATION FAILS.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Add new keyword for HPIC to stop all processes in the JOBSTEP if
  one of Shadow Creation fails.
  

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 a new keyword        *
  *                      SHDW_ERROR=.                            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new keyword SHDW_ERROR=. The new keyword
  SHDW_ERROR= is supported in order to specify whether the Image
  Copy processing is continued or stopped when the process of
  creating the shadow data set is failed.
  

Problem conclusion

Temporary fix

Comments

• Following modules and macros are modified for this APAR:
  
  The following modules and macros have been modified.
   FABJBLKD FABJDFCN FABJDMPN FABJDSSB FABJFDMP FABJGLRP FABJLINK
   FABJPARM FABJSTMD FABJTGEN H1J0410J
  
  The following modules have been reassembled.
   FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1
   FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL
   FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD7 FABJDBD8
   FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR7
   FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB
   FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPB FABJDMP0 FABJDMP7
   FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS7
   FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI
   FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9
   FABJFCDA FABJFCDB FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB
   FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9
   FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA
   FABJMDPB FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGP
   FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1
   FABJORCA FABJORCB FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM
   FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCHK FABJRCH7 FABJRCH8
   FABJRCH9 FABJRDBA FABJRDBB FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC
   FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9
   FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA  FABJTERM FABJTOI
   FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
  
  ========================
  = 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:
  
  3.0 Operating instructions
      ICEIN control statement data set
        Option parameters
  |       SHDW_ERROR keyword
  
  |SHDW_ERROR keyword
  |
  | The SHDW_ERROR keyword specifies whether the Image Copy
  | processing is continued or stopped when the process of
  | creating the shadow data set is failed.
  |
  |Format:
  |  ____________________________________________________
  | |                                                    |
  | |  SHDW_ERROR=CONT|STOP                              |
  | |                                                    |
  | |____________________________________________________|
  |
  | where
  |
  | CONT
  |    specifies that the Image Copy processing is continued when
  |    the process of creating the shadow data set is failed. CONT
  |    is the default.
  |
  | STOP
  |    specifies that the Image Copy processing is stopped when
  |    the process of creating the shadow data set is failed.
  |
  | This keyword is effective when FASTIC=(opt,FDUMP) is specified
  |
  |
  | This keyword can be used in the following control statements:
  |  -GLOBAL
  |
  | This keyword can be defined in the site default table.
  |
  
  Messages
  
  | FABJ4213E THE PROCESS OF CREATING SHADOW DATA SET IS FAILED.
  | NO IC DATA SET IS CREATED.
  |
  | Explanation: The shadow data set create process failed. HPIC
  | terminates without creating an image copy from the shadow data
  | set.
  | System action: IMS HP Image Copy stops processing.
  | Programmer Response: Contact IBM Software Support, and provide
  | the RC and RSN found in the message
  
  | FABJ4219I HPIC RECEIVED RC=4 FROM DFSMSDSS API. HPIC CONTINUES
  | PROCESSING.
  |
  | Explanation: HPIC received RC=4 from DFSMSdss API and
  | confirmed physical copy completed.
  | System action: IMS HP Image Copy continues processing.
  | Programmer response: Check DFSMSdss message and RC. Correct
  | the job and rerun the job if you need.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK57607

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD
  FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC
  FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB
  FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA
  FABJDBRB FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM
  FABJDEMP FABJDFCA FABJDFCB FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9
  FABJDMPA FABJDMPB FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9
  FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9
  FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJDSSB FABJFCAI FABJFCBK
  FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9
  FABJFCDA FABJFCDB FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJFDMP
  FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX7
  FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK
  FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDPN FABJMDP7 FABJMDP8
  FABJMDP9 FABJMRGE FABJMSGP FABJMSUL FABJNTFC FABJNTFI FABJNTFS
  FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORCN FABJORC7
  FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB
  FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDBB FABJRDB7
  FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN
  FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2
  FABJSTA  FABJSTMD FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR
  FABJXHPC FABJXLIM H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK57607

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