TOPS-20 Commands Reference Manual

SET

Sets or modifies various characteristics of your job, a directory, a file, a device, or some other entity.

Format

@SET argument(s) setting(s)

where:

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,
   @@AFTER n Default n - 1
@@ALL
@@EXECUTE
@@NONE
@@READ
@@WRITE
ALERT date/time message
AUTOMATIC
CARD-READER-INPUT-SET name of input set n
CONTROL-C-CAPABILITY
DEFAULT CARDS /switch(es)
COMPILE-SWITCHES file type /switch(es)
PAPER-TAPE /switch(es)
PLOT /switch(es)
PRINT /switch(es)
SUBMIT /switch(es)
TAKE ALLOW
DISALLOW

ECHO
NO ECHO
DIRECTORY ACCOUNT-DEFAULT dev:<directory> account password
ARCHIVE-ONLINE-EXPIRED-FILES
FILE-PROTECTION-DEFAULT dev:<directory> octal code password
 Default code - 777700
GENERATION-RETENTION-COUNT-DEFAULT dev:<directory> n password
 Default n - 1
NO ARCHIVE-ONLINE-EXPIRED-FILES
NO SECURE
OFFLINE-EXPIRATION-DEFAULT dev:<directory>date or +n
 Default n - 90
ONLINE-EXPIRATION-DEFAULT dev:<directory>date or +n
 Default n - 60
PASSWORD dev:<directory>
old password
new password
new password
PROTECTION dev:<directory> octal protection code password
 Default code - 777700
SECURE str:<directory>
ENTRY-VECTOR octal or symbolic
memory location
octal or symbolic length
between 1 and 777
Default length - 1
FILE ACCOUNT filespecs account
EPHEMERAL filespecs
EXPIRED filespecs
GENERATION-RETENTION-COUNT filespecs n
 Default n - 1
INVISIBLE
NO EPHEMERAL filespecs
PERMANENT filespecs
PROHIBIT filespecs
RESIST filespecs
SAVE-BY-BACKUP-SYSTEM filespecs
SECURE filespecs
PERMANENT filespecs
TEMPORARY filespecs
UNDELETABLE filespecs

OFFLINE-EXPIRATION filespecs date or +n
ONLINE-EXPIRATION filespecs date or +n
PERMANENT
PROHIBIT filespecs
PROTECTION filespecs octal protection code
 Default code - 777700
RESIST filespecs
SAVE-BY-BACKUP-SYSTEM
SECURE filespecs
TEMPORARY
UNDELETABLE
VISIBLE
HOST node-name:: /CTERM
/NRT
LATE-CLEAR-TYPEAHEAD
LOCATION node-name Default node-name - your host node
MAIL-WATCH user-name message-count
NAME fork-name
NO ADDRESS-BREAK
ALERT
AUTOMATIC
CONTROL-C-CAPABILITY
DEFAULT CARDS
COMPILE-SWITCHES file type or *
PAPER-TAPE
PLOT
PROGRAM
PRINT
SUBMIT

LATE-CLEAR-TYPEAHEAD
MAIL-WATCH user-name
RETRIEVAL-WAIT
STATUS-WATCH
TIME-LIMIT
TRAP <RET>
FILE-OPENINGS
JSYS /ALL
/DEFINED
/UNDEFINED
name
number

UUO-SIMULATION
PAGE-ACCESS octal page numbers COPY-ON-WRITE
EXECUTE
NO COPY-ON-WRITE
WRITE

NONEXISTENT
READ
WRITE
PASSWORD dev:<directory>
old password
new password
new password
PROGRAM fork-name EPHEMERAL
KEEP CONTINUE
REENTER
START

NO-EPHEMERAL
NONE
REMOTE-PRINTING CHARACTERISTICS name value
PRINTER name remote queue
LATserver port
LATserver service
alias
DQS node
LAT server

SYSTEM-DEFINITIONS
RETRIEVAL-WAIT
SESSION-REMARK remark of up to 39 characters
SPOOLED-OUTPUT IMMEDIATE
DEFERRED
STATUS-WATCH,
   @@INTERRUPT
