Compaq PATHWORKS for OpenVMS (Advanced Server)
Server Administrator's Guide


Previous Contents Index

5.3.2.1.2 Displaying Information About a Single Print Queue

To display information about a single print queue, specify the queue name with the SHOW PRINT QUEUE command, as in the following example:


LANDOFOZ\\TINMAN> SHOW PRINT QUEUE TOTO 
Name            Jobs    Status          Printer/Routing   Description 
-----------     ----    ------------    ---------------   ---------------- 
TOTO             1      printing        LRA0:GENERIC 
 
LANDOFOZ\\TINMAN> 

The Advanced Server displays the queue name and status of the queue and the number of print jobs currently in the queue.

5.3.2.2 Changing the Printer Type

Specify the type of printer supported by a shared print queue using the SET PRINT QUEUE command with the /TYPE qualifier. For example, the following command sets the print queue TOTO to support a DEClaser 3200 printer:


LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/TYPE=DL3200 
%PWRK-S-QUESET, characteristics set for queue "TOTO" on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.3 Pausing a Print Queue

You can hold or pause a print queue; this prevents the queue from sending any jobs to printers. When you do this, printers associated with the queue finish printing their current jobs, but all further jobs stay in the queue until the queue is released.

To pause a print queue, use the PAUSE PRINT QUEUE command, as in the following example:


LANDOFOZ\\TINMAN> PAUSE PRINT QUEUE TOTO 
Do you really want to pause print queue "TOTO" [YES or NO] (YES) : YES 
%PWRK-S-QUESET, queue "TOTO" paused on server "TINMAN" 
 
LANDOFOZ\\TINMAN> SHOW PRINT QUEUE 
Name         Jobs  Status               Printer/Routing    Description 
----------   ----- ------------------   ---------------    ---------------- 
BRUCE_PRNT       0 destination paused   LRA0:GENERIC 
PARSIFAL         0 ACTIVE               BRUCE_PRNT 
TOTO             0 PAUSED               BRUCE_PRNT         Printer in the 
                                                           Land of Oz 
LANDOFOZ\\TINMAN> 

You can also pause a print queue with the SET PRINT QUEUE/PAUSE command. In the following example, the queue called BRUCE_PRNT is a printer queue that points to a physical device, LRA0:GENERIC, and the queues GLENDA and TOTO are routing queues that point to the printer queue BRUCE_PRNT.


LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/PAUSE 
%PWRK-S-QUESET, queue "TOTO" paused on server "TINMAN" 
 
LANDOFOZ\\TINMAN> SHOW PRINT QUEUE 
Name          Jobs  Status               Printer/Routing    Description 
----------    ----- ------------------   ---------------    ------------ 
BRUCE_PRNT       0  destination paused   LRA0:GENERIC 
GLENDA           0  ACTIVE               BRUCE_PRNT 
TOTO             0  PAUSED               BRUCE_PRNT         Printer in the 
                                                            Land of Oz 
LANDOFOZ\\TINMAN> 

5.3.2.4 Continuing a Print Queue

After you have paused a print queue, you can continue printing on the queue, returning it to normal status. Continuing a queue that is in an error condition clears the error. Use the SET PRINT QUEUE /CONTINUE command, as in the following example:


LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/CONTINUE 
%PWRK-S-QUESET, queue "TOTO" continued on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example continues a paused print queue. Any jobs that were waiting in the paused print queue can now print.

5.3.2.5 Purging Print Jobs from a Print Queue

You can purge a shared print queue; that is, you can delete all jobs in the queue except the one currently printing. Use the SET PRINT QUEUE /PURGE command, as in the following example:


LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/PURGE 
%PWRK-S-QUESET, queue "TOTO" purged on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.6 Deleting a Print Queue

To remove an Advanced Server print queue from network access, use the REMOVE PRINT QUEUE command. Removing the queue deletes the OpenVMS queue, but does not remove any print shares assigned to the print queue; these must be removed manually.

The following rules and restrictions apply to deleting print queues:

To delete a print queue, use the REMOVE PRINT QUEUE command, as in the following example:


LANDOFOZ\\TINMAN> REMOVE PRINT QUEUE TOTO 
Do you really want to remove print queue "TOTO" [YES or NO] (YES) : YES 
%PWRK-S-QUEREM, queue "TOTO" removed from server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This command removes the print queue called TOTO from the list of print queues known to the server called TINMAN. All jobs in the queue complete before the queue is removed.

5.3.2.7 Managing Print Shares

The following sections describe how to create print shares, set permissions on print shares to control access to the printers, how to change the characteristics of a print share, and how to stop sharing a print queue. To manage print shares, you must be logged on to a user account that is a member of one of the following groups:

There are no special requirements for displaying print share information.

