IBM Support

PK36670: IMAGE COPY ALL LOGICALLY RELATED DATA BASES, WHEN YOU SPECIFY THE DATA BASE HAS LOGICAL RELATIONSHIPS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • HPIC V4 will take all ICs for unspecified DB that are related
    logically,  when you specify the DB that has logical relation
    ship with other DBs.
    

Local fix

  • Apply 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 the new parameter keyword *
    *                      DBALL=. When the DBALL=Y is specified,  *
    *                      HPIC searches logical related databases *
    *                      from the specified database and creates *
    *                      those image copy data sets              *
    *                      automatically.                          *
    *                                                              *
    *                      The maximum number of processed DBDS in *
    *                      HPIC Image Copy function is changed to  *
    *                      4095 from 999.                          *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    HPIC provides the new keyword DBALL=. When the DBALL=Y is
    specified, HPIC searches logical related databases from the
    specified database and creates those image copy data sets
    automatically. The IC timestamp of logical related databases are
    same.
    
    The maximum number of processed DBDS in HPIC Image Copy function
    is changed to 4095 from 999.
    
    +--------------------------------------------------------------+
    |The DBALL= keyword is effective when you apply APAR PK33419   |
    |to IMS High Performance Pointer Checker for z/OS Version 2    |
    |Release 2 ( FMID=HPC2220 ) is required.                       |
    +--------------------------------------------------------------+
    

Problem conclusion

Temporary fix