@@NO
@@PAGES
@@TOPS-10-PAGES
TAPE
DENSITY 200
556
800
1600
6250
SYSTEM-DEFAULT

FORMAT ANSI-ASCII
CORE-DUMP
HIGH-DENSITY
INDUSTRY-COMPATIBLE
SIXBIT
SYSTEM-DEFAULT

PARITY EVEN
ODD

RECORD-LENGTH n bytes Default n - 512
TERMINAL feature or type
TIME-LIMIT n
TRAP FILE-OPENINGS
JSYS /ALL
/DEFINED
/UNDEFINED
name
number

NO <RET>
FILE-OPENINGS
JSYS /ALL
/DEFINED
/UNDEFINED
name
number

PROCEED

PROCEED
TYPEOUT MODE NUMERIC
SYMBOLIC
UUO SIMULATION
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,
  @@AFTER n
  @@ALL
  @@EXECUTE
  @@NONE
  @@READ
  @@WRITE
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

ALERT date and hh:mm
hh:mm
+hh:mm
day-of-week and +hh:mm
TODAY and +hh:mm
message
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 given.

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.

Default

DEFAULT CARDS /switch(es)
COMPILE-SWITCHES file type /switch(es)
PAPER-TAPE /switch(es)
PLOT /switch(es)
PROGRAM EPHEMERAL
KEEP argument
NO-EPHEMERAL
NONE

PRINT /switch(es)
SUBMIT /switch(es)
TAKE ALLOW
DISALLOW

ECHO
NO ECHO
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 given command.

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
PASSWORD:password
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
PASSWORD:password
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 DIRECTORY.

Default n - 1

DIRECTORY NO ARCHIVE-ONLINE-EXPIRED-FILES prevents on-line files that have expired from being automatically archived

Default

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.

Default

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 creation date.

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
Password:password
establishes for the directory a protection code constructed (by addition) from the values shown below. Check with INFORMATION DIRECTORY.
77 full access to the directory
40 access to files in the directory (including expunging individual files), consistent with the file protection of the files
10 connect to the directory without giving a password, undelete files, expunge the entire directory, and change times, dates and accounting information for files. All other access is governed by the file protection of each file.
04 create files in the directory
00 no access to the directory

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.
ENTRY-VECTOR octal or symbolic
memory location
octal or symbolic length
between 1 and 777
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 subcommand.

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 expunged.

Default

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.

Default

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 subcommand.

Default

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.

Default

FILE NO UNDELETABLE filespecs specifies that the file can be deleted.

Default

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.
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 access the file using wildcarded file specifications
00 no access to the file

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.

Default

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.

Default

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 FORK-STATUS.

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
SET PROGRAM SQUARE EPHEMERAL

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.

Default

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 COMMAND-LEVEL.

Default

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.
NO DEFAULT CARDS
COMPILE-SWITCHES file-type
PAPER-TAPE
PLOT
PRINT
PROGRAM EPHEMERAL
KEEP
NO-EPHEMERAL
NONE

SUBMIT
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.

Default

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

Default

NO RETRIEVAL-WAIT tells the system to send an error message if your job attempts to use off-line files.

Default

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 TRAP command.

Default

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.

Default

NO TRAP JSYS /ALL
/DEFINED
/UNDEFINED
name
number
nullifies the effects of the SET TRAP JSYS command, disabling the TOPS-20 feature that causes traps to occur when a JSYS is executed.

Default

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.
COPY-ON-WRITE provides programs with private copies of the specified pages (13:17, 21 specifies pages 13 through 17 and page 21, 6 pages in all) of current memory whenever they try to change (write to) them
EXECUTE allows programs accessing these pages to execute the instructions they may contain
NO COPY-ON-WRITE
WRITE
prevents programs from performing the indicated operation on the specified pages
NONEXISTENT removes the indicated pages from memory
READ permits programs to examine the indicated pages of memory
WRITE permits programs to change as well as examine the indicated pages

