PK23109: HPIC FASTIC=DUMP TERMINATES WITH ABEND S0C4, BECAUSE GETMAINED BUFFER SIZE IS SHORTER THAN REAL DATA.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HPIC FASTIC=DUMP obtains storage for I/O buffer, but its length
  is shorter than real data. HPIC tried to move longer data into
  the small buffer and terminated with ABEND S0C4.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Image Copy for z/OS Version 4   *
  *                 Release 1 (FMID=H1J0410) users who run       *
  *                 the Advanced Copy Service with Standard HPIC *
  *                 Image Copy Format.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: When HPIC user runs the DUMP request of *
  *                      Advanced Image Copy Service, user gets  *
  *                      ABEND S0C4 ( ABEND0C4 ).                *
  *                      *** Important ***                       *
  *                      DFSMSdss APAR OA18326 is required for   *
  *                      using the DUMP of HPIC Advanced Image   *
  *                      Copy Service.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When you run the DUMP of HPIC Advanced Image Copy Service,
  you may get ABEND S0C4 ( ABEND0C4 ).
  
  The DUMP of HPIC Advanced Image Copy Service allocated DUMMY
  file as output worked data set of DFSMSdss DUMP command. But
  DFSMSdss does not support DUMMY as output, and if it is dummy
  DFSMSdss passes unexpected record to DFSMSdss API.
  
  And DFSMSdss API record delete function for the output data set,
  then unnecessary data set is created when using DUMP of the
  Advanced Image Copy Service.
  
  DFSMSdss maintenance OA18326 is required when you use the DUMP
  of HPIC Advanced Image Copy Service.
  

Problem conclusion