Comments

  • A new module FABJDBAL is provided that searches logical related
    databases from specified DBD and creates HPIC control block,
    and sorts sequence of HPIC Image Copy process by logical
    relation ship.
    
    FABJMAIN, FABJICDD, FABJCALL, FABJFCDN, FABJFCCN, FABJDPSN,
    FABJDFCN, and FABJDMPN have been modified to searches some
    logical related databases and to creates the image copy data
    sets of the searched databases.
    
    FABJDOPN, FABJDALO, FABJMAIN, FABJICDD, FABJDPSN, and FABJDFCN
    have been modified to change the maximum number of dynamically
    allocated image copy data sets DDname 999 to 4095.
    
    FABJPARM, FABJSTMD, FABJTGEN, and FABJBLKD have been modified to
    support the new keyword DBALL=.
    
    FABJGLRP has been modified to report the new keyword DBALL to
    Global Options Report.
    
    FABJMSGC has been modified to add the new messages.
    
    The following modules have been reassembled.
      FABJACQG  FABJAPIM  FABJATRC  FABJCMDB  FABJCRC0  FABJCRC1
      FABJCRC3  FABJCTCV  FABJCZCV  FABJDALC  FABJDALS  FABJDBCM
      FABJDBC1  FABJDBD7  FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK
      FABJDBR7  FABJDBR8  FABJDBR9  FABJDCTL  FABJDDIM  FABJDEMP
      FABJDFC7  FABJDFC8  FABJDFC9  FABJDMP0  FABJDPUT  FABJDREQ
      FABJDRQS  FABJFCAI  FABJFCCM  FABJGDGB  FABJIDX7  FABJIDX8
      FABJIDX9  FABJINT2  FABJINT3  FABJIPRC  FABJMAS1  FABJMDP7
      FABJMDP8  FABJMDP9  FABJMRGE  FABJNTFC  FABJNTFI  FABJORC7
      FABJORC8  FABJORC9  FABJPRM2  FABJPRM3  FABJRCH7  FABJRCH8
      FABJRCH9  FABJRDB7  FABJRDB8  FABJRDB9  FABJRETC  FABJRETM
      FABJRFC7  FABJRFC8  FABJRFC9  FABJRPT0  FABJSAS1  FABJSAS2
      FABJSTA   FABJTERM  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:
    
    2 Operating Instructions
     2.3 Input
      2.3.4 HPIC Control Statements
       2.3.4.1 GLOBAL Statement
      The GLOBAL statement contains the following keywords:
        :
    | . DBALL=
        :
    
    |  2.3.5.XX DBALL=
    | The DBALL keyword specifies whether the HPIC Image Copy
    | function is to search the Logical Group DBDSs.
    |
    | +---------------------------------------------------------+
    | | DBALL=Y|N                                               |
    | +---------------------------------------------------------+
    |
    | where:
    | Y
    |    Specifies that the HPIC Image Copy function searches the
    |    Logical Group DBDSs from the DBD and processes the Image
    |    Copy function those DBDSs.
    |
    | N
    |    If you specify the HPIC Image Copy function does not
    |    search the Logical Group DBDSs.
    |    This is the default.
    |
    | The IC timestamp of logical related database are all same.
    |
    | Notes:
    |  - Parameter of DBALL=Y and ICOUT=ddname is exclusive.
    |    But automatically found DBDS are only index DBs and VIC=Y
    |    is specified, the VIC is processed.
    |  - The operational parameter for automatically searched
    |    database is used  with the operational parameters of the
    |    first specified database in logical relation in ICEIN.
    |
    | This keyword can be used in the following control statements:
    |    GLOBAL
    
    3 Site Default Generation Utility
     3.2 Generating a Site Default Table
      3.2.2 Input
      The keywords for the Site Default Generation utility are as
      follows:
        :
    | . DBALL=
        :
    
    A.0 Appendix A. Return Codes, Abend Codes, and Messages
     A.3 Messages
    
    The message FABJ0194I is added.
    | FABJ0194I DATABASE LOGICAL GROUP MEMBER DBD=dbdname DDN=ddname
    | IS FOUND, IMAGE COPY PROCESS APPLIED.
    |
    | Explanation: The Logical Group DBDS is found. The Image Copy
    | function is processed about this DBDS.
    |
    | System Action: None.
    |
    | Programmer Response: None.
    
    The message FABJ0195W is added.
    | FABJ0195W DBD dbdname NOT FOUND IN DBDLIB. IMAGE COPY PROCESS
    | IS BYPASSED.
    |
    | Explanation: The Logical Group DBDS is found. But, the DBD
    | member of this DBDS was not found in the DBD library
    | that is specified in the IMS DD statement in the JCL. The
    | Image Copy function is not processed about this DBDS.
    |
    | System Action: FABJMAIN continues processing without this
    | DB. The return code of the process is 04.
    |
    | Programmer Response: Make sure that the correct DBD library
    | was specified in the IMS DD statement.
    
    The message FABJ0196W is added.
    | FABJ0196W DBALL=Y IS IGNORED BECAUSE OF HPPC CONDITION.
    |
    | Explanation: Keyword DBALL=Y is specified in the ICEIN control
    | statement, but is ignored, for one of the following reasons.
    |  - Not supported Version and Release of the HPPC library.
    |  - Not found HPPC library.
    |
    | System Action: FABJMAIN continues processing without the
    | Logical Group search. The return code of the process is 04.
    |
    | Programmer Response: If you wish, correct the error and rerun
    | the job.
    

APAR Information

  • APAR number

    PK36670

  • Reported component name

    IMS HP IMAGE CO

  • Reported component ID

    5655K9600

  • Reported release

    410

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2006-12-26

  • Closed date

    2006-12-27

  • Last modified date

    2007-01-04

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

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

    002PC0Ÿ UK20936 002PC0Ÿ

Modules/Macros

  • FABJACQG FABJAPIM FABJATRC FABJBLKD FABJCALL
    FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC
    FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDN FABJDBD7
    FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8
    FABJDBR9 FABJDCTL FABJDDIM 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
    FABJLINK 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
    FABJSTMD FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC
    FABJXLIM H1J0410J
    

Publications Referenced
SC18940900    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R410 PSY UK20936

       UP06/12/29 P F612

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"4.1.0","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020