User Guide - Océ | Printing for Professionals
Transcription
User Guide - Océ | Printing for Professionals
Océ | User Guide Océ Océ PRISMAoffice V3.0 ...and Training? For this product we also offer seminars at our Training Center in Poing. Information: Phone +49 8121 72-3940 Fax +49 8121 72-3950 Océ Printing Systems GmbH Postfach 1260 85581 Poing Germany February 2003 Edition A29247-X30-X-5-7670 Copyright Océ Printing Systems GmbH 2003 All rights reserved, including rights of translation, reprinting, reproduction by copying or any other method. Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserverd. Delivery subject to availability; right of technical modification reserved. All hardware and software names used are trademarks of their respective owners. Introduction Components, Functionalities and Licenses System Requirements Installation Print Manager Spool Extended Line Printer Server Windows Job Ticket Enhancement Web Job Submission Appendix Glossary More Chapters -> A29247-X30-X-5-7670 Related Publications Index A29247-X30-X-5-7670 Contents Contents 1 Introduction................................................................................................................ 1 2 2.1 2.2 2.3 Components, Functionalities and Licenses ........................................................... 3 PRISMAoffice Components......................................................................................... 3 PRISMAoffice Functionalities ...................................................................................... 4 PRISMAoffice Licenses .............................................................................................. 5 3 System Requirements............................................................................................... 7 3.1 Hardware ..................................................................................................................... 7 3.2 Software ...................................................................................................................... 8 4 Installation.................................................................................................................. 9 4.1 Prerequisites................................................................................................................ 9 4.2 Types of Installation................................................................................................... 11 4.2.1 Custom ............................................................................................................ 11 4.2.2 Remote Admin................................................................................................. 12 4.3 Installing PRISMAoffice ............................................................................................. 15 4.4 Installing the Data Encryption Plug-in........................................................................ 20 4.4.1 Data Encryption............................................................................................... 20 4.4.2 Installing the Plug-in ........................................................................................ 20 4.4.3 Activating the Plug-in....................................................................................... 21 4.4.4 How does the Interface Work? ........................................................................ 23 4.5 Installing the BarCode Support Plug-in ..................................................................... 24 4.5.1 Printing the BarCode ....................................................................................... 24 4.5.2 Supported BarCodes....................................................................................... 24 4.5.3 Installing the Plug-in ........................................................................................ 27 4.5.4 Activating the Plug-in....................................................................................... 28 4.5.5 How does the Interface Work? ........................................................................ 30 4.6 Add/Remove Components ........................................................................................ 31 4.6.1 Extended Line Printer Server .......................................................................... 33 A29247-X30-X-5-7670 Contents 5 Print Manager Spool................................................................................................ 35 5.1 Introduction ................................................................................................................ 35 5.2 Quick Start: Installing and Configuring Printers ......................................................... 40 5.2.1 Parallel Printers ............................................................................................... 40 5.2.2 SCSI Printers................................................................................................... 45 5.2.3 TCP/IP Printers................................................................................................ 50 5.2.4 Local NT Printers............................................................................................. 56 5.2.5 Command Printers........................................................................................... 59 5.3 Advanced Configuration ............................................................................................ 63 5.3.1 Input Filter ....................................................................................................... 64 5.3.2 Filter Configuration File ................................................................................... 76 5.3.3 Parameters for the OSPPRINT.EXE ............................................................... 78 5.3.4 Print Job Generation with PJM Server ............................................................ 79 5.3.5 JEC Support for NPS File Systems ................................................................. 79 5.3.6 LIP Control File................................................................................................ 80 5.4 Spool Administration.................................................................................................. 84 5.4.1 Server Properties............................................................................................. 85 5.4.2 Security Settings ............................................................................................. 96 5.4.3 Forms .............................................................................................................. 98 5.4.4 Viewing Documents....................................................................................... 108 5.5 Print Manager Spool User Interface ........................................................................ 110 5.5.1 Customizing the Appearance of the User Interface....................................... 111 5.5.2 Working with the In-Place Editable Dialog Boxes.......................................... 115 5.5.3 Toolbar and Menu Functions......................................................................... 116 5.5.4 Job Handling ................................................................................................. 119 5.5.5 Printer Handling............................................................................................. 131 6 Extended Line Printer Server ............................................................................... 135 6.1 Customizing Printcap File and lpd.ini....................................................................... 136 7 Windows Job Ticket Enhancement...................................................................... 139 7.1 Windows NT Print Extension ................................................................................... 139 7.2 Windows 95 Print Extension .................................................................................... 145 8 Web Job Submission ........................................................................................... 149 8.1 Web Service ............................................................................................................ 149 8.2 Configuration of Web Job Submission..................................................................... 156 8.2.1 Customizing HTML and Script Files .............................................................. 156 A29247-X30-X-5-7670 Contents 8.2.2 Setting up Microsoft Personal Web Manager................................................ 159 8.2.3 Setting up Apache ......................................................................................... 165 8.3 Submitting Files ....................................................................................................... 166 8.4 Getting Information .................................................................................................. 171 9 Appendix ................................................................................................................ 175 10 Glossary ................................................................................................................. 179 11 Related Publications ............................................................................................. 183 Index .............................................................................................................................. 185 A29247-X30-X-5-7670 Contents A29247-X30-X-5-7670 Introduction 1 Introduction This manual describes the functionality, installation, administration and usage of the PRISMAoffice system for Windows NT 4.0 and Windows 2000. PRISMAoffice is a powerful product family which offers scalable and efficient print solutions for the professional office printing environment. PRISMAoffice supports all kinds of PCL printers. It is designed to accommodate the demands of business with heavy print volumes and to make work for operating personell as easy as possible. The PRISMAoffice systems environment The operating system´s user interface makes the spool system easy to work with. Since Windows NT/2000 supports many network protocols, the PRISMAoffice system integrates into virtually every network environment and prints from every application. A29247-X30-X-5-7670 1 Introduction PRISMAoffice enables easy installation and administration of all kind of printers via SCSI, TCP/IP and more. You even can address printers that are connected to other servers in the network. So you can distribute print jobs between several print servers and access all PCL network printers which are supported by Windows NT/2000. Covenient user interfaces of the different components make it easy to submit and control print jobs. Tracking the print jobs is provided via job tickets. An accounting function gives control of quantity of printing and makes cost calculation easy and effective. For the history of products and versions leading to PRISMAoffice see chapter 9, "Appendix" on page 175. 2 A29247-X30-X-5-7670 Components, Functionalities and Licenses PRISMAoffice Components 2 Components, Functionalities and Licenses 2.1 PRISMAoffice Components The PRISMAoffice software component structure: Software Components PRISMAoffice V3.0 Basic Module Professional Edition Network Connection Windows Job Ticket Enhancement PCL BarCode Translation Remote Administration • The Basic Module contains the functionality of PRISMAoffice LE V2.02. • The Professional Edition contains: SCSI connection, faster printers, security package (data encryption, secure viewing) • Network Connection: lpd deamon, web job submission • Windows Job Ticket Enhancement: portmonitor extensions for job tickets • PCL BarCode Translation: Input filter for replacement of PCL ESC sequences through bitmaps • Remote Administration: PRISMAoffice User Interface through network A29247-X30-X-5-7670 3 PRISMAoffice Functionalities Components, Functionalities and Licenses 2.2 PRISMAoffice Functionalities • The Extended Line Printer Server contains a RFC 1179 compatible lp daemon which accepts lpr generated print requests from the network. This gives you access to PRISMAoffice from computers of the non-Windows world. • The Windows NT Print Extension is an NT-conform port monitor which adds a job ticket for advanced print job and output management to the print job. • The Windows 95 Print Extension is similar to the Windows NT Print Extension but especially adapted to Windows 95. • The PJM Interface allows to use the print manager spool from other tools via the PJM server which can be installed with PRISMAoffice. The PJM server allows to generate print jobs with a general PRISMA job generator and PRISMA job ticket. The PJM Interface requires a Java Runtime Environment (Version 1.3.1_04). This JRE is installed automatically when you install the component ’Pjm Server’ from PRISMAoffice V3.0. Existing JRE versions will not be overwritten. Note: When you uninstall the component ’Pjm Server’ from your computer the installed JRE Version 1.3.1_04 is also removed. 4 • The Web Job Submission enables users to submit print jobs, query spoolstatus information and general information via an usual web browser, i.e. without the installation of a special client software. On a server (i.e. the machine, where the spool system is installed) a web server (e.g. Microsoft Internet Information Server) has to be installed. On the clients only a common web browser need to be installed. • The Remote Administration component enables users to handle and administer the spool system completely from a Windows NT/2000 client. The Remote Administration component has to be installed on the client. A29247-X30-X-5-7670 Components, Functionalities and Licenses PRISMAoffice Licenses 2.3 PRISMAoffice Licenses Software Components License Key (FLEXlm) PRISMAoffice V3.0 Basic Module SPOOL_BASE 3.0 Professional Edition SPOOL_PROF 3.0 Network Connection SPOOL_NET_CONN 3.0 Windows Job Ticket Enhancement SPOOL_TIC_ENH 3.0 PCL BarCode Translation SPOOL_BARCODE_PCL 3.0 Remote Administration SPOOL_REM_ADMIN 3.0 A29247-X30-X-5-7670 5 PRISMAoffice Licenses Components, Functionalities and Licenses PRISMAoffice System Overview 6 A29247-X30-X-5-7670 System Requirements Hardware 3 System Requirements It is recommended to use the OPS Printer Servers PRISMA-Base 1 or PRISMA-Base 2 with PRISMAoffice products. Note: In various countries different hardware could be recommended. 3.1 Hardware Minimum hardware requirements for PRISMAoffice: • Pentium 1 GHz processor for very high volume printing • 256 MB main memory for the base version. Additional 256 MB main memory for the Professional Edition or if the PJM server is used. • 10 GB free hard disk capacity • SVGA screen with a resolution of 800x600 or higher • SCSI adapter for SCSI printer: Adaptec 2940 (single ended) or Adaptec 2944 (differential). Printer cable D:20033-23 (20 meters) Note: Ultra SCSI must be turned off when printing on a SCSI printer. In various countries different hardware could be recommended. • OPS printer: functional code with PCL mode V1.22 or higher has to be used A29247-X30-X-5-7670 7 Software System Requirements 3.2 Software • Windows NT 4.0 Workstation with Service Pack 6a Languages: International or German Windows NT 4.0 Server is recommended for all customers who want to use the full connectivity of PRISMAoffice. • Windows 2000 Professional Service Pack 2 Languages: English or German • Windows SNMP Agent Note: The Windows SNMP agent has to be installed before the PRISMAoffice installation. • If you want to use Web Job Submission you need a web server. The web server "Microsoft Peer Web Server" is on the Windows NT 4.0 Workstation CD. You can also use Microsoft’s Personal Web Manager. But this is not on the Océ delivered CDs for Windows NT 4.0 Workstation or Windows NT 4.0 Server. On Microsoft’s Website you will find information about the copyright and the use of the Internet Information Server (IIS) and Personal Web Server (PWS). • If you use the SCSI Driver, you need: Windows NT 4.0 or Windows 2000 SCSI Hostadapter Driver Note: Printing with a SCSI connection to a printer is not possible with the original SCSI driver from the EZ-SCSI CD from Adaptec, but only with the SCSI driver installed automatically from the Windows NT CD. If you use Windows NT as operating system, you need the SCSI mini driver from Windows NT Service Pack 6a. 8 A29247-X30-X-5-7670 Installation Prerequisites 4 Installation In this chapter you will find a description of the installation of PRISMAoffice, the necessary preliminaries and the specialities. 4.1 Prerequisites First of all, it is strongly recommended that you make a backup of your system, before you install or update PRISMAoffice. For this and for all other actions, you have to do on your Windows NT/2000, please refer to the respective manuals from Microsoft or contact your system administration. You will also need a Windows NT/2000-CD in some cases, so be sure that you have it present when you start the installation of PRISMAoffice. Note: Before installing PRISMAoffice you have to install the Microsoft SNMP service. If this service is not installed before, it is not possible to install PRISMAoffice. You get a corresponding message. Next log in as a user with full administrator´s rights. Close all other applications on your system. Stop all active print jobs. During the installation a window will pop up reminding you to stop all print jobs, but it is more useful to deactivate all print jobs before the installation. If you intend to install an update of PRISMAoffice, first uninstall the previous version of any PRISMAoffice components. For detailed information see chapter 4.6, "Add/Remove Components" on page 31. Depending on which components you want to install or which printer you intend to use, some further details have to be considered. If you are using the parallel port the computer BIOS needs to be set to ECP mode. Follow the instructions of your computer manual how to do this. A29247-X30-X-5-7670 9 Prerequisites Installation If you want to install the ’Extended Line Printer Server’ from PRISMAoffice, you need to deactivate the service ’TCP/IP Print Server’ from Windows NT/2000. As both the Microsoft ’TCP/IP Print Server’ and the ’Extended Line Printer Server’ use the same lpd protocol and port, they cannot be activated simultaneously. Instead, you need to activate the ’Simple TCP/IP Services’, which are necessary for using ’Extended Line Printer Server’. After this, you need to reinstall the Windows NT service pack. Refer to your Windows manual, to look up how to work with services. Now reboot your computer again to be ready for installation. 10 A29247-X30-X-5-7670 Installation Types of Installation 4.2 Types of Installation PRISMAoffice offers you two different types of installation: • Custom • Remote Admin Choose ’Custom’ to install PRISMAoffice components on the print server. Select ’Remote Admin’ if you want to install the Remote Administration Module on a client PC which is not the print server. 4.2.1 Custom With setup type ’Custom’ you can select, which components of PRISMAoffice shall be installed. When you select ’Custom’, a new window opens. The following modules are selected by default: – Base – PCL Bar Code Translation – Windows Job Ticket Enhancement – Windows NT Print Extension You can see the little boxes left of the product name. You have to select every module separately, if you want to install it. Click a module you want to select and it is marked. A29247-X30-X-5-7670 11 Types of Installation Installation Note: There are certain correlations between the products. If you select one item that has to be combined with certain others, these will be marked automatically and have grayed out boxes you cannot deselect. 4.2.2 Remote Admin To use the remote administration feature included on the PRISMAoffice CD, you have to install the remote administration on a different Windows NT/2000 system. You can choose any PRISMAoffice system in the network by selecting the IP address of PRISMAoffice spooler. All of the spooler features work except file viewing. You must install a corresponding license on the PRISMAoffice systems you want to administer remotely. The advantage of remote administration is that you can administer several PRISMAoffice systems from one computer, you can centrally administer PRISMAoffice systems at different locations and you can administer PRISMAoffice systems that may not have physical access to the PC where the PRISMAoffice is installed. 12 A29247-X30-X-5-7670 Installation Types of Installation Installing the Remote Administration Feature 1. Install a corresponding license on the PRISMAoffice system (primary spooler) you want to administer remotely. 2. Install a user with same name and password which is not user administrator (but which may have administrator rights) on the PRISMAoffice system and on the remote administration system. 3. Make sure that on the remote administration system there are no PRISMAoffice components. If so remove them. 4. Install from the PRISMAoffice CD and choose ’Remote Admin’. 5. This will popup some windows. The last one, the license window, which you quit. (You don’t need a license on the client machine; you need a license on each PRISMAoffice system you want be administer remotely.) 6. After a reboot of the system log in as the user you have chosen for remote administration and start the ’Print Manager Spool’. Using the Remote Administration To use the remote administration feature of PRISMAoffice start the ’Print Manager Spool’. 1. Select ’Select Computer’ from the ’File’ menu. 2. The dialogbox ’New Computer’ appears. In this dialogbox enter the internet address of the PRISMAoffice system you want to administer remotely. A29247-X30-X-5-7670 13 Types of Installation Installation Note: A license for Web Job Submission Production Edition must be installed on that system. 3. In the dialog box ’New Computer’ enter the internet address of the PRISMAoffice system you want to administer. 14 A29247-X30-X-5-7670 Installation Installing PRISMAoffice 4.3 Installing PRISMAoffice The following description of the PRISMAoffice installation is made with setup type ’Custom’. 1. Insert the PRISMAoffice CD in your CD drive and insert the license disk in your floppy drive. If the auto run option of your CD drive is activated, the setup procedure will start automatically, if not, open Windows NT/2000 explorer and select the letter of your CD drive. Now double-click ’setup.exe’ and the installation routine will start automatically. 2. Select a setup language. The choice is between german and english. Click the ’OK’ button and then click ’Next’ in the following welcome screen to proceed with the installation. A29247-X30-X-5-7670 15 Installing PRISMAoffice Installation 3. Then the installation routine proposes the path for the PRISMAoffice folder. You can accept the default settings or you can click ’Browse’ to select a different path. When you have entered the desired path, click ’Next’ to continue. 4. In the next window, you can select the setup type. Click on the desired option and then click ’Next’ to proceed. 16 A29247-X30-X-5-7670 Installation Installing PRISMAoffice 5. Now you are asked, which components of the PRISMAoffice package you want to install. Click the small check boxes in the dialog box to make your selection. 6. Now setup will ask you, where the PRISMAoffice program icon shall be installed. You can either select an existing folder, type a new one or accept the default folder: A29247-X30-X-5-7670 17 Installing PRISMAoffice Installation 7. An information windows appears to tell you that no print job has to be active during installation. If you have followed the instructions in the chapter 4.1, "Prerequisites" on page 9 you can click away the window with the ’OK’ button. Otherwise you first have to stop all print jobs. 8. The installation now proposes the folder for the HTML and script files, necessary for the ’Web Job Submission’. If the default folder is not accepted for the HTML and script files it will be necessary for the paths for ’Web Job Submission’ to be changed. Note: After the installation you may still move the files to another location. You need to modify the configuration of your web server. 9. After that proceed with ’Next’ and the installation is nearly finished. In the next window you have to select the path for the license file. If you receive your license file on a floppy disk, you can accept the default settings. If you will receive the license file electronically, you can click the ’Browse’ button to select a different path. Note: Make sure that the license file is named "License.dat". The licenses which you will install are written into an event log so you can check later on which licenses are installed on your system. 18 A29247-X30-X-5-7670 Installation Installing PRISMAoffice When you have entered the desired path, click ’Next’ to continue.. 10. The installation is completed now. Accept the settings by clicking the ’Finish’ button and your computer will be rebooted. After the reboot PRISMAoffice is ready for the installation and settings of your printer. You will find the PRISMAoffice entry in the Windows NT/2000 start list and the respective program group. A29247-X30-X-5-7670 19 Installing the Data Encryption Plug-in Installation 4.4 Installing the Data Encryption Plug-in 4.4.1 Data Encryption The encryption of print data with the data encryption plug-in allows to transfer data via LAN to PRISMAoffice in an encrypted state. When the print job is sent from the client to the print server the data will be encryted. In the spool of the print server the data will be converted back to the original print format. Note: Data encryption is only guaranteed during the data transfer via LAN. If you want to use the data encryption plug-in, you need a license for the Professional Edition component of PRISMAoffice. Without the license for the Professional Edition component the data encryption plug-in will not encrypt and pass through the data. 4.4.2 Installing the Plug-in The data encryption plug-in is a ’*.dll’ file which is added to the registry (HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\Spooler\Plugins\IF_PRE) during the installation of PRISMAoffice automatically. 20 A29247-X30-X-5-7670 Installation Installing the Data Encryption Plug-in The data encryption plug-in uses an interface which is installed in the registry during the installation of PRISMAoffice too. The path to the data encryption plug-in is specified in the registry (HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\Spooler) during the PRISMAoffice installation. 4.4.3 Activating the Plug-in After the installation of the data encryption plug-in (de_encrypt.dll) this module has the name ’100’ in the registry. To open the ’Registry Editor’ window select ’Run...’ from the ’Start’ menu. The ’Run’ dialog box is opened. Type ’regedit’ in the ’Open’ text field and click the ’OK’ button. The ’Registry Editor’ window is opened. A29247-X30-X-5-7670 21 Installing the Data Encryption Plug-in Installation The following picture shows the corresponding registry entries after the installation. The plug-in ’InputFilter.dll’ has the name ’0’ and the plug-in ’de_encrypt.dll’ has the name ’100’. To activate the data encryption plug-in in the ’Registry Editor’ you have to change the name of the encryption plug-in to ’1’. To do this right-click to the name and select ’Rename’ from the displayed menu. Now you can change the name of the plug-in. 22 A29247-X30-X-5-7670 Installation Installing the Data Encryption Plug-in Note: If you recieve encrypted data, you have to name the ’de_encrypt.dll’ with ’0’ to decode the recieved data. Rename the plug-in ’InputFilter.dll’ with ’1’ to use the input filter after decoding. Reboot the computer to update your system. After the reboot you can use the data encryption plug-in. 4.4.4 How does the Interface Work? When the print job is in the spool the registry is searched for entries in ’HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\Spooler\Plugins\IF_PRE’. These entries have to be named ’0, 1, 2, ...’. The values of ’0, 1, 2, ...’ are the plug-in names which are called in ascending order after the input filter. The functionality of the input filter in PRISMAoffice V2.02 is now contained in a separate plug-in called ’InputFilter.dll’. This plug-in is installed in ’HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\ Spooler\Plugins\IF_PRE’ and has the name ’0’. A29247-X30-X-5-7670 23 Installing the BarCode Support Plug-in Installation 4.5 Installing the BarCode Support Plug-in 4.5.1 Printing the BarCode The HP-PCL data stream allows the creation of specific BarCodes via escape sequences. This support can typically only be used with a limited range of desk top printers, mostly HP printers, that require costly hardware modules called DIMM's. The BarCode option for PRISMAoffice V3.0 removes the requirement for any hardware upgrades by converting the PCL escape sequences to standard PCL bitmaps that can be printed on any PCL printer, including the Océ high speed printers. The conversion runs as an automatic background task, and the updated print files are placed in the standard Spool. 4.5.2 Supported BarCodes The BarCode plug-in of PRISMAoffice supports the following BarCodes: 24 BarCode ID BarCode Name 23591 USPS ZEBRA 24600 UPC-A 24601 UPC-A +2 24602 UPC-A +5 24610 UPC-E 24611 UPC-E +2 24612 UPC-E +5 24620 EAN/JAN-8 24621 EAN/JAN-8 +2 24622 EAN/JAN-8 +5 24630 EAN/JAN-13 24631 EAN/JAN-13 +2 24632 EAN/JAN-13 +5 24640 25 interleaved A29247-X30-X-5-7670 Installation Installing the BarCode Support Plug-in BarCode ID BarCode Name 24641 25 interl + CHK 24642 German Postal 25 Leitcode 13 24643 German Postal 25 Identcode 11 24644 USPS 25, 11 digits Tray Label 24645 USPS 25, 8 digits Sack Label 24650 25 industrial 24651 25 indust + CHK 24660 25 matrix 24661 25 matrix + CHK 24670 39 (3of9) 24671 39 + CHK 24680 39 extended 24681 39 extended + CHK 24675 Danish PTT 39 barcode 24676 French Postal 39 A/R 24690 93 24691 93 extended 24700 128 autoswitch 24701 128 A 24702 128 B 24703 128 C 24704 128 C 24710 UCC-128 24720 EAN 128 24750 CODABAR A29247-X30-X-5-7670 25 Installing the BarCode Support Plug-in 26 BarCode ID BarCode Name 24751 CODABAR +CHKmod16 24760 MSI 24761 MSI +CHK10 24762 MSI +CHK10+CHK10 24763 MSI +CHK11+CHK10 24770 ZIP+4 POSTNET 5 24771 ZIP+4 POSTNET 9 24772 ZIP+4 POSTNET 11 24780 Singapore 4 State 24785 Australia 4 State 37-CUST 24786 Australia 4 State 52-FF-MET 24787 Australia 4 State 67-FF-MET 24788 Australia 4 State FCC-45 REPLY Installation A29247-X30-X-5-7670 Installation Installing the BarCode Support Plug-in 4.5.3 Installing the Plug-in To install the BarCode Support plug-in you have to select the ’PCL Barcode Translation’ check box in the ’Select Components’ dialog box during the PRISMAoffice installation. A29247-X30-X-5-7670 27 Installing the BarCode Support Plug-in Installation This plug-in uses an interface which is installed in the registry during the installation of PRISMAoffice. The path to the BarCode Support plug-in is specified in the registry (HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\Spooler) during the PRISMAoffice installation. 4.5.4 Activating the Plug-in After the installation of the BarCode Support plug-in (BcEscToBmpPlugin.dll) this plug-in has the name ’101’ in the registry. To open the ’Registry Editor’ window select ’Run...’ from the ’Start’ menu. The ’Run’ dialog box is opened. Type ’regedit’ in the ’Open’ text field and click the ’OK’ button. The ’Registry Editor’ window is opened. 28 A29247-X30-X-5-7670 Installation Installing the BarCode Support Plug-in The following picture shows the corresponding registry entries after the installation. A29247-X30-X-5-7670 29 Installing the BarCode Support Plug-in Installation The plug-in ’InputFilter.dll’ has the name ’0’ and the plug-in ’BcEscToBmpPlugin.dll’ has the name ’101’. To activate the BarCode Support plug-in in the ’Registry Editor’ you have to change the name of the BarCode plug-in to ’1’. To do this right-click to the name and select ’Rename’ from the displayed menu. Now you can change the name of the plug-in. Reboot the computer to update your system. After the reboot you can use the BarCode Support plug-in. 4.5.5 How does the Interface Work? When the print job is in the spool the registry is searched for entries in ’HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\Spooler\Plugins\IF_PRE’. These entries have to be named ’0, 1, 2, ...’. The values of ’0, 1, 2, ...’ are the plug-in names which are called in ascending order after the input filter. The functionality of the input filter in PRISMAoffice V2.02 is now contained in a separate plug-in called ’InputFilter.dll’. This plug-in is installed in ’HKEY_LOCAL_MACHINE\SOFTWARE\OcePrintingSystems\ Spooler\Plugins\IF_PRE’ and has the name ’0’. 30 A29247-X30-X-5-7670 Installation Add/Remove Components 4.6 Add/Remove Components If you want to add or remove components, PRISMAoffice offers a convenient function for doing so. In Windows NT/2000 click ’Start/Settings/Control Panel’. The ’Control Panel’ window opens. Now double-click the ’Add/Remove Programs’ icon. The ’Add/Remove Programs’ window appears. In the left column of this window click the ’Change or Remove Programs’ icon. The currently installed programs are listed in the right column. Select the entry ‘PRISMAoffice‘ from this list and click the ’Change/Remove’ button. A29247-X30-X-5-7670 31 Add/Remove Components Installation The ’PRISMAoffice Setup’ windows appears. The window offers three options: – ’Modify’ – ’Repair’ – ’Remove’ ’Modify’ With ’Modify’ you can easily add or remove any components of PRISMAoffice. Click on the option field and a new window opens. 32 A29247-X30-X-5-7670 Installation Add/Remove Components Select the module you want to install or uninstall by clicking to the respective box left of the module name. Then click ’Next’ to proceed and the installation process will run as described before in the ’Installing PRISMAoffice’ chapter. ’Repair’ With ’Repair’ you can reinstall your previous configuration of PRISMAoffice, e.g. after a system breakdown corrupting files or any other damage in PRISMAoffice. To have ’Repair’ work properly, the installation medium has to be accessible in the same way (i.e. drive letter and path) as during the original installation. If this cannot be accomplished, you have to remove the whole installation via ’Remove’ and reinstall PRISMAoffice from scratch. Therefore you have to save all modified files (printcap file etc.) before you reinstall PRISMAoffice. ’Remove’ ’Remove’ will uninstall PRISMAoffice from your system. Depending on the installed components, you may have to delete some files and entries manually. Please refer to the following chapters. 4.6.1 Extended Line Printer Server If you want to uninstall the ’Extended Line Printer Server’, it is recommended to save the ’printcap’ file prior to de-installation in case you will need it for some other programs. A29247-X30-X-5-7670 33 Add/Remove Components 34 Installation A29247-X30-X-5-7670 Print Manager Spool Introduction 5 Print Manager Spool 5.1 Introduction The Print Manager Spool is the central tool to manage print jobs. It receives print jobs through various print job submission tools. (Ospprint, Windows Port Monitor, lpr, Web print). When the print jobs are put into the print queue, a job ticket will be assigned to them if they do not already have one. The input filter can be configured to extract the parameters for the job ticket from a header page of the print job. The Print Manager Spool processes the printing of the jobs on the connected printers. When the job is completely printed, an accounting entry is generated and the print job is deleted or is moved to the reprint queue. End of Job The ’Print Manager Spool’ is the basic module of PRISMAoffice. It consists of several Windows NT/2000 system services: • ’Print Manager Spool Server’ (the main print service) • ’Print Manager Spool Interface’ (for receiving jobs) • ’Print Manager Spool Cleaner’ (manages the Reprint Queue) A29247-X30-X-5-7670 35 Introduction Print Manager Spool The user interface for this module is implemented as a separate Windows NT/2000 application program, ’OspAdmin.exe’. The spool system supports local PCL printers (SCSI or Centronics) and communicates with the printers via Windows NT/2000 device drivers. It can also address printers that are configured in the local Windows NT/2000 standard spool and printers connected to other servers in the network. So you can distribute jobs between several print servers and access all PCL network printers which are supported by Windows NT/2000. It is also possible to address a printer via TCP/IP. Jobs are controlled and the printer status is queried by means of the Printer Job Language (PJL). A job ticket defines the properties of each job. The ticket stores various parameters, such as the form name, the number of document copies requested, details about the sender and information for the header page. The ticket is either created by a special Océ Printing Systems printer driver on the basis of information entered by the Windows Print Extension for Windows NT or Windows 95 on basis of information entered by the user before printing, generated by the OSPPRINT.EXE print command with parameters, or via the Input filter. System messages may be written to the Windows NT Event Log Service. With the integrated Océ PCL Viewer you can view jobs or header- and trailer pages. The Océ spool system also supports JEC (printing systems of Océ NPS). For more details please refer to chapter 5.3.5, "JEC Support for NPS File Systems" on page 79. The functionality of the Océ spool system can be grouped in four main parts: 1. Job Control/Editing 36 • Display of a list of all jobs, together with their current status. • Handle various data types, supported types are PCL, PCLXL, PostScript, Text, some SEC_*, Text with form feeds included, AFPDS and IPDS but only to forward them to a AFPDS/IPDS print server, and RAW for all unknown types. • Form-controlled job processing. A job's form name determines, how it will be handled, i.e. the system decides on the basis of the name which resources need to be loaded, whether the paper has to be changed, or whether a data converter or filter has to be run. • Job handling while printing is in progress: functions for halting, continuing, cancelling and immediately deleting jobs. • Display of job progress during printing: you can see at a glance how many pages have been sent to the printer and how many have already been physically printed. A29247-X30-X-5-7670 Print Manager Spool Introduction • Functions for reprinting: jobs can be restarted at any particular page. Via PJL, the printer then outputs the job beginning at this page, skipping the pages preceding this point. If only part of the job is to be printed, the spooler stops transferring pages as soon as the last page in the requested range has been printed. If a job is cancelled, the spooler notes the last printed page in the job ticket – if you restart the job later, you have the option of selecting the page after this one as the new start point. • Other job functions – you can change the form name, move jobs to a different target printer, and display the job ticket with the statistics of the last printout. • Accounting: when a job is printed or cancelled, the spool is informed how many pages have been printed physically. This data, plus the information from the job ticket, can be stored in an accounting file. • Data conversion: each form name can be assigned a converter or filter for processing data. The system then runs the converter or filter before the data is printed. • Input filter: this filter can extract information from a header page for use these information in a job ticket in the spooler. This enables the spool functionality to be accessed by other system environments. • Rearranging of job list: the sort order of jobs can be changed by simple point-and-click functions. There are also multiple sort options for listing jobs by selected criteria. • Changing the order of jobs in the print queue: each job can be moved to any position in the list. • Display filter: you can choose which jobs shall be displayed, e.g. just the jobs belonging to a specific department. 2. Printer Control/Status • The spool system supports multiple printers, enabling simultaneous printing on the devices. • Each printer can be (logically) activated and deactivated, i.e. a printer is either enabled or disabled for output. • Each printer is assigned to a form. The assignment ”triggers” the output of the jobs which have this form name. If a form has the ‘automatic form mounting’ property, the spool changes to a different form automatically and then prints the jobs with the new form. If a form does not have this property, it has to be assigned to the printer explicitly. • Pending printer error messages are displayed. • When a job is printing, the number of the most recently printed page is displayed; this number is updated dynamically to inform you how many pages have been output on the printer. A29247-X30-X-5-7670 37 Introduction Print Manager Spool 3. Form Properties The properties of a form determine which actions the spool system is to execute when it processes a job. The spool system can be instructed to: 38 • Print a header page at the start of a job. This page contains data from the job ticket. • Print a trailer page at the end of a job. • Automatically load a form. This determines, whether the form has to be assigned explicitly to the printer in order for jobs with this form name to be printed, or whether the spool assigns the form name to the printer automatically. • Turn job offsetting on or off. The system can also be instructed to take the job offsetting commands from the print file itself. • Turn job monitoring on and off (PJL capable printers only). This is the function that displays the number of pages printed while the job is being output. • Load resources: PCL resources can be inserted preceding and following the job. • Delete a job: you can specify, whether the job is to be deleted immediately after printing, kept for a number of days and then deleted, or be deleted manually later. • Run a data converter: a data filter can be run on the print data before output, e.g. to insert special control commands for printing. Data filters provide the capabilities for customizing specific applications. A29247-X30-X-5-7670 Print Manager Spool Introduction 4. Input Filters The input filter makes it possible for parameters such as the form name, user, etc. to be transferred from other environments (e.g. UNIX or SAP). The input filter (IPF.EXE) is now included in the Print Manager Interface Service. The filter is started automatically by the Print Manager Interface Service when a job is received that has no job ticket. From the print file (e.g. the header page), it retrieves the text that is to serve as parameters. It can search for key words, read at fixed positions or suppress a header page. This functionality is available for ASCII, EBCDIC and formatted PCL print files. Detecting of header pages will now be done during the transfer of the jobs from the standard NT Spool to the PCL Spool. After the Print Manager Interface Service has tracked the parameters of the header page, it will inform the spooler with the parameters (form and so on). Functionality in detail: After the job has been transferred completely, the Print Manager Interface Service checks the job ticket and starts the input filter if the ticket contains the form 'standard'. The input filter reads the job file and looks for a known identification string. Then it reads the parameters being configured for this string and saves them in the job ticket. This procedure allows to read any parameters, if the files can be detected by different identifiers. The input filter contains a complete PCL parser and can therefore read preformed PCL files. Only printable data in the files are interpreted. EBCDIC files can also be read. For more information refer to chapter 5.3.1, "Input Filter" on page 64. A29247-X30-X-5-7670 39 Quick Start: Installing and Configuring Printers Print Manager Spool 5.2 Quick Start: Installing and Configuring Printers In this chapter you will see, how different types of printers are to be installed with the ’Print Manager Spool’. 5.2.1 Parallel Printers The ’Print Manager Spool’ can only access a parallel printer if the corresponding parallel port is not linked with a printer in the internal Windows NT/2000 spool. Note: No printers can be defined as LPT1. Open the Océ ’Print Manager Spool’ via ’Start/Programs/PRISMAoffice/Print Manager Spool’. The user interface window opens. The main window is divided into two panes. The upper one is the job view, which lists all the current jobs in the spool, together with their properties. The lower window part is the printer view, which lists all the printers you have configured, their current status plus various other properties. In the lower part of the window, the printer view, click right to open the context menu (click anywhere in the white area). 40 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers In the context menu click on ’Add Printer’. Now a new printer appears on the left side of the printer view as Printer 0, the context menu closes. Now mark this printer and click it with the right mouse button. A new context menu appears. Click on the item ’Properties’. A new dialog window opens. In this window you have to set the properties of the new printer. First open the ’Connection Type’ drop down list and select ’Parallel’. A29247-X30-X-5-7670 41 Quick Start: Installing and Configuring Printers Print Manager Spool Then open the ’Device-Link’ drop down and select ’\Device\Parallel0’. PRISMAoffice starts counting the printers by 0. So if you install e.g. the third printer in the system, it would be printer 2 for PRISMAoffice. The settings in the list below can stay unchanged, they are already set on default. Now confirm the settings by clicking ’OK’ and the window closes. Mark the printer in the printer view again and click right to open the context menu. Now click on the item ’Activate’ to activate the printer. 42 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers A new window, ’Mount Form for Printer New Location 0’, opens. In this window you can select the form you want to assign to the printer and the class. You can accept the proposed default settings and confirm the window by clicking ’OK’. Now a new window shows up that can be ignored, as you have already selected the standard form. Click ’OK’ and the window closes. A29247-X30-X-5-7670 43 Quick Start: Installing and Configuring Printers Print Manager Spool In the printer view you can control now the settings you have just made. You can see that ’Printer0’ is type ’Parallel’ with ’Active’ status, class ’*’ and form ’Standard’. So now the printer is installed correctly. 44 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers 5.2.2 SCSI Printers For security reasons each SCSI printer must be connected to a separate SCSI adapter. Normally the printer runs on an Adaptec AHA 2944 board in differential mode. The cable can be obtained from Océ. Note: If you want to use the SCSI Driver, you need the Windows NT 4.0 or Windows 2000 SCSI Host adapter Driver. In various countries different hardware could be recommended. Always turn on the SCSI printer before you start the system. In addition, the printer´s SCSI channel must be enabled and active. Open the ’Océ Print Manager Spool’ via ’Start/Programs/PRISMAoffice/Print Manager Spool’. The user interface window opens. The main window is divided into two panes. The upper one is the job view, which lists all the current jobs in the spool, together with their properties. The lower window part is the printer view, which lists all the printers you have configured, their current status plus various other properties. In the lower part of the window, the printer view, click right to open the context menu. A29247-X30-X-5-7670 45 Quick Start: Installing and Configuring Printers Print Manager Spool In the context menu click on ’Add Printer’. Now a new printer appears on the left side of the printer pane as Printer 0. Now mark this printer and click it with the right mouse button. A new context menu appears. Click on the item ’Properties’. A new dialog window opens. In this window you have to set the properties of the new printer. Now change to the desktop and select ’My computer/Control Panel/SCSI adapters and check the port assignment for your SCSI printer. Go back to the installation procedure. Now open the ’Connection Type’ drop down list and select SCSI. 46 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers Then open the ’Device-Link’ drop down and select ’\Device\ScsiPort0’ or what your port assignment is. PRISMAoffice starts counting the SCSI ports by ’0’. The counting corresponds to the numbers of the host adapters. Now click on the ’Address‘ button, to put in the printers SCSI address. A new window opens. For ’Path-ID/Bus_No.’ put in 0. This is always the right value. The ’Target-ID’ is the SCSI ID of the printer. This SCSI ID is configurable at the operator panel of the OPS printers. Finally put in 0 for the ’LUN’ value. 0 is always the correct value here. Then click ’OK’ to confirm the settings, close this window and return to the properties window. The settings in the list below can stay unchanged, they are already set on default. Now confirm the settings by clicking ’OK’ and the window closes. Mark the printer in the printer view again and click right to open the context menu. Now click on the item ’Activate’ to activate the printer. A29247-X30-X-5-7670 47 Quick Start: Installing and Configuring Printers Print Manager Spool A new window, ’Mount Form for Printer New Location 0’, opens. In this window you can select the form you want to assign to the printer and the class. You can accept the proposed default settings and confirm the window by clicking ’OK’. Now a new window shows up that can be ignored, as you have already selected the standard form. Click ’OK’ and the window closes. 48 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers In the printer view you can control now the settings you have just made. You can see that ’Printer0’ is type ’SCSI’ with ’Active’ status, class ’*’ and form ’Standard’. So now the printer is installed correctly. If the printer goes to a ’Waiting’ state check the print job properties for the correct destination printer. A29247-X30-X-5-7670 49 Quick Start: Installing and Configuring Printers Print Manager Spool 5.2.3 TCP/IP Printers Open the ’Océ Print Manager Spool’ via ’Start/Programs/PRISMAoffice/Print Manager Spool’. The user interface window opens. The main window is divided into two panes. The upper one is the job view, which lists all the current jobs in the spool, together with their properties. The lower window part is the printer view, which lists all the printers you have configured, their current status plus various other properties. In the lower part of the window, the printer view, click right to open the context menu. In the context menu click on ’Add Printer’. Now a new printer appears on the left side of the printer view as ’Printer0’. PRISMAoffice starts counting the printers by ’0’. So if you install e.g. the third printer in the system, it would be ’Printer2’ for PRISMAoffice. 50 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers Now mark this printer and click it with the right mouse button. A new context menu opens. Click on the item ’Properties’. A new dialog window opens. In this window you have to set the properties of the new printer. First open the ’Connection Type’ drop down list and select ’TCP/IP’. A29247-X30-X-5-7670 51 Quick Start: Installing and Configuring Printers Print Manager Spool In the ’TCP/IP Address’ field you put in the correct TCP/IP address of the printer. You find the port number, you have to put in the field ’TCP/IP Port’, in the documentation of your printer. The default TCP/IP port of OPS printers is ’5001’ and of HP printer usually ’9100’. The settings in the list ’Parameter’ and ’Contents’ can stay unchanged, they are already set on default. Note: ’Check printer status’ is a setting for PJL capable TCP/IP printers. If this setting is activated, PRISMAoffice will check the status of the printer before a print job is sent to this printer. This setting prevents that jobs are sent to a printer which is offline or reports an error. This printer check might cause a short delay for starting printing the job. This setting has no effect for printers which are non TCP/IP or non PJL capable printers. 52 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers Enabling the SNMP support for printers requires that the printers are connected through TCP/IP, that all network components pass through SNMP packages and that the printer supports SNMP. In the ’Parameter’ list you can make settings for the SNMP support. Click the ’Query printer via SNMP’ check box to enable the SNMP requests for printers. The check box is set to ’Yes’. The port number for SNMP must be ’161’ as the libraries of Windows NT 4.0 does not support other values. To configure the SNMP protocol enter the ’Community name for SNMP’ in the corresponding text box. This community name depends from the device. Please refer the documentation of your printer for the community name. Now confirm the settings by clicking ’OK’ and the window closes. Mark the printer in the printer view again and click right to open the context menu. Now click on the item ’Activate’ to activate the printer. A29247-X30-X-5-7670 53 Quick Start: Installing and Configuring Printers Print Manager Spool A new window, ’Mount Form for Printer New Location 0’, opens. In this window you can select the form you want to assign to the printer and the class. You can accept the proposed default settings and confirm the window by clicking ’OK’. Now a new window shows up that can be ignored, as you have already selected the standard form. Click ’OK’ and the window closes. 54 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers In the printer view you can control now the settings you have just made. You can see that ’Printer0’ is type ’TCP/IP’ with ’Active’ status, class ’*’ and form ’Standard’. So now the printer is installed correctly. A29247-X30-X-5-7670 55 Quick Start: Installing and Configuring Printers Print Manager Spool 5.2.4 Local NT Printers Open the ’Océ Print Manager Spool’ via ’Start/Programs/PRISMAoffice/Print Manager Spool’. The user interface window opens. The main window is divided into two panes. The upper one is the job view, which lists all the current jobs in the spool, together with their properties. The lower window part is the printer view, which lists all the printers you have configured, their current status plus various other properties. In the lower part of the window, the printer view, click right to open the context menu. In the context menu click on ’Add Printer’. Now a new printer appears on the left side of the printer view as ’Printer0’. PRISMAoffice starts counting the printers by ’0’. So if you install e.g. the third printer in the system, it would be ’Printer2’ for PRISMAoffice. 56 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers Now mark this printer and click it with the right mouse button. A new context menu opens. Click on the item ’Properties’. A new dialog window opens. . In this window you have to set the properties of the new printer. First open the ’Connection Type’ drop down list and select ’LOCAL/SERVER’. Then enter the name of the printer in the ‘Printer name’ field. A29247-X30-X-5-7670 57 Quick Start: Installing and Configuring Printers Print Manager Spool Examples: Local printer: HP LaserJet 4Si Printer on a print server: \\Server name\Printer name \\ST049018\2050 Click the ’User’ button to specify the User and the Password the Print Manager Spool Server should use to send jobs to the Windows NT/2000 Spooler. The settings in the list ’Parameter’ and ’Contents’ can stay unchanged, they are already set on default. 58 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers 5.2.5 Command Printers Open the ’Océ Print Manager Spool’ via ’Start/Programs/PRISMAoffice/Print Manager Spool’. The user interface window opens. The main window is divided into two panes. The upper one is the job view, which lists all the current jobs in the spool, together with their properties. The lower window part is the printer view, which lists all the printers you have configured, their current status plus various other properties. In the lower part of the window, the printer view, click right to open the context menu. In the context menu click on ’Add Printer’. Now a new printer appears on the left side of the printer view as ’Printer0’. PRISMAoffice starts counting the printers by ’0’. So if you install e.g. the third printer in the system, it would be ’Printer2’ for PRISMAoffice. A29247-X30-X-5-7670 59 Quick Start: Installing and Configuring Printers Print Manager Spool Now mark this printer and click it with the right mouse button. A new context menu opens. Click on the item ’Properties’. A new dialog window opens. . In this window you have to set the properties of the new printer. First open the ’Connection Type’ drop down list and select ’COMMAND’. Enter the desired command in the corresponding text field. 60 A29247-X30-X-5-7670 Print Manager Spool Quick Start: Installing and Configuring Printers If you select the connection type 'command', a printer type can be configured, that creates a job file and calls a command/program, for example to send print data via the LPR command or to PRISMAnet via the xpadd command. Select the printer type ‚command‘. In the edit box, enter the command to call after the job data has been created. To give job parameters to the command, the Print Manager Spool uses parameters starting with a ‚%‘, for example ‚%Y‘ will be replaced by the path and file name of the created job file. The following parameters are available: Parameter Contents %0 Name %1 Department %2 Account no %3 Phone no %4 Header page line 1 %5 Header page line 2 %6 Post Processing %7 Document name %8 Computer name %9 IP-Address %A Mail-Address %B Form name %C Document Copies %D Date/Time of Job creation %E Printing Date/Time %F Counted Pages %G First to be printed Page no %H Last to be printed Page no %I Job status as number %J Current document copy no %K User name in the NT-Network A29247-X30-X-5-7670 61 Quick Start: Installing and Configuring Printers 62 Parameter Contents %L Printer name %M Job Class %N Current JobID %O - %X Reserved %Y File name of created job file %Z Insert Dynamic Resource file Print Manager Spool A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration 5.3 Advanced Configuration Overview on generating, spooling and printing a job: End of Job A29247-X30-X-5-7670 63 Advanced Configuration Print Manager Spool 5.3.1 Input Filter The configuration of print files with parameters is performed by the program 'IPFCFG.EXE'. After starting the program you can see a list of the actual configuration. If you have not configured a file yet, the list is empty: Buttons: Close: Terminates the program New: A new 'type of file' is created Modify: Configuring a 'type of file' Delete: Deleting a 'type of file' An Example: Parameters from an SAP list should be assigned to a print job. SAP sends possibly a header page. An SAP list starts with some lines building up the word 'SAP' followed by different spool parameters. For the creation of a new 'type of file', a job should be in the spool, which has the format, that is to be processed. Click ’New’ to create a new 'type of file' ('type of file' is here used to identify the environment from which a job comes, i.e. from SAP, PReS ...). 64 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration In the following dialog box enter a source name (i.e. SAP) and an identifier. The identifier is a text which is placed before the parameters and identifies the type of file uniquely. In SAP lists you can take i.e. one line from the large SAP lines: --- SSSSSSSSSS --- AAAA ------ AAAA – PPPP --------- For this example the input is sufficient. Click ’OK’ and the configuration will be saved. A29247-X30-X-5-7670 65 Advanced Configuration Print Manager Spool Other Parameters in the Dialog Box: Source is EBCDIC: Check this box, if the text of the PCL file is EBCDIC coded. Read until current Page ends: The input filter only reads the file until the next form feed is indicated. EndString: You can insert a string which identifies the end of the list of parameters. Parameter List: Shows the parameters which you edit using the buttons ’New’, ’Modify’ and ’Delete’. Gives also information about the allocation to the job card destination field. The SAP job has Job Id '43'. If a type of file and an identifier is set, the input filter can be started with an option to test the configuration. The filter then creates a text file which tells you how the filter reads the job file. It is also possible to read parameters from absolute positions. Now start the input filter with the test option: C:\Program Files\Oce Printing Systems\PRISMAoffice\IPF -t C:\Program Files\Oce Printing Systems\PRISMAoffice\Jobs\00000043.JOB In the spool directory you will then find the file '00000043.JOB.txt' which tells you how the input filter detects and reads the data. To set up the parameter again start the program 'IPFCFG.EXE', mark 'SAP' and click <Modify>. New Parameter Entry Click ’New’ to get the 'New Parameter Entry' dialog box. Here you can enter the parameters which should be read from the file and which should be transferred to the job ticket: 66 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration Options: Search for Keyword: Enter a string to be searched for. Data behind this keyword are detected as parameters. Read from Line-No.: Use this option if the parameter is at an absolute position in the file. You can read the number of the line and column in the test file mentioned above. Parameter Length: With absolute parameters enter here how many characters should be read. Read until End of Line: All characters until the end of line are read. Store Parameter in Job-Card field: Choose a field in the job card where the detected parameters should be saved. In this example you want information on 'Documentname', 'Form' and 'Document-Copies'. Enter these three expressions as 'Search for Keyword' and 'Job-Card Field' parameters. Use the –t option to test the configuration again. Now you have a direct control whether the parameters are assigned correctly. Close all dialog boxes by clicking 'OK' and send the new print job to the spool. Conditional Processing If you want to change found parameters to different values activate the option 'Edit Conditional Processing Definition' by clicking the 'Edit Conditional Processing Definition' button. Enter in the box under the 'Definition File:' text a valid filename for the configuration file. The filename should be different for different input filter configurations. A29247-X30-X-5-7670 67 Advanced Configuration Print Manager Spool In the list under the filename box you will see later all changes that will be made to job ticket fields. Let's try a sample. Every time we get the name '60B2' in the field ‘User’ we want to set the following values: User -> Paul Smith Header page Line1 -> 60B2 Copies -> 2 Printer -> Printer3 We want to have always the form 'Invoice' for this input filter definition. 68 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration So create a new entry in the list with the button 'New'. In the following box we have the following setting: Search field: the field of the job ticket that will be searched for a value. Search for: the value that will be searched for in the field. Field to set: the field where we want to store new information. Value to set: the value to set in the field. The 'Search field' and 'Search for' parameters may be empty what gives you the ability to set a value as default (without a search for data). The option 'Allow multiple changes when Search String found' is needed if you want to change more than one destination field on a value found. For our example we will make the following entries: Note: Because we will change more than one field on the same user name, we have to change the user last, because changes will be made immediate, and if we first change '60B2' to 'Paul Smith' and look in the next entry for '60B2' again, the field will not be changed, because its contents is then 'Paul Smith'. A29247-X30-X-5-7670 69 Advanced Configuration Print Manager Spool Then click ’OK’ and again ’New’. 70 A29247-X30-X-5-7670 Print Manager Spool A29247-X30-X-5-7670 Advanced Configuration 71 Advanced Configuration Print Manager Spool To change the form permanently to 'Invoice' for this configuration, we make the following entry: Finally you will get: 72 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration Changing the Destination Printer The printer field in the PCL Spool always contains the Océ Spooler port where the job came from. If you want to change the printer, you have to set this port in the printer field and not the printer name. Use the following port names: Printer0 --> OSP1: Printer1 --> OSP2: Printer2 --> OSP3: . . . . . . . . . Printer31 --> OSP32: A29247-X30-X-5-7670 73 Advanced Configuration Print Manager Spool To route the job to a printer whose name is defined in the data, you can use the following examples: This will route jobs for printer L2 to the PCL Spool Printer2 and jobs for printer L3 to the PCL Spool Printer3. Of course, you must have setup a parameter to read the printer name from the print data in your input filter parameter list. 74 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration Setting a Default Printer if none of the values above was found: String search is case sensitive, for numeric values (Pages or Document Copies field), you can use the following characters: = equal ! not equal < lower than > greater than A29247-X30-X-5-7670 75 Advanced Configuration Print Manager Spool The following entry will send all jobs where the count of pages is greater than 1000 pages to Printer2: 5.3.2 Filter Configuration File The filter configuration file is a standard ASCII text file. Comment lines will start with a ‘*’ in the first column. To modify a PCL Sequence, you have to specify the PCL command without parameter, followed by the value you want to change and the new value the command should be changed to. 76 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration Sample Filter Configuration File: * PCL Spool system Filter File * * each line describes an PCL command to be replaced with another value * * value's MUST have same size (V2.02.00) * * Format : "<PCL Sequence>", "<oldvalue>" = "<newvalue>" * the PCL Sequence MUST have 3 characters: * 1. the Parameterized character * 2. the Group character * 3. the Termination character * unused characters must be replace by a ' ' (space) * * Example: change <esc>*v0S to <esc>*v1S "*vS" , "0" = "1" "*vS" , "1" = "2" * skip (remove) the next sequence "*vS" , "6" = SKIP * additional filter switches * change 2 FF characters to only 1 -skip empty pages * filtering JEC entries * this sample will filter the flagsheet command in a jec header JEC FLAGSHEET * filter <esc>E, UEL command and all PJL " E" , "" = SKIP "% X" , "-12345" = SKIP -SKIP PJL A29247-X30-X-5-7670 77 Advanced Configuration Print Manager Spool 5.3.3 Parameters for the OSPPRINT.EXE With OSPPRINT.EXE, you can print a PCL file from the MS-DOS box via the Office Print Manager. There are the following parameters: -n <Name of the User> -d <Department-Name> -a <Account> -p <Phone-No.> -m <Mailing Address> -v <PNV-Text> -1 <Spoolheaderpage Line 1> -2 <Spoolheaderpage Line 2> -c <Number of Dataset Copies> -f <Form-Name> -C <Job-Class (0-9, A-Z)> -P <Printername> -j <Document Title> 78 -T <Ticket file> Use this ticket as template You can use a *.JIF file (get one from the spool directory) as template. The program will use the parameters from this JIF file for the newly created job. Other command line parameters will override parameters from the JIF file. -L <LIP file> LIP Resource File from LIP2PCL This parameter is used by the LIP2PCL Converter, to tell the spool what resources and how the resources are to be loaded for this job. The LIP file may also include some other parameters like the user name and so on (see Specification of the LIP control file). The Resources (fonts and macros) must be copied first to the Resource directory of the Spool system. A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration -t <table> Use this ticket as tamplate. -y <type> Specify the document type. -J <job-id> Use the predefined JobID. -D Delete the <datafile> after printing. Syntax for the usage of OSPPRINT.EXE: ospprint [options] <printfile> 5.3.4 Print Job Generation with PJM Server Note: Prerequisite for the print job generation with the PJM server it is required that the PJM server is installed. The PJM server will be installed during the PRISMAoffice installation, if you select the corresponding check box during the installation process. You can generate print jobs for PRISMAoffice by the command ’spjm’. After the installation of PRISMAoffice the program ’spjm.exe’ is located in the following directory: ’\Program Files\Oce Printing Systems\PRISMAoffice’ The command ’spjm’ has the following syntax: spjm -f <file> -f <file> Specify the file which should be printed. 5.3.5 JEC Support for NPS File Systems If you have a configuration with the name ‘JEC‘, where you read some parameters from the JEC header, the input filter can read a second configuration after he has detected the End String. With this function, you can add another configuration, e.g. if you print PostScript, you can use a filter definition to count the pages of the PostScript file (see next point). Use the following configuration for a JEC header: Name: JEC Identifier: *JEC BEGIN End String:*JEC BODY A29247-X30-X-5-7670 79 Advanced Configuration Print Manager Spool 5.3.6 LIP Control File The LIP control file is a standard text file. It describes the resources (fonts and macros) that are needed for the print job. It can also describe some parameters for the job ticket (user, account). Fonts can be loaded using a CAT (Character Assignment Table) to describe the position of characters. A line starting with an asterisk (*) is a comment line and will be ignored. A parameter line looks like the following: KEYWORD = PARAMETER, KEYWORD = PARAMETER Parameters for the Job Ticket: 80 FORM = <form name> USER = <user name> DEPT = <department of the user> ACCOUNT = <account> PHONE = <phone number> MAIL = <mail address> POSTP = <post processing> LINE1 = <header page line 1> LINE2 = <header page line 2> CLASS = <job class (0-9, A-Z)> DOCNAME = <document name> COPIES = <document copies> PAGES = <pages of the job> A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration Parameters for LIP Resource Loading FONT NAME = <filename of the font>, ID = <font-id> The FONT NAME command will load the font file <filename> and will set the font id to <font-id>. If no previous CAT command was specified, the font loader will use a standard cat with no conversions. The font file <filename> must exist in the Océ PCL Spool system Resource directory. MACRO NAME = <filename of the macro>, ID = <macro-id> The MACRO NAME command will load the macro <filename> and will set the macro id to <macro-id>. The macro loader will override the existing id of the stored macro. The macro will be made permanent. CAT = <2 Byte Hex numbers from 00 to FF> The CAT command will set a character assignment table for the fonts that will be loaded after this CAT command, until a new CAT will be set. The parameters of the CAT command are 256 hex values, separated by a space, one value for each ASCII character setting the address of this character. A29247-X30-X-5-7670 81 Advanced Configuration Print Manager Spool Example LIP Control File: * * LIP Resource File * * Section 1: LIP Resources* * the following 2 fonts will be unchanged (no cat used) font name = SET09043.sfp,id = 9043 font name = SET10001.sfp,id = 10001 * * we load now a cat, this example works like the * standard cat, it changes nothing *cat = 00 10 20 30 40 50 60 70 80 90 A0 B0 C0 D0 E0 F0 01 11 21 31 41 51 61 71 81 91 A1 B1 C1 D1 E1 F1 02 12 22 32 42 52 62 72 82 92 A2 B2 C2 D2 E2 F2 03 13 23 33 43 53 63 73 83 93 A3 B3 C3 D3 E3 F3 04 14 24 34 44 54 64 74 84 94 A4 B4 C4 D4 E4 F4 05 15 25 35 45 55 65 75 85 95 A5 B5 C5 D5 E5 F5 06 16 26 36 46 56 66 76 86 96 A6 B6 C6 D6 E6 F6 07 17 27 37 47 57 67 77 87 97 A7 B7 C7 D7 E7 F7 08 18 28 38 48 58 68 78 88 98 A8 B8 C8 D8 E8 F8 09 19 29 39 49 59 69 79 89 99 A9 B9 C9 D9 E9 F9 0A 1A 2A 3A 4A 5A 6A 7A 8A 9A AA BA CA DA EA FA 0B 1B 2B 3B 4B 5B 6B 7B 8B 9B AB BB CB DB EB FB 0C 1C 2C 3C 4C 5C 6C 7C 8C 9C AC BC CC DC EC FC 0D 1D 2D 3D 4D 5D 6D 7D 8D 9D AD BD CD DD ED FD 0E 1E 2E 3E 4E 5E 6E 7E 8E 9E AE BE CE DE EE FE 0F 1F 2F 3F 4F 5F 6F 7F 8F 9F AF BF CF DF EF FF * * the following 2 fonts will be loaded using the cat above * font name = SET10002.sfp, id = 10002 font name = SET11630.sfp, id = 11630 macro name = SET01560.mac, id = 1560 macro name = SET01561.mac, id = 1561 * 82 A29247-X30-X-5-7670 Print Manager Spool Advanced Configuration * setting some job ticket information * pages = 165 copies = 2user = smith docname = :3:$TSOS.P.INFO class = X A29247-X30-X-5-7670 83 Spool Administration Print Manager Spool 5.4 Spool Administration A PRISMAoffice system can be administered on the machine where the PRISMAoffice is installed or from any NT system in a network which is allowed to do this. If you want to administer a PRISMAoffice system remotely, you have to install the ’Remote Admin’ component on the remote Windows NT/ 2000 PC. As an administrator you can manage the print and reprint queues, configure the accounting of the spool, set up header, separator and trailer pages, configure and manage printers, create and configure forms and setup and configure input filters. 84 A29247-X30-X-5-7670 Print Manager Spool Spool Administration 5.4.1 Server Properties After installing the program, you have to make a number of basic settings. Start the spool user interface by running OspAdmin.exe in the directory in which the software was installed, or select Print Manager Spool from the PRISMAoffice program group. From the ‘File’ menu, select the option ‘Server Properties’ to open the general settings dialog box. The settings for the Print Manager Spool Server has 5 categories, to select one of the following categories, use the drop down box to see only the parameters of the specific category: Accounting settings to create account files of the printed jobs Directories path settings Separator Pages settings for the trailer pages Reprint Queue settings for the reprint queue Misc miscellaneous settings A29247-X30-X-5-7670 85 Spool Administration Print Manager Spool Accounting Choose ‘Accounting’ from the ‘Category’ box. You can then activate or deactivate the accounting function by clicking with the left mouse button in the column ‘Contents’ at the row ‘Accounting active’ and by selecting ‘Yes’ or ‘No’. Click into the column ‘Contents’ at the row ‘Accounting file’ and enter a name for the file where to store the accounting records. Accounting files may be created daily, monthly, per year or only one file for all information. You specify the type of the accounting file by entering format parameters in the file name. The format parameters will be replaced by specific date values, for example %d will be replaced by the day in numeric format. The following format parameters are possible: 86 Format Parameter Replaced with %a Abbreviated weekday name %A Full weekday name %b Abbreviated month name %B Full month name %d Day of month as decimal number (01 – 31) %j Day of year as decimal number (001 – 366) %m Month as decimal number (01 – 12) A29247-X30-X-5-7670 Print Manager Spool Spool Administration Format Parameter Replaced with %U Week of year as decimal number, with Sunday as first day of week (00 – 53) %w Weekday as decimal number (0 – 6; Sunday is 0) %W Week of year as decimal number, with Monday as first day of week (00 – 53) %y Year without century, as decimal number (00 – 99) %Y Year with century, as decimal number After a job is printed, the spool system queries the printer for the number of printed pages. When accounting is turned on, the system saves a data record for every job to the accounting file you specify in this dialog box. If the accounting file does not exist, it is created by the spool system. The record contains the job ID, data from the job ticket, the number of printed pages and the final job status (canceled or printed). The accounting file is an ASCII text file. The first line contains the field names, followed by a line of data for each job. The fields are separated by '|' characters. Directories Use this category to specify the directories where the spool system can find the work files (resources, jobs and fonts). The settings should be set during the installation process to the correct path. To change a file path, click into the column ‘Contents’ in the right row to enter the full paths in the fields or click to choose from a dialog box list. A29247-X30-X-5-7670 87 Spool Administration Print Manager Spool The following file paths are required: 88 Path Function Program directory The basic directory containing the spool system. This is the directory you specified during installation. Job directory The directory which stores incoming jobs. Two files are stored for every job: <JOB ID>.JIF for the job ticket and <JOB ID>.JOB for the print data. Reprint Queue directory The directory which stores printed or deleted jobs if the required option is set in the category Reprint Queue in the Server Properties dialog box. Job archive directory The directory which stores jobs from the print and reprint queue. Optimized fonts directory This directory stores the characters of optimized fonts. A large font (m2.sfp) is supplied for the header page. Optimization can shorten the time needed to load the header page, since the spool then only loads the required characters into the printer. (see Settings/Header-Trailer Page). Resource directory The directory for user resources such as macros and fonts. When you configure form resources or header and trailer page resources, the dialog boxes access this directory to display the available resource files. Directory for filters The directory for data filters. All created data filters must be copied to this directory so that they are visible from the corresponding setting in the form properties. Directory for accounting The directory where the Print Manager Spool will save the accounting files, if enabled. A29247-X30-X-5-7670 Print Manager Spool Spool Administration Reprint Queue The Reprint Queue properties control the deletion of printed or manually deleted jobs. The third Print Manager Service (Print Manager Spool Cleaner) will use these settings to delete altered jobs from the Reprint Queue. The following parameters are possible: Parameter Function Move printed Jobs to the Reprint Queue Controls if printed jobs should be moved to the Reprint Queue. Move deleted Jobs to the Reprint Queue Controls if manually deleted jobs should be moved to the Reprint Queue. Keep time of jobs in days The time in days, how long the jobs must be kept in the Reprint Queue. Interval of job deletion in hours Defines the interval the Print Manager Spool Cleaner must start the process of checking for altered jobs in hours. NOTE: The print server must run this time without reboot. A29247-X30-X-5-7670 89 Spool Administration Print Manager Spool Separator Pages • A header or trailer page consists of several files from which the spool system generates one formatted page: • A form file: a PCL file containing the basic layout of the page and the fixed texts. • A data file: the positions and dummy parameters for variable texts are in this file. The dummy parameters are each linked to a field in the job ticket. When the header and trailer pages are generated, the dummy parameters are replaced by values from the job ticket. A dummy parameter has the format %<ID>, where <ID> is an alphanumeric value. • Resources: a list of the files required for printing. Normally, these are just fonts. Sample files and fonts are supplied for the header page. The files for trailer pages have to be created separately. To enter the file names in the fields for the form and variable files, click into the Contents column in the corresponding row or click the button: to select files from a dialog box. 90 A29247-X30-X-5-7670 Print Manager Spool Spool Administration The files supplied for the header page are listed below. After a standard installation, they are located in the spool system's resource directory: Header page form file: header.nt Header page variable file PCL4: header.dat Header page variable file PCL5: header_pcl5.dat The PCL5 data file doesn’t need any resources whereas the PCL4 dat file does. To select the resource files for the PCL4 dat file, click the button, after you have selected the Resource parameter by clicking into the Contents column in the right row. As for selecting the resources of a form, the left side of the dialog box lists the resources in the resource directory. On the right is a list of the resources to be used for the header and trailer page. The order in the list indicates the order in which the resources will be loaded. In the list of available resources, select the entry you wish to add to the ‘Order’ list, then click ◊. The <Delete>, <1 Up> and <1 Down> buttons can be used to delete an entry from the list or to move it up or down one place. To use the supplied PCL4 header page resources, copy the names into the ‘Order’ list and order them as shown in the figure above. A29247-X30-X-5-7670 91 Spool Administration Print Manager Spool The files have the following content: 15003.id: Sets the font ID of the following font to 15003 (used by the form file and variable file for the small font). m1.sfp: A PCL downloadable font for small, variable text. 15018.id: Sets the font ID of the following font to 15018 (used by the form file and variable file for the small font). m2.sfp: The second PCL downloadable font for lines 1 and 2 of the job ticket. This font has approx. 3 cm high characters. To speed up loading of the large font m2.sfp, it can be optimized. If the font is only used for line 1 and line 2 of the header page, not all characters in the font will be required. The fields ‘line 1’ and ‘line 2’ of the header page have a maximum length of eight characters each, i.e. a total of 16 characters. The installation process has installed the m2 font broken down into individual characters in the optimized font directory you specified with ‘Settings/ File Paths’. Specify which fields should be printed with this font. When the header page is generated, only the characters that occur in these fields are actually loaded into the printer. Select font m2.sfp in the ’Order’ list and click <Optimize>. Parameters for the header lines of the separator page will be inserted to the font parameter, it has now the form ‘%4%5:m2’ Note: The selection of a font for a field with variable data takes place in the variable file of the header or trailer page. Therefore, you must know which fields in the variable file are to be printed with the font which you are optimizing. If you leave out a field, characters could be missing from the header page. Use the Océ PCL Viewer to view the header and trailer pages which have been assigned to a form. To do this pop up the context menu of a job in the main window of the Océ Spool System. Select 'View/Separator Pages'. 92 A29247-X30-X-5-7670 Print Manager Spool Spool Administration Miscellaneous Settings The Misc category contains miscellaneous settings. – Parameter Function Log level Allows you to specify the settings for the Windows NT Eventlog. Enable Security Allows you to assign or withdraw permissions for specific operations. ’Log level’ parameter: Click into the Contents column and then the button: to open a dialog box, where you specify which spooler events must be written to the Windows NT Eventlog. A29247-X30-X-5-7670 93 Spool Administration Print Manager Spool The events will be written to the application log. The following events may be recorded: 94 Event Function Server startup and end The Print Manager Spool Server was started or stopped. Output Manager startup The Output Manager, responsible for a printer was started. PJL messages Writes all incoming PJL read back data to the event log. Event Manager Messages Messages from the Event Manager which is responsible for updating job and printer information to the user interface should be recorded. Event Manager client connect When a user interface client has connected to the Event Manager. I/O errors Record non critical I/O errors. Modify job When a user has modified job parameters. Restart job When a user has restarted a job. Delete job When a user has deleted a job. Cancel job When a user has canceled a job. A29247-X30-X-5-7670 Print Manager Spool – Spool Administration Event Function Sort jobs / change queue order When a user has sorted or rearranged the job queue order. Activate Printer When a user has activated a printer. Deactivate Printer When a user has deactivated a printer. Mount form on Printer When a user has mounted a from for a printer. Delete Printer When a user has deleted a printer from the configuration. Add Printer When a user has created a new printer. Modify Printer When a user has modified the parameters of a printer. ’Enable Security’ parameter: You can enable this function, if you select the ’Enable Security’ check box in the ’Parameter’ column and the corresponding check box in the ’Contents’ column at the same time. The check box in the ’Contents’ column is called ’Yes’ now. To disable this security function deselect the ’Yes’ check box in the ’Contents’ column and this check box is called ’No’ automatically. A29247-X30-X-5-7670 95 Spool Administration Print Manager Spool 5.4.2 Security Settings A security function is implemented into PRISMAoffice which makes it possible to assign or withdraw permissions for specific operations per user or per user group. You can enable or disable this security function via the ’Server Properties’ dialog box. Select ’Security Settings’ from the ’File’ menu. The ’Object Permissions’ dialog box is opened. In the ’Object Permissions’ dialog box you find a list with all users or user groups of this computer like in Windows NT/2000. Note: Using the ’SubReplaceTitle’ check box has no effect! 96 A29247-X30-X-5-7670 Print Manager Spool Spool Administration Select the corresponding user name or user group from the ’Name’ list. From the ’Type of Access’ drop down list select ’Special Access...’. The ’Special Access’ dialog box is opened. From the ’Other’ group select the corresponding check boxes for the desired permissions which you want to assign to the selected user or user group. To withdraw permissions deselect the corresponding check boxes. Note: Using the ’Full Control (All)’ radio button has no effect! The following permissions are available: Permission Function List all Jobs Lists all jobs independent of the ownership. Otherwise only the jobs of your own are visible. Access Reprint Queue Lists the jobs in the reprint queue. The view of the list depends on the selection of the ’List all Jobs’ check box. If this check box is selected, all jobs are listed. Otherwise only your own jobs are displayed. Modify Jobs Enables the ’Modify Job’ dialog box. Delete Jobs Enables the deletion visible jobs. Restart Jobs Enables the restart of visible jobs. Cancel Jobs Enables the cancellation of visible jobs. Reorder Jobs Changes the order of the jobs. Edit Forms Edits, adds or deletes forms. A29247-X30-X-5-7670 97 Spool Administration Print Manager Spool Permission Function List Printers Lists all available printers/ports. Access Printers Activates or deactivates the printers. Configure Printers Adds, modifies or deletes printers. Server Properties Modifies the settings in the ’Server Properties’ dialog box. Security Settings Modifies the security settings for any group or user. Note: Members of the ’Administrator’ group can always modify the security settings. 5.4.3 Forms Form Settings From the main menu of the Print Manager Spool select ’File’ and ’Form definitions’. A form name is assigned to every job. A job's form name is either taken from the job ticket of the Windows Print Extension or generated by an input filter: this can search incoming print data for certain keywords and assign the parameters which it retrieves to the individual fields of a job ticket. Print data that does not include a job ticket or readable parameters is automatically assigned the form name 'standard'. To create or modify form names, select the option ‘Form definitions’ from the file menu. 98 A29247-X30-X-5-7670 Print Manager Spool Spool Administration In this dialog box, you define the form names which are registered with the spool system and specify their properties. The ‘Available Forms’ list gives the form names which the spool system already knows. This list is empty just after you have installed the program. To print a job with a specific form name, you must first define the name and its properties. The 'standard' form name should be registered in every system, since this name is assigned to jobs that do not contain job tickets. ’Add’ button Click this button to create a new form name. A dialog box is then opened for you to enter the name and properties of the new form. ’Delete’ button To delete a form name from the system, select it in the list and then click this button. The form is deleted after a confirmation query. ’Modify’ button Use this button to view and change the properties of an existing form. Select the form name and then click this button. A dialog box is then opened for you to view and change the form's properties. A29247-X30-X-5-7670 99 Spool Administration Print Manager Spool Creating and Editing Forms Use this dialog box to assign properties to a form. These are the properties that will be applied when you print a job to which this form is assigned. To create a new form, enter its name in the ‘Form Name’ field. If you are editing an existing form, its current name is shown in this field when you open the dialog box. By changing the name, you can also create a new form with the same properties as the current one (assuming you do not change the properties before saving the form). 100 A29247-X30-X-5-7670 Print Manager Spool Spool Administration ’Properties’ Tab: General: To activate an option, check the box next to the entry in the list. A second click turns the option off again. Option Function Insert Header page Prints a header page before the start of the job. The header page contains information from the job ticket. The necessary resources are provided. Use the Settings/ Header-Trailer Page command to specify which resources you want to use on the header page. Append Trailer page Prints a trailer page at the end of the job. Use the Settings/ Header-Trailer Page command to specify which resources you want to use on the trailer page. Automatic Form mounting Determines whether the operator must assign this form name to the printer explicitly, or whether the system can change to this form name automatically. Delete job after printing When this option is selected, the print job is deleted immediately after printing. Job-Separation: Use these options to make settings for separating jobs. Océ cut sheet printers offset the output stacks mechanically. Continuous forms printers print a job separation mark on the paper. Option Function No Job-Separation No job offset is executed. PCL job offset commands (<ESC>&l1T) from the print file are ignored. Job-Separation from Print data An offset is performed at the end of the job. PCL job offset commands (<ESC>&l1T) are also executed. Job-Separation after Job end An offset is performed only at the end of the job. PCL job offset commands (<ESC>&l1T) have no effect. A29247-X30-X-5-7670 101 Spool Administration Print Manager Spool Resources and Filter: These settings concern the loading of resources and the use of filters and converters. . Option Function Insert Resources Resource files are loaded into the printer before the print data but after the header page. To specify which resources to load, use the ‘Resources’ tab in this dialog box. Append Resources Resource files are loaded into the printer after the print data and after the header page, e.g. in order to delete permanently-loaded resources. To specify which resources to load, use the ‘Resources’ tab in this dialog box. Use a Filter The PCL Spool system can now modify PCL Escape Sequences when sending jobs to the printer. For example Landscape Documents can be modified on the fly to be Reverse Landscape, input tray numbers can be changed and so on. To use this function, you have to create a ’filter configuration file‘. Under ‘Settings/ Forms’, mark the option ‘use a filter‘ and specify the path and file name of the filter configuration file in the edit box. Job control: The spool system uses the PJL language to control and monitor jobs, i.e. to find out the printer status (operator panel messages), the number of the page currently being printed and, at the end of the job, the total number of pages printed. . 102 Option Function Control each Copy Each document copy is treated as a separate job: at the end of a copy, the system waits for the last page of the copy to be printed before beginning the second copy. Control Job and Copies The job is tracked across all document copies, i.e. all copies are treated as a single job for control purposes. No Job-Control No job control takes place and the number of pages printed is determined by a counter. Lines per Page for data type ‘TEXT’ Specifies the number of lines a print file for this form of the type ‘TEXT’ contains. The Print Manager Spool will be able to reposition the print file without using the silent print mode of the printer. A29247-X30-X-5-7670 Print Manager Spool Spool Administration ’Resources’ Tab: To define the resource files to be added to the data stream, click the ‘Resources’ tab. This displays the ‘Resources’ dialog box, where you specify the files and the order in which they are to be loaded. Note: The resource files are only loaded into the printer if the relevant options are turned on in the Properties tab of the dialog box on page 100. To list available resource files, the system accesses the directory you have configured as the resource directory using ‘Settings/File Paths’. In the ‘Display filter’ field, you can enter wildcard to determine which files you want to list. *.MAC, for example, would display all files whose name extension is .MAC. There are two lists in the ‘Order’ section. These are empty when you are creating a new form. The top list will later contain the resource files to be loaded into the printer before the print data, and the order in which they will be loaded. The lower list displays the resource files to be sent to the printer at the end of the job. There are four buttons next to each list. Use these to add resources to the list or delete them, and to change their order. To add a file to one of the lists, select it in the list of available resources and click the ’−>’ button next to the list concerned. The ’Delete’, ’1 Up’ and ’1 Down’ buttons can be used to delete an entry from the list or to move it up or down one place. A29247-X30-X-5-7670 103 Spool Administration Print Manager Spool The first file in the list is the job the spool system will send to the printer first. 104 A29247-X30-X-5-7670 Print Manager Spool Spool Administration ’Separator Pages’ Tab: Here you have the possibility to define individual header and/or trailer pages for one form. The image shows the files for the header page which are originally shipped with the program. If you need a trailer page, you have to generate it and to add the required resources. Mark the check box 'Use form assigned separator pages' in order to use the separator pages you selected for this form. A29247-X30-X-5-7670 105 Spool Administration Print Manager Spool ’Mount Message’ Tab: Use this tab to insert a user defined message which will be displayed if the operators mounts the form to the printer. The operator can also read this message if he pops up the context menu for the printer with the right mouse button and selects 'Mount Form'. 106 A29247-X30-X-5-7670 Print Manager Spool Spool Administration ’Options’ Tab: Under the options tab you can enable automatic job concatenation. If a color station is installed in with the printer, you can insert it’s ID in this window. Additionally you can enable or disable the two across mode for fanfold printers. A29247-X30-X-5-7670 107 Spool Administration Print Manager Spool 5.4.4 Viewing Documents You have the possibility to define various viewer for the different data types which you can select in the job ticket. Note: There are some data types (SEC_*) which you can select through the job generation in the job ticket. It is not possible to assign a viewer to these data types so that the print files which are spooled in these data types cannot be viewed. To define a special viewer for a particular data type select ’Viewer definitions’ from the ’File’ menu. A dialog box appears where the configured viewer are displayed. Furthermore here you can add a new viewer, modify or delete an existing one. Adding a new Viewer Click the ’Add’ button in the dialog box for configuring the viewers. A further dialog box is opened. From the ’Type’ list box select the desired data type. 108 A29247-X30-X-5-7670 Print Manager Spool Spool Administration Note: You can assign a viewer to the PostScript data type too because in PRISMAoffice V3.0 a PostScript parser is added which parses PostScript files and counts the number of pages in this file. To work correctly the file has to follow the document structuring conventions (DSC) according to the Adobe specification. In the ’Viewer’ text box enter the path for the corresponding viewer or click the button right next to this text box to browse for the viewer path. If you want to set several parameters, enter these parameters in the ’Parameters’ text box. Click the ’OK’ button, if you have finished your entries. You return to the dialog box for configuring viewers. The new added viewer is displayed in the ’Configured viewer’ list. Deleting a Viewer Select the viewer which you want to delete from the ’Configured viewers’ list. Click the ’Delete’ button to delete the selected viewer without confirmation. Modifying an Existing Viewer If you want to modify an existing viewer select the corresponding viewer in the ’Configured viewers’ list and click the ’Modify’ button. A dialog box appears where you can modify the desired entries. After you have finished your modifications click the ’OK’ button to return to the dialog box with the configured viewers. A29247-X30-X-5-7670 109 Print Manager Spool User Interface Print Manager Spool 5.5 Print Manager Spool User Interface When you start the Print Manager Spool user interface by calling OspAdmin.exe, or by selecting Print Manager Spool from the PRISMAoffice program group, the main spool system window is displayed. The main window is divided into two panes (see figure): the job view, which lists all the jobs currently in the spool directory together with their properties, and the printer view, which lists all the printers you have configured, their current status, plus various other properties. You can adjust the relative size of the panes by moving the split bar up and down. Each pane is divided into titled columns. The column headers indicate which parameters or values are listed in the columns. In the job view, you can sort the list by a particular column header by clicking the header with the mouse. 110 A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Above the job view is a tool bar (assuming it has not been turned off with the View/Toolbar command). The tool bar provides direct access to frequently-used commands. Button Function Click the ’Open’ button in the tool bar. The ’Open’ window is displayed to select a previous saved configuration. Click the ’Save’ button to save your customized configuration of the user interface. Click this button to switch between the view of the job queue and the reprint queue. Click the ’Help’ button to display the version and release of the current installed PRISMAoffice. 5.5.1 Customizing the Appearance of the User Interface You can customize the appearance of the user interface through various actions. To make sure, that the appearance is restored the next time you use the user interface, use the Save or Save as command from the File menu. This will save all changes you made in the user interface. The configuration will be saved to a file with the extension .osa. When you save the configuration file to your desktop folder, an icon will appear on your desktop. Doubleclick on this icon to start the user interface next time and the user interface will appear with the same appearance that you saved the last time or use the Open command from the File menu to load a previous saved configuration. Choosing the Used Language The user interface supports the languages English and German. The software comes up with English per default. You can change the language using the Language command in the View menu. The language will be changed on the fly without restarting the user interface program. A29247-X30-X-5-7670 111 Print Manager Spool User Interface Print Manager Spool Changing the Column Order in a View You can change the order of the column entries in the job or printer view by simply clicking and holding down the left mouse button in a column header and by moving the mouse to the new position. The column header will appear shadowed while moving it’s position. Changing the Width of a Column The width of a column may be changed by moving the mouse pointer to the end of a column header. The mouse pointer will change its appearance to indicate that the column width may be changed. By double clicking the left mouse button, the column width will be changed to the greatest width of the visible entries in the list. When you click and hold left the mouse button, you can change the column width by moving the mouse to the left or right. Changing the Sort Order of a Column in the Job View Press the right mouse button anywhere in the job column headers to change the sort order for the job columns. The current sort order will be indicated by an arrow in the Job-ID column showing the current sort order. Columns in descending order Columns in ascending order 112 A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Showing or Hiding Columns You may show or hide columns in the job or the printer view. Press the right mouse button in the view where you want to show or hide a column. In the context menu of the view, select the command Visible columns. A dialog box will appear with the column names and a box that is checked or is not checked. To hide a column, remove the check from the box by a left mouse click, to show a column check an unchecked entry. Customizing Colors You may change the colors of a view. Depending of the view, you can customize the colors of the job entries in the job view, depending on the state of a job and in the printer view the colors of the printer entries, depending on the printer state. The color of the background for each second line in the view may be changed also. A29247-X30-X-5-7670 113 Print Manager Spool User Interface Print Manager Spool To modify the colors of a view, click the right mouse button in the view and select Settings from the context menu. The properties pane shows all available color entries. However, some entries are only valid in the printer view while others are only valid for the job view. The following table list all available entries: 114 Property Color for AbortedJob A job that has the status Aborted. ErrorJob A job that has the status Error. NoPrinterFound An unusable printer. PrintedJob A job that has the status Printed. PrinterActive A printer that was activated but is not printing. PrinterDeactive A printer that has the status Deactive. PrinterPrinting A printer that is printing a job. PrintingJob A job that is printing on a printer. PrintQueue The background color for jobs in the PrintQueue. ReprintQueue The background color for jobs in the ReprintQueue. SndLineBkg The background color for the each second line in a view. SpoolingJob A job that is currently sent to the Print Manager Spool. WaitingJob A job that is ready to print and waiting. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface To change the color of an entry, mark the entry in the property pane and select the new color in the right pane of the dialog box. 5.5.2 Working with the In-Place Editable Dialog Boxes Most Dialog boxes in the user interface have changed to a view in report style where you can modify more than one parameter at a time. In-Place editable means that you see the description of a parameter and its contents. To modify the parameter, just click with the left mouse button on its contents or press the STRG key on your keyboard. The contents will change to an editable or selectable field. The box left of the parameter name indicates if the contents of the field was modified. By removing the check from a parameter, you can undo the change which means that the made modification is not sent to the Print Manager Spool Server when you apply the changes by pressing the ’OK’ button. In the sample above, the destination printer was changed (because its box is checked) and the parameter Print from Copy No. is being edited. There are different types of contents or value fields, some fields offer a selectable list of options or parameter names while others are free text fields or can only be changed via a second dialog box. The icon in the contents column shows you the general type of the field: the field is a drop down list A29247-X30-X-5-7670 115 Print Manager Spool User Interface Print Manager Spool the field is a free form text field or a numeric field or a second dialog box must be used to select the options. When a text field is in edit mode and available options are selectable or browse able (for examples a directory path name) via a second dialog box, then the browse button will appear. Click on the browse button or press the STRG key again to open the second dialog box. You’ve already seen such browse able text fields when you configured the server properties in chapter 5.4.1, "Server Properties" on page 85. 5.5.3 Toolbar and Menu Functions The symbols on the tool bar provide fast access to frequently-used functions. You can display and hide the tool bar using the View/Toolbar command. By pressing and holding the left mouse button on the edge of the tool bar, you can drag it to a different position on the screen. Unavailable functions appear dimmed; available functions appear in black in the menus and in color on the tool bar. To select a printer entry, click its name in the printer list. To select a job, click a job entry in the job list. You can select multiple entries by holding the STRG key while you make your selection. To select a block of entries, hold the SHIFT key and drag the mouse pointer down the block you want to select. Commands in the ’File’ Menu The ’File’ menu contains functions for loading and save the environment to a file, exiting the user interface program and functions for general configuration data. A list of the last 4 used configuration files will also be displayed. 116 Command Function Open Loads a configuration file for the environment of the user interface. Save Saves a configuration file for the environment of the user interface. Save as… Saves a configuration file for the environment of the user interface under a new name. Select Computer Opens a dialog box where you can enter or select an internet address for the remote administration of a PRISMAoffice system. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Command Function Server Properties Opens a dialog box where you can modify the general settings for the Print Manager Spool Server (see chapter 5.4.1, "Server Properties" on page 85). Security Settings Opens a dialog box where you can edit the permissions for specific operations (see chapter 5.4.2, "Security Settings" on page 96). Form definitions Opens a dialog box to modify or create new form definitions. Exit Quits the User Interface Program. This will not affect the Print Manager Spool Server itself. To stop the Print Manager Spool Server, you have to use the Services applet from the Control Panel. Commands in the ’Functions’ Menu The ’Functions’ menu contains only the command ’Print Local File’, which you can use to send already formatted print files to the Print Manager Spool Server. A file selection dialog box will appear where you can choose one or more files to be printed. After you have selected the print files, you have to specify the data type of the print files. The data type will be applied to all files that you have selected. If you are unsure, select <detect> and the Print Manager Spool Server will try to find out the data type of the files. A29247-X30-X-5-7670 117 Print Manager Spool User Interface Print Manager Spool Commands in the ’View’ Menu The ’View’ menu has some functions to modify the general appearance of the user interface program. Command Function Toolbar Shows or hides the tool bar. Status bar Shows or hides the status bar. Split Activates the split bar to change visible area of the job and the printer view. Reprint Queue Switches the job view between the Spool Queue and the Reprint Queue. Language With this command you can choose the language of the user interface program. You can select English or German. Commands in the ’?’ (Help) Menu The ’?’ (Help) menu contains the following entries: Command Function Info about OspAdmin... Displays the version and release of the installed PRISMAoffice. Support Displays a window containing 2 internet addresses for PRISMAoffice support. ’Info about OspAdmin’ window: 118 A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface ’Support’ window: 5.5.4 Job Handling Column Entries in the Job View The job view lists the main values of the job tickets. When you start the spool system, the spool directory is searched for jobs. The jobs found are entered in the list with their current parameters. The Print Manager Spool Server service must be running to receive jobs. The jobs are simply placed in the spool directory by the Print Manager Spool Interface service. Note: Not all columns are visible initially, some columns must be made visible via the ’Visible columns’ command from the context menu of the job view first. The columns in detail: Column Header Meaning Job-ID Each job is assigned a unique number, the job ID. The ID is automatically incremented by 1 for each job. Status The current job status. The state can be changed by menu commands or when the job is printed. A29247-X30-X-5-7670 119 Print Manager Spool User Interface 120 Print Manager Spool Column Header Meaning Printer The output device on which the job is to be printed. Document Name The name or title of the job. Class The class of the job. Form Name The form name with which this job should be printed. Pages Total number of pages of the job. From If you are printing only a part of the job (using the Resume function), this column gives the number of the first page to be printed. To For printing part of a job: the number of the last page to be printed. Copies Number of document copies to be printed. For each copy, the entire job is sent to the printer again. Copy-No. For jobs with document copies: the printing will start with this copy number. Size The size of the print job in bytes. Username / Department The name and department, separated by a slash character / . This information is taken from the job ticket. If a print job without a job ticket arrives in the spool system, the network user name is used as the sender, and the entry unknown is made for the department. Date / Time The date and time when the print job was received by the print server. Type The data type of the document. This may be PCL, PCLXL, POSTSCRIPT, TEXT, TEXT [FF] (with form feeds), AFPDS, IPDS or RAW. Phone The phone number of the document owner. Account The account of the document owner. Post processing The post processing field the user has sent via the job ticket. Line 1 Line 1 of the job ticket extra fields. Line 2 Line 2 of the job ticket extra fields. Date / Time printed The date and time the printout of this job was started the last time. Date / Time print ended The date and time the printout of this job was finished the last time. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Jobs States The status column indicates the current processing state of each job in the list. A job can have the following states: State Meaning Waiting The job has not yet been printed and is waiting for processing. Printing The job is now being output on its assigned printer. Output Control All data of the job has been sent to the printer and the spool system is now waiting for the last page physically printed. Error While printing the job an error has occurred. Use the command View error message from the job view context menu to see what error occurred. Data transfer This status indicates that a new job will be transferred to the spool system. Printed Jobs which are not to be deleted automatically after printing (this setting can be made in the form definition) are shown as printed. Pending Abort You can cancel the output of a job using the Cancel command. As when you hold a job, the spool system continues to send data to the printer until the current page is complete. The job has the state Canceling while the data for this page is being transferred. Aborted Printing of the job has been canceled. Canceled jobs are not deleted automatically by the spool system, even if the autodelete setting has been made in the form definition. Pending Delete When you choose Delete from the job view context menu for a job that is currently printing, this job goes to Pending Delete state. The spool system transfers the rest of the data for the current page before the job is finally deleted. Commands in the Job View To open the job menu, click the right mouse button in the job view. The commands in this menu relate to jobs. Before choosing a command, you must select one or more jobs in the job list, except for adding a printer or when you customize the pane settings. Command Function Modify job Opens a dialog box to modify the job parameters. The form, class, destination printer, the number of copies, the range to be printed, the number of the start and end page and the document name can be modified at once. Restart Puts a printed or canceled job back to Waiting state. The job will then be printed again. A29247-X30-X-5-7670 121 Print Manager Spool User Interface 122 Print Manager Spool Command Function Cancel Cancels printing of the job. The spool system waits for the printer to acknowledge that the last transmitted page has been printed and stacked (provided the acknowledge function is turned on). This function is also known as a soft cancel. Delete Deletes the selected jobs from the spool system together with all their data. Depending on the settings of the Reprint Queue, the jobs will be deleted immediately or moved to the Reprint Queue. Archive Opens a dialog box to enter a file name for the print job which should be archived. This job is archived in a special directory which is defined in the ’Server Properties’ dialog box. View separator pages Opens the viewer to view the separator pages. View print data Opens the viewer to view the print data. View job ticket Display a dialog box with the attributes of the job. View error message Opens a dialog box where the last error messages for this job will be displayed. Change position Opens a submenu with commands for changing the position of a job in the job list: Top of list or F1 key: moves the job to the start of the list. End of list or F2 key: moves the job to the start of the list One up or F3: moves the job one position up. One down or F4: moves the job one position down. Sort order Opens a submenu to set the sort options for the column sort and the multi sort function. Apply multi sort Sorts the job list according to the parameters you set with Sort order/ Multisort. Edit display filter Opens a dialog box where you can set the job attributes of the jobs that should be shown in the job view. See chapter "Filtering Jobs in a View" on page 125. Display filter Toggles the last edited display filter to on (filter the list of the jobs) or off (display all jobs). Concatinate jobs This function will copy all job files which are selected through a display filter to a new job file. This function is useful to copy many short jobs to one print job for performance reasons. Refresh Redraws the printer view. Settings Opens the dialog box for customizing the colors. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Command Function Visible columns Opens a dialog box where you can show or hide a column of the printer view. Archiving Jobs The Print Manager Spool offers the possibility to archive jobs from the print and reprint queue to a special archive directory which is set in the ’Server Properties’ dialog box. Note: For the following directories you cannot use a network drive: - Job directory - Reprint Queue directory - Job archive directory If you want to use a network drive, you have to create a separate Office user with administrator rights. Furthermore the following servers have to run with this Office user: - Print Manager Spool Server - Print Manager Spool Interface - Print Manager Spool Cleaner Select the jobs you want to archive and click the right mouse button. From the menu select ’Archive’. The ’Archive Job(s) as’ dialog box appears. A29247-X30-X-5-7670 123 Print Manager Spool User Interface Print Manager Spool Enter the filename in the text field. You can use free text for the file name and/or one or several of the following placeholders. Note: The placeholders refer to the date/time of the job submission and not to the date/ time of printing or archiving. Placeholder Replaced by %a abbreviated weekday name %A full weekday name %b abbreviated month name %B full month name %d day of month (01...31) %H hour (00...23) %j day of year (001...366) %m month (00...12) %M minute (00...59) %S second (00...59) %U week of year (0...53), Sunday as first day of week %w weekday (Sunday = 0,...,Saturday = 6) %W week of year (0...53), Monday as first day of week %y last two digits of year (00...99) %Y all four digits of the year %% % The archived file name consists the file name which you entered in the text field, perhaps the translation of the used placeholders, an underscore and the eight digits of the job number (i.e. Testjob_Monday_20_December_2001_00000022). Note: The job number is added automatically. Don’t use characters in the file name which must not be used in ordinary file names, for example ’/’, ’\’, ’*’, ’..’ etc. 124 A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface If you want to open an archived job, select ’Print Local File’ from the ’Function’ menu. The ’Open’ dialog box appears. Select the corresponding job and click the ’OK’ button. The selected job is added at the end of the job queue. Job Tickets A job ticket is generated either by the print command while executing a job within the Print Manager Spool or by the input filter. It defines the properties of each job: Filtering Jobs in a View With a so called Display filter you can choose, which jobs should be displayed in the job view. This is useful if you have many jobs in the Print Manager Spool and you are looking for specific jobs for example to modify the specific jobs. A display filter can also be used for a printer and this is a really powerful feature with a unknown number of possibilities. The standard output mechanism checks the form name, the job class, the assigned printer and the data type of the job. With a display filter, the assigned printer and the job class of a job are ignored (but you can include these attributes in your display filter if the original output mechanism should be used). Here are some examples, what you can do with a display filter assigned to a printer. • Route jobs depending on there page size to a printer. For example jobs with a page count greater than 100 pages must be printed on a high speed printer, others on a low volume printer. A29247-X30-X-5-7670 125 Print Manager Spool User Interface Print Manager Spool • Forward jobs with a specific data type via a lpr command to another print server which can handle the job, for example AFPDS jobs should be forwarded to PRISMA+APA. • Control your output only by the job class, for example Printer1 must print all jobs with the job class A and Printer2 must print all jobs with class B. • Create a printer pool. When two or more printers are started with the same filter, the jobs will be distributed to the next available printer. • Print jobs depending on the user name, or the department on a specific printer. The user interface provides a dialog box to set up the attributes for the filter. However, internally a Query Language is used. When editing the display filter, the following dialog box will be opened: With the Field drop down box, you can select the job attribute that should be used for filtering. In the drop down box below, select the operation that should be used and finally enter in the to: edit box the value that should be used for the operation. With the Apply button, you will move the attributes to the attribute list for the filter. If you want to remove a attribute from list, mark the entry in the attribute list and click the Delete button. The OK button will send the display filter so the Print Manager Spool Server, whereas the Cancel button aborts the function. With the QL button, a new dialog box is opened displaying the filter in the Query Language format. In this sample, we will only see the job, that have a page count greater than 1000 pages (this means from a page count of 1001) and that have a job class of A. 126 A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface In the Query Language dialog box, you can use the Apply button to use this filter or the Close button to go back to the previous dialog box for setting the attributes. In the edit field, you can modify the filter in a textual form. Query Language Format The Query Language consists of one or more lines separated by a new line. The following syntax is used: <keyword><SP><operator><SP><parameter><NEWLINE> <keyword>: The job attribute the operation applies to. <operator>: The operation that should be used. <parameter>: A value to compare. <SP>: Space key. <NEWLINE>: The return key. A29247-X30-X-5-7670 127 Print Manager Spool User Interface Print Manager Spool Keywords The following table lists the keyword that can be used. 128 Keyword Job Attribute ACCOUNT The account field. CDATE The creation date and time. The parameter format is a date field. CLASS The job class. COMPUTER The senders computer name. COPIES The document copies. The Parameter format must be a number. COPYNO The last printed copy no. The Parameter format must be a number. DEPT The senders department. DOCNAME The document name EDATE The date and time when the last print ended. The parameter format is a date field. END The last to be printed attribute of a job. The Parameter format must be a number. FORM The form name. JOBID The Job ID of the job. The Parameter format must be a number. LINE1 The line 1 attribute of the job ticket extra fields. LINE2 The line 2 attribute of the job ticket extra fields. MAIL The senders mail address. NETADDRESS The senders network address. NTUSER The senders network name. PAGES The count of the total pages of the job. The Parameter format must be a number. PDATE The date and time the last print was started. The parameter format is a date field. PHONE The sender phone number. POSTP The post processing field of the job ticket extra fields. PRINTER The printer the job is assigned to. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Keyword Job Attribute SIZE The size in Bytes of the job. The Parameter format must be a number. START The first page to be printed of the job. The Parameter format must be a number. STATUS The job status of the job. The parameter must be one of the predefined values. TYPE The data type of the job. USER The senders name. Operators The operator defines the action that must be applied with the parameter to the keyword. The following table lists the operator in the Query Language and its appearance in the user interface dialog box. Query Language User Interface and Function =e Empty (no parameter needed) = Equal (case) == Equal (no case) >= Greater or equal > Greater than <= Lower or equal < Lower than !e Not empty (no parameter needed) != Not equal Parameter Formats The standard parameter format is free form text. However some fields require a special format (listed in the keyword table). A29247-X30-X-5-7670 129 Print Manager Spool User Interface Print Manager Spool Text Parameters Text parameters may contain the pattern ‘*’. Test* searches for values that start with the string ‘Test’, for example ‘Test page’. *.doc searches for all values that contain the string ‘.doc’. Numeric Parameters There is nothing special to numeric parameters, they may only contain numbers. Date Parameters Date parameters must have a length of 14 characters in the following format: YYYYMMDDhhmmss where YYYY is the year with century MM the month (01-12) DD the day hh the hour mm the minutes ss the seconds (01-31) if a parameter of the date or the time should be ignored, it must be filled with ‘*’, for example: CDATE = 199905******** lists all jobs that where created in the May of 1999. Parameters for the STATUS Keyword For the keyword ‘STATUS’, the following contents is allowed: 130 Printing jobs that are currently printing Printed jobs that were printed Waiting jobs that are waiting Aborted aborted jobs A29247-X30-X-5-7670 Print Manager Spool Error Print Manager Spool User Interface jobs with status error Parameters for the PRINTER Keyword A printer attribute can be filtered in 3 ways: • The (internally) port name, for example OSP1: for Printer0 • The Printer name, for example Printer3 • The Location of the printer you entered by the printer properties. When using the printer location the pattern ‘*’ can be used. 5.5.5 Printer Handling Columns in the Printer View The printer list contains a line for each printer configured in the system. This tells you the current status of the printer. Column Header Meaning Printer The name of the printer in the spool system. The name is composed of the string printer and a number. Type For SCSI printers, the entry states the device type. For printers connected via the Centronics interface, the entry Parallel is shown. Location Shows the user defined printer name and it's location (i.e. room number) Status Indicates the logical state of the printer in the spool system. Printer Display If the printer supports bidirectional communication, this column displays (error) messages received from the printer. Class Contains the job class(es) to be printed. If a job filter is used, the job filter will be displayed here, because it overrides the job class(es): Current Form The name of the form which is currently assigned to the printer. Depending on the form type, the form can either change automatically from one job to the next, or it must be assigned manually using Job/ Assign Form. The job will not be printed if there is no name in this column. A29247-X30-X-5-7670 131 Print Manager Spool User Interface Print Manager Spool Column Header Meaning Job-ID When a printer is printing, this column gives the ID of the job being output on the printer. A separate process is started for printing a job on a printer. The presence of a job ID in this column indicates that the (write) process is still active. Page No. For PJL capable printers supporting bidirectional communication: while a job is printing, this column specifies the number of the page that was most recently printed and sent to the printer's output stacker. Bytes sent When a job is printing, this column specifies how many bytes have been sent to the printer so far. Also included in the byte count are resources and header page data. Port The name of the port which can be selected in the Windows NT/2000 spool and which is assigned to this printer. The port-to-printer assignments are made automatically by the spool system. Printer States The Status column indicates the current state of the printers. The state is merely a logical value – it has nothing to do with the real operating status of the printer. A printer can have the following states: 132 State Explanation No printer found The system is unable to locate the device link for this printer. SCSI printers can have this state when the print server is booted without first powering on the printer and switching it online. Not available The system is unable to open the device link for this printer. The device could be occupied by another application (e.g. the standard NT spool) or offline ... Deactive The printer is disabled for printing in the spool system. Jobs queued for this printer will not print. Deactivating The printer is currently active and printing, and termination of print output has been requested with the Printer/Deactivate menu command. The current job will be completed and the printer will then go to Deactive state. Active The printer is ready to print, but there are no jobs pending for this printer. However, if you know there are jobs awaiting output on this printer, this could indicate that the printer has been assigned the wrong form or no form at all. Printing The printer is active and printing. A29247-X30-X-5-7670 Print Manager Spool Print Manager Spool User Interface Commands in the Printer View To open the printer menu, click the right mouse button in the printer view. The commands in this menu relate to output devices. Before choosing a command, you must select a printer in the printer view, except for adding a printer or when you customize the pane settings. Command Function Activate Starts output on this printer. The printer must be assigned a form, and the jobs in Waiting state must be present for this printer in the job list. Deactivate Ends output on this printer. The current job is completed first. Mount Form Assigns a logical form to the printer. If no form is assigned, it is not possible to start printing on this printer. Filter print jobs Using a display filter, you can specify which jobs are allowed to be printed on this printer by job attributes. See chapter "Filtering Jobs in a View" on page 125. Deactivate and cancel active job Deactivates the printer and cancels the current print job. The current page will be sent to the printer and then no more data will be sent to the printer. The printer goes to deactivated after the last page of the job is physically printed. Cancel active job Cancels the active job. The current page will be sent to the printer. Cancel print out Cancels the print out immediately and deactivates the printer. Properties Displays a dialog box with the settings for this printer to modify the properties of the printer. Add printer Adds a new printer to Print Manager Spool System. Delete printer Deletes a printer from the list of the managed printers. Refresh Redraws the printer view. Settings Opens the dialog box for customizing the colors. Visible columns Opens a dialog box where you can show or hide a column of the printer view. A29247-X30-X-5-7670 133 Print Manager Spool User Interface 134 Print Manager Spool A29247-X30-X-5-7670 Extended Line Printer Server 6 Extended Line Printer Server Extended Line Printer Server (ELPS) supplies a subset of the standard UNIX line printing daemon service for WindowsNT in conjunction with Print Manager Spool of PRISMAoffice. Print jobs submitted via the lpd protocol from the local or any remote host are forwarded to the PRISMAoffice spool. In contrast to WindowsNT's TCP/IP Print server jobs may be associated with special parameters such as job class, printer, form etc. suitable for the spool via entries in a "printcap" file. Additionally, the number of copies requested is interpreted correctly. The ELPS service listens on the standard TCP/IP printer port 515. Security Issues & Known Problems Jobs directed to non-existent print queues (i.e. not defined in "printcap") are rejected. In particular, the queue names are CASE SENSITIVE! Support for the "lpq" command is quite rudimentary. The response for non-existent queue is "Unknown queue", otherwise just "Queue enabled". Currently there is no authorization mechanism for submitting print jobs, i.e. there is nothing like an "/etc/hosts.lpd". Consequently, print jobs may be submitted from everywhere. However, it is common practice anyway to protect an enterprise network by a firewall from intruders, in particular to block TCP packets from outside a trusted environment and directed to port 515. Ask your network administrator if in doubt. When stopping the service via "Control Panel", "Services" two error messages are added to the NT EventLog. These are for information only and may be safely ignored. A29247-X30-X-5-7670 135 Customizing Printcap File and lpd.ini Extended Line Printer Server 6.1 Customizing Printcap File and lpd.ini Use a text editor like Edit or Notepad to customize the ‘printcap’ file to suit your needs. The structure of this file follows the usual BSD lpd syntax: Everything after a ‘#’ up to the next end of line is ignored. Definitions for different print queues are separated by end of line; if a definition is to spawn several lines each but the last one must be terminated by a ‘\’. Each definition starts with the name field of the print queue followed by optional parameter fields, the fields are separated by ‘:’, e.g. NTDR0:mc#100:sn=Printer0: defines a print queue named ‘NTDR0’ and associated with the parameters ‘mc#100’ and ‘sn=Printer’. Exactly the same may be accomplished by: NTDR0:\ :mc#100:sn=Printer0: Note: Queue names are CASE SENSITIVE! There are two variants of parameters, namely string parameters and numerical parameters. String parameters are of the form ‘parameter_name=value’ where value is everything starting right after the equal sign up to the next ‘:’ or end of line. If the value is to include the special characters ‘:’, ‘ ‘, ‘#’, ‘@’, they must be escaped by a preceding ‘\’, e.g. ‘fm=Form\#0’ means that the value of ‘sn’ is ‘Form#0’ etc. Numerical parameters are of the form ‘parameter_name#value’ where value is a decimal number, e.g. ‘mc#100’ means the value of ‘mc’ is 100. 136 A29247-X30-X-5-7670 Extended Line Printer Server Customizing Printcap File and lpd.ini The currently supported parameters are as follows: Name Type Default Description cl string "" Job class fm string STD The Form name can be changed dynamically via the document title. The document title which is given to the lp or lpr command has to start with ’fm=xxx ’ (xxx = form’s name followed by a blank). if string no default Input filter file, equivalent to ‘-i’ option to ospprint.exe. If the file name does not start with an absolute path, C:\OceSpool\Lpd\Filters (in default setup) is prepended automatically. jt string no default Job ticket template file, equivalent to ‘-T’ option to ospprint.exe. If the file name does not start with an absolute path, C:\OceSpool\Lpd\Tickets (in default setup) is prepended automatically. mc numerical 0 Max number of copies, 0 means no limit. However, there is a hardcoded internal limit of 9999. If a print job exceeds either limit the number of copies is truncated to the allowed maximum. sn string "" Printer name/number Note: Set the job ticket file to read-only, otherwise it will be deleted after first use. Other parameters should not be specified to maintain compatibility with future products. Errors are logged to the NT Application Event Log A29247-X30-X-5-7670 137 Customizing Printcap File and lpd.ini Extended Line Printer Server Advanced Features Some features not related to individual print queues may be configured via the file lpd.ini (which is created if it doesn't exist). It is a plain text file and may contain any of the following parameters: Trace[n] where n=-1, 0 (default), 1, 2, 3, 4, 5 specifies the trace level. 0 means no tracing at all, towards 5 verbosity increases. Trace output is written to the file ‘Trace’. Logging of errors to the NT EventLog may be suppressed by setting the trace level to -1, though this is strongly discouraged. Threads[n] where n=1, 2, ..., 64 specifies the maximum number of simultaneous connections. The default is 16. Increasing this number is useful only if the clients are rather slow when compared to transfer capacity of the network and to the server. Port[n] where n=1, 2, ..., 1023 specifies the port Extended Line Printer Server is listening on for incoming print jobs. Changing the default (515 as specified in RFC 1179) is rarely useful. Note: lpd.ini is read only once during startup. For changes to take effect the service must be stopped and restarted via ‘Control Panel/Administrative Tools/Services’. 138 A29247-X30-X-5-7670 Windows Job Ticket Enhancement Windows NT Print Extension 7 Windows Job Ticket Enhancement 7.1 Windows NT Print Extension The Windows NT Print Extension accepts the print data from applications and adds a job ticket to the print job. The job ticket can either be created interactively, or a predefined default job ticked can be used. The Windows NT Print Extension enables printing to spool systems in the network as well as to the local spool. Note: The port monitor ‘OCEMON.DLL’ from older versions no longer exists. Instead, the Windows NT Print Extension must be used to submit jobs to the Print Manager Spool via shared Windows NT/2000 printers on the local server. A29247-X30-X-5-7670 139 Windows NT Print Extension Windows Job Ticket Enhancement To pass the output to the Print Manager Spool, you have to assign a specific port to a selected printer. This is done by opening the ‘Printers’ window from the ‘Settings’ menu and selecting the corresponding printer. Choose ‘File/ Properties’ and mark the port ‘Windows NT Print Extension’. Click the button ’Configure Port...’. The ’Port Configuration’ dialog box appears. The port name is the unique name of this port. You can choose two methods of linking to the Print Manager Spool: Local Installation 140 Windows NT Print Extension and spool system are on the same computer A29247-X30-X-5-7670 Windows Job Ticket Enhancement Remote Installation Windows NT Print Extension Windows NT Print Extension and spool system are on different computers in the network. Once the port has been configured, you can define a job ticket for this port. To do this, click the ‘Edit Standard Jobticket’ button in the ’Port Configuration’ dialog box. The ’PRISMAoffice - Jobticket’ dialog box is opened where the ticket can be created and saved. To automatically open the ’PRISMAoffice - Jobticket’ dialog box for every print job, select in the ’Port Configuration’ dialog box the ‘Show Jobticket Dialog when printing’ check box. The option ‘Use extended options when printing’ offer some special features that were be provided by the old PRISMAoffice port monitor ‘OCEMON.DLL’. Tabs of the Window ’PRISMAoffice - Jobticket’ Click the ’Edit Standard Job Ticket’ button in the ’Port Configuration’ dialog box. The following property tabs should be completed with user specific values in order to define details about the user or job. A29247-X30-X-5-7670 141 Windows NT Print Extension Windows Job Ticket Enhancement The details in the job ticket are evaluated by the Print Manager Spool and can be used for various purposes – on a header page, for instance, or for accounting. This tab is used for entering details such as the name, department, cost center and phone number of the person submitting the job. The ‘Print Options’ tab provides the following information: 1. Form name 2. Printer name 3. Data stream (use <detect> if you are unsure) 4. Job class 5. Number of document copies 142 A29247-X30-X-5-7670 Windows Job Ticket Enhancement Windows NT Print Extension 6. Whether there is to be an offset at the end of the job The ‘Formname’ and ‘Printername’ list boxes present the data that was assigned in the Print Manager Spool. The ‘Workstation’ tab contains user's related workstation information. Note: To print the print data to the selected physical output port, the option ’Local Printer’ must be set as the destination in the ’PCL Generator’ window. Network printing is subject to the Windows NT/2000 security regulations. A29247-X30-X-5-7670 143 Windows NT Print Extension Windows Job Ticket Enhancement Extended Options Dialog The ‘Use extended options when printing’ check box may be used to • Send print jobs to the print server but not to the Print Manager Spool jobs for further processing by a third party program. • To use a translate table for the print data for examples EBCDIC to ASCII To activate the extended option, select the ‘Use extended options when printing’ check box and click the ‘Options…’ button. In the ’Enhanced options’ dialog box, the following functions can be activated: • ‘Store the file in this path’: This will store the job file and the job ticket file at the print server in the file path that you must enter in the text field below. Note: The entered path must be already exist on the server, otherwise submitting of jobs will fail. 144 • ‘Store the file with the original filename’: When checked, after submission of the job, the job file and job ticket file will be renamed to the original document name. The job ticket file will get the extension ‘.JIF’. If a file with the same name already exists, the files will get a heading count number. • ‘Delete jobticket file’: The job ticket file will be deleted from disk after the job is transferred completely. A29247-X30-X-5-7670 Windows Job Ticket Enhancement Windows 95 Print Extension • ’Character translation’: If you check the option ‘Use following mapping table’, the print data will be converted using a translate table. The table must have 256 bytes of size. In the text field below, enter the absolute path and filename on the server of the translate table. • 'Append printername to form': This options appends the Windows printer name to the form name. It is intended for backward compatibility with an older product only and may disappear in future releases. 7.2 Windows 95 Print Extension The Windows 95 Print Extension accepts the print data from applications and adds a job ticket to the print job. The job ticket can either be created interactively, or a predefined default job ticked can be used. The Windows 95 Print Extension enables printing to Print Manager Spool in the network. Note: If you don’t have installed the Windows 95 Print Extension before, please use the PRISMAoffice CD to install the Windows 95 Print Extension afterwards. To pass the output to the Print Manager Spool, you have to assign a specific port to a selected printer. This is done by opening the ‘Printers’ window from the ‘Settings’ menu. Select a printer and choose ‘File/ Properties’, then go to the ‘Details’ page and choose ‘Add Port’. Then you can select Windows 95 Print Extension: A29247-X30-X-5-7670 145 Windows 95 Print Extension Windows Job Ticket Enhancement Following this you can set some configuration parameters for the new port: The Portname is the unique name of this port. Once the port has been configured, you can define a job ticket for this port. To do this, click ‘Port settings’ on the ‘Details’ property page. The ‘Edit Standard Jobticket’ button opens a dialog box where the ticket can be created and saved. To automatically open the job ticket dialog box for every print job, select ‘Show jobticket when printing’. Tabs of the Window ’PRISMAoffice - Jobticket’ Click the ’Edit Standard Job Ticket’ button in the ’Port Configuration’ window. The following property tabs should be completed with user specific values in order to define details about the user or job. 146 A29247-X30-X-5-7670 Windows Job Ticket Enhancement Windows 95 Print Extension The details in the job ticket are evaluated by the Print Manager Spool and can be used for various purposes – on a header page, for instance, or for accounting. This tab is used for entering details such as the name, department, cost center and phone number of the person submitting the job. The ‘Print Options’ tab provides the following information: 1. Form name 2. Printer name 3. Data stream (use <detect> if you are unsure) 4. Job class 5. Number of document copies A29247-X30-X-5-7670 147 Windows 95 Print Extension Windows Job Ticket Enhancement 6. Whether there is to be an offset at the end of the job The ‘Formname’ and ‘Printername’ list boxes present the data that was assigned in the Print Manager Spool. The ‘Workstation’ tab contains user's related workstation information. Note: Network printing is subject to the Windows security regulations. 148 A29247-X30-X-5-7670 Web Service Web Job Submission 8 Web Job Submission 8.1 Web Service ’Web Job Submission’ enables the user to print documents via a common browser in an intranet or internet environment. For this the ’Web Job Submission’ provides a Web Sevice subcomponent, which manages the connection between the user interface and the ’Print Manager Spool’. On the server side you need the ’Print Manager Spool’ component of ’PRISMAoffice’, a web server (Microsoft IIS, Peer Web Service, etc.) a browser and the ’Web Job Submission’. On the client side you just need a web browser. A29247-X30-X-5-7670 149 Web Job Submission Web Service The installation of the ’Web Job Submission’ is an automated part of the normal installation routine. For detailed instruction see chapter 4.3, "Installing PRISMAoffice" on page 15. For installation of the web server and the browser please refer to the respective manuals. Installation of the Windows NT SNMP Agent In addition you need the Windows NT SNMP Agent on the server to run ’Web Job Submission’ properly. You can check whether this service is on your system by selecting ’Start/Settings/Control Panel’ and then clicking the icon ’Administrative Tools’. In the window ’Administrative Tools’ double-click the icon ’Services’. A window opens where you see a list of the installed services and by scrolling this list you can look for SNMP Service. If you can´t find it, follow the next instructions for installing it. • 150 Select ’Start/Settings/Control Panel’ and click the ’Add/Remove Programs’ icon in this window. A29247-X30-X-5-7670 Web Service Web Job Submission • The ’Add/Remove Programs’ dialog box appears. In this dialog box click the ’Add/Remove Windows Components’ button. • The ’Windows Components Wizard’ dialog box is opened. In the list ’Components’ select the ’Management and Monitoring Tools’ check box. Click the ’Next’ button. A29247-X30-X-5-7670 151 Web Job Submission 152 Web Service • You are asked now to insert the corresponding Windows CD into your CD-ROM drive. Insert the WindowsNT Workstation or Windows 2000 Professional CD into the CD drive and click the ’OK’ button. • If you have inserted the Windows NT Workstation or Windows 2000 Professional CD already, the path to the appropriate drive and folder (i386) already shows up in the input field. A29247-X30-X-5-7670 Web Service Web Job Submission • The selected components will be configured and the necessary data will be installed from CD. After configuration and installation of the components you return to the ’Windows Components Wizard’. Click the ’Finish’ button. • You return to the ’Add/Remove Programs’ dialog box. Close this dialog box by clicking the ’Close’ button. A29247-X30-X-5-7670 153 Web Job Submission • 154 Web Service In the ’Control Panel’ window double-click the ’Administrative Tools’ icon. In the following window double-click the ’Services’ icon. A29247-X30-X-5-7670 Web Service Web Job Submission • The ’Services’ window is opened. In this window you can see all services which are already installed on your system. Look for the SNMP service and click right on this service to open the context menu. Select ’Properties’ from this context menu. • The ’SNMP Service Properties’ dialog box is opened. A29247-X30-X-5-7670 155 Web Job Submission • Configuration of Web Job Submission Click the ’Agent’ tab in the ’SNMP Service Properties’ dialog box. Here you find to input fields, ’Contact’ and ’Location’. If you use the SNMP service not only for PRISMAoffice, then you can enter your name in ’Contact’ and your room number in ’Location’. Otherwise leave the window untouched and just click the ’OK’ button. You return to the ’Services’ window. The installation of the SNMP service is finished. 8.2 Configuration of Web Job Submission After the installation of ’Web Job Submission’ you will have to customize certain files and settings in order to establish communication between ’Web Job Submission’ and your web server. 8.2.1 Customizing HTML and Script Files During the installation of ’Web Job Submission’ you are asked where to establish a directory for the HTML and script files. It is strongly recommended to use a directory ’PRISMAoffice’ right below the web server document root as the installation routine suggests. See chapter 4.3, "Installing PRISMAoffice" on page 15. Warning:Do not attempt to modify the HTML files with an ordinary HTML editor! In particular Microsoft´s FrontPage will corrupt the files due to the presence of some private tags within the files. Only use a simple text editor like Notepad and don´t touch anything in the files except as described next. First you have to modify the file ’checksystem.htm’. You will find this file under the root directory of your web server, e.g.: ’c:\WebServer\PRISMAoffice\cgi-bin\checksystem.htm’ You will have to modify only the lines at the very beginning of the files. Here the total number of preselected computers in the system and their IP-addresses are defined. That means the server will check these addresses preferentially, whether the respective computers or printer are logged in the net and what their operating systems and status are. You will get the IP-addresses from your system operator. You may add or delete some lines or modify the IP-addresses. However, the IP address strings (IpAddr0, IpAddr1...) must be numbered consecutively starting at zero, and the number of systems -1 (the string ’COUNT’) must be adjusted accordingly. Items to modify are marked bold. Just look at the following example. 156 A29247-X30-X-5-7670 Configuration of Web Job Submission Web Job Submission <! This is the total number of systems -1 to be checked > <Ptag FUNC= “userDefineString“ Value= “COUNT“ Value= “8“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr0“ Value= “192.168.8.1“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr1“ Value= “192.168.17.240“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr2“ Value= “192.168.17.254“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr3“ Value= “192.168.11.66“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr4“ Value= “192.168.81.19“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr5“ Value= “192.168.13.177“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr6“ Value= “192.168.98.19“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr7“ Value= “192.168.20.133“ ><Ptag> <Ptag FUNC= “userDefineString“ Value= “IpAddr8“ Value= “192.168.17.139“ ><Ptag> Next you will have to modify the file ’check_m.htm’. Here you define a range of IP-addresses that will be checked. With a button in the ’Web Job Submission’ you can execute this action. You find this file under the root directory of your web server, e.g.: ’c:\WebServer\PRISMAoffice\check_M.htm’ You will find the respective lines at the end of the document. Here you can set a range of IP-addresses which will be checked preferentially, whether the respective computers or printers are logged in the net and what their operating systems and status are. You will get the IP-addresses from your system operator. The prefix 'NETWORK', the start address 'SNODE' and end address 'ENODE' may be modified to suit your needs. However, 'NETWORK' must specify a valid class C network without trailing dot (i.e. like xxx.xxx.xxx), 'SNODE' and 'ENODE' must be numbers in the range 1 to 254, and 'SNODE' must be smaller than or equal to 'ENODE'. That means ’NETWORK’ represents the first three groups of numbers of a IP-address. ’SNODE’, which is the starting point of the address range and ’ENODE’, which is the end point of the address range, represent the last group of numbers. For customizing just modify the items marked bold. A29247-X30-X-5-7670 157 Web Job Submission Configuration of Web Job Submission <tr> <td><img src="images/button_network.gif" align="center"></td> <td><p align="center" style="font-size: 20pt"> <input type="text" name="NETWORK" value="192.168.40" size="12" style="font-family: Arial; font-size: 20pt"></p></td> </tr> <tr> <td><img src="images/button_snode.gif" align="center"></td> <td><p align="center" style="font-size: 20pt"> <input type="text" name="SNODE" value="1" size="12" style="font-family: Arial; font-size: 20pt"></p></td> </tr> <tr> <td><img src="images/button_enode.gif" align="center"></td> <td><p align="center" style="font-size: 20pt"> <input type="text" name="ENODE" value="1" size="12" style="font-family: Arial; font-size: 20pt"></p></td> </tr> Now ’Web Job Submission’ is locally accessible with your browser via the address 'http://localhost/PRISMAoffice/index.htm'. 158 A29247-X30-X-5-7670 Configuration of Web Job Submission Web Job Submission 8.2.2 Setting up Microsoft Personal Web Manager For the installation of a web server follow the Microsoft instructions for Personal Web Manager. After this you have to modify some settings for the ’Web Job Submission’. By default the root directory for your web pages will be something like ’C:\FrontPage Webs\Content’. Now you have to set up the ’PRISMAoffice’ directory. As recommended in the installation procedure (see chapter 4.3, "Installing PRISMAoffice" on page 15) you should locate it directly under the web server root. So if you install the web server before PRISMAoffice, select e.g. ’C:\FrontPage Webs\Content\PRISMAoffice’ or, if you install your web server later, move the PRISMAoffice directory to ’C:\FrontPage Webs\Content\ PRISMAoffice’. For Microsoft Personal Web Server the respective directory path is ’C:\Inetpub\wwwroot’. Now select ’Start/Settings/Control Panel’. The window ’Control Panel’ is opened. Double-click the icon ’Administrative Tools’. A29247-X30-X-5-7670 159 Web Job Submission Configuration of Web Job Submission The window ’Administrative Tools’ is opened. Double-click the icon ’Personal Web Manager’. A new window opens, ’Personal Web Manager’. 160 A29247-X30-X-5-7670 Configuration of Web Job Submission Web Job Submission Select ’Advanced’ from the menu ’View’ or click the icon ’Advanced’. You change to the ’Advanced’ view. Select ’Home’ in the ’Virtual Directories’ group and click the ’Add...’ button. The ’Add Directory’ dialog box is opened. First, in the field ’Directory’ enter the path to your ’PRISMAoffice’ directory, e.g.: C:\FrontPage Webs\Content\PRISMAoffice In the ’Alias’ field enter ’PRISMAoffice’. A29247-X30-X-5-7670 161 Web Job Submission Configuration of Web Job Submission In the ’Access permissions’ group make sure that only the option button ’Read’ is selected. Furthermore make sure that in the ’Application permissions’ the radio button ’Scripts’ is selected. Click the ’OK’ button to confirm the settings. You return to the ’Advanced Options’ view. Select ’PRISMAoffice’ in the ’Virtual Directories’ group and click the ’Add’ button to set up the virtual directory for the PRISMAoffice cgi-bin subdirectory. Enter the path to the ’cgi-bin’ diectory in the field ’Directory’, it should be C:\FrontPage Webs\Content\PRISMAoffice\cgi-bin In the ’Alias’ field enter ’cgi-bin’. Select the ’Read’, ’Write’ and ’Script Source Access’ option buttons in the ’Access permissions’ group. In the ’Application permissions’ group select the radio button ’Execute (including scripts)’. Click the ’OK’ button to confirm the settings. Confirm the displayed message with ’Yes’. You return to the ’Advanced Options’ view. Select ’Main’ from the menu ’View’ or click the icon ’Main’. You change to the ’Main’ view. 162 A29247-X30-X-5-7670 Configuration of Web Job Submission Web Job Submission You have to stop and restart the web service. To do this click the ’Stop’ button in the ’Publishing’ group. The web service is stopped now. To restart the service click the ’Start’ button in the ’Publishing’ group. A29247-X30-X-5-7670 163 Web Job Submission Configuration of Web Job Submission Now you can address the ’Web Job Submission’ via your internet browser by entering the address http:\\XXX.XXX.XX.XXX\PRISMAoffice or http:\\servername\PRISMAoffice. Substitute the X with the corresponding numbers of your server address or servername with the name of your server. 164 A29247-X30-X-5-7670 Configuration of Web Job Submission Web Job Submission 8.2.3 Setting up Apache If you use Apache Web Server, you have to modify the script aliases for the PRISMAoffice directories, which contain the necessary script files for running ’Web Job Submission’. After the installation look up the ’ScriptAlias’ directives in Apache´s ’httpd.conf‘ file, which should be located under ’C:\Program Files\Apache Group\Apache\conf’. Add the entries for PRISMAoffice as described in the following example. Note that every line starting with # is just a comment and will not be interpreted by Apache. Look at the items marked bold. # # ScriptAlias: This controls which directories contain server scripts. # ScriptAliases are essentially the same as Aliases, except that # documents in the realname directory are treated as applications and # run by the server when requested rather than as documents sent to the client. # The same rules about trailing "/" apply to ScriptAlias directives as to # Alias. # ScriptAlias /cgi-bin/ "C:/FrontPage Webs/Content/cgi-bin/" ScriptAlias /PRISMAoffice/cgi-bin "C:/FrontPage Webs/Content/ PRISMAoffice/cgi-bin/" # # "C:/Program Files/Apache Group/Apache/cgi-bin" should be changed to whatever your # ScriptAliased CGI directory exists, if you have that configured. # <Directory "C:/FrontPage Webs/Content/cgi-bin"> AllowOverride None Options None </Directory> <Directory "C:/FrontPage Webs/Content/PRISMAoffice/cgi-bin"> AllowOverride None Options None </Directory> # A29247-X30-X-5-7670 165 Web Job Submission Submitting Files 8.3 Submitting Files If you want to submit a file from your local disk (or from another one in the network) proceed as follows. Open your browser and select the address to ’Web Job Submission’. In the browser, the ’Web Job Submission’ start page opens. Now click on the button ’Job submit’ on the left side of the screen. A job ticket dialog consisting of 5 sheets will pop up for you to make your job ticket settings. 166 A29247-X30-X-5-7670 Submitting Files Web Job Submission On the first sheet data for a header page may be specified. Clicking on <Cancel> aborts the dialog and the ticket window disappears. To proceed to the second sheet click on ‘Userinfo‘, in the topmost line. The ‘Userinfo’ sheet shows up: Note: The string entered in the ‘Name’ field is used to identify the submitting user for accounting purposes, so ensure you use a suitable one. The default is the IP address of your computer. The remaining fields are for information only. A29247-X30-X-5-7670 167 Web Job Submission Submitting Files Now click on ‘Options’ to get the next sheet: The lists of available forms and printers are not hardcoded but taken directly from the spool settings. The ‘Workstation’ sheet offers the following fields: The ‘Workstation’ and ‘Network address’ fields may be used to identify your computer. The email address is currently used for information only, no email is actually generated. 168 A29247-X30-X-5-7670 Submitting Files Web Job Submission The last sheet contains some information about the software: There is no need for filling out the five job ticket sheets in any specific order, you may switch to any sheet more than once and correct the data, or skip any sheet if the defaults suit your needs. In ’Web Job Submission’ the job ticket is generated automatically from the entries you made in the above mentioned windows. Now Click on <Ok> to proceed to the file selection box: You may enter the name of the file to print manually, alternatively click on the <Browse> button to get the usual WindowsNT file selection dialog. A29247-X30-X-5-7670 169 Web Job Submission Submitting Files After you have submitted a print job successfully, the job ticket shows up shortly: Here you can control the entries and by clicking on the ’Cancel’ button you finish printing, by clicking on the ’Next Job’ button you get prepared for the next print job. 170 A29247-X30-X-5-7670 Getting Information Web Job Submission 8.4 Getting Information General Information You can query general information on the system via SNMP from the server. On the PRISMAoffice homepage click the ‘General info’ button. The resulting page will look as follows: A29247-X30-X-5-7670 171 Web Job Submission Getting Information Printers Querying PRISMAoffice spool on server for installed printers. Click the ’Printers’ button on the PRISMAoffice homepage. 172 A29247-X30-X-5-7670 Getting Information Web Job Submission Print Queue Quering PRISMAoffice spool on server for available print jobs. Click the ’Print queue’ button on the PRISMAoffice homepage. A29247-X30-X-5-7670 173 Web Job Submission Getting Information Reprint Queue Quering PRISMAoffice spool on server for available jobs for reprinting. Click the ’Reprint queue’ button on the PRISMAoffice homepage. 174 A29247-X30-X-5-7670 Appendix 9 Appendix Migration to PRISMAoffice The following graphic shows the migration from OPS PCL Generator/Driver and Océ PCL Spoolsystem to PRISMAoffice. PRISMAoffice history: From PCL Spool V1.0 to PRISMAoffice V2.00 The PCL Spool V1.02 is built on PCL Spool V1.00, enhanced with new spool functionality and adding the lp daemon as an option. The mini drivers of V1.00 were replaced with the portmonitor. PRISMAoffice V2.00 is built on the two products PCL Spoolsystem V1.02 and PCL Generator/Driver V2.0. A29247-X30-X-5-7670 175 Appendix The PCL Spool V1.02 was renamed to Print Manager Spool. The lp daemon was enhanced with multiple connection support and named Extended Line Print Server. The portmonitor was enhanced with a switch for the display of the popup window at job generation and named Windows NT Print Extension. The PCL Generator/Driver V2.0 was renamed to Printer Driver for PCL. PRISMAoffice history: From PRISMAoffice V2.00 to PRISMAoffice V2.02 PRISMAoffice V2.02 adds two new connectivity components: Print Manager Web and Windows 95 Print Extension. The Print Manager Spool is extended by a highly sophisticated SCSI driver. 176 A29247-X30-X-5-7670 Appendix PRISMAoffice history: From PRISMAoffice V2.02 to PRISMAoffice V3.0 PRISMAoffice V3.0 has the following improved security features: – The encryption of print data allows to transfer the data to PRISMAoffice in an encrypted state. In a special plugin (located in the registry in ’IF_PRE’) the data will be encoded to scan the datastream. – The restricted viewing rights allow to define particular data types (SEC_*) so that the print files which are spooled in that data types cannot be viewed. The new data types can be selected through the job generation in the job ticket. It’s not possible to assign a viewer to these data types. Furthermore has PRISMAoffice V3.0 an improved SNMP support and offers a plugin for the printing of BarCode. A PJM interface is integrated and the Printer Driver for PCL is no longer part of PRISMAoffice V3.0. The Printer Driver for PCL is now part of the Windows Application Drivers which are located in the PRISMAtools. A29247-X30-X-5-7670 177 Appendix 178 A29247-X30-X-5-7670 Glossary 10 Glossary Accounting The tracking of the printers connected to PRISMAoffice for security and billing purposes. CustomTone® A color that differs from the standard color in which the printer prints. The CustomTone® is used to emphasize text or graphics in the printout. Dithering A technique for representing shades of gray or blended colors. The areas of an image are treated as groups of dots over which the colors are distributed in different dot patterns. When viewed normally, the colors blend and are perceived as homogeneous colors or shades of gray. Driver A program that drives (controls) a device via a computer system. The driver is programmed with the specific properties of the device concerned, and allows general application programs to use the device. EMF EMF/WMF are the extensions for files in Windows Metafile formats. WMF stands for 'Windows Metafile' and EMF for 'Enhanced Metafile'. Windows Metafiles are files that start GDI (graphics device interface) functions which generate an image on an output device. Input Filter Module that can extract job ticket information from a header page of a print job. MAC Address Media access control. With networking the address of a network device. A29247-X30-X-5-7670 179 Glossary PCL Printer Control Language. Introduced by Hewlett-Packard, PCL has evolved into a de-facto standard for printing. PJL Printer Job Language. PJL was developed by Hewlett-Packard to give software applications more job-level printer control. By definition, it takes priority over the actual printer language (PCL or also Postscript) and is largely independent of this language. PJL offers functions for controlling jobs in networks and other mulit-user systems, for simulating operator panel inputs and for quering the printer status. Print Job A print job consists of the data to be printed, plus user-defined parameters (settings) to control the printer. The data can be in one or more documents. The type of printer control settings which the user can make depends on the features and capabilities of the printer and printer driver. Print Queue A squential list of print jobs waiting to be printed. Reprint Queue A sequential list of processed print jobs which will be stored for a time intervall. Resolution A measure of the granularity with which details are presented on a screen or printer. The resolution of a printer, which represents characters and images as closely-printed dot patterns, is measured in dots per inch (dpi). The more dots there are within a defined area, the more precise is the presentation. Modern high performance printers work with a resolution of 600 dpi. RGB The RGB value is used for screen presentation of colors. It indicates the proportional intensity of the colors red, green and blue. Each of the colors is specified as a value between 0 and 255. red = 255, green = 0, blue = 0 produces pure red. red = 0, green = 255, blue = 0 produces pure green. 180 A29247-X30-X-5-7670 Glossary red = 0, green = 0, blue = 255 produces pure blue. red = 255, green = 255, blue = 255 produces white. red = 0, green = 0, blue = 0 produces black. Spool Spool (Simultaneous Peripheral Operations On Line) is a program that buffers print jobs until the printer is ready to process them. The spool program accepts the jobs as fast as the applications submit them. The print output speed is determined by the printer hardware and printer driver. Spot Color See CustomTone® TrueType A method of representing fonts. A character in a TrueType font is described by means of one or more outlines. Instead of the character bitmaps, a font contains a set of instructions defining how the outlines are to be drawn. TrueType fonts are printed on the printer exactly as they are shown on the computer screen. They can be scaled to any size. Web Shorthand for Wold Wide Web. WMF Windows Metafile Format: this is a Windows format for storing vector graphics, allowing them to be exchanged between applications. A29247-X30-X-5-7670 181 Glossary 182 A29247-X30-X-5-7670 Related Publications 11 Related Publications [1] PJL for SRA Controller Reference Guide Order Number A29247-X59-X-2-7672 [2] PCL5e for SRA Controller Reference Guide Order Number A29247-X58-X-2-7672 Ordering Manuals Please apply to your local office for ordering the manuals. A29247-X30-X-5-7670 183 Related Publications 184 A29247-X30-X-5-7670 Index Date Parameters 130 Directories 87 Index A Accounting 86 Activating the Module 21, 28 Add/Remove Components 31 - Extended Line Printer Server 33 Advanced Configuration 63 Appendix 175 - Migration to PRISMAoffice 175 Archiving Jobs 123 C Changing the Column Order in a View 112 Changing the Sort Order of a Column in the Job View 112 Changing the Width of a Column 112 Choosing the Used Language 111 Column Entries in the Job View 119 Columns in the Printer View 131 Command Printers 59 Commands in the File Menu 116 Commands in the Functions Menu 117 Commands in the Help (?) Menu 118 Commands in the Job View 121 Commands in the Printer View 133 Commands in the View Menu 118 Components 3 - PRISMAoffice Spool 3 Components, Functionalities and Licenses 3 Custom Administration 11 Customizing Colors 113 Customizing HTML and Script Files 156 Customizing Printcap File and lpd.ini 136 Customizing the User Interface 111 D Data Encryption 20 A29247-X30-X-5-7670 E Extended Line Printer Server 135 - Customizing Printcap File and lpd.ini 136 F Filter Configuration File 76 Filtering Jobs in a View 125 Forms 98 - Creating and Editing Forms 100 - Form Settings 98 Functionalities 4 G General Information 171 Glossary 179 I Index 185 Installation 9 - Add/Remove Components 31 - Installing PRISMAoffice Spool 15 - Installing the BarCode Support Plugin 24 - Activating the Plugin 28 - Installing the Plugin 27 - Printing the BarCode 24 - Supported BarCodes 24 - Installing the Data Encryption Plugin 20 - Activating the Plugin 21 - Data Encryption 20 - Installing the Plugin 20 - Prerequisites 9 - Types of Installation 11 - Custom 11 - Remote Admin 12 Installing PRISMAoffice Spool 15 Installing the BarCode Support Plugin 24 Installing the Data Encryption Plugin 20 Installing the Plugin 20, 27 Installing the Remote Administration Feature 13 Introduction 1 185 Index J JEC Support for NPS File Systems 79 Job Handling 119 Job Ticket 125 Jobs States 121 K Keywords 128 L Licenses 5 LIP Control File 80 Local NT Printers 56 M Migration to PRISMAoffice 175 Miscellaneous Settings 93 N Numeric Parameters 130 O Operators 129 Ordering Manuals 183 OSPPRINT.EXE 78 P Parallel Printers 40 Parameter Formats 129 Parameters for the OSPPRINT.EXE 78 Parameters for the PRINTER Keyword 131 Parameters for the STATUS Keyword 130 PJM Server 79 Prerequisites 9 Print Job Generation with PJM Server 79 Print Manager Spool 35 - Advanced Configuration 63 - Filter Configuration File 76 - Input Filter 64 - JEC Support for NPS File Systems 79 - LIP Control File 80 - Print Job Generation with PJM Server 79 - Installing and Configuring Printers 40 - Command Printers 59 186 - Local NT Printers 56 - Parallel Printers 40 - SCSI Printers 45 - TCP/IP Printers 50 - Introduction 35 - Spool Administration 84 - Forms 98 - Security Settings 96 - Server Properties 85 - Viewing Documents 108 - User Interface 110 - Customizing the User Interface 111 - Job Handling 119 - Printer Handling 131 - Toolbar and Menu Functions 116 - Working with the In-Place Editable Dialog Boxes 115 Print Manager Spool User Interface 110 Print Queue 173 Printer Handling 131 Printer States 132 Printers 172 Printing the BarCode 24 Q Query Language Format 127 R Related Publications 183 - Ordering Manuals 183 Remote Administration 12 Reprint Queue 89, 174 Rermote Admin 13 S SCSI Printers 45 Security Settings 96 Separator Pages 90 Server Properties 85 Setting up Apache 165 Setting up Microsoft Personal Web Manager 159 Showing or Hiding Columns 113 Spool Administration 84 Supported BarCodes 24 A29247-X30-X-5-7670 Index System Requirements 7 - Hardware 7 - Software 8 T TCP/IP Printers 50 Text Parameters 130 Toolbar and Menu Functions 116 Types of Installation 11 U Using the Remote Administration 13 V Viewing Documents 108 W Web Job Submission 149 - Configuration 156 - Customizing HTML and Script Files 156 - Setting up Apache 165 - Setting up Microsoft Personal Web Manager 159 - Getting Information 171 - General Information 171 - Print Queue 173 - Printers 172 - Reprint Queue 174 - Submitting Files 166 - Web Service 149 - Web Services - Installing Windows NT SMNP Agent 150 Web Service 149 Windows 95 Print Extension 145 - Jobticket 146 Windows Job Ticket Enhancement 139 - Windows 95 Print Extension 145 - Windows NT Print Extension 139 Windows NT Print Extension 139 - Extended Options Dialog 144 - Jobticket 141 Working with the In-Place Editable Dialog Boxes 115 A29247-X30-X-5-7670 187 Index 188 A29247-X30-X-5-7670