IBM Support

PI15084: RECEIVE MESSAGE - EXCEPTION: ERROR OCCURRED WHILE PERFORMING SSL HANDSHAKE, WHEN ATTEMPTING TO CONNECT TO THE PDTCC SERVER

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When attempting to connect to the PDTCC server, receive
    messages:
    Exception: Error occurred while performing SSL handshake.
    com.ibm.pdtools.comms.CommunicationException: Error occurred
    while performing SSL handshake.
    
    Also, on the host syslog the following message is received:
    BPXP018I THREAD 354D170000000000, IN PROCESS 84280828, ENDED
    WITHOUT BEING UNDUBBED WITH COMPLETION CODE 00806000, AND
    REASON CODE 00000000.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of the PDTOOLS Common Server.          *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1. Connections fail when the owner of   *
    *                      the server contains '*' or '#'          *
    *                      characters.                             *
    *                      2. Diagnosis output is difficult to     *
    *                      collect when a server extension does    *
    *                      not connect.                            *
    *                      3. When using SSL=NO, extensions may    *
    *                      not receive all expected data.          *
    ****************************************************************
    * RECOMMENDATION: Apply the provided PTF.                      *
    ****************************************************************
    1. The sample IPVMKDIR for customization includes commands to
    set the owner for the servers work directory. However, the
    sample job does not run correctly when the userid for the server
    contains special characters, which results in the server being
    unable to complete setup for product configurations.
    2. File status and startup traces are in multiple places.
    3. An API for extensions to receive messages  was incorrectly
    updating a buffer length, possibly resulting in truncated
    messages being returned to the caller.
    Additional problem:
    4. Product configurations often need to repeat data set high
    level qualifiers which increases the probability of a
    typographical error when customising.
    

Problem conclusion

  • The following updates have been made:
    
    1. The sample IPVMKDIR has been updated to handle userids
    containing special characters.
    2. Additional diagnostic messages have been added during server
    startup to confirm that pre-existing files in the WORKDIR are in
    the expected state. Also, the server now captures extension
    launch information for the JOBLOG and trace information until
    the extension has successfully established communications with
    the client.
    3. The internal API has been corrected.
    4. The server has been updated to support $VAR=value syntax in
    the configuration file. The sample IPVCONFG has been updated to
    include using substitution variables to reduce the need to repea
    data set high level qualifiers. This syntax is recognized when
    before the first CONFIG statement or otherwise between CONFIG
    and SPAWN_PARMS_SECTION statements.
    None of the above changes require alteration of existing
    configurations.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI15084

  • Reported component name

    ZPDTOOLS CCOMP(

  • Reported component ID

    5655IPV00

  • Reported release

    170

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-04-03

  • Closed date

    2014-08-04

  • Last modified date

    2014-09-03

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

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

    UI20221 UI20222

Modules/Macros

  •    HVWR170J IPVCMENU IPVCONFG IPVMKDIR IPVRECV
    IPVSRV   IPVSRVRF IPVSRVSL IPV0LVL
    

Publications Referenced
SC19367002SC19415900   

Fix information

  • Fixed component name

    ZPDTOOLS CCOMP(

  • Fixed component ID

    5655IPV00

Applicable component levels

  • R160 PSY UI20221

       UP14/08/07 P F408

  • R170 PSY UI20222

       UP14/08/08 P F408

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"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"170","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 September 2014