PrintMate Op Guide

ECRM PrintMate
(Print Production Manager)
User Manual
AG50563 Revision 3
PRINTMATE / PRINT PRODUCTION MANAGER 1.2
INDEX CONTENTS 2
COPYRIGHT AND TRADEMARKS

Harlequin RIP Print Production Manager 1.2r0 User Guide
November 2006
Document issue: 123
Copyright 2006 Global Graphics Software Ltd. All rights reserved.
Certificate of Computer Registration of Computer Software. Registration No. 2006SR05517
No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic,
mechanical, photocopying, recording, or otherwise, without the prior written permission of Global Graphics Software Ltd.
The information in this publication is provided for information only and is subject to change without notice. Global Graphics Software
Ltd and its affiliates assume no responsibility or liability for any loss or damage that may arise from the use of any information in this
publication. The software described in this book is furnished under license and may only be used or copied in accordance with the terms
of that license.
Harlequin is a registered trademark of Global Graphics Software Ltd.
The Global Graphics Software logo, the Harlequin at Heart Logo, Cortex, Harlequin RIP, Harlequin ColorPro, EasyTrap, FireWorks,
FlatOut, Harlequin Color Management System (HCMS), Harlequin Color Production Solutions (HCPS), Harlequin Color Proofing
(HCP), Harlequin Error Diffusion Screening Plugin 1-bit (HEDS1), Harlequin Error Diffusion Screening Plugin 2-bit (HEDS2),
Harlequin Full Color System (HFCS), Harlequin ICC Profile Processor (HIPP), Harlequin Standard Color System (HSCS), Harlequin
Chain Screening (HCS), Harlequin Display List Technology (HDLT), Harlequin Dispersed Screening (HDS), Harlequin Micro
Screening (HMS), Harlequin Precision Screening (HPS), HQcrypt, Harlequin Screening Library (HSL), ProofReady, Scalable Open
Architecture (SOAR), SetGold, SetGoldPro, TrapMaster, TrapWorks, TrapPro, TrapProLite, Harlequin RIP Eclipse Release and
Harlequin RIP Genesis Release are all trademarks of Global Graphics Software Ltd.
Protected by U.S. Patents 5,579,457; 5,808,622; 5,784,049; 5,862,253; 6,343,145; 6,330,072; 6,483,524; 6,380,951; 6,755,498;
6,624,908; 6,809,839.
Other U.S. Patents Pending
Protected by European Patents 0 803 160; 0 772 934; 0 896 771; 672 29 760.8-08.
Portions licensed under U.S. Patent No. 5,212,546; 4,941,038.
TrueType is a registered trademark of Apple Computer, Inc.
The ECI and FOGRA ICC color profiles supplied with this Harlequin RIP are distributed with the kind permission of the ECI
(European Color Initiative) and FOGRA respectively, and of Heidelberger Druckmaschinen AG (HEIDELBERG).
The IFRA ICC profiles supplied with this Global Graphics Software are distributed with the kind permission of IFRA and of
GretagMacbeth.
International Cooperation for Integration of Processes in Prepress, Press and Postpress, CIP4, Job Definition Format, JDF and the CIP4
logo are trademarks of CIP4.
Adobe, Adobe Photoshop, Adobe Type Manager, Acrobat, Display PostScript, Adobe Illustrator, PostScript, Distiller and PostScript 3
are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries which may be
registered in certain jurisdictions.

Global Graphics Software Ltd is a licensee of Pantone, Inc. PANTONE Colors generated by ScriptWorks are four-color process
simulations and may not match PANTONE-identified solid color standards. Consult current PANTONE Color Publications for accurate
color. PANTONE, Hexachrome, and PANTONE CALIBRATED are trademarks of Pantone, Inc. Pantone, Inc., 1991.
Other brand or product names are the registered trademarks or trademarks of their respective holders.
AG50563 REV. 3 INDEX CONTENTS 2

Contents
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.1 What is PrintMate? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2 Supported file types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Restrictions on TIFF/IT-P1 files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.3 Running PrintMate on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.4 Running PrintMate on Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.5 PrintMate user accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2 Installing and Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.1 Before you install PrintMate Pre-installation checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
RIP pre-installation checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Web browser pre-installation checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Firewall pre-installation checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2 Installing PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3 Adding the PrintMate permit file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.4 Installing the PrintMate printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing the printer on a Mac OS X server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing the printer on a Windows server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.5 Starting PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Starting PrintMate in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Starting PrintMate in Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.6 Connecting to the PrintMate web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.7 Setting PrintMate back to default settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.8 Closing PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.9 Making a backup copy of your PrintMate data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.10 Recovering from an invalid application shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.11 Uninstalling PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 3 A Brief Tour of the

PrintMate Web GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.1 The Monitor window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
The Input queue list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
The RIP toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
The Output queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

INDEX CONTENTS 4
The Print toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

The Complete list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.2 The Job Info window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.3 The Roam window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.4 The Channels window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.5 The RIPchannel window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.6 The Config window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
PrintMate settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.7 The Debug window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 4 Using PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

4.1 Setting up channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Adding channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Editing channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Deleting channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Starting and stopping channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.2 Creating and publishing virtual printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Installing PrintMate virtual printer on Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Installing PrintMate virtual printer on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.3 Creating hot folders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.4 Processing jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Submitting jobs for processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Reoutputting jobs (including parts of a job). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Skipping output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Reprocessing jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Previewing jobs (Roaming) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Searching for jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Holding or unholding jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Deleting jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Keeping jobs from being deleted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Viewing job history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Chapter 5 Troubleshooting PrintMate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

5.1 PrintMate cannot be started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
5.2 PrintMate takes a long time to start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.3 Unable to connect to the PrintMate web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.4 PrintMate closes without warning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
How to increase Java memory in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
How to increase Java memory in Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.5 Roam is very slow when previewing jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.6 Some characters or graphics do not display correctly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

INDEX CONTENTS 5
Appendix A Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

A.1 Location of configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
A.2 swwebgui.txt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
A.3 Persistence.txt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 1 Introduction
This chapter includes sections on the following topics:

What is PrintMate?, page 6.
Supported file types, page 7.
Running PrintMate on Windows, page 9.
Running PrintMate on Mac OS X, page 10.
PrintMate user accounts., page 11.
1.1 What is PrintMate?

PrintMate is ECRMs implementation of Global Graphics Print Production Manager (PPM). It is a server-
based, simplified process control and job management application for RIPMate, ECRMs implementation of
Global Graphics Harlequin RIP.
PrintMate makes heavy use of the Global Graphics Print Production Manager (PPM) application. For this
reason, some screens and displays in PrintMate make reference to Print Production Manager or PPM
rather than to PrintMate. Whenever you see a Print Production Manager or a PPM reference on the
screen or in this manual, understand that it is really PrintMate that is being refenced.
PrintMate allows multiple clients to connect to a web-based graphical user interface (web GUI) for monitor-
ing and managing job processing through each stage of the print production workflow.
INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 6

INTRODUCTION INDEX CONTENTS 7
Job view Job info Job logs
History
Search Roam
Figure 1.1 Job control and process monitoring with PrintMate
PrintMate features include:

An easy-to-use, browser-based GUI that allows you to track and administer the RIP print pro-
duction workflow.
Support for concurrent access from multiple local and remote web-based clients. The precise
number of clients is strictly controlled by the Printmate/PPM permit file, installed in the Harle-
quin License Server (HLS).
Enhanced remote inspection and previewing (Roaming) of RIPped jobs.
Password protected user accounts and permissions. Setting up user accounts is described in the
PPM Customization Guide, available on the PPM CD-ROM at
CD-Drive:\Documentation\PrintProductionManager\<version>\<revision>\all-
all\pdf\PrintProdMgr_customize.pdf.
A GUI that can be easily changed to suit your own product styling requirements. See the PPM
Customization Guide for details on how to customize the application interface.
1.2 Supported file types

PrintMate can accept and process jobs in any of these file formats: PostScript-language, Encapsulated
PostScript (EPS) files, Portable Document Format (PDF) files, TIFF/IT-P1 files, (see restrictions below)
TIFF 6.0 baseline files, and JPEG and JFIF files. Processing of these files, however, is governed by the RIP,
with the exact options depending on your configuration and particular RIP version. Refer the your RIP User
Guide for details of files which are supported.

1.2.1 Restrictions on TIFF/IT-P1 files

Support of TIFF/IT-P1 is not fully compliant with the TIFF/IT specification, and the following restrictions
should be noted when submitting TIFF/IT-P1 files for processing:
PrintMate does not read the FP (final page) file, but instead assumes that any files with the same
base name as the FP file and a TIFF/IT extension (LW, CT, HC...) are part of the same TIFF/IT job.
The TIFF/IT specification does allow different base file names, but in practice they is rarely seen. It
is therefore not possible to use this feature to process a TIFF/IT job where some of the files referred-
to by the FP file do not have the same base name as the FP file.
PPM checks the stability of the component (CT, LW, HC...) files and the FP file. Therefore, PPM
will not submit any TIFF/IT jobs for processing which have slave files that are still being updated.
However, since PPM does not read the FP file, PPM is unable to detect slave files that are entirely
missing, when the FP file looks stable. This can result in premature submission of the job to the RIP.
The best way to avoid premature submission of the job to the RIP is to copy all the slave files to the
hot folder, before copying the FP file. If the user cannot guarantee to copy the FP file after all the
slave files, then a work-around is to set a large stabilization time on the hot folder.
The hot folder server (a component of PrintMate) treats all TIFF/IT file extensions case-insensitively
on all platforms. For instance, FP, fp and Fp are all acceptable extensions for the final page
file.
The hot folder server treats the base name case-insensitively on Windows, and case-sensitively on all
other platforms. Note that this could occasionally cause unexpected results on Mac OS X, if the user
is using a case-insensitive filesystem (the Mac has both types).

