tibemsConnectionFactory_SetSSLProxy

Function

Purpose

Set a connection factory’s parameters for connecting through a TLS proxy.

C Declaration

tibems_status tibemsConnectionFactory_SetSSLProxy(
    tibemsConnectionFactory factory,
    const char* proxy_host,
    tibems_int proxy_port);

COBOL Call

CALL "tibemsConnectionFactory_SetSSLProxy"
     USING BY VALUE factory,
           BY REFERENCE proxy-host,
           BY VALUE proxy-port,
           RETURNING tibems-status
END-CALL.
Note: factory has usage pointer.

Parameters

Parameter Description
factory Set the TLS proxy host and port on this connection factory.
proxy_host The connection factory establishes TLS communication through a web proxy at this host. Supply a simple hostname, a fully qualified hostname with domain name, or an IP address (dot notation).
proxy_port The connection factory establishes TLS communication through a web proxy on this port.

Remarks

A TLS proxy lets an EMS application create a TLS connection to an EMS server, even though a firewall separates the application from the server. The proxy usually runs within the firewall’s DMZ.

A connection factory contacts the TLS proxy, requesting a TLS connection to the server. The proxy authenticates the application program, and mediates the initial TLS negotiation between application and server. After the TLS connection is established, the application and server use it to communicate directly with one another.

See Also

tibemsConnectionFactory_GetSSLProxyHost

tibemsConnectionFactory_GetSSLProxyPort

tibemsConnectionFactory_SetSSLProxyAuth