paris spooler technical manual - product support and...

T H E P A R I S S P O O L E R T E C H N I C A L M A N U A L

Contents

The Paris Spooler Technical Manual 2

© 1997 XLPrint/Laser Image Technologies Pty. Limited. All rights reserved. This work is copyright. This manual and its accompanying software may not be reproduced by any means, mechanical, electronic or otherwise, without the prior agreement and written consent of XLPrint Pty. Limited or an appointed representative.

The Paris Spooler Technical Manual First published, December 1996 Reprinted 1997 Second edition, 1998 Reprinted with revisions, August 1998 Third edition, May 1999 Fourth edition, August, 1999 CD-ROM edition, March 2000 Version 3 CD-ROM Edition, March 2001

Paris Spooler is an XLPrint Software product. Paris is a trademark of XLPrint Pty. Limited, Sydney, Australia

This document may contain or refer to information and products protected by copyright or patents and does not convey any license under the patent rights of XLPrint Pty. Limited nor the rights of others. All product names used in this manual are trademarks of their respective owners.

The information in this document is provided for reference only. Names and data used in examples are fictitious and are provided for explanatory purposes only.

Written and produced by XLPrint Pty. Limited, Suite 401, 220 Pacific Highway, Crows Nest, Sydney, NSW, 2065, Australia.


TAB LE O F CO N T E NT S

AB O U T T H I S MA N U A L 13

SYMBOLS USED IN THIS MANUAL 13

PA R T ON E: IN T R O D U C T I ON T O T H E PA R I S SP O OL ER 15

FEATURES OF THE PARIS SPOOLER SYSTEM .............................................. 15

TH E O R Y O F OP E R A T I O N 16

PARIS SPOOLER START-UP DIALOGS 17

The Paris Spooler Control Panel ...................................................... 18

Buttons in the Spooler Task Bar................................................................. 19

THE PARIS ENGINE DIALOG................................................................... 21

PA R T TW O: SET T I N G U P T H E PA R I S SP O OL ER 23

CH A P T E R 1 : PR I N T E R DE F I N I T I O N S 24

ADDING A PRINTER DEFINITION 25

DEFINING PRINTER ATTRIBUTES ............................................................ 26

Printer Name.............................................................................................. 26

Printer Type................................................................................................ 27

Contents


Rebuilding the Printer Type List.................................................................29

Defining the Output destination................................................................30

Using NEXTFILE as the output destination.................................................31

Setting the Printer Priority..........................................................................35

PRINTER RESOURCES........................................................................... 36

How Paris manages printer resources .......................................................36

XPD Graphics Compression commands ....................................................40

Using XPD Graphics Compression commands..........................................40

Updating Resources ...................................................................................41

Resetting Resources ...................................................................................43

Media Mapping ..........................................................................................44

PHYSICAL PAGE SHIFT ......................................................................... 45

SCHEDULING A PRINTER ...................................................................... 46

SAVING THE PRINTER DEFINITION ......................................................... 47

SPD Files.....................................................................................................47

MODIFYING A PRINTER DEFINITION 48

DELETING A PRINTER DEFINITION 49

SETTING THE PRINTER STATUS 50

FLUSHING THE PRINT JOBS FROM A PRINTER 51

ADDING A PRINTER POOL 52

ADDING A PRINTER POOL .................................................................... 53

Adding a printer to the pool....................................................................... 53

Contents


Scheduling a printer pool........................................................................... 54

Editing a Printer Pool ................................................................................. 55

Deleting a Printer Pool............................................................................... 55

CH A P T E R 2 : JO B DE F I N I T I O N S 56

SJD Files (Spooler Job Definition files) ...................................................... 56

ADDING A JOB DEFINITION 57

JOB DEFINITION NAME........................................................................ 58

DEFINING THE INPUT SOURCE FOR A JOB DEFINITION .............................. 59

OVERVIEW OF ‘DIRECTORY’ AS THE INPUT SOURCE .................................. 60

How the Spooler polls Directories for Input Data..................................... 60

Changing File Attributes ............................................................................ 62

DEFINING DIRECTORY AS THE INPUT SOURCE.......................................... 63

Defining the directory search path ............................................................ 63

Defining the directory search settings....................................................... 64

OVERVIEW OF ‘NOVELL QUEUE’ AS THE INPUT SOURCE ............................. 65

Creating Novell Queues to use with Paris ................................................. 65

Using Novell Print Queues with Paris ....................................................... 75

DEFINING NOVELL QUEUE AS THE INPUT SOURCE .................................... 77

OVERVIEW OF USING SERIAL AS THE INPUT SOURCE .................................. 78

Understanding Serial Communications..................................................... 78

DEFINING SERIAL AS THE INPUT SOURCE................................................. 83

OVERVIEW OF USING THE PARIS PORT MONITOR AS THE INPUT SOURCE ...... 85

The role of Print Providers......................................................................... 85

CONFIGURING YOUR PARIS PORT MONITOR ........................................... 87

I. Install the Paris Port Monitor .............................................................. 87

II. Create a Job Definition with the Port Monitor as the Input Source..........................................................................................89

Contents


III. Set up a Windows printer ....................................................................91

Deleting the Paris Port Monitor: ................................................................94

OVERVIEW OF USING LPR/LPD SERVER AS THE INPUT SOURCE ................... 95

What is an LPD? .........................................................................................95

DEFINING LPD SERVER AS THE INPUT SOURCE ........................................ 96

Creating a Job Definition with LPD as the Input Source............................97

PARIS AND LPR CONTROL FILE PROCESSING ........................................... 99

How Paris reads an LPR Control File..........................................................99

How the Spooler uses the information from the Control file ....100

How the Paris Engine uses entries from an LPR Control file .....101

Windows NT LPR......................................................................................102

DEFINING THE POLLING INTERVAL FOR SEARCHING AN INPUT SOURCE ....... 103

HOLDING NEW JOBS ........................................................................ 104

PREPROCESSES IN A JOB DEFINITION ................................................... 105

ADDING A PREPROCESS TO A JOB DEFINITION....................................... 106

ENVIRONMENT FILE IN A JOB DEFINITION ............................................. 107

General methods by which Paris selects environments...................107

SELECTING AN ENVIRONMENT FILE FOR THE JOB DEFINITION ................... 109

If Input Source is Directory… ..................................................................109

If the Input Source is Novell Queue….....................................................110

If the Input Source is LPD Server…..........................................................112

SELECTING THE OUTPUT OPTIONS FOR THE JOB DEFINITION ................... 113

Adding the printer(s) to the list ................................................................ 113

Adding a printer to the list when Novell Queue is the input source .......114

Appending small print jobs into a single large job ..................................115

Splitting the files in a print job.................................................................116

Specifying the number of copies to be printed for a selected printer .....117

MODIFYING A JOB DEFINITION 118

Contents


DELETING A JOB DEFINITION .............................................................. 119

CH A P T E R 3 : EN G I N E DE F I N I T I O N S 120

HOW THE SPOOLER MANAGES MULTIPLE ENGINES ................................... 120

HOW MANY ENGINES CAN BE ADDED AND LAUNCHED? ............................ 120

LINKING AN ENGINE TO A PRINTER ...................................................... 120

ADDING AN ENGINE .......................................................................... 121

Options .................................................................................................... 122

Printers..................................................................................................... 123

LAUNCHING AN ENGINE ..................................................................... 124

EDITING AN ENGINE .......................................................................... 125

DELETING AN ENGINE ........................................................................ 126

CH A P T E R 4 : TH E S P O O L E R UT I L I T I E S 127

THE RESOURCE MANAGER 128

HOW DOES RESOURCE PACKING WORK?............................................... 129

PACKING RESOURCES ........................................................................ 130

SETTING THE PACKER OPTIONS ........................................................... 131

PACKING FILES ................................................................................. 133

UNPACKING RESOURCES .................................................................... 136

FAQS AND TROUBLESHOOTING .......................................................... 138

THE EURO RATES UTILITY 141

ACCESS LEVELS IN THE EURO RATES UTILITY........................................... 142

View Conversion Rates............................................................................. 143

View Fixed Rates, Edit Variable Rates ...................................................... 143

Edit Any Rate ............................................................................................ 143

Contents


Defining the attributes for a Variable Conversion Rate...........................144

Viewing Conversion Rates........................................................................146

Viewing Fixed Rates, Adding or Editing Variable Rates............................147

Editing Any Rate .......................................................................................149

ACCOUNTING UTILITY 152

WHAT IS THE NORMAL FLOW OF JOBS? ................................................ 152

WHAT DOES THE ACCOUNTING UTILITY ENABLE ME TO DO? .................... 153

STARTING THE ACCOUNTING UTILITY .................................................. 154

Selecting the Display Filters .....................................................................155

Displaying the Accounting Information after the filters have been selected.....................................................................................................157

Viewing the Accounting Info items ..........................................................158

Sorting the Accounting Info items............................................................158

Clearing the Accounting Info....................................................................158

Backing up Accounting Info......................................................................159

Exporting Accounting Info into an XML File.............................................159

PA R T TH RE E: JO B CO N T R O L A N D PR OC E SS I N G 161

CH A P T E R 5: JO B CO N T R O L 162

PAUSING, RESTARTING, HOLDING AND RELEASING A JOB 163

PAUSING A JOB ................................................................................ 163

RESTARTING A JOB ........................................................................... 164

HOLDING A JOB............................................................................... 165

RELEASING A JOB.............................................................................. 166

DELETING A JOB............................................................................... 166

Contents


CONTROLLING MULTIPLE JOBS ............................................................ 167

Selecting a list of jobs .............................................................................. 167

Selecting individual jobs in a list ............................................................. 168

PAPER AND PAGE CONTROL 169

MOVING FORWARD IN A JOB .............................................................. 169

SAMPLING A PAGE............................................................................. 169

MOVING A PRINT JOB TO THE FRONT OF THE QUEUE............................... 170

CH A P T E R 6 : SINGLE JOB OR BATCH MODE PROCESSING 171

SINGLE SPOOLER JOB REQUEST ........................................................... 171

PREPROCESSING IN A JOB REQUEST...................................................... 171

ADDING A SINGLE JOB 172

ENTERING THE INPUT INFORMATION.................................................... 172

ADDING A PREPROCESS TO A JOB REQUEST ........................................... 173

ENTERING THE OUTPUT OPTIONS ....................................................... 174

SPECIFYING THE PAGE RANGE ............................................................. 176

EDITING A SINGLE JOB ....................................................................... 177

DELETING A JOB REQUEST .................................................................. 178

FLUSHING THE PRINT JOBS FROM A PRINTER .......................................... 179

PA R T FOUR: SP OO L ER SY ST EM SE T T I N GS AN D SP OO L ER CO N T R O L 181

CH A P T E R 7 : S Y S T E M S E T T I N G S 182

SPECIFYING THE INTERVAL FOR VERIFICATION OF THE ENGINE

CONNECTION 182

Contents


SETTING THE DATE AND TIME FORMAT 183

DATE FORMAT ................................................................................. 183

TIME FORMAT ................................................................................. 184

CREATING A LOG FILE FOR THE PRINT JOBS AS THEY ARE PROCESSED 185

CH A P T E R 8: SP O O LE R CO N T R O L 186

STARTING THE SPOOLER WITHOUT DOWNLOADED PRINT JOBS BEING

PROCESSED 186

PAUSING THE SPOOLER 187

DISPLAYING THE LPD SERVER INFORMATION 188

LPD LOG ....................................................................................... 188

DISPLAYING THE LPD LOG ................................................................ 188

LPD SERVER SETTINGS 189

SETTINGS OPTIONS........................................................................... 189

BYPASS SPOOLER OPTION .................................................................. 189

DEFINING LPD SERVER SETTINGS........................................................ 190

Settings ..................................................................................................... 190

EXITING THE SPOOLER 192

AP P E N D I X A : MO D I F Y I N G T H E CH A R A C T E R S E LE C T I O N TA B L E 194

WHY CONTROL THE NUMBER OF CHARACTERS? ..................................... 194

MODIFYING THE CHARACTER SET ........................................................ 195

Contents


AP P E N D I X B : US I N G T H E M E D I A MA P P I N G F U N C T I O N 197

MEDIA MAPPING OVERVIEW 197

SETTING UP MEDIA MAPPING 198

ADDING ‘*XLPINPUTMEDIA’ STATEMENTS ............................................ 198

SETTING UP MEDIA MAPPING FOR AN ENVIRONMENT.............................. 199

AP P E N D I X C: MO D I F Y I N G PA R I S JO B T I C K E T S 209

JOB TICKET STRUCTURE 209

RECORD STRUCTURE ......................................................................... 209

THE PARIS JOB TICKET STRUCTURE 210

HOW ARE JOB TICKETS ENABLED IN PARIS? 211

PARIS XPD FILES .............................................................................. 211

XPD STATEMENTS IN XPD FILES .......................................................... 212

MODIFYING A JOB TICKET 213

MODIFYING A JOB TICKET VIA THE XPD FILE ......................................... 213

JOB TICKETS AND LPR CONTROL FILES ................................................ 214

AP P E N D I X D: DE V I C E S P E C I F I C F E A T U R E S I N T H E PA R I S S Y S T E M 216

USING DEVICE SPECIFIC FEATURES 217

Contents


IMPLEMENTATION OF THE DEVICE SPECIFIC FEATURE .............................. 217

Currently defined hooks...........................................................................218

SELECTING A DEVICE SPECIFIC FEATURE 220

1. ENVIRONMENT OUTPUT ................................................................ 220

2. ENVIRONMENT EVENTS ................................................................. 221

3. RUN TIME EVENTS ....................................................................... 221

EXAMPLE OF AN XPD FILE USING DEVICE SPECIFIC FEATURES 222

USING THE ENVIRONMENT OUTPUT OPTION TO SELECT A FEATURE ........... 223

USING THE ENVIRONMENT EVENTS OPTION TO SELECT A DEVICE SPECIFIC FEATURE ......................................................................................... 224

AP P E N D I X E : US I N G PR E P R O C E S S E S I N T H E S P O O L E R 226

What is a Preprocess and how is it defined in the Spooler?....................226

What is defined in a Preprocess? .............................................................227

Adding a Preprocess to the Spooler .........................................................230

How does the Spooler make Command line parameter substitutions? ..231

Important points to know about using Preprocesses ..............................232

Example of how to run an application as a Preprocess............................233

Adding Preprocessing tasks to a Job Definition.......................................234

IN D E X 242

13 The Paris Spooler Technical Manual

A B O U T T H I S M A N U A L

This manual describes the use of the Paris Spooler system and is to be used in conjunction with the Paris Designer User’s Manual and the Paris Designer Reference Manual.

SY M B O LS U SED I N T H I S M A N UA L

Symbols will appear regularly in the text or in the column adjacent to the text to mark special information that supplements the textual theme or topic.

The symbols may flag additional information such as suggestions, advice or warnings or may be an illustration of the topic of the text (for example, a tool button in the ToolBox, a mouse or keyboard).

The symbols used in this manual are as follows:

! NOTE: This symbol indicates information supplementary to the current text.

