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

  Requires  OPER  privilege, EXECUTE (E) access to the queue, or WRITE
  (W) access to the queue.


  Format:


    PRINT  file-spec[,...]

Additional information available:

ParametersCommand QualifiersExamples

 file-spec[,...]

  Specifies  one  or more files to be printed. 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 two or more files, 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. For
  complete information on specifying time  values,  see  the  VMS  DCL
  Concepts Manual. If the specified time has passed, the job is queued
  for printing immediately.

 /BACKUP
 /NOBACKUP

  Modifies the interpretation of the time  value  specified  with  the
  /BEFORE  or /SINCE qualifier. /BACKUP selects files according to the
  dates of their most recent backups. This qualifier  is  incompatible
  with  the  other  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
  /CREATED.

 /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
  /BEFORE 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 two keywords:

  ALL   Prints the flag pages and a burst page before each file in the
  job

  ONE   Prints the flag pages and a burst page 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 /BURST 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  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,  and its
  association  with  a  particular  characteristic  name  is   system-
  specific.  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 a  execution  queue  only  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:

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

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

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

  -  the job is deleted (using, for example, the DELETE/ENTRY command)

 /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. The following responses are valid:

       YES      NO     QUIT

       TRUE     FALSE  <CTRL/Z>

       1        0      ALL

                <RET>

  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 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, DCL issues an error message and redisplays
  the prompt.

 /COPIES=n

 Positional qualifier.

  Specifies  the number of copies to print. The value of 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  /COPIES  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  /SINCE
  qualifier.  /CREATED selects files based on their dates of creation.
  This qualifier is incompatible with the other 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 /CREATED.

 /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=queue-name[:]

  Places the print job in the specified queue (rather than the default
  queue SYS$PRINT). This qualifier is synonymous with  /QUEUE,  except
  that  the  /DEVICE qualifier is reserved for special use by DIGITAL.
  Its usage, therefore, is not recommended.

 /EXCLUDE=(file-spec[,...])
 /NOEXCLUDE

  Excludes the specified files  from  the  print  operation.  You  can
  include  a  directory  but  not  a device in the file specification.
  Wildcard characters are allowed in the file specification.  However,
  you  cannot  use  relative  version  numbers  to  exclude a specific
  version. If you provide only one file specification,  you  can  omit
  the parentheses.

 /EXPIRED
 /NOEXPIRED

  Modifies  the  interpretation  of  the time value specified with the
  /BEFORE or /SINCE qualifier. /EXPIRED  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 other 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 /CREATED.

 /FEED (default)
 /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 two 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
  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. Form definitions are  system-specific.  To  see  which
  forms  are  available  on  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 not, the job remains pending until one  or  more
  of the following occurs:

  -  a different form is mounted on the queue (using, for example, the
     SET QUEUE/FORM_MOUNTED command)

  -  a different form is specified with the job to make the stocks  of
     these  forms  match  (using,  for  example,  the  SET  ENTRY/FORM
     command)

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

  -  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 n can be from 1 through 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
  /LOWERCASE.

 /MODIFIED
 /NOMODIFIED

  Modifies  the  interpretation  of  the time value specified with the
  /BEFORE or /SINCE qualifier. The qualifier /MODIFIED  selects  files
  according  to  the  dates  on  which  they  were last modified. This
  qualifier is incompatible with the other 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 /CREATED.

 /NAME=job-name

  Names  the  job.  The  name  consists  of  1 through 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 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 one to eight optional parameters to be passed to the
  job; each parameter can contain up to  255  characters.  The  commas
  delimit   individual   parameters.   Enclose  parameters  containing
  lowercase  letters,  blanks,  or  other  nonalphanumeric  characters
  (including spaces) in quotation marks (").

  If you specify only one parameter, you can omit the parentheses.

 /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 /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-scheduling priority of the print job. The value of
  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 /DEVICE.

 /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
  /REMOTE, 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
  /SINCE 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  two
  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 privilege and R (READ) and W (WRITE)  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 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
         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.