1 PRT V4.3
  Copies one or more files to  a  temporary  output  file  with  a  file
  extension  .PRT  and  places  that  file  in  print queue. Designed to
  replace the VMS PRINT command, PRT offers several advantages.   First,
  PRINT  simply  places  the  names  of files to be printed in a printer
  queue, so files printed with  PRINT  cannot  be  deleted  or  modified
  without  aborting  the  execution of the print job.  PRT, on the other
  hand, prints from a temporary file created on the user's  account,  so
  the user is free to make changes to the file immediately after issuing
  the PRT command.

  PRT  also  makes  minor formatting changes to the file before printing
  begins.  The insertion of line numbers for program source code and the
  powerful facility for specifying page headers and footers are the most
  common benefits of PRT.

  Format:

    PRT[/Qualifier]* file-spec[/Qualifier]* [,file-spec[/Qualifier]*]* 

2 Parameters

 file-spec [,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 PRT  command concatenates the  files  into a single  print
  job.

  You  can  use wildcard characters in the directory specification, file
  name, file extension, or version number fields.  Node  names  are  not
  allowed in the file specification.

  If you do not specify a file type for any input file, the PRT  command
  uses  the  default  file  type  LIS.   If you do not specify a version
  number, then PRT prints the latest version of the file.

  Certain files with system standard file  extensions  (i.e.  '.EXE'  or
  '.OBJ')  which are considered non-text files will not print using PRT.
  Any reference to these files will be excluded from the final output.

2 Command_Qualifiers

  PRT contains all of the command qualifiers present in VMS PRINT except
  /BACKUP,  /BEFORE,  /BY_OWNER,  /CHARACTERISTICS,  /CREATED,  /DEVICE,
  /EXPIRED,   /MODIFIED,  /OPERATOR,  /PARAMETERS,  /PRIORITY,  /REMOTE,
  /SINCE, and /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 Section 2.5 of the VAX/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.

/CONFIRM

 /CONFIRM
 /NOCONFIRM (default)

  Controls whether a request is  issued  before  each  individual  PRT
  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:

   AFFIRMATIVE       NEGATIVE    STOP PROCESSING     CONTINUE W/O PROMPT
       YES              NO            QUIT                    ALL
       TRUE            FALSE        <CTRL> Z
       1                0     
                       <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).  If you type a response other
  than one of those in the list, the prompt will be reissued.

/FORM

 /FORM=form-name 

  Specifies  the  name of the form that you want for the print job. Form
  numbers are not supported with PRT.

  Specify the form type using an alphanumeric name.  Form types refer to
  the print image width, length, margins, and the type of  paper  stock.
  Codes  for  form types are installation-defined.  You can use the SHOW
  QUEUE/FORM/FULL 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 paper stock is different  from  the  paper
  stock  of  the  form  mounted  on  the  queue, your job is placed in a
  pending state until the  requested  paper  stock  is  mounted  on  the
  printer.   (In  order  to have your job print, the system manager will
  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.)

  At  the current time, special forms requiring a paper stock other than
  DEFAULT  must  be  queued  to  VM$PRINT.  See  /QUEUE  for  additional
  information.

/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. See /AFTER for related information.

/IDENTIFY

 /IDENTIFY (default)
 /NOIDENTIFY

  Controls  whether  the  PRT  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. See /NOTIFY for related information.

/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.   See  /COPIES  for  related
  information.

/LOG

 /LOG (default)
 /NOLOG

  Controls  the  display  of  status  messages  to  the  terminal during
  execution.  When enabled, PRT will notify the user of each file  being
  processed.

/LOWERCASE

 /LOWERCASE (default)
 /NOLOWERCASE 

  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 with either upper- or
  lowercase letters.

/NAME

 /NAME="banner-string"

  Defines a banner string for easy identification of the printed output.
  The  banner  string  can  have from 1 to 39 characters.  The banner is
  used in the SHOW QUEUE command display and is printed on the flag page
  of the output.

  Output that is queued to SYS$PRINT is placed in the distribution boxes
  in the hallway of the Academic Computing Center according to the first
  two  characters  of  the  banner.   By  normal  convention,  the first
  character of the banner should  be  a  letter,  the  second  character
  should be a number, and the third character should be a space.  If the
  second character is not a number, then the output is placed in the '0'
  box.   Distribution  boxes numbered '7', '8', and '9' are locked boxes
  which required permission  from  the  Computer  Center  System  Access
  office.   Output  to  these  boxes must have a banner beginning with a
  '$' ('*' will be converted to '$').

  As an example, specifying

			PRT/NAME="B1 BOMBER"

  will be placed in box B1, and

			 PRT/NAME="BOMBER"

  will be placed in box B0.

  The double quotes are required delimiters around the banner.

  You are required to specify a banner. If one is not specified  on  the
  command  line,  then  PRT will prompt for one with "Specify NAME (Type
  '?'  for  help)  ?".  At  this  point,  specify  your  banner  without
  delimiting  quotes.  If  an  improper  bin  address  is  detected, the
  appropriate error message will appear and the prompt will be reissued.

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

  If  a  string  is  not specified, the DCL command line issuing the PRT
  command is reprinted on the flag page for future reference.