5.3.2.7.1 Creating an Advanced Server Print Share

To give network users access to a print queue, you share that queue over the network by creating a print share. To access the print queue, network users specify the share name associated with that queue. If you do not specify permissions when you add the print share, it is available to all users. You control user access by specifying permissions for the print share. When multiple permissions apply to a print share, the minimum permission is used. To create a print share, use the ADD SHARE/PRINT command and set permissions for the share. You should add a print share based on a routing queue that points to the specific printer queue. For example:

  1. Set up your routing queue.
  2. Set up your print share with the same name as the routing queue.

For example, the following command sets up a print share called GLENDA. The share name is the same as the routing queue name, as required by Windows NT.


LANDOFOZ\\TINMAN> ADD SHARE/PRINT GLENDA/DESCRIPTION="GLENDA's print share" 
%PWRK-S-SHAREADD, share "GLENDA" added on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.8 Controlling Access to Print Shares

To control user access to print shares, you can assign users to the groups that have the appropriate access permissions, or you can assign permissions directly to shares.

Permissions set on the share will apply to the queue as well. If you do not specify permissions on a print share, the default is to allow access by all users (that is, /PERMISSIONS=(EVERYONE=FULL)). The default setting sets permissions on the share, not on the queue. Any permissions that applied previously to a queue (that is, which previously were associated with another share) are retained and not explicitly visible. Therefore, when you add a print share that points to an existing queue, the queue may have permissions retained from a previous print share, which may conflict with the permissions on the print share. To ensure that permissions are set correctly, set permissions when you set up a new print share.

You can specify the following access permission levels for print shares:

As part of monitoring printer security, you can enable auditing and keep track of successful and failed attempts to access a print share. The server logs these events in the audit trail. To set auditing for printer access, use the SET AUDIT POLICY command. For example:


LANDOFOZ\\TINMAN> SET AUDIT POLICY/AUDIT/SUCCESS=ACCESS/FAILURE=ACCESS 
%PWRK-S-AUDPOLSET, audit policy set for domain "LANDOFOZ" 

See Section 6.1.3.3, Auditing Security Events Domainwide, for information about enabling auditing for printer events.

To set permissions for a shared print queue, use the ADD SHARE/PRINT command or the MODIFY SHARE command. The following example adds a share called WESTWITCH and sets the permissions for the print share so that user SCARECROW has full access to the share, but user LION has no access to the share. The share WESTWITCH is a print share for an existing print queue named WESTWITCH.


LANDOFOZ\\TINMAN> ADD SHARE/PRINT WESTWITCH - 
_LANDOFOZ\\TINMAN>/PERMISSIONS=(SCARECROW=FULL,LION=NONE) 
_LANDOFOZ\\TINMAN>/DESCRIPTION="Shared Print Queue in the Land of Oz" 
%PWRK-S-SHAREADD, share "WESTWITCH" added on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.9 Changing Print Share Options

The Advanced Server lets you change the options for an existing print share. For example, you may want to revise the share's description. Changes you make take effect immediately for new print jobs, but do not affect jobs already in the queue, except for changes in the routing list. Use the MODIFY SHARE command.

The options you can change include:

5.3.2.9.1 Example: Changing the Maximum Number of Connections for an Existing Print Share

To set the print share TOTO to have no limit on the number of client connections, enter the following command:


LANDOFOZ\\TINMAN> MODIFY SHARE TOTO/NOLIMIT 
%PWRK-S-SHAREMOD, share "TOTO" modified on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.9.2 Example: To Change the Permissions for an Existing Print Share

The following example modifies permissions for the print share WESTWITCH, so that user LION has PRINT access to the share, and user TINY has MANAGE_DOCUMENTS access to the share:


LANDOFOZ\\TINMAN> MODIFY SHARE WESTWITCH - 
_LANDOFOZ\\TINMAN>/PERMISSIONS=(LION=PRINT,TINY=MANAGE_DOCUMENTS) 
%PWRK-S-SHAREMOD, share "WESTWITCH" modified on server "TINMAN" 

5.3.2.10 Displaying Information About Print Shares, Using ADMINISTER Commands

You can display the print share information, including the permissions on the share. Use the SHOW SHARES /FULL command. For example, to display the permissions for the print share WESTWITCH, enter the following command:


LANDOFOZ\\TINMAN> SHOW SHARES WESTWITCH/FULL 
 
Shared resources on server "TINMAN": 
Name          Type       Description 
-----------   ---------  --------------------------------------- 
WESTWITCH     Printer    Shared Print Queue in the Land of Oz 
    Path: TOTO 
    Connections:  Current: 0, Maximum: No limit 
    Share Permissions: 
        Everyone                        Full Control 
        LION                            Print 
        TINY                            Manage Documents 
  Total of 1 share 
 
