tibemsSSLParams_System_SetExpectedHostName

Function

Purpose

Set the expected host name.

C Declaration

tibems_status tibemsSSLParams_System_SetExpectedHostName(
    tibemsSSLParams SSLParams,
    const char* expected_hostname );

COBOL Call

CALL "tibemsSSLParams_System_SetExpectedHostName"
     USING BY VALUE SSLParams,
           BY REFERENCE expected-hostname,
           RETURNING tibems-status
END-CALL.
Note: SSLParams and expected_hostname have usage pointer.

Parameters

Parameter Description
SSLParams Set the value in this TLS parameter object.
expected_hostname Use this value.

Remarks

This parameter applies when establishing a TLS connection to the EMS server. If host name verification is enabled, the EMS client compares the name specified in this call to the CN of the certificate presented by the server during the initial TLS handshake. If they are not the same, the connection fails.

This parameter is connection-specific and can be specified for each connection.