PM21942: IMS HP IMAGE COPY PRE-CONDITIONING SUPPORT FOR IMS V12

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Pre-conditioning support for IMS.
  KEYWORDS: IMSV12TGT/K
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 ( FMID=H1J0420 ) users   *
  *                 who use IMS Version 12.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables IMS High Performance  *
  *                      Image Copy for z/OS Version 4 Release 2 *
  *                      to run with IMS Version 12 (5635-A03).  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  has been modified to support IMS Version 12.
  
  *** Notes ***
  - When you use HASH check option for Full Function databases
    on IMS Version 12 environment, you need to apply the following
    APAR to IMS High Performance Pointer Checker for z/OS
    Version 3 Release 1 (5655-U09):
     - PM21945
  - When you use HASH check option for DEDB on IMS Version 12
    environment, you need to apply the following APAR to IMS Fast
    Path Solution Pack for z/OS Version 1 Release 1 (5655-W14):
     - PM21939
  

Problem conclusion

Temporary fix

Comments

• IMS High Performance Image Copy for z/OS Version 4 Release 2
  has been modified to support IMS Version 12.
  
  HP Image Copy supports the Fast Path Secondary Index for DEDB
  database.
  
  Restrictions:
  - EAV OSAM database is not supported.
  - Virtual Image Copy process (VIC=Y) is not applied to the Fast
    Path Secondary Index that is specified in IC, AIC, CIC, ACIC
    or GROUP statement.
  - HP Image Copy function terminates with an unexpected result
    when all of the following conditions are satisfied:
    - Input database is Fast Path Secondary Index.
    - HDPC=Y is specified.
    - Fast Path Secondary Index is specified in IC, AIC, CIC, ACIC
      or GROUP statement
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-00 ( SC19275600 ) should be changed as
  follows:
  
  1.0 Introduction
        IMS HP Image Copy overview
          IMS HP Image Copy terminology
  
    Abbreviations used in this information
    To make this information easier to read, the version and
    release levels of IMS are abbreviated, as follows:
      IMS Version 9 refers to IMS Version 9 Release 1.
      IMS Version 10 refers to IMS Version 10 Release 1.
      IMS Version 11 refers to IMS Version 11 Release 1.
  |   IMS Version 12 refers to IMS Version 12 Release 1.
    The various versions of IMS are referred to simply as IMS,
    except where distinctions among them need to be made.
  
  1.0 Introduction
        IMS HP Image Copy overview
          IMS HP Image Copy information
  
  Add the following information in the table.
    +--------------+---------------------------------------------+
  | |IMS DBRC Guide|IMS Version 12 System Administration         |
    |and Reference |IMS Version 12 Command Volume 3              |
    +--------------+---------------------------------------------+
  | |IMS System    |IMS Version 12 System Definition             |
    |Definition    |                                             |
    |Guide         |                                             |
    +--------------+---------------------------------------------+
  | |IMS Command   |IMS Version 12 Command Volume 1 and Volume 2 |
    |Reference     |                                             |
    +--------------+---------------------------------------------+
  | |IMS Messages  |IMS Version 12 Messages and Codes Vol.1,     |
    |and Codes     |Vol 2, and Vol. 3                            |
    +--------------+---------------------------------------------+
  | |IMS System    |IMS Version 12 System Utilities              |
    |Utilities     |                                             |
    |Reference     |                                             |
    +--------------+---------------------------------------------+
  | |IMS Database  |IMS Version 12 Database Utilities            |
    |Utilities     |                                             |
    |Reference     |                                             |
    +--------------+---------------------------------------------+
  
  3.4 IMS HP Image Copy JCL statements
        ICEIN control statement keywords
          DBALL keyword
  
    Notes:
      1.When ICOUT=ddname is specified, DBALL=Y is ignored for
        that statement. However, when ICOUT=ddname, DBALL=Y, and
        VIC=Y are specified, IMS HP Image Copy searches for an
        index database that has logical relationship with the
        specified database, and creates a virtual image copy for
        that index database.
      2.For the optional parameter for the auto-searched DBDS, the
        first DBDS optional parameter that is specified for ICEIN
        in the same Logical Group is used.
  
    Default value
      DBALL=N
  
  | Restrictions:
  |   The DBALL keyword is not effective for the Fast Path
  |   Secondary Index for DEDB database.
  
  3.4 IMS HP Image Copy JCL statements
        ICEIN control statement keywords
          IDXSRCH keyword
  
    The IDXSRCH keyword specifies whether the Image Copy function
    is to search related index DBDS while creating virtual image
    copies.
  
    Statements that support this keyword
      GLOBAL statement
    Site default option
      Supported
    Related keyword
      VIC keyword
  
    Format
      +---------------------------------------------+
      | IDXSRCH=Y|N                                 |
      +---------------------------------------------+
    Y
      specifies that the Image Copy function searches the related
  |   primary index DBDS's for DL/I database and secondary index
  |   DBDS's for DL/I Database and DEDB area from the DBD and
      create VIC automatically. The IDXSRCH keyword requires
      VIC=Y.
    N
      specifies that the Image Copy function does not search the
      related primary or the secondary index DBDS's. N is the
      default.
  
    Default value
      IDXSRCH=N
  
    Related reference
      "VIC keyword" in topic 3.4.2.99
      The VIC keyword specifies whether the Image Copy function
      processes virtual image copies for primary and secondary
      index databases.
  

