1 PRINT
Queues one or more files for printing to an output queue.
Requires read (R) access to the file and submit (S) access to the
queue.
To specify functions unique to particular print symbionts, use
the /PARAMETERS qualifier.
For information on parameters available for printing to
PostScript printers using DECprint Supervisor software (DCPS),
see the DCL Help topic PRINT_Parameter.
Format
PRINT filespec[,...]
2 Parameter
filespec[,...]
Specifies one or more files to be printed. The asterisk (*)
and the percent sign (%) wildcard characters are allowed in the
directory specification, file name, file type, and version number
fields. The default file type is that of the preceding file. If
no previous file specification contains an explicit file type,
the default file type is .LIS.
If you specify more than one file, separate the file
specifications with either commas (,) or plus signs (+).
If you specify a node name, you must use the /REMOTE qualifier.
2 Qualifiers
/AFTER
/AFTER=time
/NOAFTER
Holds the job until the specified time. The time can be specified
as absolute time or a combination of absolute and delta times.
If the specified time has passed, the job is queued for printing
immediately.
For complete information on specifying time values, see the
OpenVMS User's Manual or the topic SPECIFY Date_Time in online
help.
/BACKUP
/BACKUP
/NOBACKUP
Modifies the time value specified with the /BEFORE or the
/SINCE qualifier. The /BACKUP qualifier selects files according
to the dates of their most recent backups. This qualifier
is incompatible with the /CREATED, /EXPIRED, and /MODIFIED
qualifiers, which also allow you to select files according
to time attributes. If you specify none of these four time
qualifiers, the default is the /CREATED qualifier.
/BEFORE
/BEFORE[=time]
/NOBEFORE
Selects only those files dated prior to the specified time. You
can specify time as absolute time, as a combination of absolute
and delta times, or as one of the following keywords: BOOT,
LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify one of
the following qualifiers with the /BEFORE qualifier to indicate
the time attribute to be used as the basis for selection:
/BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.
For complete information on specifying time values, see the
OpenVMS User's Manual or the topic SPECIFY Date_Time in online
help.
/BURST
/BURST[=keyword]
/NOBURST
Positional qualifier.
Controls whether two file flag pages with a burst bar between
them are printed preceding a file. If the /BURST qualifier is
specified between the PRINT command and the file specifications,
it can take either of the following keywords:
ALL Prints the flag pages and a burst bar before each file in
the job.
ONE Prints the flag pages and a burst bar before the first
file in the job.
If you want the /BURST qualifier to apply to individual files
in a multifile job, place the qualifier directly after each file
that you want to have the flag pages and a burst bar.
Use the /[NO]BURST qualifier to override the /DEFAULT options
that have been set for the output queue you are using. The
/[NO]BURST qualifier does not override the /SEPARATE options
set for the queue.
When you specify the /BURST qualifier for a file, the /[NO]FLAG
qualifier does not add or subtract a flag page from the two flag
pages that are printed preceding a file.
/BY_OWNER
/BY_OWNER[=uic]
/NOBY_OWNER
Selects only those files whose owner user identification code
(UIC) matches the specified owner UIC. The default UIC is that of
the current process.
Specify the UIC by using standard UIC format as described in the
OpenVMS Guide to System Security.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...])
Specifies the name or number of one or more characteristics to be
associated with the job. Characteristics can refer to such things
as color of ink. If you specify only one characteristic, you can
omit the parentheses.
A characteristic's number must range from 0 to 127. To see which
characteristics have been defined for your system, use the SHOW
QUEUE/CHARACTERISTICS command. To see which characteristics
are associated with a particular queue, use the SHOW QUEUE/FULL
command.
A print job can be processed on an execution queue if the job's
characteristics are a subset of the queue's characteristics.
However, if any of the characteristics associated with the job
are not associated with the queue, the job remains pending until
one or more of the following occurs:
o The characteristics specified with the queue are changed
to make the job's characteristics a subset of the queue's
characteristics (using, for example, the SET QUEUE
/CHARACTERISTICS command).
o The characteristics specified with the job are changed to
make the job's characteristics a subset of the queue's
characteristics (using, for example, the SET ENTRY
/CHARACTERISTICS command).
o The job is moved to a queue on which all the job's
characteristics have been specified (using, for example, the
SET ENTRY/REQUEUE command).
o The job is deleted (using, for example, the DELETE/ENTRY
command).
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each file is queued
for printing to confirm that the operation should be performed on
that file. The following responses are valid:
YES NO QUIT
TRUE FALSE Ctrl/Z
1 0 ALL
<Return>
You can use any combination of uppercase and lowercase letters
for word responses. Word responses can be abbreviated to one or
more letters (for example, T, TR, or TRU for TRUE), but these
abbreviations must be unique. Affirmative answers are YES, TRUE,
and 1. Negative answers include: NO, FALSE, 0, and pressing
the Return key. Entering QUIT or pressing Ctrl/Z indicates that
you want to stop processing the command at that point. When you
respond by entering ALL, the command continues to process, but no
further prompts are given. If you type a response other than one
of those in the list, DCL issues an error message and redisplays
the prompt.
/COPIES
/COPIES=n
Positional qualifier.
Specifies the number of copies to print. The value of the
parameter n can be from 1 to 255 and defaults to 1. If you place
the /COPIES qualifier after the PRINT command name, each file in
the parameter list is printed the specified number of times. If
you specify the /COPIES qualifier following a file specification,
only that file is printed the specified number of times.
/CREATED
/CREATED (default)
/NOCREATED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /CREATED qualifier selects files based on their
dates of creation. This qualifier is incompatible with the
/BACKUP, /EXPIRED, and /MODIFIED qualifiers, which also allow
you to select files according to time attributes. If you specify
none of these four time qualifiers, the default is the /CREATED
qualifier.
/DELETE
/DELETE
/NODELETE (default)
Positional qualifier.
Controls whether files are deleted after printing. If you place
the /DELETE qualifier after the PRINT command name, all specified
files are deleted. If you specify the /DELETE qualifier after
a file specification, only that file is deleted after it is
printed.
The protection applied to the file must allow delete (D) access
for the life of the job. You need to have delete access when you
submit the job and delete access when the system deletes your
file at the end of the job.
/DEVICE
/DEVICE=queue-name[:]
Places the print job in the specified queue (rather than the
default queue SYS$PRINT). This qualifier is synonymous with
the /QUEUE qualifier, except that the /DEVICE qualifier is
reserved for special use by Digital. Its usage, therefore, is
not recommended.
/EXCLUDE
/EXCLUDE=(filespec[,...])
/NOEXCLUDE
Excludes the specified files from the print operation. You can
include a directory but not a device in the file specification.
The asterisk (*) and the percent sign (%) wildcard characters
are allowed in the file specification. However, you cannot use
relative version numbers to exclude a specific version. If you
specify only one file, you can omit the parentheses.
/EXPIRED
/EXPIRED
/NOEXPIRED
Modifies the time value specified with the /BEFORE or the
/SINCE qualifier. The /EXPIRED qualifier selects files according
to their expiration dates. (The expiration date is set with
the SET FILE/EXPIRATION_DATE command.) The /EXPIRED qualifier
is incompatible with the /BACKUP, /CREATED, and /MODIFIED
qualifiers, which also allow you to select files according
to time attributes. If you specify none of these four time
qualifiers, the default is the /CREATED qualifier.
/FEED
/FEED
/NOFEED
Positional qualifier.
Controls whether form feeds are inserted into the print job when
the printer reaches the bottom margin of the form in use. You can
suppress this automatic form feed (without affecting any of the
other carriage control functions that are in place) by using the
/NOFEED qualifier. The /[NO]FEED qualifier does not affect user-
formatted files and can be used to override the installation-
defined defaults that have been set for the output queue you are
using.
/FLAG
/FLAG[=keyword]
/NOFLAG
Positional qualifier.
Controls whether a file flag page is printed preceding a file.
The flag page contains the name of the user submitting the job,
the job entry number, and other information about the file being
printed. If the /FLAG qualifier is positioned between the PRINT
command and the file specifications, it can take either of the
following keywords:
ALL Prints a file flag page before each file in the job.
ONE Prints a file flag page before the first file in the job.
If you want the /FLAG qualifier to apply to individual files in a
multifile job, place the qualifier directly after each file that
you want to have a flag page.
Use the /[NO]FLAG qualifier to override the /DEFAULT=[NO]FLAG
option that has been set for the output queue you are using.
The /[NO]FLAG qualifier does not override the /SEPARATE=[NO]FLAG
option set for the queue.
When you specify the /BURST qualifier for a file, the /[NO]FLAG
qualifier does not add or subtract a flag page from the two flag
pages that are printed preceding the file.
/FORM
/FORM=form
Specifies the name or number of the form to be associated with
the print job. If you omit the /FORM qualifier, the default form
for the execution queue is associated with the job.
Forms have attributes such as print image width and length or
paper stock, which the print symbiont associates with a job when
the job is processed. To see which forms have been defined for
your system, use the SHOW QUEUE/FORM command. To find out which
form is mounted currently on a particular queue and which form is
specified as that queue's default form, use the SHOW QUEUE/FULL
command.
The stock of the form associated with the job must match the
stock of the form mounted on the execution queue on which you
want the job to be processed. If the stocks do not match, the job
remains pending until one or more of the following occurs:
o A form with the same stock as the job's form is mounted on
the queue (using, for example, the SET QUEUE/FORM_MOUNTED
command).
o A form with the same stock as the queue's mounted form is
specified with the job (using, for example, the SET ENTRY/FORM
command).
o The job is moved to a queue on which the stock of the mounted
form matches the stock of the job's form (using, for example,
the SET ENTRY/REQUEUE command).
o The job is deleted (using, for example, the DELETE/ENTRY
command).
/HEADER
/HEADER
/NOHEADER (default)
Positional qualifier.
Controls whether a heading line is printed at the top of each
page.
/HOLD
/HOLD
/NOHOLD (default)
Controls whether a job is available for printing immediately.
The /HOLD qualifier holds the job until released by a SET ENTRY
/RELEASE or SET ENTRY/NOHOLD command.
/IDENTIFY
/IDENTIFY (default)
/NOIDENTIFY
Displays the job name, queue name, entry number, and status of
the job when it is queued.
/JOB_COUNT
/JOB_COUNT=n
Prints the job n times. The value of the parameter n can be from
1 to 255 and defaults to 1.
/LOWERCASE
/LOWERCASE
/NOLOWERCASE (default)
Indicates whether the print job must be printed on a printer that
can print both lowercase and uppercase letters. The /NOLOWERCASE
qualifier means that files can be printed on printers supporting
only uppercase letters. If all available printers can print both
uppercase and lowercase letters, you do not need to specify the
/LOWERCASE qualifier.
/MODIFIED
/MODIFIED
/NOMODIFIED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /MODIFIED qualifier selects files according to
the dates on which they were last modified. This qualifier
is incompatible with the /BACKUP, /CREATED, and /EXPIRED
qualifiers, which also allow you to select files according
to time attributes. If you specify none of these four time
modifiers, the default is the /CREATED qualifier.
/NAME
/NAME=job-name
Names the job. The name consists of 1 to 39 alphanumeric
characters. If characters other than alphanumerics, underscores
(_), or dollar signs ($) are used in the name, enclose the name
in quotation marks (" "). The default is the name of the first
(or only) file in the job. The job name appears in the SHOW ENTRY
and SHOW QUEUE command display and is printed on the flag page
for the job.
/NOTE
/NOTE=string
Specifies a message string of up to 255 characters to appear on
the flag page of the job.
/NOTIFY
/NOTIFY
/NONOTIFY (default)
Controls whether a message is broadcast to your terminal session
when the job is printed or aborted.
/OPERATOR
/OPERATOR=string
Specifies a message of up to 255 characters to be sent to the
operator when the job begins to print.
/PAGES
/PAGES=([lowlim,]uplim)
Positional qualifier.
Specifies the number of pages to print for the specified job. You
can use the /PAGES qualifier to print portions of long files. By
default, all pages of the file are printed.
The lowlim specifier refers to the first page in the group of
pages that you want printed for that file. If you omit the lowlim
specifier, the printing starts on the first page of the file.
The uplim specifier refers to the last page of the file that you
want printed. If you want to print to the end of the file, but
do not know how many pages the file contains, use quotation marks
(" ") as the uplim specifier. You can omit the parentheses if
you are including only a specific value for the uplim specifier.
For example, /PAGES=10 prints the first ten pages of the file;
/PAGES=(5,10) prints pages five through 10; /PAGES=(5,"") starts
printing at page 5 in the file and continues until the end of the
file is reached.
/PARAMETERS
/PARAMETERS=(parameter[(=value[,...])] [,...])
Specifies from 1 to 8 optional parameters that are unique to a
particular print symbiont. Each parameter and its values are
passed as a single text string directly to the print symbiont:
logical names and DCL symbols are not translated by the PRINT
command.
Each parameter can take from 1 to 8 values for a total of 255
characters. If you specify only one parameter or parameter value,
you can omit the parentheses. Enclose parameter values containing
lowercase letters or nonalphanumeric characters (such as spaces,
parentheses, or commas) in quotation marks.
You can specify the /PARAMETERS qualifier only once in each PRINT
command. For example, in the command PRINT /PARAMETERS=(JJJ,KK)
/PARAMETERS=(LL,MMM), the "JJJ" and "KK" are ignored, since the
second occurrence of the /PARAMETERS qualifier supersedes the
first occurrence.
For information on parameters available for printing to
PostScript printers using DECprint Supervisor software (DCPS),
see the DCL Help topic PRINT_Parameter.
/PASSALL
/PASSALL
/NOPASSALL (default)
Positional qualifier.
Specifies whether the symbiont bypasses all formatting and
sends the output QIO to the driver with format suppressed. All
qualifiers affecting formatting, as well as the /HEADER, /PAGES,
and /SETUP qualifiers, are ignored.
If the /PASSALL qualifier is placed between the PRINT command and
any file specifications, all files are printed in PASSALL mode.
To specify the /PASSALL qualifier for only some files in the
job, place the qualifier after each file that you want printed in
PASSALL mode.
/PRIORITY
/PRIORITY=n
Requires OPER (operator) or ALTPRI (alter priority) privilege
to raise the priority above the queue's maximum scheduling
priority.
Specifies the job-scheduling priority of the print job. The value
of the parameter n can be from 0 through 255, where 0 is the
lowest priority and 255 is the highest. The default value of n
is the value of the system parameter DEFQUEPRI. No privilege
is needed to set the priority lower than the queue's maximum
scheduling priority.
/QUEUE
/QUEUE=queue-name[:]
Queues the job to the specified output queue. The default queue
is SYS$PRINT. This qualifier is synonymous with the /DEVICE
qualifier.
/REMOTE
Queues the job to SYS$PRINT on the remote node specified in the
file specification; the file must exist on the remote node. When
you use the /REMOTE qualifier, you must include the node name in
the file specification.
You can specify only the following qualifiers with the /REMOTE
qualifier:
/BACKUP
/BEFORE
/BY_OWNER
/CONFIRM
/CREATED
/EXCLUDE
/EXPIRED
/MODIFIED
/SINCE.
Note that, unlike the printing on the local node, multiple files
queued by a single PRINT/REMOTE command are considered separate
jobs.
/RESTART
/RESTART (default)
/NORESTART
Indicates whether a job restarts after a system failure or after
a STOP/QUEUE/REQUEUE command.
/RETAIN
/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:
o ALWAYS--Holds the job in the queue regardless of the job's
completion status.
o DEFAULT--Holds the job in the queue as specified by the
queue's retention policy.
o ERROR--Holds the job in the queue only if the job completes
unsuccessfully.
o UNTIL=time-value--Holds the job in the queue for the specified
length of time, regardless of the job's completion status.
NOTE
You cannot specify a /NORETAIN qualifier with the PRINT
command (as system managers can with the commands INITIALIZE
/QUEUE, START/QUEUE, and SET QUEUE). However, you can
specify /RETAIN=DEFAULT with the PRINT command. The default
option holds the job in the queue as specified by the
queue's retention policy. If the system manager has not
specified retention for the queue, the job is not retained.
How Job Retention is Determined
Although you can specify job retention options for your own jobs,
the job retention option you specify may be overridden by the job
retention option of the queue on which your job executed. If you
submit or print a job to a generic queue, the generic queue's job
retention setting may also override the job retention option you
specify. This section describes how job retention is determined.
An execution queue's job retention setting takes precedence
over a generic queue's job retention setting. However, if the
job's completion status does not match the job retention setting
(if any) on the execution queue, then the generic queue's job
retention setting attempts to control job retention. If the job's
completion status does not match the job retention setting (if
any) on the generic queue, then the user-specified job retention
setting is used. Jobs submitted directly to execution queues are
not affected by job retention settings on generic queues.
If the execution queue's retention setting applies, the job is
retained on the execution queue. Likewise, if the generic queue's
retention setting applies, the job is retained on the generic
queue. If the user-specified setting applies, the job is retained
in the queue to which it was submitted.
The following example illustrates how the queue manager
determines job retention:
Suppose you submit a job to a generic queue and specify
/RETAIN=ALWAYS, and the job completes successfully.
First, the queue manager compares the job's completion status
to the execution queue's retention setting. Suppose the queue
is set with /RETAIN=ERROR (retains only jobs that complete
unsuccessfully). The job is not retained in the execution queue
because the error condition was not met.
The queue manager then compares the job's completion status to
the generic queue's retention setting. Suppose the generic queue
has no retention setting. The queue manager's comparison again
fails to retain the job.
Finally, the queue manager compares the job's completion
status to the retention setting you specified for the job. This
comparison reveals that the job should be retained. Because the
user-specified setting leads the queue manager to retain the job,
the job is held in the queue to which the job was submitted-in
this case, the generic queue.
For more information on types of queues, see the INITIALIZE/QUEUE
command. For more information on setting retention options for
queues, see the INITIALIZE/QUEUE, START/QUEUE, or SET QUEUE
command.
Timed Retention
Timed retention, which you specify using the UNTIL=time-value
option, allows you to retain a job in the queue only as long as
you need it. This eliminates the need to delete the job from the
queue later.
For example, the following command retains the print job MYFILE
in the queue until 7:31 on December 14, when the job will
automatically be deleted from the queue.
$ PRINT/RETAIN=UNTIL=14-DEC-1994:07:31:0.0 MYFILE.DAT
However, depending on the queue's job retention policy, the
job might be retained indefinitely. The job retention policy
set on the queue takes precedence over the user-specified job
retention setting. Because system managers cannot specify timed
job retention for a queue, any jobs retained as a result of a
queue's setting are retained indefinitely.
If you specify the /RETAIN=UNTIL=time-value option, you must
supply a time value. The time value is first interpreted as
a delta time, then as a combination time, and finally as
absolute time. If you specify a delta time, the delta begins
when the job completes. For example, if you specify PRINT
/RETAIN=UNTIL="+3:00", the job will be retained for three hours
after the job completes. For information on specifying time
values, see the OpenVMS User's Manual.
/SETUP
/SETUP=module[,...]
Extracts the specified modules from the device control library
(containing escape sequence modules for programmable printers)
and copies the modules to the printer before a file is printed.
By default, no device control modules are copied.
Note that the module names are not checked for validity until
the time that the file is actually printed. Therefore, PRINT
/SETUP is susceptible to typing errors and other mistakes. It is
recommended only for experimental setups.
For production setups, see DEFINE/FORM/SETUP.
/SINCE
/SINCE[=time]
/NOSINCE
Selects only those files dated after the specified time. You can
specify time as absolute time, as a combination of absolute and
delta times, or as one of the following keywords: BOOT, LOGIN,
TODAY (default), TOMORROW, or YESTERDAY. Specify one of the
following qualifiers with the /SINCE qualifier to indicate the
time attribute to be used as the basis for selection: /BACKUP,
/CREATED (default), /EXPIRED, or /MODIFIED.
For complete information on specifying time values, see the
OpenVMS User's Manual or the topic SPECIFY Date_Time in online
help.
/SPACE
/SPACE
/NOSPACE (default)
Positional qualifier.
Controls whether print job output is double-spaced. The default
is single-spaced output.
/TRAILER
/TRAILER[=keyword]
/NOTRAILER
Positional qualifier.
Controls whether a file trailer page is printed at the end of
a file. The trailer page displays the job entry number as well
as information about the user submitting the job and the files
being printed. If the /TRAILER qualifier is positioned between
the PRINT command and the file specifications, it can take either
of the following keywords:
ALL Prints a file trailer page after each file in the job.
ONE Prints a file trailer page after the last file in the
job.
If you want the /TRAILER qualifier to apply to individual files
in a multifile job, place the qualifier directly after each file
that you want to have a trailer page.
Use the /[NO]TRAILER qualifier to override the
/DEFAULT=[NO]TRAILER option that has been set for the output
queue you are using. The /[NO]TRAILER qualifier does not override
the /SEPARATE=[NO]TRAILER option set for the queue.
/USER
/USER=username
Requires CMKRNL (change mode to kernel) privilege and read (R)
and write (W) access to the user authorization file (UAF).
Allows you to print a job on behalf of another user. The print
job runs exactly as if that user had submitted it. The print
job runs under that user's user name and user identification
code (UIC), and accounting information is logged to that user's
account. By default, the user identification comes from the
requesting process. The user name qualifier value can be any
user name that is valid on your system. The name must be 1 to 12
alphanumeric characters.
2 Examples
1.$ PRINT/QUEUE=LPB0/COPIES=10/AFTER=20 RESUME
Job RESUME (queue LPB0, entry 239) holding until 14-DEC-1994 20:00
The PRINT command in this example queues 10 copies of the file
RESUME.LIS to printer LPB0, but requests that the copies not be
printed until after 8:00 P.M.
2.$ PRINT THETA.TXT + BETA/FLAG + GAMMA/FLAG + *.LIS/FLAG
Job THETA (queue SYS$PRINT, entry 237) pending
The PRINT command in this example submits the files THETA.TXT,
BETA.TXT, GAMMA.TXT, and the highest versions of all files with
the file type .LIS as a single print job. Flag pages separate
the individual files. Notice that the file type for BETA and
GAMMA is .TXT, the file type of the first file in the list.
3.$ PRINT/LOWERCASE THETA.TXT/COPIES=2, -
_$BETA.DOC/COPIES=3
Job THETA (queue SYS$PRINT, entry 240) pending
The print job queued by the PRINT command in this example
consists of two copies of THETA.TXT followed by three copies
of BETA.DOC. This job must be printed on a printer that can
print lowercase letters. If no such printer is available, the
job waits in the queue.
4.$ PRINT/JOB_COUNT=3 THETA.TXT,BETA/NOIDENTIFY
The PRINT command in this example concatenates the files
THETA.TXT and BETA.TXT into a single print job and prints three
copies of the job. The /NOIDENTIFY qualifier requests that the
job entry number and queue name not be displayed.
5.$ COPY REPORT.MEM NODE3::
$ PRINT/REMOTE NODE3::REPORT.MEM
In this example, the two commands are entered at a node other
than NODE3. The COPY command copies the file REPORT.MEM from
the current node to the NODE3 node. The PRINT command queues
the file REPORT.MEM located on the NODE3 node for printing at
the NODE3 node. The job entry number and queue name are not
displayed when the /REMOTE qualifier is used.
6.$ PRINT/HOLD MASTER.DOC
Job MASTER (queue SYS$PRINT, entry 540) holding
.
.
.
$ SET ENTRY 540/RELEASE
The PRINT command in this example queues a copy of the file
MASTER.DOC to the default printer in a hold status. Later,
the SET ENTRY command releases the hold status on the file and
makes it available for printing.
7.$ PRINT TEST.TXT
Job TEST.TXT (queue SYS$PRINT, entry 867) started on LPA0
$ SHOW ENTRY '$ENTRY'
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
867 TEST.TXT Gibbons 135 Printing
Submitted 10-DEC-1994 11:07 /FORM=DEFAULT /PRIORITY=100
File: $5$DUA174:[GIBBONS]TEST.TXT;3
The PRINT command in this system example queues a copy of the
file TEST.TXT to the default printer. It also creates the local
symbol $ENTRY to store the job entry number. The SHOW ENTRY
command requests a display of the entry using the symbol $ENTRY
to identify it.
8.$ PRINT/RETAIN=UNTIL=1 MYFILE.DAT
.
.
.
$ SHOW QUEUE DOC$LN03
Server queue DOC$LN03, stopped, on NEWTON::, mounted form DEFAULT
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
436 MYFILE HERSHEY 8 Retained until 11-DEC-1994 16:56
%JBC-F-JOBABORT, job aborted during execution
Completed 11-DEC-1994 15:56 on queue DOC$LN03
The SHOW QUEUE display in this system example includes the date
and time at which a retained job completed and the queue on
which it executed. The user set job retention to be one hour
after job completion. Depending on the queue's job retention
policy, the job might be deleted from the queue at 16:56.
9. PRINT /PARAMETERS=AAA=123
This command passes the parameter "AAA=123" to the print
symbiont. The interpretation of the parameter is dependent
on the symbiont.
10$ PRINT /PARAMETERS=(ddd,"e,(F=(3,4),g),h)",iii)
This command passes three parameters, "DDD",
"e,(F=(3,4),g),h)", and "III" to the print symbiont. The use
of the quotes around the second parameter allow the use of
nested parentheses, commas, and the preservation of alphabetic
case. This parameter value is perfectly acceptable to the PRINT
command, even though it is apt to subsequently be rejected by
the print symbiont.
11.PRINT /PARAMETERS=("N,O,P,Q,R,S,T",U,V)
This command passes three parameters, "N,O,P,Q,R,S,T", "U",
and "V", to the print symbiont. Depending on the parsing
capabilities of the symbiont and the length of the parameters
(since each parameter is limited to 255 characters), this may
be a workaround to the limitation of eight parameters.
1 PRINT_Parameter
The PRINT command accepts the /PARAMETERS qualifier to specify functions
unique to printing on PostScript* printers with DECprint Supervisor
software. Certain parameters are available only if the DCPS-PLUS license
has been installed on your system.
Format:
$ PRINT/PARAMETERS=(parameter[,...]) file-spec
If you specify only one parameter, you can omit the parentheses. If you
specify two or more parameters, separate them with commas and enclose the
set in parentheses.
If you specify a parameter that contains special characters or delimiters,
enclose the parameter in double quotation marks (" ").
If the value associated with a parameter contains delimiters, such as
commas or parentheses, enclose the value (or the entire parameter) in
double quotation marks.
The following examples are valid notations:
$ PRINT/PARAMETERS=(PAGE_SIZE=A,SHEET_SIZE=A4) file-spec
$ PRINT/PARAMETERS=(PAGE_LIMIT="(1,4)",MESSAGES="(PRINT,KEEP)") file-spec
* PostScript is a trademark of Adobe Systems Incorporated, which
may be registered in certain jurisdictions.
2 DATA_TYPE
DATA_TYPE=data-type-name
Specifies which translator, if any, the print symbiont invokes.
Data-type-name can be ANSI, ASCII (same as ANSI), AUTOMATIC,
DDIF (bitonal image subset only), PCL*, REGIS, TEK4014, POSTSCRIPT, or
PROPRINTER*. If the data-type-name is POSTSCRIPT, no translator
is invoked.
When the DCPS-PLUS license has not been installed, you can use
only ANSI, ASCII, and PostScript data-type-names. Use of the
other data-type-names requires the installation of the DCPS-PLUS
license.
The REGIS and TEKTRONIX* data-type-names are not available with the
OpenVMS Alpha version of the DECprint Supervisor software.
If the DCPS-PLUS license is installed, and you do not specify
DATA_TYPE, it defaults to AUTOMATIC. With AUTOMATIC, the data
type of the file is determined by the file extension and the
contents of the file. If the DCPS-PLUS license is not installed,
the data type defaults to ANSI.
* PCL is a trademark of Hewlett-Packard Company.
Proprinter is a registered trademark of International Business
Machines Corporation.
Tektronix is a registered trademark of Tektronix, Inc.
3 AUTOMATIC[=initial-data-type]
Specifies the automatic detection of the file's data type. The
initial-data-type specifies the data type at the start of the
file. This is useful if the file contains PostScript data after
ANSI, PCL, or Proprinter data. If the DCPS-PLUS license has been
installed, AUTOMATIC is the default method for printing files.
The default initial-data-type is ANSI.
Use of the AUTOMATIC data-type-name requires that the DCPS-PLUS
license be installed on your system.
3 ANSI
Specifies that the file to be printed is an ANSI file. The file
is translated to PostScript for printing on the PostScript printer.
ANSI refers to the Digital ANSI-Compliant PPL3 printing protocol.
If the DCPS-PLUS license is not installed on your system, your print
file is assumed to be ANSI unless you specify that it is PostScript.
3 DDIF
Specifies that the file to be printed is a DDIF bitonal image file.
DDIF (Digital Document Interchange Format) is used to encode graphic
images. Other types of DDIF-encoded data, including grayscale images,
color images, and text, are ignored. Use of this data-type-name
requires that the DCPS-PLUS license be installed on your system.
3 LIST
Specifies that the file to be printed is a simple ASCII file. The
file is translated to PostScript for printing on the PostScript
printer. The LIST translator numbers each line of text, creates
alternating bars of gray and white in the background, and creates
a running head of the file name and page number. Use of this
data-type-name requires that the DCPS-PLUS license be installed on
your system.
3 PCL
Specifies that the file to be printed is a PCL file; that is, the
file was generated for printing on a printer that supports the
Hewlett-Packard Printing Control Language.
If your print job contains one or more of the following print
parameters, or DCPS does not support your printer in PCL mode, then
the file is translated to PostScript for printing:
/PARAMETERS=LAYUP_DEFINITION
/PARAMETERS=NUMBER_UP
/PARAMETERS=SHEET_COUNT
/PARAMETERS=PAGE_LIMIT
Translation of the PCL file requires that the DCPS-PLUS license
be installed on your system. The translator assumes the file was
generated for printing on the Hewlett-Packard LaserJet* IID printer.
If your print job does not contain any of the previous print
parameters, and DCPS supports your printer in PCL mode, the file
is printed in the printer's PCL mode. This does not require that
the DCPS-PLUS license be installed on your system.
* LaserJet is a trademark of Hewlett-Packard Company.
3 PROPRINTER
Specifies that the file to be printed is a Proprinter file; that
is, the file was generated for printing on an IBM Proprinter
device. The file is translated to PostScript for printing on the
PostScript printer. Specifically, the translator assumes the
file was generated for printing on a Proprinter XL24 printer.
Use of this data-type-name requires that the DCPS-PLUS license
be installed on your system.
3 REGIS
Specifies that the file to be printed is a ReGIS graphics file.
The file is translated to PostScript for printing on the
PostScript printer. Use of this data-type-name requires that the
DCPS-PLUS license be installed on your system.
3 TEKTRONIX
Specifies that the file to be printed was generated for printing
on a TEKTRONIX 4010/4014 device. The file is translated to
PostScript for printing on the PostScript printer. Use of this
data-type-name requires that the DCPS-PLUS license be installed
on your system.
2 FONTS_USED
FONTS_USED=font_module(s)
Allows you to load fonts that emulate LN03 and DEClaser font
cartridges when you are printing ANSI files. Font modules
are available in SoftFont kits, a separate Digital product.
The following command displays a list of font modules
available on your system:
$ LIBRARY/LIST SYS$LIBRARY:CPS$ANSI_FONTS.TLB
2 INPUT_TRAY
INPUT_TRAY=tray-name
Selects the input tray that provides media on which to print
the job.
3 Colormate_PS
You cannot select input trays with the Colormate PS printer.
3 Colorwriter_LSR_2000
You can select input trays with the following values:
MAIN
MULTIPURPOSE
OPTIONAL_CASSETTE*
!
! MANUAL_FEED (same as MULTIPURPOSE)
! NOMANUAL_FEED (same as default input tray)
!
! CASSETTE (synonym for MAIN)
* Only if option is attached
3 DECcolorwriter_1000
You can select input trays with the following values:
TOP (standard input tray)
BOTTOM (optional input tray)
3 DEClaser_Printers
+-------------------------------------------------------------+
| Input tray | 1152 DEClaser |
| Values | 1150 | 2150 | 2250 | 3250 | 5100 | 3500 |
+-------------------------------------------------------------+
| MANUAL_FEED | X | X | X | X | X | X |
| NOMANUAL_FEED | | | | | | |
+-------------------------------------------------------------+
| BOTTOM | | | X | X | | |
+-------------------------------------------------------------+
| TOP | | | X | X | | |
+-------------------------------------------------------------+
| ENVELOPE_FEEDER | | | X* | | X* | |
+-------------------------------------------------------------+
| LCIT | | | | X* | | |
+-------------------------------------------------------------+
| MIDDLE | | | | | | |
+-------------------------------------------------------------+
| MULTIPURPOSE | | | | | X | X |
+-------------------------------------------------------------+
| CASSETTE | | | | | X | X |
+-------------------------------------------------------------+
| OPTIONAL_CASSETTE | | | | | X* | X* |
+-------------------------------------------------------------+
* Only if option is attached
3 Lexmark_Optra_Rt+
You can select input trays with the following values:
MANUAL_FEED
NOMANUAL_FEED
TRAY_1
TRAY_2
TRAY_3*
FEEDER_1*
FEEDER_2*
ENVELOPE_FEEDER*
* Only if option is attached
3 LN_Printers
+-------------------------------------------------------------+
| | LN15 | | | | | |
| Input tray values | LN16 |LN17ps| LN20 | LN32 | LN40 |LNC02 |
+-------------------------------------------------------------+
| MANUAL_FEED | X | | X | X | X | |
| NOMANUAL_FEED | X | | X | X | X | |
+-------------------------------------------------------------+
| FRONT | | X | | | | |
+-------------------------------------------------------------+
| MAIN | | X | | | | |
+-------------------------------------------------------------+
| UPPER / TOP | X | | X | | X | X |
+-------------------------------------------------------------+
| MIDDLE | | | | | X | |
+-------------------------------------------------------------+
| LOWER / BOTTOM | X* | | X* | | X | X* |
+-------------------------------------------------------------+
| LOWER_1 | | X* | | | | |
+-------------------------------------------------------------+
| LOWER_2 | | X* | | | | |
+-------------------------------------------------------------+
| ENVELOPE_FEEDER | | X* | | X* | | |
+-------------------------------------------------------------+
| MULTIPURPOSE | X* | | X | X | | |
+-------------------------------------------------------------+
| LCIT | | | | | X* | |
+-------------------------------------------------------------+
| TRAY_1 | | | | X | | |
+-------------------------------------------------------------+
| TRAY_2 | | | | X | | |
+-------------------------------------------------------------+
| TRAY_3 | | | | X* | | |
+-------------------------------------------------------------+
| TRAY_4 | | | | X* | | |
+-------------------------------------------------------------+
| TRAY_5 | | | | X* | | |
+-------------------------------------------------------------+
* Only if option is attached
3 PrintServer_Printers
+-------------------------------------+
| Input tray | PrintServer |
| Values | 17 | 20 | 32 | 40 |
+-------------------------------------+
| MANUAL_FEED | X* | | | |
| NOMANUAL_FEED | X* | | | |
+-------------------------------------+
| BOTTOM | X | X | X | |
+-------------------------------------+
| TOP | X | X | X | X |
+-------------------------------------+
| ENVELOPE_FEEDER | X | | | |
+-------------------------------------+
| LCIT | X | X | X | X |
+-------------------------------------+
| MIDDLE | | X | X | X |
+-------------------------------------+
* With PrintServer Supporting Host V5.0 or later
3 ScriptPrinter
You cannot select input trays with the ScriptPrinter printer.
3 Hewlett-Packard_Printers
+-------------------+-----------------------+
| | Hewlett-Packard |
| Input tray | | | | |
| Values |5000 |4000 |5SiMX| 5M |
+-------------------------------------------+
| MANUAL_FEED | | | X | X |
| NOMANUAL_FEED | | | | |
+-------------------------------------------+
| ENVELOPE_FEEDER | | X* | X | X |
+-------------------------------------------+
| TRAY_1 | X | X | X | X |
+-------------------------------------------+
| TRAY_2 | X | X | X | X |
+-------------------------------------------+
| TRAY_3 | X | X* | X | X |
+-------------------------------------------+
| TRAY_4 | X | X* | X | |
+-------------------------------------------+
+-------------------+-----------------------------+
| |Hewlett-Packard |
| | | | |4SiMX | |
| Input tray | | | |IIISi*| |
| Values |4MV | 4ML | 4M |IIID**|III**|
+-------------------------------------------------+
| MANUAL_FEED | X | X | X | X | X |
| NOMANUAL_FEED | | | | | |
+-------------------------------------------------+
| BOTTOM | | | | X | |
+-------------------------------------------------+
| TOP | | | | X | X |
+-------------------------------------------------+
| ENVELOPE_FEEDER | | | X | X | |
+-------------------------------------------------+
| MULTIPURPOSE | X | | X | | |
+-------------------------------------------------+
| CASSETTE | X | | X | | |
+-------------------------------------------------+
| OPTIONAL_CASSETTE | X | | X | | |
+-------------------------------------------------+
* Level 2 option from Hewlett-Packard supported.
** Hewlett-Packard III and IIID printers use Hewlett-Packard
cartridges (Level 1 or Level 2).
3 Apple_Printers
+---------------------------------------------------------------+
| | Apple LaserWriter |
| Input tray | | | Plus, | Select |
| Values | 600/630 | IIg/f | IINT/X | 360 |
+---------------------------------------------------------------+
| MANUAL_FEED | X | X | X | X |
| NOMANUAL_FEED | | | | |
+---------------------------------------------------------------+
| BOTTOM | X | | | |
+---------------------------------------------------------------+
| TOP | X | X | X | |
+---------------------------------------------------------------+
| ENVELOPE_FEEDER | X | | | |
+---------------------------------------------------------------+
| MULTIPURPOSE | | | | X |
+---------------------------------------------------------------+
| CASSETTE | | | | X |
+---------------------------------------------------------------+
| OPTIONAL_CASSETTE | | | | X |
+---------------------------------------------------------------+
2 LAYUP_DEFINITION
LAYUP_DEFINITION=layup-definition-filename
LAYUP_DEFINITION="(option;...)"
Specifies layup options or a layup definition file that sets
the layup features. Layup features are borders, sheet margins,
alternating margins, pages per sheet, first page, page order,
and page grid.
Use of this parameter requires that the DCPS-PLUS license be
installed on your system.
Layup definition files are located in DCPS$LAYUP: and have the
file type LUP. Do not specify the file type when you specify
the layup definition file in the command line.
To use a layup option and NUMBER_UP together, you must specify
both on the command line or associate both with a queue.
3 Options
Layup options allow you to specify the number of pages to
print on each sheet of paper, their position on a sheet, the
size of margins, and whether borders are printed. The layup
options and the syntax for specifying values is as follows:
ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM]
[NO]BORDERS
FIRSTPAGE=n
GRID=columns,rows
MARGINS=t,b,l,r
PAGEORDER=
PAGESPERSHEET=n
You can specify layup options in either a layup definition
file, or in-line as part of the PRINT command.
3 In-line
You can specify layup definition options in your command line
by enclosing them in parentheses, and separating them with
semi-colons. You must also enclose the entire layup
definition string in quotes, as follows:
$ PRINT/PARAMETERS=(LAYUP_DEFINITION="(option1;option2;...)")
See the Examples topic for examples of PRINT commands that
include in-line layup options.
3 ALTERNATE
ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM]
Shifts every other page image in preparation for two-sided
printing. Use this option in combination with the MARGINS
option.
Specify one of the words, LEFT, RIGHT, TOP or BOTTOM to
cause the DECprint Supervisor to shift alternate page side
images appropriately. Specifying LEFT or RIGHT alternates
the left and right margins you specify with the MARGINS
option (those margins along the long edge of a sheet of
paper). Specifying TOP or BOTTOM alternates the top and
bottom margins you specify.
If you specify ALTERNATE with no option values, left and
right margins alternate.
3 BORDERS
BORDERS
NOBORDERS
Draws a border around each page.
If you use the NUMBER_UP parameter, the default is to draw
borders around each page spot. Specify NOBORDERS to inhibit
drawing of borders.
The default is to draw page borders whenever the layup
feature is used.
3 FIRSTPAGE
FIRSTPAGE=value
Specifies the first page spot where a page will be printed.
You must specify a value to FIRSTPAGE. The value is the
number of the page spot on which to print the first page.
Page spots are numbered starting at 1.
The FIRSTPAGE option is useful for specifying how to print
pages when you need to preview the layout of pages for
documents with right and left pages. Without the FIRSTPAGE
option, pages are printed at all the page spots. You can
use FIRSTPAGE to print your layout in a way that reflects
proper right and left orientation.
The default is to use the first page spot on a sheet.
3 GRID
GRID=columns,rows
Sets the number of page spots on a sheet in columns and rows.
Specify columns and rows as the numbers of columns and rows
desired on each sheet side.
This option overrides the NUMBER_UP parameter.
3 MARGINS
MARGINS=t,b,l,r
Sets the margins for a sheet, where t is the top margin,
b is the bottom margin, l is the left margin, and r is the
right margin. The numbers are interpreted as printer points,
where there are 72 points to an inch, or 28.35 points per
centimeter. Pages are scaled to fit within the margins.
3 PAGEORDER
PAGEORDER=value
Specifies the order in which pages appear on a sheet.
This can be thought of as the reading order of the pages.
You must supply one of the following values to PAGEORDER:
RightDown Pages ordered left to right, top to bottom
LeftDown Pages ordered right to left, top to bottom
RightUp Pages ordered left to right, bottom to top
LeftUp Pages ordered right to left, bottom to top
DownRight Pages ordered top to bottom, left to right
DownLeft Pages ordered top to bottom, right to left
UpRight Pages ordered bottom to top, left to right
UpLeft Pages ordered bottom to top, right to left
3 PAGESPERSHEET
PAGESPERSHEET=value
Sets the number of pages that will print per sheet, no
matter how many page spots are set by the NUMBER_UP parameter.
The NUMBER_UP parameter or the GRID layup option determines
the maximum number of pages you can print for each sheet.
PAGESPERSHEET determines only the range of page spots to use;
not their layout.
You must supply a value to PAGESPERSHEET, and the value must
be less than the value supplied to the NUMBER_UP parameter
value.
3 Examples
The following PRINT commands illustrate the use of the layup
feature:
$ PRINT/PARAMETERS=(SIDES=2,LAYUP=LPS$DOUBLEHOLES) DOCUMENT.PS
prints DOCUMENT.PS using the DCPS-supplied layup definition file
LPS$DOUBLEHOLES to alternate page side images for edge-binding.
$ PRINT/PARAM=(SIDES=2,NUMBER_UP=2,LAYUP="(NOBORDERS)") MAIL.TXT
prints the file MAIL.TXT as two-sided, two-pages per side, and
with no page borders.
$ PRINT/PARAMETERS=( -
LAYUP="(MARGINS=20,20,60,20;NOBORDERS;ALTERNATE=LEFT)", -
SIDES=2,PAGE_ORIENTATION=LANDSCAPE -
) MONTHLY_REPORT.TXT
prints the file MONTHLY_REPORT.TXT with landscape orientation,
alternating page images across the long-edge margin.
2 MESSAGES
[NO]MESSAGES[=([PRINT][,][KEEP])]
Specifies what happens to job-generated event messages.
MESSAGES or MESSAGES=PRINT specifies that messages are printed on a
job log page. The message file is deleted.
MESSAGES=KEEP specifies that messages are recorded in the
SYS$LOGIN:DCPS$JOB_nnn.LOG file, where "nnn" is the queue entry
number for the job.
NOMESSAGES specifies that messages are not recorded anywhere.
The default is NOMESSAGES.
2 NUMBER_UP
NUMBER_UP=n
NUMBER_UP specifies the maximum number of pages you can print per
side of each sheet of paper. This number of pages will appear on
each printed side unless you specify a different number through
a LAYUP_DEFINITION option. Note that using the LAYUP_DEFINITION
options can affect the actual number of pages printed per side.
(A sheet is a physical piece of paper. A page is an image, which
would usually be printed on one side of a single sheet.)
Use of this parameter requires that the DCPS-PLUS license be
installed on your system.
The value n can be from 0 to 100. If you specify a value of 0,
layup will be disabled. If you specify a value of 1, one page
is printed on a side, reduced, with a border around the page. This
is useful for including space around the printed page for punching
holes or for stapling the print job.
To use NUMBER_UP and a layup definition file together, you must specify
both on the command line or associate both with a queue.
2 OUTPUT_TRAY
OUTPUT_TRAY=tray-name
Selects the output tray where the printer puts the printed output.
If you select a tray-name for a tray that is not available on your
printer, the output is sent to another tray if possible.
3 Colormate_PS
You cannot select output trays with the Colormate PS printer.
3 Colorwriter_LSR_2000
You cannot select output trays with the Colorwriter LSR 2000
printer.
3 DECcolorwriter_1000
You cannot select output trays with the DECcolorwriter 1000
printer.
3 DEClaser_Printers
+---------------------------+
| Output tray | |
| Values | 2150 | 2250 |
+---------------------------+
| FACE_UP | X | X |
+---------------------------+
| LOWER | X | X |
+---------------------------+
| UPPER | X | X |
+---------------------------+
You cannot select output trays with the DEClaser 1150 and 1152
printers, but you can select face-up stacking using the front
panel control settings.
You cannot select output trays with the following printers:
DEClaser 3250
DEClaser 3500
DEClaser 5100
3 Lexmark_Optra_Rt+
You cannot select output trays with the Lexmark Optra Rt+ printer.
3 LN_Printers
+---------------------------------------+
| Output tray | | | |
| Values |LN17ps| LN32 | LN40 |
+---------------------------------------+
| STANDARD / UPPER | X | | X |
+---------------------------------------+
| OCT ** | X* | | |
+---------------------------------------+
| MAILBOX_nn *** | X* | X* | |
+---------------------------------------+
| COLLATOR **** | X* | | |
+---------------------------------------+
| FACE_UP | | X* | X* |
+---------------------------------------+
| FACE_DOWN | | X | X* |
+---------------------------------------+
| BIN_1 | | X* | |
+---------------------------------------+
| BIN_2 | | X* | |
+---------------------------------------+
| BIN_3 | | X* | |
+---------------------------------------+
* Only if option is attached
** OCT stands for "Offset Catch Tray"
*** where "nn" is a value from 1 to 10
**** 1 to 10 collated copies, using SHEET_COUNT
You cannot select output trays with the following printers:
DIGITAL Laser Printer LN15
DIGITAL Laser Printer LN16
DIGITAL Laser Printer LN20
DIGITAL Laser Printer LNC02
3 PrintServer_Printers
+---------------------------------+
| Output tray | PrintServer |
| Values | 17 | 20 | 32 | 40 |
+---------------------------------+
| FACE_UP | X | X | X | X |
+---------------------------------+
| LOWER | | X | X | |
+---------------------------------+
| UPPER | X | X | X | |
+---------------------------------+
| LCOS | X* | | X | X |
+---------------------------------+
| SIDE | | | | X |
+---------------------------------+
| TOP | | | | X |
+---------------------------------+
* Only if option is attached
3 ScriptPrinter
You cannot select output trays with the ScriptPrinter printer.
3 Hewlett-Packard_Printers
+---------------------------------+
| | Hewlett-Packard |
| Output tray | | 4SiMX |
| Values | 5SiMX** | IIISi |
+---------------------------------+
| FACE_UP | X | X |
+---------------------------------+
| TOP | X | X |
+---------------------------------+
| MAILBOX_nn* | X | |
+---------------------------------+
* nn is the mailbox number.
** Mailbox numbers on the HP5SiMX are numbered 1 to 8. When
the printer is in stacker mode or job separator mode,
mailbox 1 is the only valid mailbox since, in these modes,
the printer views the mailboxes as one logical tray.
You cannot select output trays with Hewlett-Packard printers that
are not listed above.
2 PAGE_LIMIT
PAGE_LIMIT="([lower-limit,][upper-limit])"
Specifies the numbers of the first and last pages to print.
Use of this parameter requires that the DCPS-PLUS license be
installed on your system.
Header, trailer, and burst pages are not included in the count.
Limits apply to an entire print job, not to each file in a multifile
job.
If you omit the lower limit, printing starts at the first page of the
job. If you omit the upper limit, printing continues to the end of the
job. You can omit the parentheses if you specify only the upper limit.
The maximum value for upper-limit is 1,000,000. If you include both
the lower limit and the upper limit, you must include quotation
marks around the parentheses.
The default is to print the entire job.
2 PAGE_ORIENTATION
PAGE_ORIENTATION=logical-orientation
Specifies the orientation of printed output on the logical page.
Logical-orientation can be PORTRAIT or LANDSCAPE. If you do not
specify PAGE_ORIENTATION, it defaults to the page orientation
associated with the print queue. If there is no page orientation
associated with the queue, the default is PAGE_ORIENTATION=PORTRAIT.
The layup feature uses the page orientation in determining how to
place the pages on the sheet. If the DATA_TYPE is POSTSCRIPT and
the layup feature is not in use, this parameter is ignored.
2 PAGE_SIZE
PAGE_SIZE=logical-size
This parameter specifies the size of the logical page. Valid values are:
A0 DOUBLEPOSTCARD
A1 EXECUTIVE
A2 FOLIO
A3 LEGAL
A4 LETTER (same as A)
A5 LEDGER (same as B)
B4 HALFLETTER
B5 TWOTHIRDSA4
B6 7_ENVELOPE
C 9_ENVELOPE
D 9X12_ENVELOPE
E 10X13_ENVELOPE
7X9 BUSINESS_ENVELOPE
10X14 C4_ENVELOPE
11X14 C5_ENVELOPE
12X19.5 C6_ENVELOPE
13X19 DL_ENVELOPE
FOOLSCAP SPFOLIO
UKQUARTO
Specifying a PAGE_SIZE value in conjunction with the SHEET_SIZE
value is useful for scaling pages to fit a different size of media
than that for which they were formatted. Use of this scaling feature
requires that the DCPS-PLUS license be installed on your system.
If you do not specify SHEET_SIZE in your PRINT command, the PAGE_SIZE
value is assumed to be the physical sheet size as well. In a print job
where both PAGE_SIZE and SHEET_SIZE are not specified, the DECprint
Supervisor software assumes the size of the media that is loaded into
the default input tray.
2 SHEET_COUNT
SHEET_COUNT=number
Specifies the number of copies of each sheet to print. The printed
output is uncollated, unless the OUTPUT_TRAY value is COLLATOR.
Use of this parameter requires that the DCPS-PLUS license be
installed on your system, unless the OUTPUT_TRAY value is COLLATOR.
The value for number can be 1 through 10,000 for uncollated copies.
For collated copies, the valid values for number are as allowed by
the printer's collator option.
The default is SHEET_COUNT=1.
2 SHEET_SIZE
SHEET_SIZE=physical-size
Specifies the physical size of the sheets being printed.
If you do not specify SHEET_SIZE, it defaults to PAGE_SIZE. If
you also do not specify PAGE_SIZE, SHEET_SIZE defaults to the value
specified for the queue.
3 Colormate_PS
Valid SHEET_SIZE values are LETTER (same as A), and A4.
3 Colorwriter_LSR_2000
Valid SHEET_SIZE values are LETTER (same as A), A4, B5, and LEGAL.
3 DECcolorwriter_1000
Valid SHEET_SIZE values are LETTER (same as A), and A4.
3 DEClaser Printers
+-------------------------------------------------------------+
| Sheet_size | 1152 DEClaser |
| Values | 1150 | 2150 | 2250 | 3250 | 5100 | 3500 |
+-------------------------------------------------------------+
| LETTER, A | X | X | X | X | X | X |
| LEDGER, B | | X | X | | | |
| LEGAL | X | X | X | X | X | X |
| EXECUTIVE | X | X | X | X | X | X |
| 7X9 | X | X | X | X | X | |
| HALFLETTER | X | X | X | X | X | X |
| BUSINESS_ENVELOPE | X | X | X | X | X | X |
| 7_ENVELOPE | X | X | X | X | X | X |
| A5 | X | X | X | X | X | X |
| A4 | X | X | X | X | X | X |
| A3 | | | | | | |
| B6 | | | | | | |
| B5 | X | X | X | X | X | X |
| B4 | | | | X | | |
| TWOTHIRDSA4 | X | X | X | X | X | |
| C5_ENVELOPE | X | X | X | X | X | X |
| DL_ENVELOPE | X | X | X | X | X | X |
| 10X14 | | | | | | |
| FOLIO | | | | | | X |
+-------------------------------------------------------------+
3 Lexmark_Optra_Rt+
Valid SHEET_SIZE values are:
LETTER (same as A) A5
LEGAL A4
EXECUTIVE B5
BUSINESS_ENVELOPE C5_ENVELOPE
7_ENVELOPE DL_ENVELOPE
9_ENVELOPE
3 Lexmark_Optra_S
Valid SHEET_SIZE values are:
LETTER (same as A) A5
LEGAL A4
EXECUTIVE B5
BUSINESS_ENVELOPE C5_ENVELOPE
7_ENVELOPE DL_ENVELOPE
9_ENVELOPE
3 LN_Printers
+-------------------------------------------------------------+
| | LN15 | | | | | |
| Sheet_size values | LN16 |LN17ps| LN20 | LN32 | LN40 |LNC02 |
+-------------------------------------------------------------+
| LETTER, A | X | X | X | X | X | X |
| LEDGER, B | | | X | X | X | |
| LEGAL | X | X | X | X | X | X |
| EXECUTIVE | X | X | X | X | X | X |
| HALFLETTER | | X | X | X | X | X |
| BUSINESS_ENVELOPE | X | X | X | X | | X |
| 7_ENVELOPE | X | X | X | X | | |
| A6 | | X | X | X | | X |
| A5 | X | | X | X | X | X |
| A4 | X | X | X | X | X | X |
| A3 | | | X | X | X | |
| B5 | X | X | X | X | X | X |
| B4 | | | X | X | X | |
| C5_ENVELOPE | X | X | X | X | | |
| C6_ENVELOPE | | X | | | | |
| DL_ENVELOPE | X | X | X | X | | X |
| FOLIO | | X | X | X | | X |
| FOOLSCAP | | | | | | X |
| SPFOLIO | | | | | | X |
| UKQUARTO | | | | | | X |
| 12X19.5 | | | X | | | |
| 13X19 | | | X | | | |
+-------------------------------------------------------------+
3 PrintServer_Printers
+---------------------------------------+
| Sheet_size | PrintServer |
| Values | 20 | 32 | 40 | 17 |
+---------------------------------------+
| LETTER, A | X | X | X | X |
| LEDGER, B | X | X | X | |
| LEGAL | X | X | X | X |
| EXECUTIVE | X | X | X | X |
| 7X9 | | | | X* |
| HALFLETTER | X | X | X | X* |
| BUSINESS_ENVELOPE | | | | X |
| 7_ENVELOPE | | | | X |
| A5 | X | X | X | X* |
| A4 | X | X | X | X |
| A3 | X | X | X | |
| B6 | | | X | X* |
| B5 | X | X | X | X* |
| B4 | X | X | X | |
| TWOTHIRDSA4 | | | | X* |
| C5_ENVELOPE | | | | X* |
| DL_ENVELOPE | | | | X |
| 10X14 | X | X | X | |
+---------------------------------------+
* Supported with PrintServer Supporting Host V5.0 and
MANUAL_FEED input tray specified.
3 Hewlett-Packard_Printers
+-------------------------------------------+
| | Hewlett-Packard |
| Sheet_size | | | | |
| Values |5000 |4000 |5SiMX| 5M |
+-------------------------------------------|
| LETTER, A | X | X | X | X |
| LEDGER, B | X | | X | |
| LEGAL | X | X | X | X |
| EXECUTIVE | X | X | X | X |
| BUSINESS_ENVELOPE | X | X | X | X |
| 7_ENVELOPE | X | X | X | X |
| A3 | X | | X | |
| A4 | X | X | X | X |
| A5 | X | X | | X |
| A6 | X | | | |
| B4 | X | | X | |
| B5 | X | X | X | X |
| B6 | X | | | |
| C5_ENVELOPE | X | X | X | X |
| DL_ENVELOPE | X | X | X | X |
| POSTCARD | X | | | |
| DOUBLEPOSTCARD | X | | X | |
| SUPER_B | | | X | |
+--------------------------------------------
+-------------------------------------------------+
| | Hewlett-Packard |
| Sheet_size | | |4SiMX| | IIID|
| Values | 4MV | 4M |IIISi| 4ML | III |
+-------------------------------------------------+
| LETTER, A | X | X | X | X | X |
| LEDGER, B | X | | | | |
| LEGAL | X | X | X | X | X |
| EXECUTIVE | X | X | X | X | X |
| BUSINESS_ENVELOPE | X | X | X | X | X |
| 7_ENVELOPE | X | X | X | X | X |
| A3 | X | | | | |
| A4 | X | X | X | X | X |
| B4 | X | | | | |
| B5 | X | X | | | |
| C5_ENVELOPE | X | X | | X | X |
| DL_ENVELOPE | X | X | X | X | X |
| POSTCARD | X | | | | |
| DOUBLEPOSTCARD | X | | | | |
| SUPER_B | X | | | | |
+-------------------------------------------------+
3 Apple_Printers
+----------------------------------------------------------------+
| | Apple LaserWriters |
| Sheet_size | | | Plus, | Select |
| Values | 600/630 | IIg/f | IINT/X | 360 |
+----------------------------------------------------------------+
| LETTER, A | X | X | X | X |
| A4 | X | X | X | X |
| LEGAL | X | X | X | X |
| EXECUTIVE | X | X | X | X |
| BUSINESS_ENVELOPE | X | X | X | X |
| 7_ENVELOPE | X | X | X | X |
| B5 | X | X | X | X |
| DL_ENVELOPE | | | | X |
| C5_ENVELOPE | | | | X |
| B5 | | | | X |
| A5 | | | | X |
+----------------------------------------------------------------+
2 SIDES
SIDES=sides-layout-value
Specifies whether your job will print on one or two sides of a sheet,
and whether it will print in tumble mode. Sides-layout-value can be:
1, ONE, or Your job is printed on one side of the sheet.
ONE_SIDED_SIMPLEX
2, TWO, or Your job is printed on both sides of a sheet.
TWO_SIDED_DUPLEX
TUMBLE or Your job is printed on both sides of the sheet,
TWO_SIDED_TUMBLE and alternating pages are rotated 180°.
ONE_SIDED_DUPLEX Your job prints on one side of the sheet.
This setting reflects the placement of
margins.
ONE_SIDED_TUMBLE Your job prints on one side of the sheet.
Alternating pages are rotated 180°. This
setting reflects the placement of margins.
TWO_SIDED_SIMPLEX Your job is printed on both sides of a sheet.
This setting does not reflect the placement of
margins.
The SIDES command is overridden if the file contains an operator that
sets the duplex value.
3 Colormate_PS
Valid SIDES value is ONE_SIDED_SIMPLEX. You cannot select duplex
printing with the Colormate PS printer.
3 Colorwriter_LSR_2000
Valid SIDES value is ONE_SIDED_SIMPLEX. You cannot select duplex
printing with the Colorwriter LSR 2000 printer.
3 DECcolorwriter_1000
Valid SIDES value is ONE_SIDED_SIMPLEX. You cannot select duplex
printing with the DECcolorwriter 1000 printer.
3 DEClaser_Printers
+-------------------------------------------------------------+
| Sides | 1152 DEClaser |
| Values | 1150 | 2150 | 2250 | 3250 | 5100 | 3500 |
+-------------------------------------------------------------+
| 1, ONE, | X | X | X | X | X | X |
| ONE_SIDED_SIMPLEX | | | | | | |
+-------------------------------------------------------------+
| 2, TWO, | | | X | X | | |
| TWO_SIDED_DUPLEX | | | | | | |
+-------------------------------------------------------------+
| TUMBLE, | | | X | X | | |
| TWO_SIDED_TUMBLE | | | | | | |
+-------------------------------------------------------------+
| ONE_SIDED_DUPLEX | X | X | X | X | X | X |
+-------------------------------------------------------------+
| ONE_SIDED_TUMBLE | | | X | X | | |
+-------------------------------------------------------------+
| TWO_SIDED_SIMPLEX | | | X | X | | |
+-------------------------------------------------------------+
3 Lexmark_Optra_Rt+
+-------------------------------------+
| Sides | valid |
| Values | |
+-------------------------------------+
| 1, ONE, ONE_SIDED_SIMPLEX | X |
+-------------------------------------+
| 2, TWO, TWO_SIDED_DUPLEX | X* |
+-------------------------------------+
| TUMBLE, TWO_SIDED_TUMBLE | X* |
+-------------------------------------+
| ONE_SIDED_DUPLEX | X |
+-------------------------------------+
| ONE_SIDED_TUMBLE | |
+-------------------------------------+
| TWO_SIDED_SIMPLEX | X* |
+-------------------------------------+
* Only if printer has the duplex option installed
3 Lexmark_Optra_S
+-------------------------------------+
| Sides | valid |
| Values | |
+-------------------------------------+
| 1, ONE, ONE_SIDED_SIMPLEX | X |
+-------------------------------------+
| 2, TWO, TWO_SIDED_DUPLEX | X* |
+-------------------------------------+
| TUMBLE, TWO_SIDED_TUMBLE | X* |
+-------------------------------------+
| ONE_SIDED_DUPLEX | X |
+-------------------------------------+
| ONE_SIDED_TUMBLE | |
+-------------------------------------+
| TWO_SIDED_SIMPLEX | X* |
+-------------------------------------+
* Only if printer has the duplex option installed
3 LN_Printers
+--------------------------------------------------------------+
| Sides Values | LN15 |LN17ps| LN20 | LN40 |LNC02 |
+--------------------------------------------------------------+
| 1, ONE, ONE_SIDED_SIMPLEX | X | X | X | X | X |
+--------------------------------------------------------------+
| 2, TWO, TWO_SIDED_DUPLEX | X* | X* | X* | X | |
+--------------------------------------------------------------+
| TUMBLE, TWO_SIDED_TUMBLE | X* | X* | X* | X | |
+--------------------------------------------------------------+
| ONE_SIDED_DUPLEX | X | X | X | X | |
+--------------------------------------------------------------+
| ONE_SIDED_TUMBLE | | | | | |
+--------------------------------------------------------------+
| TWO_SIDED_SIMPLEX | X* | X* | X | X | |
+--------------------------------------------------------------+
* Only if printer has the duplex option installed
3 PrintServer_Printers
+-----------------------------------------------+
| Sides | PrintServer |
| Values | 20 | 32 | 40 | 17 |
+-----------------------------------------------+
| 1, ONE, ONE_SIDED_SIMPLEX | X | X | X | X |
+-----------------------------------------------+
| 2, TWO, TWO_SIDED_DUPLEX | X | X | | X* |
+-----------------------------------------------+
| TUMBLE, TWO_SIDED_TUMBLE | X | X | | X* |
+-----------------------------------------------+
| ONE_SIDED_DUPLEX | X | X | X | X |
+-----------------------------------------------+
| ONE_SIDED_TUMBLE | X**| X**| | X**|
+-----------------------------------------------+
| TWO_SIDED_SIMPLEX | X | X | | X* |
+-----------------------------------------------+
* Only if PrintServer 17 has the duplex option installed
** Only if printer is running PostScript Level 1
3 ScriptPrinter
Valid SIDES value is ONE_SIDED_SIMPLEX. You cannot select
duplex printing with the ScriptPrinter printer.
3 Hewlett-Packard_Printers
+-----------------------------------+
| |Hewlett-Packard|
| | | 5SiMX |
| | 4MV | 5M |
| | 4ML | 4SiMX |
| Sides | 4M | IIISi |
| Values | III | IIID |
+-----------------------------------+
| 1, ONE, | X | X |
| ONE_SIDED_SIMPLEX | | |
+-----------------------------------+
| 2, TWO, | | X* |
| TWO_SIDED_DUPLEX | | |
+-----------------------------------+
| TUMBLE, | | X* |
| TWO_SIDED_TUMBLE | | |
+-----------------------------------+
| ONE_SIDED_DUPLEX | X | X |
+-----------------------------------+
| ONE_SIDED_TUMBLE | | |
+-----------------------------------+
| TWO_SIDED_SIMPLEX | | X* |
+-----------------------------------+
* Only if printer has the duplex option installed
2 Examples
$ PRINT/PARAMETERS=DATA_TYPE=PROPRINTER file-spec
The print symbiont calls the PROPRINTER-to-POSTSCRIPT* translator.
When the translator has translated the file to PostScript, the
file is printed.
* Proprinter is a registered trademark of International Business
Machines Corporation.
$ PRINT/PARAMETERS=PAGE_ORIENTATION=LANDSCAPE file-spec
This command prints the job with landscape as the page orientation.
$ PRINT/PARAMETERS=(INPUT_TRAY=MIDDLE,PAGE_ORIENTATION=LANDSCAPE) file-spec
This command prints the job on paper from the middle input tray, with
landscape as the page orientation.
$ PRINT/PARAMETERS=("PAGE_LIMIT=(3,5)",MESSAGES) file-spec
or
$ PRINT/PARAMETERS=(PAGE_LIMIT="(3,5)",MESSAGES) file-spec
These commands print pages 3 through 5 of the job and print any
job-generated event messages on a job log page.
$ PRINT/PARAMETERS=(SIDES=2,DATA=ANSI) file-spec
This command prints an ANSI text file using both sides of the sheet.
(The SIDES command is overridden if the file contains an operator that
sets the duplex value.)
$ PRINT/PARAMETERS=(NUMBER_UP=4) file-spec
This command prints the job four pages to a sheet. The sequence
of pages as printed on the page differs depending on whether the
document is printed in portrait or landscape orientation.
For a portrait-oriented document, For a landscape-oriented document,
the pages are printed on the if PAGE_ORIENTATION=LANDSCAPE is not
sheet in the following order: specified, the pages are printed on
the sheet in the following order:
+---------+---------+
| | | +------------+------------+
| | | | | |
| | | | | |
| | | | | |
| 1 | 2 | | 3 | 1 |
+---------+---------+ +------------+------------+
| | | | | |
| | | | | |
| | | | | |
| | | | 4 | 2 |
| 3 | 4 | +------------+------------+
+---------+---------+
To print landscape pages in the portrait order, include the
PAGE_ORIENTATION=LANDSCAPE parameter in the command line.
$ PRINT/PARAMETERS=(PAGE_SIZE=A,SHEET_SIZE=A4) file-spec
This command prints a file that is designed for A-size paper on
A4-size paper, adjusting the size of the page to fit the paper. The
page image is scaled to the dimensions of the sheet without
affecting the ratio of width to height.
!Parameters that are printer-specific
!2 INPUT_TRAY
!2 OUTPUT_TRAY
!2 SHEET_SIZE
!2 SIDES
!Product names
!3 Colormate_PS
!3 Colorwriter_LSR_2000
!3 DECcolorwriter 1000
!3 DEClaser_1150
!3 DEClaser_2150
!3 DEClaser_3250
!3 DEClaser_2250
!3 DEClaser_5100
!3 DEClaser_3500
!3 LN17ps
!3 PrintServer_20
!3 PrintServer_32
!3 PrintServer_40
!3 PrintServer_17
!3 ScriptPrinter