EnTray


Table of Contents

What is EnTray?
1. Using EnTray
2. Command Line Options

What is EnTray?

EnTray is a program which serves as an indicator of the state of the Enhydra Multiserver Service (EMS). EMS is a Windows NT/2000/XP service and can be in one of the following states: Service Started, Service Stopped, Start Pending, Stop Pending.

Chapter 1. Using EnTray

Upon start, EnTray displays an icon in Systray.

EMS state is indicated by the color of the icon.

  • Green icon menas that EMS is started.

  • Red is for stopped service.

  • Yellow represents both start and stop pending (i.e. service is in process of being started or stopped).

Right click on the icon opens a context menu with two options.

  • First option in the menu depends on the state of the service: it can stop the service if it has already been started or start it if it has not.

  • Second option removes the indicator from the systray.

EMS can also be stopped or started by left double click on the indicator icon. That action is the same as choosing first option from the context menu.

Chapter 2. Command Line Options

EnTray can install itself as a Registry key entry in order to be run automatically next time Windows starts. To do that, Entray must be run with 'install' command line argument like this:

	        c:\>EnTray install
	    

This will, beside writing to registry, start EnTray as usual.

To uninstall EnTray from registry use 'uninstall' option like this:

	        c:\>EnTray uninstall
	    

Uninstall option will cause EnTray to remove his Registry entry and exit.

WARNING:

  • If EnTray is already running, trying to run it again will produce NO RESULT! It applies also to running with command line options ('install' and 'uninstall').

If there is a need for different looking tray icons or diffrent tray captions, initialization file can be made to state the new icon file names and captions. Initialization file must be named 'EnTray.ini' and must be placed in <system root> directory (usually 'c:\winnt\'). File should contain application section [EnTray] and some or all following keys in it: StartedIconPathName, StartingIconPathName, StoppedIconPathName, StoppingIconPathName, StartedCaption, StartingCaption, StoppedCaption, StoppedCaption

Here is an example of the 'Entray.ini' file:

[EnTray]
StartedIconPathName=c:\MyIcons\MultiserverStarted.ico
StartingIconPathName=c:\MyIcons\MultiserverStarting.ico
StoppedIconPathName=c:\MyIcons\MultiserverStopped.ico
StoppingIconPathName=c:\MyIcons\MultiserverStopping.ico

StartedCaption=Status: Start!
StartingCaption=Status: Starting!
StoppedCaption=Status: Stop!
StoppedCaption=Status: Stopping!
	      

Executable file EnTray.exe is placed in directory

    	        '<enhydra_home>\util\wrapper\enhydra\'