# hp DECprint Supervisor (DCPS) for hp OpenVMS
System Manager's Guide

Previous | Contents | Index

# 5.7 Pausing a Queue

Use the STOP/QUEUE command to pause a queue. You must have privileges and supply the queue name to the STOP/QUEUE command.

You can pause the queue after the current print job has completed by using the STOP/QUEUE/NEXT command. This allows the current job to complete before pausing the queue. For example:

    $ STOP/QUEUE/NEXT PS$A4

This command pauses the queue PS$A4 after the current job has completed printing.

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. Therefore, under some conditions, the device is not released immediately after a `STOP/QUEUE/RESET` command is issued.

See Appendix A for more STOP/QUEUE qualifiers.

# 5.8 Starting a Queue

Use the START/QUEUE command to restart a print queue that has been paused with the STOP/QUEUE command. If you make changes to a print queue in DCPS$STARTUP.COM, restart the queue by executing the DCPS$STARTUP.COM file, as described in Section 3.7.

For example, to restart print queue PS40$A15, use the following command:

    $ START/QUEUE PS40$A15

If you interrupt a printing job when you stop the queue, the print job restarts when you restart the queue.

The logical name, DCPS$queuename_PID, is defined by the symbiont when it starts executing. This allows the system manager to determine which symbiont is assigned to a given queue, and is especially useful when using multi-streamed symbionts. See Section 3.5.1.

Note When a DCPS queue is started, the symbiont does not immediately attempt to make a connection to the printer, to minimize the possibility that the queue will not start. This is particularly important while starting queues at system boot time, to avoid introducing delays or errors into the boot process. It is not until DCPS starts processing a 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. Note that some print queue attributes cannot be set using the SET QUEUE command.

The following command limits the print jobs for the PS$DRAFT queue to those of 1000 blocks or less.

    $ SET QUEUE PS$DRAFT/BLOCK_LIMIT=1000

The SET QUEUE command requires privileges; you must supply the queue name and the appropriate qualifiers.

# 5.10 Preventing Users from Printing to a Queue

Use the SET QUEUE/CLOSE command to close a queue and prevent users from submitting print jobs to the queue. This command requires privileges and you must supply the queue name. For example:

    $ SET QUEUE/CLOSE PS$A4

After you enter this command, the PS$A4 queue is closed and users cannot submit print jobs to the queue. The print jobs that are currently in the queue are completed. You can open the print queue using the following command:

    $ SET QUEUE/OPEN PS$A4

# 5.11 Deleting a Queue

You can delete a print queue using the DELETE/QUEUE command. This command requires privileges. Follow these steps to delete a DCPS queue:

1. Make sure that there are no generic queues running that are associated with the queue that you are deleting, by displaying the queue using the SHOW QUEUE/FULL command. If there are generic queues associated with the queue, delete the generic queues first.
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.

       $ DELETE/QUEUE PS$A4

Remember to modify the DCPS$STARTUP.COM file to delete the queue permanently. Otherwise, when the printing system is restarted, the print queue you deleted will come back.

# 5.12 Responding to a Stalled Queue

Printers are reported as Stalled when the DECprint Supervisor does not receive information from the printer within a specified amount of time. When the stalled timeout value is exceeded, the following message is displayed:

    PRINTERSTALLED, Printer printer-name is stalled

You can alter the stalled printer timeout value be defining a logical:

    $ DEFINE/SYSTEM/EXECUTIVE DCPS$queuename_STALL_TIME "0 hh:mm:ss.00"

where hh:mm:ss.00 is an OpenVMS delta-time value specifying the desired time delay.

The default stalled timeout value is four minutes. HP recommends that you do not change this timeout value.

When you receive a message that the printer is stalled, you must determine if action is required. If the stalled message came from a networked printer (for example, a PrintServer printer), the stalled message probably indicates that a long time has passed between network communications and therefore you can safely ignore the stalled messages.

But if the stalled message follows other printer-related messages, they may indicate another reason for the long delay. The printer might be out of paper, or it might have a paper jam. Therefore, when a print queue is stalled, you should check your OPCOM messages to see if a printer condition was previously reported. Refer to Chapter 11 for more information.

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. System shutdown and startup procedures perform these operations automatically. The commands to stop and start the queue manager require privileges.

You can stop the queue manager using the following command:

    $ STOP/QUEUE/MANAGER/CLUSTER

When you are ready to start the queue manager, enter the following command:

    $ START/QUEUE/MANAGER

# Chapter 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. A job trailer page looks like a job flag page with the message "END OF JOB" printed at the top and with additional information listed for the job (for example, when it finished, which PRINT qualifiers and parameters were used, and how many pages were printed). File separation pages are differentiated from each other in an analagous fashion, and from job separation pages by the presence of file-specific information (for example, the file specification, file size, and modification time).

You can enable separation pages for print jobs and each file in a print job. The following sections show you how.

# 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

You enable and disable job separation pages by editing the DCPS$STARTUP.COM file; the user cannot override these settings.