1.3 Running PrintMate on Windows

The table below lists the system requirements for installing and running Printmate on Windows.
Platform
Processor
Refer to the RIP Specs in the RIPMate for Windows Getting Started Guide.
System memory
Disk space
a
Browser Internet Explorer 5.5/6.0/7.0
Netscape Navigator 7.1
Mozilla Firefox 1.0.2 or 1.5.0.7
Browser must support English (US or British) and JavaScript.
Set browser to enable popups and session cookies.
RIP RIP Genesis Release 7.2 (security dongle required)

PPM permit file installed in Harlequin License Server (HLS).
Monitor 1024 x 768 resolution or better
Table 1.1 PPM requirements for Windows
a. After launching PPM with Internet Explorer 7.0 set as the default browser, click Yes to dismiss the message
dialog which reads: The web page you are viewing is trying to close the tab. Do you want to close this tab?.

1.4 Running PrintMate on Mac OS X

The table below lists the system requirements for installing and running PrintMate on Mac OS X.
Platform
Processor
Refer to the RIP Specs in the RIPMate for Windows Getting Started Guide.
System memory
Disk space
Browser Apple Safari 1.2/1.3/2.0

Browser must support English (US or British) and JavaScript.
Set browser to enable popups and session cookies.
RIP Harlequin RIP Genesis Release 7.2 (security dongle required)

PPM permit file installed in Harlequin License Server (HLS).
Monitor 1024 x 768 resolution or better
Table 1.2 PrintMate requirements for Mac OS X

1.5 PrintMate user accounts.

To use the PrintMate web GUI, you will need to select a user account and enter any required password in the
login screen that opens after connecting to the web GUI. The default user accounts and their permitted
actions installed by PrintMate are shown in the table below. Your installation may be different, depending on
what accounts have been set up.
User name User icon Permitted actions
viewer access PrintMate web GUI

monitor job processing
inspect job info and log files
preview jobs in Preview/Roam
user same as viewer, plus:

delete jobs
hold jobs in the output queue
keep jobs so they are not automatically deleted by PrintMate
reoutput jobs
resumbit jobs to another channel
admin same as user and viewer, plus:

setup job processing channels
change application settings, such as auto-delete policies and memory allocation
support access the Support window under the guidance of a technical support person.
Table 1.3 Default accounts
Refer to the PPM Customization Guide for details on setting up users.


Chapter 2 Installing and Running

Before you install PrintMate Pre-installation checks, page 13.
Installing PrintMate, page 15.
Adding the PrintMate permit file, page 15.
Installing the PrintMate printer, page 17.
Starting PrintMate, page 18.
Connecting to the PrintMate web server, page 20.
Setting PrintMate back to default settings, page 21.
Closing PrintMate, page 21.
Making a backup copy of your PrintMate data, page 21.
Recovering from an invalid application shutdown, page 22.
Uninstalling PrintMate, page 23.
2.1 Before you install PrintMate Pre-installation checks

Before installing, make sure the RIP, your web browser and your firewall are all ready to work with Print-
Mate. The following checks and procedure will help you to set them up correctly.
2.1.1 RIP pre-installation checks

PrintMate works with RIPMate / Harlequin RIP Genesis Release version 7.2 only; RIP versions
prior to this are not supported. If necessary, upgrade to version 7.2 before installing PrintMate.
If necessary, create suitable page setups for processing jobs submitted to PrintMate. Although no
special page settings are required, a valid output device must be specified when processing jobs sub-
mitted via PrintMate, such as a proofing printer, press or TIFF output. As such, the default page
setup installed by the RIP is not suitable for use with PrintMate, since it uses Preview as the output
device.
INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 13

INSTALLING AND RUNNING INDEX CONTENTS 14
2.1.2 Web browser pre-installation checks

Check your browser is supported by PrintMate. For a list of supported browsers, see Running
PrintMate on Windows, page 9 and Running PrintMate on Mac OS X, page 10.
Make sure your browser has JavaScript enabled.
Configure the browser to allow pop-up windows.
Configure your browser to allow session cookies.
Do not configure the browser to substitute HTTP error messages in place of those generated by
PrintMate. In Internet Explorer, the relevant setting is Show friendly HTTP error messages within the
Advanced dialog (it should not be selected).
If you are using a web proxy server, set it up to bypass pages generated by PrintMate web GUI
(SWWebGUI.exe). In practice, this often means bypassing the web proxy server for pages that are
inside the Intranet.
If your browser is configured to a locale other than English, you may find some issues with the dis-
play, whereby some icons are replaced by text or look different depending on the browser. To correct
this, configure a list of locale preferences. In Internet Explorer the option is under Tools > Internet
Options > General > Languages.
In your default web browser, make sure that English (for example, en_US or en_GB) locale is one
of the preferences. Note: English does not have to be the first preference, but it must appear in the
list.
2.1.3 Firewall pre-installation checks

If you are using a firewall to protect your network then you must configure it to allow communication from
the following PrintMate programs:
SOAR
SWWebGUI
Roamserver
On the Macintosh you may also need to add the PrintMate port number to the allow list of ports, as fol-
lows:
1. Open System Preferences, Sharing, Firewall.
2. Click New.
3. From the Port Name list, select Other.
4. Enter the port number PrintMate is using in the box.
5. Choose OK.

2.2 Installing PrintMate

PrintMate is delivered on the WorkMates CD. Refer to the ERCM RIPMate for Windows Getting Started
Guide for instructions for installing PrintMate from the CD.
2.3 Adding the PrintMate permit file

The permit file supplied with PrintMate secures the application and at the same time licenses connections to
the PrintMate login screen. The supplied permit file allows up to five simultaneous connections to the man-
ager, before blocking incoming connections. For additional licenses, you should contact your PrintMate sup-
plier.
To install the PrintMate permit file on the server:
1. On the server, launch Harlequin License Manager, as follows:
On Windows, choose Start > All Programs >ECRM WorkMates> Tools & Utilities>
License Manager.
Figure 2.1 Opening the License Manager
On Mac OS X, choose /Library/Application Support/Global Graphics Software/License

Manager/LicenseManager.
2. Select the server from the list and click Add Permit.

3. Navigate to the folder where your PrintMate permit file can be found, and click Select/Choose. You
should now see Web GUI for PrintMate / PrintMate listed in your License Manager window, as
shown in Figure 2.2.
PrintMate
permit
Figure 2.2 The License Manager with a PrintMate permit file installed

2.4 Installing the PrintMate printer

This section describes how to install the PrintMate printer on Mac OS X and Windows servers. With the
printer installed, you will be able to create and share virtual printers in your PrintMate job processing
channels, install the virtual printers on client machines and use them to print documents to PrintMate.
For details on setting up PrintMate virtual printers, see Creating and publishing virtual printers, page
50.
2.4.1 Installing the printer on a Mac OS X server

On Mac OS X, the PrintMate printer is installed automatically during the PrintMate installation procedure.
Therefore, no further user interaction is required after the application has been installed on this platform.
2.4.2 Installing the printer on a Windows server

Complete these steps to install the PrintMate printer driver and printer on a Windows server. You may be
prompted for your WorkMates installation disc during the installation, so have this on hand before you start.
1. With PrintMate installed, open the following folder:
<ECRM WorkMates folder>\SOAR\PrintProductionManager\<version>\<revision>\all-
all\all\config\ppds
2. From the folder, run instppdxp.bat (Windows 2000/XP) or instppd2003.bat
(Windows Server 2003), depending on the system.
3. Open the Windows Control Panel and select Printer and Faxes. Double-click Add Printer to start the
Add Printer Wizard.
4. In the Local or Network Printer dialog, select Local printer attached to this computer. Automati-
cally detect and install my Plug and Play printer must be unchecked. Click Next to continue.
5. In the Select a Printer Port dialog, choose File (Print File) from the menu. Click Next to continue.
6. In the Install Printer Software dialog, select Global Graphics Software Ltd, Global Graphics Print
Production Manager for the printer model. Click Next to continue.
7. In the Use Existing Driver dialog (if it appears), choose Replace existing driver. Click Next to con-
tinue.
8. In the Name Your Printer dialog, we recommend leaving the name as Global Graphics Print Produc-
tion Manager, and No as the default printer setting. Click Next to continue.
9. In the Printer Sharing dialog, select Do not share this printer. Click Next to continue.
10. Enter relevant details into the Location and Comments fields as required.
11. In the Print Test Page dialog, select No. Click Next to continue and then click Finish.

12. Click Continue Anyway when the Hardware Installation message appears. The driver files will now be
installed and you will be prompted for the location of the ggppm.ppd file, which can be found in
all\all\config\ppds.
2.5 Starting PrintMate