/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. See /IDENTIFY for related information.

/OUTPUT

 /OUTPUT=file-spec

  Redirects  the formatted output to a disk file rather then the printer
  queue.  Use of the /OUTPUT option will enable you to view  the  output
  and  make  corrections before sending it to the printer.  When this is
  done, the /NOHEADER and /NOFOOTER option should be issued when sending
  file-spec to the printer.

/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.   The  queues
  SYS$PRINT,  VM$PRINT,  LW$PRINT are distributed according to the first
  two characters of the /NAME banner in the output boxes located in  the
  hallway  of  the  Academic  Computing  Center.  All  other  queues are
  self-service printers.

  Available queues are:

	SYS$PRINT	Academic Computing Center
	CC$PRINT	Academic Computing Center Terminal Cluster
	CS$PRINT	Strong Hall, room 8b
	SS$PRINT	Fraser Hall, room 122
	EG$PRINT	Learned Hall, room 1054
	VM$PRINT	IBM/VM printer output
	LW$PRINT	LaserWriter output
 
/RESTART

 /RESTART (default)
 /NORESTART

  Specifies   whether   the   job   can  restart  after  a  crash  or  a
  STOP/QUEUE/REQUEUE command. If a  print  job  is  extremely  long  and
  output already printed can be salvaged, specify /NORESTART and reprint
  the remainder of the job  at  a  later  time.   This  saves  time  and
  resources.

2 Positional_qualifiers

  PRT  contains all  of the  positional qualifiers present  in VMS PRINT
  except /BURST, /FEED,  /FLAG,  /PAGES, /PASSALL, /SETUP,  /SPACE,  and
  /TRAILER.

/CONTINUOUS

 /CONTINUOUS
 /NOCONTINUOUS

 Positional Qualifier

  PRT will ignore  headers,  footers,  and  any  top  or  bottom  margin
  specifications.   PRT  will  print  the  file  without any page break.
  Thus, the file will be printed over  the  perforation  connecting  two
  pages. Forms with no defined top and bottom margins should be used for
  /CONTINUOUS to work properly.  If  a  form  with  defined  margins  is
  specified  with  the  /FORM  qualifier, those margins will still be in
  affect when the file is printed.

/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 PRT command  prints  a
  single copy of the specified files.

  If you place the /COPIES qualifier after the PRT  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. See /JOB_COPIES for related
  information.

/DELETE

 /DELETE
 /NODELETE (default)

 Positional qualifier

  All input files associated with the /DELETE qualifier  will be deleted
  after processing. If the input file contains a list of filenames to be
  printed (using  /LIST),   then each file  found  in  the list will  be
  deleted.  The /LIST file will not be deleted.

  This option is in no way associated with the automatic deletion of the
  temporary file created when PRT is executed. The temporary output file
  will always be deleted unless the print job aborts before printing has
  terminated normally.

/EXCLUDE

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

 Positional Qualifier

  Any files that match the listed file specifications are excluded  from
  the  PRT  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.

/FIRSTPAGE

 /FIRSTPAGE=page-number

 Positional Qualifier

  Used in conjunction with the "%L" code sequence in the /HEADING and/or
  /FOOTING  qualifier  specifications.   Specifies the starting value of
  the local page number (the page number relative  to  the  top  of  the
  file).

  Default  value  for  this setting is 1.  See "Headers and Footers" for
  related information.

/LINENUMBERS

 /LINENUMBERS
 /NOLINENUMBERS (default)

 Positional Qualifier

  Printed output has each line  numbered  on  the  extreme  right  side.
  Offset is increased by eight characters.

/LIST

 /LIST
 /NOLIST (default)

 Positional Qualifier

  The input file  specified with  the /LIST qualifier  should contain  a
  list of file specifications  for files that  are  to  be  printed, one
  file-spec per line. Standard VAX wildcard characters are allowed. No
  qualifiers can be specified within this file.

/OFFSET

 /OFFSET=n

 Positional Qualifier

  /OFFSET specifies the left margin or indentation of a page. This value
  is added to the system defined left margin of the  form  specified  by
  /FORM (or the default form if no form is specified). This qualifier is
  analogous to a left margin. The default setting is 0.

/SPACE

 /SPACE
 /NOSPACE (default)

 Positional Qualifier

  By specifying /SPACE, the file to be processed will  be  printed  with
  double  spacing.  The  default,  /NOSPACE, prints the file with single
  spacing.

/TABSETTINGS

 /TABSETTINGS=n
 /TABSETTINGS=(n1, n2, n3, ..., nn)

 Positional Qualifier

  In  the  first  case,  tabs are set to every n columns.  In the second
  case, tabs are set at each of the specified columns, and  a  space  is
  inserted  for  any  tab  beyond  the last tab in the list, nn. Default
  value for this qualifier is every 8 spaces.

