HELP PRINT — MicroVMS 4.5B
Queues one or more files for printing. Format PRINT file-spec,... Requires the Secure User Environment Option.
Additional information available:
Parameters
file-spec Specification(s) of file(s) to be printed. Wildcard characters are allowed. The plus sign can be used in place of the comma between file specifications. The file type of the first file specified defaults to LIS. The file must not reside on an allocated device. Node names are allowed only when the /REMOTE qualifier is used.
Qualifiers
Additional information available:
/AFTER/BACKUP/BEFORE/BURST/BY_OWNER/CONFIRM
/CHARACTERISTICS/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/SPACE/TRAILER
/USER
/AFTER=time
/NOAFTER Holds the job until the specified time. The time can be specified as an absolute time or a combination of absolute and delta times. If the specified time has passed, the job is queued for printing immediately.
/BACKUP
/NOBACKUP Selects files according to the dates of their most recent backup. Relevant only when used with the /BEFORE or /SINCE qualifier.
/BEFORE[=time]
/NOBEFORE Selects for printing only those files that are dated before the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, or YESTERDAY. Specified with /BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.
/BURST[=keyword]
/NOBURST Positional qualifier. As a command qualifier -- Prints a burst page (a flag page printed over the perforation between pages for easy identification of individual files) according to one of the following keywords. The default is the queue specification established in the INITIALIZE/QUEUE command. +---------+------------------------------------------------+ | ALL | Prints a burst page before each file in the | | | job | +---------+------------------------------------------------+ | ONE | Prints a burst page before the first file in | | | the job | +---------+------------------------------------------------+ As a parameter qualifier -- Prints a burst page (a flag page printed over the perforation between pages for easy identification of individual files) at the beginning of the job. The default is /NOBURST.
/BY_OWNER[=uic]
/NOBY_OWNER Selects one or more files only if their owner user identification code (UIC) matches the specified owner UIC. If the BY_OWNER
/CONFIRM
/NOCONFIRM (default) Issues a request for confirmation before each printing. The following responses are valid: +----------+-----------------------------------------------+ | YES | Print the file | +----------+-----------------------------------------------+ | NO | Do not print the file | +----------+-----------------------------------------------+ | TRUE | Print the file | +----------+-----------------------------------------------+ | FALSE | Do not print the file | +----------+-----------------------------------------------+ | 1 | Print the file | +----------+-----------------------------------------------+ | 0 | Do not print the file | +----------+-----------------------------------------------+ | <RETURN> | Print the file | +----------+-----------------------------------------------+ | ALL | Continue execution of the command with no | | | further confirmation prompts | +----------+-----------------------------------------------+ | <CTRL/Z> | Stop execution of the command | +----------+-----------------------------------------------+ | QUIT | Stop execution of the command | +----------+-----------------------------------------------+
/CHARACTERISTICS=(characteristic,...)
Specifies one or more characteristics for printing the job. Use the SHOW QUEUE/CHARACTERISTICS command to display the available characteristics (defined with the DEFINE/CHARACTERISTIC command) .
/COPIES=n
Positional qualifier. As a command qualifier -- Prints each file n number of times. The value of n can be from 1 to 255 and defaults to 1. As a parameter qualifier -- Prints the file n number of times. The value of n can be from 1 to 255 and defaults to 1.
/CREATED (default)
/NOCREATED Selects files based on their dates of creation. Relevant only when used with the /BEFORE or /SINCE qualifier.
/DELETE
/NODELETE (default) Positional qualifier. As a command qualifier -- Deletes all files after printing them. As a parameter qualifier -- Deletes the file after printing it.
/DEVICE=queue-name[:]
Places the print job in the specified queue (rather than the default queue SYS$PRINT). Synonymous with /QUEUE.
/EXCLUDE=(file-spec,...)
/NOEXCLUDE Excludes any files that match the listed file specification(s) from the PRINT operation. Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/EXPIRED
NOEXPIRED Selects files according to the dates on which they will expire. Relevant only when used with the /BEFORE or /SINCE qualifier.
/FEED (default)
/NOFEED Positional qualifier. Automatically inserts form feeds when pages are within 4 lines of the end of the page (line 62 on 66-line forms). You can reset the number of lines per form with the /FORM qualifier. This qualifier does not affect user-formatted files.
/FLAG[=keyword]
/NOFLAG Positional qualifier. As a command qualifier -- Prints a flag page (containing the job entry number, the name of the user submitting the job, and other information about the file being printed) according to one of the following keywords. +---------+------------------------------------------------+ | ALL | Prints a flag page before each file in the | | | job | +---------+------------------------------------------------+ | ONE | Prints a flag page before the first file in | | | the job | +---------+------------------------------------------------+ As a parameter qualifier -- Prints a flag page (containing the job entry number, the name of the user submitting the job, and other information about the file being printed) at the beginning of the file.
/FORM=type
Specifies a form type for print queues (defined with the DEFINE/FORM command). Type SHOW QUEUE/FORM to display the available print forms. The default is /FORM=0.
/HEADER
/NOHEADER (default) Qualifies file-spec. Prints the name of the file at the top of each page rather than just at the top of the first page of the file.
/HOLD
/NOHOLD (default) Holds the job (until released by a SET QUEUE/ENTRY command).
/IDENTIFY (default)
/NOIDENTIFY Displays the queue name and job number of the job when it is queued.
/JOB_COUNT=n
Prints the job n times. The value of n can be from 1 through 255 and defaults to 1.
/LOWERCASE
/NOLOWERCASE (default) Prints the job only on a printer that supports lowercase characters.
/MODIFIED
/NOMODIFIED Selects files according to the dates on which they were last modified. Relevant only with the /BEFORE or /SINCE qualifier.
/NAME=jobname
Names the job. The name consists of 1 through 39 alphanumeric characters. The default is the name of the first file in the job.
/NOTE=string
Specifies a message string of up to 255 characters to appear on the flag page of the job.
/NOTIFY
/NONOTIFY (default) Broadcasts a message to your terminal when the job is printed.
/OPERATOR=string
Specifies a message of up to 255 characters to be sent to the operator when the job begins to print.
/PAGES=([lower,]upper)
Positional qualifier.
As a command qualifier -- specifies the number of pages to print for
each file. The lower parameter specifies the first page to print; the
default is the first page of the file. The upper parameter specifies
the last page to print; the default is the last page, but you must
include 2 sets of quotation marks ("") if you don't specify the upper
parameter.
As a parameter qualifier -- specifies the number of pages to print for
the specified file. The lower parameter specifies the first page to
print; the default is the first page of the file. The upper parameter
specifies the last page to print; the default is the last page, but
you must include 2 sets of quotation marks ("") if you don't specify
the upper parameter.
/PARAMETERS=(parameter,...)
Specifies from one to eight optional parameters to be passed to the job; each parameter can contain up to 255 characters. Enclose parameters containing any special characters or delimiters with quotation marks.
/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=n
Requires OPER or ALTPRI privilege to raise the priority above the SYSGEN parameter MAXQUEPRI. Specifies the job's priority. The value of n can be from 0 through 255, where 0 is the lowest priority and 255 the highest. The default value of n is the value of the SYSGEN parameter DEFQUEPRI.
/QUEUE=queue-name
Queues the job to the specified print queue. The default is SYS$PRINT. Synonymous with /DEVICE.
/REMOTE
Requires the DECnet Option. Queues the job to SYS$PRINT on the remote node specified in the file specification (the file must exist on the remote node). You cannot specify any other qualifiers with /REMOTE.
/RESTART (default)
/NORESTART Restarts the job after a crash or a STOP/REQUEUE command.
/SETUP=module,...
Extracts the specified module(s) from the device control library (containing escape sequence modules for programmable printers) and copies the module(s) to the printer before a file is printed.
/SPACE
/NOSPACE (default) Positional qualifier. As a command qualifier -- Double spaces the print job (the default is single spacing). As a parameter qualifier -- Double spaces the file (the default is single spacing).
/TRAILER[=keyword]
/NOTRAILER Positional qualifier. As a command qualifier -- Prints a trailer page (containing the job entry number, the name of the user submitting the job, and other information about the file) according to one of the following keywords: +-----+------------------------------------------------------+ | ALL | Prints a trailer page after each file in the job | +-----+------------------------------------------------------+ | ONE | Prints a trailer page after the last file in the job | +-----+------------------------------------------------------+ As a parameter qualifier -- Prints a trailer page (containing the job entry number, the name of the user submitting the job, and other information about the file) at the end of the file.
/USER=user-name
Specifies a user name other than your own as the submitter of the print job.