Configuration

Configuring the server side

The server side of XECI must be set up in the XCICS/TS configuration file adding one or more TCP services configured for the XECI protocol.

Each TCP server waits for connection on a pre-defined port. This port, together with the host address, will be referenced in the client application, to identify the XECI server.

add tcpserver name=SERVXECI, port=8077, eci;
add tcpserver name=BCKPXECI, port=8099, eci;

Configuring the client side

As described in the previous chapter, applications using XECI, identifiy the server region with a 8 bytes identifier. This name must be mapped to the corresponding server address and port.

The XECI configuration file (xeci.conf) contains the mappings, according to the following syntax:

<NAME>=<hostname>:<port>

More than one mapping may be specified in the xeci.conf. Lines beginning with "#" are handled as remark.

I.e.

#
# xeci.conf
#
APPLLX01=linux01.ht.net:8077
APPLHP02=192.168.1.23:9999

The XECI client library searches by default the configuration file xeci.conf in the paths specified below. The environment variable XECI_CONFIGURATION_FILE may be used to set a different path for the configuration file. It must be set and exported before to start the client application.

export XECI_CONFIGURATION_FILE=/my/path/xeci.conf

Unix/Linux

The file xeci.conf is located by default in the directory $HOME/etc.

Windows

The file xeci.conf must is located by default in the directory %HOMEDRIVE%\%HOMEDIR%.