PK26299: THIS APAR PROVIDES ENHANCEMENT FOR GROUP AND DEDB PROCESS.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides enhancement for GROUP and DEDB process.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC V4R1 supports GROUP processing of  *
  *                      DBDSGRP defined as DB group or RECOV    *
  *                      group.                                  *
  *                                                              *
  *                      This APAR also includes fix for HPIC    *
  *                      Create Image Copy function.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  HPIC V4R1 supports GROUP processing of DBDSGRP defined as DB
  group or RECOV group.
  
  This APAR also includes fix for following problem:
  - HPIC Create Image Copy function terminates with ABEND S0C1
    ( ABEND0C1 ), when the input image copy data set is allocated
    by JCL DD statement and HPIC V4R1 PTF UK14116 ( APAR PK23701 )
    is applied.
  

Problem conclusion

Temporary fix

Comments

• FABJBLKD has been modified to add the new symbols for group
  process.
  
  FABJMAIN and FABJCRC0 have been modified to close the DBD
  library after processing of the group record in the DBRC.
  
  FABJDBDN has been modified to get the information of DEDB areas
  from DBD library, when the AREA= keyword is not specified in the
  ICEIN control statement.
  
  FABJDBRC has been modified to get the group member name of DBGRP
  and RECOVGRP in the DBRC.
  
  FABJMSGC has been modified to add a new message.
  
  FABJRCHK has been modified to bypass the logic that treats the
  DBGRP as an error.
  
  FABJRPT0 has been modified to report the group type for DBGRP
  and RECOVGRP.
  
  FABJCRC0 and FABJCRC1 have been modified to bypass the logic
  that checks VOLUME sequence numbers, when the input image copy
  data set is allocated by the JCL DD statement.
  
  The following modules have been reassembled.
    FABJACQG  FABJAPIM  FABJATRC  FABJCMDB  FABJCRC3  FABJCTCV
    FABJCZCV  FABJDALC  FABJDALO  FABJDALS  FABJDBCM  FABJDBC1
    FABJDBD7  FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK  FABJDBR7
    FABJDBR8  FABJDBR9  FABJDCTL  FABJDEMP  FABJDFCN  FABJDFC7
    FABJDFC8  FABJDFC9  FABJDMPN  FABJDMP0  FABJDMP7  FABJDMP8
    FABJDMP9  FABJDOPN  FABJDPSN  FABJDPS7  FABJDPS8  FABJDPS9
    FABJDPUT  FABJDREQ  FABJDRQS  FABJFCAI  FABJFCCM  FABJFCCN
    FABJFCC7  FABJFCC8  FABJFCC9  FABJFCDN  FABJFCD7  FABJFCD8
    FABJFCD9  FABJGDGB  FABJGLRP  FABJICDD  FABJIDXN  FABJIDX7
    FABJIDX8  FABJIDX9  FABJINT1  FABJINT2  FABJINT3  FABJIPRC
    FABJMAS1  FABJMDPN  FABJMDP7  FABJMDP8  FABJMDP9  FABJMRGE
    FABJNTFC  FABJNTFI  FABJORCN  FABJORC7  FABJORC8  FABJORC9
    FABJPARM  FABJPRM2  FABJPRM3  FABJRCH7  FABJRCH8  FABJRCH9
    FABJRDB7  FABJRDB8  FABJRDB9  FABJRETC  FABJRETM  FABJRFCN
    FABJRFC7  FABJRFC8  FABJRFC9  FABJSAS1  FABJSAS2  FABJSTA
    FABJTERM  FABJTGEN  FABJTOI   FABJUIC1  FABJXCR   FABJXHPC
    FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409-00 ( SC18940900 ) should be changed as
  follows:
  
  1 Chapter1. Introduction
   1.1 HPIC Various Functions
    1.1.1 Image Copy Function
     1.1.1.8 Database Group Processing
  
  <DEL> Note: HPIC does not support a DBDS group defined as a DBD
    type member.
  <ADD>
  | Note: If you use DB group type of DBDS group, you consider
  | following things:
  |  - DB group must indicate DBD name or partition name of HALDB
  |    that is registerd in DBRC.
  |  - When DB group indicates AREA name, HPIC ignores it.
  
   1.5 Restrictions
    1.5.2 Restrictions on the Image Copy Function
  
  <ADD>
  | If you use DB group type of DBDS group, you consider
  | following things:
  |  - DB group must indicate DBD name or partition name of HALDB
  |    that is registerd in DBRC.
  |  - When DB group indicates AREA name, HPIC ignores it.
  
    1.5.3 Restrictions on the Create Image Copy Function
  
  <ADD>
  | If you use DB group type of DBDS group, you consider
  | following things:
  |  - DB group must indicate DBD name or partition name of HALDB
  |    that is registerd in DBRC.
  |  - When DB group indicates AREA name, HPIC ignores it.
  
  2 Chapter2. Operating Instructions
   2.3 Input
    2.3.4 HPIC Control Statements
     2.3.4.3 IC/AIC Statement
  
    Mandatory keywords:
     DBD=
  <DEL> AREA= (if DEDB is to be copied)
  
     2.3.4.4 CIC/ACIC Statement
  
    Mandatory keywords:
     DBD=
  <DEL> AREA= (if DEDB is to be copied)
  
     2.3.4.6 CRC Statement
  
    The CRC statement invokes the Create Image Copy process for
    the specified image copy data set of the database data set or
    the area data set. The CRC statement requires the DBD=
  | parameter.
  <DEL> and the DDN= or the AREA= parameter.
  
    The following keywords are mandatory in CRC statement:
  <DEL> Either AREA= or DDN=
     Either ICOUT= or STACK=
  
    2.3.5 ICEIN Keywords
  
    Table 10. ICEIN keywords
    +-------------------------+--------------------------+-------+
    |             |Parameters |                          |       |
    |             +-+-+-+-+-+-+                          |       |
    |             |G|G|I|C|R|C|                          |       |
    |   Keyword   |L|R|C|I|C|R|          Meaning         |Related|
    |             |O|O| |C|V|C|                          |keyword|
    |             |B|U| | | | |                          |       |
    |             |A|P| | | | |                          |       |
    |             |L| | | | | |                          |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
           :            :                   :                :
    +-------------+-+-+-+-+-+-+--------------------------+-------+
  | |AREA=areaname| | |O|O|S|O|Specifies the area name in|       |
    |             | | | | | | |a DEDB to be processed.   |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
           :            :                   :                :
    +-------------+-+-+-+-+-+-+--------------------------+-------+
  | |DDN=ddname   | | |O|O|S|O|Specifies the DD name of  |       |
    |             | | | | | | |the DBDS data set that is |       |
    |             | | | | | | |to be processed. If this  |       |
    |             | | | | | | |parameter is omitted, all |       |
    |             | | | | | | |DBDSs in the database are |       |
    |             | | | | | | |processed by the HPIC     |       |
    |             | | | | | | |Image Copy function. If   |       |
    |             | | | | | | |RCV is specified for the  |       |
    |             | | | | | | |parameter, only the first |       |
    |             | | | | | | |DBDS is processed.        |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
  
     2.3.5.2 AREA=
  
    The AREA keyword specifies the name of an area in the database
    to be processed. The AREA keyword is valid only for DEDB.
  
    +-----------------------------------+
    |  AREA=areaname                    |
    +-----------------------------------+
  
    where:
    areaname is the name of an area in a database.
  
    This keyword does not have a default.
  
  <DEL> This keyword in conjunction with the DBD keyword is
    required in the following control statements if the database
    to be processed is a DEDB:
  <ADD>
  | This keyword can be used in the following control statements:
      IC, AIC, CIC, ACIC, CRC, RCV
  
     2.3.5.12 DBDSGRP=
  
    The DBDSGRP keyword specifies the name of a database data set
    group (DBDS) registered in the DBRC RECON data set.
  <ADD>
  | The following group types can be specified to be group name.
  |   DBDS group
  |   DB group
  |   Recovery group
  
    +-----------------------------------+
    |  DBDSGRP=groupname                |
    +-----------------------------------+
  
    where:
    groupname is the name of the DBDS group. All DBDSs defined in
    the database data set are processed by the HPIC Image Copy
    function.
  
    This keyword does not have a default.
  
  <ADD>
  | If you use DB group type of DBDS group, you consider
  | following things:
  |  - DB group must indicate DBD name or partition name of HALDB
  |    that is registerd in DBRC.
  |  - When DB group indicates AREA name, HPIC ignores it.
  
  
   2.4 Output
    2.4.3 Image Copy Dump Process Report
  
    The Image Copy information shows the following information:
  
    DBD
      The name of the processed DBD.
    DDN | AREA
      The ddname of the processed DBDS or the area name.
  <CHG>
  | DBDSGRP | CAGRP | DBGRP | RECOVGRP
  |   The group name of the DBDSGRP, DBGRP, RECOVGRP or CAGRP that
      is processed. When the Image Copy function is not processed
      in groups, this item is not reported.
  
    2.4.5 Create Image Copy Report
  
    The Input image copy data set information shows the following
    information:
  
    DBD
      The name of the processed DBD.
    DDN | AREA
      The ddname of the processed DBDS or the area name.
  <CHG>
  | DBDSGRP | CAGRP | DBGRP | RECOVGRP
  |   The group name of the DBDSGRP, DBGRP, RECOVGRP or CAGRP that
      is processed. When the Create Image Copy function is not
      processed in groups, this item is not reported.
  
  Appendix A. Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ0191I is added.
  
  | FABJ0191I GROUP MEMBER DBD=dbdname IN GROUP NAME=grpname IS
  | NOT REGISTERED WITH DBRC
  |
  | Explanation: A member of DBD=dbdname in a GROUP NAME=grpname
  |              is not registered with DBRC.
  |              Note: If you use DB group type of DBDS group, you
  |              consider following things:
  |              - DB group must indicate DBD name or partition
  |                name of HALDB that is registerd in DBRC.
  |              - When DB group indicates AREA name, HPIC ignores
  |                it.
  | System action: Program FABJMAIN ignores the member and
  |                continues processing.
  | 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:

  UK15515

Modules/Macros

• FABJACQG FABJAPIM FABJATRC FABJBLKD 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 FABJDRQS FABJFCAI FABJFCCM FABJFCCN
  FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9
  FABJGDGB FABJGLRP FABJICDD FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9
  FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPN
  FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC FABJNTFC FABJNTFI
  FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3
  FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9
  FABJRETC FABJRETM FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0
  FABJSAS1 FABJSAS2 FABJSTA  FABJTERM FABJTGEN FABJTOI  FABJUIC1
  FABJXCR  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK15515

     UP06/06/20 P F606

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.