Google
 

Trailing-Edge - PDP-10 Archives - BB-PBDEB-BB_1990 - 10,7/system/plot.hlp
There are 5 other files named plot.hlp in the archive. Click here to see a list.
PLOT Command

Function

     The PLOT command places entries in the plotter output queue.  See
     the QUEUE command for further information and examples.

Format

     PLOT dev:jobname=file-spec

     Where:    dev is the name of the specific device  on  which  your
               files  should  be  plotted.   (For  example,  PLT2:  is
               plotter number 2.) You can have your files plotted on a
               device  connected  to  another node by using the format
               PLTSxx:  where xx is the node  number.   (For  example,
               PLTS31  is  a  plotter  on node 31.) The device name is
               optional.

               jobname is the name of the job being entered  into  the
               queue.   The  job name is optional.  The default is the
               name of the first file in the request.

               The equal sign is required if you  specify  either  the
               device name, the job name, or both.

               file-spec is a single file specification or a string of
               file  specifications,  separated  by  commas.   A  file
               specification is in the form dev:file.ext[directory].

     If you specify neither a job name nor a file  specification,  the
     system  prints  a  list  of the jobs in the plotter queue on your
     terminal.

     The switches to this command can be divided into two  categories,
     depending  on whether the switch can be used only once, or can be
     used more times, in a single command string.  The two  categories
     are:

      o  Queue-Operation Switches

         These switches can be used only once in the  command  string.
         They  affect  the  entire  request,  and  you  can place them
         anywhere in the command string.  If  you  have  used  one  of
         these  switches  in a command string, you cannot use it again
         in the same string.  Many switches have a  /NO  construction,
         which  has a negative effect.  Be sure you do not use the /NO
         construction of a switch in the same command string with  the
         positive construction.

      o  File-Control Switches

         These switches can be used any number of times in the command
         string.  You can also use the /NO construction of a switch in
         the same command string with the positive construction.   For
         more information on temporary and permanent switches, see the
         help file SWITCH.


        Switch        Category                   Function

     /ABEFORE:        File         Queues the file only  if the access
      date-time       control      date is before the  specified  date
                                   and time.

     /ACCOUNT:        Queue        Specifies  the account to which the
     "string"         operation    job  should  be  charged.   If  the
                                   account    string    contains   any
                                   nonalphanumeric   characters,   you
                                   must    enclose   the   string   in
                                   quotation marks.

     /AFTER:          Queue        Processes  the  request  after  the
      date-time       operation    specified date and time.

     /ALLFILES:       Queue        Accepts  a request  only  if all of
      YES or NO       operation    the files in the request exist.  By
                                   default, if any of the files do not
                                   exist, the others will be processed
                                   appropriately.      This     switch
                                   specifies that if any file does not
                                   exist,    no    files   should   be
                                   processed.  The value of YES or  NO
                                   is  optional.   If you specify YES,
                                   all the files  you  specified  must
                                   exist  or none of the files will be
                                   plotted.

     /ASINCE:         File         Queues  only the  files  that  have
      date-time       control      been accessed since  the  specified
                                   date and time.

     /BEFORE:         File         Queues  only the  files  that  were
      date-time       control      created before the  specified  date
                                   and time.

     /CHARACTERISTIC: Queue        Specifies an output characteristic.
      arg             operation    You  can  find  a   list   of   the
                                   characteristics  arguments  defined
                                   for  your  system   in   the   file
                                   SYS:CHARTY.DAT.

     /CHECK           Queue        Prints on your terminal  a list  of
                      operation    the queue entries made by your job.

     /COPIES:n        File         Repeats the  output  the  specified
                      control      number of times  (n  must  be  less
                                   than  64).   The  default is 1 (one
                                   copy).

     /CREATE          Queue        Makes  a new entry  in the  plotter
                      operation    queue.  This switch is the default,
                                   except  when  you are listing queue
                                   entries.

     /DEFERRED        Queue        Causes   deferred   output   to  be
                      operation    released to the  queue.   You  must
                                   use  one  of the following switches
                                   with /DEFERRED:

                                   /CREATE  completes   all   released
                                   output requests.

                                   /KILL   eliminates   the   released
                                   output requests.

                                   See the <SET> command.

     /DELETE          File         Deletes the  file after  processing
                      control      it.    This   is   the   same    as
                                   /DISPOSE:DELETE.

     /DESTINATION:    Queue        Specifies   the   node   that  will
      node            operation    process  the  output.    Use   this
                                   switch  to  specify  that  the file
                                   should be plotted on a plotter that
                                   is connected to the specified node.
                                   Use  the  node  name  or  the  node
                                   number  to  specify the node.  If a
                                   request is made to a node that does
                                   not exist, the request will wait in
                                   the queue indefinitely.

     /DISPOSE:arg     File         Controls  the  disposition  of  the
                      control      file  after  it  is  queued.    The
                                   arguments to this switch are:

                                   DELETE deletes the file  from  your
                                   directory after plotting it.

                                   PRESERVE preserves the  file  after
                                   plotting  it.   This is the default
                                   function.

                                   RENAME renames the  file  into  the
                                   queuing area, deleting it from your
                                   directory immediately.

     /DISTRIBUTION:   Queue        Specifies  text  to  place  in  the
      "text"          operation    distribution field, on  the  banner
                                   page  of  output.  You can use this
                                   field    to     include     mailing
                                   information,  or the location where
                                   the  operator  should   leave   the
                                   listing.   The text field may be up
                                   to  39   alphanumeric   characters,
                                   including punctuation and spaces if
                                   the text  is  placed  in  quotation
                                   marks.

     /ERBINARY        File         Prints an error message if a binary
                      control      file is included  in  the  request.
                                   This is the default function.

     /ERNONE          Queue        Prints an error message if no files
                      operation    match the file specification.  This
                                   is the default function.

     /ERPROTECTION    Queue        Prints   an   error    message   if
                      operation    processing   the   request    would
                                   require  a  violation of protection
                                   codes.    This   is   the   default
                                   function.

     /FAST            Queue        Prints the entries in  the queue on
                      operation    your terminal using a fast format.

     /FORMS:arg       Queue        Specifies  any special paper  to be
                      operation    used.  Available forms  are  listed
                                   in SYS:FORMST.DAT.

     /GENERIC         File         Sends   output   to     the   first
                      control      available  plotter.   This  is  the
                                   default  function.   This switch is
                                   the complement to /UNIT.

     /HEADER:         File         Makes header units before each file
      YES or NO       control      if you specify YES.  Does not  make
                                   headers  if  you specify NO.  1 may
                                   be used for YES; 0 may be used  for
                                   NO.   /HEADER:NO  is  the  same  as
                                   /NOHEADER.  /HEADER is the  default
                                   function.

     /HELP:arg        Queue        Prints information on your terminal
                      operation    about  the  QUEUE  command.    This
                                   switch  does  not  queue any files.
                                   This switch can be  used  alone  or
                                   with    one    of   the   following
                                   arguments:

                                   TEXT prints  a  message  about  the
                                   format  and  switches  to the QUEUE
                                   command.  This is the same as /HELP
                                   with no arguments.

                                   SWITCHES prints a list of  all  the
                                   switches  available  with the QUEUE
                                   command.

     /JOBNAME:name    Queue        Specifies the name of the job.  The
                      operation    job  name  can   be   up   to   six
                                   alphanumeric characters.

     /KILL            Queue        Removes  the specified  entry  from
                      operation    the queue.  You  must  specify  the
                                   job name, /REQUESTID, or /SEQUENCE,
                                   to the left of the equal sign.

     /LENGTH:n:m      File         Processes only  files whose  length
                      control      is between n and m blocks.

     /LIMIT:n         Queue        Limits  the output to the specified
                      operation    number of minutes.

     /LIST:arg        Queue        Prints a  list of  the jobs  in the
                      operation    queue.  If you use /LIST alone,  it
                                   shows  the jobs in the queue.  This
                                   is equivalent to  using  the  QUEUE
                                   command  with  no  arguments and no
                                   switches.  /LIST can be abbreviated
                                   to  /L.   The  switch can also take
                                   one of the following arguments:

                                   ALL shows all data about each queue
                                   request.

                                   FAST shows a fast list of the queue
                                   requests.   (This  is  the  same as
                                   /FAST.)

                                   JOBS shows a list of  the  jobs  in
                                   the  queue.   (This  is the same as
                                   /LIST with no arguments.)

                                   SUMMARY shows only the summary line
                                   of the queue display.

     /MESSAGE:        Queue        Specifies the amount of information
      arg             operation    to be printed when an error  occurs
                                   from  the request.  You can specify
                                   one  or  more  of   the   following
                                   arguments:

                                   ADDRESS  prints  the  location   in
                                   memory where the error occurred.

                                   CONTINUATION   prints   information
                                   about the error.

                                   FIRST  prints  the  one-line  error
                                   message.

                                   PREFIX prints a six-character error
                                   prefix.

     /MODIFY          Queue        Alters the specified  parameter  in
                      operation    the  specified  job.   This  switch
                                   requires   that   you  have  access
                                   rights  to  the  job.    You   must
                                   specify  a  job name, /REQUESTID or
                                   /SEQUENCE, to the left of the equal
                                   sign in the command line.

     /NEW:            File         Accepts  the  request even  if  the
      YES or NO       control      file does not yet exist.

     /NOHEADER        File         Suppresses  header  units  for each
                      control      file.   /HEADER  is   the   default
                                   function.

     /NONEW           File         Does not accept file specifications
                      control      of files that do not  exist.   This
                                   is the default function.

     /NONOTIFY        Queue        Suppresses notification of your job
                      operation    when  your  request  is   finished.
                                   This  is the default function.  See
                                   /NOTIFY.

     /NONULL          Queue        Prints  a fatal error  message on a
                      operation    null request.  This is the  default
                                   function.

     /NOOPTION        Queue        Suppresses    the    option    file
                      operation    SWITCH.INI.

     /NOPHYSICAL      File         Recognizes  logical  names  in  the
                      control      command  string.    This   is   the
                                   default function.

     /NOSTRS          File         When searching structures for file,
                      control      uses  only  the  first  occurrence.
                                   This is the default function.

     /NOTES:text      Queue        Plots   the  text   in  the  header
                      operation    columns.  The text can be up to  12
                                   characters, and it must be enclosed
                                   in  quotes  if  it   contains   any
                                   nonalphanumeric characters, such as
                                   spaces.

     /NOTIFY:arg      Queue        Notifies  you on your terminal when
                      operation    your request is completed.   To  be
                                   notified,   use   /NOTIFY  with  no
                                   argument, or with YES or  1  as  an
                                   argument.         To       suppress
                                   notification,    use     /NOTIFY:0,
                                   /NOTIFY:NO,   or   /NONOTIFY.    By
                                   default, you are not notified  when
                                   a  request is finished.  In special
                                   cases, such as output  of  deferred
                                   requests,   you   will   never   be
                                   notified.

     /NULL:           Queue        Does   not   print  a  fatal  error
      YES or NO       operation    message if the specified  files  do
                                   not exist.  /NULL:NO is the same as
                                   /NONULL.

     /OKBINARY        File         Accepts   files   whose  extensions
                      control      indicate that they  include  binary
                                   information.   Normally, files with
                                   extensions .SAV, .SHR, .LOW,  .REL,
                                   .EXE, and .HGH will not be accepted
                                   for processing.

     /OKNONE          Queue        Does not produce  an error  message
                      operation    if  no   files   match   the   file
                                   specification.

     /OKPROTECTION    Queue        Does  not  produce an error message
                      operation    if  a  file  protection   code   is
                                   violated.

     /OPTION:option   Queue        Uses  the option  line QUEUE:option
                      operation    in  the   SWITCH.INI   file.    For
                                   information  about  the  SWITCH.INI
                                   file, see the help file SWINI.

     /PHYSICAL        File         Does not recognize logical names in
                      control      the command line.

     /PLOT:arg        File         Plots  the file  in  the  specified
                      control      mode.  If you omit /PLOT, the  file
                                   is  plotted  according  to the data
                                   mode specified in  the  file.   The
                                   argument  can  be  any  one  of the
                                   following:

                                   ASCII plots the file in ASCII mode.

                                   BINARY plots  the  file  in  binary
                                   mode.

                                   IMAGE plots the file in image mode.
                                   This is the default function.

     /PRESERVE        File         Saves  the   file  after   plotting
                      control      it.    This   is   the   same    as
                                   /DISPOSE:PRESERVE  and  it  is  the
                                   default function.

     /PRIORITY:n      Queue        Gives the specified priority number
                      operation    (n is 1 to 63) to the  request.   A
                                   larger number has greater priority.

     /PROTECTION:     Queue        Specifies a protection code for the
      nnn             operation    queue request.  Queue requests  are
                                   protected  in  the  same  way  that
                                   files    are    protected.      For
                                   information about protection codes,
                                   see the help file PCODES.

     /REMOTE          Queue        Prints on your terminal a  list  of
                      operation    remote queues.  Must be  used  with
                                   /DESTINATION.

     /REQUESTID:n     Queue        Specifies        the        request
                      operation    identification number of a  request
                                   you  wish  to  modify or terminate.
                                   The request  identification  number
                                   is  assigned  when  the  request is
                                   queued.

     /RUN:file        Queue        Executes  the  specified file after
                      operation    the request is made.

     /RUNCORE:n       Queue        Executes the file specified /RUN in
                      operation    nK of core  after  the  request  is
                                   made.

     /RUNOFFSET:n     Queue        Executes the file specified in /RUN
                      operation    offset n after the request is made.

     /SEQUENCE:n      Queue        Specifies  a sequence number to aid
                      operation    in  identifying  a  request  to  be
                                   modified or deleted.

     /SINCE:          File         Queues only the files with creation
      date-time       control      dates after the specified date  and
                                   time.

     /STRS:           File         Searches   for   the   file  on all
      YES or NO       control      structures in the search  list  and
                                   takes    every   occurrence.    The
                                   default is to take just  the  first
                                   occurrence of the file.

     /TMPFIL:         Queue        Creates  a temporary  file TMP:file
      file:text       operation    and  enters  the  text   into   the
                                   temporary file.

     /UNIT:n          Queue        Specifies  the unit  number  of the
                      operation    device that  you  want  the  output
                                   sent to.

     /USERNAME:       Queue        Specifies the user  name  field for
      "name"          operation    the banner page  of  output.   This
                                   field   can   contain   up   to  39
                                   alphanumeric  characters,  and  may
                                   include  punctuation  and spaces if
                                   the name  is  placed  in  quotation
                                   marks.

Associated Messages

     When a new entry is made in a system queue, the system  prints  a
     message on the user's terminal.  The message is in the form:

     [PLOTTER JOB name QUEUED, REQUEST #nnn, LIMIT xxx]

     Where:    name is the name of the job in the queue.  This can  be
               specified  by  the  user  in  the  PLOT command string.
               Otherwise, it defaults to the name of the first file in
               the request.

               nnn  is  the  number  that   represents   the   request
               identification of the job in the queue.

               xxx is the maximum number of minutes that the job  will
               use.

Characteristics

     Leaves your terminal in monitor level.

     Destroys your core image.

     Does not require LOGIN  when you desire a list of the queue
     entries.

     Runs the QUEUE program.

Example

     Plot all files with the extension .PLT.  The operator is asked to
     put PLAIN paper on the plotter.

     .PLOT *.PLT/FORMS:PLAIN<RET>
     [PLOTTER JOB MLB QUEUED, REQUEST #172, LIMIT 30]

     .