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

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

**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 ¹

LN03X--DJ Monospaced Swiss Large SWISS_MCS ¹

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 ¹

CGTIMES14-18_MCS ¹

CGTIMES24_MCS ¹

LNXX--CB CG Triumvirate CGTRIUM8-10-12_MCS ¹

CGTRIUM14-18_MCS ¹

CGTRIUM24_MCS ¹

LNXX--CC ITC Souvenir/Script ITCSOUV_MCS ¹

SCRIPT

LNXX--CD Monospaced BARCODE

LETGOTH

MONO_MCS ¹

OCR

SWISS_MCS ¹

**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 ¹
LN03X--DJ	Monospaced Swiss Large	SWISS_MCS ¹
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 ¹
		CGTIMES14-18_MCS ¹
		CGTIMES24_MCS ¹
LNXX--CB	CG Triumvirate	CGTRIUM8-10-12_MCS ¹
		CGTRIUM14-18_MCS ¹
		CGTRIUM24_MCS ¹
LNXX--CC	ITC Souvenir/Script	ITCSOUV_MCS ¹
		SCRIPT
LNXX--CD	Monospaced	BARCODE
		LETGOTH
		MONO_MCS ¹
		OCR
		SWISS_MCS ¹

¹Use 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

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

Contents

Index

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.

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

hp DECprint Supervisor (DCPS) for hp OpenVMSUser's Guide