PI20067: THIS APAR PROVIDES NEW FUNCTIONS OF IMS HP IMAGE COPY

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides new functions of IMS HP Image Copy V4R2.
  

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 enhances the process of       *
  *                      IMS Command Interface and FALLBACK      *
  *                      of IMS HP Image Copy.                   *
  *                      After apply this maintenance, following *
  *                      processes are available in HP Image     *
  *                      Copy:                                   *
  *                       - FALLBACK is enabled with TOIAUTO or  *
  *                         TOIAUTO_Q                            *
  *                       - HP Image Copy issues /START command  *
  *                         for the database that has been       *
  *                         stopped before JOB starts when       *
  *                         TOIAUTO_STA=Y is specified in        *
  *                         the GLOBAL statement.                *
  *                                                              *
  *                      This enhancement is for RFE 54469.      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides following enhancements for IMS HP Image Copy
  V4 R2:
  -  FALLBACK is enabled with TOIAUTO or TOIAUTO_Q
  -  HP Image Copy issues /START command for the database that
     has been stopped before JOB starts when TOIAUTO_STA=Y is
     specified in the GLOBAL statement.
  
       *** *** *** *** *** *------* *** *** *** *** ***
       *** *** ***          Notice          *** *** ***
       *** *** *** *** *** *------* *** *** *** *** ***
       * After applying this maintenance, FALLBACK=Y  *
       * process is enabled with TOIAUTO=Y or         *
       * TOIAUTO_Q=Y. If you specify both keywords    *
       * in the GLOBAL statement or site default,     *
       * HP Image Copy tries fallback process for     *
       * the database that can not stopped by         *
       * IMS command.                                 *
       *** *** *** *** *** ******** *** *** *** *** ***
  

Problem conclusion

Temporary fix

Comments

• This enhancement is for RFE 54469.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Image Copy for z/OS User's Guide
  (SC19-2756-01) is changed as follows:
  
  Running IMS HP Image Copy
    IMS HP Image Copy control statements and keywords
      ICEIN control statement keywords
        TOIAUTO_STA keyword
  
  << Add new keyword >>
  
  TOIAUTO_STA keyword
  
  The TOIAUTO_STA keyword specifies the offline database to start
  after IMS HP Image Copy creates batch image copies.
  
  If this keyword is specified, IMS HP Image Copy issues the
  /START command through the IMS Tools Online System Interface to
  start the offline database.  You can use this keyword, for
  example, when you want to create image copies of an offline
  database and then bring the database online immediately after
  the image copies are created.
  
  Default value
    TOIAUTO_STA=N
  
  Statements that support this keyword
    GLOBAL statement
  
  Site default option
    Supported
  
  Related keywords
    TOITIME keyword
  
  Format
    TOIAUTO_STA=Y|N
  
  Y
  Issues the /START command through the IMS Tools Online System
  Interface to start the offline database after the batch image
  copy process completes.  This option can be applied for a
  database, partition, or area that was manually stopped before
  the IMS HP Image Copy job started.
  
  The /START command is always issued with the GLOBAL option
  (/START GLOBAL).
  
  
  N
  Does not issue the /START command to start the database.
  
  
  Usage notes
  - To specify TOIAUTO_STA=Y, the following conditions must be
    satisfied:
    - All the load libraries of IMS HP Image Copy, IMS Tools
      Online System Interface, and, if used, IMS HP Image Copy
      site default module must be APF-authorized.
    - DBRC must be used (DBRC=Y).
    - Database data sets or areas must be registered to DBRC.
  - If TOIAUTO_STA=Y is specified but the target IMS is not
    online, IMS HP Image Copy continues the processing as
    TOIAUTO_STA=N.
  - IRLM must be active.  If IRLM is not active, the command is
    rejected.  For more information, see the topics about /START
    commands in IMS Commands.
  
  &#215;**** PE14/11/14 FIX IN ERROR. SEE APAR PI29115  FOR DESCRIPTION
  

APAR Information

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

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

  UI22159

Modules/Macros

• FABJACQG FABJAPIM FABJARCA FABJARC0 FABJASPM
  FABJATRC FABJBRLA FABJBRLB FABJBRL2 FABJBRL3 FABJBRL9 FABJCMDB
  FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO
  FABJDALS FABJDAPI FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB
  FABJDBD2 FABJDBD3 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB
  FABJDBR2 FABJDBR3 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA
  FABJDFCB FABJDFC2 FABJDFC3 FABJDFC9 FABJDMPA FABJDMPB FABJDMP0
  FABJDMP2 FABJDMP3 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPS2
  FABJDPS3 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI
  FABJFCCA FABJFCCB FABJFCCM FABJFCC2 FABJFCC3 FABJFCC9 FABJFCDA
  FABJFCDB FABJFCD2 FABJFCD3 FABJFCD9 FABJFDMP FABJGDGB FABJGLRP
  FABJGVT0 FABJICDD FABJIDXA FABJIDXB FABJIDX2 FABJIDX3 FABJIDX9
  FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJITKB FABJITP1 FABJLINK
  FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDP2 FABJMDP3 FABJMDP9
  FABJMRGE FABJMSGC FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD
  FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORC2 FABJORC3 FABJORC9
  FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCH2 FABJRCH3
  FABJRCH9 FABJRDBA FABJRDBB FABJRDB2 FABJRDB3 FABJRDB9 FABJRETC
  FABJRETM FABJRFCA FABJRFCB FABJRFC2 FABJRFC3 FABJRFC9 FABJRPT0
  FABJRPT1 FABJSAS1 FABJSAS2 FABJSDBK FABJSTA  FABJSTMD FABJTERM
  FABJTGEN FABJTGET FABJTOI  FABJTOI2 FABJUIC1 FABJXCR  FABJXHPC
  FABJXLIM H1J0420J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI22159

     UP14/10/15 P F410

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.