APAR Information

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

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

  UK62577

Modules/Macros

• FABDDATE FABJACHK FABJACQG FABJAMSI FABJAPIB
  FABJAPIM FABJAPIS FABJARCA FABJARC0 FABJASPM FABJATRC FABJBLKD
  FABJBRLA FABJBRLB FABJBRLS FABJBRL2 FABJBRL9 FABJBUF0 FABJBUF1
  FABJCMDB FABJCMP1 FABJCMP2 FABJCMP3 FABJCMP4 FABJCP4S FABJCP40
  FABJCRC0 FABJCRC1 FABJCRC3 FABJCST0 FABJCTCV FABJCZCV FABJDALC
  FABJDALO FABJDALS FABJDATE FABJDBAL FABJDBCM FABJDBC1 FABJDBDA
  FABJDBDB FABJDBDN FABJDBD2 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA
  FABJDBRB FABJDBRC FABJDBR2 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP
  FABJDFCA FABJDFCB FABJDFCN FABJDFC2 FABJDFC9 FABJDIAG FABJDLST
  FABJDMPA FABJDMPB FABJDMPN FABJDMP0 FABJDMP2 FABJDMP9 FABJDOPN
  FABJDPSA FABJDPSB FABJDPSN FABJDPS2 FABJDPS9 FABJDPUT FABJDREQ
  FABJDRQS FABJDRSN FABJDSNP FABJESSV FABJFCAI FABJFCCA FABJFCCB
  FABJFCCM FABJFCCN FABJFCC2 FABJFCC9 FABJFCDA FABJFCDB FABJFCDN
  FABJFCD2 FABJFCD9 FABJFDMP FABJFIG1 FABJGDGB FABJGLRP FABJGVT
  FABJGVT0 FABJGWTO FABJHKI  FABJHKTB FABJHSHL FABJICDD FABJIDXA
  FABJIDXB FABJIDXN FABJIDX2 FABJIDX9 FABJIGWI FABJINT1 FABJINT2
  FABJINT3 FABJIPRC FABJLINK FABJLIST FABJLPRT FABJMAC0 FABJMAIN
  FABJMAS1 FABJMAS2 FABJMDPA FABJMDPB FABJMDPN FABJMDP2 FABJMDP9
  FABJMOD0 FABJMPC0 FABJMRGE FABJMSGC FABJMSGP FABJMSGS FABJMSG0
  FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1
  FABJORCA FABJORCB FABJORCN FABJORC2 FABJORC9 FABJPARM FABJPRM2
  FABJPRM3 FABJRCHA FABJRCHB FABJRCHK FABJRCH2 FABJRCH9 FABJRDBA
  FABJRDBB FABJRDB0 FABJRDB2 FABJRDB9 FABJRETC FABJRETD FABJRETM
  FABJRETP FABJRETS FABJRFCA FABJRFCB FABJRFCN FABJRFC2 FABJRFC9
  FABJRPC0 FABJRPTH FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA
  FABJSTMP FABJSTMS FABJTERM FABJTGEN FABJTOI  FABJTOI2 FABJUHKT
  FABJUIC1 FABJVERS FABJWLDL FABJXCR  FABJXHPC FABJXLIM FABJZCPD
  FABJZCP1 FABJZCP2 FABJZCP3 FABJZCP4 FABUARCN FABUDHD8 FABUFIG1
  H1J0420J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK62577

     UP10/11/30 P F011

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.