<instance>
The instance element specifies instance-wide configurations for the client/server driver. Each instance represents a connection to the c-tree server.
Attributes
Attribute
Description
Default value
server
Specifies the server name and the host name of the c-tree to connect to. The format can be one of the following syntaxes:
servername
servername@hostname
servername@IPaddress
#port@hostname
#port@IPaddress
If the host name or the IP address is omitted, host name defaults to localhost.
FAIRCOMS
user
Specifies the c-tree user name.
n/a
password
Specifies the c-tree user password.
n/a
connect
Indicates whether to connect to c-tree at runtime initialization or wait for the first OPEN operation.
It accepts the following values:
"yes" : Indicates to connect at runtime initialization.
"no" : Indicates to connect during the first OPEN operation. This is the default value.
no
versioncheck
Indicates whether to check that c-tree version matches the c-tree version. This option is turned off by default.
It accepts the following values:
"yes" : Turn on version matching check. Versions must match otherwise an error is returned at runtime initialization.
"no" : Turn off version matching check. This is the default value.
no
ssl
Indicates whether or not an SSL connection should be enstablished.
It accepts the following values:
"yes" : Perform an SSL connection.
"no" : Perform a standard connection.
n/a
sslcert
Specifies the path to a pem file for the SSL certificate.
n/a
Example
<!-- instance 1 on a c-tree server named COBOL running on a server machine whose IP address is 192.168.0.2 -->
<instance server="COBOL@192.168.0.2" user="admin" password="ADMIN" connect="yes" versioncheck="no">
 
...
 
</instance>
<!-- instance 2 on a c-tree server running on a server machine whose IP address is 192.168.0.3 listening on port 1234 -->
<instance server="#1234@192.168.0.3" user="admin" password="ADMIN" connect="yes" versioncheck="no">
 
...
 
</instance>