Enter the /SEPARATE qualifier to parameter 5 in the execution queue entry in DCPS$STARTUP.COM, as shown here:

    @sys$startup:dcps$execution_queue -
        DCPS_TTB4 -                    ! P1 - Execution queue name
        "SERIAL/TTB4" -                ! P2 - Device name
        DCPS_LIB -                     ! P3 - Logical name for /LIBRARY
        "" -                           ! P4 - Default queue parameters
        "/SEPARATE=(BURST,NOFLAG,TRAILER)"
                                       ! P5 - 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. For example:

      $ SET QUEUE /SEPARATE=(BURST,NOFLAG,TRAILER) queuename

- Job separation pages are not affected by parameters set with the PRINT/PARAMETERS command or by the PostScript file being printed. The pages use the default PostScript context of the printer, not the context of the user's job.
- Even if you disable separation pages, DCPS prints a job trailer page if an error occurs in the print job. The job trailer page contains messages about the errors in a print job.

## 6.2.1 Error Messages on the Trailer Page

If the print job contains errors, the trailer page includes messages that can help the user determine what went wrong with the print job. Following are examples of these messages:

    28-JAN-2003 11:03  %DCPS-I-TRAYSUBST, Output will be delivered to the
    only tray on printer-name

    28-JAN-2003 11:03  %DCPS-W-INVACC, invalidaccess: Attempt to access
    restricted object or capability - offending command is get

These types of messages are also displayed on the user's terminal if /NOTIFY was specified in the PRINT command for the print job.

The following types of messages are not printed on the job trailer page:

- Start and end messages
- Hardware printer error messages, such as "out of paper"
- Messages related to communications
- Messages that the software uses to manage resources in the printer

## 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.

To prevent DCPS from printing job trailers, even when errors occur for the job, define the following system-wide logical:

    $ DEFINE /EXECUTIVE_MODE /SYSTEM DCPS$queuename_SUPPRESS_JOBTRAILER 1

Note Running DCPS this way makes it much more difficult to diagnose real problems when they arise. If you are getting nuisance error messages, HP recommends that you resolve the underlying problem rather than suppressing the messages.

## 6.2.3 Specifying a Special Input Tray for Job Burst and Flag Pages

When users print jobs on expensive or special media, it may be desirable to print job burst and flag pages from a special input tray. This technique is also useful for specifying a different color paper for separating print jobs.

You may specify a special input tray for job flag pages and job burst pages. Define a logical name using the following command:

    $ DEFINE /EXECUTIVE_MODE /SYSTEM DCPS$queuename_SEPARATOR_TRAY n

In this command, queuename is the name of the execution queue and n is the PostScript input tray number. The tray numbers are specific to your printer model and may be listed in your printer owner's manual. This feature may not work with all printers, especially newer models and those that do not select input trays with the PostScript Level 1 setpapertray operator.

The following are the values for HP, Compaq and DIGITAL printers:

Table 6-1 Tray Number Values
Printer | Tray | Tray Number
--- | --- | ---
HP LaserJet (most models) | tray 1 (multipurpose) | 3
| tray 2 | 0
| tray 3 | 1
| tray 4 | 4 or 5
| tray 5 | 6
| envelope feeder | 6
Compaq Laser Printer LN16 | upper | 0
| lower | 1
| multipurpose | 3
Compaq Laser Printer LN32 and LNM40 | multipurpose | 0
| tray 1 | 1
| tray 2 | 2
| tray 3 | 3
| tray 4 | 4
| tray 5 | 5
| envelope feeder | 6
Compaq and DIGITAL Laser Printer LNC02 | upper | 1
| lower | 5
DEClaser 1150 and 1152 | multipurpose | 0
| cassette | 1
DEClaser 2150 and 2250 | manual feed | 0
| lower | 1
| upper | 2
| envelope feeder | 3
DEClaser 3250 | multipurpose | 0
| upper | 1
| lower | 2
| high capacity feeder | 3
DEClaser 3500 | upper | 0
| lower | 2
| multipurpose | 3
DEClaser 5100 | multipurpose | 0
| upper | 1
| lower | 2
DIGITAL Colorwriter 1000 | upper | 0
| lower | 1
DIGITAL Colorwriter LSR 2000 and 2000 + | upper | 1
| lower | 2
DIGITAL Laser Printer LN15 and LN15+ | upper | 0
| lower | 1
| multipurpose | 3
DIGITAL LN17ps and Laser Printer LN17+ps | main | 0
| multipurpose | 1
| lower 1 | 2
| lower 2 | 3
| envelope feeder | 4
DIGITAL Laser Printer LN20 | multipurpose | 1
| upper | 2
| lower | 5
DIGITAL Laser Printer LN40 | upper | 1
| middle | 2
| lower | 3
| LCIT | 5
DIGITAL PrintServer 17 and 17/600 | upper | 1
| lower | 2
DIGITAL PrintServer 20, 32, 32 plus and 40 | upper | 1
| lower | 2
| LCIT | 3

# 6.3 Enabling File Separation Pages

File separation pages separate the files in the print job. Figure 6-2 shows an example of a file flag page.

Figure 6-2 A File Flag Page

To enable default file separation pages, do the following:

- For an execution queue, specify /DEFAULT=(file-separation-page) in parameter p5.
- For a generic queue, specify the /DEFAULT=(file-separation-page) in parameter p4.

Users can override the default file flag, burst, and trailer attributes for a queue by specifying the /[NO]FLAG, /[NO]BURST, and /[NO]TRAILER qualifiers in the PRINT command.

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.

Previous | Next | Contents | Index