/WIDTH

 /WIDTH=n

 Positional Qualifier

  /WIDTH  specifies  the page width (in characters) including the offset
  specified with the /OFFSET qualifier.  To  specify  the  right  margin
  correctly,  /WIDTH should be set equal to the defined system width for
  the form in use minus the number of spaces for the right margin  (i.e.
  if  the form has a system defined width of 80 characters, and you want
  a right margin of 10 characters, then you should set /WIDTH=70.

  The default value for /WIDTH is set to the system defined width of the
  form in use minus one character for the carriage return.  If /WIDTH is
  larger then this default, then the default will be used, instead.

/WRAP

 /WRAP (default)
 /NOWRAP

 Positional Qualifier

  When /WRAP is set, if a line in the file is longer than the  width  of
  the  page,  the line is continued on the next line, whereas when /WRAP
  is not set, the line is truncated at the last column of the  page  and
  the rest of the line is ignored.

2 Headers and Footers

 /[ODD]HEADING="left-string"
 /[ODD]HEADING=("left-string","center-string")
 /[ODD]HEADING=("left-string","center-string","right-string")
 /NO[ODD]HEADING
 /[ODD]FOOTING="left-string"
 /[ODD]FOOTING=("left-string","center-string")
 /[ODD]FOOTING=("left-string","center-string","right-string")
 /NO[ODD]FOOTING

 Positional Qualifiers

  Specifies the strings to be printed at the top or bottom of each page.
  /HEADING and /FOOTING are analogous but  independent  qualifiers.  The
  optional /ODDHEADING and /ODDFOOTING  qualifiers  affect the odd pages
  only.  By  specifying /ODDHEADING without  any string values, the  odd
  pages will have the default header strings in reverse order,  that is,
  the left-string will be on the right  and the right-string  will be on
  the left.

  All strings  must be delimited with  quotes (").  Any or  all   of the
  three strings  can be specified,  but when a  string is specified, the
  strings positioned to its  left  must contain   a value, even  if that
  value is empty (i.e.  "").  The parenthesis  are  unnecessary if  only
  the left-string is specified.  There are certain code sequences  which
  yield different information when inserted within a string.  These code
  sequences are as follows:

	%% -  A literal '%'
	%D -  Prints the date in the form:
		weekday, month, day-of-month, year
	%F -  Displays the current file name without the extraneous
	      information like disk, username, and catalog pathname.
	%G -  Prints the current "global" page number, that is, the
		page number relative to the first file in the listing.
	%L -  Prints the current "local" page number, that is, the
		page number relative to the top of the current file.
	%P -  Displays the current file name including the disk,
	      UIC, and catalog pathname.
	%T -  Prints the time in the form:
		     HR:MN AM  or  HR:MN PM
	%U -  Yields the username.

  As  an  example,  the  default  settings for the heading and footing
  lines would be specified as:

	PRT /HEADING=("%P", "", "%T  %D") /FOOTING=("", "%L")

2 Margins

 /TOPMARGIN=n
 /BOTTOMMARGIN=n

 Positional Qualifiers

  Specifies the ABSOLUTE offset from the top and  bottom  of  the  page.
  These  values  are  valid  only  when they are greater then the system
  defined margins for the form in use in a print job.  If these settings
  are  less then the system defined margins, then the margins defined by
  the form is assumed.  See /OFFSET and  /WIDTH  for  information  about
  left and right margins.

2 Examples

  1.   $ PRT AVERAGE
	 AVERAGE (queue SYS$PRINT, entry 236) started on LPA0

  The PRT 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.   $ PRT  ALPHA.TXT, BETA.TXT, GAMMA.TXT
         Job ALPHA (queue SYS$PRINT, entry 237) pending

  The PRT command submits the files ALPHA.TXT, BETA.TXT, and GAMMA.TXT
  as  a  single  print job.  

  3.   $ PRT/QUEUE=vm$print/NAME="B1BOMBER" JUNE10.MEM
         Job JUNE10 (queue SYS$PRINT, entry 476) started on LPA0

  The PRT command, sends a copy  of  the  file  JUNE10.MEM  to  the  IBM
  printer  located  in  the  Academic  Computing Center. 

  4.   $ PRT/OFFSET=10/WIDTH=70/TOP=6/BOT=6/FORM=bogus_form REPORT.MEM
         Job REPORT (queue SYS$PRINT, entry 342) started on LPA0

  The  file  REPORT.MEM  is  printed  with  one inch margins on the top,
  bottom, left  and  right  sides  of  the  page.   The  form  specified
  (/FORM=bogus_form)  for  this  to work properly should be a continuous
  form with no margins specified.  If the form that is  used  does  have
  margins  specified,  then the top and bottom margins will be in affect
  only if they are greater then the form specified margins.  The  offset
  is  added  on to the form specified left margin, and the width remains
  in affect only if it is less than the form specified width.
