# hp DECprint Supervisor (DCPS) for hp OpenVMS
User's Guide

Previous | Contents | Index

For example, to print the FARM.DAT file without the special processing described above, use the following command:

    $ PRINT/PASSALL FARM.DAT

### /PRIORITY=n

Specifies a priority number to be assigned to the print job. You can use this qualifier to ensure that print jobs are printed in a specific order. The value of n is 0--255. To set this priority higher than the system value of MAXQUEPRI, you must have operator (OPER) privileges.

For example, to print FARM.DAT with a lower priority than GROTON.DAT, and ensure that GROTON is printed first, enter two PRINT commands, as shown:

    $ PRINT/PRIORITY=1 FARM.DAT
    $ PRINT/PRIORITY=2 GROTON.DAT

### /QUEUE=queue-name

Specifies a print queue for printing the job. You supply the name of the execution queue or generic queue for queue-name. If you omit this qualifier, the print job is placed in the SYS$PRINT default queue, defined by the system manager.

To list the print queues at your site, use the SHOW QUEUE command, as described in Section 2.2.

For example, to print FARM.DAT on the printer for queue PS$DUPLEX, use the following command:

    $ PRINT/QUEUE=PS$DUPLEX FARM.DAT

### /REMOTE

Initiates a remote print request on another system.

When you include this qualifier, the file to be printed must exist on the remote node. You must include the host node name in the file specification portion of your print request. The file is queued on the default print queue (SYS$PRINT) of the other system and takes the printer characteristics defined for that system. The /QUEUE and /PARAMETERS qualifiers are ignored when you use the /REMOTE qualifier.

For example, to print GROTON.DAT on a printer on node AGRO::, use the following command:

    $ PRINT/REMOTE AGRO::[MACDONALD]GROTON.DAT

### /RESTART

### /NORESTART (default)

Requests that the print job be automatically restarted if the printer jams or stops.

A print job with multiple files or copies that depends on passing the PostScript parameters from one file to the next may not be restarted successfully. (See Section 1.5.)

Do not use /RESTART with printer jobs when you:

- Request multiple PostScript files that do not reset the PostScript state.
- Print multiple copies of PostScript files that do not reset the PostScript state.
- Specify one of the following parameters:
  - /PARAMETERS=LAYUP_DEFINITION
  - /PARAMETERS=NUMBER_UP
  Refer to Chapter 11 and Section 1.6, respectively, for information about these parameters on restarted print jobs.

For example, to ensure that the print job for FARM.DAT in print queue ANSI$PSPRINT will be restarted, use the following command:

    $ PRINT/RESTART/QUEUE=ANSI$PSPRINT FARM.DAT

### /RETAIN=option

Specifies the circumstances under which you want your jobs to be retained in a queue. When a job is retained in the queue, you can issue the SHOW QUEUE command after the job completes to see the status of the job. Without job retention, no record of a job is left in a queue after a job completes.

Use the following options to specify job retention:

ALWAYS | Holds the job in the queue regardless of the job's completion status.
DEFAULT | Holds the job in the queue as specified by the queue's retention policy.
ERROR | Holds the job in the queue only if the job completes unsuccessfully.
UNTIL= time-value | Holds the job in the queue for the specified length of time, regardless of the job's completion status.

### /SETUP=module

