Specify the type of printer supported by a shared print queue using the SET PRINT QUEUE command.

To set or change a printer type:

Use 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.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. For 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.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.

To continue a print queue:

Use the SET PRINT QUEUE /CONTINUE command. For 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.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.

To purge a print queue:

Use the SET PRINT QUEUE /PURGE command. For example:

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

5.3.6 Deleting a Print Queue

To remove an Advanced Server print queue from network access, use the REMOVE PRINT QUEUE command. Removing the queue removes that queue's record, including its settings and related permissions.

The following rules and restrictions apply to deleting print queues:

• You can delete only queues created by Advanced Server. You cannot use ADMINISTER commands to delete a queue created by DECprint Supervisor for OpenVMS or OpenVMS software.
• 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.
• To delete a print queue and all jobs in that queue except the job currently printing, use the REMOVE PRINT QUEUE /PURGE command.
• To remove a print queue and all jobs in its queue, including the one currently printing, cancel the currently printing job with the SET PRINT JOB/DELETE command, then use the REMOVE PRINT QUEUE command to delete the queue.

To delete a print queue:

Use the REMOVE PRINT QUEUE command. For 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.4 Managing Print Shares

The following sections describe how to 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.4.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 job, 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.4.2 Controlling Access to Print Shares

Always set permissions explicitly on a print share; this forces the permissions set on the share to apply to the queue, so they are the same on both the share and the queue. 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 set previously on the queue 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, Enabling Auditing, 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 and TOTO is the name of an existing print queue.

LANDOFOZ\\TINMAN> ADD SHARE/PRINT WESTWITCH TOTO- _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.4.3 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.

The options you can change include:

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

To change the maximum number of connections for an existing print share:

Use the MODIFY SHARE command. For example, 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>

To change the permissions for an existing print share:

Use the MODIFY SHARE command. 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.4.4 Displaying Information About Print Shares

You can display the print share information, including the permissions on the share.

To display information about a print 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.4.5 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.5 Managing Print Jobs

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

This section provides information on the following topics:

• Displaying print jobs
• 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.5.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.5.2 Holding a Print Job

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

To hold 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.5.3 Releasing a Print Job

You can release a print job that has been held, as described below. 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.5.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.5.5 Moving a Print Job in a Print Queue

You can 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.5.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.

To delete a print job:

Use the SET PRINT JOB/DELETE command. For 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 while it is 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/DELETE %PWRK-S-JOBSET, print job 3330 deleted 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.