PK17130: THIS APAR PROVIDES NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HPIC Image Copy (new) function finds Index Data base(s)
  automatically and creates VIC.
  

Local fix

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 forward fit of       *
  *                      PK15050 of HPIC V3.2:                   *
  *                        HPIC provides new keyword parameter   *
  *                        IDXSRCH=. When the IDXSRCH=Y is       *
  *                        specified, HPIC searches related      *
  *                        indices from the DBD and creates      *
  *                        VIC automatically.                    *
  *                      This APAR includes the fix for          *
  *                      following problem:                      *
  *                        Work area for each DBDS process is    *
  *                      not freed.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR includes following fixes:
  - Forward fit of PK15050 of HPIC V3.2:
     HPIC provides new keyword parameter IDXSRCH=. When the
     IDXSRCH=Y is specified, HPIC searches related indices from
     the DBD and creates VIC automatically.
  - Work area for each DBDS process is not freed.
  

Problem conclusion

Temporary fix

Comments

• A new module FABJIDX7, FABJIDX8 and FABJIDX9 have been created.
  These modules search the primary and secondary indices DBDS from
  DBD and create HPIC control block.
  
  FABJMAIN has been modified to call FABJIDX7, FABJIDX8 and
  FABJIDX9.
  
  FABJPARM, FABJSTMD and FABJTGEN have been modified to support
  the keyword parameter IDXSRCH=.
  
  FABJBLKD has been modified to add new field for IDXSRCH=.
  
  FABJDBDN has been modified to add the function that is LOAD and
  DELETE the DBD member.
  
  FABJGLRP has been modified to support new keyword IDXSRCH.
  
  FABUOUT has been modified to free the getmain area.
  
  FABJRPT0 has been modified to print reports of related indices.
  
  FABJMSGC has been modified to add a new message.
  
  The following modules have been reassembled.
   FABJACQG FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3
   FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBCM
   FABJDBC1 FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK
   FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDFC7
   FABJDFC8 FABJDFC9 FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9
   FABJDOPN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ
   FABJDRQS FABJFCAI FABJFCCM FABJFCC7 FABJFCC8 FABJFCC9
   FABJFCD7 FABJFCD8 FABJFCD9 FABJGLRP FABJICDD FABJINT1
   FABJINT2 FABJIPRC FABJMAS1 FABJMDP7 FABJMDP8 FABJMDP9
   FABJMRGE FABJNTFC FABJORC7 FABJORC8 FABJORC9 FABJPRM2
   FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9
   FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS2 FABJSTA
   FABJTERM FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
   FABJBUF1
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide: Document Number: SC18-9409-00 ( SC18940900 )
  should be changed as follows:
  
  Chapter 2.0 Operating Instructions
  2.3 Input
   2.3.4 HPIC Control Statements
    2.3.4.1 GLOBAL Statement
     The GLOBAL statement contains the following keywords:
       :
  |     IDXSRCH=
  
    2.3.5 ICEIN Keywords
  Add following sub section in following section
  
  | 2.3.5.xx IDXSRCH=
  | The IDXSRCH keyword specifies whether the HPIC Image Copy
  | function is to search related index DBDS.
  | +---------------------------------------------------------+
  | | IDXSRCH=Y|N                                             |
  | +---------------------------------------------------------+
  | where:
  | Y
  |    Specifies that the HPIC Image Copy function searches the
  |    related primary and secondary indices DBDS from the DBD and
  |    create VIC automatically.
  |    The IDXSRCH keyword requires VIC=Y.
  |
  | N
  |    If you specify the HPIC Image Copy function does not
  |    search the related primary and secondary indices DBDS.
  |    This is the default.
  |
  | This keyword can be used in the following control statements:
  |    GLOBAL
  
  3.0 Site Default Generation Utility
   3.2 Generating a Site Default Table
    3.2.2 Input
  
  |     IDXSRCH
  
  A.0Appendix A.  Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ0190I is added.
  
  | FABJ0190I INDEX DBDS DBD=dbdname DDN=ddname IS FOUND,
  | VIRTUAL IMAGE COPY PROCESS APPLIED.
  |
  | Explanation:
  | Related index DBDS is found. The virtual image copy process
  | applied to the DBDS.
  |
  | System Action: None.
  |
  | Programmer Response: None
  

APAR Information

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

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

  UK10456

Modules/Macros

•    FABJACQG FABJATRC FABJBLKD FABJBUF1 FABJCMDB
  FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO
  FABJDALS FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9
  FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL
  FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPN FABJDMP0
  FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8
  FABJDPS9 FABJDPUT FABJDREQ FABJFCAI FABJFCCM FABJFCCN FABJFCC7
  FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGLRP
  FABJICDD FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2
  FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8
  FABJMDP9 FABJMRGE FABJMSGC FABJNTFC FABJORCN FABJORC7 FABJORC8
  FABJORC9 FABJPARM FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9
  FABJRDB7 FABJRDB8 FABJRDB9 FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9
  FABJRPT0 FABJSAS2 FABJSTA  FABJSTMD FABJTERM FABJTGEN FABJTOI
  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM FABUOUT  H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK10456

     UP06/01/05 P F601

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.