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 TOPS-10/TOPS-20 COMMANDS QUICK REFERENCE GUIDE 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: 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 @ 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 or press 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,filespec,... 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: 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 . 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. @ 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 . @ 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: 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:, 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: 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: Terminates your access rights to a specific directory. @EXPUNGE (DIRECTORY) dev:, 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: 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: 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