You can display, delete, and modify your print jobs using the commands described in this chapter. You can also list the print jobs in the queue and the status of your print jobs.

2.1 Displaying Print Jobs

The SHOW ENTRY command allows you to display information about your print jobs.

If you want to see the status of a particular print job, include the job number in the SHOW ENTRY command. For example:

$ SHOW ENTRY 96

Entry Jobname Username Blocks Status ----- -------- -------- ------ ------ 96 MEMO MSMITH 114 Holding until 27-JAN-2003 17:00 On idle printer queue LP40$A14

You can get more information about the print job if you include the /FULL qualifier. For example:

$ SHOW ENTRY 96/FULL

Entry Jobname Username Blocks Status ----- -------- -------- ------ ------ 96 MEMO MSMITH 114 Holding until 27-JAN-2003 17:00 On idle printer queue LPS40$A14 Submitted 27-JAN-2003 10:36 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOTIFY /PARAM=("DATA=AUTOMATIC") /PRIORITY=100 File: _$1$DUA10:[MSMITH]MEMO.TXT;1 File: _$1$DUA10:[MSMITH]FILE_SNIFF.TXT;1 File: _$1$DUA10:[MSMITH]INFOPLAN.TXT;1 File: _$1$DUA10:[MSMITH]MONTHLY_REPORT.TXT;2 File: _$1$DUA10:[MSMITH]SPECIAL_SEPARATION_PAGES.TXT;1 File: _$1$DUA10:[MSMITH]VTPW.TXT;1

The /FULL qualifier displays the status of the print job in the queue. The print job in the example is holding, because it was submitted with the /AFTER qualifier to delay starting the print job. The print job status may be any one of those listed in Table 2-1.

Table 2-1 Print Job Status

Status	Meaning
Printing	On a local printer, the print job is currently printing. On a network printer, the print job may be printing, or a job from another system may be printing.
Pending	The print job is waiting to be printed. Other print jobs are ahead of this job in the queue, or the job is waiting for the appropriate type of media to be mounted in the printer.
Holding	The print job is waiting to print because it was submitted with the /AFTER qualifier or the /HOLD qualifier, or the SET ENTRY/HOLD command was entered for the job. To release the print job for printing, use the /RELEASE qualifier in the SET ENTRY command (see Section 2.4).
Stalled	The job started, but is now stalled, possibly due to a paper jam or tray out of paper.
Aborting	The job has been aborted with a DELETE /ENTRY command. (See Section 2.3 for more information.)
Retained	The print job has completed but it is being retained in the queue.

You can display all your print jobs by entering the SHOW ENTRY command without specifying the print job number. For example:

$ SHOW ENTRY

Entry Jobname Username Blocks Status ----- -------- -------- ------ ------ 96 MEMO MSMITH 114 Holding until 27-JAN-2003 17:00 On busy printer queue LP40$A14 75 AUTO MSMITH 368 Pending On busy printer queue PS40$A10 68 BOOK_LIST MSMITH 78 Printing On busy printer queue PS40$A10

You can use the following qualifiers with the SHOW ENTRY command to display print jobs:

SHOW ENTRY Qualifier	Displays ...
/BRIEF	A short summary about one or more print jobs. This is the default display if you do not include the /FULL qualifier.
/BY_JOB_STATUS=( keyword,...)	Print jobs that have the status you specify for the keyword. The status types are listed in Table 2-1.
/FILES	The file names of the files in each print job displayed.
/FULL	Complete information about the print job, including job status and files to be printed.
/USER_NAME= user-name	The print jobs for the user you specify.

2.2 Displaying Print Queues

You can display a list of all of your print jobs in a queue and the status of the print queue, by using the SHOW QUEUE command.

To see all of your print jobs in a queue, enter the SHOW QUEUE command followed by the name of the print queue:

$ SHOW QUEUE LPS40$A10

Printer queue LPS40$A10, on LEVEL::A10, mounted form DCPS$DEFAULT (stock=DEFAULT) Entry Jobname Username Blocks Status ----- -------- -------- ------ ------ 96 MEMO MSMITH 114 Holding until 27-JAN-2003 17:00

If you wish to see print jobs belonging to all users, and you have sufficient privileges to do so, use the SHOW QUEUE/ALL command.