• DFSMSdss APAR OA18326 supports API Record Delete Function
  correctly. This DFSMSdss APAR and HPIC PK23109 is required
  when using the COPY of HPIC Advanced Image Copy Service.
  .
  By the HPIC APAR PK23109 provides new DD ICEFICO that allocates
  temporary data set for DFSMSdss API Sub Address Space. This
  set is optional, but if your environment does not allow to share
  temporary data set in the different address space by RACF
  control of TEMPDSN class.
  
  A new module FABJDDIM has been created for analyzing the ICEFICO
  DD statement.
  
  FABJDSXA and FABJFCDN have been modified to expand the CI buffer
  
  FABJMAIN has been modified as follows:
  - to check the existence of ICEFICO DD statement.
  - to call the new module FABJDDIM, if the ICEFICO DD statement
    exist.
  
  FABJPARM, FABJSTMD, FABJSTMP, FABJTGEN, and FABJBLKD have been
  modified to support the new keyword DSSTEMP=.
  
  FABJDALC has been modified to allocate ICEFICO data set
  dynamically.
  
  FABJGLRP has been modified to report the new keyword DSSTEMP= to
  Global Options Report.
  
  The following modules have been reassembled.
    FABJACQG  FABJAPIM  FABJATRC  FABJCMDB  FABJCRC0  FABJCRC1
    FABJCRC3  FABJCTCV  FABJCZCV  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
    FABJFCD7  FABJFCD8  FABJFCD9  FABJGDGB  FABJICDD  FABJIXDN
    FABJIDX7  FABJIDX8  FABJIDX9  FABJINT1  FABJINT2  FABJINT3
    FABJIPRC  FABJMAS1  FABJMDPN  FABJMDP7  FABJMDP8  FABJMDP9
    FABJMRGE  FABJNTFC  FABJNTFI  FABJORCN  FABJORC7  FABJORC8
    FABJORC9  FABJPRM2  FABJPRM3  FABJRCHK  FABJRCH7  FABJRCH8
    FABJRCH9  FABJRDB7  FABJRDB8  FABJRDB9  FABJRETC  FABJRETM
  
  << Documentantion Change >>
   The documentation is modified as follows:
   ==============================================================
     IMS High Performance Image Copy for z/OS, V4R1,
     User's Guide (SC18940900)
   ==============================================================
  
  2.0 Operating Instructions
  2.2 JCL Requirements
  2.2.1 FABJMAIN JCL
   :
    Table 1. Table 1. DD statements of the FABJMAIN JCL
  | +---------+-------+----------+----------------------+
  | | DDNAME  | USE   | Format   | Required or Optional |
  | +---------+-------+----------+----------------------+
  | | ICEFICO | INPUT | LRECL=80 | Optional             |
  | +---------+-------+----------+----------------------+
   :
  | ICEFICO DD
  |  This optional input data set contains the user-specified
  |  control statements that define the allocation attribute for
  |  the work data set of FASTIC=(,DUMP) process. If this data set
  |  is not defined, uses 'DUMMY', or uses DSN=NULLFILE, HPIC
  |  allocates the temporary data set as a work data set.
  
  |  If you specify DSSTEMP=dsn in GLOBAL statement or Site
  |  Default Table, HPIC allocats the data set as ICEFICO DD.
  
  2.3 Input
  2.3.1 ICEIN Control Statement Data Set
  2.3.4.1 GLOBAL Statement
     :
    The GLOBAL statement contains the following keywords:
     :
  | DSSTEMP=
  
  2.3.5 ICEIN Keywords
  | 3.3.5.x DSSTEMP=
  
  | The DSSTEMP Keyword specifies the data set name for
  | ICEFICO. The data set is specify the allocation information
  | of the work data set of FASTIC=(,DUMP) process.
  | +----------------------------------------------------+
  | | DSSTEMP=dsn                                        |
  | +----------------------------------------------------+
  | where:
  |  dsn
  |   is the data set name that is provides the allocation
  |   attributes for the work data set of FASTIC=(,DUMP) process.
  
  | This keyword does not have a default.
  
  | This keyword can be used in the following control statements:
      GLOBAL
  
  | 2.3.x ICEFICO data set
  |  ICEFICO is the optional input data set that contains the
  |  user-specified control statements that define the allocation
  |  attribute for the work data set of FASTIC=(,DUMP) process.
  
  |  Tape Unit can not be used as DFSMSdss temporaqry workd output
  |  data set.
  
  |  Input Parameters of ICEFICO are :
  |    HLQ=
  |    DATACLAS=
  |    MGMTCLAS=
  |    STORCLAS=
  |    VOLSER=
  |    UNIT=
  
  |  HLQ=
  |  You can specify a High Level Qualifier for the work data
  |  set. You can specify up to a 17 bytes qualifier. HPIC
  |  allocates the data set using the following naming rule:
  |    DSN=hlq.Jnnnnnnn.Dyyyyddd.Thhmmss
  
  |  DATACLAS=
  |  The DATACLAS keyword specifies the name of the data class
  |  for the SMS managed work data set that is dynamically
  |  allocated.
  
  |  MGMTCLAS=
  |  The MGMTCLAS keyword specifies the name of the management
  |  class for the SMS managed work data set that is dynamically
  |  allocated.
  
  |  STORCLAS=
  |  The STORCLAS keyword specifies the name of the storage class
  |  for the SMS managed work data set that is dynamically
  |  allocated
  
  |  VOLSER=
  |  The VOLSER keyword specifies the volume serial number.
  
  |  UNIT=
  |  The UNIT keyword specifies the UNIT parameter of the work
  |  data set.
  
  | EXAMPLE:
  | //ICEFICO  DD *
  |   HLQ=ICSMS1.TESTDS,
  |   DATACLAS=DCICSTN,
  |   MGMTCLAS=MCICSTN,
  |   STORCLAS=SCICSTN
  
  | If you specify a ICEFICO DD, HPIC allocates a work data set
  | for FASTIC=(,DUMP) by providing allocation information. This
  | data is then deleted when the process has ended.
  
  3.0 Site Default Generation Utility
  3.2.2 Input
    :
   The keywords for the Site Default Generation utility are as for
      :
  |  DSSTEMP=
  

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:

  UK20233

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
  FABJDDIM FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPN
  FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7
  FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDSXA 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
  FABJSTMP FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC
  FABJXLIM H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK20233

     UP06/12/05 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.