l8HP DECprint Supervisor (DCPS) for OpenVMSG

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

z d f

Contents

Index

@For example, to print FARM.DAT with a job name AG_DATA, use the following command:

"
3 $ PRINT /NAME=AG_DATA FARM.DAT

/NOTE=string

HSpecifies a message string of up to 255 characters to be printed on the job separation pages.

BFor example, to include a distribution location on the separation !pages, use the following command:

"
I $ PRINT /NOTE="Send to second floor, Bin 7" FARM.DAT

/NOTIFY

/NONOTIFY (default)

@Causes you to be notified when the job starts and finishes, and Enotifies you of errors that occur during the printing process and of 3messages returned by PostScript operators (such as Eprint, pstack, =, and ==).

HIf you omit the /NOTIFY qualifier, the default action is not to display these print job messages.

EFor example, to ensure you are notified of print job status, use the following command:

"
8 $ PRINT /NOTIFY FARM.DAT,GROTON.DAT

EIf you use Distributed Queuing Service (DQS) software to queue print Hjobs to a remote printer, /NOTIFY returns job start and finish messages Ethat may or may not represent the actual time of starting and ending Cprinting. DQS suppresses the display of printer error messages and 7other messages from the printer on the user's terminal."

/OPERATOR=string

ESpecifies a message string to be sent to the operator when the print Bjob starts. The message can contain up to 255 characters. Include *quotation marks around the message string.

AFor example, to send the distribution location to the operator's $terminal, use the following command:

"
C $ PRINT /OPERATOR="FARM.DAT TO JONES" FARM.DAT

0

/PAGES=[lowlim,]uplim

JIgnored by the DECprint Supervisor software. Use the PAGE_LIMIT parameter tdescribed in Section 1.7. If you include the /PAGES qualifier in a HPRINT command to a PostScript printer, the qualifier is ignored and the print job is printed.'

/PARAMETERS=parameter

DSpecifies values for the DECprint Supervisor printing features. The Uparameters are listed in Appendix C.

GFor example, to include the SIDES parameter to print on two sides of a !sheet, use the following command:

"
; $ PRINT /PARAMETERS=SIDES=2 GROTON.DAT

/PASSALL

/NOPASSALL (default)

HMaintains the original characteristics of the print job through printer Eprocessing, preventing /HEADER, margin processing, and tab emulation s(described in Chapter 5). The /PASSALL qualifier does not prevent Foperations specified by the system manager with DEFINE/FORM/SETUP. If Dyour print job uses a form definition, the form characteristics for tthat form type prevail. (Refer to Chapter 12 for more information.)

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

"
. $ PRINT /PASSALL FARM.DAT

/PRIORITY=n

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

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

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

#

/QUEUE=queue-name

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

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

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

"
6 $ PRINT /QUEUE=PS$DUPLEX FARM.DAT

/REMOTE

3Initiates a remote print request on another system.

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

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

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

/RESTART

/NORESTART (default)

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

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

/Do not use /RESTART with printer jobs when you:

Request multiple PostScript files that do not reset the PostScript state.F
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.

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

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

/RETAIN=option

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

3Use the following options to specify job retention:
ALWAYS K Holds the job in the queue regardless of the job's completion status.
DEFAULT N Holds the job in the queue as specified by the queue's retention policy.
ERROR J Holds the job in the queue only if the job completes unsuccessfully.
UNTIL= time-value N Holds the job in the queue for the specified length of time, regardless % of the job's completion status.

/SETUP=module

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

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

EFor 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)

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

FUse 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 M Selects files based on the file creation time. (This is the default if / no file selection qualifier is included.)
/EXPIRED 6 Selects files based on the file expiration time.
/MODIFIED A Selects files based on the time the file was last modified.

EFor example, to print only the files named GROTON that were modified .after June 1, 2005, use the following command:

"
B $ PRINT /MODIFIED /SINCE=01-JUN-2005 GROTON.*

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

/SPACE

/NOSPACE (default)

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

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

"
+ $ PRINT/SPACE FARM.DAT

"

/TRAILER=keyword