After installing the application files and the permit file, you may start PrintMate on the installation server.
The manager handles all aspects of job processing and communication between the RipMate RIP and Print-
Mate. Running as a background task on Windows and Mac, it is accessed through a web browser, as
described in Connecting to the PrintMate web server, page 20.
2.5.1 Starting PrintMate in Windows

To start the PrintMate in Windows:
1. Close the RIP if it is running.
2. From the Start menu choose, All Programs > ECRM Workmates> WorkMates Administrator.
Figure 2.3 Selecting Workmates Administrator
3. The WorkMates Admin screen opens.

From the Control pull-down menu. select Restart WorkMates Server.
Figure 2.4 Selecting Restart WorkMates Server

4. WorkMates Admistrator launches the RIP, and several RIP screens open. Once the RIP is running,
WorkMates Administrator launches PrintMate and the login screen shown below opens. You can then
login to PrintMate to view, use, or administer jobs.
Figure 2.5 Printmate Login Screen
Additionally, the following System Tray program icons appear when PrintMate is running.
Indicates the Harlequin PPM (PrintMate) server is running with the Harlequin RIP open.
Indicates the Harlequin PPM (PrintMate) server is running without the Harlequin RIP
GUI open.
May appear briefly during Harlequin PPM (PrintMate) startup or shutdown. However, if it
appears persistently at any other time, it means an error has occurred in the
Harlequin PPM server that requires operator assistance.
Table 2.1 System Tray icons for PrintMate
2.5.2 Starting PrintMate in Mac OS X

To start PrintMate in Mac OS X:
1. Close the RIP if it is running.
2. Navigate to the Harlequin PPM installation folder, normally Applications/Harlequin.
3. Double-click Start Harlequin Print Production Manager to launch Harlequin PPM manager.
Note: If the SWWEBGUI: Application Corrupt dialog box appears, refer to Recovering from an invalid
application shutdown, page 22.

2.6 Connecting to the PrintMate web server

The PrintMate web server connects you to the PrintMate web GUI, which allows you to see all the jobs sub-
mitted to PrintMate for processing and outpu, Additionally, if you have the necessary access rights, it allows
you to setup processing channels and manage jobs: previewing, deleting, reoutputting, and reprocessing as
necessary.
Connecting to the web server on the machine where PrintMate is installed:
See Starting PrintMate, page 18
Connecting to the web server from any machine (local or remotely connected):
Open a web browser and enter the following web address:
http://<IP address|machine name>:<port>/soar/
Where,
IP address or machine name is the machine where PrintMate is installed,
port is the comms port number assigned to PrintMate.
For example:
http://my-machine:8080/soar/
Note: The port number is specified during the installation of PrintMate, which is done from the
ECRM WorkMates CD.

2.7 Setting PrintMate back to default settings

If required, you may reset PrintMate back to its default installation settings. Resetting deletes all your chan-
nel settings, job metadata and application settings.
To reset Harlequin PPM:
On Windows, choose Start > All Programs >ECRM WorkMates>Tools & Utilities>PrintMate
Utilities>Printmate Reset to Defaults.
On Mac OS X, run Applications/Harlequin/SOAR Control. In the SOAR Control dialog enter the
command reset.
2.8 Closing PrintMate

To close PrintMate and the RIP associated with it, do the following:
1. In any PrintMate screen other than the login screen, click the logout button (shown below).
2. Go to the WorkMates Admin screen. From the Control pulldown menu, select Stop WorkMates
Server.
Figure 2.6 Stopping the WorkMates Server
2.9 Making a backup copy of your PrintMate data

You can configure Harlequin PPM so that it creates a backup copy of the job processing data each time
Harlequin PPM starts up. The backup can be used to recover from an invalid application shutdown, which
might have resulted in corruption of the application data.
To create a backup, add -backup to the persistence.txt file, located in:
all\all\config
When backups are enabled the time taken to launch PrintMate may be significantly longer, since there may
be a considerable amount of data to backup. To facilitate the startup time, therefore, you may wish to delete

redundant completed jobs, either manually or by setting the auto-destroy policy setting to do this for you
(see PrintMate settings, page 45 for auto-destroy policy settings).
2.10 Recovering from an invalid application shutdown

Should an invalid shutdown occur when using PrintMate, the application data containing job data and other
application related data may not have been saved to disk before the shutdown occurred, resulting in possible
corruption of the application state. Following an invalid shutdown, the next time you start PrintMate the
SWWEBGUI: Application State Corrupt dialog box (Figure 2.7) will appear, with possible options for recov-
ering the application state, as described below.
Figure 2.7 Application State Corrupt dialog
Abort Aborts start-up without affecting the application data. This is the safest
option to choose following an invalid shutdown, since your data will
remain unaffected. Under the guidance of Technical Support, it may be pos-
sible to recover the data.
Log Attempts start-up and adds an entry to the PPM log file
(\SOAR\PrintProductionManager\<version>\
<revision>\<processor>\rel\logger.log). Start-up using the Log option will typi-
cally succeed, but in fact there could be potential corruption that will
cause errors later on. Once you have had a successful start-up using this
option, the previous backup will be lost and you will not be able to go back
to the known-good state. #
If you decide to use Log, because you have some jobs that you absolutely
have to carry on working with, then you should Reset to Defaults as soon as
possible afterwards. Note that, once you have continued using Log, it is no
longer safe to restore a backup.

Restore (recommended)
Selecting this option restores PrintMate to a known good state from the
PrintMate backup file, and is the recommended option to take the first time
you start after an invalid shutdown but not after you have used Log already;
in this case you should use Reset.
Reset Resets PrintMate back to its default settings, deleting all of PrintMates
application and job processing data in the process.
2.11 Uninstalling PrintMate

To uninstall PrintMate:
1. If PrintMate is running on the server shut it down, as described in Closing PrintMate, page 21.
2. Run the Windows Uninstall utilty program as follows:
On Windows, click Start > Control Panel > Add or Remove Programs
In the Add/Remove Window, scroll to ECRM Printmate and then click the Change/Remove
button to remove the PrintMate program.
Figure 2.8
On Mac OS X, choose Applications:Harlequin:Install.

3. From the list of packages and products that are available, select the PrintMate package and product
that you want to uninstall (usually only one product will be listed, unless you have installed multiple
versions of the applications).
4. Click Add to add PrintMate to the package/product list. Continue adding products if there are multiple
products to uninstall.

5. Click Uninstall and click Yes to confirm that you want to proceed uninstalling PrintMate; otherwise
click No.
6. Lastly, click OK to close the Product Installer window.


Chapter 3 A Brief Tour of the
PrintMate Web GUI
The Monitor window, page 27.
The Job Info window, page 36.
The Roam window, page 39.
The Channels window, page 41.
The RIPchannel window, page 42.
The Config window, page 44.
The Debug window, page 46.
The PrintMate web GUI uses web technology to present a graphically-rich, easy-to-operate user interface for
the PrintMate manager.
A BRIEF TOUR OF THE PRINTMATE WEB GUI AG50563 REV. 3 INDEX CONTENTS 26
A BRIEF TOUR OF THE PRINTMATE WEB GUI INDEX CONTENTS 27
3.1 The Monitor window

The Monitor window lists jobs queued for processing and output, and shows completed jobs which havent
yet been deleted from PrintMate. The displayed job name is usually the file name, except in special cases
('Remote Downlevel Document')..
A B C D E F
Figure 3.1 The PrintMate web GUI Monitor window.
A Monitor tab Opens the Monitor window, which enables you to monitor and adminis-
ter jobs in the print production workflow.
B Channels tab Opens the Channels window, which enables you to administer job pro-
cessing channels.
C Config tab Opens the Configuration Summary window, which allows you to view
application summary information, administer application-wide settings,
and read the license agreement.
D Refresh Manually refreshes the display. PrintMate auto-refreshes the display

according to the Job List Refresh Period setting (see PrintMate
settings, page 45).
E Logout Logs out the current user.
F RIP status
RIP is available, connected and able to process jobs from PrintMate.
Job submission to the RIP has been suspended or the RIP has been shut-
down. Click the Resume output button in the RIP toolbar to resume pro-
cessing, or restart the RIP if necessary.
RIP is connected but the queue is blocked, most likely as a result of the
RIP being configured.
Job submission to output devices has been suspended or the printer is

not ready. Click the Resume output button in the Print toolbar to resume
output, or ready the printer if necessary
G Input queue Lists jobs queued for processing by the RIP. For details of the Input list,
see page 29.
H RIP toolbar Enables you to manage job submission to RIP. For details of the RIP
toolbar, see page 30.
I Output queue Lists jobs queued for output. For details of the Output list, see page 30.
J Print toolbar Enables you to manage job submission to the output device. For details
of the Print toolbar, see page 33.
K Complete list Lists completed jobs. The status icons show if the job completed suc-
cessfully or not. For details of the Complete list, see page 34.
3.1.1 The Input queue list

