IBM Support

PM81587: DFHIS0002 A SEVERE ERROR CODE(X'0686') HAS OCCURRED IN MODULE DFHISXM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The dump show that USERAUTH = IDENTIFY is specified on IPCONN
    
     definition.
     An request is received from CTG to CICS, CICS provide a
    ISSB(/AG6) and
     attach the mirror task for it.
    
     The mirror started, INITIALIZE_RECEIVER call is issued but exit
    with
     exception SECURITY_VIOLATION. SET_DEFERRED_MESSAGE call is
     issued to defer the error and handle it later.
     .
     After BIND_RECEIVER finished, REPORT_MESSAGE call is issued
     to handle the security violation. DFHACP is excuted which will
    call
     DFHISIS SEND_ERROR to write a message DFHIS1027.
     Since the data receiving is not finished, ISSB_STATE =
    IS_RECEIVE here
     which cause the IS7 can not be send to client. The client task
    in CTG
     should be hang there waiting for a response.
     .
     The following work flow is similar to PM75241. After error
    handling,
     CICS then free the ISSB(/AG6) and terminate the mirror
     task. The fields in ISSB get cleared.
     .
     Since the request in task # is received with a large data size,
     the data receiving is not completed. CISR still is receiving
    the residue
     of the request and it doesn't know the mirror task has hit an
    error and
     terminated already. During the data receiving, the some fields
    in the
     freed ISSB(/AG6) is updated.  ISSB_IS_BLE is updated to 2.
     .
     When another request is received, this updated ISSB(/AG6) is
    used for
     that. Here we can see the ISSB_IS_BLE = 2. It should be zero
     as the ISSB is just obtained through ALLOCATE_RECEIVE call.
     .
     The mirror started, INITIALIZE_RECEIVER call is issued, since
     the incorrect ISSB_IS_BLE value. There is a mismatch between
     ISSB_IS_BLE and ISSB_WB_BLE. This is where the exception *EXC
     INVALID_STATE is issued followed by the DFHIS0002 message.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Exception INVALID_STATE with message    *
    *                      DFHIS0002 is issued when handling       *
    *                      a DPL request from CICS TG client.      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    IPIC connection with USERAUTH(IDENTIFY) is setup between CICS
    TG and CICS. A DPL request with data size larger than 60K is
    received in CICS from CICS TG client. The CISR task is notified
    and an ISSB is obtained for this request. CISR then attaches
    a mirror task to handle this request. During the process of
    the mirror task, a security violation is detected. CICS then
    frees the ISSB and terminates the mirror task. However the
    rest of the data for this request is received and handled in
    CISR task which causes some fields in the freed ISSB are
    incorrectly updated.
    
    When a new request is received, CICS gets an ISSB for this
    request. If the updated ISSB (contains incorrect residual
    value) is used here, this request can not be handled by CICS
    successfully which causes an exception and DFHIS0002 message
    being issued.
    
    Additional Keywords: IS0002  DFHIS0002  msgDFHIS0002
    

Problem conclusion

  • DFHISIS has been changed to receive all the data before the
    ISSB gets freed if a security violation happened.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM81587

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-01-28

  • Closed date

    2013-04-25

  • Last modified date

    2015-03-04

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

    PM80715

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

    UK93961

Modules/Macros

  • DFHISIS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UK93961

       UP13/05/10 P F305

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":"5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 March 2015