TOPS-20 Commands Reference Manual

Appendix B Alphabetical list of TOPS-20 commands

This appendix consists of an alphabetical list of TOPS-20 commands and short descriptions of each. The varieties of argument needed to complete each command are shown next, in the order that you give them; parentheses indicate that the argument is optional or can be defaulted. Last comes the effect of the command on memory - whether it clears memory (by loading a program or by other means) or otherwise alters it, or leaves it unaffected. Use this appendix along with the question mark and recognition features to refresh your memory once you have become familiar with the contents of this manual.

                                                              Effect
                                                                on
   Command      Function                 Arguments            Memory

   ACCESS       gets ownership rights    dev:<directory>,     ---
                to a directory           password

   ADVISE       sends commands to        user name or         ---
                another user's job       terminal number

   APPEND       adds files onto end      filespecs,           ---
                of another file          (subcommands)

   ARCHIVE      requests off-line        filespecs,           ---
                storage of files         (subcommand)

   ASSIGN       allocates a device       device name          ---
                for your job

   ATTACH       engages a job to         user name,           ---
                your terminal            (job number)
                                         (password)

   BACKSPACE    moves a magnetic         device name, number  ---
                tape backward            of records or files

   BLANK        clears your video        ---                  ---
                terminal screen

   BREAK        ends links made by a     (user name or        ---
                TALK command             line number)

   BUILD        creates, modifies, or    dev:<directory>,     ---
                deletes a subdirectory   subcommands

   CANCEL       withdraws output         queue, jobname       ---
                or batch requests

   CLOSE        closes open files        JFN                  ---

   COMPILE      translates source        filespecs, switches  loads
                programs into object                          compiler
                programs                 

   CONNECT      connects your job        dev:<directory>,     ---
                to a directory           password

   CONTINUE     continues a halted       NORMALLY or STAY     ---
                program

   COPY         makes copies of          filespec,filespec    ---
                a file                   (subcommands)

   CREATE       creates a file           (switches),          loads
                                         filespec             EDIT

   CREF         translates .CRF          (filespec)           loads
                files into listings                           CREF

   CSAVE        stores a copy of         (filespec, memory    ---
                memory in a file         locations)
                (in compressed format)

   DAYTIME      tells the date and       ---                  ---
                time

   DDT          starts a debugging       (switches)           merges
                program                                       debugging
                                                              program
                                                              with
                                                              existing
                                                              memory (if
                                                              necessary)

   DEASSIGN     gives up a previously    device name          ---
                assigned device

   DEBUG        debugs a program         filespec, switches   loads
                                                              program
                                                              and
                                                              debugging
                                                              program

   DEFINE       establishes or withdraws logical name,        ---
                a logical name           search list

   DELETE       marks files for          filespecs,           ---
                later erasure            (subcommands)

   DEPOSIT      changes contents of      memory location,     changes
                a memory location        octal number         one
                                                              location

   DETACH       disengages a             (argument)           ---
                job from your
                terminal

   DIRECTORY    gives information        (dev:<directory>,    ---
                about files              filespecs),
                                         subcommands

   DISABLE      deactivates              ---                  ---
                capabilities

   DISCARD      gives up tape copy       filespecs            ---
                of on-line files

   DISMOUNT     gives up access to       alias or setname,    ---
                structure or tape        switches
                set

   EDIT         edits existing           (switches),          loads
                files                    filespec             EDIT

   ENABLE       activates capabilities   ---                  ---

   END-ACCESS   terminates ownership     dev:<directory>      ---
                rights to a directory

   EOF          writes an                device name          ---
                end-of-file mark on
                a magnetic tape

   ERUN         runs a system            name of system       loads
                program in an            program (switches)   program
                ephemeral fork

   EXAMINE      inspects a memory        memory location      ---
                location

   EXECUTE      compiles, loads and      filespec, switches   loads
                starts a program                              compiler
                                                              and/or
                                                              program

   EXPUNGE      erases all deleted       (dev:<directory>,    ---
                files from a             subcommands)
                directory

   FDIRECTORY   DIRECTORY command        (dev:<directory>,    ---
                with subcommands         filespecs),
                CRAM,EVERYTHING,         subcommands
                and NO HEADING

   FORK         specifies what           fork name            ---
                fork is current          or number

   FREEZE       stops a                  fork name            ---
                running fork             or number

   GET          places an executable     filespec,            loads
                program in memory        (switches)           program

   HELP         presents a short         name of system       ---
                description of a         program
                system program

   INFORMATION  gives information        arguments            ---
                about system and job
                parameters

   KEEP         protects a fork          fork name            ---
                from being               or number
                reset

   LOAD         compiles and loads       filespec, switches   loads
                a program                                     compiler
                                                              and/or
                                                              program

   LOGIN        begins a job             user name,           ---
                                         password, account

   LOGOUT       ends a job               ---                  clears
                                                              memory

   MERGE        merges an executable     filespec,            adds
                program with current     (switches)           program
                memory                                        to
                                                              existing
                                                              memory

   MODIFY       changes output or        queue, jobname,      ---
                batch requests           switches

   MOUNT        requests use of          alias or setname,    ---
                structure or tape set    switches

   PERUSE       edits files in           (switches),          loads
                read-only mode           filespec             editor

   PLOT         plots files on           filespecs, switches  ---
                plotter
   POP          returns to superior      ---                  clears
                TOPS-20 command                               memory of
                level, ending                                 inferior
                inferior TOPS-20                              process
                command level

   PRINT        prints files on          filespecs, switches  ---
                line printer

   PUNCH        punches files on         filespecs, switches  ---
                card punch or paper
                tape punch

   PUSH         begins an inferior       ---                  preserves
                TOPS-20 command                               superior
                level                                         memory

   R            runs a system            name of system       loads
                program                  program, (switches)  program

   RECEIVE      allows communication     argument             ---
                with your terminal

   REENTER      starts program in        ---                  ---
                memory at the
                restart address

   REFUSE       disallows                argument             ---
                communication with your
                terminal

   REMARK       informs the system       ---                  ---
                that you are typing
                only comments, not
                commands

   RENAME       changes the              filespec, filespec   ---
                specification of a
                file

   RESET        clears the specified     fork name or         clears
                fork from memory         number               fork

   RETRIEVE     restores off-line        filespecs            ---
                files to disk

   REWIND       rewinds a magnetic       device name          ---
                tape to its load
                point

   RUN          places an executable     filespec,            loads
                program in memory        (switches)           program
                and starts it

   SAVE         stores a copy of         (filespec)           ---
                memory in a file

   SEND         sends messages           line number          ---
                to terminals

   SET          sets various job         arguments            ---
                parameters

   SET HOST     connects the terminal    system name,
                to another system        switches

   SKIP         moves a magnetic         device name,         ---
                tape forward             number of records
                                         or files

   START        starts program in        (memory location)    ---
                memory at start
                address

   SUBMIT       submits entries (jobs)   filespecs, switches  ---
                to the batch system

   SYSTAT       gives information        arguments,           ---
                about system and job     (subcommands)
                status

   TAKE         starts processing        filespec,            ---
                of a command file        (subcommands)

   TALK         makes communication      user name or         ---
                links with another       terminal number
                user

   TDIRECTORY   DIRECTORY command        (dev:<directory>,    ---
                with subcommands         filespecs),
                CHRONOLOGICAL WRITE,     subcommands
                REVERSE, and TIMES
                WRITE

   TERMINAL     sets various             argument             ---
                terminal
                characteristics

   TRANSLATE    gives directory          dev:<directory> or   ---
                names for ppn's and      [project-programmer
                vice versa               number]

   TYPE         prints files on your     filespecs            ---
                terminal

   UNATTACH     disengages another job   user name,           ---
                from its terminal        (job number)
                                         (password)

   UNDELETE     restores deleted         filespec             ---
                files

   UNKEEP       cancels the kept         fork name            ---
                status of a fork         or number

   UNLOAD       unloads a magnetic       device name          ---
                tape and deassigns
                the drive

   VDIRECTORY   DIRECTORY command        (dev:<directory>,    ---
                with subcommands         filespecs),
                LENGTH, NO HEADING,      subcommands
                PROTECTION, SIZE,
                and TIMES WRITE