!	USERPRINT.HLP
!
!	VERSION 1.3	29-JUNE-1983
!
!	Written by:	Jim Moomaw
!			INTEL CORPORATION
!			Reliability Physics Laboratory,  Dept. 255
!
!
! This is a  help-text   file to be included in  HELPLIB.HLB as a descrip-
! tion  of the INTEL specific  print command (as  defined  by the  program
! USERPRINT.FOR,   and   the   accompanying   command   definition    file
! USERPRINT.CLD.  Some of  the qualifiers are the same as the original DCL
! defined PRINT command, some are modified versions, and some are entirely
! new. 
!
!
1 PRINT
 Queues one or more files for printing, either on a default printer, or
 on a specified device.  For this QA VAX system, the default printer is
 the  LA100  printer in the same building as the user's  terminal.  The
 command also  provides  some  control over printer formatting,  if the
 printing device has selectable characteristics. 

 Format:

     PRINT[/qualifiers...]   file-spec[,...][/qualifiers...]

 Example:

     PRINT/FONT=GOTHIC12  [MAIN.SUBDIR]MEMO1.MEM/LETTER,MEMO2,TABLE.TXT

2 Disclaimer
 This is a custom command made specially for the QA VAX computer. It is
 a modified form of the PRINT command  found in the  VAX/VMS documenta-
 tion.  You  must  refer  to  the  addendum  in  the  Command  Language
 User's Guide under PRINT  (INTEL)  for  further information.  Problems
 with the command should be refered to the system  manager, and  not to
 Digital Equipment Corp.
2 Parameters
 file-spec[,...]

  Specifies one or more files to be printed.  If you  specify  more
  than  one  file,  separate  the  file  specifications with either
  commas (,) or plus signs (+).  In either case, the PRINT  command
  concatenates the files into a single  print  job.  Wildcards  are
  allowed in file specifications.

  If you do not specify a file type for the first input  file,  the
  PRINT command uses the default file type of LIS. Subsequent files
  in  the  list  take  on  as  defaults  the  parts of the filespec
  identified in the file specification  immediately  preceeding it.

  When the  /FORMATTING  qualifier is used,  a specific file cannot
  be repeated in the list, and, in fact, cannot be re-submitted for
  printing  until  the  first  instance has completely printed out.
  This  restriction  does  not  hold  for /NOFORMATTING print jobs.
2 Qualifiers
/AFTER

   /AFTER=time

 Requests that the  file(s)  not be printed until a  specific time
 of day.  This  is a global qualifier that applies to all files in
 the list, regardless of where it is specified.

 You may specify an absolute time, delta time, or a combination of
 the two.  See HELP SPECIFY DATE_TIME for the rules for specifying
 date and time.

 If the specified time has already passed, the file is queued  for
 printing immediately.

 You may not specify this qualifier for files queued to the  LA120
 printer (via the SYS$TERMINAL queue)  in the AL3 software office.
/COPIES

   /COPIES=n

 Specifies the number of copies to print,  to a maximum of 10.  By
 default,  the  PRINT  command  prints  a  single  copy of a file.

 If you specify /COPIES 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.
/DELETE

   /DELETE
   /NODELETE   (D)

 Controls whether files are deleted after printing. If you specify
 /DELETE after the  PRINT  command name,  all files specified  are
 deleted.  If you specify /DELETE after a file specification, only
 that file is deleted after it is printed.

 This  qualifier  is  only  valid  for  /NOFORMATTING  print jobs.

 The protection applied to the  file  must  allow delete access to
 the current UIC.

 By default, no files are deleted after printing.
/DEVICE

   /DEVICE=device-name[:]

 Requests that the file(s) specified be queued for printing  on  a
 specific  device  to  which  queueing is allowed.  If the /DEVICE
 qualifier is not specified, files  are  queued,  by  default,  to
 the  closest  printer to user's terminal.  The  table below shows
 currently available printing devices,  and their location  within
 the Intel Oregon QA department.

 Model       Device-name    Queue          Location
 -----------------------------------------------------------------
 VERSATEC    VERSATEC       SYS$PRINT      AL3/ Software Office
 LA120       LA120          SYS$TERMINAL   AL3/ Software Office
 LA100       AL3LA100       TTD1           AL3/ Department Office
 LA100       JF1LA100       TTD3           JF1/ Software Office

 This is a global qualifier that applies to all files in the list,
 regardless  of  where  it  is  specified.  If  this  qualifier is
 present,  all  files  will  be  directed to  the device selected.

 This qualifier is fully synonymous  with  the  /QUEUE  qualifier.
/DRAFT

   /DRAFT   (D)

 Specifies  draft-quality  printing  on  letter-quality   printing
 devices that  support this feature.  Enabled  by the  /FORMATTING
 qualifier.  Currently, only valid for LA100 printers, and ignored
 by  all other devices.  Draft  mode  provides  the highest speed,
 but the  poorest print quality.  Draft  quality printing is about
 4X faster than letter quality printing.  Note that draft mode  is
 the only way to achieve pitches other than the generic font-pitch
 of the chosen font.

 If you specify the  /DRAFT qualifier as a command qualifier  with
 the command name, the entire job is printed draft-quality.

 If you specify the  /DRAFT qualifier with any file  specification
 (which is the default), that file will be printed draft-quality.

 Related to, but mutually exclusive with, the /LETTER qualifier.
/FLAG_PAGE

   /FLAG_PAGE
   /NOFLAG_PAGE   (D)

 Controls whether a flag page is printed  preceeding  output.  Use
 this  qualifier to override the installation-defined defaults set
 up for printers when they are started. The default for the LA100,
 and LA120 printers is no flag page. The flag page acts as a cover
 page,  containing the print-job name,  the  date of the printout,
 and what account generated it.  It  is most useful for big  print
 jobs,  and less needed for small ones.

 If you specify the /FLAG_PAGE qualifier as  a  command  qualifier
 with the command name, a flag page is printed for the entire job.

 If  you  specify  the  /FLAG_PAGE   qualifier   with   any   file
 specification,  a  separate  flag  page is printed preceeding the
 associated file.
/FONT

   /FONT=element-type, or slot-position

 Specifies a font style, for letter-quality  printing devices that
 support this feature.  Currently,  only valid for LA100 printers,
 and ignored by all other devices. Choices are COURIER10 (default),
 ORATOR10, and  GOTHIC12.   Optionally,  other  plug-in font cart-
 ridges may be used (after inserting into a printer) by specifying
 UPPER  or  LOWER  font  socket, as appropriate.  Enabled  by  the
 /FORMATTING qualifier.

 Vertical pitch is set to 6 lines/inch for all font types,  except
 ORATOR, which is set to 4 lines/inch.

 If you specify the  /FONT  qualifier as a command qualifier  with
 the command name, the  entire  job is printed in the chosen font.

 If you specify the  /FONT  qualifier with any file specification,
 that  file  will be printed in the chosen font,  and those others
 which aren't specified will print in the default font.
/FORMATTING

   /FORMATTING    (D)
   /NOFORMATTING

 Enables  printer  formatting  qualifiers,  if the printing device
 chosen supports formatting commands.  Currently,  both  the LA100
 and  LA120  printers  accept formatting commands.  Other printers
 assume /NOFORMATTING.  For most print jobs, this qualifier should
 be used  (and,  in fact,  must be  used to enable any non-default
 printer characteristics wanted, such as letter-quality printing.)
 The  exceptions  would  be  very  large  print  jobs that can use
 default printer setups, such as program listings. Since the PRINT
 utility formats files at a rate of 200 blocks/minute,  very large
 print jobs might take several minutes to queue if /FORMATTING was
 selected, but would only take a few seconds if /NOFORMATTING  was
 selected.

 This is a global qualifier that applies to all files in the list,
 regardless of where it is specified.
/HEADER

   /HEADER
   /NOHEADER    (D)

 Controls whether the name of the file is printed at  the  top  of
 each  output  page.   By  default,  the file specification is not
 printed.
/JOB_COUNT

   /JOB_COUNT=n

 Requests that the entire job be printed n times,  where  n  is  a
 decimal number from 1 through 10.   By default the job is printed
 once. This differs from /COPIES in that /JOB_COUNT duplicates the
 entire print  command line  n  times,  while the repeat count for
 /COPIES only applies to files in the parameter list.  Both can be
 used in a command line, where the /JOB_COUNT value will act as  a
 multiplier to any /COPIES values specified.
 
 This  is a global  qualifier  that  applies  to  the entire print
 command, regardless of where it is specified. 
/LETTER

   /LETTER

 Selects  letter-quality  printing   on  letter-quality   printing
 devices that  support  this  feature.  Enabled by the /FORMATTING
 qualifier. Currently, only valid for LA100 printers,  and ignored
 by all other devices.  Letter  mode  provides  the slowest speed,
 but the highest print quality.  Letter quality  printing is about
 4X slower than draft quality printing. Note that letter mode only
 allows two horizontal pitch choices -  one at generic font-pitch,
 (10 or 12) and one at half generic font-pitch (5 or 6).
 
 If you specify the  /LETTER qualifier as a command qualifier with
 the  command  name, the  entire  job  is  printed letter-quality.

 If you specify the /LETTER qualifier with any file specification,
 that file will be printed letter-quality.

 Related to,  but mutually exclusive with,  the  /DRAFT qualifier.
/MARGIN

   /MARGIN=left-margin-column

 Specifies  where  the first  printable column on the left side of
 the page will be,  where the physical left edge of the paper will
 be positioned to coincide with a margin setting of one.   Default
 setting for the LA100 is eight, and default setting for the LA120
 is one.  Valid for LA100 and LA120 printing devices,  and ignored
 for all others. Enabled by the /FORMATTING qualifier.

 If you specify the  /MARGIN qualifier as a command qualifier with
 the command name,  all files are printed at the indicated margin.

 If you specify the /MARGIN qualifier with any file specification,
 that file will be printed at the indicated margin.
/NAME

   /NAME=job-name

 Defines a 1- through  9-alphanumeric  character  name  string  to
 identify  the  job.   The job name is displayed by the SHOW QUEUE
 command and is printed in the top and bottom  rows  of  the  flag
 page for the job.

 This is a global qualifier that applies to all files in the list,
 regardless of where it is specified. 
/NOTIFY

   /NOTIFY
   /NONOTIFY   (D)

 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.

 By default, no message is broadcast.
/PAGE_COUNT

   /PAGE_COUNT=n

 Specifies the number of pages of the  specified  file  to  print.
 You  can only use /PAGE_COUNT to qualify file specifications;  it
 cannot qualify the command name.  You  can  use  the  /PAGE_COUNT
 qualifier to print just the first few pages of a large file.

 By default, all pages are printed.
/PITCH

   /PITCH=horizontal-pitch

 Specifies horizontal printing pitch, expressed in characters/inch,
 for printing devices that support this  feature.  Currently valid
 for  LA100  and  LA120  devices,  and  ignored  by other devices.
 Choices  are:  5, 6, 6.6, 8.25, 10, 12, 13.2,  and  16.5.  If not
 specified, and /FORMATTING is enabled, an optimum pitch is chosen
 (auto-sizing) for each document printed, at either  10, 12, 13.2,
 or 16.5.  This auto-sizing feature will turn off /LETTER mode, if
 the document won't fit on the page due to  excessive  line length
 at the generic font-pitch of the selected font.  (Beware that tab
 characters  in  a  document  will  fool the auto-sizer,  possibly
 causing a document to run off the edge of the paper.)  If /NOFORM-
 ATTING is chosen,  the default pitch is 16.5 for LA100 and  LA120
 printers.
 
 Enabled by the /FORMATTING qualifier. 

 (Note:  LA100  printers   have  only  two  pitch  choices when in
 LETTER mode - one at the generic font-pitch (10 or 12),  and  one
 at half the generic font-pitch (5 or 6).

 If you specify the  /PITCH  qualifier as a command qualifier with
 the command name,  all  files are printed at the indicated pitch.

 If you specify the  /PITCH qualifier with any file specification,
 that file will be printed at the indicated pitch,  and the others
 will be printed at an optimum pitch (auto-sized).
/PRIORITY

   /PRIORITY=n

 Specifies the priority of the print job.  The priority,  n,  must
 be  in  the range of 0 through 31, where 0 is the lowest priority
 and 31 is the highest.

 Defaulted to 4,  and  may  be  increased only if the user has the
 privilege to change priority.  Anyone may decrease it below four.

 This is a global qualifier that applies to all files in the list,
 regardless of where it is specified. 
/QUEUE

   /QUEUE=queue-name[:]

 Requests that the file(s) specified be queued for printing  in  a
 specific print queue.  If the  /QUEUE qualifier is not specified,
 files are queued,  by default,  to the closest  printer to user's
 terminal.  The  table below shows  currently  available  printing
 queues, and their location within the Intel Oregon QA department.

 Model       Queue          Device-name    Location
 -----------------------------------------------------------------
 VERSATEC    SYS$PRINT      VERSATEC       AL3/ Software Office
 LA120       SYS$TERMINAL   LA120          AL3/ Software Office
 LA100       TTD1           AL3LA100       AL3/ Department Office
 LA100       TTD3           JF1LA100       JF1/ Software Office

 This is a global qualifier that applies to all files in the list,
 regardless  of  where  it  is  specified.  If this  qualifier  is
 present, all  files  will  be directed  to  the  queue  selected.

 This qualifier is fully synonymous  with  the  /DEVICE qualifier.
/SPACE

   /SPACE
   /NOSPACE    (D)

 Controls whether output is to be double-spaced.

 If you specify the  /SPACE  qualifier as a command qualifier with
 the command  name,  all  files  are printed  with double spacing.

 If you specify the  /SPACE qualifier with any file specification,
 that  file  will be printed with double spacing,  and the others
 will be printed with normal single spacing.
