IBM Support

PK28108: THIS APAR PROVIDES NEW FUNCTION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR provides NEW FUNCTION.
    

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 V4R1 allows for the STEPLIB DD     *
    *                      that is not APF authorized.             *
    *                                                              *
    *                                                              *
    *                      HPIC V4R1 supports the following        *
    *                      function and ICEIN keyword, when the    *
    *                      Image Copy function is invoked under    *
    *                      IMS Parallel Reorganization.            *
    *                                                              *
    *                      - High Performance Input/Output         *
    *                        interface to reduce CPU time          *
    *                                                              *
    *                      - Keyword GDGBASE= to allocate GDG base *
    *                        information                           *
    *                                                              *
    *                                                              *
    *                      This APAR includes fixes for following  *
    *                      HPIC V4R1 problems:                     *
    *                                                              *
    *                      1. HPIC Type-B Image Copy function      *
    *                         terminates with ABEND S0C4           *
    *                         ( ABEND0C4 ) when all of the         *
    *                         following conditions are satisfied:  *
    *                       - ICTYPE=B is specified in the HPSIN   *
    *                         control statement                    *
    *                       - The first IC/AIC statement           *
    *                         that is about unnecessary DBD for    *
    *                         IMS Parallel Reorganization is       *
    *                         specified in the ICEIN control       *
    *                         statement                            *
    *                                                              *
    *                      2. HPIC Image Copy function terminates  *
    *                         with ABEND U3938 ( ABENDU3938 ) when *
    *                         the GDGBASE=Y keyword is specified   *
    *                         in the ICEIN control statement.      *
    *                                                              *
    *                      3. HPIC Recovery function generates the *
    *                         unnecessary message FABJ4187W        *
    *                         ( MSGFABJ4187W ) when DFSURDB0 is    *
    *                         invoked by DFSRRC00 with IMS V8.     *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    *                 This APAR level is required to run under     *
    *                 IMS Paralell Reorganization for z/OS,        *
    *                 Version 3 Release 2 (FMID H25N320).          *
    ****************************************************************
    HPIC V4R1 allows for the STEPLIB DD that is not APF authorized
    and continues process without ABEND U0199 ( ABENDU0199 ), when
    HPIC is processed under one of the following conditions.
    - HPIO=N or HPIO=X is specified and processing without using
      the HPIO (High Performance Input/Output ) function.
    - TOIAUTO=N keyword is specified and processing without using
      the IMS Tools Online Interface.
    - FASTIC= keyword is not specified and without using the
      DFSMSdss COPY or DFSMSdss DUMP.
    APF authorization is still required if you run HPIC with one of
    these conditions.
    HPIC V4R1 supports the following function and ICEIN keyword,
    when the Image Copy function is invoked under IMS Parallel
    Reorganization.
    - High Performance Input/Output
      interface to reduce CPU time
    - Keyword GDGBASE= to allocate GDG base
      information
    This APAR includes fixes for following HPIC V4R1 problems:
    1. HPIC Type-B Image Copy function terminates with ABEND S0C4
       ( ABEND0C4 ) when all of the following conditions are
       satisfied:
     - ICTYPE=B is specified in the HPSIN
       control statement
     - The first IC/AIC statement
       that is about unnecessary DBD for
       IMS Parallel Reorganization is
       specified in the ICEIN control
       statement
     In these conditions, HPIC terminates without creating image
     copy data sets and misread the ECB area.
    2. HPIC Image Copy function terminates
       with ABEND U3938 ( ABENDU3938 ) when
       the GDGBASE=Y keyword is specified
       in the ICEIN control statement.
     Because HPIC doesn't clear control block for IDCAMS, HPIC
     mishandles the next pointer of the next IDCAMS command. So the
     unnecessary IDCAMS command is issued and failed.
    3. HPIC Recovery function generates the
       unnecessary message FABJ4187W
       ( MSGFABJ4187W ) when DFSURDB0 is
       invoked by DFSRRC00 with IMS V8.
    

Problem conclusion

Temporary fix

