Spool Print
No. D11088-006-*2
Spooling System
for
Aix, Windows, Linux, Solaris, OMVS
Administration / User’ Guide
Reference
Date
Rev
: Spool2Print
: March 24, 2014
: D11088-006-*2
About MPI
The MPI Tech Group is a leading manufacturer of printing solutions for IBM systems.
All products are developed and produced by MPI Tech and sold through MPI Tech sales offices or authorized
dealers around the world.
MPI Tech partakes in various international committees to further spread its know-how and define the future of digital
printing (Members of the “AFP Consortium”).
No part of this manual can be translated without the prior written consent of MPI Tech.
Copyrights:
 Copyright MPI Tech 1981 - 2014. All rights reserved.
All other products mentioned are trademarks of their respective owners.
Web site: www.mpitech.com
2
France
US (East coast)
MPI Tech SA - Corporate Headquarters
40 rue du Général Malleret Joinville
BP 88
94402 Vitry sur Seine
France
Phone + 33 (0) 1 45 73 09 40
Fax
+ 33 (0) 1 46 80 70 71
e-mail : [email protected]
MPI Tech Inc.
2001 Jefferson Davis Highway
#Suite 306
Arlington,
VA 22202
USA
Phone + 1 (703) 418 0680
Fax
+ 1 (703) 418 0684
e-mail : [email protected]
Denmark
US (West coast)
MPI Tech A/S
Vadstrupvej 35
DK– 2880 Bagsværd
Denmark
Phone + 45 4436 6000
Fax
+ 45 4436 6111
e-mail : [email protected]
MPI Tech Inc.
4952 Warner Avenue,
Suite 301
Huntington Beach
CA 92649-5506
USA
Phone + 1 (714) 840 80 77
Fax
+ 1 (714) 840 21 76
e-mail : [email protected]
United Kingdom
Germany
MPI Tech United
Anchor House,
50 High Street,
Bagshot
Surrey
GU19 5AW
United Kingdom
Phone + 44 (0) 844 800 9803
Fax
+ 44 (0) 1276 452 379
e-mail : [email protected]
MPI Tech GmbH
Bavariastr. 7a
D-80336 Munich
Germany
Phone + 49 (0) 89 35 4762 -30
Fax
+ 49 (0) 89 35 4762-11
e-mail : [email protected]
Spool Print
CONTENTS
1.
MPI TECH. LOCATIONS & TECHNICAL SUPPORT .............................................................................................................. 9
2.
SPOOL2PRINT ............................................................................................................................................................... 11
2.1. SOFTWARE DESCRIPTION ..................................................................................................................................................... 11
2.2. FEATURES ........................................................................................................................................................................ 12
2.3. SERVER REQUIREMENTS ..................................................................................................................................................... 12
2.3.1.
Supported Server Environments ........................................................................................................................... 12
2.3.2.
AIX server requirement ......................................................................................................................................... 12
2.3.3.
Windows server/workstation minimum requirements ......................................................................................... 12
2.4. GUI REQUIREMENTS .......................................................................................................................................................... 13
2.4.1.
Network protocol requirements ........................................................................................................................... 13
2.4.1.1.
2.4.1.2.
UDP port allowed ................................................................................................................................................................ 13
TCP/IP port allowed ............................................................................................................................................................ 13
2.5. SPOOL2PRINT LICENSE ....................................................................................................................................................... 13
2.6. INPUT DATA STREAM.......................................................................................................................................................... 14
2.6.1.
AFPDS MO:DCA-P.................................................................................................................................................. 14
2.6.2.
Linedata ................................................................................................................................................................ 14
2.6.3.
IPDS....................................................................................................................................................................... 14
2.6.4.
PCL ........................................................................................................................................................................ 14
2.6.5.
PostScript, PDF...................................................................................................................................................... 14
2.6.6.
Generic.................................................................................................................................................................. 15
2.7. INPUTS ............................................................................................................................................................................ 15
2.7.1.
Hot Folder ............................................................................................................................................................. 15
2.7.2.
TCP/IP MVS download .......................................................................................................................................... 15
2.7.3.
TCP/IP LPR/LPD ..................................................................................................................................................... 15
2.7.4.
TCP/IP DPF ............................................................................................................................................................ 15
3.
SPOOL2PRINT INSTALLATION ....................................................................................................................................... 17
3.1. WINDOWS INSTALLATION ................................................................................................................................................... 17
3.1.1.
Getting a license prior to install ............................................................................................................................ 17
3.1.2.
Installation procedure .......................................................................................................................................... 17
3.1.3.
Installing the license ............................................................................................................................................. 20
3.2. INSTALLATION ON UNIX SYSTEMS.......................................................................................................................................... 21
3.2.1.
Setting up the installation .................................................................................................................................... 21
3.2.2.
Getting a license ................................................................................................................................................... 24
3.2.3.
Installing the license ............................................................................................................................................. 24
4.
DIRECTORY STRUCTURE, SERVICES AND PROCESSES ..................................................................................................... 25
4.1.1.
4.1.2.
4.1.3.
4.1.4.
5.
Directory Structure ............................................................................................................................................... 25
Windows Services ................................................................................................................................................. 25
Spool2Print processes ........................................................................................................................................... 25
Spool2Print registry (windows) ............................................................................................................................. 25
SPOOL2PRINT GETTING STARTED ................................................................................................................................. 27
5.1. CONFIGURE AND START THE MPI SPOOL2PRINT WINDOWS SERVICE .......................................................................................... 27
5.2. START SPOOL2PRINT ON UNIX ............................................................................................................................................. 28
5.2.1.
To launch Spool2Print ........................................................................................................................................... 28
5.2.2.
To launch the main process .................................................................................................................................. 29
5.2.3.
To launch the Graphic User Interface ................................................................................................................... 29
5.2.4.
To launch the Backup Server ................................................................................................................................ 29
5.2.5.
To launch the TCP/IP Server.................................................................................................................................. 30
5.2.5.1.
5.2.5.2.
5.2.6.
5.2.6.1.
5.2.6.2.
5.2.7.
6.
First method ........................................................................................................................................................................ 30
Second method ................................................................................................................................................................... 30
To launch the HTTP Server .................................................................................................................................... 31
First method ........................................................................................................................................................................ 31
Second method ................................................................................................................................................................... 31
To uninstall the software ...................................................................................................................................... 31
HOW TO START THE GUI ............................................................................................................................................... 33
Spool Print
3
6.1. SUMMARY ....................................................................................................................................................................... 33
6.2. STARTING THE MPI SPOOL2PRINT GUI ................................................................................................................................. 33
6.2.1.
Windows messages .............................................................................................................................................. 33
6.2.1.1. Windows cannot find ‘javaw.exe’ ....................................................................................................................................... 33
6.2.1.2. The system cannot find the file specified command = javaw.exe -jar Spool2Print.jar ........................................................ 34
6.2.1.2.1. Explanation for Spool2Print.JavaProperties file ........................................................................................................... 34
6.2.1.3. Could not find the main class. Program will exit ................................................................................................................. 34
6.2.2.
6.2.3.
7.
Connection Setup .................................................................................................................................................. 35
Adding a server ..................................................................................................................................................... 35
SPOOL2PRINT INTERFACE ORGANIZATION ................................................................................................................... 37
7.1. INTERFACE PRESENTATION................................................................................................................................................... 37
7.2. THE GUI MENU BAR .......................................................................................................................................................... 38
7.2.1.
The Setup menu .................................................................................................................................................... 38
7.2.2.
The View menu ..................................................................................................................................................... 38
7.2.3.
The Preference menu ............................................................................................................................................ 41
7.3. MAIN TASK BAR ................................................................................................................................................................ 42
7.3.1.
Icon list.................................................................................................................................................................. 42
7.4. USING THE TABS ................................................................................................................................................................ 43
7.4.1.
Inputs .................................................................................................................................................................... 43
7.4.2.
Jobs ....................................................................................................................................................................... 43
7.4.3.
Outputs ................................................................................................................................................................. 44
7.5. USING THE TREE ................................................................................................................................................................ 44
7.5.1.
Selection ............................................................................................................................................................... 44
7.5.2.
Server Options ...................................................................................................................................................... 45
8.
HOW TO CREATE/CONFIGURE AN INPUT ...................................................................................................................... 47
8.1. CREATING AN INPUT – GENERAL INFORMATION ....................................................................................................................... 47
8.1.1.
Input configuration – Destination tab .................................................................................................................. 47
8.1.1.1.
8.1.1.2.
8.1.1.3.
8.1.1.1.
8.1.1.2.
8.1.2.
Source ................................................................................................................................................................................. 48
Format................................................................................................................................................................................. 49
Filter .................................................................................................................................................................................... 49
Data Filter............................................................................................................................................................................ 49
Destination .......................................................................................................................................................................... 50
Input configuration – Options tab ........................................................................................................................ 50
8.1.2.1.
8.1.2.2.
8.1.2.3.
8.1.3.
Default Job Status ............................................................................................................................................................... 50
Default job Date .................................................................................................................................................................. 50
Priority ................................................................................................................................................................................ 50
Input configuration – Library Path tab ................................................................................................................. 51
8.1.3.1.
8.1.3.2.
8.1.3.3.
8.1.3.4.
8.1.4.
Libraries path ...................................................................................................................................................................... 51
Default FormDef.................................................................................................................................................................. 51
Default Font ........................................................................................................................................................................ 51
Default PageDef .................................................................................................................................................................. 52
Input configuration – UserExit tab........................................................................................................................ 52
8.1.4.1.
8.1.4.2.
Exit Command ..................................................................................................................................................................... 52
Command parameters ........................................................................................................................................................ 52
8.2. INPUT STATUS AND OPERATOR COMMANDS ........................................................................................................................... 52
8.2.1.
Input status : ......................................................................................................................................................... 52
8.2.2.
Operator commands: ............................................................................................................................................ 53
8.2.2.1.
Input filter and check boxes ................................................................................................................................................ 53
8.3. CREATING AN AFP INPUT .................................................................................................................................................... 53
8.3.1.
Input configuration – Destination tab .................................................................................................................. 54
8.3.1.1.
9.
Source ................................................................................................................................................................................. 54
THE JOBS ...................................................................................................................................................................... 55
9.1. STATUS AND OPERATOR ACTIONS ......................................................................................................................................... 55
9.1.1.
Job status .............................................................................................................................................................. 55
9.1.2.
Operator Actions on the jobs ................................................................................................................................ 55
9.1.3.
Job States Diagram ............................................................................................................................................... 57
10.
HOW TO CREATE AN OUTPUT ................................................................................................................................... 59
10.1.
CREATING AN OUTPUT TO DRIVE AN IPDS DEVICE ................................................................................................................ 59
10.1.1. Output configuration – General Tab ..................................................................................................................... 60
10.1.1.1.
4
Format ............................................................................................................................................................................ 60
Spool Print
10.1.1.2.
10.1.1.3.
10.1.1.4.
10.1.1.5.
10.1.1.6.
10.1.1.7.
10.1.1.8.
10.1.1.9.
10.1.1.10.
10.1.1.11.
10.1.1.12.
10.1.1.13.
10.1.1.14.
10.1.1.15.
10.1.1.16.
10.1.1.17.
10.1.1.18.
10.1.1.19.
10.1.1.20.
10.1.1.21.
10.1.1.22.
10.1.2.
DataFilter ........................................................................................................................................................................ 60
Destination ..................................................................................................................................................................... 60
TCP Address .................................................................................................................................................................... 60
TCP port .......................................................................................................................................................................... 60
Connection Retries ......................................................................................................................................................... 60
Disconnect Timeout ........................................................................................................................................................ 60
Ppd Trace File ................................................................................................................................................................. 60
Ppd Log File..................................................................................................................................................................... 60
Trace Open Mode ........................................................................................................................................................... 61
Description ..................................................................................................................................................................... 61
Job Separator .................................................................................................................................................................. 61
Initial Status .................................................................................................................................................................... 61
Check Point ..................................................................................................................................................................... 61
OutGrp ............................................................................................................................................................................ 61
Processed When ............................................................................................................................................................. 61
Mark Form ...................................................................................................................................................................... 61
Ctrl Edge Mark ................................................................................................................................................................ 61
Eject TimeOut ................................................................................................................................................................. 62
License in PPM ................................................................................................................................................................ 62
MaxQueuedJobs ............................................................................................................................................................. 62
Job Split .......................................................................................................................................................................... 62
Output configuration – Library path tab .............................................................................................................. 63
10.1.2.1.
10.1.2.2.
10.1.2.3.
10.1.2.4.
Libraries path .................................................................................................................................................................. 63
Default FormDef ............................................................................................................................................................. 63
Default Font .................................................................................................................................................................... 63
Default PageDef .............................................................................................................................................................. 63
10.2.
CREATING AN OUTPUT WITH AN AFP TRANSFORM TO PCL, PDF… ......................................................................................... 64
10.2.1. Output configuration – General Tab..................................................................................................................... 64
10.2.1.1.
10.2.1.2.
10.2.1.3.
10.2.1.4.
10.2.1.5.
10.2.1.6.
10.2.1.7.
10.2.2.
Output configuration – Library path tab .............................................................................................................. 65
10.2.2.1.
10.2.2.2.
10.2.2.3.
10.2.2.4.
10.2.3.
Internal IP Port................................................................................................................................................................ 66
Output Language ............................................................................................................................................................ 66
Printer Emulation............................................................................................................................................................ 66
Input Resolution ............................................................................................................................................................. 66
Code Page ....................................................................................................................................................................... 66
Block Char Error .............................................................................................................................................................. 67
Output configuration – PARSERDLL Tab – Advanced Setup ................................................................................. 67
Status and Operator commands........................................................................................................................... 68
10.2.5.1.
10.2.5.2.
10.2.5.3.
11.
Library path .................................................................................................................................................................... 65
Default FormDef ............................................................................................................................................................. 65
Default Font .................................................................................................................................................................... 66
Default PageDef .............................................................................................................................................................. 66
Output configuration – PARSERDLL tab ................................................................................................................ 66
10.2.3.1.
10.2.3.2.
10.2.3.3.
10.2.3.4.
10.2.3.5.
10.2.3.6.
10.2.4.
10.2.5.
Format ............................................................................................................................................................................ 64
DataFilter ........................................................................................................................................................................ 64
Ppd Trace File ................................................................................................................................................................. 64
Ppd Log File..................................................................................................................................................................... 65
Job Separator .................................................................................................................................................................. 65
Checkpoint ...................................................................................................................................................................... 65
Description ..................................................................................................................................................................... 65
Output status .................................................................................................................................................................. 68
Output commands .......................................................................................................................................................... 68
Log report ....................................................................................................................................................................... 68
CONFIGURE THE GUI REMOTE ACCESS ...................................................................................................................... 69
11.1.
OVERVIEW ................................................................................................................................................................... 69
11.2.
THE JAVA CLIENT ........................................................................................................................................................... 69
11.2.1. GUI communication setup .................................................................................................................................... 70
11.2.1.1.
Connection setup parameters ........................................................................................................................................ 71
11.2.2. GUI communication over TCP/IP .......................................................................................................................... 72
11.2.3. GUI communication over Multicast ...................................................................................................................... 72
11.3.
THE GUI FROM A WEB BROWSER...................................................................................................................................... 73
11.3.1. Installation ............................................................................................................................................................ 73
11.3.2. Serv2Print.exe process .......................................................................................................................................... 74
11.3.3. MpiS2PhttpServerW.exe process .......................................................................................................................... 74
11.3.4. Connect from the browser .................................................................................................................................... 74
12.
JOB SUBMISSION ...................................................................................................................................................... 75
Spool Print
5
12.1.
12.2.
13.
DISK ........................................................................................................................................................................... 75
LPR ............................................................................................................................................................................ 75
USING THE SPOOL2PRINT EXITS ................................................................................................................................ 77
13.1.
DESCRIPTION ................................................................................................................................................................ 77
13.1.1. Input Exit............................................................................................................................................................... 77
13.1.2. Output Exit ............................................................................................................................................................ 77
13.2.
CONFIGURATION ........................................................................................................................................................... 77
13.2.1. Input exit ............................................................................................................................................................... 77
13.2.1.1.
For a specific program .................................................................................................................................................... 77
13.2.1.1.1. Exit command ............................................................................................................................................................. 78
13.2.1.1.2. Command parameters................................................................................................................................................ 78
13.2.1.2.
Setup Input exit for a bat or cmd file .............................................................................................................................. 78
13.2.2.
14.
Output Exits .......................................................................................................................................................... 79
USER MANAGEMENT ................................................................................................................................................ 81
14.1.
GROUPS ...................................................................................................................................................................... 81
14.2.
USERS ......................................................................................................................................................................... 82
14.3.
SETTING UP THE USER MANAGEMENT ............................................................................................................................... 83
14.3.1. Create a Group ..................................................................................................................................................... 83
14.3.2. Create a User ........................................................................................................................................................ 85
14.4.
LOGIN TO SPOOL2PRINT ................................................................................................................................................. 86
15.
STATISTICS ................................................................................................................................................................ 87
15.1.
16.
EXAMPLE ..................................................................................................................................................................... 88
SETTING UP A SECONDARY SERVER .......................................................................................................................... 89
16.1.
INSTALLATION ............................................................................................................................................................... 89
16.1.1. Backup / Restore the Database ............................................................................................................................ 89
16.1.2. Licenses ................................................................................................................................................................. 89
16.2.
SETTING UP THE SERVERS FOR BACKUP SUPPORT .................................................................................................................. 89
16.2.1. Primary Server configuration ................................................................................................................................ 89
16.2.2. Secondary Server configuration ............................................................................................................................ 90
17.
DATABASE PARAMETERS .......................................................................................................................................... 91
17.1.
THE XML PARAMETERS .................................................................................................................................................. 92
17.1.1. Inputs: ................................................................................................................................................................... 92
17.1.2. Jobs: ...................................................................................................................................................................... 93
17.1.3. Submit Jobs: .......................................................................................................................................................... 94
18.
TROUBLE SHOOTING ................................................................................................................................................. 95
18.1.
INSTALLATION ERROR 1325 ............................................................................................................................................ 95
18.2.
INSTALLATION ERROR 1720 ............................................................................................................................................ 95
18.3.
STARTING YOUR SPOOL2PRINT GUI AND YOU GET MESSAGE: ................................................................................................ 95
18.3.1. Unable to find a version of the runtime to run this application ........................................................................... 95
18.3.2. Windows cannot find ‘javaw.exe’ ......................................................................................................................... 95
18.3.3. The system cannot find the file specified command = javaw.exe -jar Spool2Print.jar.......................................... 96
18.3.4. Could not find the main class. Program will exit .................................................................................................. 96
18.3.5. JVM Memory too small to run correctly ............................................................................................................... 96
18.3.6. Spool2Print – Error on Server Address x.x.x.x Port 6789 (Ping Error) ................................................................... 97
18.3.7. Server does not respond perhaps it is busy ........................................................................................................... 97
18.3.8. Spool2Print Already Active on this computer, instance port = 6790 .................................................................... 97
18.4.
HOW TO REGISTER YOUR SPOOL2PRINT ............................................................................................................................. 98
18.4.1. Procedure for sending the keys.cfg file ................................................................................................................. 98
18.4.2. key.cfg file received from MPI with the agreement .............................................................................................. 98
18.5.
HOW TO UPDATE SPOOL2PRINT ....................................................................................................................................... 99
18.5.1. Introduction .......................................................................................................................................................... 99
18.5.2. Getting started ..................................................................................................................................................... 99
18.6.
HOW TO ADD COLUMNS TO THE SPOOL2PRINT GUI........................................................................................................... 100
18.6.1. Description .......................................................................................................................................................... 100
18.6.1.1.
18.6.1.2.
18.6.2.
6
Case 1: How to display the existing job parameter <ROOM> which does not appear in the default GUI .................... 100
Case 2: You want to add a new parameter to the GUI corresponding to the City name .............................................. 100
How to name the dynamic columns in the GUI .................................................................................................. 101
Spool Print
18.7.
HOW TO REPAIR YOUR SPOOL2PRINT DATABASE ............................................................................................................... 102
18.8.
HOW TO MOVE SPOOL2PRINT PRODUCTION ENVIRONMENT TO ANOTHER SERVER ................................................................... 103
18.8.1. Backup / Restore the Database .......................................................................................................................... 103
18.8.2. Repair the database ........................................................................................................................................... 103
18.9.
HOW TO GET LOGS AND TRACES TO FORWARD TO TECHNICAL SUPPORT.................................................................................. 104
18.9.1. Printout or printer(s) related .............................................................................................................................. 104
18.9.2. Operating / manipulating Spool2Print ............................................................................................................... 104
18.9.3. Major problem with Spool2Print ........................................................................................................................ 104
18.10. HOW TO CHECK SPOOL2PRINT WEB INTERFACE ................................................................................................................. 105
18.11. HOW TO START MPI SPOOL2PRINT AS USER .................................................................................................................... 106
18.11.1.
Logon as Root ................................................................................................................................................. 106
18.11.2.
Logon as a normal User .................................................................................................................................. 106
18.12. HOW TO CONFIGURE JOB DELETING AFTER PROCESSED........................................................................................................ 106
18.13. HOW TO CONFIGURE PAGE RANGE FOR POSTSCRIPT OR XPIF FEATURE ................................................................................. 107
18.13.1.
Description ...................................................................................................................................................... 107
18.13.2.
Input configuration without EXIT.................................................................................................................... 107
18.13.2.1.
18.13.3.
18.13.3.1.
18.14.
Jobs tab result without EXIT activated .......................................................................................................................... 107
Input configuration with and EXIT .................................................................................................................. 108
Jobs tab result with an EXIT activated .......................................................................................................................... 108
HOW TO SETUP JAVA TO AUTHORIZE S2P APPLETS IN THE BROWSER ..................................................................................... 109
19.
TRADEMARKS ......................................................................................................................................................... 111
20.
CUSTOMER SUPPORT AND WARRANTY INFORMATION .......................................................................................... 119
20.1.
20.2.
20.3.
20.4.
20.5.
CUSTOMER SUPPORT ................................................................................................................................................... 119
AUTHORIZED DEALERS.................................................................................................................................................. 119
USER WARRANTY ........................................................................................................................................................ 119
MAINTENANCE ........................................................................................................................................................... 119
END USER LICENSE AGREEMENT FOR MPI TECH SOFTWARE ................................................................................................ 119
Spool Print
7
<This page is intentionally left blank>
8
Spool Print
1.
MPI Tech. locations & technical support
Web site: www.mpitech.com
France
US (East coast)
MPI Tech SA - Corporate Headquarters
40 rue du Général Malleret Joinville
BP 88
94402 Vitry sur Seine
France
Phone + 33 (0) 1 45 73 09 40
Fax
+ 33 (0) 1 46 80 70 71
e-mail : [email protected]
MPI Tech Inc.
2001 Jefferson Davis Highway
#Suite 306
Arlington,
VA 22202
USA
Phone + 1 (703) 418 0680
Fax
+ 1 (703) 418 0684
e-mail : [email protected]
Denmark
US (West coast)
MPI Tech A/S
Vadstrupvej 35
DK– 2880 Bagsværd
Denmark
Phone + 45 4436 6000
Fax
+ 45 4436 6111
e-mail : [email protected]
MPI Tech Inc.
4952 Warner Avenue,
Suite 301
Huntington Beach
CA 92649-5506
USA
Phone + 1 (714) 840 80 77
Fax
+ 1 (714) 840 21 76
e-mail : [email protected]
United Kingdom
Germany
MPI Tech United
Anchor House,
50 High Street,
Bagshot
Surrey
GU19 5AW
United Kingdom
Phone + 44 (0) 844 800 9803
Fax
+ 44 (0) 1276 452 379
e-mail : [email protected]
MPI Tech GmbH
Bavariastr. 7a
D-80336 Munich
Germany
Phone + 49 (0) 89 35 4762 -30
Fax
+ 49 (0) 89 35 4762-11
e-mail : [email protected]
Spool Print
9
<This page is intentionally left blank>
10
Spool Print
2.
Spool2Print
2.1. Software description
Spool2Print is a software solution that allows you to take advantage of your print data. It can run on
different platforms like AIX, Windows, Solaris or Linux. Spool2Print accepts various types of input data
such as Line Data (or mixed mode), IPDS and AFPDS when referring to the IBM AFP environment. It also
accepts standard print data stream such as PCL, PostScript, PDF or any kind of print data.
Print data can be submitted from a local <<hot folder>> or spooled over a TCP/IP connection from a host.
Depending on the type of data, the TCP/IP connection with a mainframe can be performed via MVS
download. DPF is used for transmitting IPDS spool from a PSF. The other systems can address the data
over a TCP/IP LPR/LPD connection.
For Line Data or AFPDS, the AFP resources can be either in-line (included in the data stream) or managed
locally by Spool2Print.
Spool2Print is designed for the management of day-to-day print jobs. Spool2Print can print your jobs to a
physical printer or can convert them to various formats (PDF, Tiff, etc.). Utilizing a Java GUI or a web
interface you are able to fully manage your production (documents can be released, held, reprinted...). The
jobs are retained in a local database and are stored until a retain date or upon operator intervention. The
product has been designed for either local or remote management.
Spool2Print can address any model of IPDS printer or network printer. It allows printing of AFP printing to
non-IPDS printers supporting PCL, Postscript or PDF. Spool2Print allows organizing the print production
and address all the available printers.
In addition to printing, Spool2Print provides line/AFPDS data conversion to PDF or Tiff for distribution,
E-mail submission or archiving.
Spool Print
11
2.2. Features