LANDOFOZ\\TINMAN> 

5.3.2.11 Stopping a Print Share

You may need to stop sharing a print share for several reasons:

To stop sharing a print share, use the REMOVE SHARE command. The queue still exists and can be displayed using the SHOW PRINT QUEUE command, but it is unavailable to network users. Jobs in the print queue complete as usual. For example:


LANDOFOZ\\TINMAN> REMOVE SHARE TOTO 
Do you really want to remove share "TOTO" [YES or NO] (YES) : YES 
%PWRK-S-SHAREREM, share "TOTO" removed from server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

5.3.2.12 Managing Print Jobs

The Advanced Server lets you display and control print jobs in Advanced Server print queues.

This section provides information about the following topics:

To manage print jobs, you must be logged on to a user account that is a member of one of the following groups:

There are no special requirements for displaying print job information.

5.3.2.12.1 Displaying Print Jobs

To display print jobs, use the SHOW PRINT JOBS command. For example:


LANDOFOZ\\TINMAN> SHOW PRINT JOBS 
 
Routing Queue TOTO : ACTIVE 
        Job  User Name       Size         Status 
        ---- --------------- -----------  ---------- 
          5  system                  512  QUEUED 
          6  system                  512  QUEUED 
          7  system                  512  PAUSED 
 
LANDOFOZ\\TINMAN> 

5.3.2.12.2 Pausing a Print Job

If you have FULL or MANAGE_DOCUMENTS permission on the share, you can pause (or in OpenVMS terminology, hold) any print job that the queue has not yet sent to the printer. The paused job stays in the queue until you release it; other jobs in the queue are printed. Other users can pause and release their own print jobs.

To pause a print job, use the SET PRINT JOB /HOLD command. For example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/HOLD 
%PWRK-S-JOBSET, print job 3330 held on server "TINMAN" 
 
LANDOFOZ\\TINMAN> SHOW PRINT JOB 
 
Routing Queue TOTO : PENDING 
        Job   User Name            Size         Status 
        ----  ----------------     ------------ --------------- 
        3330  system                        512 PAUSED 
 
LANDOFOZ\\TINMAN> 

This example pauses or holds print job number 3330.

5.3.2.12.3 Releasing a Print Job

You can release a print job that has been held. The job prints when it reaches the top of the queue.

To release a print job, use the SET PRINT JOB /RELEASE command. For example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/RELEASE 
%PWRK-S-JOBSET, print job 3330 released on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example releases the specified print job that was on hold. The job then proceeds to print.

5.3.2.12.4 Restarting a Print Job

You can restart a print job, printing it again from the beginning. This can be useful if a job is interrupted by an error or printer problem.

To restart a print job, use the SET PRINT QUEUE /RESTART command. For example:


LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/RESTART 
%PWRK-S-JOBACTION, print job 1 at server "TINMAN" has been restarted 
 
LANDOFOZ\\TINMAN> 

5.3.2.12.5 Moving a Print Job in a Print Queue

You can use the SET PRINT JOB command to move a print job to the beginning or end of the queue.

To move a print job to the first position in its queue, use the SET PRINT JOB/FIRST command. For example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/FIRST 
%PWRK-S-JOBSET, job 3330 set to first position on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example moves job number 3330 in the print queue to the first position in the queue. It prints as soon as any currently printing job is done.

To move a print job to the last position in a queue, use the SET PRINT JOB /LAST command. For example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/LAST 
%PWRK-S-JOBSET, job 3330 set to last position on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example moves print job number 3330 to the last position in the print queue. The print job prints after all other print jobs currently in the queue are done.

5.3.2.12.6 Deleting a Print Job

If you have FULL or MANAGE_DOCUMENTS permission on the share, you can delete any job that is waiting in a print queue. Other users can delete their own print jobs. Use the SET PRINT JOB /DELETE command to delete a print job. To abort a print job that is currently printing, use the SET PRINT JOB /ABORT command.

To delete a print job, use the SET PRINT JOB/DELETE command, as in the following example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/DELETE 
%PWRK-S-JOBSET, print job 3330 deleted on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example deletes job number 3330 from the print queue.

To cancel a print job that is currently printing, use the SET PRINT QUEUE/ABORT command.

When you need to shut down a printer immediately, you may need to cancel a print job that is printing. Or you may need to cancel a print job that is printing incorrectly, such as a PostScript file that is printing as an ASCII or text file. For example:


LANDOFOZ\\TINMAN> SET PRINT JOB 3330/ABORT 
%PWRK-S-JOBSET, print job 3330 aborted on server "TINMAN" 
 
LANDOFOZ\\TINMAN> 

This example cancels print job number 3330 while it is printing. To restart a deleted job, you must resubmit the print job.


Previous Next Contents Index