TOpenServer

Description

This function is available for backward compatibility only. It is used when configuration information is specified in a configuration file, and not derived from Configuration Server. If the configuration file is not located in the same directory from which an application is running, then the location of the configuration file has to be described in the environment variable TSERVER_HOME. This function opens a communication session to T-Server specified by the parameter server_name and designates the event-processing function that will be invoked each time an event from that T-Server is detected.

Parameters

Name	Description
server_name	A pointer to the name of T-Server to be contacted. The name of T-Server specifies the section name in the configuration file. If it is not specified, the default section name is default.
dispatch_function	A pointer to the function that will be called when an event from T-Server arrives.
application_name	A pointer to the application name.
application_password	A pointer to the string containing the tenant name and the tenant password separated by a slash (/).
open_mode	Communication mode (synchronous or asynchronous). Refer to the type TOpenMode for information on the implications of using one mode versus the other.

Return Values

> 0 — A local server handle to the specific T-Server; in other words, a unique identifier assigned by T-Library to the connection between a client and T-Server. The handle will be used subsequently to send requests to T-Server throughout this communication session.

< 0 — Error condition. Returned to the application if the communication session with the T-Server could not be established.