# tibemsSSLParams_System_SetVerifyHostName

Function

## Purpose

Enable or disable the verification of the server's hostname during connection creation.

## C Declaration

    tibems_status tibemsSSLParams_System_SetVerifyHostName(
        tibemsSSLParams SSLParams,
        tibems_bool verify );

## COBOL Call

    CALL "tibemsSSLParams_System_SetVerifyHostName"
         USING BY VALUE SSLParams,
               BY VALUE verify,
               RETURNING tibems-status
    END-CALL.

Note: `SSLParams` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`SSLParams` | Set the value in this SSL parameter object.
`verify` | `TIBEMS_TRUE` enables verification. `TIBEMS_FALSE` disables verification.

## Remarks

`tibemsSSLParams_System_SetVerifyHostName` enables checking the server’s actual host name against an expected server host name. If no "expected hostname" has been established, the server's fully qualified hostname is compared with the CN in the certificate presented by the server during the initial handshake. If they are not equal, the connection fails.

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

This verification action is enabled by default (unless a program explicitly disables it).

## See Also

`tibemsSSLParams_System_SetExpectedHostName`

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