You can list all the queues in the system by entering the SHOW QUEUE command with no queue name.

You can use the following qualifiers to specify the type of information to display about a queue or queues:

SHOW QUEUE Qualifier	Displays ...
/ALL_JOBS	All the print jobs in a queue. If you do not include this qualifier, the SHOW QUEUE command displays your print jobs in the queue.
/BRIEF	A short summary about one or more print jobs. This is the default display if you do not include the /FULL qualifier.
/BY_JOB_STATUS=( keyword,...)	Print jobs that have the status you specify for the keyword. The status types are listed in Table 2-1.
/FILES	The file names of the files in each print job displayed.
/FORM	Information about the forms that are defined (see Chapter 12).
/FULL	Information about the print job, including job status and files to be printed.
/SUMMARY	A short message about the status of the queue and the print jobs in the queue.

2.3 Deleting a Print Job

You can remove a print job from the queue by using the DELETE/ENTRY command. If the print job is being printed, this command terminates printing and deletes the print job.

If the system manager sets up the queue to retain print jobs, your print job remains in the queue after you use the DELETE/ENTRY command. In this case, use the DELETE/ENTRY command twice to remove the job from the queue.

Include the job number of the print job to be deleted after the DELETE/ENTRY command. For example:

$ DELETE/ENTRY=96

Job MEMO (queue LP40$A10, entry 96) terminated with error status %JBC-F-JOBDELETE, job deleted before execution %DELETE, entry 96 aborting or deleted

2.4 Modifying a Print Job

You can modify a print job that has not started printing. You can change the queue for the print job, or any of the print job attributes that you specified in the PRINT command. You cannot modify a print job that has begun printing.

Use the SET ENTRY command to modify the status, queue, or attributes of a print job. Specify the job number and any qualifiers in the SET ENTRY command. The following example shows how to change the print queue for print job number 318. To specify the new queue, use the SET ENTRY command with the /REQUEUE qualifier.

$ PRINT *.MSG/AFTER=17:00/QUEUE=PS40$A10

Job AUTO (queue PS40$A10, entry 318) holding until 27-JAN-2003 17:00

$ SET ENTRY 318/REQUEUE=LP40$A10 $ SHOW QUEUE LP40$A10

Printer queue LP40$A10, on MOON::A10::, mounted form DCPS$DEFAULT (stock=DEFAULT) Entry Jobname Username Blocks Status ------- -------- -------- ------ ------ 318 AUTO MSMITH 368 Holding until 27-JAN-2003 17:00

Use the SET ENTRY command to release a print job that is Holding. Include the /RELEASE qualifier in the SET ENTRY command to release the print job. For example:

$ SET ENTRY 318/RELEASE

%DCPS-I-JOBSTART, Job AUTO (queue LP40$A10, entry 318) started on LP40$A10

You can change the qualifiers and print parameters for a print job using SET ENTRY. Include the job number and the new qualifier or parameter values in the SET ENTRY command.

If your PRINT command included more than one print parameter, you must include them all in the SET ENTRY command. You cannot modify only one of the print parameters without affecting the others that you included in the PRINT command. If you modify only one parameter, the others are reset to default values. For example, you could submit a print job with the following command:

$ PRINT/PARAMETERS=(SIDES=2,PAGE_ORIENTATION=LANDSCAPE) MYFILE.RPT Job MYFILE (queue PS40$A10, entry 329)

To modify the page orientation setting for this print job, you must include the SIDES parameter, as well:

$ SET ENTRY 329/PARAMETERS=(SIDES=2,PAGE_ORIENTATION=PORTRAIT) $ SHOW ENTRY 329/FULL

Entry Jobname Username Blocks Status ----- -------- -------- ------ ------ 329 MYFILE MSMITH 4 Holding until 27-JAN-2003 17:00 On Printer queue PS40$A10 Submitted 27-JAN-2003 11:50 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOTIFY /PARAMETERS=("SIDES=2","PAGE_ORIENTATION=PORTRAIT") /PRIORITY=100 File: _$1$DUA10:[MSMITH]MYFILE.RPT;2

Some printers have more than one input tray. You can use different trays for various types of media, such as transparencies, envelopes, and paper.

