V'()J

8HP DECprint Supervisor (DCPS) for OpenVMSA

HP DECprint Supervisor (DCPS) for OpenVMS

System Manager's Guide

Order Number: AA--PSVEL--TE

November 2005

EThis manual describes how to create DCPS print queues, customize the ;DCPS environment and troubleshoot common printing problems.

-Revision/Update Information:IThis manual supersedes the System Manager's Guide V2.4.

"Software Version:7HP DECprint Supervisor (DCPS) for OpenVMS, Version 2.5

"Operating System:(OpenVMS Alpha Version 6.2, 7.3-2, or 8.2
! OpenVMS I64 Version 8.2 or 8.2-1
' OpenVMS VAX Version 5.5-2, 6.2, or 7.3

>Hewlett-Packard Company Palo Alto, California

CConfidential computer software. Valid license from HP required for Cpossession, use or copying. Consistent with FAR 12.211 and 12.212, CCommercial Computer Software, Computer Software Documentation, and HTechnical Data for Commercial Items are licensed to the U.S. Government +under vendor's standard commercial license.

FThe information contained herein is subject to change without notice. FThe only warranties for HP products and services are set forth in the Eexpress warranty statements accompanying such products and services. ANothing herein should be construed as constituting an additional Fwarranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

AAdobe, Adobe PostScript 3 and PostScript are trademarks of Adobe Systems Incorporated.

CIntel and Itanium are trademarks or registered trademarks of Intel ?Corporation or its subsidiaries in the United States and other countries.

BMicrosoft and Windows are U.S. registered trademarks of Microsoft Corporation.

1UNIX is a registered trademark of The Open Group.

Printed in the U.S.

AThe DECprint Supervisor documentation set is available on CD-ROM.

, 4
HContents BIndex

Preface

Intended Audience

FThis manual is for OpenVMS system managers and data center operators. GUsing this guide, you can create and modify print queues, maintain the Fprint jobs and print queues, and set up printing environments to meet 'the needs of the printing system users.

@This guide is also intended for advanced users and applications Fprogrammers who customize the printing system using form definitions, csetup modules and layup definition files. The User's GuideUser's Guide describes 5how users access the features of the printing system.

