eqstartcl - utility to start remote Eloquence program via eloqsd
----------------------------------------------------------------

Revision: 2009-03-31

usage: eqstartcl [options] command line
options:
 -u login     - login name (required)
 -p password  - password
 -D directory - program start directory
 -e var=value - environment variable
 -h hostname  - host name (default: 127.0.0.1)
 -s service   - service name (default: eloqsd)

The eqstartcl utility may be used to start remote Eloquence programs
via the eloqsd server.

This functionality is usually provided on the Windows platform through
Eloquence Start Files (using the EQSTART program) or the Eloquence IDE
debugger, or the Eloquence JDLG application menu.

With eqstartcl, a command line utility is added that provides this
functionality for all platforms the Eloquence product is available on.


Installation instructions:

Download the eqstartcl archive according to your platform and unpack
the contained eqstartcl executable into a directory of your choice.
You could, for example, unpack it into the Eloquence bin directory to
integrate it into your Eloquence environment.


Usage examples:

To start a program named TEST located on the 192.168.33.44 machine in
a directory associated with the PROGS volume, using the eloqsd login
name "remote" with the password "eloq", a command line like below may
be used:

eqstartcl -h 192.168.33.44 -u remote -p eloq TEST,PROGS

Please note that this requires the eqstartcl executable to be located
in a directory that is contained in the PATH environment variable,
otherwise it is required to specify the path to the eqstartcl executable.

To pass an environment variable to the program, the -e command line
option may be used, for example:

eqstartcl -h 192.168.33.44 -u remote -p eloq -e HOME=/home/remote TEST,PROGS

To specify multiple environment variables, specify the -e option for
each variable, for example:

eqstartcl ... -e HOME=/home/remote -e LOGNAME=remote ...

Any command line option that should be passed to the executing eloqcore
process must be separated by the -- marker to prevent eqstartcl from
parsing it. For example, to pass the -dlg option to eloqcore, a command
line like below may be used:

eqstartcl -h 192.168.33.44 -u remote -p eloq -- -dlg 192.168.33.111 TEST,PROGS


If you have questions or feedback, please contact: support@marxmeier.com

Your Eloquence team at Marxmeier Software AG