3 Eloquence Graphical User Interface
The Remote Exec Utility
The EQEXEC utility is provided for the Microsoft Windows platform. It makes it possible to start HP-UX processes on a remote host using the rexec protocol.
The EQEXEC remote exec utility is available on the 32bit Windows environment and is now named EQEXEC32. It uses the eqexec.ini configuration file located in the Windows installation directory.
EQEXEC enables you to start your HP-UX application without the necessity to
login to your favorite HP-UX box while you don't get in contact with the operat
ing system at all.
EQEXEC enables you to start your HP-UX application without the necessity to login to your favorite HP-UX box while you don't get in contact with the operating system at all.
EQEXEC is designed for end users to start their Eloquence applications on a PC running Microsoft Windows using the DLGSRV network dialog server. This way, Eloquence applications behave like native Microsoft Windows programs.
Probably, EQEXEC may be used in a more general way since the rexec protocol enables you to start any process on any remote host running a remote execution server.
NOTE: For details about the rexec protocol please refer to the rexecd(1m) HP-UX manual page.
EQEXEC Features
The EQEXEC utility
- is fully localizable by changing a configuration file
- supports multiple hosts, applications and users
- provides a command line per application (up to 500 characters)
- has a built-in configuration screen, so it is easy to use and maintain
- includes a log window for debugging purposes
As an additional benefit, if your Eloquence application has been migrated to Dialog Manager client-server dialogs, you don't need a HP-UX user license (since the HP-UX system is used as an application server only) and a costly terminal emulator such as Reflection in order to start your application.
The EQEXEC.INI File
The EQEXEC utility relies on the eqexec.ini configuration file located in your WINDOWS directory. Part of this file is automatically maintained by EQEXEC, part of it can be manually configured. The eqexec.ini file is fully documented and contains a complete description of the various configuration items.
Manual configuration includes
- the common runtime behavior (e.g. if a password is required generally)
- customizing the dialog caption and control element titles
- customizing the program error messages
Using EQEXEC
EQEXEC pops up with a dialog. It contains the following control elements:
- Application:
- Select the application you want to execute.
NOTE: The application is saved for the next time you use EQEXEC.
- Username:
- Enter your user name to log in on the remote host.
NOTE: The username is saved for the next time you use EQEXEC.
- Password:
- Enter your password to log in on the remote host.
NOTE: The password is not saved for the next time you use EQEXEC.
It depends on the PasswordRequired configuration item in section [common] of the eqexec.ini configuration file if a password is required generally.
- Log output:
- Check this option to show the host response in a log window. This is useful if a command does not execute as expected.
NOTE: The state of the log output check box is saved for the next time you use EQEXEC.
- OK:
- Push this button to execute the selected application.
- Cancel:
- Push this button to leave EQEXEC.
- Settings:
- Push this button to open the configuration sub-dialog.
The configuration sub-dialog enables you to maintain the application list. It contains the following control elements:
- Description:
- This is the application title to be displayed in the list.
- Host:
- This is the name of the remote host where the application shall be executed.
NOTE: You should provide the appropriate entry in your HOSTS file. The location of your HOSTS file depends on your networking software.
- Command:
- This is the command line to be executed on the remote host.
NOTE: Is is recommended to redirect standard input to the null device, this is done by appending </dev/null to the command line.
When the command is executed as expected, you should also redirect standard output and standard error to the null device since this reduces the network traffic. This is done by appending >/dev/null 2>&1 to the command line.
- Add:
- Push this button to put your changes to the application list.
- Delete:
- Push this button to delete the selected entry from the application list.
NOTE: Since every control element title can be customized, the titles in this description may differ from the current EQEXEC settings.
Eloquence Dialog Manual - 19 DEC 2002