PM28291: THIS APAR PROVIDES NEW FUNCTION OF HP IMAGE COPY V4.2

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides new function of HP Image Copy V4.2.
  

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 enhancements of the  *
  *                      following keywords:                     *
  *                      1. FASTIC= keyword.                     *
  *                      2. DBALL= keyword.                      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes following enhancements:
  1. For third operand of FASTIC= keyword, new parameters for
     FCTOPPRCPrimary option of DFSMSdss are added.
     - FCTOPPRCP(PRESMIRREQ)
     - FCTOPPRCP(PRESMIRPREF)
     - FCTOPPRCP(PMR)
     - FCTOPPRCP(PMP)
     These new parameters are ignored when FASTIC=DUMP or
     FASTIC=FDUMP is specified.
  
  2. For first operand of DBALL= keyword, new parameter, XIDX, is
     added. When XIDX is specified, HP image copy searches the
     DBDSs which have logical relationships with each others and
     processes these DBDSs only. Their related indexes are not
     searched and not processed.
  

Problem conclusion

Temporary fix

Comments

• The following modules are modified for this APAR:
   FABJBLKD FABJCSIF FABJDBAL FABJDFCN FABJDFC9 FABJDFCA FABJDFCB
   FABJDFC2 FABJDSSB FABJFCCM FABJGLRP FABJMAIN FABJOFL1 FABJPARM
   FABJRFCN FABJRFC9 FABJRFCA FABJRFCB FABJRFC2 FABJSTMD FABJSTMP
   FABJTGEN FABJRPT1
  
  The following modules have been reassembled.
   FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1
   FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBCM
   FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD2 FABJDBD9 FABJDBF0
   FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR2 FABJDBR9 FABJDCTL
   FABJDDIM FABJDEMP FABJDMPA FABJDMPB FABJDMPN FABJDMP0 FABJDMP2
   FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS2 FABJDPS9
   FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCA FABJFCCB
   FABJFCCN FABJFCC2 FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD2
   FABJFCD9 FABJFDMP FABJGDGB FABJICDD FABJIDXA FABJIDXB FABJIDXN
   FABJIDX2 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAS1
   FABJMDPA FABJMDPB FABJMDPN FABJMDP2 FABJMDP9 FABJMRGE FABJMSUL
   FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJORCA FABJORCB
   FABJORCN FABJORC2 FABJORC9 FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB
   FABJRCHK FABJRCH2 FABJRCH9 FABJRDBA FABJRDBB FABJRDB2 FABJRDB9
   FABJRETC FABJRETM FABJRPT0 FABJSAS1 FABJSAS2 FABJSTA  FABJTERM
   FABJTOI  FABJTOI2 FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
  
  
  ========================
  = 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:
  
  
  3.0  Running IMS HP Image Copy
       IMS HP Image Copy JCL statements
         ICEIN control statement keywords
           DBALL keyword
  
       The DBALL keyword specifies whether the Image Copy function
       is to search the Logical Group DBDSs automatically.
       When you request that all DBDS, which are logically related
       database, are to be searched, IMS HP Pointer Checker is
       required.
  
  |    Note:
  |    Logical Group is the term of IMS HP Image Copy. Logical
  |    Group is the group of databases which have logical
  |    relationships with each others and their related indexes.
  
       Statements
          that support this keyword GLOBAL statement
  
       Site default
          option Supported
  
       Related keyword
          None.
  
  
       Format
  |  ____________________________________________________
  | |                                                    |
  | |  DBALL=Y|XIDX|N|(Y|XIDX,Y|N)                       |
  | |____________________________________________________|
  |
  |   First operand
  |   Y
  |    specifies that the Image Copy function searches the Logical
  |    Group DBDSs from the DBD and that it processes the Image
  |    Copy function for those DBDSs.
  |
  |   XIDX
  |    specifies that the Image Copy function searches the DBDSs
  |    which have logical relationships with each others and that
  |    it processes the Image Copy function for those DBDSs. Their
  |    related indexes are not searched and not processed.
  |
  |   N
  |    If you specify N, the Image Copy function does not search
  |    the Logical Group DBDSs. N is the default.
  |
  |   Second operand
  |    If you omit the second subparameter, N is used as the
  |    default.
  |
  |   Y
  |    The timestamps of IC data sets for logically related
  |    databases are the same.
  |
  |   N
  |    The timestamps of IC data sets for logically related
  |    databases are not the same.
  
  
      Notes:
  |    1. When ICOUT=ddname is specified, DBALL=Y|XIDX 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 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.
  |    3. If you specify DBALL=(N,Y) in GLOBAL statement, HPIC
  |       terminates RC=16 with DBALL operand error.
  |    4. If you specify DBALL=Y|XIDX and DBDALLOC=N in ICEIN
  |       statement, DBALL=Y|XIDX is ignored.
  |    5. DBALL= keyword dose not support DEDB and Fast Path
  |       Secondary Index.
  |    6. When DBALL=XIDX and IDXSRCH=Y are specified, Image Copy
  |       function processes DBDSs as follows:
  |       - At first, Image Copy function searches the related
  |         primary and secondary index DBDSs from the DBD using
  |         IDXSRCH=Y function.
  |       - Next, Image Copy function searches the DBDSs which
  |         have logical relationships with each others using
  |         DBALL=XIDX function.
  
  
  3.0  Running IMS HP Image Copy
       IMS HP Image Copy JCL statements
         ICEIN control statement keywords
           FASTIC keyword
  
     opt
  |     FCTOPPRCP | FCTOPPRCP(sub-opt)
        specifies that the DFSMSdss FCTOPPRCPrimary option is to
        be used in the DFSMSdss COPY command. For details, see the
        description about the FCTOPPRCPrimary keyword in the z/OS
        DFSMSdss Storage Administration Reference.
  
  |     Note: The FCTOPPRCP option is valid only when it is
  |     specified for the FASTIC=(,COPY) processing.
        The release level of DFSMSdss must be higher than Version
        1 Release 6, because the FCTOPPRCP option is supported by
        DFSMSdss Version 1 Release 6 or higher.
  
  |     You can confirm the information of FCTOPPRCP from the
  |     following web page:
  |     z/OS V1R10.0 DFSMS Storage Administration Reference (for
  |     DFSMSdfp, DFSMSdss, DFSMShsm) SC26-7402-12
  |
  |     http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS
  |     /dgt2s272/2.3.7.5.29?SHELF=DGT2BK81.bks&DT=20090227163444
  
  |     sub-opt
  |     The following sub-option can be used in the
  |     FCTOPPRCPrimary option.
  |
  |     PRESMIRREQ
  |       specifies that the DFSMSdss FCTOPPRCPrimary option with
  |       PRESMIRREQ sub-keyword is to be used in the DFSMSdss
  |       COPY command.
  |       abbreviation: PMR
  |
  |     PRESMIRPREF
  |       specifies that the DFSMSdss FCTOPPRCPrimary option with
  |       PRESMIRPREF sub-keyword is to be used in the DFSMSdss
  |       COPY command.
  |       abbreviation: PMP
  |
  |     Note:
  |       PRESMIRREQ and PRESMIRPREF are mutually exclusive.
  |       The release level of DFSMSdss must be higher than
  |       Version 1 Release 10, because the PRESMIRREQ and
  |       PRESMIRPREF sub-keyword are supported by DFSMSdss
  |       Version 1 Release 10 or higher.
  

APAR Information

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

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

  UK63533

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD
  FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCSIF FABJCTCV FABJCZCV
  FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA
  FABJDBDB FABJDBDN FABJDBD2 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA
  FABJDBRB FABJDBRC FABJDBR2 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP
  FABJDFCA FABJDFCB FABJDFCN FABJDFC2 FABJDFC9 FABJDMPA FABJDMPB
  FABJDMPN FABJDMP0 FABJDMP2 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB
  FABJDPSN FABJDPS2 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN
  FABJDSSB FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC2
  FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD2 FABJFCD9 FABJFDMP
  FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX2
  FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1
  FABJMDPA FABJMDPB FABJMDPN FABJMDP2 FABJMDP9 FABJMRGE FABJMSUL
  FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA
  FABJORCB FABJORCN FABJORC2 FABJORC9 FABJPARM FABJPRM2 FABJPRM3
  FABJRCHA FABJRCHB FABJRCHK FABJRCH2 FABJRCH9 FABJRDBA FABJRDBB
  FABJRDB2 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN
  FABJRFC2 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA
  FABJSTMD FABJSTMP FABJTERM FABJTGEN FABJTOI  FABJTOI2 FABJUIC1
  FABJXCR  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK63533

     UP11/01/05 P F101

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.