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.
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. |
> 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.