Starting EasyCopy

The information provided below applies to the UNIX versions of EasyCopy.

Start from a Console or Terminal Window

Make sure that the X Window system is running and start EasyCopy by typing the following command:

$ ecx &

The & character is advised to ensure that EasyCopy runs as a background process.

You can enter options together with the ecx command.

Automatic Start at System Login

The system administrator can add an invocation of EasyCopy to the system-wide startup shell script (/usr/lib/X11/xinit/initrc) to make EasyCopy automatically available to all users. For example, to start EasyCopy automatically in iconic mode the following line should be added:

$ ecx -iconic &

When EasyCopy is in iconic mode you only see the EasyCopy icon.

The icon label is the name of the selected printer (in this example hp8500_PCL). Click on the icon to restore the graphical user interface.

If the automatic invocation is not installed globally you can insert the line in your private X window initialization file ($HOME/.xinitrc).

Run EasyCopy on a Remote Server

If EasyCopy should run on a remote server you can start it from a remote display in several ways.

Remote Login
You can make a remote login from a terminal window to the server, and then start EasyCopy by means of the ecx command:

$ rlogin servername ... (login sequence) $ ecx -display remotedisplay:0.0 &

Remember the -display option! Otherwise the graphical user interface is opened on the server’s monitor and nothing happens on your display.

Remote Shell Script
A much easier approach than remote login can be established by means of a local script that you run from the display. Let this script take care of remote login and correct display setup. Your advantage is that you access EasyCopy as were it a local application. The only potential drawback is that your local file system is visible in EasyCopy only if it has been exported and mounted on the server. An example of such a script for remote use of EasyCopy is given here.

#!/bin/sh xhost servername rsh servername ecx -display `hostname`:0.0 $*

Substitute servername with the name of the server on which EasyCopy is installed. The remote display is automatically substituted for `hostname`.

The script itself may be placed in a shared directory. The system administrator may for example create the script on a network drive and make EasyCopy available to the users for which the associated display licenses are purchased by putting the location on these users’ path.

EasyCopy will look for your initialization files in your home directory. It is therefore required that you have a home directory on the server.

You can avoid that the script prompts for a login password if you create an .rhosts file in your home directory on the server. The .rhosts file tells the server from which nodes you can login without being prompted for a password.

Start EasyCopy from CDE

You can start EasyCopy from a CDE control panel if this has been defined as an action. The system administrator can add EasyCopy to the applications available in the control panel, or a user can add it to Personal Applications.

Icons
The four icons shown here are installed together with EasyCopy (in the icons directory). To make the icons available on CDE’s normal icon path you must copy them to /etc/dt/appconfig/icons/C (system-wide icon folder) or to $HOME/.dt/icons (personal icon folder).

ec.t.pm
16x16 ec.s.pm
24x24 ec.m.pm
32x32 ec.l.pm
48x48

If you have the choice between various licenses, for example EasyCopy Silver and EasyCopy Gold, you need to be able to distinguish between them. For this purpose there is a selection of icons at disposal:

Name Intended usage

ec General (or EasyCopy Silver if this distinction is required)

ecplus EasyConvert Plus

ecgold EasyCopy Gold

ecgraf EasyCopy with a licensable option for graphics (EasyCGM or EasyCopy/Graphics)

You associate an icon with specific license requirements in the command line parameters you specify for the command that the icon represents (see step 6 below).

Adding EasyCopy to Personal Applications
To add EasyCopy to your Personal Applications proceed as follows:

The action information has now been saved in your $HOME directory.

Next, you must open your $HOME directory in the File Manager in order to add the action to your Personal Applications:

This completes the configuration of the CDE panel.

Now you can start EasyCopy from Personal Applications in the CDE panel by clicking it on the menu:

	Name	Intended usage
	ec	General (or EasyCopy Silver if this distinction is required)
	ecplus	EasyConvert Plus
	ecgold	EasyCopy Gold
	ecgraf	EasyCopy with a licensable option for graphics (EasyCGM or EasyCopy/Graphics)