/NOTRAILER (default)

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

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

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

"
1 $ PRINT/TRAILER=ALL GROTON.*

!

/USER=user-name

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

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

"
1 $ PRINT /USER=JONES FARM.DAT

Appendix C
PRINT Command Parameters

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

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

C.1 PRINT Parameters

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

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

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

X $ & $
Table C-1 PRINT Parameters
Parameter Description Reference
DATA_TYPE < Specifies the data type of the files in the print job. 5 Chapter 1
FONTS_USED H Specifies one or more device control library modules that contain SoftFonts kits. E Section 5.4
INPUT_TRAY ( Specifies which input tray to use. G Section 3.1
LAYUP_DEFINITION N Specifies layup options or a layup definition file to be applied to the print job. A Chapter 11
MEDIA_TYPE @ Specifies the media type on which the job will be printed. F Section 3.1
MESSAGES F Specifies creation of a log file or log page for print messages. ? Appendix A
NUMBER_UP J 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. G Section 3.2
PAGE_LIMIT 7 Specifies the first and last pages to be printed. C Section 1.7
PAGE_ORIENTATION E 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. G Section 10.7
[NO]PUNCH , Specifies whether to punch job output. F Section 15.1
SHEET_COUNT 7 Specifies how many copies of each sheet to print. C Section 1.5
SHEET_SIZE 6 Specifies the sheet size for the printer stock. H Section 10.4
SIDES H Specifies whether to print the job on one or two sides of a sheet. G Section 1.3
STAPLE I Specifies whether to staple the job and where the staple should be positioned. E Section 15.2
[NO]TAB S Selects whether DECprint Supervisor software or the ANSI translator performs tab expansion. F Section 5.3

**Table C-1 PRINT Parameters**
Parameter	Description	Reference
DATA_TYPE	< Specifies the data type of the files in the print job.	5 Chapter 1
FONTS_USED	H Specifies one or more device control library modules that contain SoftFonts kits.	E Section 5.4
INPUT_TRAY	( Specifies which input tray to use.	G Section 3.1
LAYUP_DEFINITION	N Specifies layup options or a layup definition file to be applied to the print job.	A Chapter 11
MEDIA_TYPE	@ Specifies the media type on which the job will be printed.	F Section 3.1
MESSAGES	F Specifies creation of a log file or log page for print messages.	? Appendix A
NUMBER_UP	J 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.	G Section 3.2
PAGE_LIMIT	7 Specifies the first and last pages to be printed.	C Section 1.7
PAGE_ORIENTATION	E 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.	G Section 10.7
[NO]PUNCH	, Specifies whether to punch job output.	F Section 15.1
SHEET_COUNT	7 Specifies how many copies of each sheet to print.	C Section 1.5
SHEET_SIZE	6 Specifies the sheet size for the printer stock.	H Section 10.4
SIDES	H Specifies whether to print the job on one or two sides of a sheet.	G Section 1.3
STAPLE	I Specifies whether to staple the job and where the staple should be positioned.	E Section 15.2
[NO]TAB	S Selects whether DECprint Supervisor software or the ANSI translator performs tab expansion.	F Section 5.3

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

C.2 Syntax for PRINT Parameters

FWhen 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 J enclosed in quotation marks is considered to be a single parameter.) If I you are using Distributed Queuing Service (DQS) software, a maximum of seven parameters is allowed.J
If you specify two or more parameters, separate them by commas and E enclose the list in parentheses. The following examples show valid # syntax for specifying parameters:
"
K $ PRINT /PARAMETERS=DATA_TYPE=REGIS file-name
"
V $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,MESSAGES) file-name
E

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

"
X $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,PAGE_LIMIT="(1,4)",MESSAGES) -* _$ file-name X $ PRINT /PARAMETERS=(DATA_TYPE=REGIS,"PAGE_LIMIT=(1,4)",MESSAGES) -* _$ file-name V $ PRINT /PARAMETERS="DATA_TYPE=REGIS,PAGE_LIMIT=(1,4),MESSAGES" -* _$ file-name

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

C.3 Order of Defaulting for Parameters

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

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

z a d f