PK18978: HPIC GENERATES GDG BASE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HPIC generates Base information for Generation Dataset
  Group (GDG) automatically, if base information does not
  exist.
  

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 provides a new keyword parameter   *
  *                      GDGBASE= for allocating GDG base        *
  *                      information. When the GDGBASE=Y is      *
  *                      specified, HPIC checks existence of     *
  *                      a catalog entry for a generation data   *
  *                      group and creates the entry if needed.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  HPIC provides a new keyword parameter GDGBASE= for allocating
  GDG base information. When the GDGBASE=Y is specified, HPIC
  checks existence of a catalog entry for a generation data group
  and creates the entry if needed.
  

Problem conclusion

Temporary fix

Comments

• A new module FABJGDGB has been created.
  This module generates the DEFINE GENERATIONDATAGROUP command and
  call IDCAMS utility.
  
  FABJMAIN and FABJCRC0 have been modified to call new function of
  FABJACQG that is for creating GDG base.
  
  FABJACQG has been modified to create a control block for
  defining GDG base and call FABJGDGB.
  
  FABJPARM, FABJSTMD and FABJTGEN have been modified to support
  the keyword parameters GDGBASE= and GDGLIMIT=.
  
  FABJBLKD has been modified to add new fields for GDGBASE= and
  GDGLIMIT=.
  
  FABJCALL has been modified for calling FABJGDGB.
  
  FABJMSGC has been modified to add a new message.
  
  FABJGLRP has been modified to support new keywords GDGBASE= and
  GDGLIMIT=.
  
  ========================
  = 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:
  
  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:
       :
  |     GDGBASE=
  |     GDGLIMIT=
  
    2.3.5 ICEIN Keywords
  Add following sub section in following section
  
  | 2.3.5.xx GDGBASE=
  | The GDGBASE keyword specifies whether the HPIC Image Copy
  | function is to create a catalog entry for a generation data
  | group.
  | +---------------------------------------------------------+
  | | GDGBASE=Y|N                                             |
  | +---------------------------------------------------------+
  | where:
  | Y
  |    Specifies that the HPIC Image Copy function creates a
  |    catalog entry for a generation data group, if the catalog
  |    entry does not exist.
  |
  | N
  |    If you specify the HPIC Image Copy function does not
  |    create a catalog entry for a generation data group.
  |    This is the default.
  |
  | This keyword can be used in the following control statements:
  |    GLOBAL
  
  | 2.3.5.xx GDGLIMIT=
  | The GDGLIMIT keyword specifies the maximum number of
  | generation data sets that can be associated with the GDG being
  | defined.
  | +---------------------------------------------------------+
  | | GDGLIMIT=nnn                                            |
  | +---------------------------------------------------------+
  | where:
  | nnn
  |    is the left-justified maximum number of generation data
  |    sets that can be associated with the GDG being defined.
  |    The number can be specified from 1 to 255.
  |    The default value is 10.
  |
  | 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
  
  |     GDGBASE
  |     GDGLIMIT
  
  A.0Appendix A.  Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ3938E is added.
  
  | FABJ3938E DEFINE GDG FAILED. IDCAMS RETURNED ABNORMAL
  | CONDITION CODE.
  |
  | Explanation: IDCAMS DEFINE GENERATIONDATAGROUP failed. The
  | reason and code is shown by IDCAMS messages in ICEPRINT.
  |
  | System Action: FABJMAIN issues a user error abend code of
  | 3938.
  |
  | Programmer Response: Check IDCAMS messages, Correct any
  | errors, and rerun the job.
  

APAR Information

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

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

  UK11429

Modules/Macros

• FABJACQG FABJBLKD FABJCALL FABJCRC0 FABJGDGB
  FABJGLRP FABJLINK FABJMAIN FABJMSGC FABJPARM FABJSTMD FABJTGEN
  H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK11429

     UP06/02/07 P F602

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.