Spool system and print management tool

Printing, duplicating, releasing, re-routing, retaining and deleting of print jobs

Supports Line Data and AFPDS data streams input data streams

Supports PCL and PostScript input data streams for printing

Handles embedded or external resources

Addresses IPDS, PCL and PostScript printers and devices

Remote GUI interface (S2P Client or Web Interface)

Transform Line Data and AFPDS to PDF or Tiff for distribution, E-mail submission and archiving
2.3. Server Requirements
2.3.1. Supported Server Environments
Spool2Print operates on AIX, Windows, and Linux Operating Systems
2.3.2. AIX server requirement
Spool2Print can run on AIX 5.3
Spool2Print performance depends on the server hardware configuration (Processor speed, RAM memory,
Hard disk (space, speed and number)).
20 MB free disk space for Spool2Print. Additional storage is necessary for the jobs and the Spool2Print
database.
2.3.3. Windows server/workstation minimum requirements
Computer running Windows 7, 8, 2003, 2008, 2012.
Spool2Print performance depends on the server hardware configuration (Processor speed, RAM memory,
Hard disk (space, speed and number)).
Here is an example of minimum server configuration required to run Spool2Print:
12

1G Hz Pentium processor or faster,

Minimum 2 GB RAM or more,

50 MB free disk space for Spool2Print. Additional storage is necessary for the jobs and the
Spool2Print database.
This storage depends jobs (number, size and period of retention).

Windows component “Windows Installer” Version 3.1 or later
Spool Print
2.4. GUI requirements
A java based GUI is provided to access and control Spool2Print. Therefore, java JRE must be installed on
each server / workstation accessing Spool2Print. A web interface is also available. In this case, the access
to Spool2Print is performed via a web browser (no need to install the remote GUI client). Java is still
mandatory.
If different Java JRE versions are installed on the server, select a minimum JRE Java version 1.6 in the
GUI preference.
Note: For additional information refer to chapter “Starting the MPI Spool2Print GUI”.
2.4.1. Network protocol requirements
The Java GUI can run locally (on the Spool2print server itself) or remotely. The Server-GUI communication
is performed over multicast (UDP). It is also possible to communicate over TCP/IP sockets for remote
interfaces.
2.4.1.1. UDP port allowed
When running with the multicast, Allow UDP port on firewall.
IP Multicast address 224.6.7.8
UDP Port 5678 
UDP Port 9012 
2.4.1.2. TCP/IP port allowed
When running in TCP/IP, Allow TCP/IP port 6789 on firewall
TCP Port 6789 
These settings can be changed with the Setup > Connection> setup dialog box.
2.5. Spool2Print license
For each server running Spool2Print, a license is required.
Spool2Print cannot run/start without a valid license.
Contact your local MPI Tech sales/support to get a temporary or permanent license.
Note: For additional information refer to chapter “Spool2Print getting started”.
Spool Print
13
2.6. Input data Stream
2.6.1. AFPDS MO:DCA-P
Spool2Print accepts AFPDS MO:DCA-P (composed) data. AFPDS document are converted to IPDS to
drive IPDS printers. AFPDS can also be transformed to PCL or PostScript (for printing to printers supporting
these languages) or to PDF or Tiff for Distribution or archiving.
AFPDS files can be generated from an IBM host with the APKACIF product or directly generated by AFP
composers.
The AFPDS resources (Formdef, CharacterSet, Codepage, Overlays, PagesSegment) can be embedded in
the file or external. If the AFPDS file does not contain resources, they must be available in the Spool2Print
server local directories. The paths for the local resources are configured during the input or ouput setups
Note: For AFPDS MO:DCA-P information please refer to the IBM manual SC31-6802
“Data
Stream and Object Architectures / Mixed Object Document Content Architecture Reference”.
2.6.2. Linedata
Line Data is first transformed to AFPDS and then processed by Spool2Print. Line Data can be printed to
any kind of printers (IPDS, PCL, and PostScript) or transformed to PDF.
Line Data Conversion support:
LND
RCD
XML
Not Supported
Not Supported
Supported except:
Inline AFP Commands *
Inline AFP page
LND Triplets
Shift in/Shift out controls
* IMM and IDM are supported
The Line Data format accepted are (when Input = Hotfolder):
Control Code type
Structure
No control code
2 bytes for length + Data
ANSI
2 bytes for the length + ANSI control code + data
Machine
2 bytes for the length + ANSI control code + data
ANSI + TRC
2 bytes for the length + ANSI control code + TRC Code (From F0 to F3) + data
2.6.3. IPDS
Spool2Print accepts IPDS spool files from a PSF (Mainframe, AS/400, other…). IPDS jobs can be printed to
IPDS printers or any PCL, PostScript printers. They can also be transformed to PDF or Tiff for Distribution
or archiving.
2.6.4. PCL
Spool2Print accepts PCL. This data streams is interpreted by Spool2Print and can be routed to PCL
printers. Page range printing is allowed.
2.6.5. PostScript, PDF
Spool2Print accepts PostScript or PDF already formatted data stream. PostScript and PDF files can be
transformed to AFPDS. These data streams can also be routed and printed to PDF or PostScript printers
without interpretation.
14
Spool Print
2.6.6. Generic
Spool2Print accepts any kind of print data stream. The jobs are spooled and forwarded to the printers
without interpretation.
2.7. Inputs
The inputs are the ways to submit spool jobs to Spool2Print. The input configuration provides information to
Spool2print to process the data (default destination, status, resources…)
2.7.1. Hot Folder
A hot Folder is a local directory. As soon as a file is copied to a configured directory, it is detected and
processed by Spool2Print. In order to inform Spool2Print about the processing to be performed, it is also
possible, prior to copy the file to be processed, to first copy a parameter file (file with extension .parms) to
override the default input settings.
According to its configuration, a hot folder input can accept any kind of print jobs (Line Data, AFPDS, PCL
or PostScript, PDF…).
2.7.2. TCP/IP MVS download
When “MVS download” or “Download for z/OS” is installed and configured on the IBM mainframe,
Spool2Print can receive print files and JCL parameters. It is a very convenient way to receive Line Data or
AFPDS data stream from a mainframe JES Spool over TCP/IP.
Warning
The Spool2Print MVS download receiver is not compatible with the IBM software “AFP download Plus”
2.7.3. TCP/IP LPR/LPD
LPR is a very common way to submit print jobs from any kind of systems. Spool2Print can receive print jobs
from a large variety of systems over this TCP/IP Protocol. To submit any kind of print jobs to Spool2print,
MPI Tech provides the utility LPRMPI. This utility provides additional parameters compared to the standard
LPR command and allows specifying parameters to process the input data stream.
2.7.4. TCP/IP DPF
DPF is a TCP/IP method to communicate IPDS from PSF to Spool2Print over TCP/IP. PSF formats the
IPDS data and transfer the job as a spool to Spool2Print.
Spool Print
15
<This page is intentionally left blank>
16
Spool Print
3.
Spool2Print installation
3.1. Windows Installation
You can get the installation program from the web site or the CD-ROM.
Spool2Print needs a valid license to start.
3.1.1. Getting a license prior to install
Spool2Print needs a valid license to start.
It is recommended to get a license before you install Spool2Print (in order to install Spool2Print and operate
it immediately). Before you install Spool2Print, run the utility MLRegister.exe provided by MPI on the server
you plan to install Spool2Print.
When executing this utility on the server, a window with the Registering number appears. Forward this
number to MPI.
Upon reception of the registering number, MPI will send you the file keys.cfg containing the appropriate
license for your server.
3.1.2. Installation procedure
In order to install, follow this procedure:

Log on the server as an Administrator user,

Run the setup file, or insert the CD-ROM into the CD-ROM drive, the MPI Spooler Install Shield
Wizard will start automatically

Select ‘Next’
Spool Print
17

If Java is not installed on the server, the setup proposes to install Java JRE 1.6. It is highly
recommended to install it in order to be able to operate the GUI directly on the server.
The Java installation runs in a separate install shield.

Once Java has been installed, the Installation process continues.

Read the license agreement, select ‘I accept the terms in the license agreement’, and then ‘Next’
Confirm the User Name and Organization, by clicking on ‘Next’, or modify the information.
18
Spool Print

Click ‘Complete’, or ‘Custom’.
- Select Complete
: The default installation path is, “C:\MPI_Tech”
- Select Custom
: if you want to setup a specific drive for the programs or change some options
such as the TCP/IP port used for the embedded web server used to access
the spool 2 Print GUI from a web browser.

Click ‘Next >’. The installation creates the directory structure and the services, copies the files, and
start the MPI Spool2Print service.

The default installation process will also install the MPI Tech web server for the remote interface from a
browser.
If you want the web server to be automatically started when the Spool2Print service starts, select Yes
during the installation process:
Setup the TCP/IP port used to access Spool2Print from a web Browser.
The default port number is 80 but it may already be used by other applications ‘alternative port
suggested = 8080’
Note: For additional information refer to chapter “How to check Spool2Print Web interface”.
Spool Print
19

The installation ends with the following window:
3.1.3. Installing the license

If you have already got from MPI Tech the keys.cfg file which contains the valid license for your
server, copy this file to the directory “..\MPI_Tech\MPI_Spooler\spool-exe” and restart the Server.
When the server has been restarted, the installation process is finished and you are ready to operate
Spoo2Print

If you have not got the keys.cfg from MPI, locate the file keys.cfg in the directory
“..\MPI_Tech\MPI_Spooler\spool-exe” and forward it to your MPI representative.
Upon reception of this file, MPI will send you the updated keys.cfg file containing the appropriate
license for your server.
When you get from MPI the keys.cfg file which contains the valid license for your server, copy this file
to the directory “..\MPI_Tech\MPI_Spooler\spool-exe” and restart the Server.
When the server has been restarted, the installation process is finished and you are ready to operate
Spoo2Print.
20
Spool Print
3.2. Installation on Unix systems
When installing Spool2Print to an AIX, Solaris or Linux system, follow this procedure.
In order to install, two files are provided.

S2Psetup_V[DATE].tar
is the compressed file containing all the necessary files to run
Spool2Print.

S2PREADME_V[DATE].txt
is the explanations to install the software
Note:
[DATE] is the date of Spool2Print package creation and is of format [YYYYMMDD]
with [YYYY] for the year, [MM] for the month number and [DD] for the day of the month.
3.2.1. Setting up the installation
To install Spool2Print, download from the server the file S2PSetup_V[DATE].tar to a temporary directory
(example: /tmp).
Warning
 It is strongly recommended to install and use the product as <root> user.
 This prevents most problems with directories & files creation and network settings & usage.
 You can also install and use the product with a user different than <root>, but after the installation,
only this user should use the product.
 However, if you really need to install, start and modify the product with several different users, do
<chmod -R 777 [Installation Directory]> and change the files creation mask to 0 by using <umask 0>
before launching the product, but in this case it may have unexpected behaviors !
Important note for OMVS users
 The user who will install the product must be authorized to change/restore file extended attributes
otherwise, the software won't be able to access JES database !

From a console window, login as root and go into the temporary directory where you have copied the
file S2Psetup_V[DATE].tar (example: cd /tmp).

To decompress the S2Psetup_V[DATE].tar file, type the command:
tar xvfo S2PSetup_V[DATE].tar [Enter].

To start the installation process, type the command:
./S2PInstall.sh [Enter]
Spool Print
21

A menu appears:
1)
2)
3)
4)
5)
6)
7)
8)
9)
10)
11)
12)
13)
14)
15)
16)
-
Root installation directory
Installation subdirectory
Full installation directory path
Multicast address
Multicast read port
Multicast write port
Multicast server TCP/IP address
Launch TCP/IP server
TCP/IP server type
TCP/IP server name
TCP/IP server address
TCP/IP server port
Job recycle time
Launch Web server
Web server port
Mail server address
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
[/opt]
[MPI_Tech/MPI_Spooler]
[/opt/MPI_Tech/MPI_Spooler]
[224.6.7.8]
[9012]
[5678]
[127.0.0.1]
[True]
[IPSC]
[]
[127.0.0.1]
[6789]
[22:00:00-06:00:00]
[False]
[80]
[smtp.mpitech.com]
Follows, the option(s) description:
Option
Title
Root installation directory
Full installation directory path
Directory where the product will be installed. You can modify
the installation directory of the product by changing any of
those three options (default installation directory:
</opt/MPI_Tech/MPI_Spooler >).
4
Multicast address
Customer network multicast address for the GUI
5
Multicast read port
Multicast read port
6
Multicast write port
Multicast write port
7
Multicast server address
TCP/IP address of the current host
8
Launch TCP/IP server
If True, launches the TCP/IP server at program startup
9
TCP/IP server type
10
TCP/IP server name
Name of the TCP/IP server (or the host's name)
11
TCP/IP server address
TCP/IP address of the current host
12
TCP/IP server port
TCP/IP server port
13
Job recycle time
Spooled job recycle time
14
Launch web server
If True, launches the Web server at program startup
15
Web server port
A Web server generally uses port number 80. If your server is
already running a web server, you can select another port than
80 to be used by the Spool2Print Web server. to a value that
does not exist in </etc/services> (31080 for instance).
16
Mail server address
Customer outgoing mail server address
1/2/3

22
Explanation
Installation subdirectory
"IPSC" : to use the TCP/IP to TCP/IP server,
"MULTC" : to use the TCP/IP to Multicast server
When the parameters match your requirements, type <c> + <Enter>.
Spool Print

Next, a demand to install a backup Spool2Print server appears and, if you choose to install it, the
following menu appear (example):
1) - Main/production server address
: []
2) - Main/production server port
: [12657]
3) - Process to monitor
: [./spoolSvc]
4) - Startup trigger delay
: [30]
5) - Shutdown trigger delay
: [30]
6) - Command to execute at startup
: []
7) - Command to execute at shutdown
: []
Follows, the option(s) description:
Option
Title
Explanation
1
Main/production server address
TCP/IP address or DNS name of the main/production
server
2
Main/production server port
Main/production server port
3
Process to monitor
Name of the process to monitor which is also the
command line used to start and stop the spooler server
(optional arguments are allowed)
4
Startup trigger delay
Backup spooler startup trigger delay (in sec.) on main
server failure
5
Shutdown trigger delay
Backup spooler shutdown trigger delay (in sec.) on main
server recovery
6
Command to execute at startup
Command line to execute at backup spooler startup
7
Command to execute at shutdown
Command line to execute at backup spooler shutdown
Note
If you install a backup Spool2Print server, a backup server license is necessary for the program to run
properly and in this case, contact MPI Tech to get this type of license.
When the parameters match your requirements, type <c> + <Enter>.
Spool Print
23