Check the status of current memory pages with INFORMATION MEMORY-USAGE.

PASSWORD
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.

PROGRAM fork-name KEEP CONTINUE
REENTER
START
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.
REMOTE-PRINTING CHARACTERISTICS name value
PRINTER name remote queue
LATserver port
LATserver service
alias
DQS node
LAT server

SYSTEM-DEFINITIONS
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:

  • the letters of the alphabet
  • the digits 0 through 9
  • the symbols _(underscore) and $ (dollar sign)

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:

  • an actual remote printer queue (such as XEROX defining SI$8700 on VAXNOD)
  • a LATprinter port or service (such as LN03 defining LBBNA129 on LAT990)
  • another alias (such as FAST defining XEROX).

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.
SPOOLED-OUTPUT IMMEDIATE
DEFERRED
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

STATUS-WATCH,
   @@INTERRUPT
@@NO
@@PAGES
@@TOPS-10-PAGES
sets an interrupt character that displays the status of all open, non-execute files mapped to the current fork. The display includes:
  • the job file number. The JFN identifies a file to the job. The user program uses the JFN in all references to the file.
  • the file specification.
  • file pages mapped to a process.
  • file position and byte size displayed in the form "Byte nn(mm)" where nn is the byte pointer and (mm) is the byte size. Not displayed if file position is zero.
  • file size displayed in the form "Page nn of mm" where nn is the page being read and mm is the total number of pages in the file. If a single number is displayed, as in "Page nn", nn is the total number of pages in the file. For example, "Page 5 of 9" represents a 9-page input file where page 5 is currently being read. "Page 11" represents an output file where 11 pages have been created. Note that some programs do not read the input file sequentially.
  • The mode of access (read, write and append) for which the file has been opened.
  • 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.

TAPE DENSITY 200
556
800
1600
6250
SYSTEM-DEFAULT
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

TAPE FORMAT ANSI-ASCII
CORE-DUMP
HIGH-DENSITY
INDUSTRY-COMPATIBLE
SIXBIT
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 TAPE-PARAMETERS.

Default - SYSTEM-DEFAULT

TAPE PARITY EVEN
ODD
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.
TRAP JSYS /ALL
/DEFINED
/UNDEFINED
name
number
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 Example 6.

Default - /DEFINED

NOTE
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.
TRAP NO JSYS /ALL
/DEFINED
/UNDEFINED
name
number
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 PROGRAM-STATUS.

Default

TYPEOUT MODE NUMERIC
SYMBOLIC
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.

Default

Characteristics

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.

SYSTEM:REMOTE-PRINTING.CMD

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.

Hints

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

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 instance:
SET REMOTE-PRINTING PRINTER ODIE LASER LAT1
SET REMOTE-PRINTING PRINTER GARFIELD LASER VAXNOD

Restrictions

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.

Examples

  1. Set the LATE-CLEAR-TYPEAHEAD parameter for your job.
    @SET LATE-CLEAR-TYPEAHEAD
    
  2. 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 set.
    @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.
    
  3. 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)
    
  4. 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
    
  5. 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]
    
  6. 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]
    
  7. 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]
    
  8. 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
    
  9. 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>
    
  10. 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
    
  11. 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
    @
    
  12. 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
    
  13. Run an ephemeral system program and disable the program's ephemeral attribute.
    @SET PROGRAM CHANGE NO-EPHEMERAL
    @CHANGE
    CHANGE>
    

    or

    @R CHANGE
    CHANGE>
    
  14. 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.

  15. Define the name of the remote printer queue SI$8700 on node OURVAX to XEROX.
    @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
    @
    
  16. 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:

    @PRINT MYFILE.MEM/REMOTE-PRINTER:LN03
    
  17. Set some remote printer characteristics.
    @SET REMOTE-PRINTING CHARACTERISTIC P90 52 ;portrait 90 wide
    @SET REMOTE-PRINTING CHARACTERISTIC BOLD 61
    @