Trailing-Edge
-
PDP-10 Archives
-
tops10_tools_bb-fp64a-sb
-
10,7/manual/topcmd.mem
There are 3 other files named topcmd.mem in the archive. Click here to see a list.
TOPS-10/TOPS-20
COMMANDS
QUICK REFERENCE GUIDE
OCTOBER 1983
NOTE
This publication was originally created for those customers who were
converting from a TOPS-10 system to a TOPS-20 system. The title of
the publication and the organization of material was designed to meet
that objective. Customers at 1983 Fall DECUS who saw this publication
requested DIGITAL to release it to all TOPS-10 customers because it
contains useful information for those not converting to TOPS-20.
Because of the number of customer requests, we are distributing this
publication as part of the TOPS-10 customer supported tape. There is
no commitment on DIGITAL's part to upgrade this material with future
releases nor to respond to requests for enhancements or corrections.
Operating systems:
TOPS-10 Version 7.01
TOPS-20 Version 5.1
1
First Printing, October 1983
The information in this document is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation. Digital Equipment Corporation assumes no responsibility
for any errors that may appear in this document.
The software described in this document is furnished under a license
and may only be used or copied in accordance with the terms of such
license.
No responsibility is assumed for the use or reliability of software on
equipment that is not supplied by DIGITAL or its affiliated companies.
Copyright (C) 1983 by Digital Equipment Corporation.
All Rights Reserved.
2
Preface
The TOPS-10/TOPS-20 COMMANDS QUICK REFERENCE GUIDE lists, in
alphabetical order, all TOPS-10 operating system commands available to
the user and comparable TOPS-20 commands. Each command description
contains the command name followed by its function. Where TOPS-10 and
TOPS-20 commands are identical, they are together with a single
functional description. TOPS-10 monitor level and TOPS-20 command
level are considered to be equivalent in the function descriptions.
All TOPS-20 commands not comparable to available TOPS-10 commands
appear with their function descriptions in the "Additional TOPS-20
Commands" section of this guide.
Various TOPS-20 commands accept subcommands, switches, and arguments.
To enter subcommand level, type a comma before you press the RETURN
key. You are at subcommand level when you see the prompt @@.
You terminate all command strings by pressing the RETURN key. In
addition, TOPS-20 commands provide Command Recognition when you press
the ESCAPE key. On TOPS-10, the ESCAPE key is equivalent to the
RETURN key.
You can use wildcard characters in TOPS-10 file specifications to
specify groups of files, in project-programmer numbers to specify
groups of PPN's, and in names of directories to represent groups of
directories. You cannot use wildcard characters in device names. The
asterisk (*) wildcard takes the place of a group of characters. The
question mark (?) wildcard takes the place of a single character. You
cannot use the characters * and ? together in the same field.
In TOPS-20 you can include wildcard characters in any field of a file
specification, to access all files matching the rest of the file
specification. An asterisk (*) takes the place of a group of
characters, while a percent sign (%) fills in for a single character
only. You cannot use the characters * and % together in the same
field.
For complete information on TOPS-10 and TOPS-20 commands, refer to the
respective operating system commands manual.
3
CONVENTIONS USED IN THIS GUIDE
The following conventions are used in this guide:
Convention Meaning
UPPERCASE LETTERS A command name
lower case letters A user-input argument
(word in command line) A TOPS-20 guide word
switch A TOPS-10 or TOPS-20 switch
switch followed by (10) A TOPS-10-only switch
switch followed by (20) A TOPS-20-only switch
switch preceded by (J) A TOPS-20-only job switch
4
TOPS-10/TOPS-20 COMMANDS
.ASSIGN node-id_dev:logical-name
Allocates an unrestricted device to your job without operator
intervention and assigns the logical name to the device. The node-id
allows you to specify a device from another node in the system
network. The node-id and the logical name are optional parts of the
command line.
@ASSIGN (DEVICE) dev:
Assigns exclusive control of a specific device for your job.
.ATTACH jobn [PPN]
PASSWORD:password
Detaches your terminal from your current job (if you are logged in)
and attaches your terminal to the specified job. The job number
(jobn) is required. The project-programmer number [PPN] is required
if you are detaching a job that has a different PPN from the job to
which you are attaching, or if you are not logged in when you type the
ATTACH command.
@ATTACH (USER) user name (JOB#) job number
PASSWORD:password
Attaches your terminal to a job. If you give the ATTACH command while
logged in, your current job is detached. You can use the LOGOUT n
command to log out this detached job.
.BACKSPACE MTxnnu:n {FILES or RECORDS}
@BACKSPACE (DEVICE) dev: n {FILES or RECORDS}
n is the number of files or records over which you want to backspace
Moves magnetic tape backwards the specified number of files or
records.
5
.CCONTINUE
@CONTINUE (PROGRAM) STAY
Resumes execution of a program that is halted and keeps your terminal
at monitor/command level.
.CLOSE dev:
Terminates I/O on the specified device, but does not release the
device from your job. If you omit the device name, I/O ends on all
devices assigned to your job except your terminal and disk.
@CLOSE (JFN) n
Closes files in your job and releases their JFNs (Job File Numbers).
6
.COMPILE filespec(a,b,c)/switches,filespec/switches,...
@COMPILE (FROM) /switch(es) source/switch(es) object,...
Runs one or more language processors to translate source code into
object code. For TOPS-10, if you omit the file specification and
switches, the system uses the arguments specified in any previous
COMPILE-class command. Use the optional (a,b,c) construction to pass
switches to the compiler or assembler. (Refer to Appendix C, TOPS-10
Operating System Commands Manual.)
Switches:
/68-COBOL(20) /74-COBOL(20) /ALGOL
/BINARY /BLISS /C68(10)
/C74(10) /COBOL /COMPILE
/CREF /DDT /DEBUG:arg
/DLIST(10) /FAIL(20) /FORTRAN
/FORDDT(10) /FUDGE:file(10) /KI10(10)
/KL10(10) /KS10(10) /LANGUAGE-SWITCHES:(20)
/LIBRARY /LIST /LMAP:file(10)
/MACRO /MACY11(10) /MANTIS(10)
/MAP:file /NEW(10) /NOBINARY
/NOCOMPILE /NOCREF(20) /NODEBUG
/LIBRARY(20) /NOLIST /NOMANTIS(10)
/NOOPTIMIZE /NOSEARCH /NOSYMBOLS(20)
/OPTIMIZE /OLD(10) /PASCAL(20)
/REL(10) /RELOCATABLE(20) /SAIL(20)
/SAVE(10) /SEARCH /SELF(10)
/SIMULA(20) /SNOBOL /SSAVE(10)
/SYS(10) /STAY(20) /SYMBOLS(20)
7
.CONTINUE
@CONTINUE (PROGRAM) NORMALLY
Resumes execution of a program that is halted and restores your
terminal to user level.
.COPY new-filespec=old-filespec-1,old-filespec-2,...
Copies files from one device or directory to another. If you omit the
new file name, the new file is written to your directory on DSK:. The
new file will have the same file name and extension as the old file
and also the default protection code.
@COPY (FROM) source filespec list (TO) destination filespec,
@@subcommand
Copies files from one device or directory to another. If you omit the
destination filespec, the new file will have the same file name and
extension as the old file but in your connected directory, if
necessary using the next higher generation number.
Subcommands:
ASCII(20) BINARY(20)
BYTE(20) IMAGE-MODE(20)
.CORE memory
Changes the amount of memory assigned to your job. If you omit the
argument, the monitor displays your current memory assignment on your
terminal.
There is no comparable TOPS-20 command.
8
.CPUNCH job=filespec/switches,filespec/switches,...
Makes entries in the card punch output queue. If you omit job=, the
default is the name of the first file in the request. To see the jobs
in the card punch queue, use the CPUNCH command with no arguments or
switches. To create a file containing the names of the jobs in the
queue, type the output file name instead of the job name, and use the
/LIST switch.
@PUNCH (ONTO) CARD (FILES) /switch(es) filespec/switch(es),...
Makes entries in the card punch output queue. File switches placed
before all files in the command line act as defaults for all;
otherwise they affect only the nearest preceding file. To see a list
of jobs in the TOPS-20 card punch queue, use:
INFORMATION (ABOUT) OUTPUT-REQUESTS.
Switches:
/ABEFORE:date-time(10) (J)/ACCOUNT:(20) /AFTER:date-time(10)
(J)/AFTER:(20) /ASINCE:date-time(10) /BEFORE:date-time(10)
/COPIES:n /CREATE(10) /DELETE
(J)/DESTINATION-NODE:(20) /DISPOSE:arg(10) /ERBINARY(10)
/ERNONE(10) /ERPROTECTION(10) /FAST(10)
/FILE:arg(10) /FORMS:arg(10) (J)/FORMS:(20)
(J)/GENERIC(20) /HEADER:arg(10) /HEADER(20)
/HELP:arg(10) (J)/JOBNAME:(20) /JOBNAME:name(10)
/KILL(10) (J)/LIMIT:(20) /LIMIT:n(10)
/LIST:arg(10) (J)/METERS:(20) /MODE(20)
/MODIFY(10) /NEW(10) /NOHEADER
/NONEW(10) /NONULL(10) /NOOPTION(10)
/NOPHYSICAL(10) /NOREMOVE(10) /NOSTRS(10)
(J)/NOTE:(20) /NOTE:text(10) (J)/NOTIFY:(20)
/NULL(10) /OKNONE(10) /OKPROTECTION(10)
/OPTION:name(10) /PHYSICAL(10) /PRESERVE
(J)/PRIORITY:(20) /PRIORITY:n(10) /PUNCH:arg(10)
/REMOVE(10) /RUN:n(10) /RUNCORE:n(10)
/RUNOFFSET:n(10) (J)/SEQUENCE:(20) /SEQUENCE:n(10)
/SINCE:date-time(10) /STRS(10) (J)/UNIT(20)
(J)/USER:(20)
9
.CREF filespec
Prints the cross-referenced listing file generated for the specified
file by a previous COMPILE-class command containing the /CREF switch.
If you omit the file specification, the system uses the file specified
in the previous COMPILE-class command, (if any). If you type the file
name but omit the file extension, the default is .CRF.
@CREF destination filespec=source filename
Runs the CREF program, which produces a cross-reference listing(s)
from files of type .CRF. If you have files of type .CRF produced by
LOAD-class commands during the current terminal session, the
unmodified command CREF produces listings of them and deletes the
files. By supplying an argument, you can copy the listing for a
current .CRF file to another file or device.
Switches:
1A(20) 1B(20) 1C(20) 1D(20) 1H(20)
1K(20) 1M(20) 1O(20) 1P(20) 1R(20)
1S(20) 1W(20) 1Z(20)
.CSTART addr
Begins execution of a program at the specified address and leaves your
terminal at monitor level. If you omit the address argument,
execution starts at the beginning of the program.
For the comparable TOPS-20 command, see the TOPS-20 START command
listed under .START.
10
.D lh rh addr
Modifies the contents of a specific memory location. The arguments in
octal are placed in the left half(lh) and the right half (rh) of the
word. You must specify both the left and right halves. If you omit
the address argument, the values are deposited in the address
specified in a previous E command, or in the location after the
address specified in a previous D command. The address is taken from
the D or E command used most recently.
@DEPOSIT (MEMORY LOCATION) octal address (CONTENTS) octal number
Modifies the contents of a specific memory location. If you omit the
address argument, the values are deposited in the address specified by
your most recent EXAMINE command. You must press the ESCAPE key to
take this default.
.DAYTIME
@DAYTIME
Displays today's date and the time on your terminal. TOPS-20 also
displays the day of the week.
.DCORE filespec
Writes a core dump of your memory without changing the state of your
memory area. If you omit the file specification, the default is
DSK:nnnDAE.TMP, where nnn is your job number.
There is no comparable TOPS-20 command for the unprivileged user.
11
.DDT
Starts execution of the currently loaded debugging program. If no
debugger is currently loaded, this command loads and starts VMDDT.
@DDT/switch
Loads or merges a debugging program and then starts your program.
Switch:
/USE-SECTION(20)
.DEASSIGN dev:
@DEASSIGN (DEVICE) dev:
Releases the device from your job and places the device in the
system's pool of available resources.
12
.DEBUG filespec/switches,filespec/switches,...
@DEBUG (FROM) /switch(es) source/switch(es) object,...
Loads and starts your program with an appropriate debugging program.
For TOPS-10, if you omit the file specification and switches, the
system uses the arguments specified in a previous COMPILE-class
command, (if any). For TOPS-20, if you omit the source and object
filespecs, the system uses the filespecs and associated switches
specified in a previous LOAD-class command.
Switches:
/68-COBOL(20) /74-COBOL(20) /ALGOL
/BINARY /BLISS /C68(10)
/C74(10) /COBOL /COMPILE
/CREF /DDT /DEBUG:arg
/DLIST(10) /FAIL(20) /FORTRAN
/FORDDT(10) /FUDGE:file(10) /KI10(10)
/KL10(10) /KS10(10) /LANGUAGE-SWITCHES:(20)
/LIBRARY /LIST /LMAP:file(10)
/MACRO /MACY11(10) /MANTIS(10)
/MAP:file /NEW(10) /NOBINARY
/NOCOMPILE /NOCREF(20) /NODEBUG
/NOLIBRARY(20) /NOLIST /NOMANTIS(10)
/NOOPTIMIZE /NOSEARCH /NOSYMBOLS
/OPTIMIZE /OLD(10) /PASCAL(20)
/REL(10) /RELOCATABLE(20) /SAIL(20)
/SAVE(10) /SEARCH /SELF(10)
/SIMULA(20) /SNOBOL(10) /SSAVE(10)
/STAY(20) /SYMBOLS(20) /SYS(10)
13
.DELETE filespec,filespec,...
Deletes the specified file(s) from the directory area.
@DELETE (FILES) filespec,...,
@@subcommand
Marks files for deletion. When you give the EXPUNGE command, the
specified files are immediately deleted from your directory.
Subcommands:
ARCHIVE(20) CONTENTS-ONLY(20)
DIRECTORY(20) EXPUNGE(20)
FORGET(20) KEEP(20)
.DETACH
@DETACH (AND) {CONTINUE, REENTER or START}
Disconnects your terminal from the current job.
14
.DIRECTORY output-filespec=input-filespec/switches
@DIRECTORY (OF FILES) filespec,...
@@subcommand
Displays information about the files in a specified directory.
TOPS-10 displays the directory entry from the specified input file in
the specified output file. If you omit the output filespec and the
equal sign, the entrys are displayed on your terminal. If you omit
the input filespec, the entries for all files in your default
directory are displayed.
Switches and Subcommands:
/ABEFORE:date-time(10) /ACCESS:n(10) ACCOUNT(20)
/ACCOUNT(10) /ALLOCATED(10) ARCHIVED(20)
/ASINCE:date-time(10) /AUTHOR(10) BEFORE(20)
/BEFORE:date-time(10) /BLOCKS(10) CHECKSUM(20)
/CHECKSUM(10) CHRONOLOGICAL(20) /COMPARE(10)
CRAM(20) DATES(20) DELETED(20)
/DENSITY:n(10) /DETAIL(10) /DIRECT(10)
DOUBLESPACE(20) /EOTS(10) /ERLOG(10)
/ERNONE(10) /ERPROTECTION(10) /ERSUPERSEDE(10)
/ESTIMATE:n(10) EVERYTHING(20) /FAST(10)
/FDTA(10) /FILES:n(10) FIND(20)
/FIND(10) /FLSDIR(10) /FNDBLD(10)
/FNDDAT:file(10) GENERATION-RETENTION-COUNT(20) /HDSDIR(10)
HEADING(20) /HELP:arg(10) /INDIRECT(10)
INVISIBLE(20) LARGER(20) LENGTH(20)
/LENGTH:m:n(10) LPT(20) /LIST(10)
/MARKS(10) /MESSAGE:arg(10) /MVOLUME(10)
NO(20) /NOAUTHOR(10) /NOCHECKSUM(10)
/NOCOMPARE(10) /NODETAIL(10) /NOEOTS(10)
/NOERLOG(10) /NOFDTA(10) /NOFIND(10)
/NOFLSDIR(10) /NOFNDBLD(10) /NOHDSDIR(10)
/NOINDIRECT(10) /NOMARKS(10) /NOMVOLUME(10)
/NOOPTION(10) /NOPRDEVICE(10) /NOPRDIRECT(10)
/NOPRVERSION(10) /NORETRY(10) /NOREWIND(10)
/NORMAL(10) /NOSORT(10) /NOSUMMARY(10)
/NOTITLE(10) /NOUNITS(10) OFFLINE(20)
/OKNONE(10) /OKPROTECTION(10) /OKSUPERSEDE(10)
ONLINE(20) /OPTION:name(10) OUTPUT(20)
/PARITY:arg(10) /PHYSICAL(10) /PRDEVICE(10)
/PRDIRECTORY(10) PROHIBIT-MIGRATION(20) PROTECTION(20)
/PROTECTION:n(10) /PRVERSION(10) RESIST-MIGRATION(20)
/RETRY(10) REVERSE(20) /REWIND(10)
/RUN:file(10) /RUNOFFSET:n(10) SEPARATE(20)
SINCE(20) /SINCE:arg(10) SIZE(20)
/SLOW(10) SMALLER(20) /SORT(10)
/STRS(10) /SUMMARY(10) TIMES(20)
15
/TITLE(10) /TMPFIL(10) /UNITS(10)
USER(20) /VERSION:n(10) /WIDTH:n(10)
16
.DISABLE
Returns the status of privileged jobs to normal unprivileged state.
Privileges are automatically enabled when you log in.
@DISABLE (CAPABILITIES)
Disables all special capabilities you may have specifically enabled
with the ENABLE command.
.DISMOUNT dev:/switches
@DISMOUNT {STRUCTURE or TAPE} (NAME) dev:/switch(es)
Gives up access to a mounted structure or tape set.
Switches:
/CHECK(10) /HELP:arg(10) /KEEP(10)
/NOWAIT /REASSIGN:n(10) /RELEASE(10)
/REMARK(20) /REMOVE /REWIND(10)
/STAY(10) /STRUCTURE-ID(20) /UNLOAD(10)
/VID:"text"(10) /WAIT(10)
.DSK jobn
Displays disk usage statistics for the specified job on your terminal.
If you omit the job number, statistics are displayed for the job to
which your terminal is currently attached.
@INFORMATION (ABOUT) DISK-USAGE dev:<directory>
Prints for the indicated directory, the number of pages of assigned
disk storage, the number of deleted pages, working and permanent page
limits, and the total number of unused pages on the file structure
containing the directory.
17
.DUMP/command/command...
Creates a file of the memory area, analyzes the file, and provides
printable output. The argument /command is one or more DUMP commands
that are passed to the DUMP program.
There is no comparable TOPS-20 command for the unprivileged user.
.E addr
Displays the contents of a specific memory location in octal on your
terminal. If you omit the address, the address of either a previous D
command or the location after the address of a previous E command is
displayed.
@EXAMINE (MEMORY LOCATION) octal or symbolic address
Displays the contents of a specific memory location. If you omit the
address, the contents of either the last address examined increased by
1 or the address of a more recent DEPOSIT command is displayed.
.ENABLE
@ENABLE (CAPABILITIES)
Enables any special capabilities you may have.
.EOF MTxnnu
@EOF (DEVICE) dev:
The EOF command writes an end-of-file mark on the specified magnetic
tape.
18
.EXECUTE filespec/switches,filespec/switches,...
@EXECUTE (FROM) /switch(es) source/switch(es) object,...
Loads, compiles (if necessary), and starts your program.
Switches:
/68-COBOL(20) /74-COBOL(20) /ALGOL
/BINARY /BLISS /C68(10)
/C74(10) /COBOL /COMPILE
/CREF /DDT /DEBUG:arg
/DLIST(10) /FAIL(20) /FORTRAN
/FORDDT(10) /FUDGE:file(10) /KI10(10)
/KL10(10) /KS10(10) /LANGUAGE-SWITCHES:(20)
/LIBRARY /LIST /LMAP:file(10)
/MACRO /MACY11(10) /MANTIS(10)
/MAP:file /NEW(10) /NOBINARY
/NOCOMPILE /NOCREF(20) /NODEBUG
/NOLIBRARY(20) /NOLIST /NOMANTIS(10)
/NOOPTIMIZE /NOSEARCH /NOSYMBOLS(20)
/OPTIMIZE /OLD(10) /PASCAL(20)
/REL(10) /RELOCATABLE(20) /SAIL(20)
/SAVE(10) /SEARCH /SELF(10)
/SIMULA(20) /SNOBOL /SSAVE(10)
/STAY(20) /SYMBOLS(20) /SYS(10)
.FILE arg
Provides remote control of DECtape to disk and disk to DECtape
transfers.
Arguments:
C(10)
D,tape-id,filespec,filespec,...(10)
F,tape-id,filespec,filespec,...(10)
L,tape-id(10)
R,tape-id,filespec,filespec,...(10)
W(10)
Z,tape-id,filespec,filespec,...(10)
There is no comparable TOPS-20 command.
19
.FINISH dev:
Terminates I/O on the specified device, closes any open files, and
deassigns the device. If you omit dev:, all device I/O that is
currently in progress ends except the I/O intended for your job's
terminal.
For the comparable TOPS-20 command, see the TOPS-20 DEASSIGN command
listed under .DEASSIGN.
.FUDGE
Creates a library .REL file by reading a temporary file. The
temporary file is generated by a previous COMPILE-class command line
containing the /FUDGE switch.
There is no comparable TOPS-20 command.
.GET filespec memory
@GET (PROGRAM) filespec/switch
Places an executable program in memory.
Switch:
/USE-SECTION(20)
.HALT
<CTRL/C>
@<CTRL/C>
Stops execution in your memory area without changing it and immediatly
puts you at monitor/command level. Continue the program with the
CONTINUE command.
20
.HELP lib:name
Displays information about the specified system feature on your
terminal.
The argument lib: is one of the following:
HLP: DOC: SYS:
NEW: OLD:
@HELP system-program-name
Displays information about the specified system feature. For
information on system commands, type a question mark (?) after the @
system prompt.
.INITIA arg arg...
Sets terminal characteristics and displays the system name, file
structure name, terminal characteristics, and other information, based
on the arguments you specify.
Arguments:
BATCH HELP KSYS
NAME NORUN NOTICE
SETTTY STRUCTURES TERMINAL
TERMINET TEXT
You can type NO before any of the above arguments except NORUN to turn
off the function of the argument.
For the comparable TOPS-20 command, see the TOPS-20 SET TERMINAL
command listed under .SET TERMINAL.
.JCONTINUE jobn
Continues the specified job if it is in an operator wait state because
of a device error.
There is no comparable TOPS-20 command.
21
.KJOB/switch
@LOGOUT n
Ends a timesharing job. For TOPS-20 n is the job number (defaults to
the current job number).
Switches:
/FAST(10) /BATCH(10) /HELP(10)
/NOMESSAGE(10)
.LABEL dev:"name"
Writes the identifier ("name") onto a DECtape. You can use any
non-alphanumeric character for the delimiter ("), or you can omit the
delimiter if the name is only alphanumeric characters. The name is
one to six alphanumeric characters.
There is no comparable TOPS-20 command.
.LIST filespec,filespec,...
Prints the specified files on the line printer. You should use SET
SPOOL LPT: or assign a line printer to your job before using the LIST
command.
For the comparable TOPS-20 command, see the TOPS-20 PRINT command
listed under .PRINT.
22
.LOAD filespec/switches,filespec/switches,...
@LOAD (FROM) /switch(es) source/switch(es) object,...
Loads your program into memory, compiling the source file first, if
necessary.
Switches:
/68-COBOL(20) /74-COBOL(20) /ALGOL
/BINARY /BLISS /C68(10)
/C74(10) /COBOL /COMPILE
/CREF /DDT /DEBUG:arg
/FAIL(20) /FORTRAN /FORDDT(10)
/FUDGE:file(10) /KI10(10) /KL10(10)
/KS10(10) /LANGUAGE-SWITCHES:(20) /LIBRARY
/LIST /LMAP:file(10) /MACRO
/MACY11(10) /MANTIS(10) /MAP:file
/NEW(10) /NOBINARY /NOCOMPILE
/NOCREF(20) /NODEBUG /NOLIBRARY(20)
/NOLIST /NOMANTIS(10) /NOOPTIMIZE
/NOSEARCH /NOSYMBOLS(20) /OLD(10)
/OPTIMIZE /PASCAL(20) /REL(10)
/RELOCATABLE(20) /SAIL(20) /SAVE(10)
/SEARCH /SELF(10) /SIMULA(20)
/SNOBOL /SSAVE(10) /STAY(20)
/SYMBOLS(20) /SYS(10)
.LOCATE node-id
Sets the ANF-10 remote station at which your job is considered to be
running. If you do not specify the node-id, the default is the node
to which your terminal is connected.
@SET LOCATION node name::
Sets the DN200 node or IBM-type node remote station at which your job
is considered to be running. Printer output is sent to this node
unless you specifically direct it elsewhere by the /DESTINATION-NODE
switch.
23
.LOGIN ppn/switches
@LOGIN (USER) user name (PASSWORD) password (ACCOUNT) account name
(SESSION REMARK) session remark
Begins your timesharing job, and connects you to and accesses your
log-in directory. For TOPS-10, if you do not specify your
project-programmer number (PPN) in the command line, LOGIN prompts you
with a # on the next line. You must type your PPN here. However, you
can use a directory instead of the PPN to establish a default
directory for the job. LOGIN then prompts you for your password.
Switches:
/ASSIGN:dev:logical-name(10) /ATTACH:arg(10) /CORE:memory(10)
/DEFER(10) /DEFPROT:nnn(10) /DSKFUL:arg(10)
/DSKPRI:n(10) /GUIDELINE(10) /HELP(10)
/LIMIT(10) /MESSAGE:arg(10) /NAME:name(10)
/NEW(10) /NONEW(10) /NOOPTION(10)
/NOSCAN(10) /NOSETTTY(10) /NOSTR(10)
/NOSYS(10) /NOTE:file(10) /NOTICE:arg(10)
/NOWATCH(10) /OPTION:name(10) /PATH:[dir](10)
/PHYSICAL:memory(10) /QUOTA:str(10) /RUN:file(10)
/RUNCORE:n(10) /RUNOFFSET:n(10) /SCAN(10)
/SETTTY(10) /SFDPROT:nnn(10) /SPOOL:arg(10)
/STR(10) /SYS(10) /TERMINAL:(arg,arg,...)(10)
/TIME:n(10) /UFDPROT:nnn(10) /VIRTUAL:memory(10)
/WATCH:arg(10)
24
.MAKE filespec
Creates a file using the TECO text editor and leaves your job at user
level.
(To start SOS text editor, type SOS, then press the RETURN key.)
@CREATE (FILE) /switch(es) filespec
Creates files with the editor of your choice. To establish the editor
program (EDIT or TV) you want to use, type:
DEFINE (LOGICAL NAME) EDITOR: (AS) SYS: {EDIT or TV}
Switches:
/BAK(20) /C128(20) /C64(20) /DECIDE(20)
/DPY(20) /EXPERT(20) /INCREMENT:(20) /ISAVE:(20)
/LOWER(20) /M33(20) /M37(20) /NOBAK(20)
/NODECIDE(20) /NOSEPARATORS(20) /NONUMBER(20) /NOVICE(20)
/NUMBER(20) /OLD(20) /OPTION:(20) /PLINES:(20)
/R(20) /READONLY(20) /RONLY(20) /RUN:(20)
/SAVE:(20) /SEPARATORS(20) /SEQUENCE(20) /START:(20)
/STEP:(20) /UNSEQUENCE(20) /UPPER(20) /WINDOW:(20)
.MERGE filespec memory
Combines the low segment of the specified file with the program
currently in memory. If you omit the memory argument, the minimum
amount of necessary memory is used.
@MERGE (PROGRAM) program name/switch
Places an executable program in memory, combining it with whatever
program (if any) is already there.
Switch:
/USE-SECTION(20)
25
.MOUNT dev:logical-name/switches(drives)
@MOUNT {STRUCTURE or TAPE} (NAME) name:/switch(es)
Requests that a specific file structure or magnetic tape be made
available to your job.
Switches:
/ACTIVE(10) /CHECK(10) /CHECK-SETNAME(20)
/CREATE(10) /DENSITY:(20) /DRIVE-TYPE:(20)
/HELP(10) /LABEL-TYPE:(20) /MULTI(10)
/NEW(20) /NOCREATE(10) /NOSHOVE(10)
/NOUNLOAD(20) /NOWAIT /OPERATOR(20)
/PASSIVE(10) /PAUSE(10) /PROTECTION:(20)
/READ-ONLY(20) /REELID:name(10) /REMARK:(20)
/RONLY(10) /SCRATCH(20) /SHOVE(10)
/SINGLE(10) /START:(20) /STRUCTURE-ID:(20)
/VID:"text"(10) /VOLIDS:(20) /WAIT(10)
/WENABLE(10) /WLOCK(10) /WRITE:arg(10)
/WRITE-ENABLED(20)
26
.NETWORK node-id-1,node-id-2,...
Displays information about the specified ANF-10, DECnet, and emulation
nodes on your terminal. If you omit the node-id, information is
displayed about every node in the network.
@INFORMATION (ABOUT) DECNET NODES
Displays the names of DECnet network and emulation nodes accessible to
your system.
Switches:
/BRIEF(10) /CDP(10) /CDR(10)
/COST(10) /DTA(10) /ERROR(10)
/HELP(10) /LPT(10) /MCR(10)
/MTA(10) /NOBRIEF(10) /NOCDP(10)
/NOCDR(10) /NOCOST(10) /NODTA(10)
/NOERROR(10) /NOHELP(10) /NOLPT(10)
/NOMCR(10) /NOMTA(10) /NOPLT(10)
/NOPTR(10) /NOPTP(10) /NORDA(10)
/NOSILENCE(10) /NOTSK(10) /NOTTY(10)
/PLT(10) /PTP(10) /PTR(10)
/RDA(10) /SILENCE(10) /SORT(10)
/TSK(10) /TTY(10) /TYPE:arg(10)
/TOPOLOGY(10)
.NODE node-id
Displays information about devices available at the specified node on
your terminal. If you omit the node-id, information is displayed
about the node to which your terminal is connected.
@INFORMATION (ABOUT) AVAILABLE DEVICES
Displays the devices available to you or already assigned to your job.
27
.PJOB jobn
Displays the job number, name, project-programmer number, and terminal
number of the specified job on your terminal. If you omit the job
number, information is displayed about the job to which your terminal
is connected.
@INFORMATION (ABOUT) JOB-STATUS
Displays the job number, name, connected directory, account, terminal
number, and network node of the specified job on your terminal.
.PLEASE dev:text
Sends the text to the operator's terminal and provides two-way
communication between you and the operator. To end communication,
press <ESC> or press <CTRL/C> twice. The dev: specification is
supplied by either of the following: TTYn: is a terminal number of
any terminal that is not attached to a job. OPRnn: is the operator's
terminal at node nn.
@PLEASE
Helps you communicate with the operator. After starting the PLEASE
program, you may communicate with the operator in a two-way
conversation. When you are done press the ESCAPE key. The system
prints the FINISHED message.
28
.PLOT job=filespec/switches,filespec/switches,...
@PLOT (FILES) /switch(es) filespec/switch(es),...
Places requests in a plotter output queue. For TOPS-10, if you omit
job=, the default job name is the name of the first file in the
request. To see a list of TOPS-10 jobs in the plotter queue, use the
PLOT command with no arguments or switches. To create a file
containing the names of the TOPS-10 jobs in the queue, type the output
file name instead of the job name, and specify the /LIST switch. To
see a list of jobs in the TOPS-20 plotter queue, use:
INFORMATION (ABOUT) OUTPUT-REQUESTS.
Switches:
/ABEFORE:date-time(10) (J)/ACCOUNT:(20) (J)/AFTER:(20)
/AFTER:date-time(10) /ASINCE:date-time(10) /BEFORE:date-time(10)
/COPIES:n /CREATE(10) /DELETE
(J)/DESTINATION-NODE:(20) /DISPOSE:arg(10) /ERBINARY(10)
/ERNONE(10) /ERPROTECTION(10) /FAST(10)
/FEET:n(10) /FILE:arg(10) (J)/FORMS:(20)
/FORMS:arg(10) (J)/GENERIC(20) /HEADER:arg
/HELP:arg(10) (J)/JOBNAME:(20) /JOBNAME:name(10)
/KILL(10) (J)/LIMIT:(20) /LIMIT:n(10)
/LIST:arg(10) /MODE(20) /MODIFY(10)
/NEW(10) /NOHEADER /NONEW(10)
/NONULL(10) /NOOPTION(10) /NOPHYSICAL(10)
/NOREMOVE(10) /NOSTRS(10) (J)/NOTE:(20)
/NOTE:text(10) /NULL(10) (J)/NOTIFY:(20)
/OKNONE(10) /OKPROTECTION(10) /OPTION:name(10)
/PHYSICAL(10) /PLOT:arg(10) /PRESERVE
(J)/PRIORITY:(20) /PRIORITY:n(10) /REMOVE(10)
/RUN:n(10) /RUNCORE:n(10) /RUNOFFSET:n(10)
(J)/SEQUENCE:(20) /SEQUENCE:n(10) /SINCE:date-time(10)
/STRS(10) (J)/UNIT:(20) (J)/USER:(20)
.PRESERVE filespec
Changes the protection code of the specified file so that the digit in
the first field (owner field) is 1.
There is no comparable TOPS-20 command.
29
.PRINT job=filespec/switches,filespec/switches,...
@PRINT (FILES) /switch(es) filespec/switch(es),...
Places requests in a printer output queue. For TOPS-10, if you omit
job=, the default job name is the name of the first file in the
request. To see a list of TOPS-10 jobs in the printer queue, type
PRINT with no arguments or switches. To create a file containing the
names of the TOPS-10 jobs in the queue, type the output file name
instead of the job name, and specify the /LIST switch. To see a list
of jobs in the TOPS-20 printer queue, use:
INFORMATION (ABOUT) OUTPUT-REQUESTS.
Switches:
/ABEFORE:date-time(10) (J)/ACCOUNT:(20) (J)/AFTER:(20)
/AFTER:date-time(10) /ASINCE:(10) /BEFORE:(10)
/BEGIN:n /COPIES:n /CREATE(10)
/DELETE (J)/DESTINATION-NODE:(20) /DISPOSE:arg(10)
/ERBINARY(10) /ERNONE(10) /ERPROTECTION(10)
/FAST(10) /FILE:arg (J)/FORMS:(20)
/FORMS:arg(10) (J)/GENERIC(20) /HEADER:arg
/HELP:arg(10) (J)/JOBNAME:(20) /JOBNAME:name(10)
/KILL(10) (J)/LIMIT:(20) /LIMIT:n(10)
/LIST:arg(10) (J)/LOWERCASE(20) /MODE:(20)
/MODIFY(10) /NEW(10) /NOHEADER
/NONEW(10) /NONULL(10) /NOOPTION(10)
/NOPHYSICAL(10) /NOREMOVE(10) /NOSTRS(10)
(J)/NOTE:(20) /NOTE:text(10) (J)/NOTIFY:(20)
/NULL(10) /OKBINARY(10) /OKNONE(10)
/OKPROTECTION(10) /OPTION:name(10) /PHYSICAL(10)
/PRESERVE /PRINT:arg(10) (J)/PRIORITY:(20)
/PRIORITY:n(10) /REMOVE(10) /REPORT:code
/RUN:n(10) /RUNCORE:n(10) /RUNOFFSET:n(10)
(J)/SEQUENCE:(20) /SEQUENCE:n(10) /SINCE:date-time(10)
/SPACING:arg /STRS(10) (J)/UNIT:(20)
(J)/UPPERCASE(20) (J)/USER:(20)
30
.PROTECT filespec<nnn>,filespec<nnn>,...
Assigns the specified protection codes to the specified files. Every
file has a protection code. The code tells who can and cannot access
the file. The protection code consists of three octal digits. Each
digit specifies the amount of protection against a group of users.
The first (leftmost) digit is the protection code for the owner of the
file; the middle digit is the protection code for all users having
the same project number as the file owner; the last (rightmost) digit
is the protection code for all other users.
@SET FILE PROTECTION filespecs octal protection code
Sets, for the specified files, a protection code constructed (by
addition) from the following octal values.
77 Full access to the file
40 Read the file
20 Write and delete the file
10 Execute the program contained in the file
04 Append to the file
02 List the file specification using DIRECTORY-CLASS
commands
00 No access to the file.
.QUEUE queue-name:job=filespec/switches,filespec/switches,...
Makes entries in the specified system queue.
Queue Names:
CDP: PLT: LPT:
INP: PTP:
If you omit the queue name, it defaults to LPT:. If you omit job=,
the job name defaults to the name of the first file in the request.
To create a batch job, specify the control file followed by the log
file. To see a list of all the jobs in all the system queues, type
QUEUE with no arguments or switches. To create a file containing the
names of the jobs in the queues, type the output file name instead of
the job name, and specify /LIST switch.
31
Equivalent of QUEUE CDP:
@PUNCH (ONTO) CARD (FILES) /switch(es) filespec/switch(es),...
Places requests in a card punch output queue. To see a list of jobs
in the TOPS-20 card punch output queue, use:
INFORMATION (ABOUT) OUTPUT-REQUESTS.
For PUNCH (ONTO) CARD switches see below.
Equivalent of QUEUE PTP:
@PUNCH (ONTO) PAPER-TAPE (FILES) /switches(es) filespec/switch(es),...
Places requests in a paper-tape-punch output queue. To see a list of
jobs in the TOPS-20 paper-tape-punch output queue, use;
INFORMATION (ABOUT) OUTPUT-REQUESTS.
For PUNCH (ONTO) PAPER-TAPE switches see below.
Switches:
/ABEFORE:date-time(10) (J)/ACCOUNT:(20) (J)/AFTER:(20)
/AFTER:date-time(10) /ASINCE:date-time(10) /BEFORE:date-time(10)
/BEGIN:n(10) /CARDS:n(10) /COPIES:n
/CORE:n(10) /CREATE(10) /DELETE
/DEPEND:n(10) (J)/DESTINATION-NODE:(20) /DISPOSE:arg(10)
/ERBINARY(10) /ERNONE(10) /ERPROTECTION(10)
/FAST(10) /FEET:n(10) /FILE:arg(10)
(J)/FORMS:(20) /FORMS:arg(10) (J)/GENERIC(20)
/HEADER:arg /HELP:arg(10) (J)/JOBNAME:name(10)
/JOBNAME:(10) /KILL(10) (J)/LIMIT:(20)
/LIMIT:n(10) /LIST:arg(10) (J)/METERS:(20)
/METERS:n(10) /MODE:(20) /MODIFY(10)
/NEW(10) /NOHEADER /NONEW(10)
/NONULL(10) /NOOPTION(10) /NOPHYSICAL(10)
/NOREMOVE(10) /NORESTART(10) /NOSTRS(10)
(J)/NOTE:(20) /NOTE:text(10) (J)/NOTIFY:(20)
/NULL(10) /OKBINARY(10) /OKNONE(10)
/OKPROTECTION(10) /OPTION:name(10) /OUTPUT:arg(10)
/PAGE:n(10) /PATH:[dir](10) /PHYSICAL(10)
/PLOT:arg(10) /PRESERVE /PRINT:arg(10)
(J)/PRIORITY:(20) /PRIORITY:n(10) /PUNCH:arg(10)
/REMOVE(10) /REPORT:code(10) /RESTARTABLE(10)
/RUN:n(10) /RUNCORE:n(10) /RUNOFFSET:n(10)
(J)/SEQUENCE:(20) /SEQUENCE:n(10) /SINCE:date-time(10)
/SPACING:arg(10) /STRS(10) /TAG:label(10)
/TAPE:arg(10) /TIME:time(10) /TPLOT:arg(10)
/UNIQUE:arg(10) (J)/UNIT:(20) (J)/USER:(20)
32
.QUEUE PLT:job=filespec/switches,filespec/switches,...
@PLOT (FILES) /switch(es) filespec/switch(es),...
Places requests in the plotter output queue.
For the comparable TOPS-20 command and appropriate switches see the
TOPS-20 PLOT command listed under .PLOT.
.QUEUE LPT:job=filespec/switches,filespec/switches,...
@PRINT (FILES) /switch(es) filespec/switch(es),...
Places requests in the print queue.
For the comparable TOPS-20 command and appropriate switches see the
TOPS-20 PRINT command listed under .PRINT.
.QUEUE INP:job=filespec/switches,filespec/switches,...
@SUBMIT (BATCH JOB) /switch(es) filespec/switch(es),...
Enters a job(s) into the batch input queue.
For the comparable TOPS-20 command and appropriate switches see the
TOPS-20 SUBMIT command listed under .SUBMIT.
.R filespec memory
@R (PROGRAM) filespec/switch
Places in memory the specified executable program from SYS: and
starts it.
Switch:
/USE-SECTION(20)
33
.REASSIGN dev:jobn
Reassigns the specified device to the specified job. If you omit the
job number, the device is assigned to your current job.
There is no comparable TOPS-20 command.
.REENTER
@REENTER (PROGRAM)
Starts your currently loaded program at its alternate entry point if
it has one.
.RENAME new-filespec = old-filespec
@RENAME (EXISTING FILE) old-filespec (TO BE) new-filespec
Changes the name of a file. Note that the arguments are specified in
reverse between the two systems.
.RESOURCES
Displays on your terminal the names of all devices (except terminals
and pseudo-terminals), all file structures, and all physical units
that are part of the system resource pool.
@INFORMATION (ABOUT) AVAILABLE DEVICES
Lists the devices available to you or already assigned to your job.
34
.REWIND dev:
@REWIND (DEVICE) dev: /switch
Rewinds a magnetic tape.
Switches:
/CURRENT-VOLUME-ONLY(20) /ENTIRE-VOLUME-SET(20)
.RUN filespec memory
@RUN (PROGRAM) filespec/switch
Places an executable program from your directory in memory and starts
it.
Switch:
/USE-SECTION(20)
.SAVE
@CSAVE (ON FILE) filespec (WORDS FROM) n1 (TO) n2, n3 n4,...
n1 n2, n3 n4, are pairs of octal numbers that specify the span of
memory pages you want to save
Saves a non-sharable copy of the program in memory in a file, in a
compressed executable format.
35
.SSAVE filespec memory
@SAVE (ON FILE) filespec (PAGES FROM) n1 (TO) n2, n3 n4,...
n1 n2, n3 n4, are pairs of octal numbers that specify the span of
memory pages you want to save
Stores a sharable copy of memory in a file in an executable format.
.SCHED
Displays on your terminal the schedule bits set by the operator.
There is no comparable TOPS-20 command.
.SEND arg text
Sends the text to the specified user. The arguments are:
TTYn:(10) JOB n(10) OPR:(10) OPRnn:(10)
@TALK (TO) user name or terminal number
Links your terminal to another user's terminal.
.SET BLOCKSIZE MTxnnu:n
Sets the block size in words for the specified magnetic tape. The
block size (n) is any number from 3 to 4094.
@SET TAPE RECORD-LENGTH n
Sets the size, in bytes, for each physical record on magnetic tape.
36
.SET BREAK AT addr ON condition AFTER n
Sets address break locations in programs according to specified
conditions. AT, ON, and AFTER are optional portions of the command
line. AFTER n indicates the number of times the sequence is to be
followed before the break occurs. You can use one of the following
lines to remove a condition(s):
SET BREAK NO condition
SET BREAK NONE
The possible conditions are:
ALL
EXECUTE
MUUO
READ
WRITE
@SET ADDRESS-BREAK octal or symbolic memory location
Causes the program in memory to be suspended and a message to be
displayed on your terminal when the memory location you specify is
referenced for the indicated operation - EXECUTE, READ, WRITE, or any
of these (ALL).
Subcommands:
AFTER n(20)
ALL(20)
EXECUTE(20)
NONE(20)
READ(20)
WRITE(20)
.SET CDR name
Sets the file name for the next card reader job. The default file
extension is .CDR. The name is one to three alphanumeric characters.
@SET CARD-READER-INPUT-SET name of input set n
Used by the batch system to associate the indicated set of punch
cards, beginning with deck n, with system device CDR:
37
.SET CPU CPan
Adds the specified processor to the list of processors on which your
job can run. This command requires that privileges be enabled for
your job. The letter "a" must be replaced by one of the following:
U to specify a logical name.
I to specify a KI10 processor.
L to specify a KL10 processor.
The value n is any number from 0 to the number of processors on the
system minus one. You can use any of the following constructions:
SET CPU ALL
SET CPU NO CPan
SET CPU ONLY CPan
There is no comparable TOPS-20 command.
.SET DEFAULT BUFFERS n
Sets the number of disk buffers that can be used for your program to
n. If you specify 0 for n, the default number of buffers is used.
The default number for disk is 6. For all other devices, the default
number of buffers is 2.
There is no comparable TOPS-20 command.
.SET DEFAULT PROTECTION arg
@SET DIRECTORY FILE-PROTECTION-DEFAULT dev:<directory> octal code
Sets a default protection code governing access to files subsequently
created in the directory.
38
.SET DEFER
@SET SPOOLED-OUTPUT DEFERRED
Directs the system to defer processing your spooled output requests
until log-out. To set the spooled output to be completed immediately,
use SET NO DEFER(10) for TOPS-10 and IMMEDIATE(20) for TOPS-20. The
default functions are SET NO DEFER(10) and IMMEDIATE(20).
.SET DENSITY MTxnnu:density
@SET TAPE DENSITY setting
Sets the density for the specified magnetic tape.
Densities:
200 556 800 1600 6250
.SET DSKFUL arg
Controls the monitor's action on the job when you have exhausted your
disk space.
Arguments:
ERROR(10) PAUSE(10)
There is no comparable TOPS-20 command.
.SET DSKPRI n
Sets the priority for the job's disk I/O operations. The value n is
any number from -3 to +3. The system default is 0.
There is no comparable TOPS-20 command.
39
.SET FLOATING POINT SIMULATION
On KL-based systems, sets the system to simulate KA10 floating point
instructions.
There is no comparable TOPS-20 command.
.SET HOST node-id
@SETHOST node-id
The SET HOST command in TOPS-10 connects your terminal to another
system in the ANF-10 network. In TOPS-20 the SETHOST command connects
your terminal to another system in the DECnet network. In TOPS-10 you
do not need to be logged-in to use this command but you must be
logged-in to use this command in TOPS-20.
.SET HPQ n
Sets your job's priority in the high-priority scheduler run queue.
The value n is a number from 1 to 15. This command requires that
privileges be enabled for your job.
There is no comparable TOPS-20 command.
.SET PHYSICAL arg memory
Sets the maximum physical page limit and paging guideline for your
job. To set the limit, use LIMIT for arg. To set the guideline, use
GUIDELINE for arg. If you omit the argument it defaults to GUIDELINE.
There is no comparable TOPS-20 command.
40
.SET RETRY MTxnnu: arg
Controls error recovery by the DX10 magnetic tape controller. The
argument is either OFF or ON. If you specify ON, the DX10 recovers on
soft errors, and reports both soft and hard errors. If the argument
is OFF, the DX10 does no error recovery, and all errors are reported
as hard errors.
There is no comparable TOPS-20 command.
.SET SPOOL dev:,dev:,...
Changes the list of spooled devices for your job.
Devices:
CDP:(10) CDR:(10) LPT:(10)
PLT:(10) PTP:(10)
You can also use one of the following formats:
SET SPOOL ALL
SET SPOOL NO dev:
SET SPOOL NONE
There is no comparable TOPS-20 command.
41
.SET TERMINAL arg arg...
@TERMINAL (MODE IS) argument
Specifies the characteristics of your terminal. In TOPS-10 you can
omit the word SET, and you can use TTY instead of TERMINAL. You can
use the terminal type as an argument. To obtain the opposite effect
of an argument, type NO before the argument.
Arguments:
33(20) 35(20) 37(20)
ALTMODE(10) BLANKS(10) COPY(10)
CRLF(10) DAS21(10) DEBREAK(10)
DEFER(10) DISPLAY(10) ECHO(10)
ELEMENT:(10) EXECUPORT(20) FILL:n(10)
FLAG(20) FORM(10) FORMFEED(20)
FULLDUPLEX(20) GAG(10) HALFDUPLEX(20)
HELP(20) HOLD(10) IMMEDIATE(20)
INDICATE(20) LA30 LA34(10)
LA36 LA38 LA120
LC(10) LENGTH(20) LINE-HALFDUPLEX(20)
LOWERCASE(20) NO(20) PAGE
PAUSE(20) RAISE(20) RTCOMPATIBILITY(10)
SPEED:n SYSTEM-DEFAULT(20) TAB(10)
TABS(20) TERMINET(20) TI(20)
TTY(10) TTY33(10) TTY35(10)
TYPE:arg(20) VK100(20) VT05
VT06(10) VT50 VT52
VT61(10) VT100 VT125(20)
WIDTH:n(20) 2741(10)
.SET TIME n
@SET TIME-LIMIT n
Sets the CPU time limit for your job. The value n is the number of
CPU seconds your job can use.
42
.SET TTY
See the TOPS-10 SET TERMINAL and the accompanying TOPS-20 TERMINAL
commands.
.SET VIRTUAL LIMIT memory
Specifies the page limit on the virtual memory for your job. If you
use 0 for memory, the system default is used. LIMIT is an optional
portion of the command line.
There in no comparable TOPS-20 command.
.SET WATCH arg,arg,...
Controls the output of automatic, incremental job statistics.
Arguments:
ALL(10) DAY(10) FILES(10)
MTA(10) NONE(10) READ(10)
RUN(10) WAIT(10) WRITE(10)
VERSION(10)
There is no comparable TOPS-20 command.
.SKIP MTxnnu: n {RECORDS, FILES or EOT}
@SKIP (DEVICE) dev: n {RECORDS, FILES or LEOT}
Moves a magnetic tape forward over a specified number of files,
records, or to the logical end of tape.
43
.START addr
@START (PROGRAM) n
n is the octal or symbolic address at which you want to start the
program
Begins execution of the program currently in memory.
.SUBMIT job=filespec,filespec/switches
@SUBMIT (BATCH JOB) /switch(es) filespec/switch(es),...
Places requests in the batch input queue. In TOPS-10, to see a list
of the batch jobs in the batch queue, type SUBMIT with no arguments or
switches. In TOPS-20, to see a list of the batch jobs in the batch
queue, type INFORMATION (ABOUT) BATCH-REQUESTS.
Switches:
/ABEFORE:date-time(10) /ACCOUNT:(20) /AFTER:date-time
/ASINCE:date-time(10) /ASSISTANCE:(20) /BATCH-LOG:(20)
/BEFORE:date-time(10) /BEGIN:n /CARDS:n
/CONNECTED-DIRECTORY:(20) /CORE:n(10) /CREATE(10)
/DELETE /DEPEND:n(10) /DEPENDENCY-COUNT:(20)
/DESTINATION-NODE:(20) /DISPOSE:arg(10) /ERBINARY(10)
/ERNONE(10) /ERPROTECTION(10 /FAST(10)
/FEET:n /HELP:arg(10) /JOBNAME:name
/KILL(10) /LIST:arg(10) /LOGDISPOSITION:(20)
/LOGNAME:(20) /METERS:n(10) /MODIFY(10)
/NEW(10) /NONEW(10) /NONULL(10)
/NOOPTION(10) /NOPHYSICAL(10) /NOREMOVE(10)
/NORESTART(10) /NOSTRS(10) /NOTIFY:(20)
/NULL(10) /OKNONE(10) /OKPROTECTION(10)
/OPTION:name(10) /OUTPUT:arg /PAGE:n(10)
/PAGES:(20) /PATH:[dir](10) /PHYSICAL(10)
/PRESERVE /PRIORITY:n /PROCESSING-NODE:(20)
/READER(20) /REMOVE(10) /RESTARTABLE:
/RUN:n(10) /RUNCORE:n(10) /RUNOFFSET:n(10)
/SEQUENCE:n /SINCE:date-time(10) /STRS(10)
/TAG:label /TIME:time /TPLOT:arg
/UNIQUE:arg /USER:(20)
44
.SYSTAT arg arg...
@SYSTAT,
Displays information about system status. The arguments or
subcommands specify the kind of information to display. If you do not
specify an argument, most of the available information is displayed.
Arguments (TOPS-10):
B Displays only status of busy (assigned) devices.
C Displays a continuous system status.
D Displays dormant segment status.
E Displays non-disk error report.
F Displays file structure status.
G Displays other system status.
H Displays information about using SYSTAT.
J Displays job status of all jobs.
L Displays the output on the line printer.
N Displays non-job status (all information except J).
P Displays disk performance statistics.
S Displays a short job status.
T Displays dataset status.
U Includes user names in job status.
V Displays paged output for display terminals.
X Reads DSK:CRASH.EXE.
n Specifies the job number of the job for which you want
information.
[ppn] Specifies a job's project-programmer number for which you
want information displayed.
. Displays information for your job.
#n Specifies a terminal number which causes information to be
displayed only for jobs to which the indicated terminal is
attached.
Subcommands (TOPS-20):
ALL CLASS CONTROLLING DIRECTORY
HEADER JOB LIMIT LINE
LPT NO OUTPUT PROGRAM
STATE SYSTEM TIME USER
WHAT WHERE WHO DIRECTORY NAME
JOB NUMBER(decimal)
45
.TECO filespec
Opens the specified file for editing with TECO. If you omit the file
specification, the argument in the last TECO or MAKE command is used.
@EDIT (FILE) /switch(es) input filespec (OUTPUT AS) output filespec
Modifies or creates a file in a directory. To establish the editor
program (EDIT or TV) you want to use, type:
DEFINE (LOGICAL NAME) EDITOR: (AS) SYS:{EDIT or TV}.EXE.
Switches:
/BAK(20) /C128(20) /C64(20) /DECIDE(20)
/DPY(20) /EXPERT(20) /INCREMENT:(20) /ISAVE:(20)
/LOWER(20) /M33(20) /M37(20) /NOBAK(20)
/NODECIDE(20) /NONSEPARATORS(20) /NONUMBER(20) /NOVICE(20)
/NUMBER(20) /OLD(20) /OPTION:(20) /PLINES:(20)
/R(20) /READONLY(20) /RONLY(20) /RUN:(20)
/SAVE:(20) /SEPARATORS(20) /SEQUENCE(20) /START:(20)
/STEP:(20) /UNSEQUENCE(20) /UPPER(20) /WINDOW:(20)
.TIME jobn
.<CTRL/T>
Displays the total and incremental run times for the specified job on
your terminal. If you omit the job number, your own job is used.
@<CTRL/T>
Displays the current time, the state of the program, the amount of
system time you used since logging in, and the load average for the
system.
46
.TPUNCH job=filespec/switches,filespec/switches,...
@PUNCH (ONTO) PAPER-TAPE (FILES) /switch(es) filespec/switch(es),...
Places requests in a paper-tape-punch output queue. In TOPS-10, if
you omit job=, the name of the first file in the request is used. To
see a list of the jobs in the TOPS-10 paper tape queue, type TPUNCH
with no arguments or switches. To create a file containing the names
of the jobs in the TOPS-10 queue, type the output file name instead of
the job name, and specify the /LIST(10) switch. To see a list of jobs
in the TOPS-20 paper tape queue, use:
INFORMATION (ABOUT) OUTPUT-REQUESTS.
Switches:
/ABEFORE:date-time(10) (J)/ACCOUNT:(20) (J)/AFTER:(20)
/AFTER:date-time(10) /ASINCE:date-time(10) /BEFORE:date-time(10)
/COPIES:n /CREATE(10) /DELETE
/DESTINATION-NODE:(20) /DISPOSE:arg(10) /ERBINARY(10)
/ERNONE(10) /ERPROTECTION(10) /FAST(10)
/FILE:arg(10) /FORMS:arg(10) (J)/FORMS:(20)
(J)/GENERIC(20) /HEADER:arg /HELP:arg(10)
/JOBNAME:name(10) (J)/JOBNAME:(20) /KILL(10)
/LIMIT:n(10) (J)/LIMIT:(20) /LIST:arg(10)
(J)/METERS:(20) /MODE:(20) /MODIFY(10)
/NEW(10) /NOHEADER /NONEW(10)
/NONULL(10) /NOOPTION(10) /NOPHYSICAL(10)
/NOREMOVE(10) /NOSTRS(10) /NOTE:text(10)
(J)/NOTE:(20) (J)/NOTIFY:(20) /NULL(10)
/OKNONE(10) /OKPROTECTION(10) /OPTION:name(10)
/PHYSICAL(10) /PRESERVE /PRIORITY:n(10)
(J)/PRIORITY:(20) /REMOVE(10) /RUN:n(10)
/RUNCORE:n(10) /RUNOFFSET:n(10) /SEQUENCE:n(10)
(J)/SEQUENCE:(20) /SINCE:date-time(10) /STRS(10)
/TAPE:arg(10) (J)/UNIT:(20) (J)/USER:(20)
.TYPE filespec,filespec,...
@TYPE (FILE) filespec,...
Displays one or more files on your terminal.
47
.UNLOAD dev:
Rewinds and unloads the specified magnetic tape or DECtape.
@UNLOAD (DEVICE) dev:
Rewinds a magnetic tape and places the tape drive offline. You cannot
use this command with a tape drive accessed by the MOUNT TAPE command.
.USESTAT
.<CTRL/T>
@<CTRL/T>
Displays information about your job on your terminal. This
information includes the state of the current program and the actual
processing time used.
.VERSION
@INFORMATION (ABOUT) VERSION
Displays on your terminal the name and version number of the program
in memory.
48
.WHERE dev:
Displays the ANF-10 node number of the specified device on your
terminal. You can see the location of the operator's controlling
terminal by using CTY: as the argument.
There is no comparable TOPS-20 command.
.ZERO dev:[dir]
Deletes all of the files in the specified directory on the specified
device. If you omit [dir], the files in the directory you are using
are deleted.
For the comparable TOPS-20 command, see the TOPS-20 DELETE command
listed under .DELETE.
49
ADDITIONAL TOPS-20 COMMANDS
This section lists and briefly explains all non-privileged TOPS-20
commands not comparable to available TOPS-10 commands, grouping them
in categories of similar use.
SYSTEM ACCESS COMMANDS
System access commands enable you to gain and relinquish access to the
system, to activate and deactivate any special capabilities you have
been given, and to engage and disengage jobs to your terminal.
@UNATTACH (USER) user name (JOB#) job number
PASSWORD:password
Disengages another job from its terminal.
FILE SYSTEM COMMANDS
File system commands enable you to create, examine, change, and delete
files.
@ACCESS (TO DIRECTORY) dev:<directory>
PASSWORD:password
Obtains ownership rights to the accessed directory, and group access
rights of the directories for the structure where the directory is
located.
50
@APPEND (SOURCE FILE) source filespec (TO) destination filespec,
Appends a file(s) to an existing file or a new file.
Subcommand:
ASCII BINARY BYTE n
IMAGE IMAGE BINARY
@ARCHIVE (FILES) filespec,...,
Stores files offline on magnetic tape.
Subcommand:
RETAIN
@BUILD (DIRECTORY NAME) str:<directory>,
Creates, modifies, or deletes a subdirectory to which you have access
rights.
Subcommands:
ABORT ABSOLUTE-ARPANET-SOCKETS
ACCOUNT-DEFAULT ARCHIVE-ONLINE-EXPIRED-FILES
ARPANET-ACCESS ARPANET-WIZARD
CONFIDENTIAL DECNET-ACCESS
DEFAULT-FILE-PROTECTION DIRECTORY-GROUP
DISABLE ENABLE
ENQ-DEQ FILES-ONLY
GENERATIONS IPCF
KILL LIST
MAINTENANCE MAXIMUM-SUBDIRECTORIES
NOT NUMBER
OFFLINE-EXPIRATION-DEFAULT ONLINE-EXPIRATION-DEFAULT
OPERATOR PASSWORD
PERMANENT PRESERVE
PROTECTION PUSH
REPEAT-LOGIN-MESSAGES SUBDIRECTORY-USER-GROUP
USER-GROUP WHEEL
WORKING
51
@CONNECT (TO DIRECTORY) dev:<directory>
PASSWORD:password
Connects your job to the specifed directory.
@DEFINE (LOGICAL NAME) name: definitions
Establishes or cancels logical names for your job.
@DISCARD (TAPE INFORMATION FOR FILES) filespec,...
Deletes the tape information of an archived file.
@END-ACCESS (TO DIRECTORY) dev:<directory>
Terminates your access rights to a specific directory.
@EXPUNGE (DIRECTORY) dev:<directory>,
Permanently erases the contents of all deleted files from your
directory, and eliminates the directory entries for all files not
marked "permanent".
Subcommands:
DELETE PURGE REBUILD
52
@FDIRECTORY (OF FILES) filespec,...,
Same as DIRECTORY command with the CRAM, EVERYTHING, and NOHEADING
subcommands.
Subcommands:
ACCOUNT ALPHABETICALLY
ARCHIVED BEFORE
CHECKSUM CHRONOLOGICAL
CRAM DATES
DELETED DOUBLESPACE
EVERYTHING FIND
GENERATION-RETENTION-COUNT HEADING
INVISIBLE LARGER
LENGTH LPT
NO OFFLINE
ONLINE OUTPUT
PROHIBIT-MIGRATION PROTECTION
RESIST-MIGRATION REVERSE
SEPARATE SINCE
SIZE SMALLER
TIMES USER
@RETRIEVE (FILES) filespec
Requests that an off-line file be restored.
53
@TDIRECTORY (OF FILES) dev:<directory> filespec,...,
Same as DIRECTORY command with the subcommands CHRONOLOGICAL, WRITE,
REVERSE, and TIMES.
Subcommands:
ACCOUNT ALPHABETICALLY
ARCHIVE BEFORE
CHECKSUM CHRONOLOGICAL
CRAM DATES
DELETED DOUBLESPACE
EVERYTHING FIND
GENERATION-RETENTION-COUNT HEADING
INVISIBLE LARGER
LENGTH LPT
NO OFFLINE
ONLINE OUTPUT
PROHIBIT-MIGRATION PROTECTION
RESIST-MIGRATION REVERSE
SEPARATE SINCE
SIZE SMALLER
TIMES USER
@UNDELETE (FILES) filespec,...
Resets the "deleted" flag for previously deleted files. You can
access an undeleted file.
54
@VDIRECTORY (OF FILES) filespec,
Same as the DIRECTORY command with the LENGTH, NO HEADING, PROTECTION,
SIZE, and TIMES subcommands.
Subcommands:
ACCOUNT ALPHABETICALLY
ARCHIVE BEFORE
CHECKSUM CHRONOLOGICAL
CRAM DATES
DELETED DOUBLESPACE
EVERYTHING FIND
GENERATION-RETENTION-COUNT HEADING
INVISIBLE LARGER
LENGTH LPT
NO OFFLINE
ONLINE OUTPUT
PROHIBIT-MIGRATION PROTECTION
RESIST-MIGRATION REVERSE
SEPARATE SINCE
SIZE SMALLER
TIMES USER
PROGRAM CONTROL COMMANDS
Program control commands help you run and debug your own program.
@FORK (IS) process number
process number is an octal number from 1 to 777
Specifies the process of your job to which subsequent TOPS-20 commands
referencing specific processes apply.
@POP (COMMAND LEVEL)
Terminates the current command level of TOPS-20 and returns you to its
superior process.
55
@PUSH (COMMAND LEVEL)
Creates a new command level of TOPS-20 inferior to the command level
from which you give the PUSH command.
@RESET
Terminates the current process and all inferior processes.
INFORMATION COMMANDS
Information commands return information about TOPS-20 commands, your
job, and the system as a whole.
@TRANSLATE (DIRECTORY) dev:<directory>
or
@TRANSLATE (DIRECTORY) dev:[project-programmer number]
Prints either the PPN corresponding to a directory, or the directory
number corresponding to the PPN.
56
TERMINAL COMMANDS
Terminal commands allow you to declare the characteristics of your
terminal, to clear your video screen, and to control linking to
another user's terminal.
@ADVISE (USER) n
n is user name or terminal number
Links your terminal with another user's terminal. After successful
execution of the command, input from the advising terminal is treated
as a command typed to the advised terminal's job.
@BLANK (SCREEN)
Clears your screen of all characters except the TOPS-20 prompt.
@BREAK (LINKS) argument
Ends all communication links made by the TALK command.
Arguments:
User Name Line Number
@RECEIVE {ADVICE, LINKS, or SYSTEM-MESSAGES}
Notifies the system that you are willing to accept advice,
communication links, or system messages.
57
@REFUSE {ADVICE, LINKS, SYSTEM-MESSAGES}
Notifies the system that you are not willing to accept advice,
communication links, or system messages.
@REMARK (MODE)
Type Remark, end with CTRL/Z
Notifies the system that the text that follows is a comment.
@TAKE (COMMANDS FROM) filespec1 (LOGGING OUTPUT ON) filespec2,
Informs the system to process TOPS-20 commands stored in the specified
file.
Subcommands:
ALLOW DISALLOW
ECHO LOG-FILE
NO
58
OUTPUT COMMANDS
Output commands allow you to request output listings of files on the
plotter, line printer, card punch, or paper tape punch, and to
examine, modify or withdraw these requests.
@CANCEL (REQUEST TYPE) queue (ID) identifier/switch(es)
Deletes various types of requests from queues.
Switches:
/JOBNAME: /SEQUENCE: /USER:
@MODIFY (REQUEST TYPE) queue (ID) request-id /switch(es)
Adds or changes switches for a request placed in a batch or output
queue.
Switches:
/AFTER: /BEGIN: /CARDS:
/COPIES: /DELETE /DEPENDENCY-COUNT
/DESTINATION-NODE: /FEET: /FILE:
/FORMS: /GENERIC /HEADER
/JOBNAME: /LIMIT: /LOWERCASE
/MODE: /NOHEADER /NOTE:
/PAGES: /PRESERVE /PRIORITY:
/PROCESSING-NODE: /REPORT: /RESTARTABLE:
/SEQUENCE: /SPACING: /TIME:
/TPLOT: /UNIQUE: /UNIT:
/UPPERCASE /USER:
59