IBM Support

PM95690: IF THE LENGTH OF PARTITION NAME OF HALDB IS ONE BYTE, HP IMAGE COPY TERMINATES WITH ERROR MESSAGE DFS310A

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If the input database is HALDB and the length of its partition
    name is one byte, HP Image Copy fails to pick up DBDS name and
    terminates with error msg DFS310A.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
    *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
    ****************************************************************
    * PROBLEM DESCRIPTION: This APAR fixes the following problems. *
    *                                                              *
    *                      1. If the length of HALDB partition     *
    *                         name is less than 2 bytes, HP Image  *
    *                         Copy terminates with one of the      *
    *                         following errors:                    *
    *                                                              *
    *                         - Error message DFS310A              *
    *                           ( MSGDFS310A ) when Image Copy     *
    *                           function is scheduled by the       *
    *                           following conditions:              *
    *                           - FABJMAIN program                 *
    *                           - IMS Parallel Reorganization with *
    *                             TYPE=B process of IMS            *
    *                             Reorganization Expert            *
    *                           - IMS Online Reorganization        *
    *                             Facility.                        *
    *                         - Error message DSP0111I             *
    *                           ( MSGDSP0111I ) when Image Copy    *
    *                           function is scheduled by IMS       *
    *                           compatible JCL                     *
    *                         - Error message DFS854A              *
    *                           ( MSGDFS854A ) when the Recovery   *
    *                           function is scheduled by either    *
    *                           FABJMAIN program or IMS            *
    *                           Compatible JCL.                    *
    *                                                              *
    *                      2. If DDN= keyword or AREA= keyword is  *
    *                         omitted on ICEIN control card when   *
    *                         HP Image Copy runs under the control *
    *                         of the following IMS Tools, HP Image *
    *                         Copy terminates with error and       *
    *                         message FABJ0181E ( MSGFABJ0181E ):  *
    *                                                              *
    *                         This problem occurs under the        *
    *                         following conditions:                *
    *                         - HP Image Copy is scheduled by one  *
    *                           of the following:                  *
    *                           - IMS Reorganization Expert.       *
    *                           - IMS Fast Path Advanced Tool in   *
    *                             IMS HP Fast Path Utilities.      *
    *                           - IMS Fast Path Online Tool in IMS *
    *                             HP Fast Path Utilities.          *
    *                                                              *
    *                      3. The speed of processing slows down   *
    *                         when HP Image Copy uses HPIO=Y for   *
    *                         the following database organization: *
    *                         - PSINDEX                            *
    *                         - HISAM                              *
    *                         - SHISAM                             *
    *                         - P-Index                            *
    *                         - S-Index                            *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    This APAR fixes the following problems.
    
    1. If the length of HALDB partition name is less than 2 bytes,
       HP Image Copy terminates with one of the following errors:
    
       - Error message DFS310A ( MSGDFS310A ) when Image Copy
         function is scheduled by the following conditions:
         - FABJMAIN program
         - IMS Parallel Reorganization with TYPE=B process of IMS
           Reorganization Expert
         - IMS Online Reorganization Facility.
       - Error message DSP0111I ( MSGDSP0111I ) when Image Copy
         function is scheduled by IMS compatible JCL
    
       - Error message DFS854A ( MSGDFS854A ) when the Recovery
         function is scheduled by either FABJMAIN program or IMS
         Compatible JCL.
    
       The cause of this problem is that HP Image Copy misinterprets
       the rule of minimum length of partition name of HALDB. Then
       HP Image Copy regards the 1 byte partition name as an error.
    
    2. If DDN= keyword or AREA= keyword is omitted on ICEIN control
       card when HP Image Copy runs under the control of the
       following IMS Tools, HP Image Copy terminates with error and
       message FABJ0181E ( MSGFABJ0181E ):
    
       This problem occurs under the following conditions:
       - HP Image Copy is scheduled by one of the following:
         - IMS Reorganization Expert.
         - IMS Fast Path Advanced Tool in
           IMS HP Fast Path Utilities.
         - IMS Fast Path Online Tool in IMS
           HP Fast Path Utilities.
    
       When HP Image Copy runs under the control of other IMS Tools,
       a list of target database data set names is passed from
       parent tool. If ICEIN control statement is specified in the
       JCL, HP Image Copy compares and merges the process options in
       the list and ICEIN control statement. The cause of this
       problem is that HP Image Copy can not merge correctly and
       makes same database data set name entry in the control block.
       Then it is regarded as duplicate process request.
    
    3. The speed of processing slows down when HP Image Copy uses
       HPIO=Y for the following database organization:
       - PSINDEX
       - HISAM
       - SHISAM
       - P-Index
       - S-Index
    
       HPIO does not use the buffer numbers in DCB or VSAM ACB for
       I/O, so HP Image Copy sets minimum number of buffer for OPEN
       process. But HP Image Copy does not use HPIO for VSAM KSDS
       data set. Even though HP Image Copy sets minimum number of
       buffer and processes VSAM GET/PUT for KSDS database. HP Image
       Copy should use optimized buffer number for KSDS always.
    