"""" TIP: This symbol indicates a practical hint.

#### WARNING! This symbol is to draw your attention to a significant item or topic.

PART ONE INTRODUCTION TO THE PARIS SPOOLER

INTRODUCTION

THEORY OF OPERATION

THE PARIS SPOOLER CONTROL PANEL

THE PARIS ENGINE


Part One I N T R O D U C T I O N TO T H E PA R I S S P O O L E R

The Paris Spooler is at the heart of the Paris Document Management System. It has the dual responsibilities of directing the flow of data through the system and ensuring that the correct set of formatting rules are used for each job by passing instructions to the Paris formatting engines.

The role of a Paris Engine is to accept instruction from the Spooler as to where to find its input, what rules to use for processing, what printer to format for and ultimately, where to send the output.

The Spooler is fundamentally a messaging system. It does not actually perform print formatting tasks, the engine has this responsibility. The Spooler passes processing instructions to the engines and responds to messages sent back from the engines.

FEA T U R E S OF T H E PA R I S SP O OL ER SY ST E M

The Paris Spooler system is a genuinely network-oriented method of processing business documents based on your host or within your network.

Hundreds of different input queues can be monitored and up to 512 printers can be managed on a network, together with intervention free document formatting and delivery.

The ability to add multiple engines to the Spooler provides the concurrent processing and delivery of documents, therefore a higher throughput in the order of 5000 ppm or more.

The Spooler system also provides options for the definition of additional input sources (LPD and Port Monitor) and preprocessors. Support for reading the contents of the Control file


T H E O R Y O F O P E R AT I O N

The Spooler is essentially a ‘printer-centric’ system, that is, the main view and operation of the system is by printer (or destination). Up to 512 different printers can be defined and serviced by a single execution of the Spooler. Jobs are in turn defined and allocated to a printer.

For example:

• The invoice, statement and remittance jobs might be directed to a printer called ‘Printer2’ which is located in the Accounts Department.

• Delivery dockets and stock reports might be directed to a printer called ‘Printer3’ which is located in the Warehouse.

• If the Printer2 printer is highlighted the Spooler will display all the jobs queued or processing for that printer.

Being at the ‘production end’ of the Paris Document Management System, the Spooler is intended to be setup then left to perform its duties. It acts as a print server controlling the flow of information between the host and the target printers.


PA R I S S P O O L E R S TA R T-U P D I A LO G S

When the Spooler is started, it automatically locates and starts a formatting Engine and is ready for processing. This means that in normal operation you will have the Paris Spooler Control Panel open on your screen and the Paris Engine icon will appear in your Status Bar, on the right.

As the Paris Spooler is capable of launching and managing multiple formatting engines, any additional engines set to automatically launch at start-up will also be displayed. Refer to Chapter 3, Engine Definitions.

Both the Spooler and the Engine dialogs can be re-sized and re-positioned. Their size and position is remembered when the program is shut down.

Introduction to the Paris Spooler


TH E PA R I S SP O O LE R CO N T R OL PA N EL

The Paris Spooler control panel is deliberately designed to be similar to other operating system print spoolers. The intent is to provide a simple, clean and familiar interface containing all the necessary information on the status of the printing task.

The Control Panel is divided into upper and lower panes.

• For each printer that has been defined in the Spooler, the upper pane of the control panel displays information on the printer setup. [1]

• Selecting a printer in the upper pane will display each print job defined for the printer in the lower pane. [2]

• An online printer or print job is displayed in BLACK. An offline printer or print job is displayed in GREY. [3]

• The width of each column in the control panel can be resized by clicking and holding on the vertical bar and moving the bar to the left or right as required. [4]

• The upper and lower panes can be resized by clicking and holding on the horizontal bar and moving the bar up or down as required. [5]

• The Status Bar shows the current status of the Spooler, LPD Server, Engine(s) and Preprocess. [6]

The Paris Spooler Control Panel

2

1

4

5

6

3


The PARIS Spooler Technical Manual 19 19

Buttons in the Spooler Task Bar

In the Spooler Control Panel below the menus is the Spooler Task Bar. The bar contains buttons that allow you to access common tasks. If you move the mouse pointer over the task button, the function of the button is displayed in the Status Bar.

Viewing the task bar from the left, the Task Buttons in order are:

1. View and Edit Spooler Settings

Selecting this button will display the System Settings dialog. Refer to ‘System Settings’ on page 182.

2. Make printer online/offline

Selecting this button will change a selected printer to online or offline, depending on the current status.

3. View/Change Printer settings

Selecting this button will display the View/Change Printer dialog for the currently selected printer. Refer to ‘Modifying a Printer Definition’ on page 48.

4. Add a new Printer

Selecting this button will display the View/Change Printer dialog for the addition of a new printer. Refer to ‘Adding a Printer Definition’ on page 25.

5. Delete the current Printer

Selecting this button will display a box requesting confirmation to delete the currently selected printer. Refer to ‘Deleting a Printer Definition’ on page 49.

6. Change the status of the current job

Selecting this button will pause or resume a selected print job depending on the current status.



7. View/Change the settings for the current Job

Selecting this button will display the View/Change Job Request Settings dialog for the selected job. Refer to ‘Editing a single job’on page 177.

8. Add a new job to the current Printer queue

Selecting this button will display the Add Job Request Settings dialog. Refer to ‘Adding a single job’ on page 172.

9. Delete the current Job

Selecting this button will display a box requesting confirmation to delete the currently selected print job. Refer to ‘Deleting a Job’ on page 166.


The PARIS Spooler Technical Manual 21 21

TH E PA RI S EN G I N E D I A LO G

When the Spooler is started, it automatically locates and starts a formatting Engine (and any additional engines) and is ready for processing.

The print formatting engines are displayed as an icon in the lower right corner of the status bar as an image of a printer overlaid with a 'P'.

Whereas the Paris Spooler control panel provides a summary of the printer setup and print jobs, the Paris Engine dialog displays in detail what is actually happening during the printing process. It lists each job as it starts, the downloading of fonts and images and reports any error conditions that occur on the printer.

The Paris Engine dialog

PART TWO SETTING UP THE PARIS SPOOLER

CHAPTER 1: PRINTER DEFINITIONS

$ ADDING A PRINTER DEFINITION

$ MODIFYING A PRINTER DEFINITION

$ DELETING A PRINTER DEFINITION

$ PRINTER STATUS

CHAPTER 2: JOB DEFINITIONS

$ ADDING A JOB DEFINITION

$ MODIFYING A JOB DEFINITION

$ DELETING A JOB DEFINITION

CHAPTER 3: ENGINE DEFINITIONS

$ HOW THE SPOOLER MANAGES MULTIPLE ENGINES

$ ADDING, LAUNCHING AND EDITING AN ENGINE

$ DELETING AN ENGINE


Part Two S E T T I N G U P T H E PA R I S S P O O L E R

To allow the Spooler to perform its dual tasks of flow control and delivering instructions to the engine, it must first be setup correctly. The setup is at two basic levels.

First, the printers must be defined and second, the instructions for the individual jobs must be defined.

Printer functions are defined via the View/Change Printer dialog and job functions are defined via the Job Definition Settings dialog.

Once the printer and the jobs definitions have been setup and the Spooler is started, it searches for an available engine, fires up the engine then sends full processing instructions to the engine.

24 The PARIS Spooler32 Technical Manual

Chapter 1

PR I N T E R DE F I N I T I O N S

Printers are defined by the same methods as those used in the Paris Designer system.

New printers can be added or existing printers modified via the Printers/Pools menu in the Menu Bar.

•••• An added printer can be set online by selecting the ‘Online’ from the Printers menu.

•••• All the jobs defined for a printer can be ‘flushed’ from the printer by using the ‘Flush’ option.

•••• Selecting the ‘Add Printer’ option will display the View/Change Printer dialog to add a printer.

•••• Selecting the ‘Add Pool’ option will display the Printer Pool dialog for the creation of a printer pool.

•••• Selecting an added printer from the control panel and then the ‘Settings’ option will display the settings for the selected printer in the View/Change Printer dialog.

•••• Selecting an added printer from the control panel and then the ‘Delete’ option will display a Request dialog to delete the printer definition.

Options in the Printers/Pools menu.


A D D I N G A PR I N T E R D E F I N I T I O N

When the Spooler is first installed a default printer is supplied. To add a new printer, click on the Add option in the Printers/Pools menu. The View/Change Printer dialog will be displayed.

The dialog is divided into the following sections:

&&&& Printer,

&&&& Resources,

&&&& Physical Page Shift,

&&&& Scheduling

Chapter 1


DE F I N I N G PR I N T E R AT T R I B U T E S

The Printer section of the View/Change Printers dialog deals with the printer attributes that are displayed in the Paris Spooler control panel. The first thing to do is to name the printer.

Printer Name

A printer is given a ‘File Name’ and a ‘Full Name’ and each is entered in the relevant box in the View/Change Printer dialog.

The ‘File Name’ (default setting NEWPRT) is used to identify the printer in the Spooler system and must be a valid DOS filename, up to 8 characters and must also be unique.

For example ACCNTL3

The ‘Full Name’ is displayed in the ‘Printer’ column in the Paris Spooler control panel. The default setting is NEW_PRINTER

Up to 16 characters can be used. Spaces are allowed.

For example: Accounts Level3

! NOTE: Both names must be entered.

Printer Name in the Spooler Control Panel

Printer Definitions


Printer Type

The printer ‘Type’ refers to the physical printer to which the Spooler will direct the formatted output file.

Printer Type in the Paris Spooler control panel

The printer type is displayed in the Type column in the Paris Spooler control panel and is selected from the ‘Type’ drop-down list in the View/Change Printers dialog.

The printers available in the list vary according to the configuration of the PC on which the Spooler is running. Usually the list is broken into three general types differentiated by small graphic symbols as follows:

• HP-PCL type printers, indicated by the BLUE HP symbol. • Adobe Postscript printers, indicated by the RED stylized Adobe ‘A’. • Available Windows devices, indicated by the Windows symbol.

Printer Type List

The printers displayed in the list are a result of two searches the software performs:

1. The software checks the /PARIS/PRT directory to see what XPD (XLPrint Printer Description) files are present.

2. The software queries Windows as to what printer (or device) drivers have been loaded. This allows the Spooler to format for any Windows GDI supported device, for example Fax drivers or PDF drivers.

HP Symbol

Adobe ‘A’

Windows Symbol

Printer Type

Chapter 1


About XPD Files XPD files are the way Paris describes the features of the printer. They work either as standalone files, in the case of HP-PCL printers, or in combination with PPD (Postscript Printer Description) files, in the case of Adobe Postscript printers. In general terms XPD files are created and supplied by your distributor. PPD files are those files supplied by the Printer manufacturer. An XPD for a PostScript printer simply contains a reference to include a corresponding PPD file in the XPD.

! NOTE: XPD files contain command options to manage printer resources. These options enable you to tailor Paris resource management for the particular requirements of your printer. Refer to the section ‘XPD Resource Management Commands for PCL and PostScript printers’ on page 38. Refer also to Appendix D ‘Using Device Specific Features’ of this manual regarding adding a feature code to an XPD file. # WARNING! Both XPD and PPD files are text files and can be edited using a standard text editor, however, it is recommended that these should NOT be changed except by experienced users or under instructions from the distributor. A full description of the working of XPD and PPD files can be found in ‘How do XPD and PPD files work?’ in Chapter One of the Paris Designer Reference Manual.

Windows GDI supported devices

When using GDI to print there are important points to be considered. Firstly, GDI was not really designed as a production printing method. As a result, it is not optimized for speed and can struggle to keep up with high speed printers. Secondly, when using GDI, Paris is passing responsibility for the final output over to Windows and in turn the manufacturer supplied GDI driver. As a result, the outcome cannot be guaranteed to print exactly as intended. There could be font substitutions or incomplete support for some of the Paris features, because the printer is incapable of imaging the page as originally designed.

Printer Definitions


Rebuilding the Printer Type List

Paris maintains a list of available printers. It is this list that contains the PCL and Adobe printer entries that are shown in the Printer Type drop-down menu.

As described on the previous page, this list is a result of two searches the software performs. This list must be kept up-to-date as the number of printer types supported by Paris will constantly grow as new printers are released on the market. That is the purpose of the Rebuild Printer List button that is within the View/Change Printer dialog.

'''' To support the features of a new printer: 1. Place the distributor supplied XPD and\or PPD file in the PARIS/PRT

directory. 2. Once the new files have been added, click on the Rebuild Printer List button to

make the printer available to the software. Selecting the button causes the software to scan the directory and update the list with any new entries. If no new XPD\PPD files have been added the existing list will not be changed.

2. Click on the Rebuild Printer List button to make added XPD or PPD files available to the software.

Chapter 1


Defining the Output destination

Part of the printer definition is to instruct the software where to send the output once it has been formatted.

Output can be directed to a physical port, Novell Queue, Windows defined printer or disk file.

If printing to a Windows defined printer, this can in turn be mapped to a TCP/IP address, a physical port (e.g. LPT2), a Novell Queue or a disk file.

! NOTE: If you are printing to a Windows defined printer, you must ensure that: 1. The driver selected for the printer is Generic Text Only. 2. The Print Processor for the printer is winprint and RAW (Windows NT) or the Spooler Setting for the printer is RAW (Windows 95).

The output destination is entered in the ‘Output To’ text box. For example, the name of the Novell Queue or the destination drive, directory and file name if to a disk file.

The output destination for a printer is displayed in the ‘Output’ column in the Paris Spooler control panel.

Printer Output destinations in the Paris Spooler control panel

Printer Definitions


Using NEXTFILE as the output destination

NEXTFILE is a special Paris keyword specified when the system is required to direct its output to a series of files on disk. NEXTFILE allows a file name or extension to be incremented to avoid overwriting previous files.

NEXTFILE settings are printer bound, not global.

! NOTE: File splitting is specified at job level and is described under Splitting Files in a print job in Chapter 2, of this manual.

'''' To define the NEXTFILE settings: 1. Enter the keyword NEXTFILE in the printer Output To box. The Settings

button to the immediate right will become available.

2. Click on the Settings button to display the View/Change Next File Settings dialog.

Chapter 1


Settings

Under the Settings section of the dialog are the text fields Output directory; Output Name; Output extension. Next to each text field is a drop-down menu which lists the options that can be used for the Output directory, file name or file extension (each menu is the same for each output setting).

Output directory

In the Output Directory text field, specify the directory to which you want the files to be written, or select a name from the drop-down menu.

Output name

In the Output Name text field, either type in the name of the file required, or choose a name from the menu.

•••• The entries <@INPUT> or <INPUT> are equally valid. Either passes the name

of the input file through to output and applies to disk based input only.

•••• <fieldname> where a field name is entered in the angled brackets, uses the contents of the nominated field for the output file name,

•••• The LPR control file can be scanned and any of the following entries can be extracted and used for the output filename:

- <@LPR_HOST> - <@LPR_USER> - <@LPR_CLASS> - <@LPR_JOB> - <@LPR_INPUT> - <@LPR_INPUT_PATH> - <@LPR_INPUT_NAME_ - <@LPR_INPUT_EXTN> - <@LPR_TITLE>

Printer Definitions


Output extension

In the Output extension text field, either type in the name of the file required, or choose a name from the menu (as above)

Once the filename and extension are specified you can choose to increment either of them.

Maximum File Number

In the Maximum File Number text field, enter the maximum file number required.

Appending the Number to the file name or extension

Append the Number to ‘Name’ To increment the file name, select the Append Number to ‘Name’ checkbox.

For example, as per the dialog above, the resultant files would be PRINT001.OUT, PRINT002.OUT and so on.

Chapter 1


Append Number to ‘Extension’ To increment the file extension, select the Append Number to ‘Extension’ checkbox.

For example, as per the dialog above the resultant files with be PRINT.001, PRINT.002, PRINT.003 and so on.

Retaining the input file name and number for the output file

To retain the input file name and number, the character string <input> can be entered in both the Output Name and Extension text fields.

! NOTE: <input> can also be entered as the Directory name, however this would result in the overwriting of the input files by the output files and should only be used with caution.

Printer Definitions


Setting the Printer Priority

A priority can be assigned to the printer which is displayed in the Priority column in the Spooler control panel.

The printer priority number is entered in the ‘Priority’ box and can range between 1 and 99. The lower the number, the higher the priority. This allows the system to be configured in such a way that urgent printing (for example, dispatch notes for the warehouse) can always take priority over printing for other users.

‘Priority’ box

Chapter 1


PR I N T E R RE SO UR C E S

The Resources section of the View/Change Printers dialog deals with printer resource management. (The Id number is the internal identifier used by Paris for that set of printer resources and cannot be edited.)

How Paris manages printer resources

Resource management, the downloading of fonts, forms and graphics to the printer, is automatically controlled by Paris, but varies according to the capabilities of the device and Page Description Language (PDL) being used.

There are four general levels of resource management:

I. Printers with permanent storage available. Paris is capable of permanently storing the font resources of some printers. For these printers, when a resource is first sent to the printer, Paris sets a flag to indicate the resource is permanently stored and it is not sent again unless specifically instructed.

Refer to the section Updating Resources on page 40 (For full details of which printers are currently supported, contact your distributor.)

II. PCL printers (no permanent storage). When printing to PCL printers (those with no permanent storage), Paris uses its resource flag system to indicate that resources are stored in the printer’s memory. Because this is memory-based storage, these resources are lost if the printer is turned off, or overwritten if another application sends output to the printer.

If the printer is turned off or reset, you must use the ‘Reset at start of next job’ option in the Paris Spooler to reset the flags to their initial state.

Printer Definitions


Also, if the printer is being shared with other applications, (e.g. for word-processing), Paris Spooler must be instructed to reset the resources at the beginning of each job. This naturally means the resources will be sent every time the job is printed and has the effect of increasing the transmission time to the printer.

Refer to the section ‘XPD Resource Management Commands for PCL and PostScript printers’ on page 38.

! NOTE Paris provides you with the option to control the number of characters downloaded in a character set. This may be necessary if you are using a printer that requires the resources to be sent every time a job is printed. Refer to Appendix A, ‘Modifying the Character Selection Table’.

PCL4 printers PCL4 printers are not supported by Paris.

III. Postscript printers (no permanent storage) As part of its job end processing, Postscript printers go through a clean-up. As a result, when printing to Postscript printers (those with no permanent storage), Paris must send all resources required for a job at the beginning of each job.

Refer to the section ‘XPD Resource Management Commands for PCL and PostScript printers’ on page 38.

IV. Windows GDI When printing using a manufacturer supplied GDI driver, Paris passes total responsibility for the downloading and management of resources to Windows.

#### WARNING! Windows GDI does not understand bitmap fonts. If the application contains bitmap fonts, Windows passes the information to the driver. It is up to the printer driver to provide a solution to managing the fonts. Note also that bitmap fonts will not appear in the Font List if a GDI printer driver is selected. Refer to Chapter 20, ‘Using the Font List function’ of the Paris Designer Reference Manual and ‘Adding a font to the font list’ in Chapter 11 of the Paris Designer User’s Manual.

Chapter 1


XPD Resource Management Commands for PCL and PostScript printers

XPD files contain command options to manage printer resources. These options enable you to tailor Paris resource management according to the particular requirements of your printer.

Some XLPrint supplied XPDs have these entries already added.

#### WARNING! XPD files can be edited using a standard text editor, however changing XPDs without proper instruction can be detrimental. It is recommended that XPD files should NOT be changed except by experienced users or under instructions from the distributor. A full description of the working of XPD and PPD files can be found in ‘How do XPD and PPD files work?’ in Chapter One of the Paris Designer Reference Manual.

XPD ManageFonts Command The options for the XPDManageFonts command and the applicable printers are as follows:

XPD ManageFonts Command Use

*XPDManageFonts: None For Docuprint only, no font handling.

*XPDManageFonts: Harddisk For 4517, 4220, 4230 printers. Downloads to the hard disk once.

*XPDManageFonts: Download for PCL and PostScript printers which have no hard disk. Downloads the fonts as needed.

*XPDManageFonts: Always Default for Post Script.

*XPDManageFonts: True Same as Download.

*XPDManageFonts: False Same as None.

NOTE: PostScript defaults to ‘Always’. PCL defaults to ‘Download’.

Printer Definitions


XPD ManageForms Command The options for the XPDManageForms command and their use are as follows:

XPD ManageForms Command Use

*XPDManageForms: None For Docuprint only.

*XPDManageForms: Harddisk For 4517, 4220, 4230 printers. Downloads to the hard disk once.

*XPDManageForms: Download for PCL and PostScript printers which have no hard disk. Downloads the fonts as needed.

*XPDManageForms: Always Default for Post Script.

*XPDManageForms: True Same as Download.

*XPDManageForms: False Same as None.


XPD ManageGrafs Command The options for the XPDManageGrafs command and their use are as follows:

XPD ManageGrafs Command Use

*XPDManageGrafs: None For Docuprint only.

*XPDManageGrafs: Harddisk For 4517, 4220, 4230 printers. Downloads to the hard disk once.

*XPDManageGrafs: Download for PCL and PostScript printers which have no hard disk. Downloads the fonts as needed.

*XPDManageGrafs: Always Default for Post Script.

*XPDManageGrafs: True Same as Download.

*XPDManageGrafs: False Same as None.


Chapter 1


XPD Graphics Compression commands

Paris offers you the option to compress graphics using XPD Graphics Compression commands. Using graphics compression will make the output files created by Paris considerably smaller, an important benefit when color applications are involved.

Using XPD Graphics Compression commands

Graphics compression is activated in Paris via an XPD entry in the XPD file as follows: *XPDGrafCompression type, where type can be either None; RLE or Flate. Using either RLE or Flate invokes the graphics handling system.

None

Using ‘None’ restores the original Paris graphics handling system. The benefit of size reduction to output files is not available using this type.

RLE

Using RLE achieves a 20% reduction in size of simple images (e.g. black and white), less on color graphics.

RLE can be used with PostScript Level 2 printers and up. It has little effect on increasing Paris Engine throughput.

Flate

Flate uses Zlib flate/deflate compression and can be used with PostScript Level 3 printers only. It is effective with all types of graphics, with compression typically around 65% on color images and 85% on simpler images, such as black and white.

Flate has significant effect on increasing Paris Engine throughput. (NOTE: It is recommended that *XPDManageGrafs: Download is used with Flate so that graphics are compressed at the beginning of the job, thus avoiding the need for graphics to be compressed every time they are used.)

For example, to enable zlib deflate/flate compression, the following line would be added to the XPD: *XPDGrafCompression: Flate

If the XPDGrafCompression keyword is not present within the file, then the default is None.

Printer Definitions


Updating Resources

The Update function in the Resources section of the dialog only applies to those printers with permanent storage facilities (see item ‘I’ in the earlier section ‘How Paris manages printer resources’).

In rare circumstances, such as the hard disk failing on the printer, or a resource (e.g. font) being accidentally deleted, it may be necessary to instruct Paris to download these resources again.

Clicking on the Update button will display the View/Change Resource Flags dialog which gives you access to the individual Paris resources.

The dialog permits the user to select the necessary resource(s) to be updated and turn off the permanent download flag. This means the next time a job is set for printing, the selected resource(s) will be sent to the printer.

Chapter 1


' To update a resource: 1. Click on the Update button to open the View/Change Resource Flags dialog. 2. Select the type of resource required from the drop-down menu (Forms, Fonts

or Graphics). A list will be displayed of all the resources of this type that Paris has flagged as being permanently stored on the printer.

3. Highlight the resource or resources on which you require to have the flag set to ‘OFF’.

4. Click on Exit. The internal flags for the selected resources will be automatically set to ‘OFF’. The next time an application that requires these resources is run they will be sent to the printer and the download flag will be set to ‘ON’ again.

3. Highlight the required resources to reset the flag.

Printer Definitions


Resetting Resources

The Reset options allow the user to instruct the Spooler when to reset the resources. The options in the drop-down menu are ‘Never’, ‘At Job’ Start’ and ‘At System Start’. In addition there is a ‘Reset at start of next job’ checkbox option.

The option chosen depends on the storage capabilities of the printer being defined and whether or not the printer is being shared with other applications. These are described as four general levels of resource management in the section ‘How Paris manages printer resources’ on page 36.

Choosing a Reset option

(A) Printers with permanent storage facilities If you are defining a printer with permanent storage facilities, you would choose ‘Never’. If it is necessary to instruct Paris to download the resources again for this printer, you would use the Update Resource button. Refer to Updating Resources on page 40.

(B) PCL printers (no permanent storage)

• If you are using a PCL printer with no permanent storage facilities that is NOT being shared with other applications you would choose ‘Never’. However, if the printer is turned off or reset, you would have to modify the printer definition and select the ‘Reset at start of next job’ checkbox. This causes the Spooler to reset the resources at the beginning of the next job. Once the resources are sent, the ‘Reset at start of next job’ option is canceled.

• If you are using a PCL printer with no permanent storage facilities that IS being shared with other applications you would choose ‘At Job Start’. This will cause the Spooler to reset the resources at the start of each job (as the resources are overwritten if another application sends output to the printer).

Chapter 1


• If you are using a PCL printer with no permanent storage facilities as a dedicated printer you would choose ‘At System Start’ to reset the resources each time the system is started.

(C) Postscript printers (no permanent storage) If you are using a Postscript printer with no permanent storage facilities the option chosen will be irrelevant as Paris must send all the resources required for a job at the beginning of each job.

Media Mapping

Media Mapping is specific to Xerox Docuprint 350, 350HC, 390 and 390HC printers only. If you are defining a Docuprint printer, you must define the media mapping for the printer. This is explained in Appendix B, Using the Media Mapping Function’.

Printer Definitions


PH Y S I C A L PA GE SH I F T

Physical Page Shift allows the print image to be shifted either or both horizontally and vertically on the page. This allows the image position of different printers to be adjusted to match, or pre-printed material can be aligned exactly.

The specified unit of measure is 300 dots per inch (dpi) so a measure of 1 equals 1/300th inch, or 300 equals 1 inch.

Movement is controlled using positive and negative measure around the X (Horizontal) and Y (Vertical) axis. Up and left directions are plus (+) and down and right directions are minus (-).

For example, if H = -75 (-¼”) and Y = -150 (-½”), the print image will be shifted ¼” to the right and ½” down.

To shift the image, enter the required number of units (dots) in the Horizontal and/or Vertical boxes as required.

For example: X (Horizontal) = -75 Y (Vertical) = -150

Y

X + = ( Up ) Left

- = * Down + Right

Shift the page to the right for a quarter of an inch and down for half an inch

¼”

½”

Chapter 1


SC H ED UL I N G A PR I N T ER

In the Scheduling section of the View/Change Printer dialog are options for the time scheduling of print jobs that have been sent to the printer. Scheduling print jobs allows them to be submitted to the Spooler and held until a pre-determined time before being run.

For example, large print jobs can be schedule for formatting after hours.

The options are:

•••• Always, which if selected means that the job will print as normal in the Spooler,

•••• Between, which when selected activates the time fields and means that the jobs will be printed between the times entered. If you select the ‘Between’ option, enter the times required in 24-hour format.

Printer Definitions


SA VI N G T H E PR I N T ER DEF I N I T I O N

To save the printer definition, choose the OK button in the View/Change Printer dialog. Once a printer has been defined and saved, Paris creates an .SPD file in the PARIS\SPL\0 directory.

SPD Files

SPD stands for Spooler Printer Definition. This is a text file that simply contains the name of the printer definition, the current status and the current priority.

! NOTE: SPD files should not be changed or edited unless under instruction from a distributor.

Following is an example of an .SPD file

Name=Printer3Held=truePriority=5Z=EndOfParameters


MO D I F Y I N G A PR I N T E R D E F I N I T I O N

In addition to new printer definitions, the settings for existing printer definitions can be modified. Changes to printer settings only take effect when the Spooler is shut down and restarted (this does not apply when adding a new printer).

' To change the settings for an existing printer definition:

Either: Double-click on the printer in the Paris Spooler control panel,

Or: Select the printer from the Paris Spooler control panel, then select the View/Change Printer settings button.

Or: Select the printer from the Paris Spooler control panel, then select the Settings option from the Printers menu.

Either method will display the View/Change Printer dialog for the selected printer. Modify the existing settings as required.


D E L E T I N G A P R I N T E R D E F I N I T I O N

An existing printer definition can be deleted from the list in the Paris Spooler control panel. A printer can only be deleted if there are no jobs waiting.

' To delete a printer definition: 1. EITHER:

Select the printer from the Paris Spooler control panel then select the Delete Printer button. OR: Select the printer from the Paris Spooler control panel then select the Delete option from the Printers menu. A message dialog will be displayed, requesting confirmation of the deletion.

2. Select ‘Yes’ or ‘No’ as required.

! NOTE: You cannot delete the DEFAULT printer.


S E T T I N G T H E P R I N T E R S TAT U S

The Printers/Pools menu also provides options whereby printers can be set offline (not processing) or online. The ‘Online’ option is context sensitive, and according to the selection of the ‘Online’ option, the current status of the printer will be reflected in the Status column in the Spooler control panel (see below).

Printer Status in the Spooler control panel

' To set the printer status: 1. EITHER:

Select the printer from the Paris Spooler control panel then select the Make Printer Online/Offline button. OR: Select the printer from the Paris Spooler control panel then open the Printers/Pool menu. Depending on the current status of the selected printer, ‘Online’ or ‘"Online’ will be displayed.

2. Select the option required to change the status.

If the currently selected printer is offline, ‘Online’ will be displayed. If the printer has no jobs waiting, the Delete option will be available.

If the currently selected printer is online, ‘""""Online’ will be displayed. NOTE: If the printer has jobs waiting, the Delete option will NOT be available.


F LU S H I N G T H E P R I N T J O B S F R O M A P R I N T E R

The ‘Flush’ option in the Printers menu is used to remove the print jobs that have been added to a printer.

' To flush the print jobs from a printer: 1. Select the required printer from the control panel. 2. Select ‘Flush’ from the Printers menu. A request dialog will be displayed for

