IBM Support

PK76238: THIS APAR FIXES SEVERAL HPIC PROBLEMS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • This APAR fixes several problems found during internal testing.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
    *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
    ****************************************************************
    * PROBLEM DESCRIPTION: This APAR includes fixes for following  *
    *                      problems:                               *
    *                                                              *
    *                      - HPIC Image Copy function terminates   *
    *                        with an unexpected error when all     *
    *                        of the following conditions are       *
    *                        satisfied:                            *
    *                        - FASTIC=(,COPY) and OFFLDTYPE=S are  *
    *                          specified.                          *
    *                        - Creating secondary image copy is    *
    *                          requested.                          *
    *                        - LRECL size of the input database is *
    *                          smaller than 64 byte.               *
    *                                                              *
    *                      - HPIC Recovery function terminates     *
    *                        with ABEND U0001 ( ABENDU0001 ) when  *
    *                        HPIO=Y is specified for OSAM          *
    *                        database.                             *
    *                                                              *
    *                      - HPIC Recovery function terminates     *
    *                        with ABEND S300 ( ABEND300 ) when     *
    *                        HPIO=Y is specified for OSAM database *
    *                        in dirty getmain environment.         *
    *                                                              *
    *                      - HPIC terminates with ABEND S23E-8     *
    *                        ( ABEND23E RSN8 ) when DBRC=Y is      *
    *                        specified in IMS version 10           *
    *                        environment.                          *
    *                                                              *
    *                      - HPIC Diagnostics Aid ( FABJDIAG )     *
    *                        does not show APAR numbers correctly  *
    *                        for DFSUDMP0, DBFUMDP0 and DFSURDB0.  *
    *                                                              *
    *                      - HPIC Recovery function ignores        *
    *                        TIMECHK=N parameter in IMS version 10 *
    *                        environment.                          *
    *                                                              *
    *                      - HPIC Create Image Copy function       *
    *                        terminates with RC=08 and message     *
    *                        FABJ0140E ( MSGFABJ0140E ) when all   *
    *                        of the following conditions are       *
    *                        satisfied:                            *
    *                        - HPIC is running in IMS version 10.  *
    *                        - The value of MINVERS in RECON data  *
    *                          set is '9.1' or lower.              *
    *                        - The input image copy data set is    *
    *                          created by IMS Database Recovery    *
    *                          Facility (DRF) or IMS Parallel      *
    *                          Reorganization (IPR).               *
    *                                                              *
    *                      - HPIC Image Copy function reports the  *
    *                        compression routine name to ICERPRT   *
    *                        DD although compression processing is *
    *                        canceled and issues message           *
    *                        FABJ9100W ( MSGFABJ9100W ).           *
    *                                                              *
    *                      - HPIC Create Image Copy function       *
    *                        terminates with ABEND S0C4            *
    *                        ( ABEND0C4 ) in the CHANGE.IC command *
    *                        build process when the input or       *
    *                        output image copy data set resides on *
    *                        5 or more volumes.                    *
    *                                                              *
    *                      - HPIC Image Copy function fails in     *
    *                        registering CHANGE.IC result to IMS   *
    *                        Tools Knowledge Base (ITKB) Output    *
    *                        Repository when all of the following  *
    *                        conditions are satisfied:             *
    *                        - FASTIC=(,COPY) is specified.        *
    *                        - OFFLDTYPE=S or F is specified.      *
    *                        - DBRC=Y is specified.                *
    *                        - ITKB is active.                     *
    *                        - Creating secondary image copy is    *
    *                          requested.                          *
    *                                                              *
    *                      - HPIC Image Copy function registers    *
    *                        invalid IC record in the RECON data   *
    *                        set when all of the following         *
    *                        conditions are satisfied:             *
    *                        - Failing in creating both primary    *
    *                          and secondary image copy data set.  *
    *                        - The target database type is DEDB.   *
    *                        - FASTIC=(,DUMP) is specified.        *
    *                                                              *
    *                      - HPIC Recovery function terminates     *
    *                        with RC=08 and message DFS312A        *
    *                        ( MSGDFS312A ) when one of the        *
    *                        following conditions is satisfied:    *
    *                        - DBRC=Y is specified and failing in  *
    *                          the DBRC authorization process.     *
    *                        - DBRC=N is specified.                *
    *                                                              *
    *                      - HPIC terminates with ABEND S001-5     *
    *                        ( ABEND001 RSN5 ) when the specified  *
    *                        input in ICEIN DD ends with comma.    *
    *                                                              *
    *                      - The message id of FABJ3905E           *
    *                        ( MSGFABJ3905E ) and user abend code  *
    *                        U3905 ( ABENDU3905 ) that indicate    *
    *                        the error of DEVTYPE macro is         *
    *                        incorrect. The message id and user    *
    *                        abend code are changed to             *
    *                        FABJ3811E/U3811 correctly.            *
    *                                                              *
    *                      - HPIC Image Copy/Create Image Copy     *
    *                        function terminates with ABEND U3916  *
    *                        ( ABENDU3916 ) and message FABJ3916E  *
    *                        RSN=0450 ( MSGFABJ3916E RSN0450 )     *
    *                        when the target DEDB has over 1616    *
    *                        areas.                                *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    This APAR includes fixes for following problems:
    
    - HPIC Image Copy function terminates with an unexpected error
      when all of the following conditions are satisfied:
      - FASTIC=(,COPY) and OFFLDTYPE=S are specified.
      - Creating secondary image copy is requested.
      - LRECL size of the input database is smaller than 64 byte.
    
    - HPIC Recovery function terminates with ABEND U0001
      ( ABENDU0001 ) when HPIO=Y is specified for OSAM database.
    
    - HPIC Recovery function terminates with ABEND S300 ( ABEND300 )
      when HPIO=Y is specified for OSAM database in dirty getmain
      environment.
    
    - HPIC terminates with ABEND S23E-8 ( ABEND23E RSN8 ) when
      DBRC=Y is specified in IMS version 10 environment.
    
    - HPIC Diagnostics Aid ( FABJDIAG ) does not show APAR numbers
      correctly for DFSUDMP0, DBFUMDP0 and DFSURDB0.
    
    - HPIC Recovery function ignores TIMECHK=N parameter in IMS
      version 10 environment.
    
    - HPIC Create Image Copy function terminates with RC=08 and
      message FABJ0140E ( MSGFABJ0140E ) when all of the following
      conditions are satisfied:
      - HPIC is running in IMS version 10.
      - The value of MINVERS in RECON data set is '9.1' or lower.
      - The input image copy data set is created by IMS Database
        Recovery Facility (DRF) or IMS Parallel Reorganization
        (IPR).
    
    - HPIC Image Copy function reports the compression routine name
      to ICERPRT DD although compression processing is canceled and
      issues message FABJ9100W ( MSGFABJ9100W ).
    
    - HPIC Create Image Copy function terminates with ABEND S0C4
      ( ABEND0C4 ) in the CHANGE.IC command build process when the
      input or output image copy data set resides on 5 or more
      volumes.
    
    - HPIC Image Copy function fails in registering CHANGE.IC result
      to IMS Tools Knowledge Base (ITKB) Output Repository when all
      of the following conditions are satisfied:
      - FASTIC=(,COPY) is specified.
      - OFFLDTYPE=S or F is specified.
      - DBRC=Y is specified.
      - ITKB is active.
      - Creating secondary image copy is requested.
    
    - HPIC Image Copy function registers invalid IC record in the
      RECON data set when all of the following conditions are
      satisfied:
      - Failing in creating both primary and secondary image copy
        data set.
      - The target database type is DEDB.
      - FASTIC=(,DUMP) is specified.
    
    - HPIC Recovery function terminates with RC=08 and message
      DFS312A ( MSGDFS312A ) when one of the following conditions is
      satisfied:
      - DBRC=Y is specified and failing in the DBRC authorization
        process.
      - DBRC=N is specified.
    
    - HPIC terminates with ABEND S001-5 ( ABEND001 RSN5 ) when the
      specified input in ICEIN DD ends with comma.
    
    - The message id of FABJ3905E ( MSGFABJ3905E ) and user abend
      code U3905 ( ABENDU3905 ) that indicate the error of DEVTYPE
      macro is incorrect. The message id and user abend code are
      changed to FABJ3811E/U3811 correctly.
    
    - HPIC Image Copy/Create Image Copy function terminates with
      ABEND U3916 ( ABENDU3916 ) and message FABJ3916E RSN=0450
      ( MSGFABJ3916E RSN0450 ) when the target DEDB has over 1616
      areas.
    

