Compaq DECprint Supervisor (DCPS) for OpenVMS

Compaq DECprint Supervisor (DCPS) for OpenVMS

System Manager's Guide

Order Number: AA--PSVEF--TE


June 2001

This manual describes how system maintainers (system managers, data center operators, and application programmers) with system privileges can create DECprint Supervisor print queues to provide printing services for the users of PostScript printers, customize the DECprint Supervisor printing system, and test the printing system. This manual also describes common problems with PostScript printing and how to solve them.

Revision/Update Information: This guide supersedes AA--PSVEE--TE.

Operating System & Versions: OpenVMS Alpha, Version 6.2, 7.2-1, or 7.3
OpenVMS VAX, Version 5.5-2, 7.2, or 7.3

Software Version: Compaq DECprint Supervisor (DCPS) for OpenVMS, Version 2.0

Compaq Computer Corporation
Houston, Texas


© 2001 Compaq Computer Corporation

Compaq, VAX, VMS and the Compaq logo Registered in U.S. Patent and Trademark Office. DECnet and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States and other countries.

All other product names mentioned herein may be trademarks or registered trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

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

Contents Index


Preface

Intended Audience

This manual is for OpenVMS system managers and data center operators. Using this guide, you can create and modify print queues, maintain the print 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 programmers who customize the printing system using form definitions, setup modules, and layup definition files. The User's GuideUser's Guide describes how 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.

Associated Documents

For information about additional PostScript printing documentation and how to order documentation, refer to the Ordering Additional Documentation appendix in this manual.

Conventions

The following conventions are used throughout this document:
Convention Meaning
UPPERCASE Uppercase characters indicate DCL commands, qualifiers, and parameters.
italics Italic characters in command examples indicate that you are to substitute a word or value of your choice.
bold Bold characters are PostScript operators or error message prefix strings. Bold in examples shows the characters that you should enter as part of the procedure.
[] Brackets indicate that the enclosed item is optional.
Ctrl/ x This symbol indicates a control key sequence. Press the key labeled Ctrl while you simultaneously press another key, represented by x.
[Return] This symbol indicates that you should press the Return key.


Chapter 1
DECprint Supervisor Overview

1.1 Purpose of the DECprint Supervisor Software

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

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

Note

Starting with DCPS V2.0, the need for DCPS-OPEN and DCPS-PLUS licenses has been eliminated. The right to use all features of DCPS is now included with the OpenVMS operating system license.

DCPS also provides the following features:

1.2 DECprint Supervisor Software Components

The DECprint Supervisor software includes the following components:

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

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

Figure 1-1 DECprint Supervisor Software Components


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

1.2.1 The Print Symbiont

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

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


$ PRINT/QUEUE=POST3/NOTIFY THORNTON.TXT

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

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

1.2.2 Device Control Libraries

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

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

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

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

1.2.3 Translators

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

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

The system manager can associate a default data type with a generic print 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:


$ PRINT MYFILE.MEM /PARAMETERS=DATA_TYPE=ANSI
$ PRINT MYFILE.POST /PARAMETERS=DATA_TYPE=POSTSCRIPT


Chapter 2
Setting Up Printers

If you are installing DECprint Supervisor for the first time, or installing new printers, read this chapter. You may also find this chapter useful if you are changing the setup of an existing printer. The following sections describe how to set up your printers to work with DECprint Supervisor software.
Non-PrintServer printers Section 2.1
DIGITAL PrintServer printers Section 2.2

Note

If you are changing the setup of a printer for which a DECprint Supervisor queue already exists, you must first stop the associated queue using the STOP/QUEUE/NEXT or STOP/QUEUE/RESET command.

2.1 Non-PrintServer Printers

You can connect PostScript printers other than DIGITAL PrintServer printers to your OpenVMS system in a number of ways:

If your printer is connected via the network, multiple systems can access it.

The devices that can be used with DECprint Supervisor software are listed in the Software Product Description (SPD).

Note

DCPS requires that the entire communication path between your OpenVMS system and your printer be bi-directional. For a networked printer, this communication path includes the connection between the printer and the network device as well as the connection between the network device and your OpenVMS system. LAT and AppleTalk network devices, and serial interfaces, usually provide bi-directional communication. Raw TCP/IP network devices, and parallel ports on a printer, terminal server, or print server, may not satisfy this requirement. The DCPS software will not work with a connection that does not allow status messages and other information to be sent from the printer to your OpenVMS system.

CSA0 (printer port 0 on VAXstation II and VAXstation II/GPX systems) is not a supported interface for serial printers.

DEClaser printers may require an H8571--E adapter if you are using a DECconnect serial cable. Refer to your printer installation guide for more information.

2.1.1 Directly-Connected Serial Printers

For your printer and OpenVMS system to be able to communicate, you must set the baud rate of your printer and system's serial interfaces to the same values. Also, your printer should be set for eight-bit characters with no parity.

Note

When choosing a baud rate other than the default of 9600 baud, consider the following limitations:
  • OpenVMS drivers do not support baud rates of 3600 and 7200 baud.
  • DMZ32 serial interfaces, Revision E or lower, require a speed of 4800 baud or less.
  • If you select an improper speed, the printer may not operate or may stop unexpectedly.

Refer to your printer's hardware installation guide for information on configuring its serial interface. After you have made the necessary changes, turn the printer off and back on. Then manually print a test page and verify that the reported settings are as desired.