Next, a demand to install a Spool2Print server for different hosts using the same name from the
Domain Name System (DNS) appears and, if you choose to install it, the following menu appear
(example) :
1) - Name from the Domain Name System (DNS) : []
Follows, the option(s) description:
Option
1
Title
Name from the Domain Name System (DNS)
Explanation
Name of the current host from the Domain
Name System (DNS)
Note
In the case where you choose to install this type of Spool2Print server and after have installed/copied the
right license file from MPI Tech, do not change this DNS name (either into your own DNS server or into
the Spool2Print registry database file <mpi.reg>) because Spool2Print will not work and your license file
might be invalidated.

When the parameters match your requirements, type <c> + <Enter>.

The installation procedure starts…
3.2.2. Getting a license
Once the MPI Spooler has been installed, you must get a valid license to start Spool2Print:

From a shell window, login as root and go into the directory
<[Installation Directory]/spool-exe>
If [Installation Directory] is </opt /MPI_Tech/MPI_Spooler>

Type

next,

Type
: cd /opt/MPI_Tech/MPI_Spooler/spool-exe [Enter]
: ./mlcreg [Enter]
The Registering Number qualifying your server is displayed. This number is also stored in the file keys.cfg
located in the same directory.
3.2.3. Installing the license
Forward the Registering Number or the keys.cfg file to your MPI Tech contact together with the name of your
organization and the server name. Upon reception of the registering number, MPI Tech will update or create
the file keys.cfg with the license agreement to operate Spool2Print.

When you get the file keys.cfg from your MPI Tech, copy it to the directory :
<[Installation Directory]/spool-exe>.
24
Spool Print
4.
Directory Structure, Services and Processes
Once Spool2Print has been installed, a directory structure has been created on the server, the registry has
been updated and the Windows Services have been installed.
4.1.1. Directory Structure
<local_drive>:\MPI_Tech\
MPI_Spooler\
database\
Spool\
Work\
XML\
gui-exe\
hotfolder\
resource\
spooler-exe\
: Contains all the jobs.
: Temporary work folder.
: Internal configuration for jobs, inputs and outputs (Do not modify).
: Contains all the GUI files.
: Can be used as default input hot folder.
: Can contain AFP resources for the jobs.
: Contains all spooler files (exe, license ….).
4.1.2. Windows Services
MPI Spool 2 Print Service:
MPI Spool 2 Print Watchdog:
This service controls the starts and stops of Spool2Print. This service
automatically starts after installation and launches Spool2Print. During the
installation process, this service is setup with startup = Automatic.
This service is used when running a backup Spool2Print server. (the default
service status is disabled).
4.1.3. Spool2Print processes
MPISpooler.exe
: The Spool2Print main process.
MPIspoolsvc.exe
: This process is started when the service MPI Spool 2 Print Service
starts. The process “MPIspoolsvc.exe” controls the process
MPISpooler.exe.
Serv2print.exe
: Is a process used when a GUI communicates with Spool2Print over
TCP/IP.
It is started automatically when the registry key
\HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler\IPServerOption
is set to YES (Default Value). When this key is set to NO, Serv2print.exe
does not start automatically.
4.1.4. Spool2Print registry (windows)
Some information is stored in the windows registry at this location:
\HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler
Spool Print
25
<This page is intentionally left blank>
26
Spool Print
5.
Spool2Print Getting started
5.1. Configure and start the MPI Spool2Print Windows Service
1.
Click on the ‘Start Menu’, ‘Settings’ and then click ‘Control Panel’.
2.
Double-click on the ‘Services’ icon on the Control Panel.
3.
From the “MPI Spool 2 Print Service’ service properties window, make sure that the parameter
Startup = Automatic.
In order for the spooler to start automatically when the MPI Spool 2 Print service is started check the
windows registry.
Make a “Start” “Run” and type “regedit”.
Locate \HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler
The string “Startup” can accept 2 values:
Spool Print
-
MANUAL
: MPISpooler.exe does not start when the service MPI Spool 2 Print is started.
-
AUTO
: MPISpooler.exe is automatically started when the MPI Spool 2 Print is started.
27
5.2. Start Spool2Print on Unix
5.2.1. To launch Spool2Print

From a shell window, login as <root> and go into the directory <[Installation Directory]/spool-exe> by
typing:
cd [Installation Directory]/spool-exe [Enter]
You can launch the MPI Spooler in two different modes:
with silent mode or
with the process shell window.

The command to launch the MPI Spooler is:
<./spool2print [options...]>
Where [options...] are:
Option
Description
-h | --help
to display this help
-noroot
to allow non-root users to manage the software
-w
to launch MPI Spooler programs in individual shell windows
-stop
to stop MPI Spooler programs
-restart
to stop and restart MPI Spooler programs
-check
to check if any MPI Spooler program is running
-nosp
to not manage the Spool2Print program (MPISpooler.exe)
-nogui
to not manage the GUI program (Spool2Print.sh)
-sv2p
to manage the TCP/IP server as well (Serv2Print.exe)
-http
to manage the HTTP server as well (MpiS2PhttpServer.sh) (also set <-sv2p> option)
-all
to manage all the programs
-f
to force the <-stop> or <-restart> options
-sp <arg>
to pass arguments to Spool2Print program (MPISpooler.exe) (for several arguments,
use <-sp> before each of them)
-l
to create log files (*.log) for each program started (log files are stored in the directory:
<../log>)
-s
silent mode while creating log files (works with <-l>)
-diag
to perform diagnostic tests (output stored in a file)
-versions
to display all the products version
Notes
 If <spool2print> is executed without any options, it will simply start MPI Spooler programs (not in
individual shell windows),
 To start or stop the TCP/IP server and/or the HTTP server programs add the option <-sv2p> and/or
<-http> on the command line.
28
Spool Print
Examples of usage

./spool2print
launches the main MPI Spooler processes in silent mode. Only the MPI
Spooler interface appears.

./spool2print –nogui
launches the main MPI Spooler processes, except the MPI Spooler interface,
in silent mode.

./spool2print –w
launches the main MPI Spooler processes in individual shell window + the
MPI Spooler interface.

./spool2print –l
launches the main MPI Spooler processes and store their outputs in log files
located in : [Installation Directory]/log.

./spool2print –stop
stops the main MPI Spooler processes.
If you want to start the processes separately (with two shell windows):
5.2.2. To launch the main process

Type:
cd [Installation Directory]/spool-exe [Enter]
./MPISpooler.exe [Enter]
5.2.3. To launch the Graphic User Interface

Type:
cd [Installation Directory]/gui-exe [Enter]
./Spool2Print.sh [Enter]
5.2.4. To launch the Backup Server
The procedure is the same as launching Spool2Print (see above).
However, it is <WatchDog.exe> program that will be launched.
This program automatically starts the backup Spool2Print server if the main Spool2Print server stops and
shutdowns the backup Spool2Print server if the main Spool2Print server restarts.
Those start and stop procedures are triggered after a certain amount of time defined by the two following
registry values:
4) - Startup trigger delay
: [30]
5) - Shutdown trigger delay
: [30]
These registry values can be set/modified either while installing the backup software or in the registry
database file:
[Installation Directory]/mpi.reg
in section :
[MPI Tech/Spooler/WatchDog]
Spool Print
29
5.2.5. To launch the TCP/IP Server
The TCP/IP server, called Serv2Print, is a program used to communicate with the GUI's by using a TCP/IP
connection type.
There are two ways to launch this program:
5.2.5.1. First method

From a shell window, login as <root> and go into the directory <[Installation Directory]/spool-exe> by
typing:
cd [Installation Directory]/spool-exe [Enter]

You can launch the TCP/IP server of MPI Spooler in two different modes:
1 - Silent mode or
2 – Command shell window of the process.
Examples of usage

./serv2print
launches the TCP/IP server in silent mode.

./serv2print –w
launches the TCP/IP server in an individual shell window

./serv2print –l
launches the TCP/IP server and store its output in a log file located from
[Installation Directory]/log.

./serv2print –stop
stops the TCP/IP server.
If you want to start the process separately (with one shell window), type:
cd [Installation Directory]/spool-exe [Enter]
./Serv2Print.exe [Enter]
5.2.5.2. Second method

Serv2Print can be also automatically launched by the Spool2Print program by setting the
<IPServerOption> to <True> in the following registry database file :
[Installation Directory]/mpi.reg

in section :
[MPI Tech/Spooler]
In this case, it is not necessary anymore to use <./serv2print> or to specify <-sv2p> option in the command
line <./spool2print>.
Note
 This program, <./serv2print> accepts the same option arguments as those of <./spool2print>
30
Spool Print
5.2.6. To launch the HTTP Server
The HTTP server, called MpiS2PhttpServer, is a program that allows a user to have and use the Spooler
GUI in an internet browser program.
There are two ways to launch this program:
5.2.6.1. First method

From a shell window, login as <root> and go into the directory <[Installation Directory]/spool-exe> by
typing:
cd [Installation Directory]/spool-exe [Enter]

You can launch the HTTP server of MPI Spooler in two different modes:
1 - Silent mode or
2 – Command shell window of the process.
Examples of usage

./httpserver
launches the HTTP server in silent mode.

./httpserver –w
launches the HTTP server in an individual shell windows.

./httpserver –l
launches the HTTP server and store its output in a file located from
[Installation Directory]/log.

./httpserver –stop
stops the HTTP server.
If you want to start the process separately (with one shell window), type:
cd [Installation Directory]/gui-exe/Applet [Enter]
./MpiS2PhttpServer.sh [Enter]
5.2.6.2. Second method

The HTTP server can be also automatically launched by the Spool2Print program by setting the
<ActivateOnStartup> to <True> in the following registry database file :
[Installation Directory]/mpi.reg

in section :
[MPI Tech/Spooler/WebServer]
In this case, it is not necessary anymore to use <./httpserver> or to specify <-http> option in the command
line <./spool2print>.
Notes
 Since the HTTP server needs the TCP/IP server to function properly, each time it will be launched, it
will automatically launch the TCP/IP server and the spooler as well.
 This program, <./httpserver> accepts the same option arguments as those of <./spool2print>
5.2.7. To uninstall the software

From a shell window, login as <root> and go into the directory
<[Installation Directory]> by typing:
cd [Installation Directory] [Enter]

next, type:
./S2PUninstall.sh

Spool Print
And follow the instructions.
31
<This page is intentionally left blank>
32
Spool Print
6.
How to Start the GUI
6.1. Summary
The GUI gives you access and control to Spool2Print. It is a Java based software. Therefore, Java must be
installed on the computer running the GUI. MPI recommends to install a minimum
JRE Java version 1.6 on the workstation/server.
Note: If Java is not installed on the server, the installation procedure will install it. If you want to control
Spool2Print from a remote PC, refer to the chapter “Configure the GUI remote access”.
6.2. Starting the MPI Spool2Print GUI
The first time, to access Spool2Print main menu:

Start Programs → MPI Tech → MPI Spooler → Spool2Print
6.2.1. Windows messages
6.2.1.1. Windows cannot find ‘javaw.exe’
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Make sure that Java is installed on the workstation/server.
Open Control Panel→Programs→Programs and Features. Check that java is part of the programs
installed.
Spool Print
33
6.2.1.2. The system cannot find the file specified command = javaw.exe -jar Spool2Print.jar
Starting your Spool2Print GUI, and you get the following dialog box:
Actions:

Make sure that Java is installed on the workstation/server.
Open Control Panel→Programs→Programs and Features. Check that java is part of the programs
installed.

If you have installed Spool2Print (32 or 64 bits) on Windows OS x64, and your Java version is a
32 bits, verify:
-
Edit from ..\MPI_Spooler\gui-exe directory this file Spool2Print.JavaProperties, and modify the line
JREPath =
C:\Program Files (x86)\Java\jre7\  set your installation path
save it and reload.
-
Or install directly a new Java version x64.
 Re open Spool2Print. The Java version message does not appear anymore.
6.2.1.2.1.Explanation for Spool2Print.JavaProperties file
======================================================
KEYWORD
: JavaConsole
DESCRIPTION : This parameter controls the Java Console
RANGE
: "false" : No display
"true" : allows Java console
DEFAULT
: "false"
======================================================
KEYWROD
: Options
DESCRIPTION : This parameter controls the java options (i.e -Xmx100M )
DEFAULT
: empty
======================================================
KEYWROD
: JREPath
DESCRIPTION : This parameter controls the possibility to use another java version.
SYNTAX
: C:\Program Files\Java\jre1.6.0_01\bin\
DEFAULT
: empty
======================================================
6.2.1.3. Could not find the main class. Program will exit
Starting your Spool2Print GUI, and you get the following dialog box:
Action:
Make sure that Java version installed is 1.6.x_y or higher.
34
Spool Print
6.2.2. Connection Setup

The following window appears:

Make sure that the TCPIP Address parameter matches your server TCP Address
6.2.3. Adding a server

Once the GUI is started, you get the following display.
If no server is defined, The GUI opens the list of available Spool2Print servers. Select the server you
want to work with. If this window does not appear, in order to discover and add a computer running
MPI Spool2Print, use the
Spool Print
icon.
35

After a few seconds, the “Available MPI servers on Network” list appears:

Select the server you want to manage in the list and select Apply. The Server appears in the left side
of the GUI. Make a Right Click on the server name and select “start”

If this window appears, it means that no valid licenses have been entered.

