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

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:

• You can delete only queues created by the Advanced Server. You cannot use ADMINISTER commands to delete a queue created by DECprint Supervisor for OpenVMS or OpenVMS software.
• Before deleting a printer queue (one that points directly to an OpenVMS execution queue), you must use the following commands, in the order shown:
  1. PAUSE PRINT QUEUE --- to pause the print queue. Pausing the queue is an OpenVMS restriction. You do not have to pause a routing queue before deleting it. (When you use the REMOVE PRINT QUEUE command to delete a print queue, the queue is not deleted until all jobs in that queue complete.)
  2. REMOVE PRINT QUEUE --- to delete any routing queues that point to the printer queue.
  
  Then, use the REMOVE PRINT QUEUE command to delete the printer queue. The following example shows the sequence of commands required to remove printer queue GLENDA1. Routing queue GLENDA points to GLENDA1.

  LANDOFOZ\\TINMAN> PAUSE PRINT QUEUE GLENDA1/NOCONFIRM %PWRK-S-QUESET, queue "GLENDA1" paused on server "TINMAN" LANDOFOZ\\TINMAN> REMOVE PRINT QUEUE GLENDA Do you really want to remove print queue "GLENDA" [YES or NO] (YES) : YES %PWRK-S-QUEREM, queue "GLENDA" removed from server "TINMAN" LANDOFOZ\\TINMAN> REMOVE PRINT QUEUE GLENDA1 Do you really want to remove print queue "GLENDA1" [YES or NO] (YES) : YES %PWRK-S-QUEREM, queue "GLENDA1" removed from server "TINMAN"

• To delete a print queue and all pending jobs in that queue except the job currently printing, first use the SET PRINT QUEUE/PURGE command to delete the pending print jobs, then use the REMOVE PRINT QUEUE command.
• To remove a print queue and all jobs in its queue, including the one currently printing, use the following commands, in the order shown:
  1. SET PRINT QUEUE/PURGE --- to delete all pending print jobs.
  2. SET PRINT JOB/DELETE --- to delete the currently printing job.
  3. REMOVE PRINT QUEUE --- to delete the queue.

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:

• Administrators
• Account Operators
• Server Operators
• Print Operators

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:

• NONE---Users have no access to the share.
• PRINT---Users have print access to the share. Can pause and delete their own print jobs.
• MANAGE_DOCUMENTS---Users can manage print jobs; for example, pause and delete print jobs not their own.
• FULL---Users have full access to the share. Can modify and delete both shares and queues. This is the default if you do not specify permissions when creating the share.

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:

• Description
• Maximum number of users (limit)
• Permissions

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

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 reorganize shared print queues
• To remove a printer, if this printer is the only printer servicing the queue
• To remove a shared print queue that is no longer needed

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:

• Displaying print jobs
• Pausing (holding) a print job
• Releasing a print job
• Restarting a print job
• Moving a print job in a print queue
• Deleting a print job

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

• Administrators
• Server Operators
• Print Operators

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.