IBM Support

PI89039: DFHFC0313 AND DFHFC0314 MESSAGES NOT BEING ISSUED WHEN THEY SHOULD BE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Going through the areas of the CICS code for error
    handling involving Alternate Indexes we see the following for
    VSAM Component Checking:
    
    Component codes for logical errors (return code 8)
     FCVSBINC BIT(8) CONSTANT('01'X), /* Base cluster maybe
                                      /* incorrect
     FCVSAINC BIT(8) CONSTANT('03'X), /* Alternate index
                                      /* maybe incorrect
     FCVSUINC BIT(8) CONSTANT('05'X); /* Upgrade set maybe
    
    This is fine for z/OS VSAM. VSE VSAM will be returning in
    RPLFDB2 at x'26' in the RPL:
    
     RPLFDB2 Function type code:
     RPLFUPG X' 4' Upgrade processing
     RPLFAIX X' 2' AIX processing
     RPLFINC X' 1' Upgrade set is incorrect
    
    These do not match with what CICS has coded for
    Component codes for logical errors in DFHFCVS. We will never put
    out the DFHFC0313 and DFHFC0314 messages correctly. Also, the
    message description in the DFHFC0313 says:
    
     X'00' or X'01'--base cluster.
     X'02' or X'03'--alternate index.
     X'04' or X'05'--upgrade set.
    
    Additional Symptom(s) Search Keyword(s): KIXREVxxx
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS does not issue msgDFHFC0313 or     *
    *                      msgDFHFC0314 messages correctly for     *
    *                      VSAM files with alternate indices.      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Code in DFHFCVS1 which checks the response from VSAM uses values
    x'03' and x'05' to test whether messages DFHFC0313 or DFHFC0314
    should be issued for these responses but, because these are the
    values for z/OS VSAM rather than z/VSE VSAM, the messages are
    not issued.
    Keywords: FC0313 FC0314
    

Problem conclusion

  • DFHFCVS and DFHFCVS1 have been changed to test the correct z/VSE
    values of x'02' and x'04' for the alternate index processing and
    upgrade set processing error conditions, respectively.
    The CICS Transaction Server for VSE/ESA Messages and Codes
    Release 1 GC34-5561-08 manual should be changed to remove the
    codes x'00', x'03' and x'05' from the explanation of message
    DFHFC0313. The same change should be made to the z/VSE Version 5
    Messages and Codes Volume 3 SC34-2684-00 manual as well as
    inserting a description of message DFHFC0314.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • ×**** PE18/07/27 FIX IN ERROR. SEE APAR PH01022  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI89039

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-10-18

  • Closed date

    2018-03-12

  • Last modified date

    2018-09-27

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

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

    PI94223 UI54412

Modules/Macros

  • DFHFCVS
    

Publications Referenced
GC34556108SC34268400   

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UI54412

       UP18/03/26 I 1000

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
27 September 2018