Problem conclusion

  • The following modules and macros are modified for this APAR:
      FABJDMPA FABJDMPB FABJDMPN FABJDMP2 FABJDMP3 FABJDMP9 FABJDOPN
      FABJDPSA FABJDPSB FABJDPSN FABJDPS2 FABJDPS3 FABJDPS9 FABJPRM2
      FABJRDBA FABJRDBB FABJRDB2 FABJRDB3 FABJRDB9 FABUITCT
    
    The following modules have been reassembled.
      FABJAPIM FABJCMDB FABJCRC0 FABJCRC3 FABJDBAL FABJDCTL FABJDEMP
      FABJDFC2 FABJDFC3 FABJDFC9 FABJDFCA FABJDFCB FABJDMP2 FABJDMP3
      FABJDMP9 FABJDMPA FABJDMPB FABJDOPN FABJDPS2 FABJDPS3 FABJDPS9
      FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJFCCM FABJFCC2
      FABJFCC3 FABJFCC9 FABJFCCA FABJFCCB FABJFCD2 FABJFCD3 FABJFCD9
      FABJFCDA FABJFCDB FABJFDMP FABJINT1 FABJINT2 FABJINT3 FABJIPRC
      FABJMAIN FABJMAS1 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA
      FABJTERM FABJTOI
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PM95690

  • Reported component name

    IMS HP IMAGE CO

  • Reported component ID

    5655K9600

  • Reported release

    420

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-08-22

  • Closed date

    2013-09-20

  • Last modified date

    2013-10-04

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

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

    UK97722

Modules/Macros

  • FABJAPIM FABJCMDB FABJCRC0 FABJCRC3 FABJDBAL FABJDCTL FABJDEMP
    FABJDFCA FABJDFCB FABJDFC2 FABJDFC3 FABJDFC9 FABJDMPA FABJDMPB
    FABJDMP2 FABJDMP3 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPS2
    FABJDPS3 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJFCCA FABJFCCB
    FABJFCCM FABJFCC2 FABJFCC3 FABJFCC9 FABJFCDA FABJFCDB FABJFCD2
    FABJFCD3 FABJFCD9 FABJFDMP FABJINT1 FABJINT2 FABJINT3 FABJIPRC
    FABJMAIN FABJMAS1 FABJNTFC FABJNTFI FABJOFL0 FABJOFL1 FABJPRM2
    FABJRDBA FABJRDBB FABJRDB2 FABJRDB3 FABJRDB9 FABJRPT0 FABJRPT1
    FABJSAS1 FABJSAS2 FABJSTA  FABJTERM FABJTOI  FABJTOI2 FABJUIC1
    FABJXCR  FABJXHPC
    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R420 PSY UK97722

       UP13/09/21 P F309

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.2.0","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020