TOPS-20 Commands Reference Manual
Sets or modifies various characteristics of your job, a directory, a file, a device, or some other entity.
@SET argument(s) setting(s)
|argument||is a keyword, chosen from the list below, indicating your choice of SET command options.|
|setting||is a word or number, required to complete the meaning of most SET commands.|
Summary of SET Command Arguments (defaults in boldface)
|ACCOUNT account remark|
|ADDRESS-BREAK octal or symbolic memory address,
|ALERT date/time message|
|CARD-READER-INPUT-SET name of input set n|
|LOCATION node-name||Default node-name - your host node|
|MAIL-WATCH user-name message-count|
|SESSION-REMARK remark of up to 39 characters|
|TERMINAL feature or type|
SET Command Arguments
|ACCOUNT account remark||begins charging the specified account for the remainder of your current terminal session or until you use the command again. You must supply an alphanumeric account name of 39 or fewer characters valid for your user name. Then you can type an optional session remark, also of 39 or fewer characters, to be inserted in system accounting data for your current terminal session. Check your current account and session remark with INFORMATION JOB-STATUS.|
|ADDRESS-BREAK octal or symbolic memory location,
|causes the program in memory to be suspended and a message to be
printed on your terminal when the memory location you specify is referenced
for the indicated operation - execute, read, write, or any of these (ALL).
With the AFTER subcommand you determine how many times it must be
referenced before the address break occurs; with NONE you cancel address
breaks for the specified location, just as with the SET NO ADDRESS-BREAK
command. Each SET ADDRESS-BREAK command cancels any previous address
break. Check your current address break with INFORMATION ADDRESS-BREAK.
Default subcommands - ALL, and AFTER 1
|causes the system to ring your terminal bell andtype a line at the
specified date and time. This line contains the time of day and your
message. The sign (+), used with the day-of-week and TODAY arguments, adds
the time you specify to the beginning of the day (00:00:00 or midnight).
For example, the command SET ALERT THURSDAY +10:00 sets an alert for
Thursday at 10:00 A.M. If you omit the plus sign after a day-of-week or
TODAY argument, the time is interpreted as part of the message. When a
time argument is used without a day-of-week or TODAY argument, the plus
sign adds the specified time to the current time. For example, the command
SET ALERT +1:00 sets an alert for one hour from the time the command is
If the SET AUTOMATIC command is in effect, this message is sent no matter what you are doing at your terminal. Otherwise, you are alerted only when your terminal is about to type a TOPS-20 prompt ($ or @). Alert settings are erased when you log out. Therefore, you should enter this command in your COMAND.CMD file if you want to be alerted in the distant future or on a regular basis. Check the setting of this command with INFORMATION ALERTS. See Example 8.
|AUTOMATIC||allows you to be notified by the system (as a result of a SET ALERT or SET MAIL-WATCH command) whether or not your job is at TOPS-20 command level. Every five minutes, the system checks to see if you should be notified. It is recommended that you enter this command in the LOGIN.CMD file to ensure coverage from the time you log in. Check with INFORMATION ALERTS or INFORMATION COMMAND-LEVEL.|
|CARD-READER-INPUT-SET name of input set n||is used by the batch system to associate the indicated set of punch cards, beginning with deck n, with system device CDR:|
|CONTROL-C-CAPABILITY||allows any program executed at the current command level to handle
CTRL/C interrupts itself. You cannot use this command in a batch job.
Check the current setting with INFORMATION PROGRAM-STATUS.
|sets up, as default global arguments to the command selected, the
arguments you specify. CARDS refers to the PUNCH CARDS command, COMPILE-
SWITCHES to all the LOAD-class commands, and PAPER-TAPE to the PUNCH PAPER
TAPE command. These arguments are any switch or keyword valid for the
For COMPILE-SWITCHES, you must specify the type of file you want the switches applied to by preceding the switches with one of the following: a file type (excluding the period), a period for file specifications with a null extension, or an asterisk (*) for all file types. Check current settings with INFORMATION DEFAULTS.
|DIRECTORY ACCOUNT-DEFAULT dev:<directory> default account
|sets the account of 39 or fewer characters to charge for your terminal session whenever you log in to this directory without specifying an account. Check with INFORMATION DIRECTORY.|
|DIRECTORY ARCHIVE-ONLINE-EXPIRED-FILES dev:<directory>||causes on-line files that have expired to be automatically archived. Check with INFORMATION DIRECTORY.|
|DIRECTORY FILE-PROTECTION-DEFAULT dev:<directory> octal code
|sets a default protection code governing access to files subsequently
created in the directory. See description of FILE PROTECTION argument for
a list of valid protection codes. Check with INFORMATION DIRECTORY.
Default code - 777700
|DIRECTORY GENERATION-RETENTION-COUNT-DEFAULT dev:<directory> n PASSWORD:password||prescribes for the directory a default value for the number of
generations of subsequently-created files to save. Check with INFORMATION
Default n - 1
|DIRECTORY NO ARCHIVE-ONLINE-EXPIRED-FILES||prevents on-line files that have expired from being automatically
|DIRECTORY NO SECURE str:<directory>||Specifies that files created in the directory are not secure. The
Access Control Job is not used to verify user access to new files in this
|DIRECTORY OFFLINE-EXPIRATION-DEFAULT dev:<directory> date or +n||sets the tape expiration date for files that are to go off line because
of archiving or migration. If you specify "+n", the expiration date is n
days from the date the files were moved off line.
Default n - 90
|DIRECTORY ONLINE-EXPIRATION-DEFAULT dev:<directory> date or +n||sets the disk expiration date for files that are to be created in the
directory. If you specify "+n", the expiration date is n days from the
Default n - 60
|DIRECTORY PASSWORD dev:<directory>
Old password:old password
New password:new password
Retype new password:new password
|allows you to change the password of the directory named. The password can consist of up to 39 alphanumeric characters, including hyphens.|
|DIRECTORY PROTECTION dev:<directory> octal protection code
|establishes for the directory a protection code constructed (by
addition) from the values shown below. Check with INFORMATION
Default code - 777700
See the TOPS-20 User's Guide for more information about protection codes.
|DIRECTORY SECURE str:<directory>||indicates that any new files created in the specified directory be made secure by default. When a file is secure, the Access Control Job checks to see if the user has access to that file before the user can read, write, append, rename, delete, set secure, or set unsecure that file.|
|lets you change the entry vector of the program in memory. Check the
current setting with INFORMATION MEMORY-USAGE.
Default length - 1
|FILE ACCOUNT filespecs account||specifies the account to charge for storage of the files named. Check with the DIRECTORY command and the ACCOUNT subcommand.|
|FILE EPHEMERAL filespec||assigns an ephemeral attribute to a system program. The program is
placed in an ephemeral fork only when you run it by typing just the program
name as an EXEC command. Running an ephemeral system program with the R
command cancels the ephemeral attribute. For a description of an ephemeral
fork, see the ERUN command, Characteristics of an Ephemeral Fork.
Wheel or Operator privileges are required to set a system program ephemeral. See Example 11 for setting a system program ephemeral. See Example 12 for running your own programs by typing only the program name.
|FILE EXPIRED filespecs||establishes today as the expiration date for the specified on-line files. Check with the DIRECTORY command and the DATES ONLINE-EXPIRATION subcommand.|
|FILE GENERATION-RETENTION-COUNT filespecs n||tells the system how many generations of the specified files to save.
Check with the DIRECTORY command and the GENERATION-RETENTION-COUNT
Default n - 1
|FILE INVISIBLE filespecs||makes the specified file inaccessible to most programs and TOPS-20 commands. Check with the DIRECTORY command and the INVISIBLE subcommand.|
|FILE NO EPHEMERAL filespec||removes the ephemeral attribute from a system program. Wheel or
Operator privileges are required to alter a system program.
You can cancel the ephemeral attribute for your copy of a system program with the SET PROGRAM NO-EPHEMERAL command or, by running the program with the R command instead of simply typing the system program name as a command.
|FILE NO PERMANENT filespecs||specifies that the file does not exist after it is deleted and
|FILE NO PROHIBIT filespecs||allows the system to migrate the specified file to off-line storage if
disk space becomes low. For privileged users only. Check with the
DIRECTORY command and the PROHIBIT-MIGRATION subcommand.
|FILE NO RESIST filespecs||cancels the effect of the SET FILE RESIST command. This switch allows
the system to move the specified files to off-line storage without
hesitating. Check with the DIRECTORY command and the RESIST-MIGRATION
|FILE NO SAVE-BY-BACKUP SYSTEM filespecs||indicates not to save the specified file as indicated by a DUMPER save command. For example, a SYSTEM:DUMP.EXE file.|
|FILE NO SECURE filespecs||indicates that specified files are not secure. The Access Control Job is not used to verify user access to this file(s).|
|FILE NO TEMPORARY filespecs||indicates the specified file is not a temporary file.
|FILE NO UNDELETABLE filespecs||specifies that the file can be deleted.
|FILE OFFLINE-EXPIRATION filespecs date or +n||specifies when the contents of an off-line file can be expunged from off-line storage. If you specify "+n", the expiration date is n days from the date it was moved off line. Check with the DIRECTORY command and the DATES OFFLINE-EXPIRATION subcommand.|
|FILE ONLINE-EXPIRATION filespecs date or +n||establishes the date on which the disk contents of the specified files will expire. If you specify "+n", the expiration date is n days from the current date. Check with the DIRECTORY command the DATES ONLINE-EXPIRATION subcommand.|
|FILE PERMANENT filespecs||specifies that after a file is deleted and expunged, the file name still exists. For example, a MAIL.TXT file.|
|FILE PROHIBIT filespecs||tells the system never to migrate the specified file to off-line storage. For privileged users only. (Nonprivileged users should refer to the description of the SET FILE RESIST command. See also Hints - Alternative to SET FILE PROHIBIT for Non-privileged Users, below.) Check with the DIRECTORY command and the PROHIBIT-MIGRATION subcommand.|
|FILE PROTECTION filespecs octal protection code||sets, for the specified files, a protection code constructed (by
addition) from the octal values shown below. Check with the DIRECTORY
command and the PROTECTION subcommand.
Default code - 777700
See the TOPS-20 User's Guide for more information about protection codes.
|FILE RESIST filespecs||offers nonprivileged users limited protection against migration. The specified files will be forced off-line only when absolutely necessary. Check with the DIRECTORY command and the RESIST-MIGRATION subcommand.|
|FILE SAVE-BY-BACKUP-SYSTEM filespecs||indicates that the specified file is saved as required by a incremental
or full DUMPER save command.
|FILE SECURE filespecs||indicates that the specified files are secure. When a file is secure, the Access Control Job checks to see if the user has access to that file before the user can read, write, append, rename, delete, set secure, or set unsecure that file.|
|FILE TEMPORARY filespecs||indicates the specified file is temporary.|
|FILE UNDELETABLE filespecs||indicates the specified file cannot be deleted.|
|FILE VISIBLE filespecs||makes the specified file accessible to all programs and TOPS-20
commands. Check with the DIRECTORY command and the INVISIBLE subcommand.
|HOST||Due to the number of options in the SET HOST command, it is described separately from the SET command. See the SET HOST command description following the SET command.|
|LATE-CLEAR-TYPEAHEAD||instructs the system to disregard all terminal input made after a line that causes an error and before the next prompt. Check the setting for your current level of TOPS-20 with INFORMATION COMMAND-LEVEL.|
|LOCATION node-name::||causes all output device request to be sent to the specified IBM remote
station. Two colons (::) following the node name are optional. Check
available nodes with INFORMATION DECNET, and check your current setting (if
different from your host node [log-in node]) with INFORMATION JOB-STATUS.
Default node-name - your host node
|MAIL-WATCH user-name message-count||checks the MAIL file for the specified user immediately and every five
minutes thereafter whenever your terminal is about to type a TOPS-20 prompt
(@ or $), and sends a message notifying you that the user has new mail if
this file contains unread mail. If you specify your own user-name, you
receive the message [You have mail from USER-NAME at 00:00:00]. If you
specify a user-name other than your own, you receive the message
[RECEIVER-USER-NAME has mail from SENDER-USER-NAME at 00:00:00]. You must
have read access to the specified user's mail file.
The message count argument sets the number of times you are notified of unread mail. If the SET AUTOMATIC command is in effect, this message is sent no matter what you are doing at your terminal. The maximum number of users that you can MAIL-WATCH is five. See Example 10.
Default user-name - your user-name
Default message-count - 1000
|NAME fork-name||renames the current fork with the specified alphanumeric name. Select
the current fork with the FORK command. Check with INFORMATION
If you give a fork the name of a program specified in a SET PROGRAM command, the fork will receive the attributes assigned in the SET PROGRAM command. For example, suppose you have given these two commands:
SET PROGRAM COMPUTE KEEP CONTINUE
If only COMPUTE is in memory and you name it SQUARE, the fork will assume the attributes defined in the SET PROGRAM SQUARE command and become an ephemeral fork. The system indicates this with the message [Assuming attributes of SQUARE].
A fork must have a unique name. If you attempt to name a fork with the same name as another fork, the system appends a digit to the new name. For example, if you attempted to name two forks EDIT, the second fork would be named EDIT0.
|NO ALERT date/time||removes settings that were established with the SET ALERT command. You
can specify date and time in the same formats as with SET ALERT.
Additionally, you can enter BEFORE or AFTER the date and time to indicate a
time period in which alerts are to be suppressed. If you specify no date
or time argument, all alert settings are erased. Alerts are valid only for
the current terminal session and are erased automatically when you log out.
|NO AUTOMATIC||causes you to be alerted by the system (as a result of a SET ALERT or
SET MAIL-WATCH command) only when your terminal is about to type a TOPS-20
prompt (@ or $). Check with INFORMATION ALERTS or INFORMATION
|NO CONTROL-C-CAPABILITY||removes the ability of programs at the current level of TOPS-20 to prevent your terminal from returning to the TOPS-20 command processor whenever you type a CTRL/C; ensures that CTRL/C will return you to TOPS-20. Check the setting for your current level of TOPS-20 with INFORMATION PROGRAM-STATUS.|
|nullifies all default arguments (established with a previous SET DEFAULT command) for the indicated command. For COMPILE-SWITCHES you must specify the type of file for which you want to clear the switches with one of the following: a file type (excluding the period), a period for file specifications with a null extension, or an * to clear the switches for all file types. Check with INFORMATION DEFAULTS.|
|NO LATE-CLEAR-TYPEAHEAD||instructs the system to accept terminal input made after an error
message is sent to your terminal and before the next prompt. Check the
setting for your current level of TOPS-20 with INFORMATION COMMAND-LEVEL.
|NO MAIL-WATCH user-name||disables periodic checking of the MAIL file associated with the
specified user. The notice of new mail is still displayed at log-in time
and when you receive mail, unless you have given the REFUSE SYSTEM-MESSAGES
or REFUSE LINKS command. You can always check the status of your MAIL file
at any time by giving the INFORMATION MAIL command.
Default user-name - your user-name
|NO RETRIEVAL-WAIT||tells the system to send an error message if your job attempts to use
|NO STATUS-WATCH||cancels the effect of the SET STATUS-WATCH command, disabling the interrupt character or character sequence that displays the status of all open, mapped pages.|
|NO TIME-LIMIT||removes any time limit set by a previous SET TIME-LIMIT command. You cannot use this command in a batch job.|
|NO TRAP||prevents any trapping that would have occurred as the result of a SET
|NO TRAP FILE-OPENINGS||nullifies the effects of the SET TRAP FILE-OPENINGS command, disabling
the TOPS-20 feature that causes you to be notified when a program tries to
open a file.
|nullifies the effects of the SET TRAP JSYS command, disabling the
TOPS-20 feature that causes traps to occur when a JSYS is executed.
|NO TRAP PROCEED||same as TRAP NO PROCEED.|
|NO UUO-SIMULATION||disables the feature of the TOPS-20 monitor that makes it possible to use programs originally written for the TOPS-10 operating system. Check the current setting with INFORMATION PROGRAM-STATUS.|
|PAGE-ACCESS range of octal page numbers type of access||Sets the type of access allowed to programs for the specified pages
existing in memory.
Check the status of current memory pages with INFORMATION MEMORY-USAGE.
Old password:old password
New password:new password
Retype new password:new password
|allows you to change the password of the login directory PS:<username>. The password can consist of up to 39 alphanumeric characters, including hyphens. This command is identical to the SET DIRECTORY PASSWORD command, except that PS:<username> is the default directory for the SET PASSWORD command.|
|PROGRAM fork-name EPHEMERAL||tells the system to make the specified fork an ephemeral fork when it
is loaded. For a description of an ephemeral fork, see the ERUN command,
Characteristics of an Ephemeral Fork.
It is recommended that you enter this command in your COMAND.CMD file for programs that you commonly place in ephemeral forks. Check with INFORMATION PROGRAM-STATUS.
|tells the system to make the specified fork a kept fork automatically
when the fork is loaded, or immediately if the fork is already loaded. A
kept fork is not reset when another fork is loaded and is not reset by the
RESET command unless the kept fork is explicitly named or the asterisk (*),
or period (.) argument is specified.
The required KEEP attribute establishes where the program restarts when you type the fork name as an EXEC command. CONTINUE begins the program at the point where it was interrupted. REENTER begins the program at its reentry address (for most programs the reentry address is the same as the start address). START begins the program at its start address. The system informs you when the fork is "kept" with the message [Keeping fork-name]. When you type the kept fork name, the system responds with [CONTINUING], [REENTERING], or [STARTING].
This command automatically keeps forks that are loaded by typing the system program name or one of the following commands: CSAVE, GET, R, RUN, and SAVE.
It is recommended that you enter this command in your COMAND.CMD file for programs that you commonly place in kept forks. Check with INFORMATION PROGRAM-STATUS. See Example 9. For a restriction on the CONTINUE argument, see the CONTINUE command description under Restrictions: Continued Programs Do Not Prompt for Input.
|PROGRAM fork-name NO-EPHEMERAL||disables the ephemeral attribute for your copy of a system program. Note that you can also cancel a program's ephemeral attribute by running the program with the R command instead of typing just the program name. It is recommended that you enter this command in your COMAND.CMD file. See Example 13.|
|PROGRAM fork-name NONE||cancels the setting established for the specified fork with the SET PROGRAM command. If the program is in a kept fork, the address used when the fork name is given as a command is changed to the start address. Check with INFORMATION PROGRAM-STATUS.|
|Lets you create a way to directly specify a queue and a characteristic
parameter when submitting a remote print request. SET REMOTE-PRINTING
commands can be invoked at command level or within a command file.
CHARACTERISTIC sets up a string to be used as input to the PRINT command /CHARACTERISTIC switch. The system file SYSTEM:REMOTE-PRINTING.CMD uses this command to establish the initial system setting, which equate each characteristic string to an integer value. You can rename a system-wide characteristic setting by re-issuing the command with a new name and value. You can undefine a characteristic by issuing the SET REMOTE-PRINTING CHARACTERISTIC command with a null value. Multiple characteristics are separated by commas.
The name argument can be a maximum of 14 characters per characteristic and must begin with an alphabetic character. The name can consist of any combination of the following:
To get information about the system characteristics settings, use the INFORMATION REMOTE-PRINTING command or read the SYSTEM:REMOTE-PRINTING.CMD file.
PRINTER sets up a string to be used as input to the PRINT command /REMOTE-PRINTER switch. You can create keywords (aliases) that designate the names of remote printers and print queues or LATprinter ports and services. This allows you to use simple names for remote print designations when using the /REMOTE-PRINTER switch. You can define an alias for the following:
The form of the command that includes the node or server name is used to define the actual printer or queue. After this is done, you can use the other forms of the command to apply aliases to the defined printer name.
SYSTEM-DEFINITIONS sets up remote printing information for a job based on the settings in the system-wide file SYSTEM:REMOTE-PRINTING.CMD. Invoking this command provides the complete set of printers and characteristics available for remote printing as defined by the system manager.
|RETRIEVAL-WAIT||tells the system that your job is willing to wait for retrieval of off-line files. Retrieval is then requested implicitly whenever you or a program you run attempts to access off-line files. Use INFORMATION SYSTEM-STATUS to be sure that automatic retrieval waits are enabled for the system before giving this command.|
|SESSION-REMARK remark||lets you insert a note or reminder of up to 39 characters into system accounting data. Check with INFORMATION JOB- STATUS.|
|directs the system either to begin processing your spooled output
requests as soon as you make them, or to defer them until log-out. You
make spooled output requests not with the PLOT, PRINT, or PUNCH commands
(these are always processed immediately), but with a command or program
that writes files to a spooled output device (for example, a line printer -
LPT:, plotter - PLT:, or card punch - CDP:). The COPY commands, the /LIST
switch for LOAD class commands, the CREF command, and the LPT and OUTPUT
subcommands for DIRECTORY-class and SYSTAT commands may make spooled output
requests. Check with INFORMATION SPOOLED-OUTPUT-ACTION.
Default - IMMEDIATE
|sets an interrupt character that displays the status of all open,
non-execute files mapped to the current fork. The display includes:
Although much of the above information is also provided by the INFORMATION FILE-STATUS and INFORMATION MEMORY commands, these commands can only display information while your terminal is at EXEC command level. The STATUS-WATCH interrupt character functions from EXEC or program level. In addition, the interrupt character displays the status of an executing EXEC command (for example, COPY).
To check the status of pages mapped to a program, you must specify one of these subcommands: PAGES, or TOPS-10-PAGES. The interrupt character always displays the pages opened by the EXEC, for example the pages opened by a COPY command. When an EXEC command is processing, only the EXEC's pages are checked. If no command is in progress, the current fork's address space is checked. If there is no current fork, no checking takes place.
For efficiency and to reduce the overhead of this command, a maximum of 512 pages (not including EXEC pages) are checked by the interrupt character. These pages do not have to be contiguous or in the same section.
To simplify your typing, SET STATUS-WATCH accepts subcommands as arguments on the command line.
INTERRUPT "^x" is a required subcommand that sets a control character or character sequence that, when typed during program or EXEC command execution, displays the status of all files opened by the current fork. Use the FORK command to select a different current fork.
The interrupt character can be a single control character or a two-character sequence enclosed in double quotes. For example, "^B", "DF", "^QW" are valid interrupt characters. Control characters that are already used by the system, such as CTRL/C and CTRL/T, cannot be redefined by SET STATUS-WATCH. See Appendix D for a list of defined system control characters.
A two-character interrupt sequence is job-wide and can be issued from any EXEC level. If another program in your job defines a two-character interrupt sequence (for example the SET HOST command with the CTERM-SERVER), this sequence supersedes the SET STATUS-WATCH interrupt sequence. A single-character interrupt applies only to the current EXEC level. Also, the interrupt character is not echoed on the terminal.
NO INTERRUPT disables the interrupt characters.
PAGES nn adds the specified octal pages (nn) or range of pages (n:m) to the pages checked by the interrupt character. Multiple pages and ranges of pages can be specified by separating the pages with commas. For example, PAGE 100:40, 350 specifies pages 100 through 140 and page 350.
NO PAGES disables checking for all pages except pages used by the EXEC.
The total number of mapped pages checked by the interrupt character (not including EXEC pages) cannot exceed 512. Generally, programs map pages within the range of 0:777.
TOPS-10-PAGES adds the pages used by PA1050 (for TOPS-10 compatibility) to the address space checked by the interrupt character. It is recommended that you place the SET STATUS command in your COMAND.CMD file.
See Example 14.
|instructs the system to read and write magnetic tapes for your job at
the indicated density (in bits per inch). SYSTEM-DEFAULT, one of these
values (usually 1600), is established by your system manager. The value
set by this command can be superseded by commands within a program. Check
with INFORMATION TAPE-PARAMETERS.
Default - SYSTEM-DEFAULT
|advises the system that the format to use in processing tapes is either
ANSI-ASCII, which stores each word of data as five 7-bit bytes in five
frames of a 9-track type; or CORE-DUMP, which stores each word of data as a
single 36-bit byte in five frames of a 9-track tape, partially using the
fifth frame; or HIGH-DENSITY, which stores each two words of data as nine
8-bit bytes in nine frames of a 9-track tape; or INDUSTRY-COMPATIBLE, which
stores each word of data as four 8-bit bytes in four frames of a 9-track
tape; or SIXBIT, which stores each word of data as six 6-bit bytes in six
frames of a 7-track tape. SYSTEM-DEFAULT, one of these (usually
CORE-DUMP), is chosen by your system manager. See also Restrictions -
Using SET TAPE Commands, in the MOUNT command description in this manual.
See the TOPS-20 Monitor Calls Reference Manual for more information about
hardware data modes for magnetic tapes. Check with INFORMATION
Default - SYSTEM-DEFAULT
|tells the system which parity to assume when verifying the accuracy of tape
records. Check with INFORMATION TAPE-PARAMETERS.
Default - ODD
|TAPE RECORD-LENGTH n||sets the size, in bytes, for each physical record on a tape. Check with INFORMATION TAPE-PARAMETERS. Not applicable with labeled tapes. Default n - 512|
|TERMINAL feature or type||same as TERMINAL command.|
|TIME-LIMIT n||tells the system to stop any program or terminal printout when the given amount of additional CPU time (in seconds) has been used, and to inform you with a fatal error message. This command is used by the batch system to limit the runtime of batch jobs. Display the time limit set for your job with the SYSTAT command and the LIMIT subcommand. Display the CPU time used by your job with CTRL/T or INFORMATION PROGRAM-STATUS.|
|TRAP FILE-OPENINGS||displays a message when any program attempts to open a file. Check with INFORMATION PROGRAM-STATUS. See Example 5.|
|displays a message when any program calls a TOPS-20 JSYS. You can
cause trapping to occur for all JSYSs, for defined JSYSs only (JSYSs known
to the Monitor), for undefined JSYSs only (JSYSs not known to the Monitor),
or for the JSYS(s) specified by name or number. You can specify multiple
JSYSs separated by commas. Check with INFORMATION PROGRAM-STATUS. See
Default - /DEFINED
The SET TRAP command is ineffective for execute-only programs (those with a protection code that prohibits reading and writing the file). Attempts to run such programs after a SET TRAP command has been specified will result in error messages.
|TRAP NO||same as SET NO TRAP.|
|TRAP NO FILE-OPENINGS||same as SET NO TRAP FILE-OPENINGS.|
|same as SET NO TRAP JSYS.|
|TRAP NO PROCEED||directs the system to terminate the program after a trap has occurred as a result of a SET TRAP command. Check with INFORMATION PROGRAM-STATUS. See Example 7.|
|TRAP||PROCEED directs the system to continue a program after a trap has
occurred as a result of a SET TRAP command. Check with INFORMATION
|establishes the mode in which memory addresses and contents are to be
typed on your terminal in response, for example, to a CTRL/T or the
commands: INFORMATION ADDRESS-BREAK, INFORMATION FORK-STATUS, INFORMATION
PROGRAM-STATUS, and EXAMINE. Note that only NUMERIC typeout is displayed
for execute-only programs. Check with INFORMATION PROGRAM-STATUS.
Default - NUMERIC
|UUO-SIMULATION||allows the system to execute programs originally written for the
TOPS-10 operating system, by calling the TOPS-10 compatibility package,
PA1050.EXE. Check the current setting with INFORMATION PROGRAM-STATUS.
Affect Only Current Terminal Session
The SET command, except for SET DIRECTORY and SET FILE, applies to the current terminal session only, and in most cases only to the current level of TOPS-20 in that session. Therefore put SET DEFAULT, SET CONTROL-C-CAPABILITY, SET PROGRAM, and other SET commands into your COMAND.CMD file if you want them to be in effect every time you log in or give the PUSH command. Place commands that apply to any level of TOPS-20 in your LOGIN.CMD file.
The system-wide file REMOTE-PRINTING.CMD contains SET REMOTE-PRINTING commands to establish printer aliases and characteristics values. The SET REMOTE-PRINTING SYSTEM-DEFINITIONS command sets up remote printing information for a job based on the settings in REMOTE-PRINTING.CMD. Internal tables are built that consist of the command arguments. These tables are used to validate the /CHARACTERISTIC and /REMOTE-PRINTER switch values specified by the user.
You can invoke the SET REMOTE-PRINTING SYSTEM-DEFINITONS command at command level or within a command file.
Using SET PAGE-ACCESS
A SET PAGE-ACCESS command can take several arguments on the same line, with cumulative effect; contradictions are resolved in favor of the last item given. So SET PAGE-ACCESS 6 EXECUTE NO COPY-ON-WRITE NO WRITE allows a user to execute page 6 but not to change it; SET PAGE-ACCESS 7 NO WRITE WRITE allows changes to page 7.
To Make Modifiable Copies of Write-protected Programs
Because the SAVE command preserves the write protection of files, you should use the SET PAGE ACCESS WRITE or SET PAGE-ACCESS COPY-ON-WRITE command before giving SAVE if you want to save a modifiable copy of a program.
Using SET TIME-LIMIT
Although the SET TIME-LIMIT command is ordinarily used by the batch system to limit the runtime of jobs, you can employ it as a timesharing user to give you a fatal error message when the specified amount of CPU time has been spent. To find out how much of this time you have left, give the SYSTAT . LIMIT and INFORMATION PROGRAM-STATUS commands. The difference between the SYSTAT . LIMIT time and the "Used" time reported by INFORMATION PROGRAM-STATUS tells you the approximate time remaining.
SET Commands Useful for Debugging Programs
SET ADDRESS-BREAK shows you how often and for what purpose a memory address is referenced. When an address break occurs, a message will show the memory location at which execution of your program will resume.
SET NO CONTROL-C-CAPABILITY, SET UUO-SIMULATION, SET PAGE-ACCESS
If you are debugging a program, use the SET NO CONTROL-C-CAPABILITY command to ensure that you can use CTRL/C to leave the program. Test a program that traps CTRL/Cs by having it trap, say, CTRL/As instead during debugging. Also, setting NO CONTROL-C-CAPABILITY, NO UUO-SIMULATION, or PAGE-ACCESS NO WRITE NO COPY-ON-WRITE will show you what part of the program (if any) is attempting to use these features.
Alternative to SET FILE PROHIBIT for Non-privileged Users
Even if you do not have sufficient privileges to use the SET FILE PROHIBIT command, you can still do something to delay the removal of important files to off-line storage.
Create a file named MIGRATION.ORDER in each directory for which you wish to control migration. The contents of this file should be the specifications of files that you want to be migrated first, when migration is performed. You may use wildcard characters (* and %) to specify more than one file. To protect source programs, for example, you could specify that executable programs and binary files be migrated first, by listing "*.EXE, *.REL" in MIGRATION.ORDER. To protect edited files, you could list "*.Q*" (this ensures that unedited back-up files produced by the EDIT program be migrated before the edited versions).
Any files not listed in MIGRATION.ORDER will be protected from migration until all listed files have been migrated. Remember that, even without being listed in MIGRATION.ORDER, files are not usually migrated to off-line storage if they have been used or changed within a period of time specified by your system manager.
The SET FILE RESIST command also offers limited protection against involuntary migration.
Using SET REMOTE-PRINTING PRINTER
It is possible that two remote queue names on different clusters may be
the same or that a remote queue name may be the same as a LAT port or
service name. The target node name or actual name form of the SET
REMOTE-PRINTING PRINTER command resolves this problem. The node name or
server name distinguishes one identically named printer from another. For
example, the following two commands would help avoid confusion in such an
SET REMOTE-PRINTING PRINTER ODIE LASER LAT1
SET REMOTE-PRINTING PRINTER GARFIELD LASER VAXNOD
Using SET Commands in Batch Jobs
Put SET commands into a BATCH.CMD file in your log-in directory if you want them to apply to the first (highest) level of TOPS-20 in batch jobs you submit; put them into COMAND.CMD in your log-in directory if you want them to apply to all levels of TOPS-20 in both batch and interactive jobs. Remember, though, that you must not give SET CONTROL-C-CAPABILITY, SET NO TIME-LIMIT, or SET TIME-LIMIT (or the ATTACH command) within any batch job.
Using SET DIRECTORY Commands
You will be able to use the SET DIRECTORY commands only if your system is instructed at system start-up time to allow them. Otherwise, the system will send you error messages in response to SET DIRECTORY commands.
Using SET REMOTE-PRINTING Commands
In supporting host initiated connections to LATprinters, TOPS-20 users are limited to six character server names.
The remote printer functionality on TOPS-20 does not include features to allow remote systems to access a printer facility local to a TOPS-20 system.
- Set the LATE-CLEAR-TYPEAHEAD parameter for your job.
- Find out the placement of your program in memory; set an address break
to occur at location 2412 when the instruction it contains has been
executed six times. Then give the INFORMATION ADDRESS-BREAK command to see
the location and operation for which the current address break has been
@INFORMATION MEMORY-USAGE 5. pages, Entry vector loc 400010 len 254000 0-3 Private R, W, E 400 Private R, W, E @SET ADDRESS-BREAK 2412, @@AFTER 6 @@EXECUTE @@ @INFORMATION ADDRESS-BREAK Address break at 2412 on execute.
- Set defaults for PRINT command switches, then print a file immediately
by explicitly supplying an /AFTER switch with an early hour as argument.
@SET DEFAULT PRINT /LOWERCASE/AFTER:17:00 @PRINT /AFTER:+0 4-UPED.TXT [Job 4-UPED Queued, Request-ID 346, Limit 200] @INFORMATION OUTPUT-REQUESTS /USER Printer Queue: Job Name Req# Limit User -------- ---- ----- ------------------------ * 4-UPED 346 200 LATTA On Unit:0 Started at 16:11:11, printed 0 of 200 pages There is 1 Job in the Queue (1 in Progress)
- Put an executable program into memory and set the page access of its
first page to NO COPY-ON-WRITE; try to deposit a value (32) in memory
location 500 of the page (this fails). Then set its page access to
COPY-ON-WRITE and try once more, succeeding this time. Give the
INFORMATION MEMORY-USAGE command again. Notice that you now have your own
copy of the page in memory; it is no longer mapped from the file TESTF1.EXE
in your connected directory.
@GET TESTF1 @INFORMATION MEMORY-USAGE 1. pages, Entry vector loc 145 len 254000 0 TESTF1.EXE.3 1 R, CW, E @SET PAGE-ACCESS 0 NO COPY-ON-WRITE @DEPOSIT 500 32 ?Can't write that page @SET PAGE-ACCESS 0 COPY-ON-WRITE @DEPOSIT 500 32 [Shared] @INFORMATION MEMORY-USAGE 1. pages, Entry vector loc 145 len 254000 0 Private R, W, E
- Learn what files are opened when you edit a file.
@SET TRAP FILE-OPENINGS @EDIT LOGIN.CMD [Fork EDIT opening SWITCH.INI.3 for reading] [Fork EDIT opening LOGIN.CMD.33 for reading] Edit: LOGIN.CMD.33 [Fork EDIT opening EDIT-BUFFER.OUT.100042 for writing] *EU [Fork EDIT opening EDIT-BUFFER.OUT.100042 for reading] [Fork EDIT opening LOGIN.CMD.34 for writing] [LOGIN.CMD.34]
- Cause a trap to occur whenever the GTFDB JSYS is executed. Then edit a
file. The EDIT command invokes the GTFDB JSYS and causes a line to type
out in the following format:
[fork "trap" <location>/<jsys name> "Ac's 1-4:" - <ac contents>] Note that the location is in symbolic form if you so specified in the SET TYPEOUT MODE command. @SET TRAP JSYS GTFDB @EDIT LOGIN.CMD [EDIT trap 3515/ GTFDB Ac's 1-4: 11 1000004 20321 424153000000] [EDIT trap 3562/ GTFDB Ac's 1-4: 11 2000011 4 424153000000] Edit: LOGIN.CMD.42 *EU [LOGIN.CMD.43]
- Specify that program execution is to halt whenever a GTFDB JSYS causes
a trap. Then edit a file. The EDIT command invokes the GTFDB JSYS,
causing a trap to occur, which causes the EDIT process to immediately halt.
@SET TRAP NO PROCEED @SET TRAP JSYS GTFDB @EDIT LOGIN.CMD [EDIT trap 3515/ GTFDB Ac's 1-4: 10 1000004 20321 424153000000]
- Arrange for the system to remind you of a future obligation. Then
verify that you will be reminded.
@SET ALERT MONDAY +11:00:00 Turn in time card @SET AUTOMATIC @INFORMATION ALERTS Next alert at 8-Jun-84 16:55:00 - Almost time to go home!! Other alerts set for: 11-Jun-84 08:55:00 - Project meeting at 9:00 14-Jun-84 11:00:00 - Turn in last week's time card by noon Alerts are automatic
- Set the CHANGE and RADIUS programs to be automatically placed in kept
forks when they are run. Then give the INFORMATION PROGRAM-STATUS command
to display all the SET PROGRAM settings. Finally, run the CHANGE program.
Note that the message [Keeping CHANGE] indicates that the program is being
loaded into a kept fork.
@SET PROGRAM RADIUS KEEP CONTINUE @SET PROGRAM CHANGE KEEP CONTINUE @INFORMATION (ABOUT) PROGRAM Used 0:00:35 in 0:24:09 TOPS-20: 0:00:00.8 SET UUO-SIMULATION (FOR PROGRAM) SET TYPEOUT MODE NUMERIC SET PROGRAM RADIUS KEEP (AND) CONTINUE (WHEN INVOKED AS A COMMAND) SET PROGRAM CHANGE KEEP (AND) CONTINUE (WHEN INVOKED AS A COMMAND) SET PROGRAM MS KEEP (AND) START (WHEN INVOKED AS A COMMAND) SET PROGRAM DSRPLUS KEEP (AND) START (WHEN INVOKED AS A COMMAND) => MS (1): Kept, C from IO wait at 104062, 0:00:01.6 @RUN CAN [Keeping CAN] CAN>
- Arrange for the system to check for new mail in your MAIL file and the
MAIL file of user AI.GROUP. Notice the two messages indicating that you
and AI.GROUP have new mail. Then, cancel mail watching for user AI.GROUP.
@SET MAIL-WATCH @SET MAIL-WATCH AI.GROUP [You have mail from SMITH at 10:12:11] [AI.GROUP has mail from NELSON at 10:12:14] @SET NO MAIL-WATCH AI.GROUP
- Use the DIRECTORY command to learn the name of the directory that
contains a system program. Then enable your Wheel or Operator privileges
and set the system file ephemeral.
@DIRECTORY SYS:ISPELL RANDOM:<UNSUPPORTED> ISPELL.EXE.1 @ENABLE $SET FILE EPHEMERAL RANDOM:<UNSUPPORTED>ISPELL.EXE RANDOM:<UNSUPPORTED>ISPELL.EXE.1 [OK] $DISABLE @
- Add one of your own directories to the definition of SYS: so that you
can run programs in that directory by typing just the program name.
@DEFINE SYS: => SYS:, STUDENTS:<DBONIN.TOOLS> Next, set ephemeral a file in this directory. Run the program in an ephemeral fork by typing the program name. Then CTRL/C from the program. Give the INFORMATION FORK-STATUS command and note that the ephemeral fork CHANGE has been reset. @SET FILE EPHEMERAL CHANGE.EXE @CHANGE CHANGE>^C @INFORMATION FORK-STATUS => EDIT (1): HALT at 6253, 0:00:00.6
- Run an ephemeral system program and disable the program's ephemeral
@SET PROGRAM CHANGE NO-EPHEMERAL @CHANGE CHANGE>
@R CHANGE CHANGE>
- Give the SET STATUS-WATCH command with the INTERRUPT subcommand to
specify CTRL/B as the interrupt character. Then give the PAGES subcommand
to specify the range of pages to be checked by the interrupt character.
Display both settings with the LIST-PARAMETERS subcommand:
@SET STATUS-WATCH, @@INTERRUPT "^B" @@PAGES 0:777 @@LIST-PARAMETERS Enabled on "^B", Checking pages: 1-512 @
Next run the DSRPLUS program and check its status by typing CTRL/B. This program reads the input file MEMO.RNO and creates the output file MEMO.MEM. Note that the ^B is not displayed on the terminal.
@DSRPLUS DSRPLUS>MEMO.RNO ^B Connected to BLAZE:<ROBBERTS> 6 PUBLIC:MEMO.RNO.1 [Page 1 of 9. Byte 128(36). Read] ^B Connected to BLAZE:<ROBBERTS> 7 MEMO.MEM.1 [Page 3. Byte 512(36). Read Write] 6 PUBLIC:MEMO.RNO.1 [Page 4 of 9. Byte 1280(36). Read] ^B Connected to BLAZE:<ROBBERTS> 7 MEMO.MEM.1 [Page 8. Byte 3840(36). Read Write] 6 PUBLIC:MEMO.RNO.1 [Page 8 of 9. Byte 3968(36). Read] DSRPLUS>
Now look at the above display. The first time CTRL/B is typed, DSRPLUS is reading the first page of the nine page input file MEMO.RNO. The second CTRL/B shows that DSRPLUS is reading page four of the input file and has created three pages of the output file MEMO.MEM. Nearing its completion, DSRPLUS has read eight of the nine input pages and has created an eight page output file.
- Define the name of the remote printer queue SI$8700 on node OURVAX to
@SET REMOTE-PRINTING PRINTER XEROX SI$8700 OURVAX @
Now, assign the alias FAST for the name of the same remote printer queue from XEROX.
@SET REMOTE-PRINTING PRINTER FAST XEROX @
- Define the name of a LATprinter connected to port LBBNA1297Y10X on a
server named LAT990 to the alias LN03.
@SET REMOTE-PRINTING PRINTER LN03 LBBNA1297Y10X LAT990 @
Now, direct a print request to the LATprinter:
- Set some remote printer characteristics.
@SET REMOTE-PRINTING CHARACTERISTIC P90 52 ;portrait 90 wide @SET REMOTE-PRINTING CHARACTERISTIC BOLD 61 @