# 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 SSL parameter object.
`expected_hostname` | Use this value.

## Remarks

This parameter applies when establishing an SSL 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 SSL handshake. If they are not the same, the connection fails.

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

## See Also

`tibemsSSLParams_SetExpectedHostName`

Copyright © Cloud Software Group, Inc. All rights reserved.