IBM Support

PH39772: RTIMOUT VALUE NOT BEING HONORED FOR THE SSL HANDSHAKE FOR AN OUTBOUND WEB REQUEST.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Transaction hangs during the SSL handshake portion of the Web
    Converse command. The customer expected the RTIMOUT value to be
    honored and stop the transaction from hanging indefinitely
    during the SSL handshake.
    
    
    
    Additional Symptoms and Keywords: KIXREVxxx RTIMOUT SSL
    HANDSHAKE
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: RTIMOUT is not in effect for EXEC CICS  *
    *                      WEB OPEN and WEB SEND commands.         *
    ****************************************************************
    A CICS application is making outbound HTTP requests using the
    EXEC CICS WEB API commands.  The RTIMOUT value from the PROFILE
    associated with the transaction is in effect for socket receives
    issued EXEC CICS WEB RECEIVE and the receive part of the EXEC
    CICS WEB CONVERSE command.  The RTIMOUT value is not used during
    EXEC CICS WEB OPEN, WEB SEND or the send part of WEB CONVERSE.
    
    If CICS needs to send an OPTIONS request as part of these
    commands then RTIMOUT does not get used when receiving the
    OPTIONS response.  Similarly, if SSL is in use then a handshake
    may take place.  RTIMOUT would not be in effect during the
    handshake.
    
    If the remote server becomes unresponsive and abandons the SSL
    handshake or fails to respond at all to the OPTIONS request then
    the CICS task can wait forever for a response.
    

Problem conclusion

  • CICS has been updated to allow RTIMOUT to be in effect for EXEC
    CICS WEB OPEN, WEB SEND and the entire WEB CONVERSE command.
    RTIMOUT was already in effect for EXEC CICS WEB RECEIVE and the
    receive part of WEB CONVERSE.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH39772

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-08-11

  • Closed date

    2021-10-07

  • Last modified date

    2021-11-01

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

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

    UI77487 UI77488 UI77489

Modules/Macros

  • DFHEIWB
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI77489

       UP21/10/08 P F110

  • R200 PSY UI77488

       UP21/10/12 P F110

  • R300 PSY UI77487

       UP21/10/12 P F110

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.

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4"}]

Document Information

Modified date:
02 November 2021