Queues one or more files for printing to an output queue.

   Requires OPER (operator) privilege, execute (E)  access to the
   queue, or write (W)  access to the queue.

   Format

     PRINT  filespec[,...]

Additional information available:

PARAMETERQUALIFIERSEXAMPLES

filespec[,...]
   Specifies one or more files to be printed. Wildcard characters (*
   and %) 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.

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

   For complete information on specifying time values, see the VMS
   DCL Concepts Manual.

      /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 following qualifiers that also allow you to select files
   according to time attributes: /CREATED, /EXPIRED, and /MODIFIED.
   If you specify none of these four time qualifiers, the default is
   the /CREATED qualifier.

      /BEFORE[=time]
      /NOBEFORE

   Selects only those files dated prior to 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. 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 VMS
   DCL Concepts Manual.

      /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[=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
   VMS DCL Concepts Manual.

      /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 none, some,
   or all of the characteristics associated with the queue also are
   associated with the job. That is, the job's characteristics must
   be 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
      /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 with 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=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 (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
   following qualifiers that also allow you to select files according
   to time attributes: /BACKUP, /EXPIRED, and /MODIFIED. If you
   specify none of these four time qualifiers, the default is the
   /CREATED qualifier.

      /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 access to the
   current UIC.

      /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=(filespec[,...])
      /NOEXCLUDE

   Excludes the specified files from the print operation.
   You can include a directory but not a device in the file
   specification. Wildcard characters (* and %) 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
      /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 following qualifiers that also allow you to select files
   according to time attributes: /BACKUP, /CREATED, and /MODIFIED. If
   you specify none of these four time qualifiers, the default is the
   /CREATED qualifier.

      /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[=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

   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
      /NOHEADER (default)

   Positional qualifier.

   Controls whether a heading line is printed at the top of each
   page.

      /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 (default)
      /NOIDENTIFY

   Displays the job name, queue name, entry number, and status of the
   job when it is queued.

      /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
      /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
      /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 following qualifiers that also allow you to
   select files according to time attributes: /BACKUP, /CREATED, and
   /EXPIRED. If you specify none of these four time modifiers, the
   default is the /CREATED qualifier.

      /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=string

   Specifies a message string of up to 255 characters to appear on
   the flag page of the job.

      /NOTIFY
      /NONOTIFY (default)

   Controls whether a message is broadcast to your terminal session
   when the job is printed or aborted.

      /OPERATOR=string

   Specifies a message of up to 255 characters to be sent to the
   operator when the job begins to print.

      /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 two consecutive
   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=(parameter[,...])

   Specifies from 1 to 8 optional parameters to be passed to
   the job; each parameter can contain up to 255 characters. If
   you specify only one parameter, you can omit the parentheses.
   Enclose parameters containing lowercase letters, blanks, or other
   nonalphanumeric characters (including spaces) in 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 /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=n

   Requires OPER (operator) or ALTPRI (alter priority) privilege to
   raise the priority above the SYSGEN parameter MAXQUEPRI.

   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 SYSGEN parameter DEFQUEPRI. No privilege is
   needed to set the priority lower than the MAXQUEPRI value.

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

   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 only specify the following qualifiers with /REMOTE:
   /BACKUP, /BEFORE, /BY_OWNER, /CONFIRM, /CREATED, /EXCLUDE,
   /EXPIRED, /MODIFIED, and /SINCE.

   Note that, unlike the printing on the local node, multiple files
   queued by a single PRINT/REMOTE command are considered separate
   jobs.

      /RESTART (default)
      /NORESTART

   Indicates whether a job restarts after a system failure or after a
   STOP/QUEUE/REQUEUE command.

      /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[=time]
      /NOSINCE

   Selects only those files dated after the specified time. You can
   specify time as an absolute time, a combination of absolute and
   delta times, or as one of the following keywords: 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 VMS
   DCL Concepts Manual.

      /SPACE
      /NOSPACE (default)

   Positional qualifier.

   Controls whether print job output is double-spaced. The default is
   single-spaced output.

      /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=username

   Requires the 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.

   1.  $ PRINT/QUEUE=LPB0/COPIES=10/AFTER=20   RESUME
         Job RESUME (queue LPB0, entry 239) holding until 19-APR-1990 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  ALPHA.TXT + BETA/FLAG + GAMMA/FLAG + *.LIS/FLAG
         Job ALPHA (queue SYS$PRINT, entry 237) pending

     The PRINT command in this example submits the files ALPHA.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   ALPHA.TXT/COPIES=2, -
       _$BETA.DOC/COPIES=3
         Job ALPHA (queue SYS$PRINT, entry 240) pending

     The print job queued by the PRINT command in this example
     consists of two copies of ALPHA.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   ALPHA.TXT,BETA/NOIDENTIFY

     The PRINT command in this example concatenates the files
     ALPHA.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 BOSTON::
       $ PRINT/REMOTE BOSTON::REPORT.MEM

     In this example, 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. 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'
         Jobname     Username     Entry     Blocks    Status
         -------     --------     -----     ------    ------
         TEST.TXT    Gibbons        867        135    Printing
                     on printer queue LPA0

     The PRINT command in this 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.