PH40359: HP IMAGE COPY RECALLING MIGARATED DATABASE DATA SET

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HP Image Copy recalling migarated database data set
  

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: Image Copy function: RECALL keyword     *
  *                      support. The RECALL keyword recalls     *
  *                      input database data sets if the input   *
  *                      database data sets are migrated by      *
  *                      DFSMShsm so that the Image Copy         *
  *                      function can process the database data  *
  *                      sets.                                   *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Image Copy function: RECALL keyword support. The RECALL keyword
  recalls input database data sets if the input database data sets
  are migrated by DFSMShsm so that the Image Copy function can
  process the database data sets
  

Problem conclusion

• The documentation changes for this APAR has been refrected the
  IMS HP Image Copy Uer's guide SC19-2756-07. ( SC19275607 ).
  The user's guide is availbel on : https://www.ibm.com/support
  /pages/ims-tools-product-documentation
  
  Configuring IMS HP Image Copy
  > Completing IMS HP Image Copy installation
   > Hardware and software prerequisites Software requirements
  :
  Conditional operational requisites
  To use the following features, you must install additional
  products:
  :
  | RECALL option
  |  - IBM z/OS DFSMShsm (5650-ZOS)
  
  Running IMS HP Image Copy
  > Control statements and keywords
   > RECALL keyword
  
  | RECALL keyword
  | The RECALL keyword recalls input database data sets if the
  | data sets are migrated by DFSMShsm. To apply the RECALL
  | option, DFSMShsm must be started in the system and the input
  | database data sets must be SMS-managed data sets.
  
  | Functions that support this keyword
  |   Image Copy function
  | Statements that support this keyword
  |   GLOBAL statement
  | Site default option
  |   Supported
  | Related keywords
  |   None.
  | Format
  |    RECALL=Y|N
  
  |    Y   Recalls the migrated input database data sets.
  |    N   Does not recall the input database data sets even
  |        if the data sets are migrated.
  
  | Default value
  |   RECALL=N
  
  | Usage note:
  | Do not use the RECALL option for non-SMS-managed data sets.
  | If the RECALL option is applied to non-SMS-managed data sets,
  | the Image Copy function issues DFSMShsm macro to recall the
  | data sets but the result is unpredictable.
  
  Troubleshooting > Messages and codes > Messages
  | FABJ0404E CANNOT RECALL DATA SET DUE TO AN ERROR IN ARCHRCAL.
  |           RC=rc, RSN=rsn, DBD=dbdname, DDN/AREA=ddname,
  |           DATA SET=dsname
  | Explanation
  | Failed to recall migrated data set dsname. The ARCHRCAL macro
  | of DFSMShsm returned an error indication, which is shown with
  | RC=rc and RSN=rsn.
  | System action
  | Program FABJMAIN stops processing with a return code of 16.
  | User response
  | Locate associated DFSMShsm messages (ARCnnnni) in the job log
  | and resolve the problem. If the problem persists, contact IBM
  | Software Support.
  
  | FABJ0405E RECALL IS NOT PERFORMED DUE TO AN ERROR IN ARCHSEND.
  |           RC=rc, RSN=rsn
  | Explanation
  | The Image Copy function issued the DFSMShsm ARCHSEND macro to
  | check the hsm task in the system but the macro returned an
  | error indication, which is shown with RC=rc and RSN=rsn.
  | System action
  | Program FABJMAIN stops processing with a return code of 16.
  | User response
  | Locate associated DFSMShsm messages (ARCnnnni) in the job log
  | and resolve the problem.  If the problem persists, contact IBM
  | Software Support.
  
  | FABJ0406E DFSMSHSM IS NOT RUNNING IN THE SYSTEM. ARCHSEND
  |           RC=100, RSN=yy
  | Explanation
  | DFSMShsm is not active. RC and RSN show return code and reason
  | code from the ARCHSEND macro.
  | System action
  | Program FABJMAIN stops processing with a return code of 16.
  | User response
  | Start DFSMShsm in your system.
  

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:

  UI77874

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 FABJIGWI FABJINT1
  FABJINT2 FABJINT3 FABJIPRC FABJISDD FABJLINK 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 FABJRCAL 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
  FABJTYPF FABJUIC1 FABJWCRD FABJXCR  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI77874

     UP21/11/03 P F111  

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.