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.
© 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.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii 1 DECprint Supervisor Overview . . . . . 1–1 1–3 1–4 1–5 1–6 2.1 Non-PrintServer Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1 Directly-Connected Serial Printers . . . . . . . . . . . . . . . . . . . . . 2.1.2 Networked Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.2.1 Raw TCP/IP Printers . . . . . . . . . . . . . .
3 Creating and Modifying Print Queues 3.1 3.2 3.3 3.3.1 3.3.2 3.3.2.1 3.3.2.2 3.3.2.3 3.3.2.4 3.3.2.5 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.3.8 3.4 3.4.1 3.4.1.1 3.4.1.2 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6 3.5 3.6 3.7 iv If You Are Installing the Software for the First Time . . . . . . . . . If You Are Upgrading From DECprint Printing Services Software (CPS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Execution Queues . . . . . . . . . . . . . . . . . . . . .
4 Providing Automatic Data Type Detection 4.1 4.2 4.2.1 4.2.2 4.2.3 How DCPS Automatically Detects Data Type . . . . . . . Specifying Automatic Data Type Detection . . . . . . . . . Linking File Extensions with Data Types . . . . . . . Specifying Default Data Types for the System and Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How Users Control Data Type Detection . . . . . . . . ........ ........ ........ 4–1 4–1 4–2 ........ ........
7 Creating Setup Modules and Device Control Libraries 7.1 7.2 7.2.1 7.2.2 7.3 7.4 7.4.1 7.4.2 7.4.3 7.4.4 7.5 7.6 7.7 7.8 7.9 7.10 7.11 7.12 What Is a Setup Module? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Locating Setup Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Locating Custom Setup Modules . . . . . . . . . . . . . . . . . . . . . . Displaying the Contents of a Setup Module . . . . . . . . . . . . . . Creating Custom Setup Modules . . . . . . . . . . . .
10 Printer-Specific Information 10.1 Apple LaserWriter Plus Printer . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.1 LPS$PERSISTENT_RESOURCES Not Supported . . . . . . . . 10.2 Compaq Laser Printer LN16 and GENICOM microLaser 170 . . 10.2.1 Printer Configuration Setting . . . . . . . . . . . . . . . . . . . . . . . 10.2.2 LAT and AppleTalk Configuration . . . . . . . . . . . . . . . . . . . . 10.
10.12 Compaq and DIGITAL Laser Printer LNC02 . . . . . . . . . . . . . . . . 10.12.1 Minimum Firmware Version . . . . . . . . . . . . . . . . . . . . . . . . . 10.12.2 Incorrect Sheet Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.13 DIGITAL PrintServer 17 Printer . . . . . . . . . . . . . . . . . . . . . . . . . 10.13.1 Colored Separator Pages and Tray Switching . . . . . . . . . . . . 10.14 HP LaserJet IIID Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.14.
11 Troubleshooting Procedures 11.1 What to Do if a Serial Printer Is Not Printing . . . . . . . . . . . . . 11.1.1 What to Do if a Locally-Connected Serial Printer Will Not Start Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1.2 What to Do if a Locally-Connected Serial Printer Has Stopped Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1.3 What to Do if a LAT Printer Is Not Printing . . . . . . . . . . . 11.1.3.
D.10 D.11 D.12 D.13 D.14 D.15 D.16 D.17 D.18 D.19 D.20 D.21 D.22 Selecting Separator Pages from Alternate Tray Stopping Unreachable PrintServer . . . . . . . . . . Overwriting First Line . . . . . . . . . . . . . . . . . . . Stall Timeouts . . . . . . . . . . . . . . . . . . . . . . . . . Requeuing a Job . . . . . . . . . . . . . . . . . . . . . . . . Reading Stream Files . . . . . . . . . . . . . . . . . . . . Copies Start on New Sheets . . . . . . . . . . . . . . . Generic Queues Restarted . . . . . . .
Tables 2–1 2–2 3–1 3–2 3–3 5–1 7–1 7–2 7–3 7–4 8–1 10–1 10–2 10–3 A–1 A–2 B–1 D–1 DECserver Port Characteristics . . . . . . . . . . . . . . . . . . . . . Printer-Required DECserver Port Characteristics . . . . . . . Raw TCP/IP Port Numbers . . . . . . . . . . . . . . . . . . . . . . . . Parameter Values for Generic Queues . . . . . . . . . . . . . . . . IVP Files with Different Data Types . . . . . . . . . . . . . . . . . Commands to Display Queues . . . . . . . . . . . . . . . . . . . . . .
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.
xiv Convention Meaning 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.
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: • Print customized documents, print two-sided, and select input trays. • Modify printed documents without changing the files that are printed, which saves paper and allows the production of custom printed documents. • Print different types of files on the PostScript printers.
DCPS also provides the following features: • Document Formatting Change the size of pages as they are printed to fit the physical size of media, using the following command: $ PRINT/PARAMETERS=(PAGE_SIZE=n,SHEET_SIZE=m) file-spec Specify page layup handling as the file is printed, using the following command: $ PRINT/PARAMETERS=(LAYUP=option=value) Save paper, using one of the following commands: $ PRINT/PARAMETERS=(PAGE_LIMIT="n,m") $ PRINT/PARAMETERS=(NUMBER_UP=n) Print multiple uncollated copies of each s
DCPS can print files that contain both text (ANSI, PCL, or Proprinter data) and PostScript data. For example, users can print electronic mail messages that contain PostScript files. The user submits the print job without specifying any data type. The DECprint Supervisor software begins printing the file as text and automatically recognizes the change to PostScript, printing the file properly.
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.
• Monitors printer progress • Reports printer status • Handles exceptions 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.
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.
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.
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.
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.
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.
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.
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.
Note On many versions of DECserver devices, QUEUING is not a port characteristic, but is a server characteristic whose default is ENABLED. 2.1.2.2.3 Editing the LAT Configuration File The LAT configuration file (SYS$STARTUP:LAT$SYSTARTUP.COM) defines host node service characteristics. Before you start the print queues, make sure the LAT driver is running and ports are available. Note Commands referenced in this section are LATCP commands.
In the command format, you supply the following values: LTAd: Name of the application port server_name Name assigned to the LAT device port_name LAT device’s port name The following example associates application port LTA9000: with port PORT_7 on a remote DECserver 200 named LN03RDS: $ SET PORT LTA9000:/NODE=LN03RDS/PORT=PORT_7/QUEUE/APPLICATION If the LAT device is dedicated to printing services, you can define the LAT connection for the printer in the DCPS$STARTUP.COM file.
3. Power on the printer. Wait for the printer to eject the power-up test page, and then check the test page to ensure that the desired settings are indicated on the test page. 2.1.2.3 AppleTalk Printers If you use your printer in an AppleTalk network, the address of the printer in the AppleTalk network is normally the printer’s PostScript printername.
To submit the file for printing as a PostScript job, use the following command: $ PRINT/QUEUE=queuename/PARAMETER=(DATA_TYPE=POSTSCRIPT) LPS$SET_TIMEOUT.PS When the print job is processed, a page is printed to indicate that the timeout was successfully changed. 2.1.3.3 Changing the Printer Password PostScript printers have passwords that restrict access to certain functions. You can change the password for your printer from the default value.
2.2 DIGITAL PrintServer Printers DIGITAL PrintServer printers are network printers. They require the OpenVMS DECnet, Compaq TCP/IP for OpenVMS, Process Software MultiNet for OpenVMS or Process Software TCPware for OpenVMS software to be running on the OpenVMS systems where the DECprint Supervisor software is running. Note Make sure that PrintServer Software is running on the PrintServer printer before starting DECprint Supervisor.
2.2.3 Deleting the PrintServer Client Startup File An existing LPS$STARTUP.COM file, if any, is no longer used and is not compatible with DECprint Supervisor. Delete this file after you edit DCPS$STARTUP.COM. To delete this file, follow this procedure: Note Delete all generic queues before deleting the execution queue. 1. Stop existing print queues with the STOP/QUEUE/RESET command. 2. Delete existing PrintServer print queues. 3. Add new print queues to DCPS$STARTUP.COM for PrintServer printers. 4.
3 Creating and Modifying Print Queues This chapter explains how to start up the printing system and test the printer. Note Make sure the system queue manager is running before creating queues. 3.1 If You Are Installing the Software for the First Time If this is a new installation, you can use the startup template file to help you set up your queues. Copy the printer startup template file as follows: $ COPY SYS$COMMON:[SYS$STARTUP]DCPS$STARTUP.TEMPLATE SYS$COMMON:[SYS$STARTUP]DCPS$STARTUP.COM 3.
disk$manager:[cps_conversion]dcps$startup.com Please read or run DIFFERENCES on the output file, DISK$MANAGER:[CPS_CONVERSION]DCPS$STARTUP.COM, to be sure the new file meets your needs. The procedure creates a startup file that DECprint Supervisor recognizes, but does not change your existing queue definitions. If you need to add new queues, see Section 3.3 DCPS has an automatic data type detection feature. Therefore, you no longer need to specify the data type as a queue default or in the PRINT command.
Example 3–1 (Cont.
where: • node is the name of the VMScluster member on which the queue executes. If the OpenVMS system is not a member of a cluster, then node:: can be omitted. • interconnect specifies the interconnect type. You can specify one of the following: • For . . . Specify . . .
Table 3–1 Raw TCP/IP Port Numbers 20nn 2501 3001 6869 9100 DECserver terminal servers, where ‘‘nn’’ is the physical port number DIGITAL LN17ps and DIGITAL Laser Printer LN17+ps Emulex NICs DIGITAL Laser Printer LN15 and LN15+ DIGITAL RapidPrint 500 print server DIGITAL Laser Printer LN20, LN40 and LNC02 Compaq Laser Printer LN16, LN32 and LNM40 GENICOM LN and microLaser printers GENICOM RapidPrint MPS100 print server Hewlett-Packard LaserJet printers Lexmark Optra printers Tektronix Phaser printers Xerox D
from translating the printer name, prefix the printer name with an underscore (_). 3.3.2.3 If Your PrintServer Printer Is Part of a TCP/IP Network Enter the device information in the following format: "IP_CPAP/address" where address is the IP address of your DIGITAL PrintServer printer in either a named or numeric format. For example, a PrintServer TCP/IP node could be specified by either of the following: "IP_CPAP/garmnd.dsg.dec.com" "IP_CPAP/16.128.144.11" 3.3.2.
• zone is the zone that includes the printer. This value is optional. The default is the AppleTalk zone for the network segment of the OpenVMS system on which the print queue is running. • type describes the printer’s accessibility. This value is optional. Generally, the type is LaserWriter. When only printername is required, the information provided for P2 would be just "APPLETALK/printername".
3. Queue defaults specified for the execution queue 4.
This qualifier allows you to include a default form definition assumed to be mounted on the printer. The default form for ANSI jobs only is DCPS$DEFAULT. If you include a form definition with the /FORM_MOUNTED qualifier, specify the same form definition in the /DEFAULT qualifier as well. • /DEFAULT=(NOFEED) The /DEFAULT qualifier specifies default PRINT qualifiers. The standard queue definition specifies a default setting of NOFEED on print jobs. You can modify this command line to include any PRINT qualifiers.
3.3.8 Enabling SET VERIFY When Initializing the Queue (P8) You can specify the setting of the SET VERIFY command for the DCPS$EXECUTION_QUEUE.COM command procedure. The default setting is NOVERIFY, to save log file space and console log space. If P8 contains 1, then SET VERIFY is enabled, which is useful for diagnosing problems in the printer startup file. (Refer to the OpenVMS DCL Dictionary for more information about the SET [NO]VERIFY command.) 3.
3.4.1.1 Managing Print Queues When Running Multistreamed The OpenVMS Queue Manager controls when a symbiont process is created and terminated. Generally a new DCPS symbiont process is created when there are no free streams in all existing DCPS symbiont processes. As previously stated, the number of streams (queues) that a DCPS process supports is determined by the value of the logical DCPS$MAX_STREAMS when a new process is started.
3.4.2 Interrupting Busy Printers When a Job Starts DCPS normally waits for a raw TCP/IP, LAT, or serial printer to be idle before sending a new job to it. This is especially important in a networked environment where a printer connected through a DECserver device or other network terminal server can be shared among DCPS queues, LATSYM queues, Windows and UNIX hosts, etc. Prior to version V1.2, DCPS used an aggressive synchronization sequence to gain control of a printer’s PostScript interpreter.
on the configuration, it’s also possible to loose print jobs if the printer data cable is disconnected or the printer is powered off. 3.4.4 Purging the Symbiont Process’s Working Set The DCPS symbiont purges its working set after it has been idle for a period of time in order to conserve system resources. The time delay is intended to help prevent the system from thrashing by keeping the program in physical memory while more work is apt to arrive.
If you use preprinted forms that depend on the old translator’s behavior, you can retain the old behavior by defining a DCPS logical: $ DEFINE/SYSTEM/EXECUTIVE DCPS$queuename_OLD_ANSI_PAGE_SIZES 1 3.5 Setting Up Generic Queues Generic queues are not associated with a specific printer; rather, they point to the execution queues.
Table 3–2 (Cont.) Parameter Values for Generic Queues Parameter Value P4 (optional) Explicit INITIALIZE/QUEUE qualifiers. P5 (optional) Setting of the SET VERIFY command. The default is SET NOVERIFY. 3.6 Activating Changes to the Queue Definitions When you create or modify the DCPS$STARTUP.COM file, you must activate the changes for the DECprint Supervisor to use the new queue definitions. You can wait until you stop and restart the system, or you can execute the DCPS$STARTUP.COM file, as follows: 1.
• If the system startup file includes a command to start LPS$STARTUP.COM, replace it with the command to start DCPS$STARTUP.COM. • If you are upgrading from DECprint Printing Services (CPS), delete the command to start CPS$STARTUP.COM from the system startup file. 3. Execute the printer startup command file: $ @SYS$STARTUP:DCPS$STARTUP.COM If the queues are on a VMScluster system, you should execute the command above from all nodes in the cluster.
$ PRINT/QUEUE=queuename/NOTIFY DCPS$IVP_data-type.DAT If the print queue is linked to a specific data type, or you are testing the LIST data type, specify the data type of the file. For example, to print DCPS$IVP_POST.DAT, use the following PRINT command: $ PRINT/QUEUE=queuename /PARAMETERS=DATA_TYPE=POSTSCRIPT/NOTIFY SYS$COMMON:[SYSTEST.DCPS]DCPS$IVP_POST.
4 Providing Automatic Data Type Detection DECprint Supervisor software can determine the data type of the file to be printed. This chapter explains how you can customize your printing system to print the types of files that users need to print. 4.1 How DCPS Automatically Detects Data Type If a user does not specify the data type and the print queue has no default data type, DCPS examines each file in the print job.
If necessary, you can create generic queues that have default data types, so that every file sent to the queue is assumed to be that data type. Only the user’s PRINT parameters can override the queue default data type. 4.2.1 Linking File Extensions with Data Types The DECprint Supervisor software uses a data file to link file extensions to data types. Use the following procedure to create a local data file of your system’s file extensions and the associated data types. 1.
POSTSCRIPT PROPRINTER REGIS TEK4014 4.2.2 Specifying Default Data Types for the System and Queues You can specify a system wide default text data type and queue-specific default text data types. If DCPS software cannot determine the data type, the file is processed as the default data type you specify. The factory default data type is ANSI. If users regularly print PCL or Proprinter text files instead of ANSI files, you should change the default from ANSI to PCL or Proprinter.
The DECprint Supervisor software attempts to determine the file data type for each file sent to the PATHWORKS queue. If a file data type cannot be determined, the file is processed as a PCL file. If the file contains PCL text followed by PostScript, it is printed properly. 4.2.3 How Users Control Data Type Detection Users control the way print jobs are processed for automatic data type detection by specifying: • The data type with the /PARAMETERS=DATA_TYPE qualifier in the PRINT command.
This feature is useful for printing files generated by electronic messaging systems. For example, you can print a PostScript file that was sent to you from someone using the messaging system, if the resulting file contains a text message header followed by PostScript data.
5 Manipulating Print Jobs and Print Queues This chapter describes the commands for maintaining and controlling print jobs, print queues, and the queue manager. Some of the commands described in this chapter require privileges. 5.1 Displaying Print Job Status You can use the SHOW ENTRY command to display the status of a print job. You do not need privileges to use this command to display your own print jobs, but privileges are required to display another user’s print jobs.
$ SHOW ENTRY 304/FULL Entry Jobname Username Blocks Status ----- ------------------- -----304 MEMO MSMITH 5 Printing On busy printer queue PS40$A12 Submitted 14-MAR-2001 10:41 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOTIFY /PRIORITY=100 File: _$1$DUA10:[MSMITH]MEMO.TXT;1 (printing) Note Print job status may be shown as ‘‘Printing’’ when the file has not yet actually started printing on the printer. 5.2 Deleting a Print Job You can delete a print job using the DELETE/ENTRY command.
If you issue DELETE/ENTRY . . . DCPS software . . . before the job burst or job flag pages are printed, may not print the job burst or job flag page. However, job trailer and job log pages are printed if the queue is set up to print them. 5.3 Releasing a Print Job in the Holding State When a print job is in the Holding state, you must release it for it to print. The user can put a job in the Holding state using the PRINT/AFTER or PRINT/HOLD command.
5.4.2 Requeuing the Currently Printing Job to Another Queue When a printer problem prevents completion of the printing job, you can requeue the print job to another printer. Use the STOP/QUEUE/REQUEUE command to send the print job to another print queue. You supply both the old queue name and the new queue name for this command.
This example changes a print job from portrait orientation to landscape orientation. If the original PRINT job contained any PRINT parameters, you must specify them all again when you modify any print parameters with the SET ENTRY/PARAMETERS command. If you do not respecify the PRINT parameters, the print job will be printed using the default parameter values for those not included in the SET ENTRY command. 5.
If it is necessary to pause the queue without waiting for the current job to complete, use the STOP/QUEUE/RESET command. For example: $ STOP/QUEUE/RESET PS$A4 This command pauses the queue PS$A4 and printing stops immediately. Note When communications problems arise with a serial or raw TCP/IP interconnect, the symbiont will keep listening for up to 4 minutes before disconnecting from the printer.
job from a queue that DCPS determines the state of the printer and its associated interconnect. 5.9 Modifying the Attributes of a Queue You can temporarily modify the attributes of a print queue with the SET QUEUE command. When the printing system is restarted, the queue attributes you set with the SET QUEUE command are lost. To permanently modify print queue attributes, edit the DCPS$STARTUP.COM file. The qualifiers to the SET QUEUE command are listed in Appendix A.
2. Pause the queue using the STOP/QUEUE/NEXT command. Wait for the printing to stop on the printer before you delete the queue. 3. Requeue all the print jobs in the queue and future print jobs for the queue using the ASSIGN/MERGE command (see Section 5.4.3). 4. Delete the queue with the DELETE/QUEUE command. Enter the queue name as an argument to this command. For example, the following command deletes the queue PS$A4 and any print jobs that were pending in that queue.
DCPS may also temporarily define a system-wide logical giving some indication of why the queue is stalled. To examine this logical, execute the following command on the system where the execution queue is running. If the queue is on a VMScluster, be sure to use the appropriate cluster member. $ SHOW LOGICAL DCPS$queuename_STALLED 5.13 Stopping and Starting the Queue Manager To stop and start all the queuing activity on the system, stop and start the queue manager.
6 Specifying Separation, Log, and Error Pages 6.1 What Are Separation Pages? Separation pages are sheets that show where a user’s print job or each file in a print job begins and ends. Separation pages include: • Burst pages - printed at the beginning of a print job or file. • Flag pages - printed at the beginning of a print job or file. • Trailer pages - printed at the end of a print job or file. A job flag page looks like a job burst page without the border around the page.
6.2 Enabling Job Separation Pages Job separation pages keep print jobs separate. Figure 6–1 shows one type of job separation page; a job burst page. Figure 6–1 A Job Burst Page This is the value of the PSM$ANNOUNCE system logical. Note: this is text from the job’s /NOTE qualifier DAN::SYSTEM JOB 713 EXAMPLE Owner UIC: Account: [SYSTEM] SYSTEM Priority: Submit queue: Submitted: Printer queue: Printer device: Started: 100 DANS_PRINTER 30−MAY−1997 22:54 DANS_PRINTER "IP_RawTCP/ln17ps.my.
@sys$startup:dcps$execution_queue DCPS_TTB4 ! P1 "SERIAL/TTB4" ! P2 DCPS_LIB ! P3 "" ! P4 "/SEPARATE=(BURST,NOFLAG,TRAILER)" ! P5 - Execution queue name Device name Logical name for /LIBRARY Default queue parameters - Default queue qualifiers Notes: • Job burst pages do not imply job flag pages for DCPS, as is true for some other OpenVMS print symbionts. • You can use the SET QUEUE command to temporarily specify job separation pages.
6.2.2 Suppressing Job Trailer Pages DCPS normally prints a job trailer page if errors occur during the job, even if /SEPARATE=TRAILER is not specified for the queue, as mentioned in sections Section 6.2 and Section 6.2.1. This behavior may be undesireable when printing on expensive media, especially if the reported errors are unimportant.
Figure 6–2 A File Flag Page This is the value of the PSM$ANNOUNCE system logical. Note: this is text from the job’s /NOTE qualifier DAN::SYSTEM JOB 713 EXAMPLE.PS;2 File: _DAN$DKA0:[SYS0.SYSMGR]EXAMPLE.PS;2 Last Modified: 15−APR−1995 14:02 Owner UIC: [SYSTEM] Length: Longest record: Priority: Submit queue: Submitted: Printer queue: Printer device: 1 block 40 bytes 100 DANS_PRINTER 30−MAY−1997 22:54 DANS_PRINTER "IP_RawTCP/ln17ps.my.org:2501" Digital Equipment Corporation OpenVMS VAX V6.
In the following example, each file in the job will be preceded by a file flag page and followed by a file trailer page: $ PRINT/FLAG=ALL/TRAILER=ALL FILE1.PS,FILE2.PS,FILE3.PS Note If the PAGE_LIMIT parameter is used in the PRINT command, or if the print job is terminated, the file flag page and file trailer page may not be printed. 6.4 Adding a System Message to Separator Pages You can add a system message to the top of job and file burst, flag, and trailer pages for all jobs printed on your system.
6.6 The File Error Page If the software cannot access the print file when the print job starts printing, a file error page is printed and the software continues with the next file in the print job (if any).
7 Creating Setup Modules and Device Control Libraries 7.1 What Is a Setup Module? A setup module is a file containing instructions that modify the appearance of a print job or redefine the instructions in the print job. You can include a setup module in a print job with the PRINT command’s /SETUP qualifier. The following example uses a setup module that specifies 600 dots-per-inch (DPI) resolution: $ PRINT/QUEUE=LPS32$2SIDES/SETUP=RES_600X600 IMAGE.
DCW1000_DISPLAY DCW1000_ENHANCED DCW1000_HIGHRES LPS$$APPLE360_INITPSDEVICE LPS$$APPLE360_SETINPUTTRAY RES_1200X1200 RES_1200X600 Note Do not modify any of the setup modules or the device control library. Some setup modules are created only for certain printers. Those setup modules have the printer name as part of their file name. For instance, the setup module DL3500_RET_DARK is intended for the DEClaser 3500 printer. Note Do not change the contents of the standard supplied device control library. 7.2.
The setup module DI_ON enables DECimage, and contains the following instructions: %! % ~~~~~~~~~~ DI_on ~~~~~~~~~~ statusdict begin false setDECimage end systemdict /languagelevel known {languagelevel} {1} ifelse 2 ge {currentpagedevice /Install get exec} if statusdict begin true setDECimage end % ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Note Some setup modules contain escape sequences or graphics, which cannot be displayed when you type the file.
Note Do not put your custom setup modules in the standard DCPS$DEVCTL library. Custom setup modules in DCPS$DEVCTL will be deleted if you upgrade DECprint Supervisor software. To create a library for setup modules, use the following command format: $ LIBRARY/CREATE/TEXT SYS$COMMON:[SYSLIB]library-name.TLB You supply the library-name, the name you give to the library.
7.4.2 Specifying a Library Search List If you have several device control libraries, you need to set up a search list of the libraries in SYS$STARTUP:DCPS$STARTUP.COM. The search list specifies which device control libraries to search, and the priority of the libraries. Example 7–1 shows a search list of device control libraries.
Command Line Example $ DEFINE/SYSTEM/EXECUTIVE/NOLOG logical-name search-list $ DEFINE/SYSTEM/EXECUTIVE/NOLOG DCPS_LIB DCPS$DEVCTL,"PS1/DATA_TYPE=POSTSCRIPT","ANSI1/DATA_TYPE=ANSI",PS2 In the command line, you supply the following information: logical-name: Use a logical name that expands to a list of library names. Make sure the logical name also appears in the execution queue definition (parameter p3). search-list: Add the list of libraries to be searched.
7.4.3 Device Control Libraries Must Exist for Queue to Start All device control libraries specified for a queue must exist for the queue to start. For example, if a queue is defined with the following logical, the libraries SYS$LIBRARY:DCPS$DEVCTL.TLB, SYS$LIBRARY:ANSI.TLB and SYS$LIBRARY:PS.TLB must all exist as text libraries: $ DEFINE/SYSTEM/EXECUTIVE DCPS_LIB DCPS$DEVCTL, "ANSI/DATA_TYPE=ANSI", "PS/DATA_TYPE=POSTSCRIPT" 7.4.
If users access a setup module frequently, you can associate the setup module with a queue, so that all print jobs submitted to that queue are printed with the setup module automatically. See Chapter 8 for instructions. 7.6 Persistently Loading PostScript Resources Note This feature applies only to desktop printers; PrintServer printers are loaded with persistent resources using the PrintServer software. Downloading PostScript code with every print job can adversely affect printing performance.
CAUTION Problems can occur from the misuse of the persistent setup feature. Keep the following in mind when using this feature: • Only PostScript setup modules can be persistently loaded. Other data types cannot be persistently loaded. • A setup module can exceed the printer’s virtual memory. Different models of printers have different capacities. For example, a setup module can overwhelm a printer with too many fonts. • A shared network printer can be used from several nodes in the network.
2. Edit DCPS$STARTUP.COM to include these libraries, as follows: DEFINE/SYSTEM/EXECUTIVE/NOLOG DCPS_LIB DCPS$DEVCTL, "PCL_LIB/DATA=PCL", "PRO_LIB/DATA=PRO", PS_LIB) The PostScript device control library (PS_LIB) must be last in the search list. 3. Create the following setup modules: • The DEF_CHAR_SET.PCL file selects the PC-8 Danish/Norwegian character set: !‘1P(11U!‘0P Replace with the escape character (decimal 27). • The DEF_CHAR_SET.
To make this change to the queue permanent, specify this form in the execution queue definition in the DCPS$STARTUP.COM file. 7.8 Specifying Printer Resolution with Setup Module These setup modules allow you to manipulate the resolution of PostScript Level 2 printers.
Table 7–2 Enabling and Disabling DECimage Setup Module Description DI_ON Turns DECimage ON DI_OFF Turns DECimage OFF Combined Parameters These setup modules adjust two DECimage parameters simultaneously. Table 7–3 DECimage Setup Modules—Combined Parameters Setup Module Description DI_HICONTRAST Punch0 = 0.2, Punch1 = 0.8 DI_LOCONTRAST Punch0 = -.1, Punch1 = 1.1 DI_BRIGHTER Punch0 = -.2, Punch1 = 0.8 DI_DARKER Punch0 = 0.2, Punch1 = 1.
Table 7–4 DECimage Setup Modules—Individual Parameters Setup Module Description DI_PUNCH0_0 Punch0 = 0 DI_PUNCH0_0P1 Punch0 = 0.1 DI_PUNCH0_0P2 Punch0 = 0.2 DI_PUNCH0_M0P1 Punch0 = -.1 DI_PUNCH0_M0P2 Punch0 = -.2 DI_PUNCH1_1 Punch1 = 1 DI_PUNCH1_0P8 Punch1 = 0.8 DI_PUNCH1_0P9 Punch1 = 0.9 DI_PUNCH1_1P1 Punch1 = 1.1 DI_PUNCH1_1P2 Punch1 = 1.2 DI_SHARP_0P5 Sharpness = 0.5 DI_SHARP_1 Sharpness = 1.0 DI_SHARP_1P5 Sharpness = 1.5 DI_SHARP_2 Sharpness = 2.
Note DECprint Supervisor software does not include any soft font modules. You may obtain soft font kits from Compaq separately. You can associate one or more default soft font modules with a print queue, so that users do not have to specify this parameter on the PRINT command line. For example, to establish CGTRIUM24_ISO1 as the default soft font module for the queue, include the following line in DCPS$STARTUP.
$ DEFINE/SYSTEM/EXECUTIVE DCPS$queuename_DEVCTL_CACHE 1 Caching device control library modules can decrease the total CPU time consumed by the symbiont by as much as 17 percent. I/O activity on the part of the symbiont is also reduced by as much as 50 percent. You can define the system logical DCPS$DEVCTL_CACHE (with no queue name specified) to specify that device control library caching is enabled for all DCPS print execution queues on that system. 7.
The device control modules associated with an unrecognized printer are: LPS$$UNRECOGNIZED_INITPSDEVICE LPS$$UNRECOGNIZED_SETCONTEXT LPS$$UNRECOGNIZED_SETINPUTTRAY LPS$$UNRECOGNIZED_SETOUTPUTTRAY If you modify these modules for a certain printer, you should always place the modified modules in a site-specific device control library (see Section 7.4).
8 Creating and Maintaining Form Definitions You can create form definitions, which users can include in their PRINT command to modify the appearance of a file. A form definition can specify several attributes for a print job, including the type of paper stock on which it is to be printed; the width, length, and margins associated with the paper; whether long text lines are to be truncated or wrapped onto another line; and setup modules to be implicitly sent to the printer.
• Form Number: You specify a number for the form you are defining. • /DESCRIPTION: You can optionally add a description to the form to help users understand what the different forms do. • /STOCK: You supply the name of the media that needs to be in the printer when this form is invoked. The media you specify must match the media in the printer. If they do not match, the job is held in the queue until users load the specified media or modify the form definition.
8.3 Creating Form Definitions for ANSI Files When you define forms for ANSI files, you can use various qualifiers that affect the page layout. For example, the following command defines the form CENTER to have a top margin of 6 and a left margin of 10: $ DEFINE/FORM /MARGIN=(TOP=6,LEFT=10) CENTER 3 You can use the qualifiers in Table 8–1 with form defintions for ANSI files only: Table 8–1 DEFINE/FORM Qualifiers for ANSI Files This Qualifier . . . Does the Following . . .
8.
8.6 Using the Default ANSI Form Definition If users omit a form definition in their PRINT command, but supply one of the following qualifiers, DECprint Supervisor links the default form definition DCPS$DEFAULT with the ANSI file.
9 Charging Users for Printer Resources This chapter describes the accounting information that is supplied to the OpenVMS accounting files by the DECprint Supervisor software. The OpenVMS Accounting Utility reads information about the use of system resources from the file SYS$MANAGER:ACCOUNTING.DAT. The DECprint Supervisor software records information in this file about printer usage. For information about the OpenVMS Accounting Utility, see the OpenVMS System Manager’s Reference Manual. 9.
When a print job has been completed successfully, the print symbiont sends a request to the job controller to insert certain accounting data fields into the accounting log file. For successful jobs and jobs terminated by the DELETE/ENTRY command, the accounting file also includes the following message: %SYSTEM-S-NORMAL, normal successful completion If the print job terminates abnormally, the information the print symbiont supplies in the accounting log may be incomplete.
The wall-clock time it took for the job to print (finish time minus start time). • Priority Queue priority of the print job. • Final Status Code Exit status of the print job. The status code for success is 00040001. • Queue Entry Queue entry number. This is the print job number. In this example, 222 is the job number: $ PRINT/QUEUE=LN03R$SCRIPT4/NOTIFY TEST.MEM Job TEST (queue LN03R$SCRIPT4, entry 222) started on queue SCRIPT4 • Queue Name Name of the print device queue.
9.3 Compatibility with Mechanical Page Counters The PrintServer printers have mechanical page counters. The mechanical page counter is different from the counter accessible through the PostScript pagecount operator. • The mechanical page counter counts all the sheets printed since the print engine was built. • The PostScript page counter counts the number of sheets printed by the controller.
10 Printer-Specific Information This chapter provides management information about using DCPS with specific printers. Printer-specific information that might be of interest to general users is in the DECprint Supervisor for OpenVMS User’s Guide rather than in this manual. The DECprint Supervisor for OpenVMS Release Notes may also contain additional printer-specific information.
10.2.2 LAT and AppleTalk Configuration To create a LAT device for use by a DCPS queue, you can use either of the following sets of values for LATCP qualifiers: • /NODE=nodename /PORT=PORT_1 • /SERVICE=service where nodename is the printer’s NIC nodename and service is the name of a valid service on the printer. These values can be obtained from the printer NIC’s status page or by logging in to the NIC via Telnet or LAT.
10.3.1 Printer and Network Firmware Versions Firmware versions are listed on the printed Summary Sheet and on the printer’s internal Web page. Printer firmware is listed as Product Version and network firmware is listed as Network Version. 10.3.2 Printer Configuration Settings 10.3.2.1 Language-Sensing Mode DCPS can print to these printers when the printer is in PostScript mode or automatic language-sensing mode. Make sure the INTERPRETER and FORMAT settings are set as described in Table 10–1.
10.3.4 Queue Aborts When Using TCPware When using TCPware with these printers, it is possible to receive numerous userdata messages on the screen and have the queue fail with an OPCOM message similar to the following: %%%%%%%%%%% OPCOM 21-APR-1999 15:09:53.22 %%%%%%%%%%% Message from user SYSTEM on ZIPPY Queue LN32_RAW: %DCPS-F-EXQUOTA, process quota exceeded This problem occurs when running TCPware V5.3-3 and network firmware V1.0/4 (990323).
Setup File Description DCW1000_CONFIG.PS Sets the printer timeouts DCW1000_DEVPARAM.PS Changes configuration of the serial port DCW1000_STARTPG.PS Enables the start page DCW1000_NOSTRTPG.PS Disables the start page DCW1000_PRNTCNFG.PS Enables a software-selected information page DCW1000_PSCRIPT.PS Changes the port to PostScript and default on all ports Notes: • When you send the DCW1000_DEVPARAM.PS file to the printer, the communications settings change and the queue hangs.
2. Set the serial port language sensing mode to Automatic. (On the front panel: Serial, Printer Type = PS/PCL Sensing), and define the DCPS$queuename_NO_SYNC logical. In this mode, the printer responds to PJL sequences and switches to native PCL 5 or PostScript as indicated by the datastream. 10.6.2 Interaction Between Communication Protocol and Native PCL Support The optional network card supports switching to native PCL; however, the protocol must be set to autosensing. 10.6.
10.7.3 Downloading and Deleting Fonts You may download or delete fonts from the DEClaser 5100 printer’s optional hard drive using the FONT_DOWNLOADER.COM procedure described in Appendix C. 10.7.4 Error Page Feature The DEClaser 5100 printer has a feature that ejects the current sheet and then prints a PostScript Error information sheet when a PostScript interpreter error occurs.
Table 10–2 LN15 Configuration Settings Setting Value Where Set Documentation PERSONALITY PS Printer console CONFIG menu LN15 User Manual NPAP MODE OFF Printer console PARALLEL menu LN15 User Manual PORT 1 BITRONICS ENABLED Ethernet card management RapidPrint 600 Print Server Installation Guide 10.9 DIGITAL Laser Printer LN17+ps The DIGITAL Laser Printer LN17+ps is an upgrade to the DIGITAL LN17ps printer.
10.9.2 Incorrect Sheet Count The sheet count reported on the job trailer page and in the OpenVMS accounting file may be several sheets too few due to a limitation with the LN17ps printer. There is no known workaround. 10.9.3 Downloading and Deleting Fonts You may download or delete fonts from the LN17ps printer’s optional hard drive using the FONT_DOWNLOADER.COM procedure described in Appendix C. 10.9.
10.11.2 First Job May Be Offset Incorrectly The first DCPS job to print to the LN40 after the printer is powered on may jog incorrectly. This occurs only if the LN40 is configured with OFFSET STACKING set to ON and COLLATION set to OFF. 10.12 Compaq and DIGITAL Laser Printer LNC02 10.12.1 Minimum Firmware Version To use the LNC02 with the Raw TCP/IP protocol from DCPS, the printer must be running a minimum firmware version of System Release 1.1.1, Revision 3.11.
4. Enable the changes by issuing the reconfigure command from the remote console facility. $ MCR LPS$CONSOLE LPS> PRIV Password: LPS> RECONFIG LPS> EXIT Refer to the DEC PrintServer Supporting Host Software for OpenVMS Management Guide for additional information. 10.14 HP LaserJet IIID Printer 10.14.
10.16 HP LaserJet 4SiMX Printer 10.16.1 Incorrect Sheet Count on Duplex Jobs The HP LaserJet 4SiMX printer exhibits the same behavior with sheet count as mentioned in Section 10.14.2. 10.17 HP LaserJet 5M Printer 10.17.1 Problems Selecting an Input Tray DCPS may ignore explicit INPUT_TRAY parameter values for the HP LaserJet 5M printer, instead utilizing paper from another input tray. DCPS may also report that TRAY_1 is not available, even though the tray is a standard tray, when tray 1 is empty.
10.18.4 Incorrect Sheet Count on Duplex Jobs The HP LaserJet 5SiMX printer exhibits the same behavior with sheet count as mentioned in Section 10.14.2. 10.19 HP LaserJet 4000, 4050 and 5000 10.19.1 Minimum Firmware Version To use an HP LaserJet 4000 or 5000 printer from DCPS, the printer must be running a minimum firmware version of 19980714 MB3.68. To use an HP LaserJet 4050 printer, it is recommended that the printer be running a minimum firmware version of 19991030 MB6.30.
10.21 HP XL300 Printer 10.21.1 Communication Problem If a file printed to the XL300 printer contains multiple userdata messages that are returned in quick succession, some messages may be lost, and others returned incorrectly. Also, occasionally, messages that the DECprint Supervisor wants returned to it will get garbled. This will result in spurious messages to the user’s terminal (if /NOTIFY is set). Otherwise, the job prints correctly. 10.22 Lexmark Optra Rt+ Printer 10.22.
11 Troubleshooting Procedures This chapter contains troubleshooting procedures for diagnosing error conditions on the printer system. When a printer problem occurs, information may be displayed on the user’s terminal if the /NOTIFY qualifier is included on the PRINT command line. This information may indicate the cause of the failure. Check the job trailer page from the print job, which shows some of the messages that result from printing.
11.1.1 What to Do if a Locally-Connected Serial Printer Will Not Start Printing The steps in this section apply to any serial printer on a local line. Step 1: Print a test page Manually print a test page on your printer, following instructions in your owner’s manual. If able to print a test page, go on to step 2 to check the printer hardware and software configurations. If the printer does not produce a test page, check the printer hardware.
• Output speed: 9600 baud The summary sheet and the terminal settings should be the same. If your printer interface runs at a different speed, make sure you set the same configuration switch settings and device characteristics. If the printer is connected directly to the host, check the baud rate setting in the printer startup command file. If you did not enter a baud rate in parameter p6 of the execution queue definition, the startup procedure sets the printer speed at 9600 baud.
The test is successful if a page of paper is ejected from the printer. If no paper is ejected, there is a faulty connection with the printer. In this case, check the communications cables. Then try the commands in the first example again. If the COPY command succeeds, but the SET HOST command fails, check the communications cables inbound from the printer to the host node for a faulty connection. Step 4: Check DCPS$STARTUP.COM Make sure that the DCPS$STARTUP.
Step 5: Check queue logical defaulting Use the following command to check the values of queue default parameters in the DCPS$STARTUP.COM file, in p4 of the execution queue definition, and in parameter p3 of the generic queue definition. $ SHOW LOGICAL DCPS$queuename_PARAMETER Step 6: Check the queue configurations The values provided in DCPS$STARTUP.COM are not validated, but simply passed as parameters to the appropriate OpenVMS commands and utilities.
Step 1: Print the IVP data sheets Print the following Installation Verification Procedure (IVP) files from SYS$COMMON:[SYSTEST.DCPS]: DCPS$IVP_ANSI.DAT DCPS$IVP_POST.DAT DCPS$IVP_REGIS.DAT DCPS$IVP_TEK4014.DAT DCPS$IVP_PCL.DAT DCPS$IVP_PROPRINTER.DAT Remember to use the appropriate DATA_TYPE parameter value, indicated in the file name following the underscore, for each of the files. For example, to print DCPS$IVP_REGIS.
Sometimes, when the serial communication cable between the printer and the host is disconnected and later reconnected, the active print job displays the status Printing when nothing is happening at the printer. Power-cycle the printer, then resubmit the lost print job. Note When reconnecting the printer to the host, turn off and then turn on the printer. Turning the printer off and on ensures proper synchronization between the print symbiont and the printer. 11.1.
Step 1: Determine your printing node To determine which node runs your printer, issue the following command, inserting the name of the print queue you use: $ SHOW QUEUE/FULL queue-name From the first line of the following sample display, you determine that FIERY is the node that runs your printer and LTA546 is the application port associated with the print queue: Printer queue LN03R3, on FIERY::LTA546, mounted form DCPS$DEFAULT (stock=DEFAULT) /BASE_PRIORITY=4 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOENABLE_GEN
Specified Remote Node Name = TAS204 Specified Remote Port Name = PORT_7 Actual Remote Node Name = TAS204 Actual Remote Port Name = PORT_7 Link Name = LAT$LINK Step 4: Determine which host controls the printer You can determine which host controls the printer by logging in to a terminal that is connected directly to a DECserver or by connecting to a LAT device over the network. If you have direct access to the DECserver port, go directly to step 4B.
You can use the service circuit name and the Ethernet address to make a connection to the LAT node using the following command: $ MCR NCP NCP> CONNECT VIA service-circuit PHYSICAL ADDRESS nn-nn-nn-nn-nn-nn After entering the NCP CONNECT command, press Return until you get the pound sign (#) prompt.
11.1.3.2 How to Troubleshoot Printer Communications Problems After determining which system controls the printer port, follow these steps. Step 1: Check port characteristics Compare the LAT port characteristics with those listed in the DECprint Supervisor for OpenVMS Software Installation Guide. To view the port characteristics, issue the SHOW PORT command at the Local> prompt or the TSM> prompt. Step 2: Use procedures in Section 11.1.
DCPS$_CONTERMINATED, Connection abnormally terminated Explanation: This message occurs when communication to the LAT node is interrupted. This results in a stopped queue. Check the following: • Power is supplied to the LAT device. • Printer port is not logged off. • All connections from LAT device to the Ethernet cable are working. DCPS$_CONTIMEOUT, Connection timed out, server not available, or incorrect server name specified Explanation: This message occurs when the server name is not recognized.
DCPS$_LRJINUSE, Port or service in use Explanation: This message usually occurs on a LAT port when port-name is not set with the queuing parameter (/QUEUE) enabled or when the queue limit is too small. On the LAT device, enter the following command: SET PORT port-name QUEUE ENABLE DCPS$_LRJNAMEUNKNOWN, Port Name is unknown Explanation: This message occurs when the port name specified in the LAT configuration file LAT$SYSTARTUP.COM is not known on the server.
To eliminate login dialog, set terminal characteristics for terminal devices by using the following procedures in this order: 1. SYSGEN AUTOCONFIGURE 2. SYSTARTUP_VMS 3. DCPS$EXECUTION_QUEUE.COM AUTOCONFIGURE uses SYSGEN parameters to set default terminal characteristics for all terminal devices on the system. Your system will not encounter the login dialog problem if SECURE_SERVER is set with SYSGEN. The SYSGEN parameter that accomplishes this is TTY_DEFCHAR2.
For example, the queue characteristics for the PrintServer device queue LPS40$FANG on node VIPER are as follows: $ SHOW QUEUE LPS40$FANG/FULL Printer queue LPS40$FANG, on VIPER::FANG, mounted form DCPS$$FORM (stock=DEFAULT) /BASE_PRIORITY=4 /FORM=DCPS$DEFAULT /LIBRARY=DCPS_LIB /OWNER=[SYSTEM] /PROCESSOR=DCPS$SMB /PROTECTION=(S:E,O:D,G:R,W:W) /SCHEDULE=(NOSIZE) /SEPARATE=(FLAG,TRAILER) $ 2. If the queue characteristics do not match those recorded in DCPS$STARTUP.
If your printer is connected to multiple nodes running different versions of the printing system, power cycling the printer may not eliminate the 30second delay. The node that connects to the printer first persistently loads its prologue. The other nodes must load the prologue with every print job. To eliminate the delay in this case, every node should run the same version of the DECprint Supervisor software. 11.
In the following example, there is an extra L in the argument to the second parameter, PAGE_ORIENTATION. Therefore, the printing system ignores the second parameter, NUMBER_UP=2. Only the first parameter, SHEET_ SIZE=B, is processed.
In general, though, users should not be encouraged to modify the contents of their files or the file extensions so that the data type can be determined. Instead, the application that generates the file may be examined and modified if necessary; or you can provide site-specific file extension files, default text data types, or generic queues with explicit default data types.
A Printing System Management Commands You use standard OpenVMS DCL commands to manage the DECprint Supervisor queues, jobs, and related system resources. Note Remember that the management commands only affect the system on which they are issued. A network printer can serve other systems as well, with each system having its own set of queues, jobs, forms, etc. A.1 Overview of Management Commands Table A–1 lists the commands used to manage print queues, print jobs, and related system resouces.
Table A–1 (Cont.) Printing System Management Commands Command Function DELETE /CHARACTERISTIC Deletes the definition of a queue characteristic. DELETE /ENTRY Deletes one or more job entries from a queue. DELETE /FORM Deletes the definition of a form. DELETE /QUEUE Deletes a queue. INITIALIZE /QUEUE Not recommended for use with the DECprint Supervisor software. SET ENTRY Changes or deletes attributes of a job that is in the queue but not currently executing.
Table A–1 (Cont.) Printing System Management Commands Command Function STOP /QUEUE /REQUEUE Stops the executing print job and requeues it to the specified queue, but does not stop the queue. STOP /QUEUE /RESET Stops a queue immediately and returns control to the system. A.2 Use of SET PRINTER with DCPS Because PostScript printers are controlled by the DECprint Supervisor software, the DCL SET PRINTER command has no meaning in a DECprint Supervisor environment.
Table A–2 SET PRINTER Qualifier Equivalents for DECprint Supervisor Queues SET PRINTER Qualifier Equivalent Control /CR Insertion of carriage return characters is controlled by the current data type translator. /FALLBACK Translation of DIGITAL multinational characters is controlled by the current font. If the character does not exist in the specified font, the font error character prints. /FF Mechanical form feeds are controlled by the current data type translator or the PostScript interpreter.
Note Not all data type translators implement the preceding functions in the same manner; refer to a translator’s documentation for specific information about its behavior.
B Logical Names used by DCPS This appendix provides some information about OpenVMS logical names that are used by the DECprint Supervisor for OpenVMS software. Here are some guidelines for using these logical names: • Any logical whose name begins with ‘‘DCPS’’ is only used by the DECprint Supervisor for OpenVMS software. Other logical names (for example, PSM$ANNOUNCE) may be used by and impact other components of your OpenVMS system.
Below is a table of the logical names used by DCPS, their acceptable values, and a brief explanation of what they mean. There are also references to other sections of this document or other documents where you can find more information about the logical names. Note In the following table, qn is an abbreviation for the queue name.
Table B–1 (Cont.) DCPS Logical Names Logical Name Acceptable Values Meanings and References Logical names that provide information to DCPS DCPS$qn_DEVICE_NAME4 string Actual device name associated with the queue when name is too long for INITIALIZE/QUEUE/ON qualifier (and SHOW QUEUE/FULL lists ‘‘DCPS$’’ as the device instead); Section 3.3.2 DCPS$qn_IGNORE_UNKNOWN_ 1 USER Disable unknown user error when username not found in UAF; Section 3.4.
C Downloading and Deleting Fonts You may be able to use the SYS$COMMON:[SYSHLP.EXAMPLES.DCPS]FONT_ DOWNLOADER.COM command procedure to list, download, and delete fonts on the optional hard drive on a printer. The procedure is known to work with the DEClaser 5100 and LN17ps printers, and may work with other printers as well. To use the procedure, invoke it and follow the prompts that it gives you.
D DECprint Supervisor (DCPS) and DECprint Printing Services Software (CPS) This appendix explains the differences between the DECprint Supervisor software and the DECprint Printing Services software, and their ability to coexist. ‘‘DCPS’’ refers to the DECprint Supervisor for OpenVMS product; ‘‘CPS’’ refers to the DECprint Printing Services product. D.1 DCPS/CPS Coexistence DCPS software can coexist on the same system with CPS Version 4.0 or Version 4.1 software.
• CPS$ANSI_FONTS.TLB This is the library containing downloadable fonts that emulate LN03 or DEClaser font cartridges. • Data type translators The DCPS product installs its translators using the same directory and file name structure that the CPS product used. Secondary messages (those generated by other facilities such as RMS, and passed along by the DCPS product) retain the code of the facility that originated the message. D.4 Startup File Converter The conversion tool, CPS_TO_DCPS_STARTUP.
D.5 Eliminating Generic Queues DCPS software has the ability to automatically detect data types, so you may be able to reduce the number of generic queues or eliminate them altogether. Refer to Chapter 4 for more information on automatic data type detection. D.6 Page Scaling The DCPS product can scale the logical page image to fit the output sheet if the job provides the following parameters: PAGE_SIZE=p,SHEET_SIZE=s Note that p and s are different values. The job assumes the parameter NUMBER_UP=1.
D.9 Page Sizes In the CPS V4.1 product, the following page sizes did not exist or were not correctly interpreted. The DCPS product defines and interprets these correctly. A6 C D 7x9 7_envelope 10x14 11x14 PostCard D.
Table D–1 (Cont.
Table D–1 (Cont.
Table D–1 (Cont.
Table D–1 (Cont.) Tray Number Values Printer Tray Tray Number Default Optional GENICOM microLaser 170 see Compaq Laser Printer LN16 GENICOM microLaser 210 and LN21 multipurpose 0 tray 1 1 tray 2 2 tray 3 3 envelope feeder 6 ♦ ♦ ♦ ♦ GENICOM microLaser 280 and LN28 multipurpose 0 tray 1 1 tray 2 2 tray 3 3 ♦ ♦ ♦ GENICOM microLaser 320 and 401 see Compaq Laser Printer LN32 D.
D.13 Stall Timeouts The CPS V4.1 software did not start the stall timer for directly-connected serial printers. The DCPS software starts the timer. In the CPS V4.1 product, the default timeout for a stall message was one minute. This frequently resulted in ‘‘queue stalled’’ messages when the printer was processing a compute-intensive page (and was not really stalled at all). In the DCPS product, the stall timeout is four minutes. D.
D.19 DCPS and PATHWORKS Libraries PATHWORKS for OpenVMS (Macintosh) creates its own device control library, MSAP$DEVCTL.TLB, and also puts its modules into the CPS library if there is one. It does not put them in the DCPS library. To rectify this, define DCPS_LIB as a search list that points to both the DCPS and PATHWORKS libraries. An example in DCPS$STARTUP.TEMPLATE shows how to do this. D.
E Ordering Additional Documentation This appendix lists Compaq software documents and documentation kits associated with PostScript printers, and their respective order numbers. The asterisk (*) in an order number stands for the latest version of the document or kit.
DECprint Supervisor Software for OpenVMS The following is the DECprint Supervisor Software for OpenVMS documentation. Complete documentation kit (order number: QA–09NAA–GZ) • DECprint Supervisor for OpenVMS Software Installation Guide • DECprint Supervisor for OpenVMS System Manager’s Guide • DECprint Supervisor for OpenVMS User’s Guide DIGITAL ANSI-Compliant Level 3 Printing Protocol The following is the DIGITAL ANSI-Compliant Level 3 Printing Protocol documentation.
Index A Accounting fields filled with zeros by job controller, 9–3 left blank by job controller, 9–3 supplied by DECprint Supervisor, 9–1 supplied by job controller, 9–2 Accounting utility, 9–1 Automatic data type detection overview, 1–2 solving problems with, 11–17 specifying a default text data type for, 4–3 B Baud rate limitations, 2–8 Bi-directional communication requirement for, 2–2 Burst page, 6–1 C Changing the character set for PCL and Proprinter files, 7–9 Character sets, changing for PCL and Propri
Default queue (cont’d) qualifiers, 3–8 Default text data type, 4–3 Defining print queue qualifiers, 3–8 DELETE/ENTRY command, 5–2 DELETE/FORM command, 8–4 Deleting forms, 8–4 print jobs, 5–2 Device control library, 1–5, 7–1 Device name, specifying in DCPS$STARTUP.
LAT protocol file, editing the, 2–7 LAT startup file, 2–4 Library search list for setup modules, 7–5 Login dialog, reducing for serial printers, 11–13 Log page, 6–1 LPD, not supported, 3–4 LPS$$UNRECOGNIZED, 7–15 M Messages network error, 11–11 Modifying DCPS symbiont behavior, 3–10 execution queue behavior, 3–10 print job attributes, 5–4 queues, 3–15 Multistreamed symbiont process changing DCPS environment with, 3–11 running DCPS as, 3–10 N Network printers troubleshooting, 11–7 O OPCOM messages, 11–1 Oth
PrintServer printers postinstallation requirements, 2–11 specifying DECnet network address, 3–6 specifying TCP/IP network address, 3–6 troubleshooting procedures for, 11–14 Print symbiont device control library for, 1–5 Proprinter files changing character set for, 7–9 PSM$ANNOUNCE, 6–6 Q Qualifiers, print queue, 3–8 Queue See Print queue Queue logical names, 11–5 Queue manager starting, 5–9 stopping, 5–9 Queue parameters default, 3–7 defaulting order of, 3–7 redefining, 3–7 syntax for, 3–7 Queue structure of
Third-party printers unsupported, 7–15 Trailer page, 6–1 Translators, 1–6 Troubleshooting procedures for a printer in a network environment, 11–7 for incorrectly translated files, 11–17 for jobs not printing, 11–1 for newly installed printers, 11–2 for PrintServer printers, 11–14 for queue default parameters, 11–16 for slow printing, 11–15 for stopped printers, 11–5 when jobs are not printing, 11–14 when layup definition files are not found, 11–16 U Unrecognized printers, 7–15 Unsupported printers, 7–15 Ind
