HELP PRINT — VMS 5.0
Queues one or more files for printing, either to the default system
printer queue or to a specified queue.
Format:
PRINT file-spec[,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
file-spec[,...] Specifies one or more files to be printed. If you specify two or more files, separate the file specifications with either commas or plus signs. The PRINT command concatenates the files into a single print job and by default, gives the job the name of the first file specified. You can use wildcard characters in the directory specification, file name, file type, or version number fields. Node names are not allowed in the file specification unless the /REMOTE qualifier is specified. If you do not specify a file type for the first input file, the PRINT command uses the default file type LIS.
Command Qualifiers
Additional information available:
/AFTER/BACKUP/BEFORE/BURST/BY_OWNER/CHARACTERISTICS
/CONFIRM/COPIES/CREATED/DELETE/DEVICE/EXCLUDE/EXPIRED
/FEED/FLAG/FORM/HEADER/HOLD/IDENTIFY/JOB_COUNT
/LOWERCASE/MODIFIED/NAME/NOTE/NOTIFY/OPERATOR
/PAGES/PARAMETERS/PASSALL/PRIORITY/QUEUE/REMOTE
/RESTART/SETUP/SINCE/SPACE/TRAILER/USER
/AFTER
/AFTER=time /NOAFTER Requests that the job not be printed until a specific time of day. You can specify either an absolute time or a combination of absolute and delta times. See the VMS DCL Concepts Manual for complete information on specifying time values. If the specified time has already passed, the job is queued for printing immediately.
/BACKUP
/BACKUP /NOBACKUP Selects files according to the dates of their most recent backup. This qualifier is only relevant when used with the /BEFORE or /SINCE qualifier. Use of the /BACKUP qualifier is incompatible with /CREATED, /EXPIRED, and /MODIFIED. The default is /CREATED.
/BEFORE
/BEFORE[=time] /NOBEFORE Selects only those files that are dated before the specified time. You can specify either an absolute time or a combination of absolute and delta times. See the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/BURST
/BURST[=keyword] /NOBURST Positional qualifier. Controls whether a burst page is printed preceding a file. A burst page precedes a flag page and contains the same information. However, it is printed over the perforation between the burst page and the flag page. The printing on the perforation makes it easy to see where individual print jobs or individual files within a single print job begin. When you specify /BURST, you need not specify /FLAG; a flag page automatically follows a burst page. If the /BURST qualifier is positioned between the PRINT command and the file specifications, it can take either of two keywords: ALL or ONE. The ALL keyword indicates that each file in the job will be preceded by a burst page and flag page. The ONE keyword indicates that a burst page will apply only to the first copy of the first file in the job. To have the /BURST qualifier apply to individual files in a multi-file job, place the qualifier directly after each file that you want to have a burst page. Use the /[NO]BURST qualifier to override the installation-defined defaults that have been set for the printer queue you are using.
/BY_OWNER
/BY_OWNER[=uic] /NOBY_OWNER Selects one or more files only if their owner user identification code (UIC) matches the specified owner UIC. Specify the UIC using standard UIC format as described in the VMS DCL Concepts Manual. If the /BY_OWNER qualifier is specified without a UIC, the UIC of the current process is assumed.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) Specifies one or more characteristics desired for printing the files. If you specify only one characteristic, you can omit the parentheses. Characteristics can refer to such things as color of ink. Codes for characteristics can be either names or values from 0 to 127 and are installation-defined. Use the SHOW QUEUE/CHARACTERISTICS command to see which characteristics have been defined for your system. Use the SHOW QUEUE/FULL command to see which characteristics are available on a particular queue. A print job can execute on a printer queue only if each characteristic specified with the PRINT command is also specified for that particular printer queue. If you specify a characteristic that has not been specified for that particular printer queue, the job remains in a pending status. (In order for your job to print, the system manager should stop the queue, physically change the characteristics of the printer, and restart the queue, specifying the new values listed in the /CHARACTERISTICS qualifier.) Specification of a characteristic for a printer queue does not prevent jobs that do not specify that characteristic from being executed.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each individual PRINT
operation to confirm that the operation should be performed on that
file.
When the system issues the prompt, you can issue any of the
following responses:
YES NO QUIT
TRUE FALSE <CTRL/Z>
1 0 ALL
<RET>
You can use any combination of upper- and lowercase letters for word
responses. Word responses can be abbreviated to one or more letters
(for example, T, TR, or TRU for TRUE). Affirmative answers are YES,
TRUE, and 1. Negative answers are NO, FALSE, 0, and <RET>. QUIT or
CTRL/Z indicates that you want to stop processing the command at
that point. When you respond with 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, the prompt will be reissued.
/COPIES
/COPIES=n Positional qualifier. Specifies the number of copies to print. Any number of copies, from 1 through 255, may be specified. By default, the PRINT command prints a single copy of the specified files. 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 /COPIES following a file specification, only that file is printed the specified number of times.
/CREATED
/CREATED (default) /NOCREATED Selects files based on their dates of creation. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /CREATED qualifier is incompatible with /BACKUP, /EXPIRED, and /MODIFIED.
/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 /DELETE after a file specification, only that file is deleted after it is printed. The protection applied to the file must allow delete access to the current UIC.
/DEVICE
/DEVICE=queue-name[:] Synonymous with the /QUEUE qualifier with the following exception: the /DEVICE qualifier is reserved for special use by DIGITAL. Its useage is therefore, not recommended.
/EXCLUDE
/EXCLUDE=(file-spec[,...]) /NOEXCLUDE Any files that match the listed file specifications are excluded from the PRINT operation. If you specify only one file, you can omit the parentheses. The file specification can contain a directory specification, but you cannot include the device in the file specifications you supply with the /EXCLUDE qualifier. Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/EXPIRED
/EXPIRED /NOEXPIRED Selects files according to the dates on which they will expire. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /EXPIRED qualifier is incompatible with /BACKUP, /CREATED, and /MODIFIED. The default is /CREATED.
/FEED
/FEED (default) /NOFEED Positional qualifier. Controls whether the PRINT command automatically inserts form feeds when it nears the end of a page. Use of the /FEED qualifier causes the PRINT command to insert a form feed when the printer reaches the bottom margin of the form. The number of lines per form can be reset by the /FORM qualifier. 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 may be used to override the installation-defined defaults that have been set for the printer queue you are using.
/FLAG
/FLAG[=keyword] /NOFLAG Positional qualifier. Controls whether a 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 two keywords: ALL or ONE. The ALL keyword indicates that each file in the job will be preceded by a flag page. The ONE keyword indicates that a flag page will apply only to the first copy of the first file in the job. To have the /FLAG qualifier apply to individual files in a multi-file job, place the qualifier directly after each file that you want to have a flag page. Use the /[NO]FLAG qualifier to override the installation-defined defaults that have been set for the printer queue you are using.
/FORM
/FORM=type Specifies the name or number of the form that you want for the print job. Specify the form type using a numeric value or alphanumeric name. Form types can refer to the print image width and length or the type of paper. Codes for form types are installation-defined. You can use the SHOW QUEUE/FORM command to find out the form types available for your system. Use the SHOW QUEUE/FULL command to find out the name of the mounted form and the default form for a particular queue. If you specify a form whose stock is different from the stock of the form mounted on the queue, your job is placed in a pending state until the stock of the mounted form of the queue is set equal to the stock of the form associated with the job. (In order to have your job print, the system manager should stop the queue, physically change the paper stock on the output device, and restart the queue specifying the new form type as the mounted form.)
/HEADER
/HEADER /NOHEADER (default) File-spec qualifier. Controls whether a heading line is printed at the top of each output page.
/HOLD
/HOLD /NOHOLD (default) Controls whether the file is available for printing immediately. If you specify /HOLD, the job is not released for processing until you specifically release it with the /NOHOLD or /RELEASE qualifier of the SET QUEUE/ENTRY command.
/IDENTIFY
/IDENTIFY (default) /NOIDENTIFY Controls whether the PRINT command displays a message on the current output device indicating the job number of the print job and the name of the queue in which it is entered whenever a job is successfully queued.
/JOB_COUNT
/JOB_COUNT=n Requests that the entire job be printed n times, where n is a decimal integer from 1 to 255. By default the job is printed once.
/LOWERCASE
/LOWERCASE /NOLOWERCASE (default) Indicates whether the job must be printed on a printer that can print both uppercase and lowercase letters. By default, files can be printed on printers that have only uppercase letters.
/MODIFIED
/MODIFIED /NOMODIFIED Selects files according to the dates on which they were last modified. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /MODIFIED qualifier is incompatible with /BACKUP, /CREATED, and /EXPIRED. The default is /CREATED.
/NAME
/NAME=job-name Defines a name string to identify the job. The name string can have from 1 to 39 characters. The job name is used in the SHOW QUEUE command display and is printed on the flag page for the job. If you do not specify /NAME, the name string defaults to the file name of the first, or only, file in the job.
/NOTE
/NOTE=string Allows you to specify a message to appear on the flag page for the job. The string can contain up to 255 characters.
/NOTIFY
/NOTIFY /NONOTIFY (default) Controls whether a message is broadcast to any terminal at which you are logged in, notifying you when your print job has been completed or aborted.
/OPERATOR
/OPERATOR=string Allows you to specify a message to be sent to the operator. The string can contain up to 255 characters. When the job begins execution, the printer queue pauses and the message is transmitted to the operator.
/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 will start on the first page of the file. The uplim specifier refers to the last page of the file that you want printed. When you want to print to the end of the file, but do not know how many pages that will be, you can use "" 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[,...]) Specifies from one to eight optional parameters to be passed to the job. Each parameter can include up to 255 characters. If you specify only one parameter, you can omit the parentheses. The commas delimit individual parameters. To specify a parameter that contains any special characters or delimiters, enclose the parameter in quotation marks.
/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 /PAGE_SETUP qualifiers, will be ignored. If the /PASSALL qualifier is placed between the PRINT command and any file specifications, all files will be printed in PASSALL mode. To specify /PASSALL with only some files in the job, place the qualifier after each file that you want printed in PASSALL mode.
/PRIORITY
/PRIORITY=n Specifies the priority of the print job. The priority value must be in the range of 0 through 255, where 0 is the lowest priority and 255 is the highest. The default value for /PRIORITY is the value of the SYSGEN parameter DEFQUEPRI. You must have either OPER (operator) or ALTPRI (alter priority) privilege to raise the priority value above the value of the SYSGEN parameter MAXQUEPRI. No privilege is needed to set the priority lower than the MAXQUEPRI value.
/QUEUE
/QUEUE=queue-name[:] Requests that the print job be placed on the specified queue. If no queue is specified, files are queued to SYS$PRINT.
/REMOTE
/REMOTE Indicates that the specified files are to be printed on a remote node. Since the file to be printed must exist on the remote node, the file specification must contain the name of the remote node. If this qualifier is specified, the file is queued for printing in the default queue of the node on which the file exists. Note that, unlike the local case, multiple files queued by a single PRINT/REMOTE command are considered separate jobs. Not all PRINT qualifiers are compatible with /REMOTE. Only the following qualifiers may be specified with /REMOTE: /BACKUP, /BEFORE, /BY_OWNER, /CONFIRM, /CREATED, /EXCLUDE, /EXPIRED, /MODIFIED, and /SINCE.
/RESTART
/RESTART (default) /NORESTART Specifies whether the job can restart after a crash or a STOP/QUEUE/REQUEUE command.
/SETUP
/SETUP=module[,...] Calls for the specified modules to be extracted from the device control library and copied 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, and is recommended only for experimental setups. For production setups, see DEFINE/FORM/SETUP.
/SINCE
/SINCE[=time] /NOSINCE Selects only those files that are dated after the specified time. You can specify either an absolute time or a combination of absolute and delta times. See the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/SPACE
/SPACE /NOSPACE (default) Positional qualifier. Controls whether output is to be double-spaced. The default is /NOSPACE, which results in single-spaced output.
/TRAILER
/TRAILER[=keyword] /NOTRAILER Positional qualifier. Controls whether a 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 two keywords: ALL or ONE. The ALL keyword indicates that each file in the job will be preceded by a trailer page. The ONE keyword indicates that a trailer page will apply only to the last copy of the last file in the job. To have the /TRAILER qualifier apply to individual files in a multi-file job, place the qualifier directly after each file that you want to have a trailer page. Use the /[NO]TRAILER qualifier to override the installation-defined defaults that have been set for the printer queue you are using.
/USER
/USER=username Requires the change mode to kernel (CMKRNL) privilege and read (R) access to the system authorization file. Allows you to submit a print job for another user. The print job will run exactly as if that user had submitted it. The job runs under that user's UIC. Accounting information is logged to that user's account. By default, the user identification comes from the requesting process. The specifier can be any username that is validated on your system.
Examples
1. $ PRINT AVERAGE
Job AVERAGE (queue SYS$PRINT, entry 236) started on LPA0
The PRINT command queues the file AVERAGE.LIS to SYS$PRINT. The
system displays the job name, the queue to which it was submitted,
the job entry number, and the status. The job is already executing
on the queue LPA0.
2. $ PRINT ALPHA.TXT + BETA/FLAG + GAMMA/FLAG
Job ALPHA (queue SYS$PRINT, entry 237) pending
The PRINT command submits the files ALPHA.TXT, BETA.TXT, and
GAMMA.TXT 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/REMOTE BOSTON::WORK$:[SMITH.MEMO]JUNE10.MEM
Job JUNE10 (queue SYS$PRINT, entry 476) started on LPA0
The PRINT command, which is entered on a node other than BOSTON,
queues the file JUNE10.MEM that resides on the BOSTON node. The
file is entered on the printer queue at node BOSTON.
4. $ COPY REPORT.MEM BOSTON::
$ PRINT/REMOTE BOSTON::REPORT.MEM
Job REPORT (queue SYS$PRINT, entry 342) started on LPA0
The two commands are entered at a node other than BOSTON. The COPY
command copies the file REPORT.MEM from the current node to the
BOSTON node. The PRINT command queues the file REPORT.MEM located
on the BOSTON node for printing at the BOSTON node.