Problem conclusion

  • FABJCRC1 has been modified as follows:
    - To use the time stamp of 14-digit format ( yyyydddhhmmsst )
      when all of the following conditions are satisfied:
      - IMS version that is stored in the header record of input
        image copy data set is V10R1 or higher.
      - Value of MINVERS in RECON data set is '10.1' or lower.
    - To release the storage that is used for the input image copy
      data set.
    FABJDBCM has been modified to check the end of volume list
    correctly in the CHANGE.IC command build process.
    FABJDEMP, FABJDPSN, FABJDPUT, FABJDRQS and FABJMAS1 have been
    modified not to report the compression routine name to ICERPRT
    DD when the compression processing is canceled.
    FABJFCDN has been modified as follows:
    - To obtain the storage using the correct length for the
      secondary image copy data set in offload processing.
    - Not to report the compression routine name to ICERPRT DD when
      the compression processing is canceled.
    - Not to register the image copy record to the DBRC when all of
      the following conditions are satisfied:
      - Input database is DEDB.
      - FASTIC=(,DUMP) is specified.
      - Failing in creating both primary and secondary image copy
        data set.
    FABJOINT has been modified as follows:
    - To wait the completion of I/O before the CLOSE macro for the
      DBDS that is extended on the same volume when HPIC needs to
      write beyond the end of the current extent.
    - To clear the HPIC control block.
    FABJRDB7, FABJRDB8 and FABJRDB9 have been modified to check the
    organization of input image copy data set and determine type of
    image copy when one of the following conditions is satisfied:
    - Failing in the DBRC authorization process.
    - DBRC=N is specified.
    FABJRDBA has been modified as follows:
    - To check the organization of input image copy data set and
      determine the type of image copy when one of the following
      conditions is satisfied:
      - Failing in the DBRC authorization process.
      - DBRC=N is specified.
    - To check the correct position of the TIMECHK parameter in the
      SYSIN control card.
    FABJRFCN has been modified to change the message id from
    FABJ3905E to FABJ3811E and the user abend code from U3905 to
    U3811.
    FABJSTMS has been modified to notify the end of ICEIN DD to
    modules FABJPARM and FABJPRM2.
    FABJUIC1 has been modified to register the result of CHANGE.IC
    command that is issued in offload process to IMS Tools Knowledge
    Base Output Repository.
    FABUARCN has been modified not to issue the unnecessary DETACH
    macro to the subtask.
    FABUMOD0 has been modified to show the APAR numbers correctly
    for the CSECT name of DFSUDMP0, DBFUMDP0 and DFSURDB0.
    FABJBLKD has been modified to add the flag that is managed for
    allocation of DEDB.
    FABJMAIN has been modified to bypass the process that checks
    whether the input database is allocated by JCL DD using AREA
    name for the DEDB.
    FABJDALO has been modified to allocate and unallocate the
    database of DEDB using the correct DD name. DD name is used as
    follows:
    - The ADSDD name is used when DBRC is active.
    - The AREA name is used when DBRC is not active.
    FABJFCCN has been modified to call the module FABJDALO that
    unallocates the primary image copy data set in the
    FASTIC=(,COPY) process.
    FABJRCHK has been modified to change the DSECT of HPIC control
    block.
    FABJMDPN has been modified to issue the DELETE macro for IMS
    modules DFSUCP40 and DFSUCP80.
    FABJPARM, FABJPRM2 have been modified to check the return code
    from the module FABJSTMS in the last record process of ICEIN DD.
    FABJBRLS has been modified to pass the parameter list to BRLSC
    macro correctly.
    
    The following modules have been reassembled.
      FABJACQG  FABJAPIM  FABJARC0  FABJASPM  FABJATRC  FABJBRL7
      FABJBRL8  FABJBRL9  FABJBRLA  FABJCMDB  FABJCRC0  FABJCRC3
      FABJCTCV  FABJCZCV  FABJDALC  FABJDALS  FABJDBAL  FABJDBC1
      FABJDBDN  FABJDBD7  FABJDBD8  FABJDBD9  FABJDBDA  FABJDBF0
      FABJDBLK  FABJDBRC  FABJDBR7  FABJDBR8  FABJDBR9  FABJDBRA
      FABJDCTL  FABJDDIM  FABJDFCN  FABJDFC7  FABJDFC8  FABJDFC9
      FABJDFCA  FABJDMP0  FABJDMPN  FABJDMP7  FABJDMP8  FABJDMP9
      FABJDMPA  FABJDOPN  FABJDPS7  FABJDPS8  FABJDPS9  FABJDPSA
      FABJDREQ  FABJDRSN  FABJFCAI  FABJFCCM  FABJFCC7  FABJFCC8
      FABJFCC9  FABJFCCA  FABJFCD7  FABJFCD8  FABJFCD9  FABJFCDA
      FABJGDGB  FABJGLRP  FABJICDD  FABJIDXN  FABJIDX7  FABJIDX8
      FABJIDX9  FABJIDXA  FABJINT1  FABJINT2  FABJINT3  FABJIPRC
      FABJMDP7  FABJMDP8  FABJMDP9  FABJMDPA  FABJMOD0  FABJMRGE
      FABJMSUL  FABJNTFC  FABJNTFI  FABJNTFS  FABJOFDD  FABJOFL0
      FABJOFL1  FABJORCN  FABJORC7  FABJORC8  FABJORC9  FABJORCA
      FABJPRM3  FABJRCH7  FABJRCH8  FABJRCH9  FABJRCHA  FABJRETC
      FABJRETM  FABJRFC7  FABJRFC8  FABJRFC9  FABJRFCA  FABJRPT0
      FABJRPT1  FABJSAS1  FABJSAS2  FABJSTA   FABJTERM  FABJTGEN
      FABJTOI   FABJXCR   FABJXHPC  FABJXLIM
    

Temporary fix

Comments

  • ×**** PE09/04/07 FIX IN ERROR. SEE APAR PK84204  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PK76238

  • Reported component name

    IMS HP IMAGE CO

  • Reported component ID

    5655K9600

  • Reported release

    410

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2008-11-21

  • Closed date

    2008-12-01

  • Last modified date

    2009-04-14

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

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

    UK42033

Modules/Macros

  • FABJACQG FABJAPIM FABJARC0 FABJASPM 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 FABJDMPA FABJDMPN FABJDMP0 FABJDMP7
    FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSN FABJDPS7 FABJDPS8
    FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCA
    FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN
    FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXA
    FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3
    FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7 FABJMDP8
    FABJMDP9 FABJMOD0 FABJMRGE FABJMSUL FABJNTFC FABJNTFI FABJNTFS
    FABJOFDD FABJOFL0 FABJOFL1 FABJOINT 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 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA  FABJSTMS FABJTERM
    FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM FABUARCN
    FABUMOD0
    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R410 PSY UK42033

       UP08/12/04 P F812

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