Comments

  • FABJIPRC, FABJINT1, FABJINT2 and FABJDPSN have been modified to
    be able to use the High Performance Input/Output interface with
    the Type-B Image Copy function invoked under IMS Parallel
    Reorganization.
    
    H1J0410J, FABJLINK, FABJINT1 and FABJPRM2 have been modified to
    be able to specify the GDGBASE= keyword in the HPSIN control
    statement.
    
    FABJACQG has been modified to clear control block for IDCAMS
    command.
    
    FABJBLKD, FABJMAIN, FABJRPC0, FABJDMPN, FABJCRC0, FABJRDB7,
    FABJRDB8 and FABJRDB9 have been modified to allow for the
    STEPLIB DD that is not APF authorized.
    
    FABJMSGC has been modified to change the text of the message
    FABJ4199E.
    
    The following modules have been reassembled.
      FABJAPIM  FABJATRC  FABJCMDB  FABJCRC1  FABJCRC3  FABJCTCV
      FABJCZCV  FABJDALC  FABJDALO  FABJDALS  FABJDBCM  FABJDBC1
      FABJDBDN  FABJDBD7  FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK
      FABJDBRC  FABJDBR7  FABJDBR8  FABJDBR9  FABJDCTL  FABJDEMP
      FABJDFCN  FABJDFC7  FABJDFC8  FABJDFC9  FABJDMP0  FABJDMP7
      FABJDMP8  FABJDMP9  FABJDOPN  FABJDPS7  FABJDPS8  FABJDPS9
      FABJDPUT  FABJDREQ  FABJDRQS  FABJFCAI  FABJFCCM  FABJFCCN
      FABJFCC7  FABJFCC8  FABJFCC9  FABJFCDN  FABJFCD7  FABJFCD8
      FABJFCD9  FABJGDGB  FABJGLRP  FABJICDD  FABJIDXN  FABJIDX7
      FABJIDX8  FABJIDX9  FABJINT3  FABJMAS1  FABJMDPN  FABJMDP7
      FABJMDP8  FABJMDP9  FABJMRGE  FABJNTFC  FABJNTFI  FABJORCN
      FABJORC7  FABJORC8  FABJORC9  FABJPARM  FABJPRM3  FABJRCH7
      FABJRCH8  FABJRCH9  FABJRETC  FABJRETM  FABJRFCN  FABJRFC7
      FABJRFC8  FABJRFC9  FABJRPT0  FABJSAS1  FABJSAS2  FABJSTA
      FABJTERM  FABJTGEN  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:
    
    A.0Appendix A.  Return Codes, Abend Codes, and Messages
     A.3 Messages
      A.3.188 FABJ4199E
    
    The message FABJ4199E is changed.
    
    | FABJ4199E APF AUTHORIZATION IS REQUIRED TO USE THE REQUESTED
    | HPIC FUNCTION.
    |
    | Explanation: APF authorization is required to use
    | HP Input/Output interface, DFSMSdss API or IMS Tools Online
    | System Interface to generate an image copy data set or
    | recover a database.
    |
    | System Action: FABJMAIN or DFSURDB0 issues a user error abend
    | code of 0199.
    |
    | Programmer Response: Correct the error, and rerun the job.
    

APAR Information

  • APAR number

    PK28108

  • 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-07-13

  • Closed date

    2006-08-03

  • Last modified date

    2006-09-14

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

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

    UK16880

Modules/Macros

  • FABJACQG FABJAPIM FABJATRC FABJBLKD FABJBUF1
    FABJCMDB FABJCMP3 FABJCMP4 FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV
    FABJCZCV FABJDALC 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
    FABJDSNP FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9
    FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJFIG1 FABJGDGB FABJGLRP
    FABJGVT  FABJGVT0 FABJGWTO FABJICDD FABJIDXN FABJIDX7 FABJIDX8
    FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN
    FABJMAS1 FABJMAS2 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE
    FABJMSGC FABJNTFC FABJNTFI FABJORCN FABJORC7 FABJORC8 FABJORC9
    FABJOSAM FABJPARM FABJPRM2 FABJPRM3 FABJRCHK FABJRCH7 FABJRCH8
    FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCN
    FABJRFC7 FABJRFC8 FABJRFC9 FABJRPC0 FABJRPT0 FABJSAS1 FABJSAS2
    FABJSTA  FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJVSAM FABJXCR
    FABJXHPC FABJXLIM FABUCHG  FABUFIG1 FABUITCT HPSGGSTB H1J0410J
    

Publications Referenced
SC18940900    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R410 PSY UK16880

       UP06/08/05 P F608

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