PK37981: FABJMAIN ISSUES MESSAGE FABJ3916E RC=04 RSN=04100000, AND MESSAGE FABJ3917E

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• FABJMAIN issues message FABJ3916E RC=04 RSN=04100000, and
  Message FABJ3917E for a database ddname.
  DYNALLOC has been done twice, once by an IMS module, and again
  by FABJMAIN, in this case.
  

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 terminates ABEND U3916 RSN 410     *
  *                      ( ABENDU3916 ), when the library for    *
  *                      MDA member is provided STEPLIB DD and   *
  *                      HDPC=Y is specified.                    *
  *                      Because IMS DB Authorization routine    *
  *                      allocates DBDS before HPIC allocate.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC abends U3916 ( ABENDU3916 ) with message ( MSGFABJ3916 )
   FABJ3916E DYNAMIC ALLOCATION FAILURE OCCURRED FOR DD: ddname
   RC=04 RSN=04100000
  in DBDS dynamic allocation due to duplicate allocation request.
  This symptom occurs when library for MDA member is specified in
  STEPLIB DD and HDPC=Y is requested. Because DBDS members are
  allocated in IMS DB Authorization Routine from MDA member in
  STEPLIB, and HPIC issue DYNALLOC for DBDS that is already
  allocated after calling IMS DB Authorization Routine.
  

Problem conclusion

• By this APAR, HPIC correct order of duynalloc timing of DBDS
  that is Necessary DBDS allocated before taking DB authorization.
  
  And enhance DBALL= optional keyword that control timestamp.
  If you want to create IC data with same timestamp for all
  logical related DB that is found by HPIC, you should specify
  DBALL=(Y,Y).
  
  The new macro FABJDGMT and FABJLGMT are provided.
  
  FABJDMPN, FABJDPSN, FABJDFCN, FABJBRLS and FABJDSSB have been
  modified to issue the dynamic allocation before DBRC
  authorization process.
  
  FABJFCCN and FABJFCDN have been modified to unify the timestamp
  of RUNTIME for Image Copy data set, when DBALL=(Y,Y) is
  specified in the ICEIN control statement.
  
  FABUITCT has been modified to save the address of new HPIC
  control blocks.
  
  FABJPARM, FABJSTMD, FABJTGEN and FABJBLKD have been modified to
  support the new operand of DBALL= keyword.
  
  FABJGLRP has been modified to report the new operand of DBALL=
  keyword to Global Options Report.
  
  The following modules have been reassembled.
    FABJACQG  FABJAPIM  FABJATRC  FABJBRLA  FABJBRL7  FABJBRL8
    FABJBRL9  FABJCMDB  FABJCRC0  FABJCRC1  FABJCRC3  FABJCTCV
    FABJCZCV  FABJDALC  FABJDALO  FABJDALS  FABJDBAL  FABJDBCM
    FABJDBC1  FABJDBDA  FABJDBDN  FABJDBD7  FABJDBD8  FABJDBD9
    FABJDBF0  FABJDBLK  FABJDBRA  FABJDBRC  FABJDBR7  FABJDBR8
    FABJDBR9  FABJDCTL  FABJDDIM  FABJDEMP  FABJDFCA  FABJDFC7
    FABJDFC8  FABJDFC9  FABJDGMT  FABJDMPA  FABJDMP0  FABJDMP7
    FABJDMP8  FABJDMP9  FABJDOPN  FABJDPSA  FABJDPS7  FABJDPS8
    FABJDPS9  FABJDPUT  FABJDREQ  FABJDRQS  FABJFCAI  FABJFCCA
    FABJFCCM  FABJFCC7  FABJFCC8  FABJFCC9  FABJFCDA  FABJFCD7
    FABJFCD8  FABJFCD9  FABJGDGB  FABJICDD  FABJIDXA  FABJIDXN
    FABJIDX7  FABJIDX8  FABJIDX9  FABJINT1  FABJINT2  FABJINT3
    FABJIPRC  FABJLGMT  FABJMAIN  FABJMAS1  FABJMDPA  FABJMDPN
    FABJMDP7  FABJMDP8  FABJMDP9  FABJMRGE  FABJNTFC  FABJNTFI
    FABJNTFS  FABJORCA  FABJORCN  FABJORC7  FABJORC8  FABJORC9
    FABJPRM2  FABJPRM3  FABJRCHA  FABJRCHK  FABJRCH7  FABJRCH8
    FABJRCH9  FABJRDBA  FABJRDB7  FABJRDB8  FABJRDB9  FABJRETC
    FABJRETM  FABJRFCA  FABJRFCN  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 ( SC189409 ) should be changed as
  follows:
  
  2 Operating Instructions
   2.3 Input
    2.3.5.XX DBALL=
    The DBALL keyword specifies whether the HPIC Image Copy
    function is to search the Logical Group DBDSs.
  
    +---------------------------------------------------------+
  | | DBALL=Y|(Y,N)|(Y,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.
  |    The IC timestamp of logical related database are not same.
  |
  | (Y,N)
  |    Specifies that the HPIC Image Copy function searches the
  |    Logical Group DBDSs as well as DBALL=Y.
  |    The timestamp of IC data set for logical related database
  |    are not same.
  |
  | (Y,Y)
  |    Specifies that the HPIC Image Copy function searches the
  |    Logical Group DBDSs as well as DBALL=Y.
  |    The timestamp of IC data set for logical related database
  |    are same.
  |
  | If you omit the second subparameter, 'N' is used as the
  | default.
  |
    N
       If you specify the HPIC Image Copy function does not
       search the Logical Group DBDSs.
       This is the default.
  
  Remove the following sentence:
  | 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
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UK22189

Modules/Macros

• FABJACQG FABJAPIM FABJATRC FABJBLKD FABJBRLA
  FABJBRLS FABJBRL7 FABJBRL8 FABJBRL9 FABJCMDB FABJCRC0 FABJCRC1
  FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL
  FABJDBCM FABJDBC1 FABJDBDA FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9
  FABJDBF0 FABJDBLK FABJDBRA FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9
  FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCN FABJDFC7 FABJDFC8
  FABJDFC9 FABJDGMT FABJDMPA FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8
  FABJDMP9 FABJDOPN FABJDPSA FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9
  FABJDPUT FABJDREQ FABJDRQS FABJDSSB FABJFCAI FABJFCCA FABJFCCM
  FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN FABJFCD7
  FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXN
  FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC
  FABJLGMT FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7 FABJMDP8
  FABJMDP9 FABJMRGE FABJNTFC FABJNTFI FABJNTFS FABJORCA FABJORCN
  FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA
  FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDB7 FABJRDB8
  FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCN FABJRFC7 FABJRFC8
  FABJRFC9 FABJRPT0 FABJSAS1 FABJSAS2 FABJSTA  FABJSTMD FABJTERM
  FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK22189

     UP07/02/16 P F702 Ž

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.