Installation guide

January 01, 1998

1.

Move the file WEBPRINTER_SYMBIONT.EXE to SYS$COMMON:[SYSEXE]

Example:

$COPY WEBPRINTER_SYMBIONT.EXE SYS$COMMON:[SYSEXE]

2.

Move the file WEBPRINTER.EXE to the scripts directory of the Purveyor package.

If the default configuration is being used, this directory is SYS$COMMON:[PURVEYOR.SAMPLES.SCRIPTS]

3.

Create a directory where the files to display will be stored by the symbiont. Make sure that the directory is owned by the purveyor worker. This is because the purveyor worker runs without privileges whereas the symbiont runs with SYSTEM privileges.

Example:

$CREATE/DIRECTORY/OWNER=[purveyor_worker] SYS$SYSDEVICE:[WEBPRT]

4.

Define a logical that the WEBPRINTER.EXE program can access which resolves to the directory just created.

Example:

In the LOGIN.COM for the worker process of PURVEYOR:

$DEFINE/PROCESS WCF$WEBPRINTER SYS$SYSDEVICE:[WEBPRT]

Optionally, you can define a logical WEBPRINTER_LOGO which will cause code to be inserted in the output stream to the browser to link to a logo image for display at the top of the page.

Example:

$DEFINE/PROCESS WEBPRINTER_LOGO "/scripts/wcfthumb.jpg"

This will result in the following HTML sent to the browser just after the /BODY statement:

<IMG SRC="/scripts/wcfthumb.jpg">

An example wcfthumb.jpg is provided for your use. Move it to the /scripts/ directory of purveyor.

5.

Create the queue to reformat reports for display.

Example:

$INIT/QUEUE/ON=[ALPHA1]::/PROCESSOR=WEBPRINTER_SYMBIONT TEST

6.

Define a logical in the group 1 logical name table of the form queuename_WP_DIRECTORY

Example:

$DEFINE/TABLE=LNM$GROUP_000001 TEST_WP_DIRECTORY SYS$SYSDEVICE:[WEPRPT]

7.

Register your license PAK using sys$update:vmslicense.com

Example:

$@SYS$UPDATE:VMSLICENSE

8.

Start the reformat queue.

Example:

$START/QUEUE TEST

9.

Test by printing to the reformat queue.

Example:

$PRINT/QUEUE=TEST WEBPRINTER_INSTALLATION_GUIDE.TXT

10.

Verify the file now exists in queuename_WP_DIRECTORY.

Example:

$DIR SYS$SYSDEVICE:[WEBRPT]

11.

Verify the file is now in the file list from a browser application.

Example:

The URL specification would be

http://www.wcfa.com/scripts/webprinter.exe

12.

Add the logical definition for the reformat queue to SYS$STARTUP:SYSTARTUP_VMS.COM

Make sure the logical is defined prior to starting the reformat queue.

Example:

$DEFINE/TABLE=LNM$GROUP_000001 TEST_WP_DIRECTORY SYS$SYSDEVICE:[WEBPRT]

$START/QUEUE TEST

Copyright WCF and Associates, Inc. January 1998