The Input queue lists jobs that are queued for processing by the RIP. The job that is currently being pro-
cessed is indicated by an hour-glass and is ranked No.1 in the list. If you cannot see the job list, you may
need to click the arrow on the right of the toolbar (indicated) to open it.
A B C D E F
Figure 3.2 Input list features
A Visible/Total jobs Shows the number of jobs listed and the total number of jobs available.
B Job display filters Enables you to select a display filter for the jobs in the Input list. Only
jobs which match your filter selections will be displayed. The following
options are available:
Show/Hide Shows or hides jobs matching the chosen filter.
Last 24 hours Match jobs from the last 24 hours.
Hold Match held jobs.
Preserve Match kept jobs.
C Delete jobs Enables you to delete jobs that appear in the input list. Select the items
you want to delete first, before clicking the Delete jobs button.
D View job info Opens the Job Info window to show details for the job that is currently
selected.
See, The Job Info window, page 36.
E Select all jobs Selects all jobs that are currently listed.
Multiple selections can also be made using SHIFT to select contiguous
blocks of jobs. You can use CTRL or ALT to select additional jobs,
while retaining the existing selection.
3.1.2 The RIP toolbar

The RIP toolbar shows the current RIP job and its overall processing progress. It also contains options for
suspending RIP processing and viewing the RIP log file.
A B C D E F
Figure 3.3 The RIP toolbar
A Job name The displayed job name is usually the file name, except in special cases
('Remote Downlevel Document'). The special cases can be customized
by the OEM, via the Displayer configuration.
B Channel Displays the processing channel for the current job.
C Abort job Enables you to abort processing of the current job.
D RIP progress bar Displays processing progress of the current job in the RIP.
E Start/Stop connection Starts and stops the connection to the RIP from PrintMate. Jobs cannot
to RIP be sent to the RIP for processing if the connection has been stopped,
although the RIP will continue to process the current job and will still
process jobs submitted outside of PrintMate.
F View RIP log Opens the RIP Monitor Log window, displaying RIP generated mes-
sages for the current job.
3.1.3 The Output queue

The Output queue lists jobs that are queued for output to the device shown in the Device column. Output
order is determined the jobs rank, with the current output job ranked 1 and the next in line ranked 2, and so
on.
A B C D E F G H I
Figure 3.4 The Output queue
A Visible/Total jobs Displays the number of jobs listed in the output queue and the total
number of jobs that are available.
B Job list filter Enables you to select a display filter for jobs displayed in the Output
list. Only jobs which match your filter selections will be displayed. The
following filters are available:
All Match all jobs.
Waiting Match jobs that are waiting to be output.
Busy Match jobs that are currently being output.
Ripped Match jobs that have been processed by the RIP.
Errored Match jobs which failed to be processed by the RIP.
Warnings Match jobs with warnings after processing by the RIP.
Preserve Match jobs that will be kept and will not be automatically
deleted.
C Delete Enables you to deletes jobs that appear in the output list. See, Deleting
jobs, page 58.
D Hold Enables you to hold and unhold jobs that appear in the output queue. A
held job will not be output until it has been unheld, after inspection for
example. See, Holding or unholding jobs, page 57.
E Keep Enables you to keep and unkeep jobs listed in output. Jobs that have
been marked Keep will not be automatically deleted once PrintMate
deems them expired. See, Keeping jobs from being deleted, page 58.
F View job info Opens the Job Info window to display information for the currently
selected job. See, The Job Info window, page 36.
G Preview Opens the Roam/Preview window to preview the currently selected job.
The Roam window, page 39.
H View job log Opens the RIP Monitor Log window to display RIP processing informa-
tion for the currently selected job.
I Select all Selects all the jobs that are listed.
J Change job output order Lets you change the rank of jobs listed in the Output list. Higher ranking
jobs have precedence over lower ranking jobs.
K Status icons The status icons indicate a jobs processing state, as follows:
Job is being processed.
Job is held for output.
Job completed successfully with no warnings.
Job completed successfully but with warnings.
Job processing failed.
3.1.4 The Print toolbar

The Print toolbar contains buttons that let you abort printing of the current job, suspend and resume job sub-
mission to the printer, and open the RIP Monitor Log window.
A B C D E F
Figure 3.5 The Print toolbar
A Job name Shows the name of the job currently being output.
B Channel Displays the processing channel for the current job.
C Abort job Enables you to abort the current RIP job.
D Print progress bar The progress bar updates to show the progress of the job through the
printer/output device.
E Suspend/resume printing Starts and stops the connection to the printer/output device
from PrintMate. Jobs cannot be sent to the printer if the connection has
been stopped, although the printer will continue to print the current job
and will still print jobs submitted outside of PrintMate.
F View RIP log Opens the RIP Monitor Log window, displaying RIP generated mes-
sages for the current job.
3.1.5 The Complete list

The Complete list shows jobs that have been processed and output, either successfully or unsuccessfully, and
jobs that have been manually forced to skip output.
A B C D E F G H I J K
Figure 3.6 The Complete list
A Visible/Total jobs Displays the number of jobs listed in the output queue and the total
number of jobs that are available.
B Job list filter Enables you to select a display filter for the jobs in the Completed list.
Only jobs which match your filter selections will be displayed. The fol-
lowing options are available:
All Match all jobs.
Complete Match completed jobs.
Skipped Match skipped jobs.
Errored Match jobs which failed to be processed by the RIP.
Warnings Match jobs with warnings after processing or output.
Preserve Match kept jobs, that will not be deleted.
Aborted Match aborted jobs.
C Search Opens the job search window. See, Searching for jobs, page 56.
C Resubmit Resubmits the selected job(s) to the chosen channel for processing.
E Delete Enables you to deletes jobs that appear in the completed list. See,
Deleting jobs, page 58.
F Hold Enables you to hold and unhold jobs that appear in the completed list. A
held job will not be output until it has been unheld, after inspection for
example. See, Holding or unholding jobs, page 57.
G Keep Enables you to keep and unkeep jobs listed in the completed list. Jobs
that have been marked Keep will not be automatically deleted once
PrintMate deems them to have expired. See, Keeping jobs from being
deleted, page 58.
H Job info Opens the Job Details window to display information for the currently
selected job. See, The Job Info window, page 36.
I Preview Opens the Roam/Preview window and shows a preview of the selected
job. The Roam window, page 39.
J Job log Opens the RIP Monitor Log window to display RIP processing informa-
tion for the currently selected job.
K Select all Selects all jobs displayed in the list.
L Status icons The status icons indicate a jobs processing state, as follows:
Job is currently active in preview/Roam.
RIP processing aborted.
Job completed with no warnings.
Job completed but with warnings. Check the log file.
Job failed to process. Check the log file.
3.2 The Job Info window

The Job Info window contains comprehensive information for the selected job, enables you to add custom
information to the job, and lets you reoutput multiple copies of the job, resubmit it, and perform other job
related tasks. To open the Job Info window, in the Input, Output, or Complete lists select the job whose
details you want to view and click the Job Info button in the list toolbar.
A B C D E F
G H
J K L M N O P Q
Figure 3.7 The Job Info window
A Job name Shows the job's file name and the job's PDL-defined job name from the
RIP, if both are available and different.
B Job information Presents information relating to job processing, including its owner, its
current processing stage, processing priority, page size, disk usage and
various RIP times.
C Channel Shows the name of the processing channel.
D RIP status Shows the RIP status of the job. The following states are possible:
Job completed successfully with no warnings.
Job completed successfully but with warnings. Check the log file.
Job did not complete RIP process. Check the log file.
E Refresh Refreshes the Job Info window.
F Close Closes the window and releases the job for further workflow process-
ing. This button should always be used in preference to the standard
Windows close button.
G Page color separations Lists each page and its component color separations. The tick boxes
allow you to choose which pages and/or separations you want to reout-
put.
H Custom Field 13 The custom fields enable you to add your own job-related information
to the job. Youll need to click the Save Changes [Q] button to save
your entries.
I Page Setup Displays details of the page setup options used when processing the job.
To change any of these settings youll need to open the page setup in the
RIP.
J Reoutput selected items Enables you to reoutput the items selected in the page separations list
[G] to the output device selected in page setup [I].
Enter the number of copies you want in the Copies field, and select Col-
late if you want the pages to be arrange in their proper sequence on the
output device.
K Resubmit Enables you to reprocess the job using a different processing channel.
From the drop-down menu, select the channel you want to use and then
click the Resubmit button.
L Hold Enables you to suspend outputting of the job to the output device. Typi-
cally, used so that jobs can be previewed prior to printing. See also,
Previewing jobs (Roaming), page 56.
M Keep Enables you to preserve the job from automatic deletion, as determined
by PrintMates auto-destroy policy. See also, Keeping jobs from being
deleted, page 58.
N Preview/Roam Opens the Preview/Roam window with a preview of the job. For details
on previewing jobs, see Previewing jobs (Roaming), page 56.
O RIP Monitor Log Opens the RIP Monitor Log window for the job. See, Viewing job
history, page 59.
P Job History Log Opens the Job History window for the job.
Q Save Changes Click this button to save your Custom Field [H] entries.
3.3 The Roam window