And, at the bottom left side of the Spool2Print GUI you will get the message:
Server info (CNODE2) Waiting Server Response…
Note: For additional information refer to chapter “How to register your Spool2Print”, and follow the
procedure.
36
Spool Print
7.
Spool2Print Interface organization
7.1. Interface presentation
PHD1) with
1.
On the left side of the display, the tree represents the server you are connected to (i.e :
the inputs, the jobs and the outputs
2.
The right side of the window displays the inputs, the jobs and the outputs. The tabs at the top select
the view.
Spool Print
-
Inputs
: Spool2Print job receivers (Hot folder, LPD or TCP/IP download)
-
Jobs
: When an input receives a job, it becomes a Spool2Print job. You can then
manage it and work with it.
-
Outputs
: Printers managed by Spool2print
37
7.2. The GUI Menu bar
The menu bar gives access to some operations and to the GUI configuration.
7.2.1. The Setup menu
The Setup menu allows to

Add a Server
: Select the server from the list

Add server manually
: When the server is not listed in the server list, you can add the server
with its DNS Name or IP address.

Create an Input

Create an Output

Create User
: Allows to add users when user management is activated

Create Group
: Allows to add Groups when user management is activated

Exit
: Closes the GUI
7.2.2. The View menu
The View menu allows customizing the items to be displayed.

Filter
: The filters allow to display only the objects whose names contain the
string specified in the filter. The filters apply to the Inputs, the output and
the content of the log displayed.
Example:
By setting the input filter with the string MVS, only the inputs with the name starting with “MVS” “PRT”
will be displayed. By setting the output filter to *MPI*, all the output whose name contains the string
“MPI” will be displayed.

38
Refresh
: This is equivalent to the <F5> key. The GUI reinitializes the
communication with the server
Spool Print

Customize tables
: Allows to select and organize the columns you want to display for each
table (Inputs, jobs, outputs)
Example: configuring the Input table
The Filter and DataFilter columns will not be displayed. The column Name will be the first column
displayed and the Column Description will be the last one.
If you want the Format Column to be displayed before the Source column, highlight Format and use
the upper

arrow on the right side of the window to move it up.
Customize Menus
: Allows to select for each table, the operations allowed through the right
click when an element is selected
Example: configuring the Inputs menu
With the above setup, the operator will be able to Start, Stop… the inputs but will not be able to
configure (Setup) or rename the inputs (these options will not appear when performing the right
Click)
Spool Print
39

Customize Views
: Allows configuring the tables to be displayed when selecting an item in
the tree on the left side of the display.
The tree represents all the inputs, the type of jobs and the outputs defined on the Spool2Print server:
Example of customization:
This is the configuration for the Input Item View. When an operator will select in the tree a specific
input (such as PROD1_Hotfolder), the tables Inputs and Jobs will be displayed.
The table Inputs will only display the selected input (PROD1_Hotfolder ).
The table Jobs will only display the jobs received from this input.
The table Outputs (printer) will not be displayed.
40
Spool Print
7.2.3. The Preference menu
The Preference menu allows to select the GUI language, the GUI colors, the communication between the
GUI and the servers, the Java JRE installed on the computer.

Language
: The languages available for the GUI are English and
French.

Date Format
: Allows to select the format of the date (Retain date
for instance)

Color Theme
: Some color profiles are available with the GUI. You
can choose your preferred one or define your own
with the next option (Color Table)

Paper Unit
: Set additional paper sizes

Color Table
: You can define your own colors to be used with the
GUI.

Paged Tables option
: Used to optimize the GUI communication with the
server

Decorated Frame
: When checked, The GUI is a pure java interface.
When unchecked, the Java GUI runs in a Windows
window.

Disable Not Accessible Menu
: When checked, only the available options appear in
the menus.

Automatic resizing
: When checked, the GUI automatically resizes the
tables and divides up equally. When unchecked, you
can manually adjust the table sizes.

Connection
: The GUI can communicate with the Spool2Print
server over different communication methods. This
option allows configuring the GUI communication
with the server.

Keep Users context login
:

Change used Java JRE Version and Exit
: When different Java JRE are installed on the
computer you can select the one to be used with the
GUI.
For additional information refer to chapter “Starting
the MPI Spool2Print GUI”.
Spool Print
41
7.3. Main task bar
7.3.1. Icon list
The Icons present in the task bar are shortcuts for operations.
Add a Server
Create Group
Create User
Create a new Input
Create a new Output
Remove a Server
Delete Group
Delete User
Delete an Input
Delete a job
Update all groups and users
Login User
Logoff user
Start (A server, an input, a job…)
Stop (A server, an input, a job)
Filter the views with names
Wizard create
Tile horizontally
Enlarge
Help guide
42
Spool Print
7.4. Using the tabs

On the Spool2Print main menu, select All,

And you will get the following display:
This tab allows to display all the Inputs/Jobs/Outputs available on the server.
7.4.1. Inputs

The inputs are the Spool2Print jobs receivers
This tab allows to display and manage the Inputs available on the server.
7.4.2. Jobs

The Jobs are the documents that have been received by Spool2Print
This tab allows displaying and managing the Jobs available on the server.
Spool Print
43
7.4.3. Outputs

The Outputs are the final destination for the Spool2Print (printers and devices)
This tab displays all the Outputs available on the server.
7.5. Using the tree
7.5.1. Selection
The tree can be used to get different views of the Spool 2 print activity. For instance, to work with all the
jobs assigned to an output, just click on the output name.
You can then display the jobs per input or per output
44
Spool Print
7.5.2. Server Options
When clicking to the server, the right click option allows configuring or accessing specific server options:
Logoff User
: When logged with a user account, logs off,
Login User
: To login with a new user account,
Disconnect All Users
: To disconnect all users logged to Spool2Print,
Delete
: Remove the server from the server list in the tree,
Stop
: Stops the Spool2Print process,
Start
: Starts the Spool2Print process,
Customize Paper List
: Used when transforming AFP or IPDS jobs to PCL, PostScript, PDF.
The paper list allows defining new paper sizes known by the Parserdll
tray configuration,
Connect to
: To connect to the server selected in the tree,
Get Infos
: Gives information about the Spool2Print version, licenses status,
Server Network Path
: Used to access remotely to data on the server (used to access the jobs
for preview or the logs for instance,
Server Tcpip addr
: To address the server with a different TCP/IP address,
Log Report
: To display the content of the server log file Spoolog.log,
Job Distribution
: Displays the graphic of the job distribution,
View XML Config
: Displays the Xml configuration of the server inputs and outputs,
Customize statistics views
: Gives access to the configuration of the elements used for the
statistics,
Report Statistics
: Generates the S2P_Stats_Report.xml file,
View Report statistics
: Displays the file S2P_Stats_Report.xml,
Customize Operator log
:
View Operator Log
:
Clean Temporary Files
:
Backup
:
Restore
:
Spool Print
45
<This page is intentionally left blank>
46
Spool Print
8.
How to create/configure an input
An input is the document receiver for Spool2Print.
The documents can be received either from a hot folder or from a mainframe MVS download
communication.
As soon as a new document is received, Spool2Print processes it and it becomes a MPI Spool2Print job.
The documents can be placed in the directory (hot folder) in different ways (copy, FTP, LPD daemon…)
The Spool2Print job name of a document received from a hot folder will have the same name as the
windows file name.
8.1. Creating an input – General information
In order to create an input use the icon of the tool bar.

Select the icon

Enter the name of new input (i.e. INPUT1) and select Apply
, and you get the following display:
NB : The space characters are automatically replaced with the “_” character.

The input configuration window appears
8.1.1. Input configuration – Destination tab
Spool Print
47
8.1.1.1. Source
Spool2Print can accept the documents over different ways:

DISK
: The Spool2Print input will get the documents a local directory. It is the path of the
hot folder directory.
: It is the path of the hot folder directory.
Path

IBM TCPIP
: The Spool2Print input will get the documents from a mainframe with the MVS
download software (APSKAFPD module).
TCPIP Port

LPD
: This parameter must match the MVS Download PORTNUM
parameter.
: The Spool2Print input will get the documents from a host running the LPR/LPD
TCP/IP Protocol. The queue name specified to reach this input is the name of the
input itself (-P LPR parameter).
LPD Port
: The default value is 515 (Standard TCP/IP port used for a
LPR/LPD communication).

PDPR *
:

TCPIP *
:

FTP *
:

DPF:
: The Spool2Print input will get the jobs from a server generating IPDS (typically
PSF).
TCP PORT
: This parameter must match the Host printer definition.
NB: when starting the DPF input for the first time, a destination must be specified
and started.

JES DATABASE * :
(*) Please contact MPI Tech for this configuration.
Example of IBM Host configuration - TCP/IP MVS Download device:
In the MVS proc, you must configure the TCP/IP address of the Spool2Print server, and the TCP/IP port
used for communication. This TCP/IP port must match with the Spool2Print TCP/IP Port When “Source” =
IBM TCP/IP.
With this kind of configuration, parameters such as the FormDef and Form will be used as job attributes.
DEST=PRT300,
CLASS=A,
IPADDR=192.168.31.65,
PORTNUM=5001;
/*
/*
/*
/*
MATCHING CRITERION - DESTINATION
MATCHING CRITERION - CLASS
TARGET IP ADDRESS WHERE SPOOL TO PRINT IS INSTALLED
TARGET PORT NUMBER
The job received by this kind of input, will be named with the JOBNAME parameter received from the IBM
host.
48
Spool Print
8.1.1.2. Format
Values allowed:

AFPDS
: Select this option when the input receives only AFPDS jobs either from an IBM
host through a TCP/IP communication or from a local hot folder where AFPDS
files produced by various systems can be copied.

LINEDATA
: Select this option when the input receives only Line Data (a FormDef and a
PageDef are requested to process the data).

MIXED LINE-PAGE : The data received from the IBM host can be either Line Data or AFPDS.

PCL
: Select this option when the input receives PCL 5 formatted data.

POSTSCRIPT
: Select this option when the input receives PostScript formatted data.

PDF
: Select this option when the input receives PDF formatted data.

GENERIC
: Select this option when you want to submit transparent data stream (such as
PDF, PPML…).
8.1.1.3. Filter
When the input data is received from a hot folder, Spool2Print will only pick the files up with the right file
extension. Here are the default file extension expected for each data type:
Data type
File extension
AFPDS
.afp
LINE DATA
.lnd
MIXED LINE-PAGE
.mlo
PCL
.pcl
POSTSCRIPT
.ps
GENERIC
.gen
8.1.1.1. Data Filter
Data filter are used to convert incoming data to another data stream.

LINEDATA
: Is used to transform LINEDATA or Mixed Line Page data to AFPDS.

PDF2AFP
: Is used to transform PDF to AFPDS.
When the PDF2AFP filter is selected, the parameter “Filter parameters” is
accessible. It contains the command line to activate GhostScript (gswin32c.exe).
Please enter the following command line and modify the path according to your
gswin32c.exe installation.
"C:/Program Files/gs/gs9.00/bin/gswin32c.exe" -dBATCH -dNOPAUSE -dQUIET -r%r -dFirstPage=%f
-dLastPage=%l -sDEVICE=jpeg -dJPEGQ=100 -sOutputFile="%wIMG_%%d.jpg" "%i"

AFPDS *
:

PCL *
:

PS *
:

IPDS *
:
(*) Please contact MPI Tech for this configuration.
Spool Print
49
8.1.1.2. Destination
This parameter is used to select the associated output.
Note: If no output has been defined yet, the “create” button allows to create one.
The Remove and Add buttons allow selecting existing outputs.
8.1.2. Input configuration – Options tab
8.1.2.1. Default Job Status
When a new job is received, it specifies the action to be performed by the Spool2Print:
 Ready
: As soon as is received, it is automatically ready for processing. It will be
immediately sent to the associated output.
 Held
: When the job is received, it stays in the job list waiting for an operator intervention
to release it
8.1.2.2. Default job Date
The Retain Date parameter indicates what is to be done with the jobs that have been processed by
Spool2Print. You can specify if you want to keep them or delete them. In this later case, you can specify
when the jobs will be automatically deleted. Only the jobs with the status ‘Processed’ or ‘Deleted’ are eligible
for deletion. The deletion process occurs every hour. The jobs with the status ‘deleted’ are removed from
the server. The job with the status ‘Processed’ will be first deleted (will appear with the status ‘Deleted) and
will be removed from the server one hour later.

Never
: Once the job has been processed, the job is deleted (the status of the job
immediately becomes “Deleted”. The job is physically removed from the server
one hour later).

For Ever
: The job is never automatically deleted. Only an operator intervention can delete it.

Until
: Indicates the date and hour you want the job to be deleted.

During
: Specifies how long the job will be retained before deletion.
8.1.2.3. Priority
Priority is a Spool2Print job parameter which allows handling the job priority. Allowed values are from 1 to 9.
The default priority is 5.
Spool2Print will use the priority parameter to define which Jobs directed to the same output with the status
ready will be printed first.
50
Spool Print
8.1.3. Input configuration – Library Path tab
If the AFP file received does not contain all the AFP resources requested, you can use external resources
stored on the server to process the job. Specify the Directory path for each kind of resource.
8.1.3.1. Libraries path
For each type of AFP resource, specify the local directories where this specific type of local resources may
be found. The resources types are:
o
Fonts
o
Form definitions
o
Object containers
o
Overlays
o
Page definitions
o
Page segments
o
User libraries
: Character sets, coded fonts, code pages.
: A local AFP resource will be first search in this libraries.
Note:
To refer to z/OS datasets, when using the Spooler running under OMVS, their names must be preceded by
two slashes, for instance, if the dataset is named “SYS1.FONTLIB”, it must be written this way :
//SYS1.FONTLIB.
Examples of directory paths according to the O/S :
Windows
: C:\directory1\directory2
Unix
: /directory1/directory2
OMVS
: /directory1/directory2
z/OS dataset
: //DTSNAME1.DTSNAME2
8.1.3.2. Default FormDef
This is the default FormDef to be used if no FormDef is provided with the AFPDS.
8.1.3.3. Default Font
This is the default font to be used for Line Data. Up to four fonts can be specified separated with commas
(example: GT12, ESR9, EBR9)
Spool Print
51
8.1.3.4. Default PageDef
This is the default PageDef supplied for Line Data.
8.1.4. Input configuration – UserExit tab
The UserExit tab is used to invoke Spool2Print Exits which are external programs which can interact with
the Data.
8.1.4.1. Exit Command
The Exit command parameter is used to specify the program invoked.
Some programs provided by MPI Tech are protected and need the “Command Encryption” checkbox to be
checked to run.
8.1.4.2. Command parameters
The Command parameters are the argument passed to the program configured with the Exit command
parameter.
Note: For more information, refer to the chapter “Using the Spool2Print Exits”.
8.2. Input Status and Operator commands
8.2.1. Input status :
The input can have different status:
52

Offline
: The input is inactive. Spool2Print does not accept AFPDS from this input

Ready
: The input is active and is waiting for receiving new AFPDS files.

Active
: The input is receiving AFPDS data. The AFPDS is being transferred to the spool
to become a job.

Error
: An error occurred. Use the log report to determine the cause of the error
Spool Print
8.2.2. Operator commands:

Search input
: Helps you to locate the input you want to work with (useful when many inputs are
defined.

Start
: Same action as the “Green” Icon

Stop
: Same action as the “Red” Icon

Setup
: To modify the input definition. Setup can be used only when the input is « offline »

Rename
: To modify the name of the input. Rename can be used only when the input is
« offline »

Create
: To create a new input definition.

Duplicate
: Used to create a new input definition using the same definitions as already created
input.

Delete
: To delete an input. Deletion can be performed only when the input is « offline ».

Log Report
: Opens an event log about the input activity (operator interventions and AFPDS
files attached by this input).
located in the Icon bar. It activates the input.
located in the Icon bar. It de-activate the input
8.2.2.1. Input filter and check boxes
The check boxes at the top of the input list allow to select the inputs to be displayed according to their
status.
The “input filter” field: when you specify a string in this box, only the inputs with a name containing this string
will be displayed.
8.3. Creating an AFP input
In order to create an input use the icon of the tool bar.

Select the icon

Enter the name of new input (i.e. INPUT1) and select Apply
, and you get the following display:
(The space characters are automatically replaced with the “_” character)

Spool Print
The input configuration window appears
53
8.3.1. Input configuration – Destination tab
8.3.1.1. Source
Spool2Print can accept the documents over different ways:

DISK
: The Spool2Print input will get the documents a local directory. It is the path of the
hot folder directory.
Path

IBM TCPIP
: The Spool2Print input will get the documents from a mainframe with the MVS
download software (APSKAFPD module).
TCPIP Port

LPD
: It is the path of the hot folder directory.
: This parameter must match the MVS Download PORTNUM
parameter.
: The Spool2Print input will get the documents from a host running the LPR/LPD
TCP/IP Protocol. The queue name specified to reach this input is the name of the
input itself (-P LPR parameter).
LPD Port
: The default value is 515 (Standard TCP/IP port used for a
LPR/LPD communication).

PDPR *
:

TCPIP *
:

FTP *
:

DPF:
: The Spool2Print input will get the jobs from a server generating IPDS (typically
PSF).
TCP PORT
: This parameter must match the Host printer definition.
NB: when starting the DPF input for the first time, a destination must be specified
and started.

JES DATABASE * :
(*) Please contact MPI Tech for this configuration.
54
Spool Print
9.
The Jobs
Once the AFPDS files have been received through an input, they become jobs in the Spool2Print
The operator can display and have actions on the jobs
The check boxes at the top of the job list allow selecting the jobs to be displayed according to their status.
9.1. Status and Operator Actions
9.1.1. Job status

Waiting
: The job is ready for process and is waiting for the output to be available.

Processing
: The job is being processed

Processed
: The job has been processed.

Held
: The job stays in the spool. The operator can change the job attributes, release it,
delete it…

Paused
: While processing, the job is paused.

Interrupted
: While processing, the job is interrupted

Error
: While processing, the job goes in error

Deleted
: The job has been deleted
9.1.2. Operator Actions on the jobs




Spool Print
Release
Pause
Resume
Hold
: Release command makes a job eligible for processing either after that job is held
from processing by the Hold command, or if the job was submitted to the spooler
as a held job by the Batch Job.
Initial JOB state
: Held
Final JOB state
: Waiting
: The Pause command pauses a job : the job becomes ineligible.
Initial JOB state
: Canceled, waiting, processed
Final JOB state
: Paused
: The Resume command makes a job eligible for processing either after that job is
paused from processing by the Pause command, or if the job was submitted to
the spooler as a paused job by the Batch Job.
Initial JOB state
: Paused
Final JOB state
: Waiting
: The Hold command makes a job ineligible for processing by the spooler. The job
is held until it is released by the Release command.
Initial JOB state
: Canceled, paused, processed
Final JOB state
: Held
55

Cancel

Setup
: The setup command changes the job attributes such as the output, the number of
copies, the page range and the form….

Duplicate
: Duplicate Job command duplicates the specified job : one or several entry(ies) is
created in the active spool queue but the data file is not duplicated.

Rename
: The Rename Job (RENAMEJOB) command renames the specified job.

Assign to output : The assign command allows to change the output destination.


Initial JOB state
: Held
Final JOB state
: Held
Send to server
: The Send to server command moves a job from the server to another server
(future use).
Delete
: Delete Job command deletes the specified job from the spooler :
* when job is in active queue : job is moved to the RECYCLED queue
* when job is in recycled queue : job is deleted from the spooler Job has to be
inactive to be deleted.
Initial JOB state
: Canceled, paused, processed
Final JOB state
: Deleted
or

56
Undelete
Initial JOB state
: Deleted
Final JOB state
:Not applicable
: Undelete Job command undelete a job from the RECYCLED jobs queue and
move it to the ACTIVE jobs queue.
Initial JOB state
: Deleted
Final JOB state
: Held

Log report
: The Log Report command opens an event log about the job (operator
interventions and job processes).

Preview
: The preview command Launches the program specified in the windows file
association. The AFP files may for instance be associated with an AFP viewer.
Spool Print
9.1.3. Job States Diagram
Spool Print
57
<This page is intentionally left blank>
58
Spool Print
10. How to create an output
An output is a physical destination. It corresponds to a printer or a device (disk, E-mail...). An output may be
associated to one or more inputs.
A job with a held status can be redirected from an output to another.
10.1. Creating an output to drive an IPDS device
In order to create an output use the icon of the tool bar.

Select the icon

Enter the new name (i.e. PRT_IPDS) -> Apply
, and you will get this following display:
And you will get this following display:
Spool Print
59
10.1.1.Output configuration – General Tab
10.1.1.1.Format
IPDS (mandatory)
10.1.1.2.DataFilter
Depending on the jobs that will be processed by this output, the Data Filter must be set:

None
: When the jobs to process are IPDS jobs received over a DPF input.

AFPDS2IPDS
: When the jobs are AFPDS jobs (or Line Data transformed to AFPDS).

AFPforParserdll : When the jobs are AFPDS jobs and when a transform such as PCL or PostScript
is required.

IPDSforParserdll : When the jobs are IPDS jobs received over DPF and when a transform such as
PCL or PostScript is required.
10.1.1.3.Destination
Must be TCP/IP
10.1.1.4.TCP Address
TCP/IP address of the IPDS device
10.1.1.5.TCP port
This number (ranging from 5001 to 65535) is the TCP/IP port number of the IPDS device. The IPDS device
must accept IPDS data on this port.
If you define several outputs addressing a Blue Server, use a different port number for each Blue Server
Printer configuration.
10.1.1.6.Connection Retries
This number specifies the number of retries Spool2Print will attempt to connect to a printer which did not
respond to a connection request. This parameter is used when starting the output.
10.1.1.7.Disconnect Timeout
This number is a timeout in seconds. It specifies the amount of time to wait, after the last page of the last
ready spooled file has printed, before Spool2Print releases the TCP/IP connection or IPDS dialog with the
printer. A value of “-1” means that Spool2Print never releases the communication with the printer.
10.1.1.8.Ppd Trace File
When checked, specify the path and file name for the trace file (To be used for debugging purposes only).
The default path for the trace is “..MPI_Tech\MPI_Spooler\spool-exe\Trc\” and the file name corresponds the
name of the output and the extension is .spy.
Spool2Print creates a new trace for each TCP/IP connection.
10.1.1.9.Ppd Log File
When checked, specify the path and file name for the Ppd log file (To be used for debugging purposes only)
The default path for the ppd logs file is “..MPI_Tech\MPI_Spooler\spool-exe\”.
60
Spool Print
10.1.1.10.Trace Open Mode
This parameter is active when the PPD trace mode is activated (PPD Trace File or PPD log file checked).
The trace files are created in the directory “..MPI_Tech\MPI_Spooler\spool-exe\Trc”

Append
: The new data will be added to the previous data in the log file.

* New
: Each time the output is started, Spool2print deletes the previous trace file and
creates a new one.
10.1.1.11.Description
This parameter is a free comment that gives information about the Output.
10.1.1.12. Job Separator
This parameter defines the presence and the number of banner and trailer pages added at the beginning
and the end of the jobs. The banner pages give information about the jobs and separate the jobs.

No
: No Banner added.

Yes
: One banner page is added at the beginning of the job.

HP
: Three banner and trailer pages are added.
10.1.1.13.Initial Status
This parameter defines the status of the output when Spool2Print starts.

Offline
: At server startup, the output is not active.

Ready
: At server startup, the output is ready to process jobs.
10.1.1.14.Check Point
Specifies the frequency, in pages, with which Spool2print sends IPDS acknowledgment requests to a
printer. The acknowledgment request responses from the printer contain information as to the status of
pages sent to the printer.
10.1.1.15.OutGrp
Used with MVS Download Input only.
10.1.1.16.Processed When
Define when the job is considered as processed. The acknowledgment request responses from the printer
contain the pages counters which indicate the status of pages. The different IPDS page counters are
named “Received”, Committed”, “Operator Viewing”, “Jam Recovery” and “Stacked”. By setting “Processed
When” the job becomes processed when the specified page counter matches the “Received” page counter.

Stacked
: Job is processed when “stacked” and “Received” page counters are equal.

Jam Recovery
: Job is processed when “Jam recovery” and “Received” page counters are equal.

Viewing
: Job is processed when “Operator Viewing” and “Received” page counters are
equal.
10.1.1.17.Mark Form
Sends the IPDS “Mark Form” command at the beginning and the end of the job. This command causes the
printer to mark the current or the next sheet with a device-specific Form.
10.1.1.18.Ctrl Edge Mark
Edge marks consist of one, two, or three narrow bars printed perpendicular to the media perforation and
entirely within the left carrier strip ending at the trailing edge of the sheet. A corresponding number of edge
marks are printed.
Spool Print
61
10.1.1.19.Eject TimeOut
Specifies, in seconds, the timeout to send an IPDS “Stack Received Pages” command to the printer to
stack all pages that have been committed for printing. When this command is completed, the job becomes
processed.
10.1.1.20.License in PPM
Indicates the speed of the attached device.
10.1.1.21.MaxQueuedJobs
Specifies the number of jobs running concurrently on a printer (jobs with the status “Processing”
simultaneously). When many small jobs are ready for processing it can be useful to increase this
parameter. In this case Spool2Print will send multiple jobs to the printer without acknowledging each file.
10.1.1.22.Job Split
Used when one wants to split the job after every N pages.
Example: some printers do not accept jobs with a page number larger than 65 535. You can setup this
parameter for spool2Print creating a new job every 65000 pages.
62
Spool Print
10.1.2.Output configuration – Library path tab
If the AFP file received does not contain all the AFP resources requested, you can use external resources
stored on the server. Specify the Directory path for each kind of resource.
10.1.2.1.Libraries path
For each type of AFP resource, specify the local directories where this specific type of local resources may
be found. The resources types are:
o
Fonts
o
Form definitions
o
Object containers
o
Overlays
o
Page definitions
o
Page segments
o
User libraries
: Character sets, coded fonts, code pages.
: A local AFP resource will be first search in this libraries.
10.1.2.2.Default FormDef
This is the default FormDef to be used if no FormDef is provided with the AFPDS.
10.1.2.3.Default Font
These are the default fonts to be used.
10.1.2.4.Default PageDef
This is the default PageDef supplied for Line Data.
Spool Print
63
10.2. Creating an output with an AFP transform to PCL, PDF…
In addition to driving IPDS printers, Spool2Print can address PCL or PostScript printers. It also can
transform the jobs to PDF or other formats.
In this example, we will create an output which converts the jobs to PDF.
In order to create an output use the icon of the tool bar.

Select the icon

Enter the new name (i.e Transform_PDF) -> Apply
, and you will get this following display:
And you will get this following display:
10.2.1.Output configuration – General Tab
10.2.1.1.Format
IPDS (mandatory)
10.2.1.2.DataFilter
Depending on the jobs that will be processed by this output, the Data Filter must be set:

IPDSforParserdll : When the job to process are IPDS jobs received over a DPF input.

AFPforParserdll : When the jobs are AFPDS jobs (or Line Data transformed to AFPDS)
10.2.1.3. Ppd Trace File

64
Checked
: When checked, specify the path and file name for the log file (To be used for
debugging purposes only)
Spool Print
10.2.1.4.Ppd Log File

Checked
: When checked, specify the path and file name for the log file (To be used for
debugging purposes only)
10.2.1.5. Job Separator
Allows to insert a banner and trailer pages.
10.2.1.6.Checkpoint
Specify the number of pages between each acknowledge commands between Spool2Print and the IPDS
device (This parameter corresponds to MVS parameter CKPT)
10.2.1.7.Description
Free Comments giving information about the output
10.2.2. Output configuration – Library path tab
If the AFP file received does not contain all the AFP resources requested, you can use external resources
stored on the server. Specify the Directory path for each kind of resource.
10.2.2.1.Library path
For each type of AFP resource, specify the local directories where this specific type of local resources may
be found. The resources types are:
o
Fonts
o
Form definitions
o
Object containers
o
Overlays
o
Page definitions
o
Page segments
o
User libraries
: Character sets, coded fonts, code pages.
: A local AFP resource will be first search in this libraries.
10.2.2.2.Default FormDef
This is the default FormDef to be used if no FormDef is provided with the AFPDS.
Spool Print
65
10.2.2.3.Default Font
These are the default fonts to be used.
10.2.2.4.Default PageDef
This option is only available for Line Data.
10.2.3.Output configuration – PARSERDLL tab
This window allows to setup most of the parameters used for the transform.
10.2.3.1.Internal IP Port
This is the internal IP port used by the spool2Print transform. This unique port must be a free IP port (not
used by another output to drive an IPDS printer for instance).
10.2.3.2.Output Language
Spool2Print will transform the jobs to this format. The allowed values are:
o
BMP
o
PCL5
o
PostScript level 2
o
PostScript level 3
o
PDF
o
TIFF
o
PPML
10.2.3.3.Printer Emulation
This is the base IBM printer emulation to perform the transform.
10.2.3.4.Input Resolution
This is the resolution of the resource expected for the transform.
10.2.3.5.Code Page
This is the default code page used for the transform.
66
Spool Print
10.2.3.6.Block Char Error
When checked, if a character error occurs during the transform, it is not reported.
10.2.4.Output configuration – PARSERDLL Tab – Advanced Setup
These additional windows allow to setup additional settings such as the paper trays, the job naming ….
Spool Print
67
10.2.5.Status and Operator commands
10.2.5.1.Output status
The Output can have different status:

Ready
: The output is ready for receiving data

Error
: Specifies that a spool writer is in error

Offline
: Specifies that a spool writer is offline

Processing
: Specifies that a spool writer is processing
10.2.5.2.Output commands

Search output
: Helps you to locate the output you want to work with (useful when many outputs
are defined

Start
: Start command starts the specified output. During its operations, the output sends
IPDS the device defined.

Stop

Setup

Rename

Create

Duplicate

Delete
Initial WTR state
: Offline
Final WTR state
: Waiting
: Stop Writer (STOPWTR) command immediately stops the activity of the specified
spooling writer.
Initial WTR state
: Waiting
Final WTR state
: Offline
: Rename Writer (RENAMEWTR) command renames the specified spooling writer.
: Delete the specified output when status = offline
10.2.5.3.Log report
Writer (WTR, OUTPUT in GUI) commands:



68
Delete Writer (DELETWTR)
: Delete Writer (DELETEWTR) command deletes the
specified writer from the spooler. The WTR will be
deleted only in OFFLINE state.
Duplicate writer (DUPLICATEWTR)
: Duplicates the specified writer.
Pause Writer (PAUSEWTR)
: Pauses temporarily the activity of the specified spooling
writer.
Initial WTR state
: Waiting
Final WTR state
: Paused
Spool Print
11. Configure the GUI remote access
The GUI is the Graphical User Interface which allows to display the status and to control the activity of
Spool2Print.
The GUI can be a java Client software or a java applet which can be opened in from a web browser.
In any case, the GUI is a Java application and JAVA must be installed on the station you want to run the
GUI from.
11.1. Overview
The following figure describes the different components involved in the communication between Spool2print
and the GUI.
Spool2Print
Multicast Chanel
MPISPOOLER.exe
IP
MpiS2PhttpServerW
HTTP
Link
HTTP Clients
(Web Browser)
Serv2Print
IP
Link
Java GUI
Client
(IP)
Multicast
Java GUI
Client
(Multicast)
MPISpooler is the Spool2Print engine. It only communicates over multicast.
Serv2Print is a component which transforms the multicast messages to TCP/IP messages.
MpiS2PhttpServerW is the embedded Web server which allows access from a web browser.
11.2. The Java client
The Java Client is an application which can run on the server itself or on remote workstation.
During the installation process, the Java client is installed on the server. All the software components for
this application are in the directory “..\MPI_Tech\MPI_Spooler\gui-exe”.
It is therefore possible to launch the GUI on the server itself and monitor Spool2Print. It is also possible to
monitor Spool2Print from a remote workstation. In this case you need to copy the GUI programs to the
remote workstation and run the GUI from there.
Spool Print
69
When you start the java client for the first time, It scans the network cards to establish the communication
with Spool2Print and displays the Spool2Print servers available:
Select the one you want to work with.
11.2.1.GUI communication setup
To setup your preferred GUI communication, use the “Preference” menu, > Connection > Setup
70
Spool Print
Selecting “Setup” opens the connection setup window
When the Java Client is connected, uncheck the box “Automatic Network Card Selection”. It will speed up
the connection of the client next time it will be started as the client will then not scan the network cards but
will use the one configured manually.
11.2.1.1.Connection setup parameters
Check the connection setup from the preference Menu.
Selecting “Setup” opens the connection setup window
Spool Print
71
11.2.2.GUI communication over TCP/IP
The default communication method between the Server and the GUI interface is TCP/IP.
The TCP/IP radio button must be checked
TCPIP address is the IP Address of the Spool2Print server.
TCP/IP Port is the port number used for the communication with Spool2Print. It must match the
IPServerPort key in the spool2Print server.
NB : In the registry, the IPServerOption key must be set to IPSC
11.2.3.GUI communication over Multicast
Multicast is another communication method between the Server and the GUI interface.
Multicast is over UDP. Be aware that multicast is not always rooted in company’s network. Please check
with your network administrator when Multicast can be used.
72
Spool Print
Multicast Address
: must match the registry key MultiCastAddress
Read Port
: must match the registry key MulticastWritePort
Write Port
: must match the registry key MulticastReadPort
11.3. The GUI from a web browser
It is possible to control Spool2Print from a browser installed on the remote workstation. In this case, it is not
requested to copy the GUI client to the remote workstation but Java must be installed.
11.3.1.Installation
During the installation, at the “Program Maintenance window”, check the “Modify” Radio Button.
At the next window, Make sure that the “Applet” feature will be installed.to the local hard drive.
When this feature is part of the installation, the folder ..\MPI_Tech\MPI_Spooler\gui-exe\Applet is copied to
the disk and new entries are created in the Windows registry at the location:
HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler\WebServer
Spool Print
73
Values allowed:

ActivateOnStartup
: Defines if the Spool2Print web server is started automatically when
Spool2Print starts.

Hide
: When YES, the web server interface is hidden.

JREPath
: Optional. Used to specify a specific Java version to be used.

Port
: Defines the TCP/IP port used for the communication with the browser
(Default http port = 80).

RootDir
: Installation path
11.3.2.Serv2Print.exe process
With the task manager, make sure that the Serv2Print.exe is part of the processes running on the server
running Spool2Print.
11.3.3.MpiS2PhttpServerW.exe process
The MPIS2PhttpServerW.exe process is the process to start the Web server (Java application
MpiS2PHttpServer.jar) which gives you access to Spool2Print.
This process is automatically started when the registry key ActiveOnStartup = YES.
11.3.4.Connect from the browser
In the browser address field, type:
http://<IP address of the server>
Where <IP address of the server> is the IP address of the spool2print server or its DNS name.
If in the registry the “Port” key has been set with a value different of 80, use in the address field the port
selected.
Example: If the port has been set to 8080 instead of 80, type
http://<IP address of the server>:8080
74
Spool Print
12. Job Submission
The parameters of a job depend on the input it is received from. The job inherits properties from the input
definition. Depending on the input type, it is possible to modify some job parameters.
12.1. Disk
When a job is submitted from a disk (hot folder), prior to copy the input file to the input hot folder, it is
possible to copy a parameter file to the hot folder. The parameter file has the same name as the input file
and has the additional extension “.parms.xml”.
Example: the input file name is “123456_invoice.afp”. When processing this file, if Spool2Print finds a file
with the name “123456_invoice.afp.parms.xml” it corresponds to parameters for the input file.
The parms.xml file must follow a precise syntax:
<JOBPARM>
<JOBNAME>New_job_name_3</JOBNAME>
<WRITER>INFOPRINT_4100</WRITER>
<COPIES>15</COPIES>
<FROMPAGE>2</FROMPAGE>
<TOPAGE>5</TOPAGE>
<STATUS>waiting</STATUS>
<FORMS>PREPRINTED</FORMS>
</JOBPARM>
The delimiter <JOBPARM> is mandatory. The other parameters are optional
12.2. LPR
When an input is defined with the Source = LPD, It can receive any kind of data over TCP/IP.
In a standard Windows environment, the LPR.exe utility from Microsoft can be used. When you need to
give more information about the file sent to Spool2Print MPI Tech provides the LPRMPI.exe program which
provides additional parameters which can be used to setup the job.
From a command window, when you run the LPRMPI without arguments, the syntax of the command is
displayed. The syntax of the LPRMPI is:
LprMpi [-<options>] [-s<serverAddress>] [-p<queue or printer>] <file>[ <file>]
The available options are:
-Verbose
-s<serverAddress>
-p<queueName or printerName>
-J<jobName>
-H<hostName>
-P<userName>
-F<fileName>
-ocopies=<nbCopies>
-ocop=<nbCopies>
-occ=<carriage control option 'yes' or 'no'>
-otrc=<trace option 'yes' or 'no'>
-ochars=<coded fontName (e.g. GT12)>
-opagedef=<pageDefName (e.g. P1V06483)>
-opdeflib=<library pathName for pagedef>
-ooutbin=<outBinName>
-oprogrammer=<programmerName>
-ofileformat=<fileformat>
-odatatype=<odatatype>
Spool Print
75
-opa=class=<class parameter>
-opa=destination=<destination parameter>
-opa=forms=<formName>
-oaddress1=<address1>
-oaddress2=<address2>
-oaddress3=<address3>
-oaddress4=<address4>
-obu=<buildingName>
-ode=<departmentName>
-odo=<docName>
-ojobn=<jobName>
-oformDef=<formDefName>
-ona=<userName>
-oresp=<userLibName>
-osfo=<fontLibName>
-oov=<overlayName>
-oro=<roomName>
-oti=<title>
-ous=<usrId>
-ofileformat=stream,(newline=X<'HEXA DIGITS'>
-ofileformat=stream,(newline=crlf,ascii)
-ofileformat=stream,(newline=crlf,UTF8)
-ofileformat=stream,(newline=crlf,UTF16)
-ofileformat=stream,(newline=crlf,ebcdic)
-ofileformat=stream,(newline=lf,ascii)
-ofileformat=stream,(newline=lf,UTF8)
-ofileformat=stream,(newline=lf,UTF16)
-ofileformat=stream,(newline=lf,ebcdic)
-ofileformat=stream,(newline=cr,ascii)
-ofileformat=stream,(newline=cr,UTF8)
-ofileformat=stream,(newline=cr,UTF16)
-ofileformat=stream,(newline=cr,ebcdic)
Example:
C:\lprmpi -JmyData -Pguest -ocopies=15 -opa=forms=Preprint -s192.168.31.128 –pLpInput -myjob.pcl
76
Spool Print
13. Using the Spool2Print Exits
13.1. Description
When Spool2Print receives data from an input or process a job to an output, it is possible to invoke
Spool2Print Exits which are external programs which can interact with the Data.
The exit can be any external program (*.exe file) or batch file.
Example of applications:
13.1.1.Input Exit
AFP files are transferred from a host to a Spool2Print hot folder. As the AFP files can be very large, it has
been decided to compress the AFP files to optimize the file transfer.
By creating a new input and using an exit, spool2print now receives the AFP archive file, decompress it by
invoking an external program and copy the AFP file to original hot folder to become an AFP job
13.1.2.Output Exit
PCL jobs selecting paper trays are received and printed to different PCL printers. A PCL printer does not
support the same PCL input tray commands.
By using the MPI Tech Search&Replaced Spool2print exit for these particular printer (output). Before
printing, the PCL data is scanned and the PCL trays commands are substituted with the printer specific
paper tray commands.
13.2. Configuration
13.2.1.Input exit
13.2.1.1.For a specific program
To configure the user exit on the input, use the USEREXIT tab.
Spool Print
77
13.2.1.1.1.Exit command

The “Exit Command” parameter is the full path to invoke the exit.
Example:
When Winrar is installed on the server, to extract a file from an archive, use the
“Exit command” = “C:\Program Files\WinRAR\unrar.exe”
13.2.1.1.2.Command parameters

The “Command Parameters” are the parameters passed to the exit program.
Example:
With the “Exit Command” = “C:\Program Files\WinRAR\unrar.exe” you can use the
“Command Parameter” = “x %FULLPATHNAME% C:\AFP_IN”
Where:
x
: Extract files with full path (unrar parameter)
%FULLPATHNAME% : Spool2Print variable indicating the compressed file full path received from
this output.
C:\AFP_IN
: folder to copy the file extracted
13.2.1.2.Setup Input exit for a bat or cmd file
To invoke a batch file (*.bat or *.cmd file) use the “Exit command” = “c:/windows/system32/cmd.exe”.
In this case, the “Command parameters” starts with “/c”
The “Command parameters” can contain Spool2Print variables relating to the job and the input.
The variables which can be used are:
 %FILENAME%
: Job File name.
 %FULLPATHNAME%
: Job file name with full path as received from the input.
 %HOTFOLDER%
: Input Hot folder path
 %OUTFILENAME%
 %PARMNAME%
 %READERNAME%
 %EXITDIRPATH%
When executing the exit, the information relating to these variables are copied to the file
./log/MPISPooler.dbg.txt
78
Spool Print
13.2.2.Output Exits
To configure the user exit on the output, use the USEREXIT tab
The “Exit Command” parameter is the full path to invoke the exit.
The “Command Parameters” are the parameters passed to the exit program.
The “Command Parameters” can contain Spool2Print variables relating to the job and the input.
The variables which can be used are:
 %CURRDIRPATH%
 %CURREXITPATH%
 %FILENAME%
 %FULLPATHNAME%
 %JOBID%
 %JOBNAME%
 %OUTFILENAME%
 %XMLPARMNAME%
 %WRITERNAME%
 %EXITDIRPATH%
Example: the bat file listparm.bat copies the S2P exit parameters to the file S2P_Out_Parms.txt
Spool Print
79
<This page is intentionally left blank>
80
Spool Print
14. User management
The default Spool2Print installation does not use the user management.
When operating in an organization, it can be important to limit the access to Spool2Print to some persons
with customized rights. It is the user management.
Spool2Print gives the ability to define Groups and Users. The Group defines a set of operations and views
allowed. A User belongs to a Group and has a login.
14.1. Groups
A Group specifies the operations allowed on the Servers, the Inputs, the Jobs and the Outputs.
The different operations per elements are:

Server
: Add, Remove, Start, Stop

Inputs
: Create, Delete, Start, Stop, Setup, Rename, Duplicate

Jobs
: Release, Pause, Resume, Hold, Interrupt, Delete, Setup, Duplicate, Rename,
Assign, Send to, Move.

Outputs
: Create, Delete, Start, Stop, Interrupt, Setup, Rename, Duplicate
When the user management is activated, the group “SUPERVISOR” is automatically created. It gives all the
rights on all elements. Only the users belonging to this group can setup the user’s rights.
You can create as many groups as you want.
Spool Print
81
14.2. Users
A User belongs to a group. When the User Management is activated, a login is necessary to have access to
Spool2Print. To login when the User Management is activated, a User name and the associated password
are required to access Spool2Print.
Despite the User inherit the rights from the Group it belongs to, it is still possible to modify them without
having to create a new Group.
The User setup allows specifying filters for the input, the jobs or the outputs. This functionality allows limiting
the User access to specific inputs or outputs. With the following example, the Output Filter is set to “PRT”
for User Oper1. This means that the user Oper1, will only have access to the outputs whose name
comprises the string “PRT”.
Note: The User name and the password are case sensitive.
82
Spool Print
14.3. Setting up the User management
When the User Management is not activated, no login is necessary to access Spool2Print. The Spool2Print
window title indicates that you are connected in “Supervisor mode”.
When the User management is activated, the user ADMINISTRATOR with the password “adminS2P” is
automatically created. This user belongs to the group SUPERVISOR and is always available and has all the
rights.
To activate the User Management and configure the users your login must be part of the SUPERVISOR
group.
To activate or modify User Management, select “Group & Users” in the tree (left side of the window). In the
following figure, the icons relating to the user management are surrounded with a red ellipse.
14.3.1.Create a Group
To create a new group, select the icon
. The “Create Group” window appears.
Enter the name of the new group (Example “Operator”) and make “Apply”.
The Setup of the group “Operator” appears. By default, the new group has all the rights. Uncheck the boxes
corresponding to the rights you want to remove
Spool Print
83
Select the rights you want to grant the group by checking the corresponding check boxes. Make Apply.
The group appears in the group list. The default Group SUPERVISOR is automatically created with the
default user ADMINISTRATOR (password = “adminS2P”) belonging to this group. When the user
Management is activated, the user ADMINISTRATOR is always available and has all the rights.
When a group has been created, the user management
..\MPI_Tech\MPI_Spooler\spool-exe\users\UserRights.xml has been created.
is
activated
and
the
file
It contains all the user’s information. Removing this file and restarting the Spool2Print will deactivate the
user management.
84
Spool Print
14.3.2.Create a User
To create a new User, select the icon
. The “Create User” window appears.
Enter the name of the new User (Example “Oper1”) and make “Apply”.
The Setup of the User “Oper1” appears.
Enter the password you want to associate to this user, select the Group you want this user to belong to and
set the Filters. It is also possible to adapt the rights compared to rights of the group by checking or unchecking the boxes corresponding to the operations.
Spool Print
85
14.4. Login to Spool2Print
When the User management is activated, when you start the interface with the Spool2Print, the login
window is first displayed.
Enter the Username and the password.
The Username can be selected from the Combo box which gives the list of the known users when the
option “Keep Users Context login” is selected. This option is a server parameter. It is parameter is only
accessible when connected with the login ADMINISTRATOR.
The title of the Spool2Print window indicates the login used for the communication. In the above image, the
Current User is “ADMINISTRATOR”
When a user is logged on, use the icon
When no user is connected, use the icon
86
to log off.
to display the log in window.
Spool Print
15. Statistics
Over the time, Spool2Print stores information about the status of the printing production.
The statistics files are stored in the folder “..\MPI_Tech\MPI_Spooler\spool-exe\stats”
The file “S2P_Stats_Options.xml” represents the configuration for the statistics and specifies the fields that
you want to be stored in the statistic files.
You can modify the “S2P_Stats_Options.xml” configuration from the GUI. Make a right click on the server
name and select “Customize Statistics view”.
The following table appears and you can select the fields you want to store in the statistic files
The csv files contain the statistics information. At the end of each operation, a line with the fields selected in
the “S2P_Stats_Options.xml” is added to these files.
The file MPISPooler.csv contains the information for all outputs. In addition, you have one csv file per output.
Spool Print
87
15.1. Example
JOBID
NAME
PAGES
COPIES
FROMPAGE
TOPAGE
CURPAGE
2010/11/18-16:30:21
EVENTTIME
0FB53388C036C000
MPITECH._500 pages.afp
BS_local
WRITER
500
1
1
500
281
2010/11/18-16:27:42
PLAYTIME
interrupted
STATUS
2010/11/18-16:32:31
0FB53388C036C000
MPITECH._500 pages.afp
BS_local
500
1
281
500
280
2010/11/18-16:30:43
processed
2010/11/18-16:34:27
0FB53278AEB8DC00
CamiegOpe2789-A01.afp
BS_local
177
1
1
2
0
2010/11/18-16:34:23
processed
The first job contains 500 pages. It was printing and was interrupted at page 281.
It has been reprinted from page 281 and the final status is processed.
88
Spool Print
16. Setting up a Secondary Server
In a production environment, it may be necessary to move the production server to another physical server
or to setup a secondary server which can be used as a backup in case of the primary server fails.
16.1. Installation
Pre-requisites:

In order to operate correctly, it is necessary to install the same Spool2Print version on both servers.

The installation paths must be the same.

On the new server (e.g. the server used for backup), Spool2Print must be stopped (Services “MPI
Spool 2 Print Service” and process “MPISpooler.exe” must be stopped).

The AFP resource libraries must be identical and with the same paths on both servers.

In order to be able to start MPI Spool2Print on the backup server, you must get a valid license for the
primary server from MPI Tech.
Once MPI Spool2Print has been installed, it is necessary to copy the database to the secondary server.
16.1.1.Backup / Restore the Database
The directory ..:\MPI_Tech\MPI_Spooler\database\ contains the Spool2Print databases.
The subdirectory \Spool contains the jobs data. For instance, all the AFP jobs are stored in this directory.
The subdirectory \XML contains the Spool2Print configurations (example inputs, outputs…) and the job
descriptions.

If you just want to copy the Spool 2 Print configuration, copy the from the \XML directory, the files with
filenames starting with “rdr_” (input definitions) or “wtr” (output definitions).

If you also want to copy the jobs, copy from the entire \XML directory and the \Spool directory
16.1.2.Licenses
When setting up a backup server an additional “backup” license is necessary for the primary server.
When setting up a secondary server for backup purposes, there is no need of licenses for it but the primary
server must receive an additional “backup” license to allow the primary server to distribute temporary
licenses to the secondary server.
16.2. Setting up the servers for backup support
The Secondary Server, which is used as a backup server, is available in case the Primary server fails.
On the Secondary server, the MPI Spool2Print must not run. The Service “MPI Spool2Print Watchdog” is
running and monitors the activity of the Primary Server. If the Primary server fails (is not reachable over
TCP/IP), the Service “MPI Spool2Print Watchdog” automatically starts the MPI Spool2Print Service.
16.2.1.Primary Server configuration
On the primary server, the only operation is to get from your MPI Tech representative a backup license and
to install it.
Spool Print
89
16.2.2.Secondary Server configuration
In order to complete the installation of the Secondary server:

Make sure that the service “MPI Spool2Print Service” is not started and that the process
“MPISpooler.exe” is not running

Open the registry and set the key “MainServerAddress” located in

“\HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\WatchDog” with the IP address or DNS name of the
Primary Server.

Adapt the key “TriggerDelay” to an acceptable value

Start “MPI Spool2Print Watchdog” service
Once this operation has been completed Spool2Print is ready to run on the backup server and operate.
90
Spool Print
17. Database parameters
Spool2print stores the jobs and the object description in the folder:
<Installation_Directory>\MPI_Tech\MPI_Spooler\database.
This folder contains three subdirectories:

Spool : contains the spool files data received from the inputs. When data is received from a spool,
The spool is stored with the name _<Unique job ID>_<date>_<time>_<job name>

Work
: contains temporary resources files extracted from the files (Fonts, FormDef, Objects,
Overlay, PageDef, PageSeg, UserLib) and temporary conversion files. The temporary files
are stored in subdirectories with the name of the relating input or output.

XML
: contains the object descriptors in XML format. Each object (input, job and output) parameters
are stored in a xml file. Depending on the object type, The xml file naming convention follows
the following rules:
Jobs:
Prefix
= “job_”
File name structure
= <Unique job ID>_<date>_<time>_<job name>
Suffix
= “.xml”
Example: job__faeff7815109000_20070913_150517036_EDT.LOT01A1.Q07190.afp.xm l
Input:
Prefix
= “rdr_”
File name structure
= <input name>
Suffix
= “.xml”
Example: rdr_INPUT1.xml
Output:
Prefix
= “Wtr_”
File name structure
= <output name>
Suffix
= ”.xml”
Example: wtr_PDF_Direct.xml
Typically, a job received from an input is stored in the directory \Spool and its description and parameters is
stored in the directory \Xml
Spool Print
91
17.1. The XML parameters
Here is the list of XML tags for each object.
17.1.1.Inputs:
XML Tag
Description
<READER>
<NAME>
<DESCRIPTION>
<SOURCE>
<NAME>
<FORMAT>
<STREAM>
<FILTER>
<DESTINATION>
<NAME> (list)
<PLAYTIME>
<RETAINTIME>
<DEFJOBSTATUS>
<DEFJOBCOPIES>
<FORMS>
<PRIORITY>
<RESOURCE>
<DEFAULT>
<FONT>
<FORMDEF>
<PAGEDEF>
<OVERLAY>
<FRONT>
<BACK>
<LIBRARY> (list)
<FONTLIB>
<FDEFLIB>
<OBJLIB>
<OVERLIB>
</PDEFLIB>
<PSEGLIB>
<USERLIB>
<STATUS>
<OUTGRP>
92
Spool Print
17.1.2.Jobs:
XML Tag
Description
<JOBID>
<NAME>
<DATATYPE>
<READER>
<WRITER>
<PAGES>
<COPIES>
<FROMPAGE>
<TOPAGE>
<CURPAGE>
<CURCOPY>
<RESOURCE>
<DEFAULT>
<FONT>
<FORMDEF>
<PAGEDEF>
<OVERLAY>
<FRONT>
<BACK>
<LIBRARY>
<FONTLIB>
<FDEFLIB>
<OBJLIB>
<OVERLIB>
</PDEFLIB>
<PSEGLIB>
<USERLIB>
<SUBMITTIME>
<PLAYTIME>
<RETAINTIME>
<DELETETIME>
<STATUS>
<STATERR>
<STATSTR>
<FORMS>
<CCBYTE>
<CCTYPE>
<TRCFONTS>
<SOSI>
<NEWLINE>
<ADDRESS1>
<ADDRESS2>
Spool Print
93
<ADDRESS3>
<ADDRESS4>
<BUILDING>
<CLASS>
<DEPARTMENT>
<DESTINATION>
<DISTRIBUTION>
<STRID>
<OUTGRP>
<ROOM>
<TITLE>
<USERID>
<USERNAME>
<STRNAME>
17.1.3.Submit Jobs:
When you submit jobs over a hotfolder, it is possible to specify some parameters by adding first a xml file to
the hot folder. This xml file filename has the following structure:
<AFP_Filename>.afp.parms.xml
Where the <AFP_Filename>.afp is the name of the afp file to be processed.
The xml parameter file contains the tag <JOBPARM> and the different xml job tags you wish to configure.
Example:
<JOBPARM>
<NAME>myafpfile_display</NAME>
<COPIES>20</COPIES>
<FROMPAGE>2</FROMPAGE>
<TOPAGE>2</TOPAGE>
<FORMDEF>F1A10110</FORMDEF>
<PRIORITY>9</PRIORITY>
<FORMS>GREEN</FORMS>
</JOBPARM>
In this example, the parameter <NAME> can be used to display the name of the job in the interface.
94
Spool Print
18. Trouble shooting
18.1. Installation Error 1325
During the installation, if you have tried to change the default installation path, and you get the following
display:
Action:
Make sure that the new drive is accessible or valid.
18.2. Installation Error 1720
Installing Spool2Print and you get the following display:
Action:
Make sure that Java is installed on the workstation/server.
18.3. Starting your Spool2Print GUI and you get message:
18.3.1.Unable to find a version of the runtime to run this application
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Make sure that minimum version Microsoft.NET Framework 3.5 is installed.
18.3.2.Windows cannot find ‘javaw.exe’
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Spool Print
Make sure that Java is installed on the workstation/server.
95
18.3.3.The system cannot find the file specified command = javaw.exe -jar Spool2Print.jar
Starting your Spool2Print GUI, and you get the following dialog box:
Actions:

Make sure that Java is installed on the workstation/server.

If you have installed Spool2Print (32 or 64 bits) on Windows OS x64, and your Java version is a
32 bits, verify:
-
Edit from ..\MPI_Spooler\gui-exe directory this file Spool2Print.JavaProperties, and modify the line
JREPath =
C:\Program Files (x86)\Java\jre7\  set your installation path
save it and reload.
-
Or install directly a new Java version x64.
18.3.4.Could not find the main class. Program will exit
Starting your Spool2Print GUI, and you get the following dialog box:
Action:
Make sure that Java version installed is 1.6.x_y or higher.
18.3.5.JVM Memory too small to run correctly
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Check on this workstation/server, that a minimum of 2 GB RAM is installed,

Then modify from ..\MPI_Spooler\gui-exe directory this file Spool2Print.JavaProperties, and modify:
Options
= -Xmx256m
Note: Need to be adjusted with numbers of jobs stored in Spool2Print and the available memory.
Save, and reload Spool2Print GUI.
96
Spool Print
18.3.6.Spool2Print – Error on Server Address x.x.x.x Port 6789 (Ping Error)
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Check on this workstation/server, that the port is correctly configured,

Verify your Firewall configuration.
18.3.7.Server does not respond perhaps it is busy
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Refresh the screen.
18.3.8.Spool2Print Already Active on this computer, instance port = 6790
Starting your Spool2Print GUI, and you get the following dialog box:
Action:

Spool Print
Verify that another GUI is not opened. You can start only one S2P GUI on the server.
97
18.4. How to register your Spool2Print
If you start Spool2Print without a valid license, you will get the following dialog box,
And, at the bottom left side of the Spool2Print GUI you will get the message:
Server info (CNODE2) Waiting Server Response…
Follow the procedure.
18.4.1.Procedure for sending the keys.cfg file

From an explorer, go to ..\MPI_Tech\MPI_Spooler\spool-exe directory,

A keys.cfg file has been created with a unique registering number.

Forward it to your MPI contact. Upon reception of this registering number, MPI will generate a new
keys.cfg containing the license agreement to operate Spool2Print on your server/worksation.
18.4.2.key.cfg file received from MPI with the agreement

Once you get this file, stop the MPI Spool 2 Print Service,

Copy this keys.cfg file to same location,
Restart the MPI Spool 2 Print Service.
98

i.e CNODE2,

Your Spool2Print is now ready.
Spool Print
18.5. How to update Spool2Print
18.5.1.Introduction
Downloading from the www.mpitech.com , installing from a new CD-ROM, or from a link please execute the
following steps:
18.5.2.Getting started
Action:
Before installing the newest Spool2Print version, check on the station or server:

The MPI Spool2Print Service must be stopped,

All the printers must unloaded,

The Spool2Print GUI must be closed,

Execute the setup.exe, and you get this message

Select Yes, if you want to execute an update,

Select Next, and you will get at the end,

Select Finish

Restart your Spool2Print GUI.
Spool Print
99
18.6. How to add columns to the Spool2Print GUI
18.6.1.Description
This section describes how to display new columns in the GUI.
It shows how to display the columns for existing job parameters such as <ROOM> or <TITLE> which are not
displayed in the default GUI. Also, it describes how to add new columns corresponding to new custom job
parameters.
The section <VARKEYS> allows to define up to 10 dynamic columns that can be added and displayed in the
GUI.
<VARKEYS>
{<OPTION | <PARM} {0,9}> value {</OPTION | </PARM} {0,9}>
<VARKEYS>
With the above syntax, use the keyword <OPTIONn> when it refers to an existing job parameter you want to
display. Use <PARMn> when it is a new custom job parameter.
The number ‘n’ must be unique in the <VARKEYS> section and defines the dynamic column number.
18.6.1.1.Case 1: How to display the existing job parameter <ROOM> which does not appear in the default
GUI
In the <VARKEYS> section, define the dynamic column corresponding to the <ROOM> parameter.
When submitting a job to a hot folder input, the job parameter file (.parms.xml) contains the parameter
<ROOM> with a value and the section <VARKEYS> indicating that the parameter <ROOM>, which is an option,
is used as first dynamic column.
<JOBPARM>
<ROOM>Showroom</ROOM>
<VARKEYS>
<OPTION1>ROOM</OPTION1>
</VARKEYS>
</JOBPARM>
In the GUI, the first dynamic column will contain the value « Showroom ».
18.6.1.2.Case 2: You want to add a new parameter to the GUI corresponding to the City name
In the <VARKEYS> section, define the dynamic column corresponding to the <City> parameter.
When submitting a job to a hot folder input, the job parameter file (.parms.xml) contains the parameter
<PARM2> corresponding to the second dynamic column with the name of the city.
<JOBPARM>
<VARKEYS>
<PARM2>PARIS</PARM2>
</VARKEYS>
</JOBPARM>
In the same <VARKEYS> section, one can mix the <OPTION> and <PARM>.
Example :
<JOBPARM>
<ROOM>Showroom</ROOM>
<CLASS>A</CLASS>
<VARKEYS>
<OPTION1>ROOM</OPTION1>
<PARM2>PARIS</PARM2>
<OPTION3>CLASS</OPTION3>
</VARKEYS>
</JOBPARM>
100
Spool Print
In this example, the dynamic columns contain:
Col 1 = Showroom
Col 2 = PARIS
Col 3 = A
18.6.2.How to name the dynamic columns in the GUI
In the GUI, the dynamic column names are « Option n » (n from 0 to 9)
You can rename the dynamic column titles by modifying the file Spool2Custom.ini in the directory
« ..\MPI_Tech\MPI_Spooler\gui-exe » by setting, at the end of the file, the title for each dynamic column.
Example: Extract from the Spool2Custom.in :
COLOR_JOB=181,183,180
COLOR_JOB_SELECTED=156,154,99
COLOR_LABEL=0,0,0
COLOR_PRINTER=181,183,180
COLOR_PRINTER_SELECTED=198,219,222
COLOR_SELECTION=204,204,255
COLOR_STANDBY=236,236,236
COLOR_STANDBYSELECTION=181,183,180
COLOR_SUBTITLE_BACKGROUND=236,236,236
COLOR_SUBTITLE_FOREGROUND=0,0,0
COLOR_TABLE_BACKGROUND=255,255,255
COLOR_TABLE_FOREGROUND=0,0,0
COLOR_TABLE_FOREGROUND_SELECTION=255,255,255
COLOR_UI_BACKGROUND=156,154,99
COLOR_UI_FOREGROUND=255,255,255
Option0= Room
Option1= City
Option2= Class
The dynamic columns 0,1and 2 will respectively have the titles ‘Room’, ‘City’and ‘Class’
Spool Print
101
18.7. How to repair your Spool2Print Database
After a crash disk, Spool2Print could be not start able (or some devices, or spool not displayed).
Please execute the following steps:

Close your GUI,

Open an Windows command window,

Change to the drive and patch directory where this product has been installed,
For example:
D:\MPI_Tech\MPI_Spooler\spool-exe

Run the command:
MPISpoolSvc.exe stop

Wait the message:
'MPI Spool2Print Service' Stopped Successfully

From the Windows Task Manager → Processes Tab, wait the end of the process “MPISpooler.exe”,

Run the command:
MPISpoolSvc.exe remove

Wait the message:
'MPI Spool2Print Service' Removed Successfully

From the directory, ..\MPI_Tech\MPI_Spooler\database\XML, delete all files (*.xml) with null
size (0Ko),

Create an empty file named SPOOLSPL.SPL,

Run the command:
MPISpoolSvc.exe install

Wait the message:
'MPI Spool2Print Service' Installed Successfully

Run the command:
MPISpoolSvc.exe start

Wait the message:
'MPI Spool2Print Service' Started Successfully

102
Open your Spool2Print GUI, and check if everything is OK.
Spool Print
18.8. How to Move Spool2Print production environment to another server
It may be necessary to move Spool2Print to another server. In order to perform this operation, follow this
procedure.
This procedure may also be used if you want to install a backup server ready to operate in case of problem
with the production server.
Pre-requisites:

In order to operate correctly, it is necessary to have installed the same Spool2Print version on both
servers.

The installation paths must be the same.

On the backup server, Spool2Print must be stopped (Service “MPI Spool 2 Print Service” and
process “MPISpooler.exe” must be stopped).

The AFP resource libraries must be identical and with the same paths on both servers.

In order to be able to start MPI Spool2Print on the backup server, you must get a valid license from
MPI.
Once MPI Spool2Print has been installed, it is necessary to copy the database on the backup server.
18.8.1.Backup / Restore the Database
The directory ..:\MPI_Tech\MPI_Spooler\database\ contains the Spool2Print databases.
The subdirectory \Spool contains the jobs data. For instance, all the AFP jobs are stored in this directory.
The Subdirectory \XML contains the Spool2Print configurations (example inputs, outputs…) and the job
descriptions.

If you just want to copy the Spool 2 Print configuration, copy the \XML directory.

If you want to also copy the jobs, copy the \Spool directory
18.8.2.Repair the database
Once all the necessary files have been copied, repair the database on the backup server (as described in
the chapter “How to repair your Spool2Print Database”).
Once this operation has been completed you can start Spool2Print on the backup server and operate.
Spool Print
103
18.9. How to get logs and traces to forward to Technical support
When a problem occurs and you want to report this problem to your MPI Tech support, depending on the
problem follow this procedure.
18.9.1.Printout or printer(s) related
When you get a problem with printouts or printer related:

From the directory
: ..\MPI_Spooler\spool-exe

Command MPISpooler
: MPISpooler -zipTRC<printername>
-
Example for printer PRT5650
: MPISpooler -zipTRCPRT5650
-
Example for all printers
: MPISpooler -zipTRC*
18.9.2.Operating / manipulating Spool2Print
When you get a problem operating / manipulating Spool2print :

From the directory
: ..\MPI_Spooler\spool-exe

Command MPISpooler
: MPISpooler - zipLOG*
18.9.3.Major problem with Spool2Print
When you get a major problem with Spool2Print :

From the directory
: ..\MPI_Spooler\spool-exe

Command MPISpooler
: MPISpooler - zipALL
Notes: The option zipALL may take a while and produce big files
The files are created in the directory \MPI_Spooler\spool-exe\temp.
Forward them to your MPI technical support together with a complete problem description.
104
Spool Print
18.10.How to check Spool2Print web interface
1 -Make sure that you have a directory: "C:\MPI_Tech\MPI_Spooler\gui-exe\Applet" which contains:
- www (<dir>)
- MpiS2PhttpServer.exe
- MpiS2PhttpServer.jar
- MpiS2PhttpServer.JavaProperties
2 –New entries are created in the Windows registry at the location:
HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler\WebServer
Values allowed:

ActivateOnStartup
Defines if the Spool2Print web server is started automatically when
Spool2Print starts.

Hide
When YES, the web server interface is hidden.

JREPath
Optional. Used to specify a specific Java version to be used

Port
defines the TCP/IP port used for the communication with the browser
Default http port = 80
=> but must be set to any other customer value ie: 8080.

RootDir
Installation path
For this this configuration, it must be set to
ActivateOnStartup
= YES
Hide
= YES
Port
= 8080
Note: You can select the port to be used for the browser. If you select port = 8080 you must then type in
your browser (you need java installed on the workstation you browse from)
http://192.168.31.50:8080/
(Where 192.168.31.50 is the address of the spool2Print)
If you change your settings, restart the Spool2Print.
Spool Print
105
18.11.How to start MPI Spool2Print as User
18.11.1.Logon as Root

Go to the folder
/opt/MPI_Tech/MPI_Spooler/gui-exe
chmod –R 777 .

Go to

Start the spool2print without interface.
/opt/MPI_Tech/MPI_Spooler/spool-exe
./spool2print –nogui
18.11.2.Logon as a normal User

Go to the folder :
cd

/opt/MPI_Tech/MPI_Spooler/spool-exe
Launch the Spool2Print interface:
./spool2print –noroot –nosp
18.12.How to configure Job deleting after processed

From Windows x64 registry Editor:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\MPI Tech\MPI Spooler

From Windows x32 registry Editor:
HKEY_LOCAL_MACHINE\SOFTWARE\MPI Tech\MPI Spooler

Add and set a new key String Value
“RecycleTime”

Add and set a new key DWORD (32-bit) Value
“RecycleSecs”
For example:
106
Spool Print
18.13.How to configure Page Range for PostScript or XPIF feature
18.13.1.Description
Spool2Print has been updated for Page Count, Page Range and XPIF feature since version V3.00.0008
dated April 30, 2013.

Gui Version
Warning
 After the S2P installation, the ..\MPI_Tech directory is shared with full access.
 And Ghostscript has been installed.
18.13.2.Input configuration without EXIT
Note: The PostScript files can have extension .BIN or .PS
For this example we have used .BIN
The Parameter “Format” must be set to POSTSCRIPT and the parameter “DataFilter” must be set to PS
18.13.2.1.Jobs tab result without EXIT activated
If you have submitted your PostScript file to this Hot folder without activating an exit, you will display from
S2P GUI this above example a huge page count (over than 2 billion).
Spool Print
107
18.13.3.Input configuration with and EXIT
If now you configure an exit using this configuration:
Left column (*)
C:\Program Files\gs\gs9.07\bin\gswin64c.exe
Right Column
-dNOPAUSE -sDEVICE=nullpage -sOutputFile="%HOTFOLDER%%FILENAME%.cnt"
"%HOTFOLDER%%FILENAME%" -sstdout="%HOTFOLDER%%FILENAME%.stdout" -c
"currentpagedevice /PageCount get ==" "currentpagedevice /PageSize get
==" quit -
(*) NB: The left column configuration must match the GhostScript software installation on the server (Adapt
the path to the server installation)
18.13.3.1.Jobs tab result with an EXIT activated
If you have submitted your PostScript file to this Hot folder with this exit, you should display from S2P GUI
this above example (much better). For the same job submitted, 42 pages are displayed.
108
Spool Print
18.14.How to setup Java to authorize S2P Applets in the browser

From your java installation, run Javacpl.exe.

It opens a window > Security > Edit Site list > Add the URL of the Spool2Print
(here runs on server at IP Address 192.168.31.50 port 8080)
Spool Print
109
<This page is intentionally left blank>
110
Spool Print
19. Trademarks
Adobe® is a trademark of Adobe Systems Incorporated.
Microsoft® is U.S. registered trademark of the Microsoft Corporation.
PostScript® is a trademark of Adobe Systems Incorporated.
PANTONE® Colors generated may not match PANTONE-identified standards. Consult current PANTONE
Publications for the accurate color. PANTONE® and other Pantone, Inc. trademarks are the property of
Pantone, Inc. © Pantone, Inc., 2000.
True Type™ is U.S. trademark of Apple Computers, Inc.
Netscape Navigator is a U.S. trademark of Netscape Communications.
Unix® is a registered trademark of the Open Group.
Windows®, MS Windows®, and Windows NT® are U.S. registered trademarks of Microsoft Corporation.
Global Graphics is a trademark of Global Graphics S.A. which may be registered in certain jurisdictions.
All other brand and product names are the registered trademarks or trademarks of their respective owners.
Portions of this software are copyright © 2006 The FreeType Project (www.freetype.org). All rights reserved.
*************************************************************
***
***
*** GIF Image Class Loader and Writer copyright(s) notice ***
***
***
*************************************************************
---- CxImageICO (c) 07/Aug/2001 <[email protected]> ---CxImage version 5.71 25/Apr/2003
original CImageGIF and CImageIterator implementation are:
Copyright:
(c) 1995, Alejandro Aguilar Sierra <[email protected]>
6/15/97 Randy Spann: Added GIF87a writing support
[email protected]
DECODE.C - An LZW decoder for GIF
Copyright (C) 1987, by Steven A. Bennett
Copyright (C) 1994, C++ version by Alejandro Aguilar Sierra
GIF and 'Graphics Interchange Format' are trademarks (tm) of Compuserve, Incorporated, and H&R
Block Company.
---- CxImageTIF (c) 07/Aug/2001 <[email protected]> ---CxImage version 5.71 25/Apr/2003
See the file history.htm for the complete bugfix and news report.
Parts of the code come from FreeImage 2
Design and implementation by
- Floris van den Berg ([email protected])
- Herve Drolon ([email protected])
- Markus Loibl ([email protected])
- Luca Piergentili ([email protected])
LibTIFF is:
Copyright (c) 1988-1997 Sam Leffler
Copyright (c) 1991-1997 Silicon Graphics, Inc.
Spool Print
111
Permission to use, copy, modify, distribute, and sell this software and its documentation for any
purpose is hereby granted without fee, provided that (i) the above copyright notices and this
permission notice appear in all copies of the software and related documentation, and (ii) the
names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating
to the software without the specific, prior written permission of Sam Leffler and Silicon
Graphics.
THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE,
INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT
OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
---- miGIF Compression - mouse and ivo's GIF-compatible compression ---Copyright (C) 1998 Hutchison Avenue Software Corporation
http://www.hasc.com
[email protected]
Permission to use, copy, modify, and distribute this software and its documentation for any
purpose and without fee is hereby granted, provided that the above copyright notice appear in all
copies and that both that copyright notice and this permission notice appear in supporting
documentation.
This software is provided "AS IS." The Hutchison Avenue
Software Corporation
disclaims all warranties, either express or implied, including but not limited to implied
warranties of merchantability and
fitness for a particular purpose, with respect to this code and accompanying documentation.
The miGIF compression routines do not, strictly speaking, generate files
conforming to the GIF
spec, since the image data is not LZW-compressed (this is the point: in order to avoid
transgression of the Unisys patent on the LZW algorithm.) However, miGIF generates data streams
that any reasonably sane LZW decompresser will decompress to what we want.
miGIF compression uses run length encoding. It compresses horizontal runs of pixels of the same
color. This type of compression gives good results on images with many runs, for example images
with lines, text and solid shapes on a solid-colored background. It gives little or no compression
on images with few runs, for example digital or scanned photos.
der Mouse
[email protected]
7D C8 61 52 5D E7 2D 39 4E F1 31 3E E8 B3 27 4B
[email protected]
The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated.
is a Service Mark property of CompuServe Incorporated.
GIF(sm)
---- $Id: FilterRotate.cpp,v 1.10 2000/12/18 22:42:53 uzadow Exp $ ---Copyright (c) 1996-1998 Ulrich von Zadow
********************************
***
***
*** JPEG copyright(s) notice ***
***
***
********************************
This software (The Spool2Print) is based in part on the work of the Independent JPEG Group.
***********************************
***
***
*** NETSNMP copyright(s) notice ***
***
***
112
Spool Print
***********************************
---- Part 1: CMU/UCD copyright notice: (BSD like) ----Copyright 1989, 1991, 1992 by Carnegie Mellon University
Derivative Work - 1996, 1998-2000
Copyright 1996, 1998-2000 The Regents of the University of California
All Rights Reserved
Permission to use, copy, modify and distribute this software and its documentation for any purpose
and without fee is hereby granted, provided that the above copyright notice appears in all copies
and that both that copyright notice and this permission notice appear in supporting documentation,
and that the name of CMU and The Regents of the University of California not be used in
advertising or publicity pertaining to distribution of the software without specific written
permission.
CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CMU
OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF
CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.
---- Part 2: Networks Associates Technology, Inc copyright notice (BSD) ----Copyright (c) 2001-2003, Networks Associates Technology, Inc
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted
provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions
and the following disclaimer.
*
Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials provided with
the distribution.
* Neither the name of the Networks Associates Technology, Inc nor the names of its contributors
may be used to endorse or promote products derived from this software without specific prior
written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
---- Part 3: Cambridge Broadband Ltd. copyright notice (BSD) ----Portions of this code are copyright (c) 2001-2003, Cambridge Broadband Ltd. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted
provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions
and the following disclaimer.
Spool Print
113
*
Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials provided with
the distribution.
*
The name of Cambridge Broadband Ltd. may not be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
---- Part 4: Sun Microsystems, Inc. copyright notice (BSD) ----Copyright © 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
California 95054, U.S.A. All rights reserved.
Use is subject to license terms below.
This distribution may include materials developed by third parties.
Sun, Sun Microsystems, the Sun logo and Solaris are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.
Redistribution and use in source and binary forms, with or without modification, are permitted
provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions
and the following disclaimer.
*
Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials provided with
the distribution.
* Neither the name of the Sun Microsystems, Inc. nor the names of its contributors may be used to
endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
---- Part 5: Sparta, Inc copyright notice (BSD) ----Copyright (c) 2003-2004, Sparta, Inc
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted
provided that the following conditions are met:
*
114
Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
Spool Print
*
Redistributions in binary form must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other materials provided with
the distribution.
*
Neither the name of Sparta, Inc nor the names of its contributors may be used to endorse or
promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
********************************
***
***
*** TIFF copyright(s) notice ***
***
***
********************************
Copyright (c) 1988-1997 Sam Leffler
Copyright (c) 1991-1997 Silicon Graphics, Inc.
Permission to use, copy, modify, distribute, and sell this software and its documentation for any
purpose is hereby granted without fee, provided that (i) the above copyright notices and this
permission notice appear in all copies of the software and related documentation, and (ii) the
names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating
to the software without the specific, prior written permission of Sam Leffler and Silicon
Graphics.
THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE,
INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT
OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
**********************************
***
***
*** JASPER copyright(s) notice ***
***
***
**********************************
Copyright (c) 1999-2000 Image Power, Inc. and the University of
British Columbia.
Copyright (c) 2001-2002 Michael David Adams.
All rights reserved.
JasPer Software License
IMAGE POWER JPEG-2000 PUBLIC LICENSE
************************************
GRANT:
Permission is hereby granted, free of charge, to any person (the "User") obtaining a copy of this
software and associated documentation, to deal in the JasPer Software without restriction,
Spool Print
115
including without limitation the right to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the JasPer Software (in source and binary forms), and to permit
persons to whom the JasPer Software is furnished to do so, provided further that the License
Conditions below are met.
License Conditions
******************
A.
Redistributions of source code must retain the above copyright notice, and this list of
conditions, and the following disclaimer.
B.
Redistributions in binary form must reproduce the above copyright notice, and this list of
conditions, and the following disclaimer in the documentation and/or other materials provided with
the distribution.
C. Neither the name of Image Power, Inc. nor any other contributor (including, but not limited
to, the University of British Columbia and Michael David Adams) may be used to endorse or promote
products derived from this software without specific prior written permission.
D. User agrees that it shall not commence any action against Image Power, Inc., the University of
British Columbia, Michael David Adams, or any other contributors (collectively "Licensors") for
infringement of any intellectual property rights ("IPR") held by the User in respect of any
technology that User owns or has a right to license or sublicense and which is an element required
in order to claim compliance with ISO/IEC 15444-1 (i.e., JPEG-2000 Part 1).
"IPR" means all
intellectual property rights worldwide arising under statutory or common law, and whether or not
perfected, including, without limitation, all (i) patents and patent applications owned or
licensable by User; (ii) rights associated with works of authorship including copyrights,
copyright applications, copyright registrations, mask work rights, mask work applications, mask
work registrations; (iii) rights relating to the protection of trade secrets and confidential
information; (iv) any right analogous to those set forth in subsections (i), (ii), or (iii) and
any other proprietary rights relating to intangible property (other than trademark, trade dress,
or service mark rights); and (v) divisions, continuations, renewals, reissues and extensions of
the foregoing (as and to the extent applicable) now existing, hereafter filed, issued or acquired.
E. If User commences an infringement action against any Licensor(s) then such Licensor(s) shall
have the right to terminate User's license and all sublicenses that have been granted hereunder by
User to other parties.
F. This software is for use only in hardware or software products that are compliant with ISO/IEC
15444-1 (i.e., JPEG-2000 Part 1). No license or right to this Software is granted for products
that do not comply with ISO/IEC 15444-1. The JPEG-2000 Part 1 standard can be purchased from the
ISO.
THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE.
NO USE OF THE JASPER SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER. THE JASPER
SOFTWARE IS PROVIDED BY THE LICENSORS AND CONTRIBUTORS UNDER THIS LICENSE ON AN ``AS-IS'' BASIS,
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
WARRANTIES THAT THE JASPER SOFTWARE IS FREE OF DEFECTS, IS MERCHANTABLE, IS FIT FOR A PARTICULAR
PURPOSE OR IS NON-INFRINGING. THOSE INTENDING TO USE THE JASPER SOFTWARE OR MODIFICATIONS THEREOF
FOR USE IN HARDWARE OR SOFTWARE PRODUCTS ARE ADVISED THAT THEIR USE MAY INFRINGE EXISTING PATENTS,
COPYRIGHTS, TRADEMARKS, OR OTHER INTELLECTUAL PROPERTY RIGHTS.
THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE JASPER SOFTWARE IS WITH THE USER. SHOULD
ANY PART OF THE JASPER SOFTWARE PROVE DEFECTIVE IN ANY RESPECT, THE USER (AND NOT THE INITIAL
DEVELOPERS, THE UNIVERSITY OF BRITISH COLUMBIA, IMAGE POWER, INC., MICHAEL DAVID ADAMS, OR ANY
OTHER CONTRIBUTOR) SHALL ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. UNDER
NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING NEGLIGENCE), CONTRACT, OR
OTHERWISE, SHALL THE INITIAL DEVELOPER, THE UNIVERSITY OF BRITISH COLUMBIA, IMAGE POWER, INC.,
MICHAEL DAVID ADAMS, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE JASPER SOFTWARE, OR ANY
SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO THE USER OR ANY OTHER PERSON FOR ANY INDIRECT,
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION,
DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER
COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY HAD BEEN INFORMED, OR OUGHT TO HAVE KNOWN, OF THE
POSSIBILITY OF SUCH DAMAGES. THE JASPER SOFTWARE AND UNDERLYING TECHNOLOGY ARE NOT FAULT-TOLERANT
116
Spool Print
AND ARE NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE OR RESALE AS ON-LINE CONTROL EQUIPMENT IN
HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR
FACILITIES, AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE SUPPORT
MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE JASPER SOFTWARE OR UNDERLYING TECHNOLOGY
OR PRODUCT COULD LEAD DIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL
DAMAGE ("HIGH RISK ACTIVITIES"). LICENSOR SPECIFICALLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY
OF FITNESS FOR HIGH RISK ACTIVITIES. USER WILL NOT KNOWINGLY USE, DISTRIBUTE OR RESELL THE JASPER
SOFTWARE OR UNDERLYING TECHNOLOGY OR PRODUCTS FOR HIGH RISK ACTIVITIES AND WILL ENSURE THAT ITS
CUSTOMERS AND END-USERS OF ITS PRODUCTS ARE PROVIDED WITH A COPY OF THE NOTICE SPECIFIED IN THIS
SECTION.
Spool Print
117
<This page is intentionally left blank>
118
Spool Print
20. CUSTOMER SUPPORT AND WARRANTY INFORMATION
20.1. Customer Support
MPI has support services available from France, Denmark, United Kingdom, Germany, and USA (California
and Virginia) to help you in case of difficulties with this product.
20.2. Authorized Dealers
If you determine that the Blue Server requires support, call your local authorized MPI dealer or call MPI:

+ 33 (0) 1 45 73 09 40
in France,

+ 45 4436 6000
in Denmark,

+ 44 (0) 1344 891 008
in UK,

+ 49 (0) 89 35 4762 30
in Germany,

+ 1 (714) 840 80 77
in California (West coast – USA),

+ 1 (703) 243 3322
During normal business hours.
in Virginia (East coast – USA).
20.3. User Warranty
This product is warranted against malfunction for a period of 3 months from the date of installation by the
End User. During this warranty period, MPI will provide bug fixes at no charge provided the host and the
network environment have not been modified.
This warranty does not apply if this product has been damaged by accident or misuse, or as the result of
service and modification by other than an authorized dealer or MPI Support Service Facility. No other
express warranty is given by MPI. In particular MPI shall not be liable for consequential damages or indirect
losses.
20.4. Maintenance
In order to guaranty a proper operation of your Spool2Print Software over the years, and specifically in case
of Host and Network environment evolutions or modifications, please subscribe the MPI maintenance
agreement through your local authorized MPI dealer or directly with MPI
20.5. End User License Agreement for MPI Tech Software
Important: Please read this License carefully before using this Software.
This End User License Agreement ("EULA") is a legal and binding agreement between The End User (either an
individual or a single entity) and MPI Tech Group, its subsidiaries, affiliates, agents and OEM licensees (
collectively, "MPI Tech") for the Software The End User are about to download (or otherwise install, access or use)
and the associated proprietary media, printed materials, any associated documentation (including any electronic
documentation) provided to The End User by MPI Tech (collectively "Software"), however said Software is named or
branded. Any software updates, add-on components, web services, enhancements or supplements that MPI Tech,
its licensees or agents may provide to The End User or make available to The End User, by key permission access
or otherwise, after the date The End User obtain The End User initial copy of the Software, shall be deemed to be
"Software" within the scope of this EULA, from and after the date permission is granted to The End User, to the
extent that such items are not accompanied by a separate license agreement or terms of use. By installing, copying,
downloading, accessing or otherwise using the Software, The End User manifest The End User consent to and
agreement to be bound by the terms of this EULA. If The End User do not agree to the terms of this EULA, do not
install, access or use the Software, but immediately cease the download / return the unused Software to the place
of the original purchase.
Spool Print
119
SOFTWARE LICENSE
The Software is protected by intellectual property laws and treaties. Any references hereunder to "sales" or
"acquisition" or like terms notwithstanding, the Software is licensed, not sold, and rights granted hereunder are
limited to the Software in object code only. No source code rights are granted hereby. The End User may not
assign or otherwise transfer this EULA to any other party, without specific written permission from MPI Tech.
1
GRANT OF LICENSE. Under copyright law the End User are not permitted to install or run the Software
product ('the Software') or use the electronic material ('the Documentation') supplied to the End User without the
permission of the Owner. In consideration of the End User accepting the terms of this agreement the Owner grants
the End User a non-exclusive right ('the License') to install and run the Software and use the Documentation as
permitted by this Agreement. All references to the Software mean the object code only of the program(s)
comprising the Software. The End User has no rights to distribute, copy, reverse-engineer, modify or adapt the
Software unless such rights are clearly and specifically granted herein.
1.1
General License to Install and Use Software Product.
1.1.1 The End User may use the Software and the Documentation in connection with a single computer or such
other number of computers as may be specifically licensed and for which license fees have been paid, as reflected
on license records generated in connection with the acquisition of the Software ("License Record");
1.1.2 The End User may load the Software and use it only on a single computer which is under the control or
such other number of computers as may be specifically licensed and also under the End User control.
1.1.3 The End User may use the Software for its personal use or in its business or profession. The license
granted hereunder may not be shared and permitting unauthorised access to, copying or use of the Software and
the Documentation is beyond the scope of the license and is therefore a breach of this Agreement.
1.2
Additional License Permitting Use of Software under a Subscription or Service Agreement. If The End User
licensed the Software under a subscription ("Subscription Product"), the following additional licensing terms apply
and supersede any inconsistent provision under section 1.1: During the term of The End User subscription only,
The End User may install the Software on a single computer which is under its control or such other number of
computers as may be specifically licensed and also under its control. The initial subscription period begins on the
date The End User first activate its copy of the Subscription Product and ends at the end of the subscription period,
as set forth under the License Record. The End User cannot use the Subscription Product on any computer after
its subscription expires unless The End User renew or extend its subscription. By renewing or extending its
subscription, The End User will be entitled to continue using the Subscription Product for a specified period of time
beyond the date when its previous subscription would have otherwise ended. All the terms and conditions of this
EULA will continue to apply to its use of the Subscription Product during any subsequent renewal periods unless
otherwise specified. Separation of Component Parts: The Software Product is licensed as a single product and its
component parts may not be separated, except as may be provided in the Documentation, unless expressly
authorized by MPI Tech in writing.
1.3
Updates, Enhancements and Supplemental Software. No Software maintenance or support is included in
the calculation of license fees paid in consideration for this EULA. Any rights The End User may be granted for
Software maintenance or support, including updates, patches, enhancements, modifications or other support
services related to the Software ("Support Services") are beyond the scope of this EULA and will be the subject of
and governed by a separate maintenance or support agreement (if any) between The End User and MPI Tech or
licensed MPI Tech 'resellers, distributors or OEM providers' (Resellers), and may be subject to the payment of
additional fees. Support Services provided by MPI Tech or its Resellers are governed by the policies and programs
adopted from time to time by MPI Tech or by those Resellers offering such services, as described in the
Documentation, or in other materials furnished by MPI Tech or its Resellers.
1.4
Reservation of Rights. All rights not expressly granted are retained by MPI Tech.
2.
ADDITIONAL RIGHTS, TERMS AND LIMITATIONS
2.1
License Fees. All license fees (and, if applicable, subscription or service fees) The End User have paid are
non-refundable, except in connection with a return of the Software as provided in the initial paragraph of this EULA
or under section 6.1.
2.2
Intellectual Property Rights. All title and intellectual property rights in and to the Software and all elements
and components, the accompanying printed materials, and any copies of the Software are owned by MPI Tech or its
suppliers/licensors. If this Software contains documentation that is provided only in electronic form, the End User
may print ten copies of such electronic documentation. The End User may not copy the printed materials
accompanying the Software. MPI Tech retains all rights in and to any copy, translation, modification, enhancement,
improvement, development, adaptation or derivative works of the Software, including all unauthorized work.
120
Spool Print
2.3
Copy Protection. The Software may incorporate copy protection technology to prevent the unauthorized
copying of the Software or may require original media for use of the Software on the Device. It is unlawful and
prohibited to make unauthorized copies of the Software or to circumvent any copy protection technology included in
the Software.
2.4
Rental, leasing or commercial hosting. The End User may not rent, lease, lend or provide commercial
hosting services to third parties with the Software, without MPI Tech's express written authorization.
2.5
Compliance. The End User agree to supervise and control use of the Software to ensure compliance with
all terms and limitations under this EULA (including but not limited to compliance with the laws and regulations of all
applicable jurisdictions in which The End User use the Software) and to maintain accurate records of the number
and location of all users and copies of the Software and the number of storage devices used in connection with the
Software (Compliance Data"). In this connection, The End User also agrees to the following:
2.5.1 The End User agree to provide to MPI Tech with summaries of updated Compliance Data, in a form
reasonably required by MPI Tech, within thirty (30) days of any written request, and to furnish therewith written
certification that its use of the Software at the time of the request complies with this EULA. As an alternative to
such written reports or certification, and at MPI Tech's sole option, The End User agree to enable and to allow MPI
Tech to collect, via a Web interface, ONLY the record of the number of installed clients; and
2.5.2 The End User agree to allow MPI Tech or its agents full access, on 14 days' notice and during normal
business hours, to all of the devices on which the Software is loaded or from which it may be accessed "Devices"),
and to the site or sites on which Devices are located, to monitor its compliance with this section 2.5 and the other
terms of this EULA.; and
2.5.3 The End User agree to make all relevant employees, agents, advisers, consultants, group-companies,
affiliates, sub-contractors and other parties who have use of or access to the Software aware of the provisions of
this Agreement prior to such use or access, and shall ensure compliance by such users with this EULA.
2.6
The End User acknowledge that in the event that the End User have been granted a license pursuant to this
agreement for a Subscription Product we may without notice enable the Subscription Product so that it shall cease
to operate at the end of the license term in any event.
3.
TERM AND TERMINATION
3.1
This EULA shall terminate automatically on the date (if any) specified on the License Record, unless
extended by the prior mutual consent of the parties in writing. If no date is specified on the License Record, this
EULA shall be perpetual subject to termination in accordance with subsections 3.2 below. The End User may
terminate this EULA at any time by destroying the Software and the Documentation together with all copies in any
form. However, no license fee paid or owing for the Software shall be refunded or abated by virtue of such
unilateral termination.
3.2
Furthermore, the License to use the Software will terminate automatically if The End User fails to comply
with any term of this EULA. Unless applicable license fees are paid in full, this EULA and all licenses granted
hereunder will also terminate without further action and may also terminate on notice by MPI Tech if The End User
become unable to pay its debts or are otherwise insolvent, bankrupt, appoint an Administrator, cease trading,
become the subject of any liquidation or winding up action in any jurisdiction, enter into any arrangement with its
creditors other than for the purpose of a solvent reorganization or become the subject of any action under which a
receiver or administrator is appointed by a court, regulatory agency or other authority or in the event that any local
equivalent of the aforesaid arise in any jurisdiction. Upon expiration or termination of the EULA for any reason The
End User will immediately destroy the Software together with all copies in any form, including copies on its hard and
back-up disks. Any use of any copies of the Software after expiration or termination of the License is unlawful.
3.3
Termination of this EULA shall be without prejudice to the accrued rights and liabilities of either party.
4.
INDEMNITY. The End User agree to defend, indemnify and hold harmless MPI Tech, its subsidiaries,
affiliates, distributors, licensors, suppliers, officers, directors, employees and agents from any third party claims,
damages, liabilities, costs and fees (including reasonable attorney fees) arising from its use of the Software as well
as from its failure to comply with any term of this EULA. The End User agrees that MPI Tech shall have no liability
whatsoever for any use The End User make of the Software.
Spool Print
121
5.
US GOVERNMENT RESTRICTED RIGHTS. This Software is commercial computer software and the
related documentation is commercial computer software documentation. Thus, if The End User are an agency,
department, or other entity of the United States Government ("Government"), the use, duplication, reproduction,
release, modification, disclosure or transfer of the Software, or any related documentation of any kind, including
technical data or related manuals, is restricted in accordance with Federal Acquisition Regulation 12.212 for civilian
agencies and Defence Federal Acquisition Regulation Supplement 227.7202 for military agencies to the extent said
regulations apply to solicitations within the scope of said regulations. The use of the Software and related
documentation is further restricted in accordance with the terms of this Agreement, or any modification hereto.
MPI Technologies Inc., a US subsidiary of MPI Tech Group, is located at
MPI Tech, 4952 Warner Avenue, Suite 301, Huntington Beach, CA 92649-5506, USA.
6.
LIMITED WARRANTY
6.1
LIMITED WARRANTY FOR SOFTWARE ACQUIRED IN THE US, EU AND CANADA: MPI Tech warrants
that the Software, when used properly, will perform substantially as described in the accompanying materials and
documentation for a period of thirty (30) days from the date of receipt and that the media on which the Software is
recorded will be free from defects in material and workmanship under normal use for the same period.
If an implied warranty or condition is created by the End User state/jurisdiction and federal/national or
state/provincial law prohibits disclaimers of it, the End User may also have an implied warranty or condition, BUT
ONLY AS TO DEFECTS DISCOVERED DURING THE PERIOD OF THIS LIMITED WARRANTY (THIRTY DAYS).
AS TO ANY DEFECTS DISCOVERED AFTER THE THIRTY (30) DAY PERIOD, THERE IS NO WARRANTY OR
CONDITION OF ANY KIND. Some states/jurisdictions do not allow limitations on how long an implied warranty or
condition lasts, so the above limitation may not apply to The End User.
Any supplements or updates to the SOFTWARE PRODUCT, including without limitation, any (if any) service packs
or hot fixes provided to the End User after the expiration of the initial thirty (30) days Limited Warranty period are not
covered by any warranty or condition, express, implied or statutory.
6.1.1 LIMITATION ON REMEDIES; NO CONSEQUENTIAL OR OTHER DAMAGES. The End User exclusive
remedy for any breach of this Limited Warranty is as set forth below. Except for any refund elected by MPI Tech,
THE END USER ARE NOT ENTITLED TO ANY DAMAGES, INCLUDING BUT NOT LIMITED TO
CONSEQUENTIAL DAMAGES. The terms of Section 8 below ("Exclusion of Incidental, Consequential and Certain
Other Damages") are also incorporated into this Limited Warranty. Some states/jurisdictions do not allow the
exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to
the End User. This Limited Warranty gives the End User specific legal rights. The End User may have others
which vary from state/jurisdiction to state/jurisdiction.
6.1.2 THE END USER EXCLUSIVE REMEDY. The entire liability of MPI Tech and its suppliers and the End
User exclusive remedy relative to any Software, that does not meet this Limited Warranty and that is returned to the
original place of purchase with a copy of the End User proof of purchase, shall be, at MPI Tech's sole option
exercised subject to applicable law, either (a) return of the price paid (if any) for the Software, or (b) repair or
replacement of the Software. The End User will receive the remedy elected by MPI Tech without charge, except
that the End User are responsible for any expenses the End User may incur (e.g. cost of returning the Software to
MPI Tech). This Limited Warranty is void if failure of the Software has resulted from accident, abuse,
misapplication, abnormal use or a virus. Any replacement Software will be warranted for the remainder of the
original warranty period or twenty (20) days, whichever is longer. To exercise the End User remedy, contact MPI
Tech in writing at one of the following addresses:
MPI Tech A/S, Vadstrupvej 35, 2880, Bagsvaerd, Denmark.
MPI Tech SAS, 40, Rue du Général Malleret-Joinville, BP 88, 94402 Vitry Sur Seine Cedex, France
6.2
LIMITED WARRANTY FOR SOFTWARE PRODUCTS ACQUIRED OUTSIDE THE EU, US AND CANADA.
FOR THE LIMITED WARRANTIES AND SPECIAL PROVISIONS PERTAINING TO THE END USER
PARTICULAR JURISDICTION, PLEASE REFER TO THE WARRANTY PROVIDED TO THE END USER WITH
THE SOFTWARE DOCUMENTATION. IF NO SPECIAL AND SEPARATE WARRANTY IS APPLICABLE, THE
WARRANTIES OF MPI Tech AND ITS SUPPLIERS SHALL BE LIMITED AS PROVIDED HEREIN TO THE
FULLEST EXTENT ALLOWED UNDER THE LAWS OF THE APPLICABLE JURISDICTION. MPI TECH HEREBY
EXCLUDES ALL IMPLIED WARRANTIES TO THE FULLEST EXTENT ALLOWED BY LAW IN EACH
JURISDICTION IN WHICH THE SOFTWARE IS USED UNDER THIS EULA.
122
Spool Print
7.
GENERAL DISCLAIMER OF WARRANTIES. THE LIMITED WARRANTY THAT APPEARS IN SECTION
6 ABOVE IS THE ONLY EXPRESS WARRANTY MADE TO THE END USER AND IS PROVIDED IN LIEU OF ANY
OTHER EXPRESS WARRANTIES (IF ANY) CREATED BY ANY DOCUMENTATION OR PACKAGING. EXCEPT
FOR THE LIMITED WARRANTY AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MPI
Tech AND ITS SUPPLIERS PROVIDE THE SOFTWARE AND SUPPORT SERVICES (IF ANY) AS IS AND WITH
ALL FAULTS, AND HEREBY DISCLAIM ALL OTHER WARRANTIES AND CONDITIONS, EITHER EXPRESS,
IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY (IF ANY) IMPLIED WARRANTIES,
DUTIES OR CONDITIONS OF MERCHANTABILITY, OF FITNESS FOR A PARTICULAR PURPOSE, OF
ACCURACY OR COMPLETENESS OR RESPONSES, OF RESULTS, OF WORKMANLIKE EFFORT, OF LACK
OF VIRUSES AND OF LACK OF NEGLIGENCE, ALL WITH REGARD TO THE SOFTWARE, AND THE
PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES. ALSO, THERE IS NO WARRANTY OR
CONDITION OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION, CORRESPONDENCE TO DESCRIPTION
OR NON-INFRINGEMENT WITH REGARD TO THE SOFTWARE.
8.
EXCLUSION OF INCIDENTAL, CONSEQUENTIAL AND CERTAIN OTHER DAMAGES. TO THE
MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL MPI Tech OR ITS SUPPLIERS
BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER.
MPI Tech SHALL NOT BE LIABLE FOR THE FOLLOWING TYPES OF LOSS IN ANY EVENT, BE THEY DIRECT
OR CONSEQUENTIAL DAMAGES FOR LOSS OF PROFITS OR CONFIDENTIAL OR OTHER INFORMATION,
FOR BUSINESS INTERRUPTION, FOR PERSONAL INJURY, FOR LOSS OF PRIVACY, FOR FAILURE TO
MEET ANY DUTY INCLUDING OF GOOD FAITH OR OF REASONABLE CARE, FOR NEGLIGENCE, AND FOR
ANY OTHER PECUNIARY OR OTHER LOSS WHATSOEVER AND ANY OTHER LOSS ARISING OUT OF OR IN
ANY WAY RELATED TO THE USE OF OR INABILITY TO USE THE SOFTWARE PRODUCT, THE PROVISION
OF OR FAILURE TO PROVIDE SUPPORT SERVICES, OR OTHERWISE UNDER OR IN CONNECTION WITH
ANY PROVISION OF THIS EULA, EVEN IN THE EVENT OF THE FAULT, TORT (INCLUDING NEGLIGENCE),
STRICT LIABILITY, BREACH OF CONTRACT OR BREACH OF WARRANTY OF MPI Tech OR ANY SUPPLIER,
AND EVEN IF MPI Tech OR ANY SUPPLIER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
9.
LIMITATION OF LIABILITY AND REMEDIES. NOTWITHSTANDING ANY DAMAGES THAT THE END
USER MIGHT INCUR FOR ANY REASON WHATSOEVER (INCLUDING, WITHOUT LIMITATION, ALL
DAMAGES REFERENCED ABOVE AND ALL DIRECT OR GENERAL DAMAGES), THE ENTIRE LIABILITY OF
MPI TECH AND ANY OF ITS SUPPLIERS UNDER ANY PROVISION OF THIS EULA AND THE END USER
EXCLUSIVE REMEDY FOR ALL OF THE FOREGOING (EXCEPT FOR ANY REMEDY OF REPAIR OR
REPLACEMENT ELECTED BY MPI TECH WITH RESPECT TO ANY BREACH OF THE LIMITED WARRANTY)
SHALL BE LIMITED TO THE GREATER OF 110% OF THE AMOUNT ACTUALLY PAID BY THE END USER FOR
THE SOFTWARE OR U.S. $250.00. THE FOREGOING LIMITATIONS, EXCLUSIONS AND DISCLAIMERS
(INCLUDING SECTIONS 6, 7, AND 8, ABOVE) SHALL APPLY TO THE MAXIMUM EXTENT PERMITTED BY
APPLICABLE LAW, EVEN IF ANY REMEDY FAILS ITS ESSENTIAL PURPOSE.
10.
APPLICABLE LAW. If the End User acquired this Software in the United States, Canada, or any country of
South America, and unless expressly prohibited by local law, this EULA shall be governed and construed under
California (USA) law (without regard to its conflicts of laws provisions) as such law applies to agreements between
Californian residents entered into and to be performed within California. The sole and exclusive jurisdiction and
venue for actions arising under this Agreement shall be the State and Federal courts in California.
If the End User acquired this Software in any other country, and unless expressly prohibited by local law, this EULA
shall be governed by the laws of Switzerland (Code Suisse des Obligations) by the Court in Geneva.
The End User consent and submit to the jurisdiction of the applicable courts, as provided above, and agree to
service of process in accordance with the applicable court rules. The party prevailing in any dispute under this
Agreement shall be entitled to its costs and legal fees.
11.
GENERAL PROVISIONS. This Agreement and the terms of any License Record provided to the End User
(if any) combine to represent the complete agreement concerning this license between the parties and supersedes
all prior agreements and representations between them. This EULA may be amended only in writing executed by
both parties. If any provision of this EULA is held to be illegal or unenforceable, that provision shall be limited or
eliminated to the minimum extent necessary to make it legal and enforceable and this Agreement shall otherwise
remain in full force and effect and enforceable. The failure of MPI Tech to act with respect to a breach of this EULA
by The End User or others does not constitute a waiver and shall not limit MPI Tech's rights with respect to such
breach or any subsequent breaches. This EULA is personal to the End User and may not be assigned or
transferred for any reason whatsoever without MPI Tech's prior written consent and any action or conduct in
violation of the foregoing shall be void and without effect. MPI Tech expressly reserves the right to assign this
Agreement
and
to
delegate
any
of
its
obligations
hereunder.
EACH PARTY RECOGNIZES AND AGREES THAT THE WARRANTY DISCLAIMERS AND LIABILITY AND
REMEDY LIMITATIONS IN THIS AGREEMENT ARE MATERIAL BARGAINED FOR BASES OF THIS
AGREEMENT AND THAT THEY HAVE BEEN TAKEN INTO ACCOUNT AND REFLECTED IN DETERMINING
Spool Print
123
THE CONSIDERATION TO BE GIVEN BY EACH PARTY UNDER THIS AGREEMENT AND IN THE DECISION BY
EACH PARTY TO ENTER INTO THIS AGREEMENT.
Questions concerning this Agreement should be sent to the either of the addresses set forth below. Any notices or
correspondences will only be effective if sent to such address:
MPI Tech A/S, Vadstrupvej 35, 2880, Bagsvaerd, Denmark.
MPI Tech SAS, 40, Rue du Général Malleret-Joinville, BP 88, 94402 Vitry Sur Seine Cedex, France
124
Spool Print
Spool Print
125