TOPS-20 Commands Reference Manual
INFORMATION
Displays information about system and job parameters.
Format
@INFORMATION (ABOUT) argument
where:
argument | is a keyword, chosen from the list below, indicating your choice of INFORMATION command options. |
Summary of INFORMATION Command Arguments (defaults in boldface)
ADDRESS-BREAK | |||
ALERTS | |||
ARCHIVE-STATUS filespecs | |||
| |||
| Default user name - your user name | ||
CLUSTER | |||
COMMAND-LEVEL | |||
DECNET node-name | /tr>|||
| |||
DIRECTORY dev:<directory>, @@VERBOSE @@FAST @@NAME-ONLY |
Default dev:<directory> - your connected directory | ||
DISK-USAGE dev:<directory> | Default dev:<directory> - your connected directory | ||
FILE-STATUS octal JFN | Default JFN - all JFNs in your job FORK-STATUS INTERNET STATUS JOB-STATUS | ||
| |||
| Default user name - your user name | ||
MEMORY-USAGE | |||
MONITOR-STATISTICS | |||
| Default user name - your user name | ||
| Default user name - your user name | ||
PROGRAM-STATUS | |||
PSI-STATUS | |||
REMOTE-PRINTING | |||
| Default user name - your user name | ||
SPOOLED-OUTPUT-ACTION | |||
STRUCTURE dev: | Default dev: - your connected structure | ||
SUBSYSTEM-STATISTICS | |||
SUPERIORS | |||
SYSTEM-STATUS | |||
TAPE-PARAMETERS | |||
TERMINAL-MODE number | Default number - your terminal line number | ||
VERSION | |||
VOLUMES |
INFORMATION Command Arguments
ADDRESS-BREAK | gives the location (in numeric or symbolic format - depending upon previous specification of the SET TYPEOUT MODE command) and mode of any address breaks for the program currently in memory. Set with SET ADDRESS-BREAK. | ||||||||
ALERTS | lists the dates and times that the system is to signal you at the terminal. The last line of the display indicates whether alerts are to be sent unconditionally to your terminal (depending upon previous specification of the SET AUTOMATIC command). Set with SET ALERT. | ||||||||
ARCHIVE-STATUS filespecs | prints the archive status of all specified files for which archival has
been requested or for which migration has been prohibited.
Default filespec - *.*.* in your connected directory | ||||||||
| lists the devices or terminal lines available to you or already
assigned to your job. Use ASSIGN to obtain devices
(use MOUNT for structures).
Default - DEVICES | ||||||||
| lists the jobs being processed and waiting to be processed by the
batch system. The list includes:
Use SUBMIT, MODIFY, or CANCEL to change this list. The /ALL switch adds the switches /ASSISTANCE, /PRIORITY, /RESTARTABLE, /SEQUENCE, and /UNIQUE to this list, while /FAST eliminates the display of all switches and column headings; /PROCESSING-NODE specifies the DECnet network node about whose batch jobs you want information; /USER restricts descriptions to jobs of the user named, and can be given with any of the other three switches. Default user name - your user name | ||||||||
CLUSTER | displays the names of the systems in a Common File System (CFS)
cluster:
| ||||||||
COMMAND-LEVEL | prints the status of the LATE-CLEAR-TYPEAHEAD parameter, which prevents you from giving another TOPS-20 command until any error message resulting from a previous command has been printed. Set with SET LATE-CLEAR-TYPEAHEAD. | ||||||||
DECNET node-name | tells whether the specified DECnet network node is accessible to your
system. If you do not specify a node name, the system prints the name of
your host system, the total number of reachable nodes, and the names of all
reachable nodes.
Default node-name - all accessible nodes | ||||||||
|
displays, in a format suitable for entering them, default arguments
established at the current level of TOPS-20 for the specified command.
CARDS and PAPER-TAPE refer to the PUNCH CARDS
and PUNCH PAPER-TAPE commands, respectively.
COMPILE-SWITCHES refers to LOAD-class commands and
PROGRAM refers to the SET PROGRAM command. The ALL
argument displays the defaults for all these categories. Set
with SET DEFAULT. This argument displays the default for
every SET DEFAULT command given, even if duplicate
setting are made.
Default - ALL | ||||||||
DIRECTORY dev:<directory>, @@VERBOSE @@FAST @@NAME-ONLY |
lists the current parameter values set for the indicated directory (with
the exception of the directory password) by the SET
DIRECTORY or BUILD commands, or by default. The
subcommands call for either a short list of non-default (that is,
user-determined) values only (FAST), or a complete list including defaults
(VERBOSE), or a listing of directory names only (NAME-ONLY). If you use
NAME-ONLY, specify a directory in the form <directory.*>,
<*directory*>, or <*>. The categories of information include:
Set with SET DIRECTORY or (for subdirectories) BUILD.
| ||||||||
DISK-USAGE dev:<directory> | prints, for the indicated directory, the following:
The wildcard characters, * and % can be included in the <directory> field. For example, type <%directory*>, <directory.*>, or <*> to get information about all matching directories or subdirectories. Default dev:<directory> - your connected directory | ||||||||
FILE-STATUS | octal JFN gives, for the specified JFN (an internal number identifying
each file opening), the following:
Default JFN - all JFNs for your job | ||||||||
FORK-STATUS | gives a summary of the status of each fork belonging to your current copy of the TOPS-20 command processor, including Kept status, RUN status, and total CPU time used so far. An arrow (=>) indicates your current fork. | ||||||||
INTERNET | STATUS displays, if the system is a member, information about Internet
networks, including INTERNET, Milnet and Local Area Networks. The display
includes:
| ||||||||
JOB-STATUS | prints your
You can set some of these parameters with CONNECT, SET ACCOUNT, SET LOCATION, and SET SESSION-REMARK. | ||||||||
| prints the logical names and definitions which have been
established for your job, for the system, or for both; or prints the
job-wide and system-wide definitions of the specified logical name.
Establish and withdraw logical names with DEFINE.
For the DEFINE and INFORMATION LOGICAL-NAMES commands, a colon following the logical name is optional. However, in INFORMATION LOGICAL-NAMES the logical name SYS: must always be followed by a colon. Otherwise, the system interprets SYS as an abbreviation for the SYSTEM argument. The wildcard characters, * and % can be included in the logical name. For example, type A* to list all logical names that begin with the letter 'A'. See example 6. Default - JOB | ||||||||
| tells whether there is unread mail for the user, if you have read
access to the user's mailbox; otherwise, you see only the message, "Mailbox
protected." Also, displays any system messages since your last login when
you type SYSTEM instead of user-name. Send mail with one of the two mail
programs, MAIL and DECmail/MS. Read mail with the
RDMAIL or DECmail/MS program.
Default user name - your user name | ||||||||
MEMORY-USAGE | prints, for the current process of your job, the following:
| ||||||||
MONITOR-STATISTICS | gives you the following:
All averages and totals are computed for the time since system start-up. | ||||||||
| prints a list, at your terminal, of pending structure-mount and
tape-mount requests, and of tape-mount requests currently being satisfied.
The list includes:
Use the MOUNT, CANCEL (for pending requests), and DISMOUNT (for satisfied requests) commands to change this list. The /ALL switch adds the following to the display: the /ASSISTANCE, /PRIORITY, /RESTARTABLE/, /NOTE, /SEQUENCE, /UNIQUE, and /REMARK switches, whether a tape mount request is for a labeled tape, and the tape volume-set name. The /FAST switch eliminates column headings and the sum of the number of requests; /USER restricts descriptions to jobs of the user named, and can be given with either of the other two switches. Default user name - your user name | ||||||||
| prints a listing, at your terminal, of the requests being sent or
waiting to be sent to an output device. The list includes:
Use PRINT, PLOT, PUNCH, MODIFY, or CANCEL to change this list. The /ALL switch adds the /NOTE and /SEQUENCE switches to this list, while the /FAST switch eliminates the display of all switches and column headings; /USER restricts descriptions to jobs of the user named, and can be given with either of the other two switches. The /DESTINATION-NODE switch displays the print requests on remote nodes in the same TOPS-20 cluster as the local node. Default user name - your user name | ||||||||
PROGRAM-STATUS | gives the following information for the current level of the TOPS-20
command processor (EXEC):
An arrow (=>) indicates your current fork. | ||||||||
PSI-STATUS | tells you:
For further discussion of the interrupt system see the TOPS-20 Monitor Calls Reference Manual. | ||||||||
REMOTE-PRINTING | displays system definitions and characteristics for remote line printers. | ||||||||
| prints a list, at your terminal, of pending retrieval requests.
Each file for which you request retrieval constitutes a separate request,
even if specified within a single RETRIEVE command. The list includes:
Note that the /ALL switch does not display the complete file specification unless you have Wheel or Operator privileges. Default user name - your user name | ||||||||
SPOOLED-OUTPUT-ACTION | tells you whether the system processes your spooled output requests immediately, or defers them until you log out. Set with SET SPOOLED-OUTPUT-ACTION. | ||||||||
STRUCTURE dev: | gives, for each structure named, the following:
The colon after the structure name is optional. Use an asterisk * for dev: to specify all mounted structures. Mount and dismount structures with the MOUNT and DISMOUNT commands. Default dev: - your connected structure | ||||||||
SUBSYSTEM-STATISTICS | gives, for each subsystem (any name specified by the SETSN JSYS), the
following information:
See the TOPS-20 Monitor Calls Reference Manual for more information. | ||||||||
SUPERIORS | tells you the number of forks that are superior to the current EXEC
level. This number is equal to the number of times you gave the PUSH
command without intervening POP commands.
Note that many programs have PUSH commands and that some programs automatically do a PUSH. These PUSHes also change the number of superior forks reported by this command. | ||||||||
SYSTEM-STATUS | tells you:
| ||||||||
TAPE-PARAMETERS | gives the default settings of these parameters for magnetic tapes:
Set with SET TAPE. | ||||||||
TERMINAL-MODE | number gives the following information about the specified terminal:
Set with TERMINAL. The SYSTAT command displays terminal numbers. | ||||||||
VERSION | tells you:
The format of a version number is: a.b(c)-dwhere: (1) a and b are respectively incremented for major and minor changes in the software (2) c gives a rough indication of the number of times the software component has been edited (3) d, a holdover from earlier versions of TOPS-20 which is now rarely used, identifies the programmer(s) responsible for the software component. | ||||||||
VOLUMES setname: | gives the volids of currently mounted and newly created volumes in the specified tape set. A colon after the tape set name is optional. |
Hints
Specifying the Current Fork of TOPS-20
Use the FORK command to specify the fork to be described by the ADDRESS-BREAK, FILE-STATUS, MEMORY-USAGE and VERSION arguments. Find out your current fork with INFORMATION FORK-STATUS.
Restrictions
Using the INFORMATION OUTPUT-REQUESTS /DESTINATION-NODE switch
For non-privileged users, the local node's GALAXY must know if the remote node has printers. If the user is privileged, then the print request queue of the node specified is displayed, regardless of whether the local GALAXY knows if the node has printers or not. The user specified node must be a node in the cluster known to the local GALAXY.
If the node specified by the /DESTINATION-NODE switch is the local node, then the print request queue of the local node is displayed.
You cannot use an * as an argument in the /DESTINATION-NODE switch.
Related Commands
SYSTAT | for printing information about the current state of the system. |
Examples
- Use an INFORMATION command to determine your current terminal settings.
@INFORMATION TERMINAL-MODE TERMINAL VT100 TERMINAL SPEED 9600 . . . TERMINAL NO IMMEDIATE TERMINAL FULLDUPLEX
- Mount a structure and access your directory on the structure. Compare
the disk space available in this directory and in your connected directory.
(Note that there are many more pages free on your connected structure
(MISC:) as a whole than on structure SNARK:; this is likely to make your
use of the system more efficient if you work only within MISC:.)
@MOUNT STRUCTURE SNARK: Structure SNARK: mounted @ACCESS SNARK: @INFORMATION DISK-USAGE SNARK: SNARK:<LATTA> 198 Pages assigned 400 Working pages, 400 Permanent pages allowed 2836 Pages free on SNARK: @INFORMATION DISK-USAGE MISC:<LATTA> 119 Pages assigned 590 Working pages, 590 Permanent pages allowed 33172 Pages free on MISC:
- Print a file, ordering several copies and supplying a note to be
attached to it. Use an INFORMATION command to verify that your request is
in the output queue. Modify the date on which the job will be printed, and
use the INFORMATION command again to confirm this action.
@PRINT TESTF1.FOR /AFTER:17:00/COPIES:20/FORMS:NARROW/NO - TE:"T-TH LAB" [Printer job TESTF1 queued, request-ID 219, Limit 54] @INFORMATION OUTPUT-REQUESTS /ALL/USER Printer Queue: Job Name Req# Limit User -------- ---- ----- ------------------------ TESTF1 219 54 LATTA /Forms:NARROW /After: 8-Nov-85 17:00 /Note:T-TH LAB /Seq:1791 There is 1 job in the queue (none in progress) @MODIFY PRINT 219 /AFTER:15-NOV-85 17:00 [1 Job modified] @INFORMATION OUTPUT-REQUESTS /ALL/USER Printer Queue: Job Name Req# Limit User -------- ---- ----- ------------------------ TESTF1 219 54 LATTA /Forms:NARROW /After:15-Nov-85 17:00 /Note:T-TH LAB /Seq:1791 There is 1 job in the queue (none in progress)
- Request to print a file on a remote node, then use the INFORMATION
command to verify that your request is in the remote output queue.
@PRINT VENUS.TXT/DESTINATION-NODE:HENSON [Printer job VENUS queued on node HENSON, request-ID 39, Limit 12] @INFORMATION OUTPUT/DESTINATION-NODE:HENSON Printer Queue: Job Name Req# Limit User -------- ---- ----- ------------------------ VENUS 200 54 ANDERSON There is 1 job in the queue (none in progress)
- Place a program in memory section 17. Then give the INFORMATION
MEMORY-USAGE command to verify that the program was appropriately placed.
The page numbers, beginning at 17000, indicate that section 17 is in use,
because a section comprises 1000 (octal) pages. Also, the left half of the
entry vector location contains 17.
@GET GRADES.EXE.1 /USE-SECTION:17 @INFORMATION MEMORY-USAGE 64. pages, Entry vector loc 17,,542 len 254000 Section 0 R, W, E, Private Section 17 R, W, E, Private 17000-17002 GRADES.EXE.1 1-3 R, CW, E 17374-17425 GRADES.EXE.1 4-35 R, CW, E 17600-17637 GRADES.EXE.1 36-75 R, CW, E 17643-17645 GRADES.EXE.1 76-100 R, CW, E
- Issue the INFORMATION VERSION command for information on programs in
your memory area that have program data vectors associated with them. Note
that the merging of such programs yields consolidated information.
@GET IOLIB @INFORMATION VERSION BOSTON TOPS-20 System, TOPS-20 Monitor 7(163) TOPS-20 Command processor 7(10) Program is IOLIB PDVs: Program name IOPAK, version 1.1(420) @GET MATHLB @INFORMATION VERSION BOSTON TOPS-20 System, TOPS-20 Monitor 7(163) TOPS-20 Command processor 7(10) Program is MATHLB PDVs: Program name MATHLB, version 3.33(360) @MERGE IOLIB @INFORMATION VERSION BOSTON TOPS-20 System, TOPS-20 Monitor 7(163)) TOPS-20 Command processor 7(10) Program is MATHLB PDVs: Program name MATHLB, version 3.33(360) Program name IOPAK, version 1.1(420) @MERGE RPTGEN @INFORMATION VERSION BOSTON TOPS-20 System, TOPS-20 Monitor 7(163) TOPS-20 Command processor 7(10) Program is MATHLB PDVs: Program name REPORT, version 3.1(156) Program name MATHLB, version 3.33(360) Program name IOPAK, version 1.1(420)
- Use the INFORMATION LOGICAL-NAMES command with the * wildcard to list
all the job-wide and system-wide logical names that begin with the letter
'P'.
@INFORMATION LOGICAL-NAMES P* Job-wide: PAS: => PUB:<DBONIN.PASCAL> PB: => PUB:PHONE.BOOK PUB: => PUBLIC:<DBONIN> System-wide: PCL: => RANDOM:<PCL> POBOX: = PUBLIC: POST-OFFICE: => PUBLIC:<OPERATOR> PS: => GIDNEY:
- Use the INFORMATION INTERNET STATUS command to display the status of
INTERNET nodes.
@ INFORMATION INTERNET STATUS Local dec-internet host name is gidney.tops20.dec.com Network interface type is IPNI, Internet address is 16.34.0.2 Network interface is up, output is enabled Network service is enabled Last network interface up transition: 4-May-90 23:16:04 Local dec-mrnet host name is gidney.mrnet.dec.com Network interface type is IPNIA, Internet address is 192.5.5.4 Network interface is up, output is enabled Network service is enabled Last network interface up transition: 4-May-90 23:16:02 Local dec-mrrad host name is mrdale.mrrad.dec.com Network interface type is IPCI, Internet address is 192.5.6.12 Network interface is up, output is enabled Network service is enabled Last network interface up transition: 4-May-90 23:16:02