Roam enables you to preview RIP processed jobs before they are sent to the output device. To open the
Roam window, select the job you want to preview from the Output or Complete lists and click the Roam
button in the list toolbar.
A B C D E F G H I J
L
N
Figure 3.8 The Roam window
A Job name Job opened for preview in Roam.
B Nudge buttons The buttons enable you to nudge previews that are larger than the visi-
ble area into view. You can also drag the preview directly to achieve the
same effect.
C Fit to Window Enables you to resize the preview so that it fits within the available pre-
view area.
D 1 to 1 Enables you to resize the preview to actual print size.
E Zoom controls The zoom controls allow you to magnify the preview to suit your view-
ing requirements. Either click the magnifier buttons to zoom in or out,
or use the drop-down menu to choose a magnification.
F Rotate Enables you to rotate the page in the preview window.
G Mirror These enables you to mirror the preview image in the X (horizontal) and
Y (vertical) planes.
H Progress bar The progress bar enables you to see when Roam is busy processing the
preview image.
I Abort Enables you to abort the current task.
J Close window Closes the window and releases the job.
K Preview thumbnail Displays a thumbnail of the preview page. The movable rectangle indi-
cates the area of the page that is currently visible in the main preview
window.
L Page number For multiple-page jobs the drop-down menu enables you to choose
which page to display.
M Separations and Allows you to enable or disable the previewing of individual color sepa-
colorants rations. Click Apply Selections for making your selections to update
the preview window.
N Preview image Displays the preview image of the job, page number and color separa-
tions that have been selected. Click and hold the mouse to drag the pre-
view around.
3.4 The Channels window

The Channels window contains options which allow you to create, delete, amend and inspect channels
in PrintMate. For comprehensive instructions on how to work with channels, see Setting up channels,
page 48.
A B
Figure 3.9 The Channels window
A Channel toolbar The toolbar buttons enable you to work with channels and search for
jobs. See, Setting up channels, page 48 for more information.
B On / Off buttons These buttons can be used to enable and disable channels.
A channel must be enabled in order to process jobs, although it can still
receive jobs from users when it is disabled. The Channel status indicator
[C or D] shows the current status of the selected channel.
C, Channel status indicator Indicates the current enabled/disabled state of a channel: a green icon
D indicates the channel is enabled; a red icon indicates the channel is dis-
abled.
E Workflow Presents a graphical representation of the print production workflow, as

specified in the selected channel.
F Page setup Presents a summary of the page setup options which will be used to pro-
cess jobs submitted to the selected channel.
3.5 The RIPchannel window

The RIPChannel window, accessed by clicking New, Edit or Copy in the Channels window, is used to setup
job processing channels.
A B C D
L
E
F
G M
H
I
J
N
O
K
P
Figure 3.10 The RIPChannel window
A Name Enables you to enter a name for the channel. You may use spaces and
special characters if required.
B Job priority Allows you to specify a job processing priority for jobs which enter the
channel. From the menu, choose from High, Medium (default setting)
or Low priority.
C Stabilization Enables you to specify a stabilization time for files entering a hot folder.
D Driver The menu shows the printer drivers that are installed on the server. To
process jobs correctly, choose Global Graphics Print Production
Manager from this list. If it is not listed, install the PrintMate printer
driver, as described in Installing the PrintMate printer, page 17 and try
again.
E Input channel Select this option (the default option) to make the channel an input
channel, able to receive jobs from users via hot folders and/or printers.
If this option is deselected, the channel can only be used to reprocess
jobs.
F Enabled Select this option (the default option) to enable the channel. An enabled
channel is able to process jobs. Deselect this option to disable the chan-
nel; jobs can still be received, but they will not be processed until the
channel has been enabled.
G Hot folder Enables you to create a hot folder for the channel. Hot folder are used to
receive TIFF, EPS, PDF, PostScript language and other RIP-compatible
files.
Enter the path to the hot folder, including server name if required, into
the adjacent text box, or click the folder icon to navigate to the hot
folder.
It should be noted that hot folder files are never deleted by PrintMate,
instead they must be deleted manually when they are no longer
required.
H Printer Enables you to create a printer for the channel. Printers can be used to
print source documents to the channel. The printer handles the conver-
sion process to PostScript before transferring the file to the channels
input folder.
I Share printer Enables you to enter a share name for the printer. If you share a printer
with a variety of clients on a network, use 31 or fewer characters for
printer names including the server name and path, and do not include
spaces or special characters in these names.
J Page setup Allows you to specify which RIP page setup to use to process jobs in the
channel. After choosing a page setup, the page setup area [N] updates to
show which RIP options will be used to process jobs.
K Restrict resubmission Enables you to choose which channels should be excluded from repro-
cessing jobs that are submitted to the channel. Select the check box and
then select the channel(s) that you want to exclude from the list.
L Close window Closes the window and releases the job.
M Enable TIFF/IT Enables you to provide support for TIFF/IT files in the channel. See,
Restrictions on TIFF/IT-P1 files, page 8. This option is not selected
by default.
N Page setup view Shows the chosen RIP page setup [J] settings that will be used to pro-
cess jobs in the channel.
O Hold jobs in Output This option allows you to hold all jobs that enter the channel before they
queue are output. This allows you to preview the jobs after they have been pro-
cessed before they are submitted to the output device. This option is not
selected by default.
P Keep completed jobs This option allows you to keep completed jobs, preventing them from
being automatically deleted by PrintMate, according to the applications
auto-delete policy settings. See, PrintMate settings, page 45. This
option is not selected by default.
3.6 The Config window

For information about the PrintMate application, you should refer to the Summary screen in the Config win-
dow. The Settings screen allows you to specify application-wide settings, like your preferred auto-destroy
policy and inactivity time-out settings. The About screen contains the PrintMate license agreement.
Figure 3.11 The Config window with Settings selected
A Summary Click Summary to view details of the PrintMate, RIP and Roam servers,
as well as information on the hot folders, printers and output devices
that are in use.
B Settings Click Settings to view or specify settings for job auto-destroy, maxi-
mum Roam memory, inactivity time-out, and other PrintMate options.
See, PrintMate settings, page 45 for details of the settings that are
available.
C About Click About to view the PrintMate license agreement.
3.6.1 PrintMate settings

The following options are available in the Settings screen.
Maximum Job List Size Enables you to specify the maximum job list size. Select from 1001000 jobs.
The default value is 500 jobs.
Job List Refresh Period Enables you to specify a job list refresh period. Select from Never to 60 seconds.
The default value is 10 seconds.
Job Auto-Destroy Policy Enables you to specify an auto-destroy policy for completed jobs. The following
options are available:
Never Auto-Destroy Jobs: When selected, PrintMate will not automati-
cally delete jobs. This is the default setting.
Auto-Destroy Jobs on Reaching a Certain Age: When selected, jobs
will be deleted after reaching the age selected in the Job Auto-Destroy
Max Age menu.
Auto-Destroy Jobs when Disk Space is Low: When selected, jobs will
be deleted (oldest first) when disk space falls below the level selected in
the Job Auto-Destroy Min Free Disk Space menu.
Job Auto-Destroy Max Age When Auto-Destroy Jobs on Reaching a Certain Age is selected, this setting
enables you to specify the maximum age to retain jobs. Select from 1 day to 6
months.
Job Auto-Destroy Min Free When Auto-Destroy Jobs when Disk Space is Low is selected, this setting
Disk Space enables you to specify the minimum disk space before jobs start being deleted.
Select from 100 MB to 5 GB of free space.
Maximum Roam Memory Enables you to specify the maximum amount of system memory for Roam.
Select between 264 megabytes (MB). The default setting is 16 MB.
Restart PrintMate after making any changes to the Maximum Roam Memory
setting.
Custom Field Label # These three fields (Custom Field Label 1, Custom Field Label 2,
Custom Field Label 3) allow you to add your own custom job information to
all jobs that are processed.
Inactivity Time-out Allows you to specify an inactivity time-out period, after which the user will be
automatically logged out of the application (job processing will still continue as
normal).
The default time is 60 minutes.
3.7 The Debug window

The Debug window only appears after logging in with debug privileges. The options that are available can
be used by support technicians to trace processing and workflow errors, and may to used to reconstruct cor-
rupted data files.
Details of how to use these options are not available in this manual. Your support technician will be able to
provide instructions if required.
Figure 3.12 The Debug window (available only to debug users)
Chapter 4 Using PrintMate

Setting up channels, page 48.
Creating and publishing virtual printers, page 50.
Creating hot folders, page 52.
Processing jobs, page 53.
4.1 Setting up channels

A PrintMate channel contains options, such as RIP processing priority and page setup, which prescribe how
jobs in the channel should be processed. A PrintMate administrator will need to set up at least one channel
with a hot folder and/or virtual printer in place, in order for users to submit jobs for processing. Several
channels may be needed, each with different processing options, to meet the processing requirements of
your PrintMate/RIP users.
4.1.1 Adding channels

To create a new channel, do the following:
1. Connect to the PrintMate web GUI and login with an account that allows administrative access.
2. In the Channels window, click New to create a new channel, or, to create a channel using settings from
an existing channel, choose Copy instead. Both options open the RIPchannel window. See, The
RIPchannel window, page 42 for a description of the options that are available in this window.
3. Enter your hot folder and/or PrintMate printer details if you want to use the channel as an input chan-
nel, able to receive jobs from users. For more information on setting up hot folders and PrintMate
printers, see Creating and publishing virtual printers, page 50 and Creating hot folders, page
52.
4. Select your other job processing options as required.
5. Click OK to save your settings and create the new channel.
USING PRINTMATE AG50563 REV. 3 INDEX CONTENTS 48