Set the baud rate of your OpenVMS system's serial interface by specifying a value for P6 when setting up the corresponding DCPS print queue, as described in Section 3.3.6.

2.1.2 Networked Printers

Your printer may contain a network interface card (NIC) or may be accessable to the network via a print server of a terminal server.

Printers can be configured as network printers if:

Network printing has the following implications:

2.1.2.1 Raw TCP/IP Printers

Raw TCP/IP is a network protocol that utilizes the TCP/IP protocol directly without any additional interpretation of the TCP data stream. It is supported by many printer Network Interface Cards (NICs), print servers, and terminal servers.

There are other printer protocols that layer upon TCP/IP, including CPAP (Common Printer Access Protocol), LPD, and Telnet. DCPS uses CPAP to communicate with DIGITAL PrintServer printers.

Note

DCPS does not support the Telnet or LPD protocols.

To communicate with your printer using raw TCP/IP, the NIC, print server, or terminal server that you use to connect your printer to the network must provide a raw TCP/IP port. Further, this raw TCP/IP port must support bi-directional communication between the printer and your OpenVMS system. DCPS does not work with unidirectional ports, such as those found on the NICs for the DEClaser 3500 and 5100 printers, the RapidPrint 200, and Hewlett-Packard JetDirect cards that interface with the printer via its XIO (versus MIO) slot.

Before you can communicate with your printer via TCP/IP, you must define an IP address for it. You may also assign a name to the address. Refer to the printer documentation for information on setting the printer's IP address. Refer to Compaq TCP/IP Services for OpenVMS, Process Software MultiNet for OpenVMS, or Process Software TCPware documentation for information on configuring your OpenVMS system's TCP/IP environment. If your printer is connected through a print server or terminal server, you must configure the IP address of the server. You also need to configure the connection between the printer and the server (for example, you may need to perform actions similar to those described in Section 2.1.2.2.2 for LAT printers). Refer to documentation for your terminal server or printer server for information on configuring its network and printer interfaces.

2.1.2.2 LAT Printers

2.1.2.2.1 Configuring the Printer for LAT Access

To configure serial printers as network printers through a LAT connection to the Ethernet, change the following:

  1. If you are using a serial printer connected via a terminal server, set the necessary port and server characteristics for the printer (see Section 2.1.2.2.2 for DECserver devices).
  2. Make the necessary changes to SYS$STARTUP:LAT$SYSTARTUP.COM (see Section 2.1.2.2.3).
  3. Set the communications speed (see Section 2.1.2.2.4).

You can also change the printer password and printer name. These changes are optional and explained in Section 2.1.3.3 and Section 2.1.3.4.

2.1.2.2.2 Setting DECserver LAT Port Characteristics

Note

The process for configuring non-DECserver LAT devices is not described here, but many LAT devices use the same commands used by a DECserver device. Refer to the online help or other documentation for your NIC, terminal server, or print server for more information.

To change DECserver port characteristics, you need privileged status on the DECserver device. Once you have privileged status, use the DEFINE PORT and SET PORT commands.

The DEFINE command changes the port's characteristics in the server's permanent database. These changes do not take effect until the next login for the port.

SET commands take effect immediately, but only alter the port's characteristics for the current session. For example, to change the INPUT SPEED and OUTPUT SPEED values on PORT_6 to 19200 baud (on a DECserver 200), issue the following commands from the console server manager:


LOCAL> SET PRIVILEGED
PASSWORD> password
 
LOCAL> SET PORT 6 SPEED 19200
LOCAL> DEFINE PORT 6 SPEED 19200

Note

DECprint Supervisor supplies a sample command file for this purpose, if using LAT. This command file sets the characteristics for a DECserver with the Terminal Server Manager (TSM) software, and records data in the TSM database. (TSM is a software product available separately from Compaq.) The command file is:


SYS$COMMON:[SYSHLP.EXAMPLES.DCPS]DCPS$CONFIG-PRINTER-PORT.COM 


This command file provides examples of characteristics for DECserver 100, DECserver 200, and DECserver 500 devices.

For information about the commands and procedures for your DECserver device, refer to your DECserver management guide.

Make sure the DECserver port characteristics match the settings on your printer. Table 2-1 and Table 2-2 list DECserver port characteristics that must match the settings on your printer.

Table 2-1 DECserver Port Characteristics
Character size 8
Parity None
Input speed 9600
Output speed 9600

Make sure the queue limit is not set to 0, which disables queuing.

Table 2-2 Printer-Required DECserver Port Characteristics
Characteristic Default Settings
ACCESS REMOTE
AUTOBAUD DISABLED
AUTOCONNECT DISABLED
AUTOPROMPT DISABLED
BREAK DISABLED
BROADCAST DISABLED
FLOW CONTROL XON
INPUT FLOW CONTROL 1 ENABLED
OUTPUT FLOW CONTROL 1 ENABLED
INACTIVITY LOGOUT DISABLED
LOSS NOTIFICATION DISABLED
MESSAGE CODES DISABLED
QUEUING ENABLED
VERIFICATION DISABLED


1Characteristic not supported by the DECserver 500 server.

Note

On many versions of DECserver devices, QUEUING is not a port characteristic, but is a server characteristic whose default is ENABLED.


Next Contents Index