HP OpenVMS Systems Documentation

HP DECprint Supervisor (DCPS) for OpenVMS
User's Guide

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-JUN-2005 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-JUN-2005 17:00
             On idle printer queue LPS40$A14
             Submitted 27-JUN-2005 10:36 /FORM=DCPS$DEFAULT (stock=DEFAULT)
             /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.

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-JUN-2005 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:

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-JUN-2005 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:

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

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-JUN-2005 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-JUN-2005 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) started on LPS40$A10

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-JUN-2005 17:00
             On printer queue PS40$A10
             Submitted 27-JUN-2005 11:50 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOTIFY
             /PARAM=("SIDES=2","PAGE_ORIENTATION=PORTRAIT") /PRIORITY=100
             File: _$1$DUA10:[MSMITH]MYFILE.RPT;2

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

    $ PRINT /PARAMETERS=INPUT_TRAY=input-tray file-name

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

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

    $ PRINT /PARAMETERS=SHEET_SIZE=sheet-size file-name
    $ PRINT /PARAMETERS=(SHEET_SIZE=sheet-size,INPUT_TRAY=input-tray) -
    _$ file-name

For example:

    $ PRINT /PARAMETERS=SHEET_SIZE=LEGAL FILE.PS
    $ PRINT /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 PrintServer 17/600

Media type is set on the printer to indicate the type of paper loaded in a particular tray. The default is usually PLAIN. Other common media types are COLOR, LETTERHEAD, PREPRINTED, PREPUNCHED and RECYCLED. When a paper tray is set to a particular media type, only jobs requesting that media type will use paper from that tray.

To select media type in your DCPS job, use the MEDIA_TYPE parameter:

    $ PRINT /PARAMETERS=MEDIA_TYPE=media-type file-name

DCPS allows any value for the MEDIA_TYPE parameter. Note that the media type is sometimes abbreviated on a printer's front panel or on its web page. For example, the setting for LETTERHEAD media might be abbreviated as LTRHEAD. In most cases, you can specify either the full or abbreviated name.

You should specify a media type currently used by your printer. If the media type is not available on your printer, you will either:

You can specify a media type with the MEDIA_TYPE parameter. Media type is set on the printer to indicate the type of paper loaded in a particular tray. The default is usually PLAIN. Other common media types are COLOR, LETTERHEAD, PREPRINTED, PREPUNCHED and RECYCLED. When a paper tray is set to a particular media type, only jobs requesting that media type will use paper from that tray if it is different from the printer's default media type.

One benefit of using media type selection is the ability to select paper by paper size and media type without having to know the tray number containing the paper you want to use for your job.

To select paper of a particular media type:

    $ PRINT /PARAMETERS=MEDIA_TYPE=media-type file-name

For example:

    $ PRINT /PARAMETERS=MEDIA_TYPE=COLOR FILE.PS

will select paper from the tray containing colored paper.

DCPS allows any value for the MEDIA_TYPE parameter. Note that the media type is sometimes abbreviated on a printer's front panel or on its web page. For example, the setting for LETTERHEAD media might be abbreviated as LTRHEAD. In most cases, you can specify either the full or abbreviated name.

If the printer does not contain the requested media type, the print job is terminated and the following error message is displayed:

    MEDIATYPENOTAVL, No media-type type medium is loaded in
     printer name

For example,

    MEDIATYPENOTAVL, No COLOR type medium is loaded in HP LaserJet 9050

You can use the MEDIA_TYPE parameter in combination with other tray selection parameters INPUT_TRAY, PAGE_SIZE and SHEET_SIZE.

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

    MEDIATYPENOTRAY, media-type type medium is not in the tray tray in printer name

For example, if there is no letterhead paper in tray 2 and you type

    $ PRINT /PARAMETERS=(INPUT_TRAY=TRAY_2,MEDIA_TYPE=LETTERHEAD) -
    _$ /QUEUE=HP4650 FILE.PS

you will see the following error message displayed:

    MEDIATYPENOTRAY, LETTERHEAD type medium is not in the TRAY_2 tray in
     HP Color LaserJet 4650

Some printers will prompt you to load the requested media type instead of causing the MEDIATYPENOTRAY error message. The behavior depends on the characteristics of the printer. For example, HP printers with Deferred Media Selection turned on will prompt you to load the media type you specified. With most other printers, DCPS will not print the job and will return the error message instead.

Media type selection is supported only by PostScript Level 2 and higher printers. If you specify the media type for a PostScript Level 1 printer, the print job is terminated and the following error message is displayed:

    MEDIATYPENOSUP, Media type selection not supported for PostScript
     Level 1 printers

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.

    $ PRINT /PARAMETERS=(SHEET_SIZE=sheet-size,INPUT_TRAY=input-tray) file-name

For example:

    $ PRINT /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.