Includes the specified setup module (from the queue's device control libraries) with the print job. The system manager can add and modify setup modules in device control libraries.

You supply one or more setup module names from the queue's device control libraries. To include more than one module name, separate the module names with commas and enclose the set in parentheses.

For example, to include the PostScript modules 4UP_GRID and 4UP_WIDE with the print job for FARM.RPT, use the following command:

    $ PRINT/SETUP=(4UP_GRID,4UP_WIDE) FARM.RPT

### /SINCE=time

### /NOSINCE (default)

Prints files dated after the specified time, selecting files dated after the specified date and time. You can include a keyword instead of the time, including TODAY, TOMORROW, and YESTERDAY.

Use this qualifier with one of the following qualifiers to change the file selection mode:

/BACKUP | Selects files based on the time they were last backed up.
/CREATED | Selects files based on the file creation time. (This is the default if no file selection qualifier is included.)
/EXPIRED | Selects files based on the file expiration time.
/MODIFIED | Selects files based on the time the file was last modified.

For example, to print only the files named GROTON that were modified after January 1, 2003, use the following command:

    $ PRINT/MODIFIED/SINCE=01-JAN-2003 GROTON.*

If you omit the /SINCE qualifier, the specified files are printed regardless of file creation, backup, modification, or expiration times.

### /SPACE

### /NOSPACE (default)

Requests printouts with single-spacing or double-spacing (one blank line between each text line). Use /SPACE for double-spaced output. Use /NOSPACE for single-spaced output.

For example, to print FARM.DAT with double-spaced lines, use the following command:

    $ PRINT/SPACE FARM.DAT

### /TRAILER=keyword

### /NOTRAILER (default)

Specifies whether to print file trailer pages at the end of each file. Include this qualifier between the PRINT command and the file specification. You can supply the keyword ALL to specify trailer pages after each file, or ONE to specify a trailer page only after the last file in the print job. If you omit this qualifier, the default action of the print queue is used.

This qualifier does not affect the output of the job trailer page. Refer to the System Manager's GuideSystem Manager's Guide for more information about the job separation pages.

For example, to include a trailer page for all the files in the print job GROTON, use the following command:

    $ PRINT/TRAILER=ALL GROTON.*

### /USER=user-name

Allows you to print a job for another user. You must have the CMKRNL privilege and R (read) access to the file to print a job for another user. When you omit this qualifier, the default action is to print files with your user name.

For example, to print the file named FARM.DAT for user JONES, enter the following command:

    $ PRINT/USER=JONES FARM.DAT

# Appendix C
PRINT Command Parameters

The PRINT command accepts the /PARAMETERS qualifier to specify functions unique to the DECprint Supervisor software. Refer to Appendix B for more information about the PRINT command.

This appendix lists the PRINT command parameters that are used for specifying functions of the DECprint Supervisor software. See Table C-1 for a list of the parameters.

# C.1 PRINT Parameters

Parameters consist of keywords and associated values. Use the `PRINT /PARAMETERS` command to include these parameters in your print job. The /PARAMETERS qualifier is a command qualifier, so all the files in the print job are subject to the parameters used in the /PARAMETERS qualifier.

Default PRINT parameters can also be associated with a queue by the system manager. See the System Manager's GuideSystem Manager's Guide for information about associating parameters with specific print queues.

The PRINT command parameters for the DECprint Supervisor are listed in Table C-1 and are described in more detail in the sections listed in the table.

Table C-1 PRINT Parameters
Parameter | Description | Reference
--- | --- | ---
DATA_TYPE | Specifies the data type of the files in the print job. | Chapter 1
FONTS_USED | Specifies one or more device control library modules that contain SoftFonts kits. | Section 5.4
INPUT_TRAY | Specifies which input tray to use. | Section 3.1
LAYUP_DEFINITION | Specifies layup options or a layup definition file to be applied to the print job. | Chapter 11
MESSAGES | Specifies creation of a log file or log page for print messages. | Appendix A
NUMBER_UP | Specifies the number of pages to be printed on each side of a sheet. | Section 1.6
OUTPUT_TRAY | Specifies the output tray to which the job will be sent. | Section 3.2
PAGE_LIMIT | Specifies the first and last pages to be printed. | Section 1.7
PAGE_ORIENTATION | Specifies the orientation to print data on the paper: portrait (vertically) or landscape (horizontally). | Section 1.4
PAGE_SIZE | Specifies the size of the logical page. | Section 10.7
[NO]PUNCH | Specifies whether to punch job output. | Section 15.1
SHEET_COUNT | Specifies how many copies of each sheet to print. | Section 1.5
SHEET_SIZE | Specifies the sheet size for the printer stock. | Section 10.4
SIDES | Specifies whether to print the job on one or two sides of a sheet. | Section 1.3
STAPLE | Specifies whether to staple the job and where the staple should be positioned. | Section 15.2
[NO]TAB | Selects whether DECprint Supervisor software or the ANSI translator performs tab expansion. | Section 5.3

Using parameters other than those listed in Table C-1 results in a command syntax failure, as described in Appendix A.

# C.2 Syntax for PRINT Parameters

When you specify the PRINT command with the /PARAMETERS qualifier, be sure to follow these syntactic conventions:

- A maximum of eight parameters is allowed. (A series of parameters enclosed in quotation marks is considered to be a single parameter.) If you are using Distributed Queuing Service (DQS) software, a maximum of seven parameters is allowed.
- If you specify two or more parameters, separate them by commas and enclose the list in parentheses. The following examples show valid syntax for specifying parameters:

      $ PRINT /PARAMETERS=DATA_TYPE=REGIS file-spec

      $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,MESSAGES) file-spec