Some printers support special trays, such as manual-feed input slots and envelope feeders. To list the input trays supported by your printer, enter the HELP PRINT_PARAMETER INPUT_TRAY command and select the subtopic that describes your printer.

Use the INPUT_TRAY parameter in the PRINT command to select the input tray from which the media is drawn for the print job.

For example:

$ PRINT /PARAMETERS=INPUT_TRAY=TOP MYFILE.PS

Some printers do not support multiple input trays. If you specify /PARAMETERS=INPUT_TRAY on print jobs for these types of printers, your print job is terminated and the following message is displayed:

NOINPTRAY, INPUT_TRAY selection not supported for printer-name

Selecting the wrong input tray with certain printers terminates the print job. When you specify an input tray that is not supported by the printer, the following error message is displayed:

INTRAYNOTSUP, No tray-name on printer-name

Some printers have optional input trays. If you specify an optional input tray that is not currently available on the printer, the job is terminated and the following error message is displayed:

INTRAYNOTAVL, No tray-name is installed on printer-name

3.1.1 Specifying the Type of Media

Use the INPUT_TRAY parameter to specify an input tray that has the required media loaded in the tray.

You can also specify a paper size with the SHEET_SIZE or PAGE_SIZE parameter.

For example:

$ PRINT /QUEUE=PS40$A14 /PARAMETERS=(SHEET_SIZE=A4,INPUT_TRAY=TOP) FILE.PS

If you specify both the input tray and the paper size, the specified input tray must contain the requested paper size for the job to print, or the print job is terminated and the following error message is displayed:

SIZNOTRAY, paper-size size medium is not in the tray-name tray in printer-name

For example:

SIZNOTRAY, A4 size medium is not in the TOP tray in PS40$A14

3.1.2 Selecting Manual Feed

To select the manual feed slot, use the parameter INPUT_TRAY=MANUAL_FEED. You must also specify the paper size with the SHEET_SIZE or PAGE_SIZE parameter. For example:

$ PRINT /QUEUE=PS40$A14 /PARAMETERS=(SHEET_SIZE=A4,INPUT_TRAY=MANUAL_FEED) FILE.PS

If you omit the page size from a print job that specified manual feed, your print job terminates and the following error message is displayed:

NO_SHEET_SIZE, Sheet_size must be specified for Manual_Feed

When you specify manual feed, job separation pages are printed on the paper that is loaded in the printer's default input tray. Then the input tray is changed to MANUAL_FEED for printing the file.

3.1.3 Using the Envelope Feeder

You must specify the paper size with the SHEET_SIZE or PAGE_SIZE parameter when you specify the ENVELOPE_FEEDER input tray. Otherwise, your print job terminates and the following message is displayed:

NO_SHEET_SIZE, Sheet_size must be specified for Envelope_Feeder

3.2 Selecting the Output Tray

Some PostScript printers have multiple output trays.

You can list the output trays available with your type of printer by entering the HELP PRINT_PARAMETER OUTPUT_TRAY command and selecting the subtopic that describes your printer.

You can select the output tray for print jobs destined for these printers using the OUTPUT_TRAY parameter in the PRINT command.

For example:

$ PRINT /PARAMETERS=OUTPUT_TRAY=SIDE MYFILE.PS

If you select an unsupported output tray, the print job may be printed and sent to another output tray, and the following message displayed:

TRAYSUBST, Output will be delivered to the output-tray tray on printer-name

Alternatively, your print job may be terminated and the following message displayed:

NOOUTTRAY, OUTPUT_TRAY, tray-name, not supported on printer-name

Some printers have optional output trays. If you specify an optional output tray that is not currently available on the printer, your output will be directed to a similar tray if one exists. If there is no similar output tray, the job is terminated and the following error message is displayed:

OUTTRAYNOTAVL, No tray-name is installed on printer-name

3.2.1 Manually Selecting Output Trays

If you manually select the output trays on your printer, you cannot change trays with the OUTPUT_TRAY parameter. You must select the output tray by using the controls on the printer. Refer to the operator's guide to your printer for information about output tray selection.

If you specify the OUTPUT_TRAY parameter for this type of printer, be sure that the appropriate output tray is selected manually. Otherwise, the print job is terminated and the following message may be displayed:

OUTTRAYMISMATCH, Printer printer-name output tray setting does not match requested output-tray on printer-name