confirmation. 3. Choose ‘Yes’ to flush (remove) all the print jobs defined for the selected

printer.

! NOTE Defining a print job is described in Chapter Two, ‘Job Definitions’.


A D D I N G A P R I N T E R P O O L

Printers that have been defined in the Spooler can be grouped into a ‘pool’. Placing individual printers into a pool is an effective way of increasing control of the printing function to the Spooler.

For example, if your organization was using a number of high-speed printers as well as a number of desktop printers, you could set up 2 printer pools.

•••• The first pool could be named ‘Production’ and contain the high-speed printers.

•••• The second pool could be named ‘Desktop’ and contain the low-speed printers.

In this way, jobs can be directed more simply, that is, all big jobs to the ‘Production’ pool and all small jobs to the ‘Desktop’ pool.

Once added, a printer pool is displayed in the Spooler control panel in the same way that an individual printer is displayed, i.e. Printer/Pool Name, Status, Jobs, Printer type, etc.

Job Definitions


AD D I N G A PR I N T ER PO OL

' To add a printer pool:

1. Open the Printers/Pools menu and choose Add Pool from the menu. The Printer Pool dialog will be displayed. The ‘File Name’ (default setting NEW) is used to identify the printer pool in the Spooler system and must be a valid DOS filename and must also be unique. For example PRODN The ‘Full Name’ is displayed in the ‘Printer’ column in the Paris Spooler control panel. The default setting is New Destination. Up to 16 characters can be used, spaces are allowed. For example: Production

! NOTE: Both names must be entered.

2. The priority for the pool can be set as for an individual printer. Refer to ‘Setting the Printer Priority’ on page 35.

Adding a printer to the pool 3. The next step is to add the printers to the pool. Click on the Add button to

display the Choose Printers dialog.

Chapter 2


4. Choose a printer from the dialog and choose OK. The printer will be displayed in the Pool Printers list. Add more printers as required.

! NOTE: To remove a printer from the pool, select it from the Pool Printers list and choose the Remove button.

Scheduling a printer pool

As with individual printers, printer pools can be given a time schedule for print jobs that have been sent to the printers in the pool. Scheduling print jobs allows them to be submitted to the Spooler and held until a pre-determined time before being run. For example, large print jobs can be schedule for formatting after hours.

The options are:

•••• Always, which if selected means that the job will print as normal in the Spooler,

•••• Between, which means that the jobs will be printed between the times entered. If you select the ‘Between’ option, the time fields will be activated for entry of the times required in 24-hour format.

Job Definitions


Editing a Printer Pool

A pool is edited in the same way as a printer, by selecting the printer pool in the Spooler control panel, then selecting the View/Change Printer Settings button or the Settings option form the Printers/Pools menu.

Either method will display the Printer Pool dialog where the settings for the pool can be edited and printers can be added to or removed from the pool.

Deleting a Printer Pool

A pool is deleted from the Spooler in the same way as a printer, by selecting the printer pool in the Spooler control panel, then selecting the Delete Printer button or the Delete option from the Printers/Pools menu.


Chapter 2

JO B D E F I N I T I O N S

When the Spooler is initially installed there will be a default job definition file created. Once the printers have been setup, the actual print jobs then need to be defined.

A separate job definition is normally created for each different application. The exceptions to this are as follows:

1. When serial input is defined.

2. If the incoming data contains DJDE or Runtime event records which hold job control information.

3. When the netware input files are configured to select the environment using the Form Name.

SJD Files (Spooler Job Definition files)

As each new print job is defined, a Spooler Job Definition file (.SJD) is created and stored in the \PARIS\SPL\0 directory.

• The .SJD file name is a generated number.

• An .SJD file is a simple text file which contains all the information required by the Spooler and remains until the job definition is deleted.

• The files should not be directly edited as the syntax rules are very strict and unexpected results could result. Any modification should always be done via the Job Definition dialog in the Spooler


A D D I N G A JO B D E F I N I T I O N

Job Definitions are created in the Add Job Definition dialog. To display the dialog, open the Definitions menu in the Paris Spooler dialog and choose View List to display the View/Change Job Definitions dialog.

Click on the Add button to display the Add Job Definition dialog.

A Job Definition is given a Name then the Input Source, Preprocessing, Environment, and Output tabs are selected as required for the print job.

Chapter 2


JOB DEF I N I T I O N NAM E

The Job Definition name is entered in the ‘Name’ box. This name is a descriptive name and as such is not limited by DOS eight character naming conventions, however the maximum number of characters allowed is 16.

Once the job name has been entered, select the ‘Input’ tab to enter the input source.

Job Definitions


DEF I N I N G T H E IN P U T SOUR C E F O R A JO B DE F I N I T I ON

The Input tab contains a list of input sources that you can select from to tell the Spooler where the print files for the job are to be found.

The input sources listed in the ‘Search In’ drop-down menu are

•••• Directory,

•••• LPR/LPD Server

•••• Port Monitor,

•••• Novell Queue,

•••• Serial.

The following sections provide detailed information on each type of input source and its use.

Chapter 2


OV ER V I EW OF ‘DI R EC T O R Y’ A S T H E IN P UT SO UR C E

If this is the first time you are defining a directory as an input source, it is important that you understand the way the Spooler generates its processing requests and what it does when polling directories for input data.

How the Spooler polls Directories for Input Data

Each time a file is found that matches the directory search path criteria, the Spooler performs two actions. One, it creates an SJR or Spooler Job Request and two, the input is tagged as either hidden, or the file name is changed or the file extension is changed according to what has been selected in the View/Change Directory Search Settings dialog (refer to Defining the directory search settings on page 64).

Spooler Job Requests (SJR)

The SJR is the mechanism by which the Spooler passes instructions to the formatting engine. It contains all the information the engine needs to successfully process the job and deliver the output to its final destination.

A Spooler Job Request is exactly as the name implies, that is, a request from the Spooler to the engine to process a job. The Spooler Job Request remains until the engine has completed the request and sends notification back to the Spooler that the job has been completed.

Once the engine notifies the Spooler it has completed processing, the input file is then deleted. This means that if the system is shut down while job requests are still in the queue, when the Spooler is next opened those job requests would still be queued awaiting processing. It also means that if the data file for the request is deleted before it is processed, the request will remain forever or until manually deleted.

Spooler Job Requests (.SJR) are stored in the \PARIS\SPL\0 sub directory. When created they are given a generated number as a file name and only exist until the engine has processed the file. An .SJR file is a text file that contains all the information the engine needs to be able to find, process and deliver the file for printing.

Job Definitions


Following is an example of an .SJR file:

ExternalName=34466InternalName=DailyReportsInputSource=E:\INV\DTA\TUTE3.DTAInputType=DiskDescription=Disk FileStatus=queuedEnvironment=dfltpPrinter=Printer3Priority=5NovellId=0Size=411Time=16:21:22Date=06/111/96Held=0CopiesRequested=1CopiesCompleted=0Z=EndOfParameters

#### WARNING! The .SJR files in the \PARIS\PRT\0 directory should not be edited. The syntax rules are strict and unpredictable results may result if changed manually.

Chapter 2


Changing File Attributes

The file attributes are changed to hidden, or the file name is changed or the file extension is changed to prevent the Spooler constantly going back in a loop and re-processing the same input file.

The side effect of changing the attributes to hidden is that the files appear to have been immediately deleted from the system. In fact they are still there, they are simply waiting to be processed by Paris. Only after processing are the files deleted.

An example of the Spooler polling directories for input data

Once a job definition has been created with a directory search path, (for example, E:\INV\DTA\T*.DTA), the Spooler immediately checks the contents of this directory to find any files that match the search criteria.

Each time a file is found that matches the criteria, the Spooler creates an SJR, then it changes the attributes of the file to ‘hidden’.

In this example, the Spooler would search the E:\INV\DTA directory and immediately generate Spooler Job Requests for all files matching the search mask, in this case T*.DTA (that is, all filenames starting with ‘T’ and with the extension .DTA). The attributes for all these matching files would also immediately be changed to ‘Hidden’, which means the files have in theory disappeared from the directory.

If there were 20 files in the directory matching the T* and .DTA mask, the Spooler display would immediately show 20 jobs queued ready for processing.

Job Definitions


DEF I N I N G DI R EC T O RY A S T H E IN P UT SO UR C E

If the Directory option is selected, you are instructing the Spooler to search a local or remote directory for its input.

You must provide the Spooler with the specific search path, including the source directory, sub-directories and file names, according to the source of the input files.

Defining the directory search path

The search path is entered in the box below the Directory option and can be setup to search for a named file (e.g., C:\PARIS\DTA\SAMPLE.DTA) or any valid DOS wildcard search, (e.g., C:\PARIS\DTA\T*.DTA).

Search path

Chapter 2


Defining the directory search settings

When you click on the Settings button the View/Change Directory Search Settings dialog is displayed.

The dialog drop-down menu provides access to the three options that Paris has available for file tagging.

&&&& Hidden Attributes

&&&& Change Name

&&&& Change Extension

The default and preferred method of operation is ‘Hidden Attributes’, but if necessary, you can choose the required option from the menu. (Refer to ‘How the Spooler polls Directories for Input Data’ on page 60).

Once the Spooler Job Request is generated the input is tagged according to the selected option (as either hidden or the file name is changed or the file extension is changed). File or extension name changing is all under program control so there is no need to specify what the new name or extension should be.

Normal job processing applies in that as soon as the engine notifies the Spooler that the job has been processed, the input file (whether hidden or renamed) is deleted.

Job Definitions


OV E R V I E W O F ‘NO V EL L QUEUE ’ A S T H E IN P UT SO UR C E

Paris can intercept input from, or direct output to, a Novell print queue. Existing print queues can be used, or new queues can be created specifically for Paris to use.

Before selecting a Novell Queue as the input source, refer to the following information on creating and using Novell Queues in association with Paris.

Creating Novell Queues to use with Paris

A Novell Queue that Paris will attach to as a queue Server is a Paris Input Queue. Although a Novell print queue can be created using Novell's PCONSOLE, the Server attribute can only be correctly set using Paris Designer’s View/Change Novell Queues dialog. Refer to ‘Creating a Paris Input Queue’.

A Novell Queue that Paris will attach to as a queue User is a Paris Output Queue and is created using Novell’s PCONSOLE which allows the queue users to be viewed, added to and deleted from any print queue.

In a ‘standard’ Novell network, creating a queue with PCONSOLE automatically adds a User Group of ‘Everyone’, meaning all users have access to the queue. The queue is automatically useable as a Paris output destination and the Paris login user name does not have to be explicitly added to the user list. Refer to: ‘Creating a Paris Output Queue’.

! NOTE: You must be logged into the network with Supervisor access to create or modify a Novell queue.

Chapter 2


Creating a Paris Input Queue

For Paris to input from a Novell queue, the User logged on to the workstation must be defined as the queue's Server and must also be logged into the network with Supervisor access.

' To create a Paris Input Queue: 1. Ensure that you are logged in with Supervisor access and that the User is

defined as the queue Server.

2. Select Novell Queue as the Input Source in the Job Definitions Settings dialog, then click on the Settings button to display the View/Change Novell Queues dialog.

3. Click on the Add button in the Available Queues section of the dialog.

Job Definitions


4. Enter the new queue name (the queue name must be Alphanumeric, and can be up to 49 characters).

5. Choose OK. The new queue name will appear in the Available Queues list.

Once created, the queue must be prepared for input. Refer to ‘Preparing Paris Queues for Input’.

4. Enter the name of the new input queue then choose OK.

Chapter 2


Preparing Paris Queues for Input