- If the value associated with a parameter contains any special characters, such as commas or parentheses, enclose the value (or the entire parameter) in quotation marks.
  The following examples show valid syntax for specifying multiple values to a print parameter:

      $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,PAGE_LIMIT="(1,4)",MESSAGES) file-spec

      $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,"PAGE_LIMIT=(1,4)",MESSAGES) file-spec

      $ PRINT /PARAMETERS="DATA_TYPE=REGIS,PAGE_LIMIT=(1,4),MESSAGES" file-spec

The DECprint Supervisor software checks for syntax and value limits at the time the file is printed, not when the PRINT command is first entered. If a print job contains an error in the parameters, it is aborted and an error message is displayed on your terminal if you included the /NOTIFY qualifier in the PRINT command.

# C.3 Order of Defaulting for Parameters

Print parameters can be specified in the PRINT command or as default queue parameters in the printer startup file. If a parameter is not specified, the standard printer default value is used. The value for a parameter specified in a PRINT command takes precedence over the value of the default queue parameter.

The default queue parameter for a generic queue supersedes the default queue parameter defined for the execution queue. However, if there is a syntax error in the generic queue definition, the default queue parameter for the execution queue is used. Refer to the System Manager's GuideSystem Manager's Guide for information about setting up default queue parameters.

# Appendix D
SoftFont Kits for Emulating Font Cartridges

Table D-1 lists the font cartridges for LN03 and DEClaser printers for printing ANSI files. You can print these ANSI files on PostScript printers using the DECprint Supervisor software and the appropriate SoftFont kits, as described in Table D-1. See Section 5.2 for more information about printing ANSI files. Use the following module names with the /PARAMETERS=FONTS_USED qualifier. See Table D-2 for a list of SoftFont kits and the modules they contain.

Table D-1 Font Cartridge Equivalents
Cartridge Order Number | Cartridge Name | SoftFont Module Name
--- | --- | ---
LN03 Font Cartridges
LN03X--CB | CG Times | CGTIMES8-10-12_MCS
LN03X--CW | CG Times Presentation | CGTIMES14-18_MCS
LN03X--CX | CG Times Large | CGTIMES24_MCS
LN03X--CY | CG Triumvirate | CGTRIUM8-10-12_MCS
LN03X--CJ | CG Triumvirate Presentation | CGTRIUM14-18_MCS
LN03X--CZ | CG Triumvirate Large | CGTRIUM24_MCS
LN03X--CL | ITC Souvenir | ITCSOUV_MCS
LN03X--CP | English 116 Embassy | SCRIPT
LN03X--DH | Monospaced Swiss Presentation | SWISS_MCS 1
LN03X--DJ | Monospaced Swiss Large | SWISS_MCS 1
LN03X--CS | Letter Gothic | LETGOTH
LN03X--CM | OCR A/OCR B | OCR
LN03X--DE | Barcode 3 of 9 | BARCODE
LN03X--CT | US Legal | MONO_MCS
DEClaser 2100/2200 Font Cartridges
LNXX--CA | CG Times | CGTIMES8-10-12_MCS 1
|  | CGTIMES14-18_MCS 1
|  | CGTIMES24_MCS 1
LNXX--CB | CG Triumvirate | CGTRIUM8-10-12_MCS 1
|  | CGTRIUM14-18_MCS 1
|  | CGTRIUM24_MCS 1
LNXX--CC | ITC Souvenir/Script | ITCSOUV_MCS 1
|  | SCRIPT
LNXX--CD | Monospaced | BARCODE
|  | LETGOTH
|  | MONO_MCS 1
|  | OCR
|  | SWISS_MCS 1

1Use the _ISO1 suffix instead of _MCS if your document uses the ISO Latin-1 character set.

Table D-2 SoftFont Kits
SoftFont Order Number | Fonts | Modules
--- | --- | ---
LNSFT--AX | CG Times 8, 10, 12 | CGTIMES8-10-12
| CG Times 14, 18 | CGTIMES14-18
| CG Times 24 | CGTIMES24
LNSFT--BX | CG Triumvirate 8, 10, 12 | CGTRIUM8-10-12
| CG Triumvirate 14, 18 | CGTRIUM14-18
| CG Triumvirate 24 | CGTRIUM24
LNSFT--CX | English Embassy 14, 18 | SCRIPT
| ITC Souvenir 8, 10, 12 | ITCSOUV
LNSFT--DX | Barcode 3 of 9, 18, 36 | BARCODE
| Letter Gothic 10, 14 | LETGOTH
| Mono Swiss 14, 18 | SWISS
| Mono Swiss, 24 | SWISS
| OCR-A, OCR-B 10 | OCR
| US Legal | MONO_MCS

Note The SoftFont kits have been retired and are no longer sold. The information above is included for reference only.

Previous | Next | Contents | Index