USING PRINTMATE INDEX CONTENTS 49
4.1.2 Editing channels

To edit an existing channel, do the following:
1. Connect to the PrintMate web GUI and login with an account that allows administrative access. For
help on connecting to the web GUI, see Connecting to the PrintMate web server, page 20.
2. In the Channels window, select the channel you want to edit and click Edit. The RIPchannel window
opens.
3. Edit the settings accordingly. See, The RIPchannel window, page 42 for a description of the options
that are available.
4. Click OK to save your new settings.
4.1.3 Deleting channels

If necessary, you can delete a channel that is no longer required. However, you can only delete a channel if it
does not have any jobs associated with it listed in PrintMate. These include jobs which have been submitted
via a hot folder or PrintMate printer, and jobs which have been resubmitted to another channel but were orig-
inally received by the channel you want to delete. Any jobs associated with the channel, therefore, must be
deleted first, before you can delete the channel.
To delete a channel, do the following:
1. Connect to the PrintMate web GUI and login using an account that allows administrative access.
2. If necessary, delete any jobs that are associated with the channel, including jobs which have been
resubmitted to another channel before proceeding. To quickly locate all jobs that are associated with a
particular channel, run a job search on the channel name. See, Searching for jobs, page 56 for
details on how to run job searches.
3. From the Channels window, select the channel you want to delete.
4. Click Delete and then Confirm, to verify that you want to delete the channel. The channel will now be
removed from PrintMate.
5. After deleting a channel, you may uninstall/remove any PrintMate printer or hot folder that was asso-
ciated with the channel.
4.1.4 Starting and stopping channels

Job processing in a channel can be suspended by stopping the channel. Although the channel will still
remain available and is able to receive jobs, a stopped channel will not be able to process jobs until it has
been restarted again.

To stop/start a channel, do the following:

1. Connect to the PrintMate web GUI and login using an account that allows administrative access. For
2. In the Channels window, select the channel that you want to stop/start.
3. Click the Off button, located at the top right of the Channel window, to stop the channel, or click the
On button to start it.
The channel status icon (indicated in Figure 4.1) updates to show the current status of the channel.
Channel status
indicators
Figure 4.1 Channel enabled/disabled status icons
4.2 Creating and publishing virtual printers

PrintMate virtual printers appear to the operating system like normal printers, but instead of being con-
nected to a physical printer, they are connected to the Harlequin PrintMate server. You can add a virtual
printer for each channel that you create in Harlequin PrintMate, and any documents printed using the vir-
tual printer will be processed using the settings associated with that particular printer/channel combination.
Note: Before you can add a PrintMate virtual printer, you must have installed the Harlequin PrintMate
printer on the Harlequin PrintMate server. See, Installing the PrintMate printer, page 17 for details.
To create and publish a PrintMate virtual printer:
1. Connect to the PrintMate web GUI and login using an account that allows administrative access. For
2. Select the channels window and create, copy or edit a channel. The RIPchannel window appears,
allowing you to enter details for the channel.
3. If creating a new channel, enter a name for the channel and pick a page setup option.
4. Select the Printer checkbox. The channel name will be automatically entered into the printer name
field. If you want to, you can enter a different name for the printer, but this is not recommended if you
want to easily see your printer/channel associations.
5. To publish the printer on your network, select the Share Printer checkbox. Sharing a printer allows
remote users to connect to the printer. The share name of the printer will be automatically inserted;
however, if your network consists of a variety of clients you should use 31 or fewer characters for the
name, including the server name and path, and not include spaces or special characters in the name.
6. From the Driver menu, select ECRM PrintMate (or whatever name you choose when adding the
PrintMate printer).

7. Continue entering your other channel settings as required, and click OK to save them, or click Cancel
to cancel them.
The virtual printer you have created and shared can now be installed on a client machine, as described next.
4.2.1 Installing PrintMate virtual printer on Mac OS X

When Harlequin PrintMate is installed on a Mac OS X server, the PrintMate virtual printers will automati-
cally appear in the list of printers that are available to the Mac client. But when Harlequin PrintMate is
installed on a Windows server, you will need to add the printer yourself, as follows.
1. On Mac OS X client, run the Printer Setup Utility (System Preferences > Print and Fax > Set Up Print-
ers).
2. Choose Printers > Add Printer..., or click the Add icon.

3. Choose Windows Printing from the upper selector and Network Neighborhood from the lower
selector.
4. Select the PrintMate server from the list (see below if you cant see the printer), and click Choose to
continue. Login if prompted. You should now be able to see the PrintMate printers that are available
on the server.
Note: If you cannot see the PrintMate printer, check the printer sharename, as specified in the channel
settings, is 31 or fewer characters long (including full path) and contains no invalid characters (aster-
isks, spaces, etc.). In addition, the user name and password you used to login to the Mac OS X server
must not contain any spaces. For more information, see article
http://docs.info.apple.com/article.html?artnum=301768.
5. From the list, select the printer you wish to add.
6. Click Add to add the printer.
4.2.2 Installing PrintMate virtual printer on Windows

These steps describe how to install a PrintMate virtual printer on a Windows client. During the installation,
you may be asked to supply the Global Graphics printer driver, which can be found in <ECRM WorkMates
folder>\SOAR\PrintProductionManager\<version>\<revision>\all-all\all\config\ppds\ on the PrintMate
server. Your Windows installation disk may also be required to complete the setup.
1. Open the Windows Control Panel and choose Printer and Faxes.
2. From the Printers and Faxes window, double-click Add Printer to start the Add Printer Wizard.
3. In the wizard, select A network printer, or a printer attached to another computer, and click Next to
continue.
4. In the Specify a Printer dialog, either browse to the PrintMate server or enter the fully qualified path
to it. Click Next to continue.

5. Select the remote printer and click Next to continue. Select No or Yes as appropriate when asked if you
wish to make the new printer the default printer. If you are connecting to a printer on a Mac OS X
server, you may see the following message:
The server for the printer does not have the correct printer driver installed. If you want to search for
the proper driver, click OK. Otherwise, click Cancel and contact your network administrator or orig-
inal equipment manufacturer for the correct printer driver.
In this case, click OK and specify the driver file available from <ECRM WorkMates
folder>\SOAR\PrintProductionManager\<version>\<revision>\all-all\all\config\ppds\
6. Click Finish to add the printer.
4.3 Creating hot folders

PrintMate lets you set up hot folders which are continually monitored for incoming jobs. As with virtual
printers, you can add a hot folder for each channel, using the options in the RIPchannel window, as follows.
1. Connect to the PrintMate web GUI and login using an account that allows administrative access. .
2. Select the channels window and create, copy or edit a channel. The RIPchannel window appears,
allowing you to enter details for the channel.
3. If creating a new channel, enter a name for the channel and pick a page setup option.
4. Select the Hot Folder checkbox.
5. In the adjacent field, enter the path to the folder that you want to make the channels hot folder. Use
the folder browse button to navigate to the folder if required.
6. Continue entering your other channel settings as required, and click OK to save them, or click Cancel
to cancel them.
4.4 Processing jobs

This section describes how to submit, reoutput, reprocess, delete and perform other job related tasks in the
PrintMate web GUI.
4.4.1 Submitting jobs for processing

Jobs can be submitted for processing using a hot folder or a PrintMate printer. If you want to submit RIP-
compatible files, use a hot folder. If you want to submit application files, such as Adobe InDesign pages, use
a PrintMate printer instead.

Using a hot folder

To submit jobs using a hot folder:
1. Navigate to the hot folder that you want to use, using Windows Explorer, Mac Finder or your tool of
choice (note that this may require you to connect to the server machine, if you are remote from it).
Your PrintMate administrator will be able to tell you what hot folders are available and where they are
located.
2. Copy your job files to the top-level of the hot folder. PrintMate will move it to the Submitted folder
so that processing can commence.
3. Use the PrintMate web GUI to monitor job processing and output as required.
It should be noted that files in hot folders are not managed by PrintMate. It is your responsibility, or that of
the server administrator, to remove redundant files from the hot folder.
Using a PrintMate printer

To submit jobs using a PrintMate printer:
1. Open the document or image that you want to submit.
2. Choose Print and select the PrintMate that you want to use from the list of printers. Windows users
may need to install the PrintMate printer first, Mac users can simply connect to the PrintMate printer
on the server. Your PrintMate administrator will be able to tell you what printers are available and
how to connect to them. For details on setting up a PrintMate printer; see, Installing the PrintMate
printer, page 17.
3. Use the PrintMate web GUI to monitor job processing and output as required.
4.4.2 Reoutputting jobs (including parts of a job)

To reoutput jobs, including multiple copies and individual pages/separations:
1. Connect to the PrintMate web GUI and login using an account that allows job control access. For help
on connecting to the web GUI, see Connecting to the PrintMate web server, page 20.
2. Select the jobs you want to reoutput in the Complete list.
3. From the Complete list toolbar, click the Job Info button.
4. In the Job Info window, select the checkboxes for the pages and separations that you want to reoutput.
The whole job can be selected/deselected by using the top checkbox; individual pages and separations
can be selected/deselected using the appropriate checkboxes as required.
5. In the Copies field, enter the number of copies of the selected pages and/or separations that you want
to print.
6. If you want the pages to the collated on the printer, select the Collate checkbox.
7. Click the Reoutput button.

