Google
 

Trailing-Edge - PDP-10 Archives - BB-JR93N-BB_1990 - 10,7/system/cpunch.hlp
There are 2 other files named cpunch.hlp in the archive. Click here to see a list.
CPUNCH Command

Function

     The CPUNCH command places entries in the card punch  queue.   See
     the QUEUE help file for more information and examples.

Format

     CPUNCH dev:jobname=file-spec/switches

     Where:    *dev*:  is the name of the individual device  on  which
               the  file  is  to  be punched.  (For example, CDP2:  is
               card punch number 2.) The device name is optional.   To
               punch the file on a card punch at a different node, use
               devSxx;, where xx is the node  number.   (For  example,
               CDPS22:  is a card punch on node number 22.)

               jobname is the name of the job you  are  entering  into
               the  queue.   The  default  job name is the name of the
               first file in the request.

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

               file-spec is a single file specification or a string of
               file specifications, separated by commas, for the files
               being processed.  A file specification is in  the  form
               dev:file.ext[directory].   See the help file FISPEC for
               more information.

               If you specify neither a job name nor  a  file-spec,  a
               list  of  all  the jobs in the card punch queue will be
               printed on your terminal.

               The wildcard construction can  be  used  for  the  file
               specifications.

               /switches are  listed  below.   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  a  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  commands have a /NO construction, which takes
                   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.    See   the  help  file  SWITCH  for  more
                   information on temporary or permanent effect by the
                   placement of a switch.

       Switches       Category                   Function

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

     /ACCOUNT:name    Queue        Specifies the account  to which the
                      operation    job should be charged.

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

     /ALLFILES:       Queue        Accepts the 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 YES or NO  is
                                   optional.   If  you use YES, all of
                                   the files you specified must exist.
                                   If    NO,    existing   files   are
                                   processed, and warning messages are
                                   printed   for  files  that  do  not
                                   exist.

     /ASINCE:         File         Queues the  file only if the access
      date-time       control      date is later  than  the  specified
                                   date and time.

     /BEFORE:         File         Queues only the files with creation
      date-time       control      dates 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 one copy.

     /CREATE          Queue        Makes a new entry  in the specified
                      operation    queue.   This   function   is   the
                                   default,  except when listing queue
                                   entries.

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

                                   /CREATE to  complete  the  released
                                   output requests.

                                   /KILL  to  eliminate  the  released
                                   output requests.

                                   Refer to the SET DEFER command  for
                                   more information.

     /DELETE          File         Deletes  the file  after processing
                      control      it.  Same as /DISPOSE:DELETE.

     /DESTINATION:    Queue        Specifies the  node  at  which  the
      node            operation    file will be punched.  Use the node
                                   name  or node number to specify the
                                   node.   The  files  will   not   be
                                   punched  at any host other than the
                                   host  to  which  the  terminal   is
                                   connected.

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

                                   DELETE deletes the file  from  your
                                   directory after processing it.

                                   PRESERVE preserves the  file  after
                                   processing it.

                                   RENAME renames the file  from  your
                                   directory  into  the spooling area.
                                   Thus,  the  file   is   effectively
                                   deleted 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  queue.
                                   This is the default.

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

     /ERPROTECTION    Queue        Prints  an  error  message  if  the
                      operation    the request involves  a  protection
                                   violation.  This is the default.

     /FAST            Queue        Prints the entries in the queue  on
                      operation    your terminal.

     /FILE:arg        File         Specifies how the file format is to
                      control      interpreted.      The     following
                                   arguments  can  be  used  with this
                                   switch:

                                   ASCII interprets the file as  ASCII
                                   text.

                                   ELEVEN interprets the file as  four
                                   8-bit  bytes  in  each 36-bit word.
                                   The bits are arranged as follows:

                                        Byte 1:  bits 10-17
                                        Byte 2:  bits 2-9
                                        Byte 3:  bits 28-35
                                        Byte 4:  bits 20-27

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

     /GENERIC         File         Sends output  to the next available
                      control      card punch.  Complement to /UNIT.

     /HEADER:         File         Makes header cards  for  the  file.
      YES or NO       control      The default is YES.

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

                                   TEXT  prints  a  message  with  the
                                   format  and  switches  of 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    name can be up  to  6  alphanumeric
                                   characters.

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

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

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

     /LIST:arg        Queue        Prints  information  about the jobs
                      operation    in the queue.   If  you  use  /LIST
                                   alone,  it  shows  the  jobs in the
                                   queue.  This is equivalent to using
                                   the    CPUNCH   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.

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

                                   SUMMARY shows only the summary line
                                   of the queue display.

     /MESSAGE:arg     Queue        Specifies   the information  to  be
                      operation    output if  an  error  occurs.   The
                                   arguments are:

                                   ADDRESS        Prints the  location
                                                  in  memory where the
                                                  error occurred.

                                   CONTINUATION   Prints   information
                                                  about the error.

                                   FIRST          Prints  a   one-line
                                                  error message.

                                   PREFIX         Prints    the    six
                                                  character 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  the  job name, /REQUESTID,
                                   or /SEQUENCE,  left  of  the  equal
                                   sign  in  the  command  line.  This
                                   switch can  be  used  to  modify  a
                                   previously   submitted  request  as
                                   long as the request  has  not  been
                                   started.

     /NEW:            File         Accepts   file   specifications  of
      YES or NO       control      files that do not exist.

     /NOHEADER        File         Does not make header cards for each
                      control      file.

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

     /NONOTIFY        Queue        Does not notify you when the job is
                      operation    finished.  This is the default.

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

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

     /NOPHYSICAL      File         Allows logical names for devices in
                      control      the command string.

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

     /NOTES:"text"    Queue        Prints the text in the header card.
                      operation

     /NOTIFY:         Queue        Notifies  you on your terminal when
      YES or NO       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   or
                                   /NOTIFY:NO.   By  default,  you are
                                   not  notified  when  a  request  is
                                   finished.   Special  cases, such as
                                   printing of  batch  log  files  and
                                   output  of  deferred requests, will
                                   never  notify  you  when  they  are
                                   completed.

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

     /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 a warning  message
                      operation    if  no   files   match   the   file
                                   specification.

     /OKPROTECTION    Queue        Does not print an error message  if
                      operation    a file protection violation occurs.

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

     /PHYSICAL        File         Ignores logical device names in the
                      control      command line.

     /PRESERVE        File         Saves       the      file     after
                      control      processing   it.    This   is   the
                                   default.   This  switch is the same
                                   as /DISPOSE:PRESERVE.

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

     /PROTECTION:nnn  Queue        Specifies  a  protection code to be
                      operation    associated with the request.  Queue
                                   requests may have protection codes.
                                   These   are   exactly   like   file
                                   protection    codes.     For   more
                                   information, see the help  file  on
                                   protections codes, PCODES.

     /PUNCH:arg       File         Punches  the  file in the specified
                      control      mode.  If you omit this switch, the
                                   file  is  punched  according to the
                                   data mode specified  in  the  file.
                                   The following arguments can be used
                                   with this switch:

                                   026     Punches the  files  in  026
                                           Hollerith mode.

                                   ASCII   Punches the files in  ASCII
                                           card mode.

                                   BCD     Punches the  files  in  026
                                           Hollerith  mode.   (Same as
                                           026.)

                                   BINARY  Punches  the  files  in   a
                                           checksummed   binary   card
                                           mode.

                                   IMAGE   Punches the files in  image
                                           card format.

     /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  the  job
                                   you  wish  to  modify or terminate.
                                   The request  identification  number
                                   is  assigned  when  you  queue  the
                                   request.

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

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

     /RUNOFFSET:n     Queue        Executes the  specified  file  with
                      operation    start offset n after the request is
                                   accepted.

     /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:           Queue        Searches  for   the   file  on  all
      YES or NO       operation    structures in the search  list  and
                                   takes    every   occurrence.    The
                                   default is to take just  the  first
                                   occurrence of the file.

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

     /UNIT:n          Queue        Specifies the unit  number  of  the
                      operation    device 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:

          [CARD-PUNCH 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.   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 cards  that  the  job
                    will use.

Characteristics

     Leaves your terminal at monitor level.

     Runs the QUEUE program.

     Destroys your core image.

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

Examples

     1.  Punch the file SYSTAT.MAC in ASCII format.

         .CPUNCH SYSTAT.MAC/PUNCH:ASCII<RET>
         [CARD-PUNCH JOB SYSTAT QUEUED, REQUEST #75, LIMIT 33]
         .

     2.  Punch the file SYSTAT.REL in binary format, but do not  begin
         output until after 5:00 P.M.

         .CPUNCH SYSTAT.REL/PUNCH:BINARY/AFTER:17:00<RET>
         [CARD-PUNCH JOB SYSTAT QUEUED, REQUEST #43, LIMIT 200]

         .