When preparing a queue for input, the Queue Users field must contain the user name (or a User Group) of each user who will send data to the queue. (Normally Novell's PCONSOLE will add the user group 'Everyone' to the Queue Users list.)

When you prepare a Paris queue for input, you need to set the User, Server and Operator attributes of the selected Novell print queue.

Setting the queue Users list The Users list is the list of users who are permitted to add print files to this queue. It is possible to specify User Groups.

' To set the queue Users list: 1. Select the required queue from the Available Queues list. 2. Click on the ‘Users’ radio button in the Current Members section of the dialog,

then click on the Add button in the same section. The Select Queue Member dialog will be displayed.

1. Select the queue.

2. Click on the ‘Users’ radio button, then click on the Add button.

Job Definitions


3. Select the required user name from the list of Available Members, then choose OK.

The added user name will be displayed in the Current Members list in the View/Change Novell Queues dialog.

3. Select the required user name then choose OK.

Chapter 2


Setting the queue Servers list A single User must be allocated as the Server in order for Paris to input from a Novell queue.

The User allocated as the Server must also be the same as that logged onto the workstation. For example, if the User is logged on to the workstation as PARIS [USER], the Server must also be PARIS [USER].

'''' To set the queue Servers list: 1. Select the required queue from the Available Queues list. 2. Click on the ‘Servers’ radio button in the Current Members section of the

dialog, then click on the Add button in the same section. The Select Queue Member dialog will be displayed.


2. Click on the ‘Servers’ radio button, then click on the Add button.

Job Definitions





Chapter 2


Setting the queue Operators list The Operators list is the list of users who will have ‘Operator’ access to the queue. It is possible to specify user groups.

' To set the queue Operators list: 1. Select the required queue from the Available Queues list. 2. Click on the ‘Ops.’ radio button in the Current Members section of the dialog,

then click on the Add button in the same section. The Select Queue Member dialog will be displayed.


2. Click on the ‘Ops.’ radio button, then click on the Add button.

Job Definitions




4.


Chapter 2


Creating a Paris Output Queue

A Paris Output Queue is a queue that Paris will attach to as a Queue User. The queue should be created and configured using the Novell PCONSOLE utility according to the normal Novell guidelines.

• PCONSOLE allows the Queue Users to be viewed, added to and deleted from any print queue.

• In a ‘standard’ Novell network, creating a queue with PCONSOLE automatically adds a ‘user group’ of ‘Everyone’, meaning all users have access to the queue. The queue is automatically useable as a Paris output destination and the Paris login user name does not have to be explicitly added to the user list.

! NOTE: Output queues can also be created via the Paris dialogs, however the queue will have no default servers, operators or users and must therefore be configured entirely. PCONSOLE is quicker for creating Paris output queues.

'''' To prepare a queue for Paris output: 1. Create a new queue using PCONSOLE or select an existing queue.

2. To make the queue useable under Paris, ensure that the user name with which the Paris workstation is logged in is listed in the ‘Queue Users’ attributes of the queue.

Job Definitions


Using Novell Print Queues with Paris

Once the queues have been created and user access has been setup, the queues are now available for Paris use.

To send Paris output to a queue, when defining the settings for a printer setup, enter the queue name in the ‘Output To’ box for a print destination.

File Server Access

If Paris resources have been loaded onto the file server, the login user name used at a workstation running Paris must have:

1. Access to the file server disk containing the resources, and

2. A valid drive mapping to the file server disk containing the resources.

For example, if Paris has been installed to a file server but the user login ‘MYNAME’ does not have access to that drive, then Paris will fail to run.

Enter the queue name in the ‘Output To’ box to send Paris output to a queue.

Chapter 2


Single Server Access

The current Paris Novell support does not support multiple server networks. This does not mean Paris will not run in a multiple server network, but that Paris input or output queues must reside on the server that the workstation is currently logged in to.

Queues can exist on more than one server but Paris can only see the queues on the current server.

! NOTE: When Novell is chosen as the input source there are additional options available by which an environment can be selected. Refer to the section ‘If the Input Source is Novell Queue…’ on page 105.

Job Definitions


DEF I N I N G NOV E LL QUE UE A S TH E IN P U T SOU RC E

When the Novell Queue option is first selected as the input source, the box below will show the text PRINTQ1 (this is the default name). The name of the Novell Queue to be polled for input is entered in this box.

If the name of the Novell Queue is known it can be directly entered in the box. If the name is not known it can be selected from the available print queues.

' To view the available print queues: 1. Click on the Settings button to display the View/Change Novell Queues dialog

and the list of available queues.

2. Make a note of the required queue name then exit the dialog and type the

queue name in the Novell Queue box.

Enter the name of the Novell Queue in this box

Chapter 2


OV ER V I EW OF U S I N G SE R I A L A S T H E IN P U T SO UR C E

When you select ‘Serial’ as the Input Source, you will be required to set up your serial port settings.

Before setting up your serial communications, it is important to understand serial communications and the configuration of your PC.

Understanding Serial Communications

It is not within the scope of this manual to enter into a full explanation of serial communications, however, in order to avoid problems there are some issues that need to be understood.

Hardware Overrun Error Messages

A common problem with serial communication is ‘hardware overrun’ error messages. The simple answer to their cause is that the baud rate is too high, but there are other factors and there are simple solutions.

High Baud Rate Hardware overrun errors and the frequency of this error depend on the PC configuration, however the baud rate is normally the most critical factor. Generally the higher the baud rate, the greater the probability of a hardware overrun.

Job Definitions


UART Signals an Error The hardware overrun error indicates an overrun error of the receive buffer in the Universal Asynchronous Receiver Transmitter (UART). The Comm driver obtains this error by reading the Line Status Register (LSR) of the UART, of which bit 1 is set when an overrun occurs.

When the Comm driver cannot service a Received Data Available interrupt, before it receives the next transmitted character, the UART signals an error because at least one character has been lost.

The UART chip Every serial port uses a UART chip to send and receive data. Many machines still use either the 8250 or the 16450 UART chip. The 8250 was the original UART to ship with the IBM Personal Computer. This UART and the improved 16450 version are limited to one input register that holds one byte at a time.

These UART’s are not normally suited for speeds greater than 9600 bits per second because of the possible input data overruns that occur, if a character is left in the input register when the next byte is received.

The newer 16550A UART allows reliable data transfer at high speeds with its 16 byte FIFO (first in, first out) input register. The FIFO feature can buffer up to 16 bytes at a time, which greatly improves serial communications speeds.

Other causes of hardware overrun error messages Although the baud rate is the most likely cause of problems, other factors also need to be considered. These include:-

CPU speed

Faster CPU’s allow faster throughput with fewer errors. This is because they allow the communications driver to service character interrupts faster (preventing interrupt overflow) and allow applications to handle transfer protocols better.

System overhead

The more applications, TSR’s and device drivers that are running the busier the operating system is. This reduces overall execution time for everything in the system.

Chapter 2


Windows 3.0 support of UART

Windows 3.0 does not support the advanced first-in first-out (FIFO) buffer feature of the 16550A UART. It supports the 16550 and 16550A as a standard 8250 UART.

Identifying the UART chip in your PC The Microsoft Diagnostic utility (MSD) supplied with MS-DOS will easily allow you to identify the various components of your PC, including the UART chip.

MSD is run from the DOS prompt simply by typing MSD. The option for COM ports will display all details including which UART chip is being used.

If you find that you have an older 8250 or 16450 UART, you should check with your PC dealer about upgrading your I/O board to one with a 16550A UART.

The information on the following pages is for the Cybercom.drv high speed (16550AF) Windows serial port driver from Cybersoft Corp. This driver allows Windows to take full advantage of the 16550 UART chip.

Job Definitions


CyberCom V1.1.0.0P

CYBERCOM.DRV 9264 11-26-93 1:06p

The High Speed Serial Communications Driver for Windows 3.1 Designed for 386 (and above) systems using the 16550 serial port chip. (C) CyberSoft Corp 1993. Requires Windows 3.1, Enhanced Mode, a 16550 UART

Introduction

CyberCom is a direct replacement for the standard Windows Communications Driver (COMM.DRV).

Transfer at up to 115,200 KB with a 16550 serial port chip.

Great for V.FAST and Voice modems that require 57,600 Kb.

More reliable Transfer with less overhead on your system - better background operation, fewer (if any) over/under runs.

How Does it Work?

Don't worry if the following sounds too complicated - just skip over it and move on to the Installation.

CyberCom enables the FIFO buffer on the 16550 to be enabled for both receive AND transmit (COMM.DRV only enables the FIFO for receive.)

The ‘interrupt trigger level’ has been set to 8 for both transmit and receive, this gives your applications a lot more time to process incoming information. (COMM.DRV sets the trigger level to 14 which means that your application only has 2 characters in which read from the FIFO buffer.)

What this means is that your communications applications will get far fewer (if any) ‘under runs’ or ‘over runs’ when sending or receiving.

Chapter 2


Installation

1. Copy CYBERCOM.DRV into your Windows\System directory. 2. Edit the Windows\SYSTEM.INI file and change the following line:

from: comm.drv=comm.drv to: comm.drv=cybercom.drv

3. If you previously have not taken advantage of the 16550 installed in your computer, then ensure that the Windows\SYSTEM.INI file has the following information: [386Enh] COMnFIFO=1 (where n is the number of the COM port) For example, if your 16550 is installed on, say, COM 1 then [386Enh] COM1FIFO=1

4. Start or Restart windows.

License

CyberCom is provided free for non-commercial use.

Job Definitions


DEF I N I N G SE R I A L A S T H E IN P U T SO UR C E

When ‘Serial’ is selected as the input source to search, the box to the right will display the serial source (the name of the defined COM port, COM1 is the default) and the Settings button will be activated.

' To set up your Serial Port Settings:

Click on the Settings button to display the View/Change Serial Port Settings dialog.

The dialog contains three sections, Byte Settings, Handshaking and Page Eject. When configured for Serial you must ensure there is only one job definition and the job definition contains only one printer reference. In other words, when using Serial as an Input Source, Paris assumes one input, one output and that environment changing will be done via either Runtime events or conditional processing.

Chapter 2


Byte Settings

Byte Settings must be set to match those of the host computer. Ask your maintenance engineering staff what settings are required.

Handshaking

The options available in the Hardware Handshaking drop-down menu are None; DTR Only, RTS Only and DTR and RTS.

Software Handshaking The Software Handshaking checkbox is selected by default.

# WARNING! This option should NOT be de-selected unless the host sends so slowly that overruns cannot occur.

Page Eject

The page eject options control whether or not a page is ejected from the printer after a specified number of seconds.

While this option is useful when the last page is not automatically ejected from the laser printer, it can cause problems if the serial link is broken in the middle of a print job, in this case the half completed page will be ejected before the remaining data is received.

Job Definitions


OV E R V I E W O F U S I N G T H E PA R I S PO RT MO N I T O R AS T H E

IN P U T SOU RC E

With the Paris system you are able to create a Port Monitor that sends its output to a temporary disk file allowing you to direct the output from the normal Windows 95/NT4 spool system into the Paris Spooler. The disk file is then treated as normal input for the Paris Spooler.

The advantage of this approach is that the actual source of the input data is totally removed from Paris. As long as the data can be delivered into the Windows 95/NT4 spool system then Paris can ‘intercept’ it.

To fully appreciate the benefits of the Port Monitor, it is critical to understand the role of the ‘Print Providers’ in the Paris system as they determine what type of data is delivered to the Spool system.

The role of Print Providers Most Windows applications such as Word or Excel use GDI to send data into the spool system. GDI always sends data to a printer driver, which in turn delivers formatted data into the spool system (as internal spool files). These spool files always go to a port monitor for final delivery to the print device.

Other print providers, such as LPD or the DOS copy command, do not use a printer driver and the data is delivered directly to the spool system which then sends it to the port monitor.

The Paris Port Monitor is able to receive any data files sent into the Windows 95/NT spool system. However, it makes no sense to send GDI files as they are already formatted and therefore cannot be processed by Paris. As a result, the Port Monitor is only useful if the print provider used avoids the Windows print driver (that is, it is not GDI based). This can be achieved by directing the flow of data through the system as follows:

1. Data enters the system via a third party provider. 2. The data is stored in a temporary spool file. 3. This file is then redirected to a temporary disk file via the port monitor. 4. The engine processes the file and delivers output to the configured

destination.

Chapter 2


Win95/NT4 Spool System

Printer Driver

Spooled Files

Port Monitor

Final Output (printers, Novell Queues, Disk Files)

Print Providers

GDI

LPD

Other Print

Providers Paris Spooler/Engine

Temp Files

Paris Output

Paris Output

Job Definitions


CONF I GU RI NG Y O UR PAR I S PO R T MO N I T OR

To set up and use your Paris Port Monitor you need to:

I. Install the Paris Port Monitor. II. Create a Job Definition with the Port Monitor as the Input Source. III. Set up a Windows printer with the above Job Definition (name and path) as

the input source.

! NOTE: This printer is used specifically for input to Paris.

I. Install the Paris Port Monitor

When you install your Paris system, the file PMCONFIG.EXE is installed in the PARIS root directory and the file PARISPM.DLL is installed in the WINDOWS/SYSTEM directory.

' To install the Paris Port Monitor:

1. Run the PMCONFIG.EXE

file (either via the Windows Run dialog or via Windows Explorer, double-clicking on the file name). The Port Monitor Configuration dialog will be displayed.

Chapter 2


2. Select the Add Monitor button. The PMCONFIG dialog will be displayed confirming that the Monitor is added.

2.

3.

4.

3. Choose OK. The Port Monitor will be displayed in the list in the Port Monitor Configuration dialog (4).

Job Definitions


II. Create a Job Definition with the Port Monitor as the Input Source

When ‘Port Monitor’ is specified as the input source in a Spooler Job Definition, the monitor uses the port name given. The Port Monitor then makes this job definition available as a port name .

☛ To add a job definition as a port name:

1. Start the Paris Spooler and select ‘Add’ from the Definitions menu. The Add Job Definition dialog will be displayed.

2. Enter a name for the job definition. (for example, we have used the name ‘Invoice’ as this is to be the input source for invoice files.)

3. Select the Input tab, then select ‘Port Monitor’ as the Input Source.

4. Define the other settings as required by selecting the appropriate tabs, then choose OK.

3

4

Chapter 2


! NOTE: To view the added job definition, select ‘Settings’ from the Definitions menu in the Paris Spooler. The added job definition with the Port Monitor as the Input Type will be displayed.

Editing a port name (a job definition with port monitor as the input source)

The settings for an added port name (environment name, copies, output destination and so on) can be changed.

' To change the settings for a port name: 1. Go to the Spooler and open the Definitions menu, 2. Select the Job Definition to be changed, 3. Make the required changes.

Deleting a port name (a job definition with port monitor as the input source)

' To delete the port name that the Port Monitor uses: Delete the matching Job Definition in the Spooler.

Job Definitions


III. Set up a Windows printer

1. In Windows, go to the Add Printer Wizard.

2. Select a common printer from the list (such as HP Laserjet 4 or Generic) and go through the process of adding a printer. When you are asked to select a port to use with the printer, the port name (job definition) that you have added with the Port Monitor as the input source will be displayed in the list of available ports.

2.

3.

3. Select the added port name (job definition). In this case we have selected the port name ‘INVOICE’ that we added.

Chapter 2


4. Give the printer a name. (As this printer is actually for input to Paris, you can choose a name relevant to the type of files you are directing to the Paris Spooler.

5. Once the printer is added, it will be displayed in the Windows Printers dialog.

4.

5.

Job Definitions


6. Select the added printer, then select ‘Properties’ from the Printer menu.

7. Select the ‘Details’ tab. The port name that you have selected for the added printer will be displayed in the ‘Print to the following port’ box.

6.

7.

Chapter 2


Deleting the Paris Port Monitor:

1. Run the PMCONFIG.EXE file to display the Port Monitor Configuration dialog.

2. Select Paris Port Monitor from the list.

2.

3. Select the Delete Monitor button.

The PMCONFIG message dialog will be displayed, confirming the Port Monitor has been deleted. The monitor name will be removed from the list in the Port Monitor Configuration dialog.

3.

Job Definitions


OV E R V I E W O F U S I N G LPR/LPD SE RV E R A S T HE IN P U T

SOUR C E

The Paris Spooler provides an LPD function that allows you to search for input from LPD Servers. A job definition is created with LPD Server as the input source and when created, an LPD Log is activated to display the status of the LPD server.

What is an LPD?

LPD (Line Printer Daemon) is a printer server function that allows you to configure your locally attached printer as a network printer. This enables you to make print services on your locally attached printer available to other people on the network.

A computer on a network (host) that can create a TCP/IP data stream and use the LPD protocol can print remotely or act as a print server.

! NOTE: It is not within the scope of this manual to enter into a full explanation of the LPD function and how to set up your LPD print queues.

Chapter 2


DE F I N I N G LPD SE R V ER AS T H E IN P U T SO UR C E

To define an LPD Server as an input source, a job definition is set up with LPR/LPD Server selected as the input source and an LPD Server name is entered. The LPD Server that is named is the link between input files and the job definition.

A job definition must be created for each LPD based data file. The same data file cannot be printed using different job definitions.

The Paris Spooler incorporates an LPD Log dialog which logs the status of the LPD function.

If you have a job definition with LPD Server specified as the input source, when the Spooler is started, the LPD Server will open and the LPD Log will be displayed as an icon in the lower right corner of the status bar. The icon is an image of a printer overlaid with an arrow ',,,,'.

To display the LPD Log dialog, right-mouse click on the icon and choose ‘Restore’ from the pop-up menu.

Alternatively, the LPD Server can be opened or closed from the Spooler System menu by selecting or de-selecting the LPD Server option

! NOTE: You can set up your LPD Servers, then create the relevant job definitions, or create the job definitions, then set up your LPD Server.

Select LPD Server from the System menu to open the LPD Log

Job Definitions


Creating a Job Definition with LPD as the Input Source

' To create a Job Definition with LPD as the Input Source: 1. In the Spooler, open the Definitions menu and choose View List to display the

View/Change Job Definitions dialog.

2. Choose the Add button to display the Add Job Definition dialog.

3. In the Add Job Definition dialog, under the Options tab, enter a name for the job definition.

4. Under the Input tab, choose LPD Server from the list of Input Sources. The edit box below will display the default setting ‘PARIS’.

5. In the edit box, enter an LPD Server name, then choose OK. A dialog will be displayed requesting if you want to start the LPD Server.

3

4

5

Chapter 2


6. Choose ‘Yes’ or ‘No’ as required. If you choose ‘Yes’ the LPD Log dialog will be displayed indicating the status of the LPD server.

See also ‘How do I capture data from an LPD Server’ in Chapter 1 of the Paris Designer Reference Manual.

6

Job Definitions


PA R I S AN D LPR CO N T R O L F I L E P R O C E SS I N G

Paris offers support for LPR Control files. In an LPR/LPD conversation, LPR Control files are received and stored along with the Data files. The file is written to the ‘LPD’ subdirectory, with an extension of ‘ctl’. It will often, but not always, have the same name as the data file (this is because the file names are based on the time the file first arrives).

The Spooler will keep track of each data file and its associated control file and will maintain and delete the control file as required.

How Paris reads an LPR Control File The LPR Control file is a text file containing a number of entries. Each entry is a single line of text in the control file. • The first character of the control file is the ‘key’ character. This character

determines the entry type of this line. • The rest of the line is the ‘value’ of this entry. RFC1179 specifies a number of ‘standard’ entries, most of which are optional.

Different implementations of LPR/LPD may also add custom entries. Most entries are ‘optional’ and often it is necessary to use special command line options when running the LPR program in order to get various entries to appear in the control file. Which entries are available in a control file and what LPR options are necessary to activate these entries is an LPR-specific detail.

Paris will look for and use only the following entries from an LPR control file:

H = Host: The name of the host on which the LPR is running. This entry should always be available.

P = User Name: The user name of the logon account used to run the LPR program. This entry should always be available.

C = Class Name: The ‘class’ name for banner page processing. Optional.

J = Job Name: The Job Name to be printed on a banner page. Optional.

N = Input File Name: The name of the original data file submitted to the LPR program. Optional.

T = Title: The title of the job, for banner page processing. Optional.

If there are any other entries in a control file, they will be ignored.

Chapter 2


How the Spooler uses the information from the Control file

The Spooler parses the Control file for each data file received via the LPD server. The Spooler offers three different ways of using information from the control file.

1. If the Input File Name entry exists, that entry and the Host entry are used to create the Data Source name in the Spooler user interface. If the entry is not in the control file, then the Data Source is set the to generated name the data file was stored as during the LPD conversation.

2. If the User Name entry exists (and it should!) then the description field in the Spooler user interface is set to ‘Submitted by xxxx’, where ‘xxxx is the user name. If the user name is absent then the description is set to ‘LPR File’.

3. Control entries can be used to select the name of the ENV file to be used for printing a data file. When ‘LPR/LPD Server’ is selected as the input source in a Job Definition, the ‘Select by’ option under the Environment tab lists the options: LPR Host Name; LPR User Name; LPR Class Name, LPR Job Name, LPR Title and LPR Input Name.

Selecting the appropriate option means that the value of the matching Control file entry will be used as the name of the ENV to use for printing. For example, if the ‘class’ entry in a control file is ‘Invoice’, then selecting ‘LPR Class Name’ in the ‘Select By’ combo box will tell the Spooler to print this file using the 'Invoice' ENV. This allows jobs that arrive through the same LPD printer queue to be printed using different ENVs. The ‘Host' and ‘User Name’ entries are the least likely to be useful, but are allowed in case a particular client setup needs them. The most likely entries to use for selecting environments are ‘Class Name’ and ‘Job Name’.

Job Definitions


How the Paris Engine uses entries from an LPR Control file

The Paris Engine is able to use the entries from an LPR Control file when printing the associated data file. The Engine can use the control file entries in two different ways, through Fields and through the Environment Info function.

Control file entries are added to the printing info system by either:

1. Creating a field that uses the LPRData calculation function to access the Control file entries then adding the field to an LPR Defaults text box in the Environment Info dialog in the Paris Designer.

2. Enter the appropriate <@LPRxxx> option directly into the relevant LPR Defaults text box in the Environment Info dialog in the Paris Designer.

The first is the most flexible, and allows the user the most options for formatting the entry. However, it forces the user to create at least 1 field.

The second is quicker, and does not require the creation of a field. However, there is not ability to modify or concatenate entries.

1. Fields Any Control file entry can be used in the calculation string of a Field. The calculation function which makes the various entry values available is: LPRData(entry)

The ‘entry’ parameter is a number indicating which field should be returned. The possible values are:

0 - The Host Name. 1 - The User Name. 2 - The Class name. 3 - The Job Name 4 - The Input File Name 5 - The Title

If the requested entry does not exist in a particular control file, then the function returns an empty string. By using standard field calculation operations, it is possible to build custom combinations if required, such as Host + User, or Class+Title.

The contents of a field can be used in text blocks, test comparisons and Environment Information strings. By adding the contents of the Control file to the field system, the control file entries can now also be used in each of these areas.

Chapter 2


2. Environment Information One of the main uses for LPR control file info is for generating Banner information on the output printer. Paris Designer supplies the Environment Info dialog to allow the user to specify values to be included in the Job Ticket used to create banner pages (and accounting information) for Xerox printers. (Refer to Modifying a Job Ticket via the Environment Editor in Appendix C, ‘Modifying Paris Job Tickets.)

Windows NT LPR

The default Windows LPR (available when the optional Microsoft TCP/IP Printing service is installed) generates control files that contain the Host, User and Input File Name entries by default.

There are no Class, Job and Title entries in a default control file.

The -C command line switch can be used to add a Class name into the control file.

Job Definitions


DEF I N I N G T H E P O LL I N G I N T ER V A L F OR SE A R CH I N G AN

IN P U T SOU RC E

The polling interval is specified in the ‘Search every [x] seconds’ text box under the Input tab of the Add Job Definition dialog.

The polling interval instructs Paris to search the specified input source (Directory, Serial or Novell Queue) for the presence of input data at the interval specified.

! NOTE A polling interval is not specified for a Port Monitor or LPD Server.

Chapter 2


HO L D I N G NE W JO B S

By default, the ‘Hold New Jobs’ checkbox is not activated.

If the ‘Hold New Jobs’ checkbox is activated, any jobs satisfying this job definition will arrive in the system in a held state. These jobs will not be processed until the status is changed from ‘Held’ to ‘Release’ in the Spooler (refer to ‘Releasing a held job’ in Chapter 4).

This option is useful for large jobs that you do not want to start printing automatically.

Job Definitions


PR E P R OC ES SE S I N A JOB DEF I N I T I O N

The Paris Spooler system enables the user to add ‘Preprocesses’ as part of the printing of a data file. A Preprocess is an application, batch file or script to be executed by the Spooler.

In general terms, a preprocess is used to prepare data before submission to Paris for formatting. For example, the preprocess might be used to perform a sort function; to modify DJDE records that are not required; to perform an SCS control code interpretation, or to call a fully contained program (such as XES2PS.EXE which is used as an example of a preprocess program in Appendix E, ‘Using Preprocesses in the Spooler’.)

! NOTE: Preprocesses are totally independent of Paris and are created by, and the responsibility of the program creator, not XLPrint.

Before a preprocess can be added to a job definition, it must be defined in the Spooler. To find out about Preprocesses and how to define them in the Spooler, refer to Appendix E, ‘Using Preprocesses in the Spooler’.

Chapter 2


AD D I N G A PR EP R O C E SS T O A JO B DE F I N I T I ON

To execute defined preprocesses for a data file, they are added to the relevant job definition.

' To add a preprocess 1. In the Add Job Definition dialog, under the Preprocessing tab, click on the

Add button to display the Select Preprocess to Add dialog. 2. Select the required Preprocess, then click on OK. The added Preprocess will

be displayed under the Preprocessing tab in the Add Job Definition dialog.

! NOTE: Up to 8 individual preprocessing actions can be applied to a data file prior to it being printed.

2 1

Job Definitions


EN V I R O N M E N T F I LE I N A JO B DE F I N I T I ON

The next tab in the Job Definition Settings dialog controls the selection of the environment file to be used for the input source.

General methods by which Paris selects environments

Before describing how to use this method of selecting an environment file, it is useful to review the general methods by which Paris selects environments.

Method 1

The first method is where the environment is selected by direct call in the incoming data file. That is, the data file has been preconditioned with either Xerox DJDE [Dynamic Job Descriptor Events] or Paris Runtime events.) This method has two significant advantages.

• First, it allows Paris to provide support for Xerox legacy DJDE conditioned data streams or LCDS and

• Second, it allows the host application to have total control over Paris.

Its disadvantage is that it does require the host application to be changed to insert these special records.

Chapter 2


Method 2

The second method is where the environment is selected by conditional processing abilities in Paris. An extensive range of testing abilities in Paris enable it to look at the data as it flows into the system and make processing decisions according to what conditions it finds.

This method, although powerful, needs to be fully understood before it is used, as by its nature it must scan all data coming into the system.

Unless the structure of the data has been fully understood, incorrect environments could be loaded if it finds a match in a different data file.

Method 3

This is the method that is used and displayed in the Add Job Definition dialog and is where the environment call is linked to the input data file.

In simple terms this means that when Paris searches and finds the data file specified in the Input Source, it is to use the environment specified in the Environment section of the dialog.

This method provides a new and very powerful level of control for Paris users.

• It provides the dynamic functionality of a runtime event method without having to change the host applications.

• It avoids the possible limitations associated with the environment test option.

Job Definitions


SEL EC T I N G A N EN V I R O N M EN T F I LE F OR T H E JO B

DEF I N I T I O N

The options available under the Environment tab vary according to the Search type selected for the Input Source.

If Input Source is Directory…

If the Input Source is set to a Directory search, the ‘Select By’ option under the Environment tab will display ‘Default’. This means that the environment to be attached to the input file will be the environment specified as the default.

' To enter the default environment name in the Default box. 1. Either: Type the environment name in the Default box,

Or: Select the Browse button to display the Select/Enter File To Load dialog. The dialog lists all the environments in your Paris Environment (ENV) directory.

2. Select the required file from the list, then choose the OK button. The file name will be displayed in the ‘Default’ box.

2.

1.

Chapter 2


If the Input Source is Novell Queue…

If the Input Source search is set to Novell Queue, two options are available for selection of the environment: Default and Novell Form Name.

Default

Default acts the same as Directory polling in that a default environment is associated with a Novell input queue. Whenever a file is found in the specified queue, the default environment will be associated with the queue and sent to the engine for processing.

The default environment name is entered in the Default box.

1. Either: Type the environment name in the Default box, Or: Select the Browse button to display the Select/Enter File To Load dialog. The dialog lists all the environments in your Paris Environment (ENV) directory.

2. Select the required file from the list, then choose the OK button. The file name will be displayed in the ‘Default’ box.

2. 1.

Job Definitions


Novell Form Name

The Novell Form Name field is one of the attributes available in a Novell Queue. This option allows Paris to look at the Form Name attribute, extract the form name and use it to select the environment to use.

If there is no Form Name attribute found, or if there is no matching environment, the default environment is used and the default environment name is entered in the ‘Default’ box as described on the previous page.

Chapter 2


If the Input Source is LPD Server…

When ‘LPD’ is selected as the input source in a Job definition, the ‘Select by’ option under the Environment Tab lists the options: LPR Host Name; LPR User Name; LPR Class Name, LPR Job Name, LPR Title and LPR Input Name.

1. Selecting the appropriate option means that the value of the matching Control file entry will be used as the name of the ENV to use for printing.

2. Refer to the previous section ‘Paris and LPR Control File processing’.

Job Definitions


SEL EC T I N G T H E OU T P U T O P T I O N S F OR T H E JO B

DEF I N I T I O N

The Output tab of the Add Job Definition dialog provides output options for the printing of the job definition.

Adding the printer(s) to the list

A single printer or a number of printers can be added to the printer list. The number of copies required can also be defined for each printer.

! NOTE: A printer is not selected when Serial is the input source as only one printer can be specified for Serial input.

' To select a printer: 1. Click on the Add button in the Job Definitions Settings dialog to display the

Select Printer dialog. The dialog will display a list of the printers that have been configured for your Paris system.

2. Select the required printer from the list then click on OK. The selected printer will be displayed in the Printers list in the Job Definition Settings dialog.

! NOTE: To remove a printer from the list, select the printer name and click on the Delete button. The printer name will be removed.

2. 1.

Chapter 2


Adding a printer to the list when Novell Queue is the input source

If Novell is the selected as the Input Source, an extra option ‘Form Name’ is available. The printer name can be automatically selected by the Novell Form Name attribute in the same way that it is used when selecting an environment (refer to Novell Form Name on page 111).

For example, if the Novell Form Name is called INVOICE and <Form Name> is selected in the Select Printer dialog, the output will be sent to a printer called INVOICE after processing.

' To select the printer name automatically: 1. Click on <Form Name>. 2. Click on OK. <Form Name> will be displayed in the Printers list in the Add

Job Definition dialog.

<Form Name> is displayed when the input source is Novell Queue

2.

Job Definitions


Appending small print jobs into a single large job

The ‘Concatenate Logical Reports’ option is used to solve the problem caused by DJDEs calling different JDEs in an incoming data stream.

A change of JDE causes Paris to go into its ‘end of job’ processing loop. In the case of a PostScript printer, this means that the resources are flushed and have to be re-sent.

Each time the JDE changes, it also creates a new job entry on the printer. In extreme cases where the JDE is changing on almost every page the result can be hundreds or potentially thousands of small jobs being submitted to the printer. This also means that with each new job the resources are re-sent to the printer.

Why is the option necessary? The combination of the above factors has a severe impact on printer performance. To prevent both the continual reloading of resources and flooding the printer with numerous tiny jobs, the Concatenate Logical Reports option is used. This instructs Paris to append small print jobs into a single large job.

' To append small print jobs into a single large job:

Select the ‘Concatenate Logical Reports’ checkbox

! NOTE: Incrementing output file names or extensions is explained under Using NEXTFILE as the output destination in Chapter 1, Printer Definitions.

Chapter 2


Splitting the files in a print job

The ‘Split output after page’ option is used to split large files into several smaller files. For example, if a 10,000-page file is split at every 1000 pages, the result would be 10 files of 1000 pages.

' To split the files in a print job: 1. Select the ‘Split output after page’ checkbox.

2. Enter the page position for the file splitting in the adjacent text field.

Job Definitions


Specifying the number of copies to be printed for a selected printer

The number of copies of the file to be printed is entered in the ‘Selected printer copies’ box. If more than one printer is specified in the list, a different number of copies can be specified for a selected printer. The output will automatically be sent to each of the listed printers according to the number of copies specified.

! NOTE: The Total Copies box reflects the total number of copies sent to all the printers in the list.

' To select the number of copies: 1. Select the required printer from the list.

2. Enter the number of copies required in the ‘Selected printer copies’ text box.

2. 1.

1.

2.


MO D I F Y I N G A JO B D E F I N I T I O N

Once a job has been defined, the job definition settings can be viewed and, if required, changed.

'''' To view/change the settings for a job definition: 1. Select View List from the Definitions menu to display the View/Change Job

Definitions dialog that lists the jobs that have been added.

2. Select the job to be changed from the list, then click on the Edit button to display the View/Change Job Definition Settings dialog.

3. Edit the job settings as required, then choose OK to exit the dialog and return to the View/Change Job Definitions dialog.


D E L E T I N G A J O B D E F I N I T I O N

If a job definition is no longer required, it can be deleted.

' To delete a job definition: 1. Select View List from the Definitions menu to display the View/Change Job

Definitions dialog that lists the jobs that have been added.

2. Select the job to be deleted from the list, then click on the Delete button. A Request dialog will be displayed for you to confirm the deleteion.

3. Choose Yes or No as required.


Chapter 3

E N G I N E D E F I N I T I O N S

The Paris Spooler is capable of launching and managing multiple formatting engines.

HO W T H E SP OO L ER M A N A GES M ULT I P L E EN GI N E S

When a job arrives for processing, the Spooler automatically searches for an available formatting engine and assigns the job accordingly.

For example, if you had the Spooler running with 2 engines launched and a 1000 page job arrived followed by a 2 page job, the first job (1000 page) would be assigned to one engine and the following job would be assigned to the other available engine. This means that the second job does not have to wait until the first job is completed.

HO W M A N Y EN G I N E S C A N B E A D D ED A N D LA UN C H ED?

There is no upper limit to the number of engines launched by the Spooler, but rather it is governed by the practical processing limits of the hardware platform.

L I N K I N G A N EN G I N E T O A PR I N T E R

When adding an Engine to the Spooler, an option is available in the View/Change Engine dialog whereby you can link an engine to a particular printer.

Linking an engine to a printer is an advantage in situations where many small print jobs are being printed to disk at the same time as normal print jobs. By linking the printer and engine, the engine does not need to keep changing its ‘character’ for the different printer types.


AD D I N G A N EN G I N E

Print engines are added via the View/Change Print Engines dialog which is displayed by selecting ‘View List’ from the Engines menu.

' To add an engine to the list: 1. Click on the Add button in the View/Change Print Engines dialog to display

the View/Change Engine dialog.

Chapter 7: Functions in the Utilities menu


Options

2. Either: Accept the default setting, Or: Type in a name for the engine. The name can be Alphanumeric, up to 16 characters.

3. For the engine to automatically start when the Spooler is started, leave the Automatic Startup checkbox selected (default setting). If you do not want the engine to start automatically, click on the Automatic Startup checkbox to remove the check.


Printers 4. To ‘Print to any printer’, select that option.

To ‘Print only to selected printer’, select that option to activate the Choose Printers button, the click on the button to display the Choose Printers dialog and choose a printer from the list. Choose OK to return to the View/Change Print Engines dialog.

5. In the View/Change Print Engines dialog, choose OK. The added engine will

be launched when the Spooler is restarted (if Automatic Startup has been selected).



LAUN C H I N G AN EN G I N E

You can launch an engine that is not attached at any time, or if you add an engine and wish to launch it immediately without restarting the Spooler, you can do so.

! NOTE: The availability status of an engine is displayed in the View/Change Print Engines dialog as ‘Not Attached’ or ‘Available’.

'''' To launch an engine: 1. Select the engine to be launched from the list in the View/Change Print

Engines dialog. 2. Select the Launch button. Once launched, the status of the selected engine will

be displayed as Available and the ‘Launch’ button will toggle to ‘Shutdown’.

2

1, 2


ED I T I N G AN EN G I N E

To edit an engine, it must first be shutdown

' To edit an added engine: 1. Choose View List from the Engines menu to open the View/Change Print

Engines dialog.

2. Select the engine from the list in the View/Change Print Engines dialog and, if required, select the Shutdown button. The status of the engine will change to Not Attached and the Edit button will become available.

3. Choose the Edit button to display the View/Change Engine dialog.

4. Make the required changes then choose OK.



DE L ET I N G A N EN G I N E

An added engine can be deleted, but the engine must be shutdown before the Delete button becomes available.

' To delete an added engine: 1. Select the engine from the list in the View/Change Print Engines dialog and, if

required, select the Shutdown button. The status of the engine will change to Not Attached and the Delete button will become available.

2. Select the Delete button to delete the engine then select OK from the Request dialog to confirm the deletion.


Chapter 4

T H E S P O O L E R U T I L I T I E S

The Spooler Utilities menu contains the Resource Manager, Euro Rates and Accounting utilities.

The Resource Manager is used to pack and unpack resource files in the Paris system and provides an easy mechanism for the distribution of Paris resources from one system to another.

The Euro Rates utility offers users of the Paris system the ability to view fixed Euro rates and add and/or edit variable currency rates. The fixed conversion rates (as determined by the European Central Bank [ECB]) are also supplied.

The Accounting Utility keeps track of the flow of jobs through the Spooler and allows access to job information such as:

•••• The total number of jobs printed since a given date

•••• The completion status of any job

•••• The number of pages printed for a given job

•••• The total number of pages printed since a given date.


T H E R E S O U R C E M A N A G E R

The Resource Manager provides an easy mechanism for the distribution of Paris resources from one system to another. Its most important role is to gather all the resources from a newly developed or modified application in the Paris Designer and write it to a file. When sent to the Paris Spooler and unpacked, this file automatically updates the Spooler’s directory structure with all the files required for this newly designed application.

The unpacking function in the Spooler is achieved simply by loading and printing the file, however, in the Spooler, the Resource Manager can be used in exactly the same way as in the Designer to pack and unpack files.

Opening the Tools menu and choosing Resource Manager will display the Resource Manager dialog which contains five buttons/options. These are New, Add, Open, Extract and Done. The ‘Done’ button exits the user from the Resource Manager.

The dialog contains two views where information is displayed. The upper view displays the names and types of the resources that have been packed, whereas the lower view is a log view that simply displays a log of each pack session. There is also an Activity display, that ‘animates’ during the pack/unpack process.

The Resource Manager


HO W D O ES RE SO UR C E PA C K I N G WO R K?

The packing process does not ‘pack’ the file in the normal sense, that is the file does not become smaller. It uses a form of sixel encoding to ensure all characters in the file are in the normal printable character image. This prevents any character integrity problems if the file is transferred from PC to host and back again (this is especially important as the fields to be transferred are often font or graphic files which contain a large percentage of non-printable characters.

When the file is unpacked a reverse form of sixel encoding is done to return the file to its original state..

Packing and unpacking resources can be done in any order. For example, you may select to open a .pak file first, however, the following descriptions will follow the standard procedure for using the Resource Manager.

Chapter 4


PA C K I N G RES OUR C ES

The Resource Manager can be opened by selecting Resource Manager from the Tools menu.

' To pack resources:

! NOTE: By default, the pack file name is generated as pack1.pak, pack2.pak, and so on. This can be overridden by specifying your own file name and path in the file name edit box.

1. In the Resource Manager dialog, click on the New button to display the Packer Options dialog.

2. In the Pack File Name edit box, enter the path name and file name of the new pack (.pak) file. OR Click on the button adjacent to the edit box to display the‘Save in’ dialog and if it is not displayed, select the PARIS/USR directory. Enter the filename in the File name text box then click on Save.



SET T I N G T H E PA C K ER OP T I ON S

Runtime Options

Text

Offset

Skip

Runtime Options are Text, Offset, Skip and Length.

Every .PAK file begins with a Runtime event record1. This is entered in the ‘Text’ box. The default identifier is “$XLP”. The receiving system must also have the same 2identifier for this to be recognized as a valid .PAK file. Refer to: 1‘Runtime Events’ and 2‘DJDE Functions Supported in Paris’ in the Paris Designer Reference Manual.

! NOTE: The Resource Manager has a built-in function to detect whether a file is a valid pack file or not. In the event of the receiving system not having the same identifier, you will receive an early warning message and thus be able to avoid having the file rejected by the receiving system.

This is the Offset to the Runtime event identifier (refer to Offset under Runtime Events in the Paris Designer Reference Manual) and specifies the offset in bytes of the .PAK file. The Offset is 0 by default.

This value is the ‘skip’ (from 0) to the starting position of the command sequence in the Runtime event. This must match the skip in the receiving system.

Chapter 4


Line Length

Variable

Fixed Length

OK

The line length can be either fixed or variable. The default record length for .PAK files is variable.

The user can select the way each line is terminated by selecting from the options in the drop-down menu: Carriage Return; Line Feed or Carriage Ret/Line Feed

The ‘fixed line length option is very rarely used, however, in some host transfer situations variable length records cause difficulties. To overcome this, the option is available to set the line length at a fixed number of characters.

Selecting the OK button will display the ‘Add Resource’ dialog.

! NOTE: The Packer Options dialog settings are 'sticky’, meaning that they save their values each time you exit the Resource Manager.



PAC K I N G F I L ES

Select File Type

The Select File Type drop-down menu lists the resources that can be packed. That is environments, forms, pagedef, font graphics, translation table and so on. The dialog will list files of the currently selected resource type, the default setting is environment.

It is important to understand that there are resources that can hold further resources within them and ‘atomic’ resources which cannot.

For example, an environment can contain forms, forms can contain graphics or fonts. However fonts cannot contain further resources. Hence, an environment or form is a resource, and a font or graphic is termed an ‘atomic’ resource. Hence, the radio buttons are enabled and disabled according to the selection of resources. If a ‘non-atomic’ resource is selected, then all the three radio options will be available.

Add Selected Files Only:

This option will pack the selected resources only.

Add Selected Files and Required Resources:

This option ‘unconditionally’ packs the resource and its associated sub resources.

Chapter 4


' To pack selected files only or selected files and required resources: 1. Select the file type and the required files, then the desired radio button

(either Add Selected Files Only or Add Selected Files and Required Resources).

2. Choose OK. The Resource Manager dialog will be displayed and the selected files will be packed (indicated by the busy Activity dial). A log is generated simultaneously indicating the status of the pack and finally the number of files packed .is displayed



View and Select Resources Pack:

This option (also called the advanced resource selection) allows you to select a resource then select which sub-resources you want to pack.

' To view and select resources to pack: 1. Choose a resource, then the View and Select Resources Pack radio button

2. Choose OK. The Advanced Resource Selection dialog will be displayed, showing the selected resource(s) and their associated sub-resources.

3. Select which sub-resources to pack then choose OK.

4. The selected files will be packed and displayed in the Resource Manager dialog.

Chapter 4


UNP A C KI NG RES OUR C ES

' To unpack resource files: 1. Open the Resource Manager, then click on the Open button, to display the

Select/Enter File To Open dialog and the .pak files in the system.

2. Double-click on the required .pak file to display all the contained resources in the Resource Manager dialog.



3. Either select each resource as required, or select all resources, and then click ‘Extract’. This will extract all the resource files from the .pak file, and place them in their respective directories. If such a resource already exists in the directory, the Resource Manager will ask whether or not the file should be overwritten.

Chapter 4


FAQS A N D TR OUB L ES H OO T I N G

Q: I selected an environment with a .ttf font in it, but this font never shows up in the tree dialog, neither does it get packed using the Add Selected Files and Required Resources option. What's going on?

A: The true type fonts are handled differently.

1. As soon as the Resource Manager starts up, a true type font table is built. 2. The Resource Manager scans the /windows/fonts/ directory and for each

physical .ttf file it picks up, it figures out the corresponding logical name. Thus, for a file called ‘arial.ttf’, the generated logical name would be something like ‘Arial Regular 10’. Normally, when you choose an environment with an ‘Arial Regular 10’ font (the logical name) to pack, the Resource Manager figures out the actual file name (in this case, arial.ttf) by looking it up in the table for the corresponding logical name. Assume that you select an old environment, possibly brought over from another machine, and further assume that this environment contains a ‘Garamond Regular’ font that was present in that machine. If this font is absent in your font directory, when the Resource Manager starts up, it will not have an entry for the logical and physical names for the ‘Garamond Regular’ font. Hence, when the Resource Manager encounters a font called ‘Garamond Regular’, it will look up the true type font table to find if such a font exists. Naturally it does not, so the font is neither displayed nor packed.

! NOTE: This is the only satisfactory way of handling true type fonts. The other option of looking at font entries in the Windows registry is not sufficient, as not all fonts in the Windows font directory have entries in the registry. If the font is to appear in the registry, then it should be properly installed. Only by scanning all the .ttf font files in the Windows font directory and reading their internals for the corresponding logical names would result in the most accurate .ttf font table as this reflects all the current true type fonts in the system.



Q: I just received an ‘Unhandled exception, contact program vendor’ message while using the RM, and Paris crashed.

A: The most probable reason is that the Paris fonts.ini file or some other system file has been edited. The fonts.ini file should not be edited nor should any font references be deleted from the /Utilities/Font References menu in Paris.

Q: The ‘log window’ seems to display out of sync data. I packed 4 files, then 2 files, but the window displays ‘2 files packed’ instead of ‘6 files packed’. Why?

A: This is part of technical design. Each pack operation is unique, whether you create one anew or you add resources to an existing .pak file. Therefore, the log window displays only the output for the current pack operation.

Q: I can see a font resource in the Advanced Resources Selection dialog (View and Select Resources Pack option) within an environment, but when I select it and try to pack it from either the dialog or by using the Add Selected Files and Required Resources option, it does not pack. Why?

A: The most common problem is that the environment file or form or pagedef containing the offending font has been imported from another machine, so it shows the font without any problems. However, when the pack routine tries to pack this font, it looks for the corresponding physical file (for example, an lpf font called "line printer 9 regular" may not have the required physical file (LI90.lpf or a similar name) in the paris/env/fnt/ directory.

! NOTE: The .ttf fonts are in the Windows font directory and .lpf fonts are in the paris/env/fnt/ directory.

Chapter 4


Q: When I select the ‘Font’ file type in the Add Pack Files dialog, it shows me all the fonts, but when I select and try to pack it, I cannot. Why?

A: The fonts you see appearing in the view are actually taken from the fonts.ini file, which is stored in an internal list in Paris. The Resource Manager reads and displays the fonts from this list. In order for everything to be in sync, the logical names of .lpf fonts (such as line printer 9 regular) in fonts.ini reflects or corresponds to the actual physical files on disc (in this case, LI09.lpf or similar name). Hence, if a user deletes the physical file, the reference is still in the fonts.ini file, and Paris will still build a list that contains the logical name. However, there is no corresponding physical file on disk in the Paris fonts directory. Therefore, another way of putting this question would be “I have 10 physical .lpfs in my Paris fonts directory, but more than that appears in the font view in the add dialog” … the answer is that some physical files have been deleted in the Paris fonts directory.

Q: I’m trying to unpack a .pak file, but the Resource Manager keeps coming up with the message ‘Not a valid pack file’. Why?

A: The only answer is that the .pak file has been corrupted, or the file extension of a normal file has been deliberately changed to .pak, a highly improbable occurrence.


T H E E U R O R AT E S U T I L I T Y

The Euro Rates utility offers users of the Paris system the ability to convert any national currencies, including conversion to the Euro and vice-versa.

The Paris system also allows dual currency printing on a network, thus providing businesses with the opportunity to bill customers in both the contracted currency and the national currency of the customer (at the current conversion rate).

Conversion rates for the European Monetary Union countries are fixed. For the participating European Monetary Union countries the fixed conversion rates (as determined by the European Central Bank [ECB]) are supplied within the Paris Euro Rates utility. For other non-participating countries with variable currency rates, the Euro Rates Utility offers the ability to define, edit and delete their own conversion rate.

The Euro Rates utility is available in both the Paris Designer and the Paris Spooler where the fixed Euro rates can be viewed and variable currency rates can be added and/or edited.

Selecting Euro Rates from the Utilities menu will display the Select Euro Access Level dialog.

Chapter 4


AC C E S S L E V E L S I N T H E EUR O RA T E S U T I L I T Y

There are three access levels in the Euro Rates utility. The first allows any user to view the fixed Euro rates for the participating countries in the European Monetary Union. The remaining two levels are password protected and allow authorized users the ability to add, delete and edit fixed and variable rates as required.

The country code, country and fixed conversion rate for the participating countries are as follows:

Code Country Conversion Rate

ATS Austria 13.7603 BEF Belgium 40.3399 FIM Finland 5.94573 FRF France 6.55957 DEM Germany 1.95583 IEP Ireland 0.787564 ITL Italy 1936.27 LUF Luxembourg 40.3399 NLG Netherlands 2.20371 PTE Portugal 200.482 ESP Spain 166.386

The Euro Rates Tool


View Conversion Rates

This view is available to any user and displays the View/Change Conversion Rates dialogue. The fixed exchange rates for the currency of each of the 11 countries participating in the European Monetary Union are listed. At this access level, the rates can be viewed only.

View Fixed Rates, Edit Variable Rates

To add or edit a variable rate, a password is required to gain access to the dialogue. The default password is ‘Operator’ and should be changed as soon as possible. Once access is gained, only variable rates can be added or edited, fixed rates are view only.

Edit Any Rate

With ‘Supervisor’ access, a fixed rate can be added, edited or deleted should this become necessary. To do this, a password is required to gain access to the dialogue. The default password is Supervisor (the highest access level) and may be changed when required.

!CAUTION! Passwords can and should be changed for reasons of security and should be made known only to those users granted the right to add or edit variable rates. Refer to ‘Set New Password’ on page 151.

Chapter 4


Defining the attributes for a Variable Conversion Rate

When you add or edit a Conversion Rate, the following attributes are defined.

Currency Id

The Currency Id is the standard currency code as set by the International Standards Organization (ISO). Refer to Table 8 - 1 at the end of this chapter for the currency code for all countries.

Description

The Description is of the country’s currency. For example, the Yen for Japan or the Pound Sterling for the United Kingdom. A description of each country’s currency is available in Table 8 – 1.

Rate

The current conversion rate for the added variable currency against the fixed Euro rate. The user adding or editing the conversion rate is responsible for establishing its current value.

Date Set

The Date Set is automatically generated by the system clock on your PC indicating the day the conversion rate was added. This attribute cannot be edited.

The Euro Rates Tool


Verify

The number of days from the Date Set that you wish to be notified of the need to check the set conversion rate. This is done by the Spooler before a job is printed. The default setting for the Verify field is 1. You are strongly advised not to change the setting.

•••• If you do wish to change the setting to more than one day you may do so by entering the required number (of days) in the Verify field.

•••• If you do not wish to be notified you can set the Verify field to 0 (zero).

Chapter 4


Viewing Conversion Rates

' To view Euro Conversion Rates:

1. Click on the Utilities menu in the Environment Editor and choose Euro Rates from the menu to display the Select Euro Access Level dialogue.

2. Choose ‘View Conversion Rates’ from the drop-down menu, then choose OK. The View/Change Euro Conversion Rates dialogue will be displayed.

3. Use the scroll bar to scroll through the list and view each of the fixed Euro rates and the ISO currency code. (e.g. IEP = Ireland)

4. Make a note of the required currency code and rate, then choose OK to close the utility.

The Euro Rates Tool


Viewing Fixed Rates, Adding or Editing Variable Rates

' To add or edit a variable rate:

2. Choose ‘View Fixed Rates, Edit Variable Rates’ from the drop-down menu, then choose OK. The Password text field will become available for entry of the default password (Operator).

3. Enter the password (Operator) then choose OK. The View/Change Euro Conversion Rates dialogue will be displayed. The ‘Add’ button beneath the Variable Rates section of the dialogue will be available. If previous variable currency rates have already been added, the Edit and Delete buttons will also be available.


3

2

Chapter 4


1

' To add a variable rate:

6

6. Click on OK. The added rate will be listed in the View/Change Euro Conversion Rates dialogue.

With ‘Operator’ access, a variable rate can be added, edited or deleted. 1. Click on the Add button

to display the View/Change Euro Conversion Rates dialogue.

2. Type in the currency code required, e.g. JPY for the Japanese Yen [refer to the table at the end of this chapter].

3. Enter a Description of the currency (in this case Yen).

4. Enter the current conversion Rate for the Yen to the Euro.

5. The Verify text box contains the default setting of 1 - the number of days allowed to expire before you are requested to check the set variable rate.

The Euro Rates Tool


Editing Any Rate

' To edit any rate:


2. Choose ‘Edit Any Rate’ from the drop-down menu, then choose OK. The Password text field will become available for entry of the password ‘Supervisor’.

3. Enter the password then choose OK. The View/Change Euro Conversion Rates dialogue will be displayed with all the buttons in dialogue available. Any previously added variable currency rates will also be displayed.

1. To display the View/Change Euro Conversion Rate dialogue, Either: Double-click on the rate to be changed, Or: Right-mouse click on the rate to be changed and choose Edit from the pop-up menu Or: Select the rate to be changed then click on the Edit button.

With ‘Supervisor’ access, a fixed rate can be added, edited or deleted if required. Variable rates can be added, edited or deleted as necessary.

' To edit a selected rate:

1

2

3

Chapter 4


2. Type in the required rate then click on OK. The edited rate will be listed in the View/Change Euro Conversion Rates dialogue.

2

The Euro Rates Tool


Set New Password

To set a new password, you must first log in as the Operator or Supervisor, then change the password as follows:

! NOTE: Remember to make a note of your new password as once you exit, the next time you use the Euro Rates function you will need it to gain access to the required level.

1. Open the Euro Rates utility, then choose the required access level.

2. Depending on the access level selected, type in the default password (Operator or Supervisor), then select the Change button to display the Set New Password dialogue.

3. Type in the new password (it must be at least 6 characters, upper or lower case), then type the password again in the Confirm box.

4. Click on OK. You will be returned to the Select Euro Access Level dialogue.

2

3

2

1

4

3


A C C O U N T I N G U T I L I T Y

The Accounting Utility keeps track of the flow of jobs through the Spooler and allows access to job information such as:

•••• The total number of jobs printed since a given date

•••• The completion status of any job

•••• The number of pages printed for a given job

•••• The total number of pages printed since a given date.

WH A T I S T H E N OR M A L F L OW OF J O B S?

The normal flow is for a job to ‘arrive’ at one of the Spooler’s input sources, be queued for printing, be printed by the Engine, and then deleted.

There are a few variations on this basic situation:

•••• A queued job can be deleted before it is printed.

•••• A job that starts printing can be aborted (either by the user or the Engine).

•••• An aborted job is requeued immediately, and will either be ‘released’ for printing or deleted.

All of this combined means that there are two ways for a job to enter the system: queued, and requeued (after an abort) and three ways for a job to leave, ‘printed’, ‘aborted’ and ‘deleted’. In the case of ‘aborted’, the job does not really leave - it simply re-enters the system as ‘requeued’.

The Euro Rates Tool


WH A T D O ES T H E AC C OUN T I N G UT I L I T Y E N A B L E M E T O

D O? The Accounting Utility enables you to:

1. View on screen a list of the all the current accounting information •••• Show the entire list of completed jobs, sorted by date/time, ENV, output printer

and completion status.

•••• Filter the list of jobs via a given date/time range (e.g. ‘last 3 days’, ‘last week’) with selected attributes (ENV, output printer, completion status)

•••• Show a page total for the currently displayed list of jobs.

2. Manage the accumulated accounting info •••• Completely clear the accounting info

3. Export the current accounting info to an external file (in XML format) •••• Output all details for entries in the current view.

•••• Output all details for all entries.

4. View and change the settings for accumulating accounting info •••• Decide what to store

•••• How much to store (and when to clear automatically)

Chapter 4


ST A R T I N G T H E AC C O U N T I N G UT I L I T Y

' To open the Accounting Entries dialog:

Click on the Utilities Menu and choose Accounting.

The upper panel of the dialogue (Entries) enables you apply filters to the print jobs you want to show by choosing from the attributes available for Date/Time, Environment, Printer and Completion Status .

The Euro Rates Tool


Selecting the Display Filters

You can choose to filter the list of print jobs by a combination of Completion Date, Time, Environment, Printer and Completion status. The last filter settings will be saved and displayed when you next open the Accounting Entries dialog.

Completion Date/Time

Select an option for the completion date and time as required. The options are:

•••• Any Date or Time

•••• In the last: The options in the pop-up menu are Month, Week, 3 Days

•••• Between: The pop-up menus display a calendar from which the month, day and year for the start and end date can be selected.

Environment

Select an option for an environment as required. The options are:

•••• Show All: Selecting this option will display all print jobs with any environment and within the other selected display filters.

•••• Equal To: - Selecting this option will activate the pop-up menu which lists all the environments in the print jobs within the other selected display filters. - Selecting an environment from the list will display print jobs that contain that environment and other selected display filters.

•••• Not Equal To: - Selecting this option will activate the pop-up menu which lists all the environments in the print jobs within the other selected display filters. - Selecting an environment from the list will display print jobs that do not contain that environment and do contain other selected display filters.

Chapter 4


Printer

Select an option for a printer as required. The options are:

•••• Show All: Selecting this option will display all print jobs with any printer and within the other selected display filters.

•••• Equal To: - Selecting this option will activate the pop-up menu which lists all the printers in the print jobs that are within the other selected display filters. - Selecting a printer from the list will display print jobs that contain that printer and other selected display filters.

•••• Not Equal To: - Selecting this option will activate the pop-up menu which lists all the printers in the print jobs that are within the other selected display filters. - Selecting a printer from the list will display print jobs that do not contain that printer and do contain other selected display filters.

Completion Status

Select an option for the completion status as required. The options are:

•••• Show All: Selecting this option will display all print jobs with any completion status and within the other selected display filters.

•••• Equal To: - Selecting this option will activate the pop-up menu which displays the completion status (Complete, Aborted, Deleted) in the print jobs that are within the other selected display filters. - Selecting a status (Complete, Aborted, Deleted) from the list will display print jobs that contain that status and other selected display filters.

•••• Not Equal To: - Selecting this option will activate the pop-up menu which displays the completion status (Complete, Aborted, Deleted) in the print jobs that are within the other selected display filters. - Selecting a status (Complete, Aborted, Deleted) from the list will display print jobs that do not contain that status and do contain other selected display filters.

The Euro Rates Tool


Displaying the Accounting Information after the filters have been selected

' To display accounting info: Click on the ‘Show Items’ button. The jobs that have been printed relevant to the filter options selected in the ‘Entries ‘ section of the dialogue will be displayed in the ‘Show Items’ panel of the dialogue.

! NOTE: The ‘Show Items’ button will be ghosted after it has been selected and will be available again (un-ghosted) when you choose another filter. This indicates that you must click ‘Show Items’ again when another filter is chosen.

Print Jobs displayed in Show Items panel with filters ‘Any Date or Time’, ‘Show

All’ Environments, ‘Show All’ Printers and with a ‘Completed’ Status

Chapter 4


Viewing the Accounting Info items Each item in the Accounting Info panel contains the following attribute:

•••• Input file name

•••• Input source (LPD/Disk etc.)

•••• Initial ENV

•••• Initial printer

•••• Number of copies printed

•••• Date/time queued

•••• Completion status (i.e. completed, deleted or aborted)

•••• Date/time completed

•••• Pages printed

Sorting the Accounting Info items

' To sort the Accounting Info items:

Click on the column heading of the attribute. (For example, click on File Name to sort the file names in descending order.)

Clearing the Accounting Info

' To clear the Accounting Info: 1. Click on the ‘Clear Accounting Info’ button. A Request dialog will be

displayed for confirmation.


! NOTE: Once items are cleared, ‘Export Current Items To XML File’ button will be ghosted to indicate that there are no items to export as the accounting info has been cleared.

The Euro Rates Tool


Backing up Accounting Info

' To back up accounting info: 1. Click on the ‘Back Up Accounting Info’ button. The Save As dialog will be

displayed.

2. Choose the path (directory, sub-directories) in which to save the file and in the ‘File Name’ text field enter the enter the file name with the file extension ‘.txt’.

! NOTE: The file is saved as a comma delimited text file.

Exporting Accounting Info into an XML File

' To export accounting info into an XML file format: 1. Click on the ‘Export Current Items To XML File’ button. A pop-up dialogue

will be displayed.

2. Choose OK. The items will be exported into a XML format file in the

Paris\Spl directory as ‘accounts.xml’, which can be opened in your web browser.

! NOTE: This only exports current items in the ‘Show Items’ view. To export all items choose filters to ‘Show All’ for ENV, printer and status and ‘Any Date or Time’ for date.

.

PART THREE JOB CONTROL AND PROCESSING

CHAPTER 5: JOB CONTROL

CHAPTER 6: SINGLE JOB OR BATCH MODE PROCESSING


Part Three JO B C O N T R O L A N D P R O C E S S I N G

As well as providing processing control via the Online and Offline options in the Printer drop down menu, the Spooler provides specific job control and single job processing via the Jobs menu.


Chapter 5

JO B C O N T R O L

The Paris Spooler Jobs menu provides options specific to job control. A job can be paused, restarted, held or released. Page controls are also available for a selected print job.

The first section is context sensitive and will display the options Pause, Restart, Hold or Release, depending on the status of the currently selected print job.

The options ‘Move Forward’ and ‘Sample Page’ are used for page control for the selected print job.

The ‘Print Next’ option allows you to move a print job up the queue.

1

2

3


PA U S I N G , R E S TA R T I N G , H O L D I N G A N D R E L E A S I N G A JO B

The status of a job is displayed in the Status column in the Paris Spooler Control panel.

If a job is selected from the list of print jobs in the Paris Spooler control panel, the first option in the Jobs menu will display Pause, Restart. Hold or Release according to the current status of the job.

PA US I N G A JOB

' To pause a job that is currently processing: 1. EITHER:

Select the job from the list of print jobs in the Paris Spooler control panel, then open the Jobs menu, OR: Click the Right mouse button on the job in the control panel. The Jobs menu will be displayed.

2. Select Pause from the menu. The job will be paused and the status of the job will displayed in the Status column in the control panel. The option in the menu will change to Restart.

The ‘Pause’ option can be selected to pause a job that is currently processing.

The ‘Restart’ option is displayed once a job is aborted or paused and can be selected to requeue or restart the job.

Chapter 5


RES T AR T I N G A JO B

' To restart an aborted or paused job: 1. EITHER:


2. Select Restart from the menu.

Job Control


HO LD I N G A JO B

If the selected job is not currently processing (the job is still in the queue waiting its turn), it can be held by selecting the Hold option from the Jobs menu.

' To hold a job: 1. EITHER:


2. Select Hold from the menu. The selected job will be held and the held status will be displayed in the Status column of the Control panel. The option in the menu will change to Release awaiting release of the held job.

Selecting a queued job then selecting ‘Hold’ from the Jobs menu will hold the job.

Once a job is held the option ‘Release’ will be displayed for the job. Selecting a held job then selecting ‘Release’ will release the job.

Chapter 5


REL EA S I N G A JO B ' To release a held job: 1. Either:

Select the job from the list of print jobs in the Paris Spooler control panel, then open the Jobs menu, Or: Click the Right mouse button on the job in the control panel. The Jobs menu will be displayed.

2. Select Release from the menu.

DE L ET I N G A JO B ' To delete a job: 1. Either:


2. Select Delete from the menu. The Delete Job Request dialog will be displayed.


Job Control


CO N T R O L L I N G M UL T I P L E J O B S In the same way that single jobs can be controlled, multiple jobs can be selected for holding, releasing and deleting.

Selecting a list of jobs Select a list of jobs in a printer by clicking on the first job in the list, then holding the Shift key down and clicking on the last job in a list.

Click on the RIGHT mouse button to display the Jobs menu and hold, release or delete the selected jobs.

A list of jobs that has been put on ‘Hold’. The Jobs menu displays ‘Release’ for the selected [held] jobs. Held jobs can be selected individually from the list and released, or the entire list can be selected again and released.

Chapter 5


Selecting individual jobs in a list

Select individual jobs from a list by holding the Ctrl key down and clicking on the required jobs.

Individually selected jobs that have been put on ‘Hold’. The Jobs menu displays ‘Release’ for the selected [held] jobs.

Select multiple jobs, then click on the RIGHT mouse button to display the Jobs menu and hold, release or delete the selected jobs. The example shows multiply selected held jobs that can now be released or deleted.


PA P E R A N D PA G E C O N T R O L

MO V I N G FOR W A R D I N A JO B

Selecting the Move Forward option allows a number of pages to be skipped at the beginning of a file.

! NOTE This option only applies to a job that has been previously paused.

SA M P L I N G A PA GE

This option is used to sample a page on a paused job.

Chapter 5


MOV I N G A P R I N T J OB T O T H E F R O N T OF T H E QUE U E

'''' To re-queue a job: 1. Select the job from the list of jobs in the control panel, 2. Select Print Next from the Jobs menu to move the print job to the top of the

list (and front of the queue). The re-queued job will be printed next.

Print Next control option for a selected print job


Chapter 6

S I N G L E JO B O R B ATC H M O D E P R O C E S S I N G

With job processing, the Spooler has been designed to be setup for the automatic control of the constant flow of repetitive jobs through the system in a real time on line environment. This is achieved by the use of Spooler Job Definitions (SJDs). As you read earlier in the manual, the SJD is the mechanism by which a repetitive processing instruction can be defined to the Spooler. Once this definition is setup, it is stored and then re-used whenever the matching conditions are encountered.

This automatic processing philosophy may not necessarily suit all situations. For example, in some environments such as service bureaus, much of the work is not repetitive, and virtually every job can be different. Also, during the development cycle there is often a requirement to produce a test run of an entire file. The Paris Designer system only has an ability to print a single page at a time from the editor, so the Spooler must be used to do a full ‘live’ test run.

SI N G L E SP O OL ER JOB REQ UE ST

In order to accommodate these needs for single job processing, the Paris Spooler has an option in the Jobs menu that easily allows single jobs to be added. This is achieved by bypassing the requirement to create a Spooler Job Definition, instead a dialog has been created that creates a single Spooler Job Request according to the information entered into the dialog.

This Job Request is then automatically added into the printer queue and submitted to the engine in the normal fashion. Once the job has been processed the Job Request disappears.

PR E P R OC ES S I N G I N A JO B REQ UES T

Preprocesses can also be added to a Single Job Request as they can to a Job Definition (refer to ‘Preprocesses in a Job Definition’ in Chapter 2 and Appendix E, ‘Using Preprocesses in the Spooler’).


A D D I N G A S I N G L E J O B

'''' To add a single job request: 1. Select Add from the Jobs menu. The Add Job Request dialog will be

displayed.

EN T ER I N G T H E IN P U T IN F O R M A T I O N

Enter the Input Information in the Data Source and Description boxes.

2. In the Data Source box: Either: Type the source path and filename for the input file in the Data Source box, Or: Click on the Browse button to display the Select/Enter File To Open dialog and select the input file.

3. In the Description box enter a description of the file. (The Description box will display the description ‘Disk File’ by default, however a description of your own choice can be entered which will be displayed in the Spooler control panel.)

4. Check the Delete File After Printing checkbox if required. If the option is not checked the file will not be deleted.

Single Job or Batch Mode Processing


AD D I N G A PR E P RO C ES S T O A JOB REQ UE ST

Preprocesses that have been defined in the Spooler can be added to a job request. (Refer to Appendix E, ‘Using Preprocessors in the Spooler.’)

• If a preprocess or a number of preprocesses are added, they will be processed in the listed order.

• The Preprocessing tab in the Add Job Request dialog will show all the preprocesses that the job will pass through, but will not show which preprocesses have already been completed.

• If a preprocess is removed but has already been completed, then the removal has no effect.

'''' To add a preprocess to a job request 1. Select the Preprocessing tab, then select the Add button to display the Select

Preprocess to Add dialog.

2. Select the required Preprocess from the dialog, then choose OK. The added preprocessing task will be displayed under the Preprocessing tab in the Add Job Request dialog.

Chapter 6


EN T ER I N G T H E OU T P UT OP T I O N S

Once the input source is specified you now need to tell the system which printer you wish to print to and what environment to use. Both options have a Browse button available to make the selection easy. In both cases these are Paris browsers rather than standard Windows file browsers.

1. In the Printer box: Either: Type in the name of the required printer, Or: Click on the Browse button to display the Paris Select Printer dialog and select the required printer from the list.

2. In the Environment box: Either: Type in the name of the required environment, Or: Click on the Browse button to display the Paris Select/Enter File To Load (.ENV) dialog and select the required environment from the list.

3. In the Copies box: Specify the number of copies you require.

4. At runtime, a job that is paused with the status ‘Operator Intervention Required’ requires you to open the View/Change Job Request Settings dialog for the job and enter a reply in the ‘Reply’ edit field. Refer to ‘Editing a Single Job’.



5. Once you have filled in all the details, click on OK.

Paris immediately generates a Spooler Job Request (SJR) and places it in the queue for that printer. If the printer is online, and no other jobs are in the queue, the job instructions will be immediately dispatched to the engine.

If other jobs are already queued it will simply be added to the end of the queue.

Chapter 6


SP E C I F Y I N G T H E PA GE RA N G E

Specifying the page range to be printed for a single job request is a useful option, for example in cases where a number of pages in a job need to be reprinted.

'''' To specify the page range to be printed: Either: Click on the All radio button, Or: Click on the Pages radio button and enter the page numbers as directed.

Once all the options are entered, click on OK. The added Job Request will be displayed in the list of print jobs in the Spooler Control Panel.



ED I T I N G A S I N G L E J O B

'''' To edit a job listed in the control panel: 1. Either:

Double-click on the print job to display the Job Request Settings dialog for the selected job, Or: Select the print job from the list, then select Settings from the Jobs menu to display the View/Change Job Request Settings dialog.

2. Edit the job settings as required.

Reply

If a job is paused with the status ‘Operator Intervention Required’ the ‘Reply’ edit field is used to respond to the message from the Engine. Any entry into the ‘Reply’ edit field will be sent back to the Engine when the job is ‘resumed’. The Engine will then fill the required Field selected in the environment (if any).

! NOTE: Operator Messages are entered in the Designer. When designing an environment, you can send a message to the operator and request a ‘Reply’ to the message by selecting a valid a field to be filled with a value at runtime.

Chapter 6


DE L ET I N G A J O B R EQ UES T

' To delete a single print job from the list, 1. Either:


2. Select Delete from the menu. The Delete Job Request dialog will be displayed.

3. Select ‘Yes’ or No’ as required.



FL U S H I N G T H E P R I N T J O B S F R O M A P R I N T ER

The print jobs that have been added to a printer can be flushed from the printer.

To do this, select the printer from the control panel, then select ‘Flush’ from the Printers menu. All the print jobs defined for the selected printer will be flushed (removed).

PART FOUR SPOOLER SYSTEM SETTINGS AND SPOOLER

CONTROL

CHAPTER 7: SYSTEM SETTINGS

CHAPTER 8: SPOOLER CONTROL


Part Four S P O O L E R S Y S T E M S E T T I N G S A N D S P O O L E R C O N T R O L

The System menu in the Paris Spooler control panel provides you with the options, ‘Settings’, ‘Processing’, ‘LPD Server’ ‘LPD Settings’ and ‘Exit’.


Chapter 7

S Y S T E M S E T T I N G S

The Settings option allows you to set system-wide default settings for the Spooler engine and the date and time format.

SP E C I F Y I N G T H E I N T ER V A L F OR V ER I F I C A T I O N OF T H E

EN G I N E C ON N EC T I O N

The first option, ‘Verify engine every [xx] seconds’ is the interval after which the Spooler will check to verify that the engine is still connected. The range is 1 to 99 with a default of 5.

Spooler Control


SET T I N G T H E DA T E A N D T I M E FO R M A T

The current date and time are displayed in the Spooler control panel Status Bar and can be altered.

Date Format

The Date Format options available for selection are:

DD/MM/YYYY e.g. 23/01/2001 MM/DD/YYYY e.g. 01/23/2001 DD MMM, YYYY e.g. 01 Jan, 2001 MMM DD, YYYY e.g. Jan 23, 2001 DD Month, YYYY e.g. 23 January, 2001 Month DD, YYYY e.g. January 23, 2001

Chapter 7


Time Format

The Time Format options available for selection are:

HH:MM:SS - 24 hour clock e.g. 18:43:22 HH:MM:SS - 12 hour clock, no am/pm e.g. 06:43:22 HH:MM:SS xx - 12 hour clock am/pm e.g. 06:3:22 pm

Spooler Control


CR EA T I N G A LO G F I LE F O R T H E P R I N T J O B S A S T H EY A R E

P R O C E SS ED

Selecting the Job Log option ‘Write Log to File’ will create a log file (Job.Log) for the print jobs as they are processed in the Spooler.

When ‘Write Log to File’ is checked, the ‘Clear Log Each Time Spooler Starts’ and ‘Clear Log Now’ options will become available. Select one of these options as required.


Chapter 8

S P O O L E R C O N T R O L

ST A R T I N G T H E SP OO LE R W I T H OUT D O W N LO A D ED P R I N T

J O B S B E I N G P R OC ES SE D

Apart from control of jobs via the Jobs menu, there may be instances when you wish to start the Spooler yet prevent any jobs that have been downloaded from being processed. For example, you may wish to make changes to a job definition or perform a test run.

To do this, start the Spooler with the command line parameter /T=FALSE.

The Spooler and Engine will both start, but the timing loop is not activated. This prevents processing messages being sent between the Engine and Spooler and as a result no processing takes place.

Spooler Control


PA US I N G T H E SP O OL ER

The Processing option allows you to temporarily stop the Spooler from performing its normal functions. It effectively turns off the Spooler timing loop, and as a result no new jobs requests will be automatically created, and no processing messages will be forwarded to the engine.

This option is useful for pausing the system to create new printer or job definitions, or for setting up test runs of new or changed applications.

Select ‘Processing’ from the System menu to resume processing.

! NOTE: If ‘Processing’ is not selected in the System menu, the Spooler is paused.

To pause the Spooler, select ‘""""Processing’.

Chapter 8


DI SP L A Y I N G T HE LPD SER V ER I N F O RM A T I O N

Selecting the LPD Server option displays the LPD Log dialog.

LPD Log

The LPD Log shows information about the connection. Included in the display are details of which port is connected and the maximum number of simultaneous connections allowed.

If the ‘Display Thread Information in LPD Window’ in the LPD Server Settings dialog is activated, the thread information is also displayed.

Displaying the LPD Log

The LPD Log dialog can be closed or minimized. When minimized, the LPD Log will be displayed as an icon in the lower right corner of the status bar. The icon is an image of a printer overlaid with an arrow ',,,,'.

To display the LPD Log dialog, right-mouse click on the icon and choose ‘Restore’ from the pop-up menu.

Alternatively, the LPD Server can be opened or closed from the Spooler System menu by selecting or de-selecting the LPD Server option

The LPD Log dialog logs the status of the LPD function where LPD Server is specified as the input source in a job definition. Refer to ‘Defining LPD Server as the Input Source’ in Chapter 2 of this manual.

Spooler Control


LPD SER V E R SET T I N GS

The LPD Server Settings dialog is opened by selecting LPD Settings from the System menu.

Settings options

The dialog allows you to specify a particular Port Number to listen to rather than getting the port allocated by the operating system. It also allows you to specify the maximum number of simultaneous connections.

Other options include showing thread information in the LPD window and a bypass option that can be used as an alternative to the Passthrough option.

Bypass Spooler option

The Bypass Spooler option provides a more efficient method of passing files through Paris than that provided by the existing Passthrough option. It does not replace the existing method it is in addition to it.

Chapter 8


The current Passthrough option is invoked by entering the keyword <NONE> or <NOFF> (no Form Feed added to EOF) as the environment name in the job definition. This instructs Paris to pass the file though to an available engine and process the file without formatting. The file is then passed to the output specified in the job definition.

The Bypass Spooler option allows you to use the Paris LPD to pass the file directly to disk without going through a Paris Engine. This provides added efficiency in that a Paris Engine is not required.

The option allows you to specify the target printer, add multiple printers and specify where and how the file is written to disk.

DE F I N I N G LPD SE R V ER SE T T I N G S

Open the LPD Server Settings dialogue by selecting LPD Settings from the System menu.

Settings

Listen for Incoming calls on Port Number

Enter the required port number in this text field.

Maximum simultaneous connections

Enter the required number of simultaneous connections in this text field (the default setting is 5)

Display Thread Information in LPD window

Select this checkbox to show thread information in the LPD window.

Spooler Control


Bypass Spooler

' To add a printer: 1. Enter the target printer name in the text field adjacent to the Add button. (The

printer name must be as defined in the printer definition list.)

2. Click on the Add button to add the printer name to the list below. The Directory and LPR fields will be activated.

3. Enter the full path name in the Directory text field.

4. Select the ‘Use LPR supplied name’ checkbox if required.

5. Select the ‘Delete LPR Control File’ checkbox if required (this option is selected by default)

6. Add other printers and select the directory and LPR options for each printer as required.

7. Choose OK when finished.

! NOTE: To delete a printer from the list, select the printer, then the Delete button.

Chapter 8


EX I T I N G T H E SP O OL ER

The final option in the System menu is ‘Exit’. Selecting this option shuts down both the Engine and the Spooler.

! NOTE: It is not advisable to shut down the Spooler or Engine mid-job. Ensure the Spooler is either paused or not processing before exiting.

APPENDIX A MODIFYING THE CHARACTER SELECTION TABLE


Appendix A

MO D I F Y I N G T H E CH A R A C T E R SE L E C T I O N TA B L E

The ANSI character set which is supported by Windows includes 256 characters, numbered 0 to 255. The standard definition of characters 0 to 127 correspond to the letters, numbers and symbols seen on a standard U.S. keyboard and it is these characters that are predominantly used in the English language.

The remaining characters (128 to 255) are generally unused and correspond to characters not usually found on your computer’s keyboard, such as accented letters, currency symbols and mathematical symbols.

Paris provides you with the option to control the number of characters downloaded in a character set by allowing you to modify the character selection table.

WH Y C O N T R O L T H E N U M B ER OF C H A R A C T E R S?

Paris manages printer resources, the downloading of fonts, forms and graphics to the printer, according to the capabilities of the device and PDL (Page Description Language) being used. By controlling the number of characters in a character set, the transmission time to the printer to download fonts can be reduced.

For example, if you are using a printer that requires the resources to be sent every time a job is printed, the transmission time to the printer is increased. If you are printing multiple jobs, you can reduce the transmission time by speeding up the downloading of fonts. This is achieved by modifying the number of characters being downloaded.

Appendix B: Understanding Serial communications


MO D I F Y I N G T H E C H A RA C T ER SE T

The number of characters within a character selection table is controlled from the ENGINES.INI file in the PARIS directory (PARIS/ENGINES.INI).

To modify the character set: 1. Open the ENGINES.INI file. The default settings for the ENGINES.INI file

are as follows: [XLEng0]

Connect=LOCALSpooler=XLSp10NLink=DLLCSTLimit=255

The command line ‘CSTLimit=XXX’ describes the current number of characters in the Character Selection Table (CST). The default setting is 255.

2. Edit the number of characters required within the range 0 to 255 (for example, CSTLimit=128 will provide the characters 0 to 127 which correspond to the letters, numbers and symbols seen on a standard U.S. keyboard).

! NOTE: All bitmap fonts that are downloaded are affected.

An example of an edited ENGINES.INI FILE:

[XLEng0]Connect=LOCALSpooler=XLSp10NLink=DLLCSTLimit=128

#### WARNING! The syntax rules for editing a file are strict. Command lines are case-sensitive and must be edited exactly in the format displayed.

APPENDIX B USING THE MEDIA MAPPING FUNCTION

Appendix B

U S I N G T H E M E D I A M A P P I N G F U N C T I O N

MED I A MA P P I N G OV E RV I EW

The Media Mapping function in Paris applies only to Xerox Docuprint 4050NPS, 4850NPS, 4090NPS, 4890NPS and 4635NPS printers. For these printers, Paris supports the selection of different paper stock for printing jobs through the Media Mapping function which is accessed within the View/Change Printer dialog.

As Paris ‘thinks’ in terms of trays and Docuprint printers ‘think’ in terms of media, the Media Mapping function allows the user to either describe Paris trays to the Docuprint, or the Docuprint media to Paris, whichever fits the user’s needs.

The Media Mapping function is a supplement to existing tray handling features for Xerox Docuprint printers, not a replacement.

Appendix A


SE T T I N G U P ME D I A MA P P I N G

Media Mapping is invoked whenever an XPD/PPD file contains at least one ‘*XLPInputMedia’ statement.

#### WARNING! Both XPD and PPD files are text files and can be edited using a standard text editor, however, it is recommended that these should NOT be changed except by experienced users or under instructions from the distributor. A full description of the working of XPD and PPD files can be found in ‘How do PPD (PostScript Printer Description) files work?’ in the Paris Designer Reference Manual.

Adding ‘*XLPInputMedia’ statements

The first step to setting up Media Mapping for your Xerox Docuprint is the addition of ‘*XLPInputMedia’ statements to any XPD/PPD that will be used to drive the Docuprint (XPD/PPD files are supplied as part of the Paris install).

• ‘*XLPInputMedia’ statements replace the Adobe ‘*InputSlot’ statements, and have an identical syntax.

• If an XPD/PPD file contains both ‘*InputSlot’ and ‘*XLPInputMedia’ statements, the ‘*InputSlot’ statements are ignored.

• ‘*XLPInputMedia’ statements tell the Paris system which printer uses Media Mapping and how many media options the printer supports.

• One ‘*XLPInputMedia’ statement is required for each option that is to be made available in the Environment Editor.

For example, the XPD/PPD file for a Docuprint with two input trays would contain two ‘*XLPInputMedia’ statements. A four-tray printer XLP/PPD would have four entries.

Each entry makes another option available in the Paris Environment Editor. For example, the statement *XLPInputMedia Upper: “” means that ‘Upper’ will appear in the editor as a valid option for tray selection.

Using the Media Mapping Function


Setting up Media Mapping for an Environment

Media and tray options are used identically to any other printer tray support options. For example, on an HP5 printer, the user selects ‘Upper’ in a pagedef, event or DJDE to select paper from the upper tray. On a Xerox Docuprint printer, the user selects ‘Upper’ to select paper from any tray that meets the mapping for ‘Upper’.

Selecting the Media Mapping button in the View/Change Printer dialog will display the View/Change Media Mappings dialog and the table of mappings for the environments in your Paris system.

Each user-defined Docuprint printer has its own table of mappings. Within this table there is a default environment mapping (<other>) which applies to any environment that does not have a specific mapping.

The mapping is added for a tray in an environment by selecting the Add button to display the View/Change Environment Mapping dialog.

Click on the ‘Add’ button to display the View/Change Environment Mapping dialog to add the mapping for a tray

Appendix A


Adding the ‘mapping’ for a tray in an environment

The View/Change Environment Mapping dialog will display a table of the default mapping and user-defined mappings for selected environments.

Default Mapping The default mapping simply assigns the default tray to be ‘any color, any weight, any type, any size’, in other words, the default mapping is to use any tray on the Docuprint. For users who do not need tray selections, this allows any job to print without any user intervention.

User-defined Mapping When a job requires tray selection, each tray that will be used within the job must be ‘mapped’ so that the Docuprint can select that media. Each tray can be mapped to a particular color, weight, type and size. Any or all of these can be blank.

! NOTE: The Size field should not be used unless you need to mix paper sizes within a job. If the job only uses a single page size, the Size field should be left blank.

Click on the Browse button to select the environment to be mapped



Selecting the environment to be mapped

The environment to be mapped is selected by clicking on the Browse button to display the Select/Enter File To Load (.ENV) dialog.

The selected environment will be displayed in the ‘Environment’ box.

To add the mapping for a tray, click on the ‘Add’ button to display the View/Change Media Mapping dialog.

Click on the Add button to display the View/Change Media Mapping dialog to ‘map’ a tray.

Selected environment

Appendix A


Mapping the tray(s)

The Media drop-down menu displays all the available tray assignments in Paris.

Media It is recommended to only use the ‘Upper’, ‘Lower’, ‘Middle’ and Tray4’ selections.

Size The Size values are entered in points (NOT dots). These values can be found in the page size section of the PPD for the printer to which you are printing. The values are entered as they appear in the PPD, that is, width then height.

For example: For letter size on a 4890NPS, you would enter 612 792 (no brackets with a single space between the two values).

'''' To map a tray: 1. Select the required Media and enter the Color, Weight, Type and Size values

into the appropriate edit box. 2. Choose OK. The added tray mapping will be displayed in the View/Change

Environment Mapping dialog.



Editing the mapping for a tray in an environment

The mapping for a tray is edited by displaying the required environment in the View/Change Environment Mapping dialog, then selecting the tray mapping to be edited.

The View/Change Media Mapping dialog will be displayed for editing.

Selected environment

Edited ‘type’ setting

Appendix A


Deleting the mapping for a tray in an environment

The mapping for a tray is deleted by displaying the required environment in the View/Change Environment Mapping dialog, then selecting the tray mapping to be deleted.

A warning box will request confirmation or cancellation of the deletion.



Editing the ‘mapping’ for an environment

The View/Change Media Mappings dialog will display the table of mappings for the environments in your Paris system.

To edit the mappings for an environment, select the environment, then the Edit button to display the View/Change Media Mappings dialog.

Tray mapping can be added to the environment or the current mapping can be edited or deleted (refer to the previous sections).

Select the environment

Select the Edit button

Appendix A


Matching the mappings to the printer

The final step is to ensure the mappings match the printer. The physical Docuprint printer must be configured to match these media using the SETTRAY console command.

It is not within the scope of this manual to describe the working of the SETTRAY function on the Docuprint. Refer to your Docuprint documentation for this information.



An example of setting up the Media Mapping for a Docuprint A Paris print destination called ‘DocuPS’ is created that uses a Docuprint printer with 4 trays. The XPD/PPD file would contain 4 entries:

*XLPInputMedia Upper: “” *XLPInputMedia Lower: “” *XLPInputMedia Middle: “” *XLPInputMedia Tray4: “”

This XPD/PPD means the Environment Editor will allow the creation of environments using any or all of these 4 trays.

• An environment called ‘Invoice’ is created. • Tray select events are created that, at various times during a job, call for all

4 trays to be used. • The Media Mapping option is selected in the ‘DocuPS’ printer

View/Change Printer dialog to create a mapping for the environment ‘Invoice’. This mapping MUST contain 4 entries (no more, no less). Each entry maps one of the trays used (Upper, Lower, Middle and Tray4) to a unique combination of color, weight and type. For example: Upper=white,75,plain

Lower=white,75,Cheque Middle=Blue,140,Cover Tray4=white,140,plain

Finally, the Docuprint must be configured so that each of the four physical trays has one of the above mappings.

Typically, the largest capacity trays would be configured to the most commonly used media, in this example ‘Upper=white,75,plain’.

The flexibility of this system is that the user can either configure the printer to match an environment’s needs, or create media mappings that match the printer configuration.

APPENDIX C MODIFYING PARIS JOB TICKETS


Appendix C

M O D I F Y I N G PA R I S JO B T I C K E T S

The Paris Job Ticketing function provides printers with the information necessary to create banner sheets for print jobs that contain:

$ the name of the user sending the job, $ a description of the job and $ account details for allocation of costs for the job.

! NOTE: Currently, Paris Job Ticketing applies to Xerox Docuprint 4050NPS, 4850NPS, 4090NPS, 4890NPS and 4635NPS printers only

JO B TI C K E T ST R U C T U R E

A Job Ticket is structured to contain three sections:

• the header, which contains one mandatory record,

• the control section, which in Paris contains three mandatory and one optional record,

• the trailer, which contains one mandatory record.

Record Structure

A Job Ticket record consists of the record name and a value as illustrated below .

Single space

Record name Value

%XRXsenderName: Paris

Appendix C


TH E PA R I S JO B TI C K ET ST RUC T U R E

The Paris Job Ticket file contains 5 mandatory records and an additional record for accounting purposes as follows:

%XRXbegin: the mandatory header record that identifies the beginning of the job ticket

%XRXdisposition: mandatory record containing the print instructions. PRINT is the only option supported by Paris.

%XRXsenderName: mandatory record containing the user’s name

%XRXtitle: mandatory record containing a description of the job

%XRXaccount: optional record containing account details

%XRXend the mandatory trailer record that identifies the end of the job ticket

Appendix C: Modifying Paris Job Tickets


HO W A R E JO B TI C K E T S EN AB L ED I N PAR I S?

The XLPrint supplied XPD files in the PARIS\PRT directory contain XPD statements to enable job ticketing.

Paris XPD Files

XPD files are the way Paris describes the features of the printer. They work either as standalone files, in the case of HP-PCL printers, or in combination with PPD (Postscript Printer Description) files, in the case of Adobe Postscript printers and are used to:

(a) describe the features of an output destination, and

(b) to put the appropriate instructions into the output file to call the features.

In general terms XPD files are created and supplied by your distributor. PPD files are those files supplied by the Printer manufacturer. An XPD for a PostScript printer simply contains a reference to include a corresponding PPD file in the XPD.

! NOTE A full description of the working of XPD and PPD files can be found in ‘How do XPD and PPD files work?’ in Chapter One of the Paris Designer Reference Manual.

Appendix C


XPD statements in XPD files

The XPD files in the PARIS\PRT directory contain XPD statements for job ticketing as follows:

*XPD_XJTVersion: 0200 This statement is compulsory to enable job ticketing and should not be edited.

*XPD_XJTEncoding: 100. The default encoding for this statement is ISO 10646 level 2 character set. This normally would not be changed.

*XPD_XJTSender: Paris The Sender field contains the user’s name and can be up to 40 characters. For example, Accounts Department. The default setting is Paris.

*XPD_XJTTitle: print file The Title field contains a description of the job and can be up to 40 characters. For example, Monthly Statements. The default setting is print file.

*XPD_XJTAccount: <account name> Account is a field of 3 to 12 characters which is used to specify the allocation of costs. For example, Admin.

The structure of an XPD statement is statement name, colon, space, value.

These statements create the Job Ticketing records: %XRXbegin: 100.0200 %XRXdisposition: PRINT %XRXsenderName: Paris %XRXtitle: print file %XRXaccount: <account name> %XRXend

Single space

Statement name Value

Colon

*XPD_XJTTitle: print file

Appendix C: Modifying Paris Job Tickets


MO D I F Y I N G A JOB TI C K ET

A Job Ticket is created by default via the *XPD_XJTVersion: 0200 statement in the XPD file for your printer and can be modified via the XPD file or via the Environment editor.

• A Job Ticket modified via the XPD file will apply to all print jobs sent to that printer

• A Job Ticket modified via the Environment Editor for a current environment will apply only to print jobs containing that environment.

Modifying a Job Ticket via the XPD file

XPD files are contained in the PARIS\PRT directory. Each XPD file contains the default XPD statements for job ticketing that will print a banner page with the default values (refer to the previous page).

You can either accept the default values for the banner page or edit the XPD file to enter your own values.

#### WARNING! XPD files can be edited using a standard text editor, however care must be taken when making any changes. Follow the instructions on the following page carefully and make changes only to those statements and values where indicated.

Appendix C


'''' To edit the XPD file: 1. Open the PARIS\PRT directory.

2. From the list of XPD files, open the file relevant to your printer.

In the XPD file, the only XPD statements that can be edited are: *XPD_XJTSender: Paris *XPD_XJTTitle: print file *XPD_XJTAccount: <account name> The only changes that can be made are to the default values for the sender of the print job (default: Paris), the title of the job (default: print file) and the account details.

3. Make the required changes (refer to page 212 for field sizes for each value).

4. Save the edited XPD file and close the file.

Job Tickets and LPR Control Files

LPR Control File processing is described under ‘Paris and LPR Control File processing’ in Chapter 2 of this manual. One of the main uses for LPR control file information is for generating Banner information on the output printer.

Paris Designer supplies the Environment Info dialog to allow the user to specify values to be included in the Job Ticket used to create banner pages (and accounting information) for Xerox printers. Refer to the Paris Designer Reference Manual.

1

2


APPENDIX D DEVICE SPECIFIC FEATURES IN PARIS


Appendix D

D E V I C E S P E C I F I C F E AT U R E S I N T H E PA R I S S Y S T E M

The Device Specific feature in the Paris system is an option that opens up ‘hooks’ into the output data stream generated by the Paris Print Engine, allowing the user to insert custom code at specific points in the code.

The intention of this option is to allow the user to insert code to activate device specific features such as stapling, binding, collating, folding and so on, however, it is a general purpose system, and the possible uses are left open to the user.


U S I N G D E V I C E S P E C I F I C F E AT U R E S

It is the user’s responsibility to ensure that the code to be inserted is correct, both in it’s immediate effects, and also in any ‘side-effects’ the inserted code may produce. The Paris system does not attempt to validate or understand the code to be inserted.

This feature is currently only active in the Postscript driver, but will be added to the HP PCL driver if required.

#### WARNING! A pre-requisite to using these functions is a thorough understanding of the workings of PostScript commands, including the manual editing of XPD files, the use of syntax and so on. See also ‘How do XPD and PPD files work?’ in Chapter 1 of the Paris Designer32 Reference Manual.

IM P L EM EN T A T I ON O F T H E DEV I C E SP E C I F I C F E A T U R E

The Device Specific feature option consists of four different ‘hooks’ and three different methods for specifying features. To activate a device specific feature, the following steps must be followed:

• Add the feature code to an XPD file. • Add a call to a feature to the Job (via ENV or Run time event).

The four hooks differ only in where in the output data stream the user code is inserted. The code to be inserted follows normal PPD/XPD syntax rules.

Following the ‘:’ character, the actual code must be enclosed in “” characters. It can span multiple lines. An XPD file can contain any number of user defined features.

Appendix D


Currently defined hooks

The currently defined hooks are:

1. Xerox Job Ticket

The user code will be inserted as part of the Xerox Job Ticket This hook is only available if Job Ticket processing has been activated (the printer XPD file contains an ‘XPD_XJTVersion’ option). If Job tickets are not active, calls to these features are ignored. (Refer to Appendix C, ‘Modifying Paris Job Tickets’ of this manual.)

Example: XPDFeature_XJT Binding: “%XRXbinding: binding via job ticket”

2. Job Level Comment

The user code will be inserted in the Comments section of the PostScript Job preamble.

Example: XPDFeature_JobComment Binding: “%%Requirements: binding”

3. Job Level Code

The user code will be inserted in the Code portion of the Postscript Job Preamble.

Example: XPDFeature_JobCode Binding: “1 binding setpagedevice”

4. Page Preamble

The user code will be inserted at the end of the page preamble. This hook is used with events only.

Example: XPDFeature_Page Binding: “1 binding setpagedevice”

Device Specific Features in Paris


How these features are referred to in the output stream

It is important to note that the type of feature (XJT, JobComment, JobCode or Page) refers to the position of the feature in the output stream, not the contents.

For example, it is possible to insert any comment into the output stream using the JobCode or Page feature hooks, or to add valid PostScript code to the JobTicket or Comment portions of the output stream using the XJT or JobComment hooks. It is the user’s responsibility to ensure the device will accept the code inserted by any hook as valid. Paris does not read or validate the feature code at all.

What else you should know about using Features

• If a job asks for a feature that the current XPD file does not support, then nothing happens (this is not considered an error, and printing will continue).

• If two printers implement the same feature (i.e., binding) but use different code to achieve this, then the XPD files for each printer should have the same feature name defined, but with different code.

If one printer requires the activation to be in the Job Ticket, and another requires it in the Job Preamble, then each printer XPD should be given two features, one of which is a ‘null’ code. The Job is then created calling for both features. For example: Printer 1: XPDFeature_JobComment Binding1: “%%Requirements: binding true” XPDFeature_JobCode Binding2: “” Printer 2: XPDFeature JobComment Binding1: “” XPDFeature_JobCode Binding2: “binding true setpagedevice” The job would call for both ‘Binding1’ and ‘Binding2’, and would then print correctly on both printers.

Appendix D


SE LE C T I N G A DE V I C E SP EC I F I C F EA T UR E

The XPD supplies a pool of possible features to the Paris PostScript driver.

! NOTE: You must have the XPD with the added entries loaded to see the Device Specific Features in the Environment Editor View/Change Output Settings dialog. The Device must be using that XPD and must be added to the printers list.

There are 3 options available to select which features should be included in a given job:

1. Environment Output

The ‘Output Settings’ dialog of an environment contains a listbox of the requested features for this job. Any listed feature will be passed to the PostScript driver at the start of the job. Any ‘page’ oriented feature listed here will be sent at the start of the first page of the job only.

Listbox which will display added Device Specific features requested for a job



2. Environment Events

The Select Device Features event is available in ‘Page/Para’ and ‘Local Text Block’ event lists. This is a normal event, with the full range of test options. When the test is true, the current page will have the requested features added. Only ‘Page’ features can be called via tests.

3. Run Time Events

A runtime event called “FEATURE=(name,type) “ is available for use with device specific features. This is a page-based event, and will apply at the next page boundary.

The parameters are the name of the feature to call (i.e., ‘Binding’) and optionally the type of the feature. The values for type are XJT, JOBCOMMENT, JOBCODE and PAGE. If the type parameter is missing it is assumed to be PAGE. The XJT, JOBCOMMENT and JOBCODE types only have effect if specified before the first page of the Job.

Appendix D


EX A M P LE O F A N XPD F I L E US I N G DEV I C E SP E C I F I C

F E AT U RE S

The following example XPD file illustrates the use of device specific features and follows Adobe PPD syntax..

Testonly.xpd

*ModelName: "Testonly" *XLPInputMedia Upper: "" *XLPInputMedia Lower: "" *XLPInputMedia Middle: "" *XLPInputMedia Tray4: "" *XPDManageFonts: Download *XPDManageForms: Download *XPDManageGrafs: Download *XPD_XJTVersion: 0200 *XPDFeature_JobCode Binding: "1 binding setpagedevice" *XPDFeature_XJT Binding&bonding: "%XRXbinding via job ticket" *XPDFeature_JobComment Binding&Whipping: "%%Requirements: binding" *XPDFeature_Page Binding&holding: "1 binding setpagedevice" *Include: "D:\PARIS\PRT\X4890PS1.PPD"

! NOTE: 1. The above example is only to demonstrate what the entries look like. The PostScript commands are not necessarily correct. 2. The XPDFeature entries must be placed before the *Include line in the XPD.

On the following pages, the appearance of the features in the Paris system is demonstrated.

Job Level Code hook

Xerox Job Ticket hook

Job Level Comment hook

Page Preamble hook



Using the Environment Output option to select a feature The Testonly.xpd file would produce the following list in the Output Settings dialog:

Drop-down list of Device Specific Features Entries selected from the

drop-down list

Appendix D


Using the Environment Events option to select a device specific feature

1. Open the View/Change Event List (Page/Para Events) dialog and choose Select Device Features from the drop-down menu.

2. Click on the Add button to display the Select Device Features Event dialog. The Testonly.xpd file would produce the following list in the dialog.

3. Select the required entry from the list, then choose the Add button. The

selected entry will be displayed in the dialog.

4. Choose OK to return to the View/Change Event List (Page/Para Events) dialog. The selected feature will be displayed.

Drop-down list of Device Specific Features

Entry selected from the drop-down list

APPENDIX E USING PREPROCESSES IN THE SPOOLER

Appendix E

U S I N G PR E P R O C E S S E S I N T H E S P O O L E R

The Paris Spooler system allows the user to add ‘Preprocesses’ as part of the printing of a data file. Each data file to be processed by the Spooler can have up to eight individual preprocessing actions (Preprocesses) applied to it prior to being printed.

What is a Preprocess and how is it defined in the Spooler?

A Preprocess is an application, batch file or script to be executed by the Spooler. To run a preprocess within the Spooler, you need to create a command file containing the required commands.

To make the preprocess available to the Spooler, you need to define the Preprocess in the Spooler via the Preprocesses menu. This definition gives the preprocess a name and tells the Spooler how to execute the preprocess and manage the data file.

Finally, you need to add the defined preprocessing task to the relevant Job Definition in the Spooler.

! NOTE: This can be method can be repeated to add up to eight preprocessing tasks to a Job Definition.

Appendix E: Spooler Preprocessing


What is defined in a Preprocess?

The View/Change Preprocess dialog is divided into three sections:

•••• Options,

•••• Process Completion

•••• Output

Options

Name Enter the name the Preprocess will be known by within the Spooler. Maximum 15 characters.

Command Enter the command line used to run the preprocess. Typically, this is the full path name of the application, batch file or script to be run, with any required command line parameters. The Spooler will parse this string and perform command line parameter substitutions as required.

Directory Enter the start up (working) directory the preprocess should run in.



Process Completion

Execution: A combo box that allows you to specify how the Spooler and preprocess interact: Either, Wait until process terminates, or Return immediately.

Wait until process terminates

If ‘Wait until process terminates’ is selected, then the Spooler will monitor the progress of the preprocess, and will not mark it as complete until the process terminates.

! NOTE: This is best option for synchronizing the Preprocess and Spooler as it means the Spooler will not attempt to remove input files or launch more copies of the preprocess until the first instance has completed. However, this should not be selected for processes that require manual termination, as this will prevent the Spooler from running another copy of the preprocess until the user intervenes.

Return immediately

If ‘Return immediately’ is selected, then the Spooler considers the preprocessing task to have completed as soon as it is launched. This is rarely useful, but may be necessary to work around limitations in the preprocess. This option should normally be used in conjunction with the ‘Time out’ option.

Time Out: This value is intended for use with the ‘Return immediately’ option to control how long the Spooler waits before considering the job ‘completed’.

If set to ‘0’, the Spooler considers any preprocess with ‘Return immediately’ status to be ‘complete’ as soon as it launches. By adjusting this value, the user can control how long the Spooler waits before considering the Job to be ‘complete’.

! NOTE: This value should be set high to prevent possible problems where the Spooler will attempt to start the next preprocess, or print, before the current one has completed. It should be set low to increase the speed at which the Spooler can process jobs. Therefore, it may be necessary to experiment with this value to determine the best compromise between error prevent and execution speed.



Return Code The Return Code lists the options that allow you to specify how the return code of the preprocess is to be interpreted. This only applies if the Execution mode selected is ‘Wait until process terminates’. In this case, the Spooler will read the termination code of the preprocess, and mark the job as either ‘completed’ or ‘aborted’.

Output

Filename The Filename is the name of the output file created by the preprocess. Enter a name for the output file. (For an example refer to Example of how to run an application as a Preprocess on p.233. This file will become the input file for the next preprocess, or the file to be printed if all preprocesses have completed.

The Spooler will perform command line parameter substitution on this string.

Process Deletes Input File Check ["] ‘Process Deletes Input File’ if the preprocess ‘tidies up’ by removing the original input file passed to it.

Leave ‘Process Deletes Input File’ unchecked if the Spooler is to remove the original input file. The Spooler will remove the input file once the process has completed successfully.



Adding a Preprocess to the Spooler

A Preprocess definition is added to the Spooler via the Preprocesses menu.

'''' To add a Preprocess entry: 1. In the Spooler Control Panel, click on the Preprocesses menu to display the

View List option.

2. Click on View List to display the View/Change Preprocesses dialog.

3. Click on the Add button to display the View/Change Preprocess dialog.

4. Enter or select the Options, Process Completion and Output requirements.

5. Once all the fields have been defined, choose OK. The added preprocess will be displayed in the View/Change Preprocesses dialog.

6. Choose OK to return to the Spooler Control Panel. (To add a defined preprocess to a job definition, see ‘Adding Preprocessing tasks to a Job Definition’ on page 234.)



How does the Spooler make Command line parameter substitutions?

When the Spooler uses the ‘Command’ and ‘Filename’ strings of a Preprocess definition, it scans the string looking for substitution markers. These are special character sequences that the Spooler will replace with the appropriate value from the current input file name. There are 4 special values:

1. %f - The complete input filename, including path and extension. 2. %p - The Input path, with the filename and extension removed. This always

ends in the character '\'. 3. %n - The Input name, with path and extension removed. 4. %e - The input extension.



Important points to know about using Preprocesses

If preprocessing results in the creation of a fully formatted print file…

If any of the preprocessing steps result in the creation of a fully formatted print file, then the final file should not be processed by the Paris Engine. The ‘default environment’ name for this job should be set to ‘<NONE>’, which tells the Paris engine to simply pass the resulting file through to the final printer, without examining it.

The Xes2Ps application is an example of this, where the output file is a fully formatted PostScript print file. The Paris Spooler passes this to the Engine, which should not attempt to further process the file. (See ‘Example of how to run an application as a Preprocess’ on the following page.)

If the preprocess uses the redirection operators ("<" and ">") for I/O…

If the preprocess to be run is a program that uses the redirection operators ("<" and ">") for I/O, such as XES2PS.EXE, then it is necessary to place the command and parameters in a command file or batch file, and set the Paris Spooler to call the command/batch file. This sidesteps a limitation in the WIN32 ‘CreateProcess’ API.

If you wish to run multiple copies of the same preprocess simultaneously…

If you wish to run multiple copies of the same preprocess simultaneously (that is, the preprocess is a program that can run multiple instances, and each instance does not conflict with any other in terms of shared resources, etc.) then the user must create multiple preprocess definitions within the Paris Spooler.

Each definition has a unique name, but the same ‘command’ details. The user then creates separate job definitions, each of which uses a unique preprocess definition.



Example of how to run an application as a Preprocess

To run the XES2PS.EXE program as a preprocessing task within the Spooler:

1. Create a command file containing the required command: C:\Paris\XES2PS.CMD C:\xes2ps\xes2ps.exe -f%1 > %2 (The %1 is the input file name that will be passed into the command file. The %2 is the output file name.)

2. Create a new Preprocess definition in the Paris Spooler (refer to page 227) with the fields set as follows:

FIELD CONTENT

Name: Xes2ps

Command: c:\paris\xes2ps.cmd %f %p%n.ps

(The %f tells the Spooler to send the full path and filename as there first parameter at run time. The %p%n.ps tells the Spooler to send the path and the name, but with the extension changed to .ps as the second parameter.

Directory: c:\xes2ps

Execution: Wait Until Process Returns

TimeOut: 0

Result Code: Ignore

Filename: %p%n.ps

(Given an input name of "C:\Paris\Dta\File1.Xes”, the '%p' tells the Spooler to send the path "C:\Paris\Dta\", the '%n' sends the name "file1", and the '.ps' adds an extension ".ps". The output file would be "C:\Paris\Dta\File1.ps").

Process Deletes Input File:

Not checked (The Spooler will delete input files)

3. Create or modify a Job Definition that has this preprocess in the ‘Preprocesses’ list. Make sure the default environment for the selected Job Definition is set to <NONE>.



Adding Preprocessing tasks to a Job Definition

Once the required command files and Preprocess definitions have been created, the names of the preprocesses to be executed as part of the processing of data files are added to the relevant Job Definition.

The order of preprocesses in the list box is the order in which they will be executed. A preprocess must complete successfully before the data file can move onto the next preprocess (or to the final printing phase).

'''' To add a preprocessing task to a job definition: 1. Open the Definitions menu in the Spooler Control Panel and

Either: Choose Add (if adding a new job definition) to display the Add Job Definition dialog,

Or: Choose Settings (if you are adding a preprocessing task to a current job definition) to display the Select Job Definition to View/Change dialog.

2. Choose the required job definition to display the View/Change Job Definition Settings dialog.



3. In either the Add Job Definition or the View/Change Job Definition Settings dialog, click on the Preprocessing tab.

4. Click on the Add button to display the Select Preprocess to Add dialog.



5. In the dialog, select the required preprocess, then choose OK. The selected preprocess will be displayed under the Preprocessing tab in the Job Definition dialog

I N D E X


I N D E X


A about

preprocesses · 226 access levels in the Euro Rates utility · 142 Accounting utility · 152

backing up Accounting Info · 159 clearing Accounting Info · 158 displaying the Accounting Information · 157 exporting Accounting Info into an XML file

· 159 normal flow of jobs in the Spooler · 152 selecting the display filters · 155 sorting Accounting Info · 158 viewing Accounting Info · 158

activating device specific features · 216

adding engine · 121 input information for a single job · 172 job definition · 53–118 job definition as a port name · 5, 89 mapping for a tray in an environment · 200 output options for a single job · 174 page range to a single job · 176 preprocess to a job definition · 106 preprocess to a single job · 173 preprocessing tasks to a Job Definition · 234 printer definition · 25–47 printer pool · 52, 53 printer to a printer pool · 53 single job (SJR) · 172 variable rates in the Euro Rates utility · 147 XLPInputMedia statements · 198

appending small print jobs into a single job · 6, 115

B backing up

Accounting Info in the Accounting utility · 159

Bypass Spooler option in LPD Server settings · 189

C character selection table

modifying · 194, 195

clearing Accounting Info items in the Accounting

utility · 158 command file, preprocess

command line substitutions · 231 concatenate logical reports in a job definition ·

115 configuring

port monitor · 87 Control Panel · 18 controlling

jobs · 162 Spooler · 181, 186

controlling multiple jobs · 167 creating

job definition with LPD as the input source · 98

job definition with port monitor as the input source · 5, 89

job log · 185 Novell queue · 65 PARIS input queue · 66 PARIS output queue · 74

CyberCom drive · 81 installation · 82

D date setting · 183 defining

attributes for a variable conversion rate · 144 Bypass Spooler option in LPD Settings · 191 Directory as the input source in a job

definition · 60 LPD Server as the input source · 96 LPD Server settings · 190 NEXTFILE output settings · 31 Novell Queue as the input source in a job

definition · 65 preprocess · 230 printer attributes · 26 the input source in a job definition · 59 the polling interval for searching an input

source · 103 the search path for a directory · 63 the search settings for a directory · 64

deleting engine · 126 job definition · 119 job definition added as a port name · 90 job request · 178



mapping for a tray · 204 port monitor · 94 printer · 49 printer pool · 55

device specific features · 215 activating · 216 example of using in an XPD file · 222 hooks · 218 implementing · 217 inserting custom code · 216 referencing in the output stream · 219 Run Time Event, 'Feature' · 221 selecting · 220 selecting environment output · 220 selecting the environment event ‘Select

Device Features’ · 221 selecting the run time event ‘Feature’ · 221 using · 217

dialog Engine · 21 Spooler Control Panel · 18

directory as the input source · 60–64 defining as the input source in a job

definition · 60 defining the search path · 63 defining the search settings · 64 polling for input data · 60 searching for input · 63 selecting the environment file when

directory is the input source · 109 using as the input source · 63

displaying Accounting Information in the Accounting

utility · 157 LPD Log · 188

E editing

engine · 125 job definition added as a port name · 90 mapping for a tray · 203 mapping for an environment · 205 printer pool · 55 single job · 177 variable rates in the Euro Rates utility · 147

engine adding · 121 adding and launching · 120 deleting · 126 editing · 125

launching · 124 linking to a printer · 120, 123 Spooler management of multiple engines ·

120 verifying connection · 182

Engine dialog · 21 environment

adding the mapping for a tray · 200 deleting the mapping for a tray · 204 editing the mapping · 205 editing the mapping for a tray · 203 selecting for media mapping · 201

environment file selecting for a job definition · 107, 109 selecting, when the input source is directory

· 109 selecting, when the input source is Novell

queue · 110 Euro Rates utility · 141

access levels · 142 defining the attributes for a variable

conversion rate · 144 setting the password · 151 viewing conversion rates · 146 viewing fixed rates, adding or editing

variable rates · 147 events

Select Device Features · 221 example of running a preprocess as an

application · 233 example of using device specific features in an

XPD file · 222 exiting

Spooler · 192 exporting

Accounting Info into an XML file · 159

F flushing

print jobs from a printer · 51, 179

H hardware overrun messages · 78

baud rate · 78 causes · 79

holding job · 165

holding new jobs · 104 hooks defined for device specific features

Job Level Code · 218



Job Level Comment · 218 Page Preamble · 218 Xerox Job Ticket · 218

I implementing

device specific features · 217 input source

defining the polling interval for searching · 103

directory, polling for input data · 60 directory, searching for input · 63

inserting custom code to activate device specific

features · 216 installing · See also setting up

port monitor · 87

J job

appending small print jobs into a single job · 6, 115

control · 162 holding · 165 moving to the front of the queue · 170 multiple, controlling · 167 pausing · 163 printing a sample page · 169 releasing · 166 restarting · 164 selecting the number of copies to be printed

· 117 single job processing · 171 single, adding · 172 single, adding input information · 172 single, adding output options · 174 single, adding preprocess · 173 single, deleting · 178 single, editing · 177 single, specifying page range · 176 skipping pages · 169 splitting files in a print job · 116

job definition adding · 53–118 adding a preprocess · 106 adding a preprocessing task · 234 adding as a port name · 5, 89 concatenate logical reports option · 115 creating, with LPD as the input source · 98

creating, with port monitor as the input

source · 5, 89 defining Directory as the input source · 60 defining LPR/LPD Server as the input

source · 96 defining Novell Queue as the input source ·

65 defining Port Monitor as the input source ·

5, 87, 89 defining Serial as the input source · 83 defining the input source · 59 deleting · 119 holding new jobs · 104 modifying · 118 name · 58 selecting a printer · 113 selecting a printer when Novell queue is the

input source · 6, 114 selecting the environment file · 107, 109 using Port Monitor as the input source · 85 using Serial as the input source · 78

Job Level Code hook for device specific feature · 218

Job Level Comment hook for device specific feature · 218

job log creating · 185

job ticket creating · 209 modifying · 213 modifying via the XPD file · 213

job ticket structure · 209 job ticket structure in PARIS · 210 job ticketing

enabling · 211 job ticketing file · 212 jobs

holding · 104 preventing downloaded jobs from being

processed · 186

L launching

engine · 124 linking

engine to a printer · 123 LPD (Line Printer Daemon) · 95 LPD Log

displaying · 188 LPD Server

as the input source · 94–98



Bypass Spooler option · 189 defining settings · 190 defining the Bypass Spooler option · 191 displaying the LPD Log dialog · 188 LPD Log · 188 settings options · 189

LPD Server Settings dialog · 189 LPR , Windows NT · 102 LPR Control File

how Paris reads the file · 99 how the Engine uses the entries from

the fi le · 101 how the Spooler uses the information

from the file · 100 processing · 99

M media mapping

overview · 197 Media Mapping · 44

adding the mapping for a tray · 200 adding XLPInputMedia statements · 198 deleting the mapping for a tray · 204 editing the mapping for a tray · 203 editing the mapping for an environment ·

205 matching the mappings to the printer · 206 selecting the environment to be mapped ·

201 setting up · 198 setting up for an environment · 199

modifying job ticket via the XPD file · 213

modifying character selection table · 194, 195 job definition · 118 job ticket · 213 printer · 48

moving forward in a job · 169 job to the front of the queue · 170

N naming

job definition · 58 printer · 26

NEXTFILE appending the Number to the file name or

extension · 32 defining output settings · 31

Maximum File Number · 32 Name and Extension · 32 Path · 32 selecting as the printer output destination ·

31 Novell queue · See queue, Novell

using with PARIS · 75

O output destination

disk file · 30 Novell Queue · 30 physical port · 30 selecting for a printer · 30 Windows defined printer · 30

output stream referencing device specific features · 219

P packing resource files · 133 packing resources · See resource packing

setting the packer options · 131 Page Preamble

hook for device specific feature · 218 PARIS queue · See queue, PARIS password

setting in the Euro Rates utility · 151 pausing

job · 163 Spooler · 187

PCL4 · 37 physical page shift

shifting the print image on the page · 45 port monitor

adding a job definition as a port name · 5, 89 as the input source · 84–94 benefits · 85 configuring · 87 creating a job definition · 5, 89 deleting · 94 deleting a job definition added as a port

name · 90 editing a job definition added as a port name

· 90 how it works with print providers · 85 installing · 87 setting up a printer · 91 using as the input source · 87

port settings · See serial port settings



preparing

PARIS queue for input · 68 preprocess

about · 226 adding a to a job definition · 234 command line substitutions made by the

Spooler · 231 defining · 230 running as an application, example · 233 using in the Spooler · 226 using, important points to know · 232

print jobs removing from a printer · 51, 179 scheduling · 46

printer adding · 25–47 attributes, defining · 26 defining · See adding defining NEXTFILE output settings · 31 deleting · 49 flushing the print jobs · 51, 179 linking to an engine · 120, 123 matching the media mappings · 206 modifying · 48 name · 26 output destination · 30 PCL4 · 37 priority · 35 rebuilding printer type list · 29 resetting resources · 43 resource storage · 36 resources, management of · 36 saving the added printer definition · 47 scheduling the print jobs · 46 selecting

NEXTFILE as the output destination · 31 selecting for a job definition · 113 selecting for a job definition when Novell

queue is the input source · 6, 114 setting offline or online · 50 setting up · 24 shifting the print image on the page · 45 SPD files · 47 status · 50 type list · 27 updating resources · 41, 42 Windows defined · 30 XPD graphics compression commands for

PCL and PostScript printers · 40 printer options

selecting the concatenate logical reports option in a job definition · 115

printer pool

adding · 52, 53 adding a printer · 53 deleting · 55 editing · 55 scheduling · 54

printer reset options At Job Start · 43 At System Start · 44 Never · 43 Reset at start of next job · 43

printing sample page of a job · 169

processing single job · 171

Q queue, LPD

defining as the input source · 96 queue, Novell

as the input source · 65–77 creating · 65 searching for input · 77 selecting a printer when the input source · 6,

114 using as the input source · 75 using with PARIS · 75

queue, Novell as the input source selecting the environment file · 110

queue, PARIS preparing for input · 68 setting the queue Operators list · 72 setting the queue Servers list · 70 setting the queue Users list · 68

queue, PARIS input creating · 66

queue, PARIS output creating · 74

R rebuilding

printer type list · 29 releasing

job · 166 removing

print jobs from a printer · 51, 179 resetting

printer resources · 43 resource files

unpacking · 136 Resource Manager · 128



Resource Manager utility

FAQs and troubleshooting · 138 how does resource packing work? · 129 packing resource files · 133 packing resources · 130 setting the packer options · 131 unpacking resources · 136 using · 130

resource packing .pak files · 129 how does it work? · 129 packing files · 130, 133 unpacking resource files · 136

resources printer, management of · 36 printer, resetting · 43 printer, storage of · 36 printer, updating · 41, 42

resources, printer XPD graphics compression commands for

PCL and PostScript printers · 40 restarting

job · 164 Run Time Events

'Feature', for device specific features · 221

S saving

printer definition · 47 scheduling

printer pool · 54 scheduling the print jobs sent to a printer · 46 searching

a directory for input · 63 a Novell queue for input · 77 a serial source for input · 83

selecting device specific feature · 220 display filters in the Accounting utility · 155 environment event ‘Select Device Features’

for a device specific feature · 221 environment file for a job definition · 107,

109 environment file when the input source is

directory · 109 environment file when the input source is

Novell queue · 110 environment output for a device specific

feature · 220 environment to be mapped · 201

NEXTFILE as the printer output destination

· 31 output destination for a printer · 30 printer for a job definition · 113 printer for a job definition when Novell

queue is the input source · 6, 114 printer type · 27 run time event ‘Feature’ for a device specific

feature · 221 the number of copies to be printed in a job ·

117 serial

as the input source · 77–84 using as the input source · 83

serial communications hardware overrun messages · 78 high baud rate · 78 UART error message · 79 understanding · 78

serial port settings byte settings · 84 handshaking · 84 page eject · 84 setting up · 83

serial source searching for input · 83 setting up port settings · 83

setting date · 183 printer online or offline · 50 printer priority · 35 resource packer options · 131 the Operators list for a PARIS input queue ·

72 the password in the Euro Rates utility · 151 the Servers list for a PARIS input queue · 70 the Users list for a PARIS input queue · 68 time · 184

setting up Media Mapping · 198 Media Mapping for an environment · 199 printer · 24 printer for a port monitor · 91 serial port settings · 83 Spooler · 23

settings system · 181

SJD (Spooler Job Definition) files · 56 SJR (Spooler Job Request) · 60, 171

adding · 171, 172 adding input information · 172 adding output options · 174 adding preprocesses · 173



deleting · 178 editing · 177 how the Spooler creates it · 60 specifying page range · 176

sorting Accounting Info items in the Accounting

utility · 158 SPD (Spooler Printer Definition) files · 47 splitting files in a print job · 116 Spooler

Control Panel · 18 controlling · 186 Engine dialog · 21 exiting · 192 how it works · 16 introduction · 15 management of multiple engines · 120 pausing · 187 polling directories for input data · 60 setup · 23 starting without downloaded jobs being

processed · 186 start-up dialogs · 17 system, 16 and 32 bit · 15

starting Accounting utility · 154 Spooler without downloaded jobs being

processed · 186 system settings · 181

date and time · 183 job log · 185 verifying engine connection · 182

T time

setting · 184 Troubleshooting in the Resource Manager · 138 type list for printers

about · 27

U UART chip

identifying in your PC · 80 unpacking resource files · 136 updating

printer resources · 41, 42 using

device specific features · 217 device specific features, example · 222

directory as the input source · 63 Media Mapping · 198 Novell queue as the input source · 75 port monitor as the input source · 87 Port Monitor as the input source in a job

definition · 85 preprocess, important points to know · 232 preprocesses in the Spooler · 226 Resource Manager utility · 130 serial as the input source · 83 Serial as the input source in a job definition ·

78 Utilities

Accounting · 152 Accounting, starting · 154 Euro Rates · 141 Resource Manager · 128

V viewing

Accounting Info items in the Accounting utility · 158

viewing conversion rates · 146

W Windows defined printer · 30 Windows NT LPR · 102

X Xerox Job Ticket

hook for device specific feature · 218 XLPInputMedia statements

adding · 198 XPD file

example of using device specific feature · 222

XPD files · 27, 28, 211 XPD commands · 28, 38 XPD ManageFonts command · 38 XPD ManageForms command · 39 XPD ManageGrafs command · 39 XPD statements · 212

XPD graphic compression commands for PCL and PostScript printers · 40

XPD Graphics Compression Commands using · 40

XPD statements · 212

paris spooler technical manual - product support and...

Documents