Spooling EasyCopy print output via ZEH queues

UNIX only

The following describes the steps to make EasyCopy print with ZEH Plot System. It leans heavily on ZEH's newsletter 'The Plot' issue 31, winter 2004, p. 15->, and having that newsletter at hand will help a lot in understanding the different parameters. The very first step is to install the EasyCopy support files for ZEH:

Untar the ec_zeh.tar.gz file over the <EasyCopyDir> directory. That will give three new support files for EasyCopy: 'ecpstatzeh' and 'ecpsubzeh' in <EasyCopyDir> itself and 'zeh' in <EasyCopyDir>/printers/systems.

The next step has a dual purpose. It is to make sure the Zeh sub-system is functional and it also creates user default settings. (Those settings will be stored automatically in $HOME/jsubc.properties).

As the EasyCopy end-user run the following command:

$ZEHHOME/bin/jsubc -server zeh-server-name \
-host hostname-of-zeh-server \
-port port-on-which-the-zeh-database-server-listens \
-plotter zeh-plotter-name-not-the-unix-queue-name \
-user plotex-user-name \
-usergroup user-or-operator-or-administrator-probably-user \
-password user-password-if-this-is empty-then-a-pair-of-double-quotes \
-files $ZEHHOME/testfiles/ZEH_logo.cgm 

The above command is expected to give the following output:

Connecting to: ....

Loading data for ....

Reading table: ... (many lines)

- - - Submitted as Plotex Job #...

NOTE: It is very important to get the -server and -host parameters correct. With incorrect name(s) or with non-responding servers the command may hang, and never come back to the command prompt.

Then a piece of paper with the Zeh logo should come out of the plotter.

If the above fails, there are several possible sources of error:

$ZEHHOME may not be defined.

If that is the case, you may set it specifically in the current terminal session, but then you also need to set it in the EasyCopy interface scripts <EasyCopyDir>/
ecpsubzeh and <EasyCopyDir>/ecpstatzeh. The lines to put in (near the top of the script) are:

export ZEHHOME

Other things, that may go wrong are:

Missing ZEH license files.
Wrong or missing port number (the output from jsubc here is quite confusing - the default port number seems to be 7755). Invalid plotter name... For most errors on jsubc, the output from the command should give a hint as to the nature of the error.

EasyCopy relies on the jsubc command for plotting via ZEH - so if you do not make the above command work, then EasyCopy will also not work through ZEH.

When the above is working, the third step is to install the ZEH plotter to easycopy:

Start easycopy as root, and go to the File/Printers menu.

Click the 'Add' button.

Select the 'Local printer' radio button.
Click 'Next'.

For 'Print spooling system' select ZEH.

For 'Print queue' give the zeh-plotter-name
Click 'Next'

Now select the Make and Model of the printer
Click 'Next'

Carefully fill in the Name, Description and Location fields: 'Name' must be unique and is what will show up in the Print dialog.

The other fields will show up in the Printers dialog.
Click 'Finish'.

Now close down the EasyCopy GUI (as root) and restart it as the normal user.

Verify that you can open a file or capture a screen an print it through ZEH.

Special NOTEs:

We have experienced the Linux version of jsubc not to work, and that was because of a missing library in the Linux installation. It is the <EasyCopyDir>/ecsubzeh script that uses the jsubc command (near the end of the script). If you need additional parameters for your site (such as job accounting parameters), then you may edit the jsubc line here.

For any further assistance please contact The EasyCopy Company at your usual contact numbers

Prepared by Jorgen Andersen - The Easycopy Company