8. Close the Job Info window using the PrintMate button. If you use the standard window close but-
ton, PrintMate will take longer to determine that you have finished viewing the job.

4.4.3 Skipping output

You can skip job output by using the Skip Output tool, as described below. A job which has skipped output
will be immediately moved to the Completed list and its status updated to indicate that it has been skipped,
as shown in Figure 4.2.
Skipped job
Figure 4.2 Complete list with skipped job
2. In the Output list, select the job that you want to skip output.
3. In the Output list toolbar, click the Job Info button to open the Job Info window, from where you
can view various details about the job and perform other processing tasks.
4. In the Job Info window, click the Skip Output button, and then click OK to confirm.
5. Close the Job Info window using the PrintMate button. If you use the standard window close but-
ton, PrintMate will take longer to determine that you have finished viewing the job.
4.4.4 Reprocessing jobs

Completed jobs listed in PrintMate can sent for reprocessing and output by resubmitting them to a channel.
If required, you can choose another channel to reprocess the job, or you can choose the same channel, to
reprocess jobs that errored in some way.
To reprocess jobs:
2. In the Complete list, select the job(s) that you want to reprocess.
3. From the Complete list toolbar, use the drop-down menu to select the channel you want to use to
reprocess the jobs.
4. Click the Resubmit button in the toolbar, and then click OK to confirm your action.

4.4.5 Previewing jobs (Roaming)

PrintMate allows you to preview jobs that have been processed by the RIP, so jobs can be inspected and
checked prior to output. When previewing jobs youll use the Roam window. The features and options that
are available in this window are described in The Roam window, page 39.
To preview jobs:
2. Click the Monitor tab to view the Monitor window.
3. Select the job you want to preview in the Output or Complete lists.
4. From the toolbar, click the Roam button . If the job is particularly large or complex, it may take a
while for the Roam/Preview window to appear. If you wish to abort Roaming before the preview has
been generated, click the Abort button. However, once the job has been opened, you should be
able to navigate your way around it quite quickly.
5. After previewing the job, use the PrintMate close button to close the window. If you use the stan-
dard window close button, PrintMate will take longer to determine that you have finished previewing
the job.
4.4.6 Searching for jobs

The Search window (Figure 4.3) allows you to find jobs in PrintMate. Any jobs that are found will be listed
in the results window, where they can reprocessed, previewed and deleted.
Figure 4.3 The Search window
To search for jobs:

2. In the Complete list toolbar, click the Search button . The Search window (Figure 4.3) opens.
3. From the Search for menu, choose the rule that you want to search on and then click the Add Search
Rule button.
4. After adding the rule, choose the appropriate criteria to search on. For example, if you added
Device as the search rule, enter the name of the device in the text box and then choose if search
should find devices that are Equal to, Not Equal to, Contains, and so on, from the adjacent menu.

5. If necessary, build up your search string by adding other rulesup to three rules are allowed. If you
have multiple rules in place, choose And if all rules have to be met when finding jobs, or choose Or
if any of the rules can be met when finding jobs.
6. Click the Search button when you are ready to search. Any jobs that are found will be listed in the
Search window, as shown in Figure 4.4. You may now use the tools in the Search window toolbar to
resubmit, delete, hold/unhold, keep/unkeep, look at job information, preview, and view log informa-
tion as necessary.
Figure 4.4 The Search results window
4.4.7 Holding or unholding jobs

PrintMate allows you to hold back jobs that are in the output queue to allow them to be checked and
approved prior to output. If required, you can hold all jobs that enter a channel, by selecting the Hold jobs in
Output queue option in the channel settings window (see The RIPchannel window, page 42), or you can
hold individual jobs using the Hold/Unhold tool, as described below.
2. Select the job(s) that you want to hold in the Output queue, or Complete list if you intend to reoutput
the selected jobs, as described in Reoutputting jobs (including parts of a job), page 54.
3. From the toolbar, click Hold to hold or unhold the selected jobs. The status icon will change to
reflect the new hold status of the job (see figure).
Jobs with
held status
4.4.8 Deleting jobs

Jobs in the PrintMate web GUI can be deleted manually, as described below, or automatically by the system,
according to the specified auto-delete policy (see PrintMate settings, page 45).

To delete jobs:
2. From the Input, Output or Complete lists, select the jobs that you want to delete.
3. Click the Delete button, and then click OK to confirm your action.
When you delete a job that was submitted using a hot folder, the job file will be moved to the Completed or
Error folder in the hot folder, depending on whether the job completed successfully or not. It should be
noted that PrintMate never deletes job in hot folders; it is up to the user to manage these folders.
4.4.9 Keeping jobs from being deleted

The Keep option allows you to retain jobs in the Completed list that would normally be deleted by the sys-
tems auto-delete policy, if one is in operation (see, Job Auto-Destroy Policy, page 45). Kept jobs will not
be deleted until their keep status has been removed, using the Keep option again.
To keep/unkeep jobs:
2. From either the Output or Complete lists, select the jobs you want to keep.
3. Click the Keep button in the toolbar. The keep status icon will now appear beside the jobs. Click-
ing the Keep button again will unkeep the jobs and remove the keep status icon.
4.4.10 Viewing job history

For each job processed by PrintMate a record of processing is generated. To view this log, which contains
RIP processing history and job summary information, open the Job History window (see Figure 4.5), as fol-
lows.
2. Select the job whose job history you want to view.
3. Click the Job Info button in the toolbar.
4. In the Job Info window, click the Job History button to open the Job History window.

5. When closing the Job History window and Job Info window, you should use the Harlequin PrintMate
close button, rather than the Windows close button, as PrintMate will take longer to determine
that you have finished with the job.
Figure 4.5 The Job History window

Chapter 5 Troubleshooting PrintMate

PrintMate cannot be started, page 60.
PrintMate takes a long time to start, page 61.
Unable to connect to the PrintMate web server, page 61.
PrintMate closes without warning, page 62.
Roam is very slow when previewing jobs, page 63.
Some characters or graphics do not display correctly, page 64.
5.1 PrintMate cannot be started

Possible reasons why PrintMate may fail to start:
The port used by PrintMate (as specified during installation) is already being used. To specify a dif-
ferent port, amend the -port parameter in SWWebGUI.txt (see Configuration Files, page 66) or
reinstall. Ports 8080, 8082, 8084, 8086 and 8088 are all valid ports for PrintMate to use.
There is another application on port 9905 (SOAR name server) or nearby ports up to about 9940.
A license to start/connect to PrintMate is not available. Using the License Manager application
(installed at the same time as the RIP) check the status of your PrintMate licenses.
The RIP dongle is not present.
One or more of the configuration files in the all-all/config directory of the SOAR services contains
bad configuration information. For instance, the RIP will not start automatically if the
harlequinrip.txt file does not point to a usable RIP executable.
There are existing application state files and the IP address, host name and/or domain name of the
computer has changed. This should not happen in a standard installation, because it is configured
with localhost networking mode, where the state does not contain IP addresses or host names. But
an installation that has been reconfigured to use ip or fqdn networking mode can be affected. Reset-
ting the application to its default settings fixes this issue.
Also, check the PrintMate log files, logger.log and backup.log, for possible diagnostic information.
Depending on which operating system you are running, the log files are available at:
TROUBLESHOOTING PRINTMATE AG50563 REV. 3 INDEX CONTENTS 60

TROUBLESHOOTING PRINTMATE INDEX CONTENTS 61
Windows:
<installation dir>\SOAR\PrintProductionManager\<version>\<revision>\win_32-pentium\rel\
Mac OS X:
/Applications/ECRM WorkMates
/SOAR/PrintProductionManager/<version>/<revision>/macos_x-ub/rel/
5.2 PrintMate takes a long time to start

PrintMate may take a long time to start if backups have been enabled, by including -backup in the
persistence.txt (see page 67). To reduce the startup time, either reduce the amount of data there is to backup
by removing completed jobs efficiently (use the Job Auto-Destroy Policy to specify when jobs should be
removed, see page 45), or specify -noBackup so no backup is created. This second solution, however, will
reduce your ability to recover from an invalid shutdown should one occur.
5.3 Unable to connect to the PrintMate web server

The following checks may help resolve issues when connecting to the web server.
Server-side checks:
Check the PrintMate server has been started. On Windows, open your Task Manager
(CTRL+ALT+Delete) and confirm SWWebGUI.exe is running.
Check you have a PrintMate permit file installed. Use the License Manager application to list the
permits that are available on the server.
Check the port number that is being used by PrintMate isnt already being used. If necessary, amend
the -port parameter in the SWWebGUI.txt file (see Configuration Files, page 66), or reinstall
PrintMate. Ports 8080, 8082, 8084, 8086 and 8088 are all valid ports for PrintMate to use.
Check the firewall allows connections for SOAR, SWWebGUI and Roamserver.
Check your system has a default web browser. On Windows, choose Run from the Start Menu and
enter any web address. If a default browser has been set up, it should startup and connect to the
address you have entered.
To set Internet Explorer as the default browser, start it up and select the check box for Internet
Explorer should check to see whether it is the default browser in Tools > Options.
Client-side checks:
Check the address you have entered for the PrintMate web server is correct. It should be of the form:
http://<IP address|machine name>:<portnum>/soar/.
Check the IP address, machine name and port number are all accurate.
Check that JavaScript is enabled in your web browser.