{Be sure to read the Software Installation GuideSoftware Installation Guide if you have not installed the DECprint Supervisor software.5

Document Structure

;This manual contains the following chapters and appendices:

Chapter 1 provides an overview of DCPS features.
Chapter 2 provides information about setting up a new printer or , changing the setup of an existing printer.v
Chapter 3 explains how to start up the DCPS printing environment % and test a printer and print queue.w
Chapter 4 explains data types and how to customize your DCPS D printing environment to handle the types of jobs your users print.v
Chapter 5 describes commands used to maintain and control print % jobs, queues and the queue manager.l
Chapter 6 explains job separator, log and error pages.v
Chapter 7 explains setup modules and device control libraries.w
Chapter 8 describes how to create and maintain form definitions.w
Chapter 9 describes page accounting information reported by DCPS.w
Chapter 10 contains information about using DCPS with specific printers.x
Chapter 11 contains information about troubleshooting printing problems.x
Appendix A reviews OpenVMS DCL commands used to manage queues, $ jobs and related system resources.
Appendix B provides information about logical names used by DCPS.|
Appendix C explains the use of the DCPS font download utility.s
Appendix D explains the difference between DECprint Supervisor J (DCPS) and DECprint Printing Services (CPS) software, and their ability to coexist.

**Table 1 DECprint Supervisor Documentation**
* Software Installation Guide	$ Describes how to install DCPS.
% System Manager's Guide	K Describes how system managers, data center operators and application D programmers can create and manage DCPS print queues and solve printing problems.
User's Guide	E Describes how to use DCPS to print to PostScript® printers.
: Software Product Description (SPD 44.15.xx)	? Contains the full list of printers supported by DCPS and D additional information about the features and requirements of DCPS V2.5.

Reader's Comments

BHP welcomes your comments on this manual. Please send comments to "either of the following addresses:
Internet ( openvmsdoc@hp.com
Mail Hewlett-Packard Company/
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Road
Nashua NH 03062-2698
H

How to Order Additional Documentation

GFor information about how to order additional documentation, visit the !following World Wide Web address:

"
, http://www.hp.com/go/openvms/doc/order/

>Part numbers for DCPS-related documentation are listed in the ;Ordering Additional Documentation appendix of the `Software Installation Guide, System Manager's Guide and User's Guide..

Conventions

2The following conventions are used in this manual:
Ctrl/ x A sequence such as Ctrl/N x indicates that you must hold down the key labeled Ctrl while 8 you press another key or a pointing device button.
[Return] K In examples, a key name enclosed in a box indicates that you press a J key on the keyboard. (In text, a key name is not enclosed in a box.)K
In the HTML version of this document, this convention appears as " brackets, rather than a box.
... G A horizontal ellipsis in examples indicates one of the following possibilities:
I
Additional optional arguments in a statement have been omitted.H
The preceding item or items can be repeated one or more times.M
Additional parameters, values, or other information can be entered.

( ) I In command format descriptions, parentheses indicate that you must B enclose choices in parentheses if you specify more than one.
[ ] N In command format descriptions, brackets indicate optional choices. You L can choose one or more items or no items. Do not type the brackets on M the command line. However, you must include the brackets in the syntax M for OpenVMS directory specifications and for a substring specification ! in an assignment statement.
| L In command format descriptions, vertical bars separate choices within L brackets or braces. Within brackets, the choices are optional; within M braces, at least one choice is required. Do not type the vertical bars on the command line.
{ } L In command format descriptions, braces indicate required choices; you N must choose at least one of the items listed. Do not type the braces on the command line.
bold text G This typeface represents the introduction of a new term. It also C represents the name of an argument, an attribute or a reason.
italic text N Italic text indicates important information, complete titles of manuals H or variables. Variables include information that varies in system output (Internal error4 number), in command lines (/PRODUCER== name) and in command parameters in text (whereF dd represents the predefined code for the device type).
UPPERCASE TEXT M Uppercase text indicates a command, the name of a routine, the name of 9 a file, or the abbreviation for a system privilege.
Monospace text M Monospace type indicates code examples and interactive screen displays.
- K A hyphen at the end of a command format description, command line or I code line indicates that the command or statement continues on the following line.
numbers L All numbers in text are assumed to be decimal unless otherwise noted. I Nondecimal radixes---binary, octal or hexadecimal---are explicitly indicated.

Chapter 1
DCPS Overview

1.1 Purpose of the DCPS Software

KThe DECprint Supervisor software allows people to use and manage networked 5PostScript printers. For example, it allows users to:

Print customized documents, print two-sided and select input trays.D
Modify printed documents without changing the files that are I printed, which saves paper and allows the production of custom printed documents.A
Print different types of files on the PostScript printers.B
Access printers from the OpenVMS operating system and from 1 personal computers (PCs) and Macintosh systems.

HThe system manager makes the printing system easier to use by providing:

Default queue attributes, so users do not have to specify certain % parameters, such as duplex printingJ
Setup modules, which are stored in device control libraries and are 8 used to modify the printing environment for print jobsJ
Form definitions, specifying sets of print attributes and including ; setup modules to make them all easier for users to accessH
Layup definition files, which you can create to customize the way % print jobs are printed on the media

*DCPS also provides the following features:

Document Formatting
DCPS allows users to:
- Change the size of pages as they are printed to fit the physical / size of media, using the following command:
  "
  h $ PRINT /PARAMETERS=(PAGE_SIZE=n,SHEET_SIZE=m) file-spec
  F
- Specify page layup handling as the file is printed, using the following command:
  "
  F $ PRINT /PARAMETERS=(LAYUP=option=value)
  8
- Save paper, using one of the following commands:
  "
  D $ PRINT /PARAMETERS=(PAGE_LIMIT="n,m")? $ PRINT /PARAMETERS=(NUMBER_UP=n)
  K
- Print multiple uncollated copies of each sheet via the SHEET_COUNT parameter.E
- Use device control modules for all data types via the /SETUP K qualifier. ANSI modules may include control sequences. PCL modules may include binary font data.
G
Data Type Translation
DCPS lets users print ( additional file data types, including:
- PCL 4 (Printer Control Language) files generated for printing on ( Hewlett-Packard LaserJet IID devicesG
- Proprinter files generated for printing on IBM Proprinter XL24 devices5
- ReGIS graphics files (monochrome output only)G
- TEKTRONIX files, generated for printing on TEKTRONIX 4010/4014 devicesI
- ASCII text files, to be printed with line numbers, page headers, 1 and alternating groups of gray and white barsF
- DIGITAL Document Interchange Format (DDIF) bitonal image files
4
Automatic Data Type DetectionI
Users do not need to specify the data type of the print file, in F most cases. DCPS recognizes files of the supported data types and J automatically translates them to PostScript before printing.
DCPS K can print files that contain both text (ANSI, PCL, or Proprinter data) F and PostScript data. For example, users can print electronic mail K messages that contain PostScript files. The user submits the print job L without specifying any data type. The DCPS software begins printing the H file as text and automatically recognizes the change to PostScript, | printing the file properly.
See Chapter 4 for information about E customizing the printing system to recognize and print the files $ generated by users at your site.

<DCPS Version

AThe version of DCPS software currently running on your system is Hprinted on job and file separator pages, as well as in the logical name FDCPS$VERSION. If DCPS$VERSION is undefined, DCPS has not been started on the system.X

1.2 DCPS Software Components

CThe DECprint Supervisor software includes the following components:

A print symbiont, which processes print requests from OpenVMS print queues assigned to the printerj
Queue management services, as described in Chapter 5B
Data type translators to translate non-PostScript files for printing on PostScript devicesJ
A device control library for setup modules that affect the printing W of files, as described in Chapter 7

GThe DECprint Supervisor symbiont is used in place of the OpenVMS print Bsymbiont, PRTSMB. The software is distributed as executable image files, text, and help files.

mFigure 1-1 illustrates the process by which print jobs are produced 2on an OpenVMS system and delivered to the printer.

4Figure 1-1 DCPS Software Components

OThe software components of a DECprint Supervisor printing system are described in the following sections.<

1.2.1 The Print Symbiont

GUsers send jobs to the printer using the DCL PRINT command or using an Capplication program that generates the OpenVMS system service call OSYS$SNDJBC. The print symbiont manages the print jobs. The DECprint Supervisor +software performs the following operations:

Maintains resources'
Sends control data to the printer(
Sends the data file to the printer
Monitors printer progress
Reports printer status
Handles exceptions

?For example, suppose a user issues the following PRINT command:

"
> $ PRINT /QUEUE=POST3 /NOTIFY THORNTON.TXT

HThe PRINT command line is translated to system service calls, which are Fsent to the job controller. The calls are converted to job controller Gdata structures, which are then passed to the symbiont for processing. HThe symbiont sends the processed arguments and file data to the printer Eand notifies the user by displaying messages about the status of the print job.

cSee the User's GuideUser's Guide for information about the PRINT command and its qualifiers.=

1.2.2 Device Control Libraries

HA device control library is an OpenVMS text library that contains setup Fmodules. The symbiont uses modules from the device control library to Iimplement the various PRINT parameters. The DECprint Supervisor software Hextracts the appropriate module, depending on the qualifier that either Gappears on the PRINT command line or is associated with a print queue, ,and inserts the module into the data stream.

HThe device control library also contains modules that the symbiont does @not automatically use. Some of these modules contain PostScript Gprocedures, for example, to include an error handler in a print job or ?to extend the findfont procedure to recognize ealternate character encodings. These are described in the User's GuideUser's Guide.

FYou can create setup modules to be used on your own systems. When you Fcreate setup modules, you must store them in a device control library Gother than the DCPS$DEVCTL library. Create a device control library as tdescribed in Chapter 7 and add your library to the device control 0library search list defined in DCPS$STARTUP.COM.

GWhen you create a site-specific device control library for your custom Bsetup modules, the contents of your library are retained from one Mversion of the DECprint Supervisor software to the next. The standard device Gcontrol library, DCPS$DEVCTL, is overwritten when you upgrade from one $version of the software to the next.7

1.2.3 Translators

FWhen a print job submits a print file that is not PostScript (or PCL, Fif your printer has a native PCL interpreter), the symbiont invokes a Ftranslator to translate the user's input file into PostScript. (Refer uto Chapter 4 for more information about customizing the printing #system for certain types of files.)

NDECprint Supervisor software can detect the file data type automatically. You Fneed not specify the data type on the PRINT command line. Translation Hto PostScript for successful printing is automatic. It is not necessary 8to maintain generic print queues for default data types.

DThe system manager can associate a default data type with a generic Eprint queue, allowing users to print files by specifying the generic ^queue name. See Chapter 3 for more information.

@If DCPS incorrectly identifies the data type of a file, you can +identify the data type on the command line:

"
B $ PRINT MYFILE.MEM /PARAMETERS=DATA_TYPE=ANSII $ PRINT MYFILE.POST /PARAMETERS=DATA_TYPE=POSTSCRIPT

a d f

Contents

Index

Internet	( openvmsdoc@hp.com
Mail	Hewlett-Packard Company/ OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Road Nashua NH 03062-2698

Ctrl/ x	A sequence such as Ctrl/N x indicates that you must hold down the key labeled Ctrl while 8 you press another key or a pointing device button.
`[Return]`	K In examples, a key name enclosed in a box indicates that you press a J key on the keyboard. (In text, a key name is not enclosed in a box.)K In the HTML version of this document, this convention appears as " brackets, rather than a box.
...	G A horizontal ellipsis in examples indicates one of the following possibilities: I Additional optional arguments in a statement have been omitted.H The preceding item or items can be repeated one or more times.M Additional parameters, values, or other information can be entered.
( )	I In command format descriptions, parentheses indicate that you must B enclose choices in parentheses if you specify more than one.
[ ]	N In command format descriptions, brackets indicate optional choices. You L can choose one or more items or no items. Do not type the brackets on M the command line. However, you must include the brackets in the syntax M for OpenVMS directory specifications and for a substring specification ! in an assignment statement.
\|	L In command format descriptions, vertical bars separate choices within L brackets or braces. Within brackets, the choices are optional; within M braces, at least one choice is required. Do not type the vertical bars on the command line.
{ }	L In command format descriptions, braces indicate required choices; you N must choose at least one of the items listed. Do not type the braces on the command line.
bold text	G This typeface represents the introduction of a new term. It also C represents the name of an argument, an attribute or a reason.
italic text	N Italic text indicates important information, complete titles of manuals H or variables. Variables include information that varies in system output (Internal error4 number), in command lines (/PRODUCER== name) and in command parameters in text (whereF dd represents the predefined code for the device type).
UPPERCASE TEXT	M Uppercase text indicates a command, the name of a routine, the name of 9 a file, or the abbreviation for a system privilege.
Monospace text	M Monospace type indicates code examples and interactive screen displays.
-	K A hyphen at the end of a command format description, command line or I code line indicates that the command or statement continues on the following line.
numbers	L All numbers in text are assumed to be decimal unless otherwise noted. I Nondecimal radixes---binary, octal or hexadecimal---are explicitly indicated.