Google
 

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