Trailing-Edge
-
PDP-10 Archives
-
BB-PBDEB-BB_1990
-
10,7/system/tpunch.hlp
There are 2 other files named tpunch.hlp in the archive. Click here to see a list.
TPUNCH Command
Function
The TPUNCH command places entries into the paper tape punch
output queue. For more help on queues, see the the help file
QUEUE.
Format
TPUNCH dev:jobname=file-spec
Where: dev: is the name of the specific tape punch on which
your files should be processed. (For example, PTP2:
is tape punch number 2.) You can have your files
processed on another node by using the format PTPSxx:,
where xx is the node number. (For example, PTPS25: is
a punch on node 25.) The device name is optional.
jobname is the name of the job to be entered into the
queue. The default is the name of the first file in
the request.
The equal sign is required if you specify the job name,
the device name, or both.
file-spec is a single file specification or a string of
file specifications, separated by commas, for the files
to be processed. A file specification is in the form
dev:file.ext[directory].
If you do not enter a job name or an input specification, the
system prints a list of the jobs in the paper tape punch 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 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.
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. To achieve a temporary
or permanent effect by the placement of the switch, 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. See the
TOPS-10 Operating System Commands
Manual for a discussion of command
arguments and a description of
date-time arguments.
/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 is not
present, no files should be
processed. The value of YES or NO
is optional. If you specify YES,
all of the files you specified must
exist, or none of the files will be
punched.
/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 with creation
date-time control dates before the specified date and
time. See the TOPS-10 Operating
System Commands Manual for a
description of date-time arguments.
/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.
If you need more than 63 copies,
make two or more entries.
/CREATE Queue Makes a new entry in the tape punch
operation queue. This switch is the default
function, except when you are
listing the entries in the queue.
/DEFERRED Queue Causes deferred output to be
operation released to the paper tape punch
queue. You must use one of the
following switches with /DEFERRED:
/CREATE completes all released
output requests.
/KILL eliminates the released
output requests.
Fore more help, see the help file
SETDEF.
/DELETE File Deletes the file after spooling.
control (This is the same as
/DISPOSE:DELETE.)
/DESTINATION: Queue Specifies the node that will
node operation process the request. Use this
switch to specify that the paper
tape punch be connected to the
specified node. Use the node name
or node number to specify the node.
Files cannot be punched at a host
other than the host node to which
your terminal is connected. If the
request is made to punch files at
another host, or at 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 punching it.
PRESERVE keeps the file in your
area after punching it. This is
the default function.
RENAME renames the file into the
spooling area. This deletes the
file from your directory area
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 wildcard construction.
This is the default function.
/ERPROTECTION Queue Prints an error message if
operation processing the request requires a
violation of file protection. This
is the default function.
/FAST Queue Prints a list of the entries in the
operation paper tape punch queue in a fast
format. This is the same as
/LIST:FAST.
/FILE:arg File Specifies how the file format is to
control be 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 Processes the file on the specified
operation kind of paper tape. The default is
NORMAL. Available forms are listed
in SYS:FORMST.DAT.
/GENERIC Queue Sends output to the next available
operation paper tape punch. 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 type /HEADER or if you
specify YES. Does not make headers
between files 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 with 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 give a job
name, /SEQUENCE, or /REQUESTID, to
the left of the equal sign in the
command line.
/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 feet.
/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 QUEUE command with no arguments
and no switches. /LIST can be
abbreviated to /L . The switch can
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 to the error message.
/MODIFY Queue Alters the specified parameter in
operation the specified job. This switch
requires that you have access
rights to the job. You must give a
job name, /SEQUENCE, or /REQUESTID,
to the 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:YES or NO File Accepts the request even if the
control file does not yet exist.
/NOHEADER File Suppresses header units before
control file. /HEADER is the default
function.
/NONEW File Forces the system to use an
control existing file. This is the default
function.
/NONOTIFY Queue Does not set the system to notify
operation you when the request is finished.
See /NOTIFY.
/NONULL Queue Prints an error message if none of
operation the files in the request exist.
This is the default function.
/NOOPTION Queue Suppresses the SWITCH.INI file.
operation See the help file SWINI for help on
SWITCH.INI files.
/NOPHYSICAL File Recognizes logical names for
control devices in the command string.
This is the default function.
/NOSTRS File Does not scan each structure for
control files of the same name. This is
the default function.
/NOTES:"text" Queue Punches the text in the header
operation units. 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: Queue Notifies you on your terminal when
YES or NO operation 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 the output of
deferred requests, you will never
be notified.
/NULL:YES or NO Queue Does not print a fatal error
operation message if the specified file does
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 print a warning message if
operation no files match the wildcard
construction.
/OKPROTECTION Queue Does not print error messages when
operation a protection error occurs.
/OPTION:option Queue Uses the option line QUEUE:option
operation in the SWITCH.INI file. See the
help file SWINI for help on
SWITCH.INI files.
/PHYSICAL File Does not recognize logical names
control for devices in the command line.
/PRESERVE File Saves the control file after
control processing it. This is the default
and it is the same as
/DISPOSE:PRESERVE.
/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 help on
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 the job
you wish to modify or terminate.
/RUN:file Queue Executes the specified file after
operation the job is done.
/RUNCORE:n Queue Executes the file specified in /RUN
operation in nK of core after the job is
done.
/RUNOFFSET:n Queue Executes the file specified in /RUN
operation with offset n after the job is
done.
/SEQUENCE:n Queue Specifies a sequence number to help
operation identify a request to be modified
or deleted.
/SINCE: File Queues only the files with a
date-time control creation date after the specified
date and time.
/STRS:YES or NO File Searches for the file on all
control structures in the search list and
takes every occurrence. The
default is to take just the first
occurrence of the file.
/TAPE:arg File Punches paper tape in the specified
control mode. If you do not use this
switch, the tape is punched
according to the data mode
specified in the file. You can use
any one of the following arguments
with this switch:
ASCII punches the tape in ASCII
mode.
BINARY punches the tape in binary
mode.
IBINARY punches the tape in image
binary mode.
IMAGE punches the tape in image
mode.
/TMPFIL: Queue Creates a temporary file TMP:file
file:text operation and enters the text into the file.
/UNIT:n General Specifies the unit number of the
device to which you want the output
sent.
/USERNAME: Queue Specifies the user name field of
"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:
[PAPERTAPE 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 feet that the job will
use.
Characteristics
Leaves your terminal in monitor level.
Destroys your core image.
Does not require LOGIN if a list of queue entries is desired.
Example
Punch 3 copies, in binary mode, of the file DSK:SENDMP.REL.
.TPUNCH SENDMP.REL/TAPE:BINARY/COPIES:3<RET>
[PAPERTAPE JOB SENDMP QUEUED, REQUEST #131, LIMIT 10]
.