Check that pop-up windows and session cookies are allowed in your web browser. It may help to
bypass the web proxy server when connecting. If you are unable to do this, set the web proxy so that
is does not serve stale pages.
Check that a valid PrintMate license is available. The permit supplied with PrintMate allows up to
five simultaneous connections only.
Check that your firewall or any other Internet security software you are running is not blocking com-
munications with the remote server. If you are using a dial-up internet connection, you may need to
configure your browser to never dial a connection.
5.4 PrintMate closes without warning

PrintMate can sometimes close without warning when Java runs out of memory, although this is rarely seen
in version 1.2 PrintMate. (In Harlequin Print Production Manager versions prior to 1.2 it may be necessary
to increase the Java memory heap if this issue occurs.)
5.4.1 How to increase Java memory in Windows

1. From the Windows Start menu navigate to the following program group:
Start > All Programs > Global Graphics > Harlequin Print Production Manager 1.2r0
2. In this group, right-click on Start Harlequin Print Production Manager 1.2r0 and choose Proper-
ties from the pop-up menu to open the Properties dialog.
3. In the Target field of the Properties dialog, append -Xmxnnm (where nn is the memory value) to the
line that is already there. For example, to set a value of 128 MB, the command would be:
"C:\Program Files\Harlequin\SOAR\PrintProductionManager\1.2r0\Development\win_32
-pentium\rel\SWWebGUI.exe -Xmx128m
4. Click OK when you have finished editing the Properties dialog.

5.4.2 How to increase Java memory in Mac OS X

1. Open a Terminal window.
2. Navigate to the PrintMate installation folder that contains SWWebGUI.app, for example:
cd /Applications/Harlequin/SOAR/PrintProductionManager/1.2/Development/
macos_x-ub/rel/
3. To increase Java memory to nn MB enter:
SWWebGUI.app/Contents/MacOS/javalauncher -Xmxnnm
4. Close the Terminal window and restart PrintMate.

To save entering these commands each time you run PrintMate, you may wish to create a shell script for
them instead.
5.5 Roam is very slow when previewing jobs

When you first open a job in Roam, Roam has to process the job before it can be previewed. Depending on
the size and nature of the job this initial processing can take a long time; several minutes in extreme cases.
However, once the job has been opened, you should find Roam is quite responsive and you will be able to
zoom and move around the job without too much lag.
To speed up the initial job previewing stage you should reduce the number of applications that are running
on your system, to ensure processing power isnt being diverted to other programs. Obviously the RIP has to
remain runningthe application will not be able to function otherwisebut you can reduce the RIPs pro-
cessing overhead by lowering its processing priority. To do this at install-time, select a lower processing pri-
ority in the Process Priority drop-down list (see diagram), or after install, you can change it by editing the
RIPExecPart configuration file (by default, this is called harlequinrip.txt) or by using the SOAR Control
ripExec command.
Figure 5.1 Installation dialog box showing location of processor priority setting

5.6 Some characters or graphics do not display correctly

If your browser is configured to a locale other than English, you may find some issues with the display,
whereby some icons are replaced by text or look different depending on the browser. To correct this, config-
ure a list of locale preferences. In Internet Explorer the option is under Tools > Internet Options > General
> Languages.
Note: In your default web browser, make sure that English (for example, en_US or en_GB) locale is one of
the preferences. Note: English does not have to be the first preference, but it must appear in the list.


Appendix A Configuration Files
PrintMate uses various configuration files for setting application parameters. You may find the information
in this section useful when customizing the applications default behavior.
A.1 Location of configuration files

The configuration files used by PrintMate can be found in the following location:
all\all\config
A.2 swwebgui.txt
The swwebgui.txt file allows you to specify the following startup parameters and options for the
Harlequin PPM web GUI.
-port n Configures the web server port used to communicate with PrintMate.
The default setting, as specified in the installer, is 8080. If this port is
already being used, try 8082, 8084, 8086 or 8088 instead.
-startBrowser/-noBrowser Controls whether the web browser automatically starts when PrintMate
is launched. After starting, the web browser attempts to communicate
with the web server on the port specified by -port.
-context Specifies the Web server context (the base of the Web GUI application
URL).
-base Specifies the base directory for the web server. A base directory is
<customization_folder> needed if customization of the PrintMateweb GUI is to be done. See
PrintMate Customization Guide.
CONFIGURATION FILES AG50563 REV. 3 INDEX CONTENTS 66

CONFIGURATION FILES INDEX CONTENTS 67
A.3 Persistence.txt
The persistence.txt file contains the following configuration options for the application state data created
when setting up channels and processing jobs. This information is saved to the State directory.
-backup/-noBackup Determines whether a backup file of the application state data (effec-
tively a backup of the State directory) is taken when the application
starts-up. -backup is specified by default.
Depending on how much data there is to backup, PrintMate can take a
long time to start and consume a large amount of disk space when -
backup is specified. However, it will allow you to return to a known
good state, should the data become corrupt.
-minFreeDiskInM nn Specifies the minimum free disk space (in megabytes) required before
the application is allowed to start-up. It should be noted that this parame-
ter is independent of the disk space monitoring facility that is used to
suspend workflow when disk space is low disk.
-sentinelAction abort Specifies the course of action to take should an invalid shutdown be
| log | restore | reset detected. The default setting is ask.
| ask The following options are available:
abort: Startup is aborted.
log: Startup as normal and note in logger.log that an invalid shut-
down has been detected. Caution should be exercised when using this
option, since it ignores the potential corruption of your application state
data.
restore: Uses the backup file, created with the -backup option, to
restore the application state data files on startup.
reset: Resets PrintMate back to its default setting.
ask: Opens a dialog box that allows you choose which action abort,
log, restore or reset to take when an invalid shutdown has been
detected. This is the default setting.
CONFIGURATION FILES AG50563 REV. 3 INDEX CONTENTS 67

PrintMate Op Guide

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

PrintMate Op Guide

Încărcat de

Drepturi de autor:

Formate disponibile

ECRM PrintMate

(Print Production Manager)

COPYRIGHT AND TRADEMARKS

AG50563 REV. 3 INDEX CONTENTS  2 

Chapter 2 Installing and Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Chapter 3 A Brief Tour of the

AG50563 REV. 3 INDEX CONTENTS  3 

The Print toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Chapter 4 Using PrintMate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Chapter 5 Troubleshooting PrintMate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

AG50563 REV. 3 INDEX CONTENTS  4 

Appendix A Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

AG50563 REV. 3 INDEX CONTENTS  5 

This chapter includes sections on the following topics:

1.1 What is PrintMate?

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  6 

Job view Job info Job logs

Figure 1.1 Job control and process monitoring with PrintMate

PrintMate features include:

1.2 Supported file types

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  7 

1.2.1 Restrictions on TIFF/IT-P1 files

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  8 

1.3 Running PrintMate on Windows

RIP RIP Genesis Release 7.2 (security dongle required)

Monitor 1024 x 768 resolution or better

Table 1.1 PPM requirements for Windows

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  9 

1.4 Running PrintMate on Mac OS X

Browser Apple Safari 1.2/1.3/2.0

RIP Harlequin RIP Genesis Release 7.2 (security dongle required)

Monitor 1024 x 768 resolution or better

Table 1.2 PrintMate requirements for Mac OS X

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  10 

1.5 PrintMate user accounts.

User name User icon Permitted actions

viewer access PrintMate web GUI

user same as viewer, plus:

admin same as user and viewer, plus:

Table 1.3 Default accounts

Refer to the PPM Customization Guide for details on setting up users.

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  11 

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS  12 

This chapter includes sections on the following topics:

2.1 Before you install PrintMate Pre-installation checks

2.1.1 RIP pre-installation checks

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS  13 

2.1.2 Web browser pre-installation checks

2.1.3 Firewall pre-installation checks

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS  14 

2.2 Installing PrintMate

2.3 Adding the PrintMate permit file

Figure 2.1 Opening the License Manager

On Mac OS X, choose /Library/Application Support/Global Graphics Software/License

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS  15 

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS  16 

2.4 Installing the PrintMate printer

2.4.1 Installing the printer on a Mac OS X server

2.4.2 Installing the printer on a Windows server

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS  17 

2.5 Starting PrintMate

2.5.1 Starting PrintMate in Windows

Figure 2.3 Selecting Workmates Administrator

3. The WorkMates Admin screen opens.

AG50563 REV. 3 INDEX CONTENTS 2

AG50563 REV. 3 INDEX CONTENTS 3

AG50563 REV. 3 INDEX CONTENTS 4

AG50563 REV. 3 INDEX CONTENTS 5

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 6

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 7

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 8

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 9

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 10

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 11

INTRODUCTION AG50563 REV. 3 INDEX CONTENTS 12

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 13

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 14

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 15

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 16

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 17

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 18

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 19

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 20

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 21

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 22

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 23

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 24

INSTALLING AND RUNNING AG50563 REV. 3 INDEX CONTENTS 25