TOPS-20 Commands Reference Manual
Places requests in a card punch or paper tape punch output queue.
@PUNCH (ONTO) medium (FILES) /switch(es) filespec/switch(es),...
|medium||is the name of the medium on which you want to punch your file(s). It
can be either
|switches||are keywords, chosen from the list below, indicating your choice of
PUNCH command options. These switches are of two kinds: job switches and
Job switches apply to all files specified in the command, no matter where you give the switches.
File switches have different effects depending on their positions in the command line: placed before all files in the command, they act as defaults for all; otherwise they affect only the nearest preceding file.
Defaults are shown in the list of switches
|filespec||is the specification of a file you wish to punch. You can use wildcard characters (% and *) to specify more than one file.|
Summary of PUNCH Command Switches (defaults in boldface)
(affecting the entire command)
|/ACCOUNT:account||Default account - your current account|
|/AFTER:date and/or time|
|/FORMS:forms||name Default forms name - NORMAL|
|/JOBNAME:6-character||name Default - first six characters of first filename in request|
|/LIMIT:n||Default n - calculated from length of files|
|/METERS:n||(PAPER-TAPE only) Default n - calculated from length of files|
|/PRIORITY:n||Default n - 10|
(affecting only the nearest preceding file, unless placed before all filespecs)
|/COPIES:n||Default n - 1|
|/DELETE Default for files of type .LST|
|/PRESERVE||Default for all files except those of type .LST|
PUNCH Command Switches
(affecting the entire job)
|/ACCOUNT:account||specifies the account of 39 or fewer characters to charge for your
punching request. This account must be valid for your user name.
Default account - your current account (check with INFORMATION JOB-STATUS)
|/AFTER:date and/or time or day of week (or TODAY) and/or time||ensures that the job will not be punched until after the date and/or
time specified. NOV-12-79 and 18:00 illustrate two arguments to this
switch. If you give both date and time, separate them with a space. When
given alone, the time may be preceded by a plus sign (+), which will delay
processing by the indicated length of time from the present.
Alternatively, you can give a day of the week (such as MONDAY) or TODAY as argument; then the job will not be punched until the beginning of the following day. If you follow this argument with a plus sign and a time, the job will be further delayed by this amount.
|/DESTINATION-NODE:node-name||specifies the IBM remote node on whose card punch or paper tape punch your request is to be satisfied. Two colons (::) following the node name are optional.|
|/FORMS:forms name||specifies, in six or fewer characters, the forms (determining the
weight and color of card or paper stock, the size of banner, header, and
trailer sections, etc.) to use for the punching job. Using this switch
may delay processing until the operator can mount the proper forms. Note
that your installation may provide a different default argument to this
Default forms name - NORMAL
|/GENERIC||allows any card punch or paper tape punch to be used for satisfying the
request; use this switch to override a previous /UNIT switch.
|/JOBNAME:name||assigns a name (of six or fewer characters) to the punching job.
Default name - first six characters of first filename in the request
|/LIMIT:n||places a limit of n cards (or n feet of paper tape) on the output of
the punching job.
Default limits, usually adequate, are calculated from the size of the files you want punched
|/METERS:n||places a limit of n meters on the output of the punching job (PAPER-TAPE only).|
|/NOTE:message||labels the header section of output (the section displaying the jobname) with a message or notation of up to 12 characters. The message must be enclosed in double quotation marks if it contains spaces or non-alphanumeric characters.|
|tells the system whether to send a message to your terminal when the
request has been satisfied.
Default argument - NO
Default argument (if switch is given) - YES
|/PRIORITY:n||assigns a number n, reflecting the urgency of the punch request. This
n must from 1 to 63, with larger numbers receiving earlier treatment. Note
that for non-privileged users the maximum priority that can be specified is
lower (usually 20), and that your installation may provide a different
value both for this maximum and for the default priority.
Default n - 10
|/SEQUENCE:n||specifies sequence number n for the punch request, which you can use when modifying or canceling the request.|
|/UNIT:octal number||directs your request to the card punch or paper tape punch of the specified octal unit number.|
|/USER:user name||specifies the user who is to be the owner of the punch request. For privileged users only.|
(affecting only the nearest preceding file, unless placed before all file specifications)
|/COPIES:n||requests that n copies of the file be punched; n must be less than or
equal to 62.
Default n - 1
|/DELETE||deletes the file after punching. Opposite of /PRESERVE.
Default for files of type .LST
|/HEADER||causes a header section containing the jobname to be punched before the
file itself is produced.
|designates the mode for punching the file onto cards. One of the
|designates the mode for punching the file onto paper tape. One of the
|/NOHEADER||prevents the punching of a header section before the file|
|/PRESERVE||saves the file after punching. Opposite of /DELETE.
Default for all files
|for withdrawing PUNCH requests|
|INFORMATION OUTPUT-REQUESTS||for examining requests in the output queues|
|for changing PUNCH requests before processing has begun|
|for establishing default switches for subsequent PUNCH commands|
- Punch a file onto cards.
@PUNCH CARDS ESTMT.DAT [Card-Punch job ESTMT queued, request-ID 146, limit 30]
- Punch a file onto paper tape.
@PUNCH PAPER-TAPE REAUMUR.LNS [Papertape job REAUMU queued, request-ID 12, limit 55]
- Punch three files onto paper tape, specifying a particular paper tape
punch for two of them and allowing the third to be punched on any available
@PUNCH PAPER-TAPE /UNIT:2 INDX.LTG, PON.LG4/GENERIC, - BENNETT.TXT [Papertape job INDX queued, request-ID 149, limit 110, 3 files]
- Punch a file onto paper tape, specifying that the job not begin for an
hour. Check for your requests in the output queues, then cancel both of
your paper tape requests.
@PUNCH PAPER-TAPE FORUM.APR /AFTER:+1:00 [Papertape job FORUM queued, request-ID 150, limit 10] @INFORMATION OUTPUT-REQUESTS/USER Papertape Queue: Job Name Req# Limit User -------- ---- ----- ------------------------------- INDX 149 110 SCARNY FORUM 150 10 SCARNY /After:20-Jul-79 16:20 There are 2 jobs in the queue (none in progress) Card-Punch Queue: Job Name Req# Limit User -------- ---- ----- ------------------------------- ESTMT 146 30 SCARNY There is 1 job in the queue (none in progress) @CANCEL PAPER-TAPE * [2 Jobs canceled]