In addition to starting an Exceed onDemand session from the desktop or Windows Explorer, you can start a session from a command line. You can also start a session using an existing connection document (.eod ). When you use a connection document to launch an X session, Exceed onDemand uses the connection parameters saved in the file to start the session.
Tip: For information on creating connection documents, see Creating Connection Documents.
Use the command line syntax that is specific to your Client operating system to start an Exceed onDemand session.
Client Operating System |
Syntax |
---|---|
Windows |
[path1\]ExceedonDemand.exe [parameters] |
Linux |
[path1/]eodxc [parameters] |
where:
Parameter |
Description |
---|---|
--display displayspec |
Specifies the display ID of the session on which you want Exceed onDemand Client to run. This parameter is for Linux command lines only. |
-configopts OR |
Provided that you have specified all connection parameters necessary to launch an X session (either through the command line or a connection document), you can use the following parameters to specify how you want to launch Exceed onDemand Client:
Specify only one of the three parameters listed above. If you specify more than one parameter, then the last one you specify takes precedence. If no parameters are specified, Exceed onDemand Client automatically launches the X session. If you do not specify all required connection parameters, the Exceed onDemand dialog box opens, prompting you for any missing information. For more information, see Connecting to Hosts. |
-d |
Specifies that you want Exceed onDemand Client to delete a connection document, if one is specified in the command line, once it has read all login and connection parameters from the file. |
--h hostname |
The name of the host (Exceed onDemand Server machine) to which you want to connect. |
-u username |
The user name with which you want to connect to the host. |
-p password OR |
The password with which you want to connect to the host. You can specify a password that is either encrypted or not encrypted:
|
-c xconfig |
The name of the Xconfig file with which you want to launch an X session. |
-x xstart |
The name of the Xstart file with which you want to launch an X session. |
--help |
Displays the command line Help in the terminal window. |
[--] [path2/] connect.eod |
The name of the connection document with which you want to launch an X session, where path2 is the directory where the connection document is located. Specify only one connection document. If a file or path name contains spaces, you must enclose it in quotation marks. Note: If you choose to precede the name of the connection document with "--", Exceed onDemand treats everything, including spaces, that follows the "--" as the connection document path. For this reason, you do not need to enclose file or path names that contain spaces with quotation marks. |
Note: |
When specifying parameters, keep the following in mind: | |
|
Command line syntax example for Windows:
For example, you can type the following in the Windows command line to immediately launch an X session that uses all connection parameters specified in connect.eod, with the exception of the host parameter:
In the example, Exceed onDemand connects to the host specified in the command line, eodhost, rather than the one specified in connect.eod because parameters specified in the command line take precedence over ones specified in a connection document.
Command line syntax example for Linux:
For example, you can type the following in the Linux command line to immediately launch an X session that uses all connection parameters specified in connect.eod, with the exception of the host parameter:
In the example, Exceed onDemand connects to the host specified in the command line, eodhost, rather than the one specified in connect.eod because parameters specified in the command line take precedence over ones specified in a connection document.