Google
 

Trailing-Edge - PDP-10 Archives - BB-PBQUC-BM_1990 - help/set.hlp
There are 3 other files named set.hlp in the archive. Click here to see a list.
SET command

The SET command 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

     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

              ---
              | CARDS  /switch(es)
              | COMPILE-SWITCHES file type  /switch(es)
              | PAPER-TAPE  /switch(es)
     DEFAULT  | PLOT  /switch(es)
              | PRINT  /switch(es)
              | SUBMIT  /switch(es)
              |     ---
              |     | ALLOW
              |TAKE | DISALLOW
              ---   |
                    | ECHO
                    | NO ECHO
                    ---

                  ---
                  | ACCOUNT-DEFAULT dev:<directory> account
                  | password
                  |
                  | ARCHIVE-ONLINE-EXPIRED-FILES
                  | FILE-PROTECTION-DEFAULT dev:<directory> octal code
                  | password
                  |      Default code - 777700
                  | DIRECTORY GENERATION-RETENTION-COUNT-DEFAULT
                  | dev:<directory> n password
                  |      Default n - 1
     DIRECTORY    | 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 | octal or symbolic length
                    | memory location   | between 1 and 777
                    ---               ---
                           Default length - 1

               ---
               | ACCOUNT  filespecs account
               | EPHEMERAL filespecs
               | EXPIRED filespecs
               | GENERATION-RETENTION-COUNT filespecs n  Default n - 1
               | INVISIBLE
               |    EPHEMERAL filespecs
               |    PERMANENT filespecs
               | NO PROHIBIT filespecs
     FILE      |    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

          ---
          | ADDRESS-BREAK
          | ALERT
          | AUTOMATIC
          | CONTROL-C-CAPABILITY
          |          ---
          |          | CARDS
          |          | COMPILE-SWITCHES  file type or *
          |          | PAPER-TAPE
          | DEFAULT  | PLOT
          |          | PROGRAM
          |          | PRINT
     NO   |          | SUBMIT
          |          ---
          |
          | LATE-CLEAR-TYPEAHEAD
          | MAIL-WATCH user-name
          | RETRIEVAL-WAIT
          | STATUS-WATCH
          | TIME-LIMIT
          |      ---
          |      | <RET>
          | TRAP | FILE-OPENINGS
          |      |     ---
          |      |     | /ALL
          |      |     | /DEFINED
          |      | JSYS| /UNDEFINED
          |      ---   | name
          |            | number
          |            ---
          | UUO-SIMULATION
          ---
                                           ---
                                           | COPY-ON-WRITE
                                           | EXECUTE
                                           |
                                           |    ---
                                           |    | COPY-ON-WRITE
     PAGE-ACCESS  octal page numbers       | NO | WRITE
                                           |    ---
                                           |
                                           | NONEXISTENT
                                           | READ
                                           | WRITE
                                           ---

     PASSWORD dev:<directory>
     old password
     new password
     new password

                        ---
                        | EPHEMERAL
                        |      ---
                        |      | CONTINUE
     PROGRAM fork-name  | KEEP | REENTER
                        |      | START
                        |      ---
                        | NO-EPHEMERAL
                        | NONE
                        ---

                        CHARACTERISTICS name value
                                     ---              --- ---
     REMOTE-PRINTING    PRINTER name | remote queue     | | DQS node
                                     | LATserver port   | | LAT server
                                     | LATserver service| ---
                                     | alias            |
                                     ---              ---
                        SYSTEM-DEFINITIONS

     RETRIEVAL-WAIT

     SESSION-REMARK remark of up to 39 characters

                     ---
                     | IMMEDIATE
     SPOOLED-OUTPUT  | DEFERRED
                     ---

     STATUS-WATCH,
          @@INTERRUPT
          @@NO
          @@PAGES
          @@TOPS-10-PAGES

                       ---
                       |  200
                       |  556
          DENSITY      |  800
                       | 1600
                       | 6250
                       | SYSTEM-DEFAULT
                       ---

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

                      ---
                      | EVEN
          PARITY      | ODD
                      ---

          RECORD-LENGTH n bytes     Default n  - 512

     TERMINAL feature or type

     TIME-LIMIT n

           ---
           | FILE-OPENINGS
           |      ---
           |      | /ALL
           |      | /DEFINED
           | JSYS | /UNDEFINED
           |      | name
           |      | number
           |      ---
           |   ---
           |   | <RET>
     TRAP  | NO| FILE-OPENINGS
           |   |      ---
           |   |      | /ALL
           |   |      | /DEFINED
           |   | JSYS | /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,
                              causes  the  program  in  memory  to  be
                              suspended and a message to be printed on
     @@AFTER n                your terminal  when the memory  location
     @@ALL                    you   specify  is  referenced  for   the
     @@EXECUTE                indicated   operation - execute,   read,
     @@NONE                   write, or any of these (ALL).  With  the
     @@READ                   AFTER subcommand you determine how  many
     @@WRITE                  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

       ---                    ---
       | date and hh:mm         |
       | hh:mm                  |
ALERT  | +hh:mm                 |             message
       | day-of-week and +hh:mm |
       | TODAY and +hh:mm       |
       ---                    ---

                              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

         ---
         | CARDS /switch(es)
         | COMPILE-SWITCHES file-type /switch(es)
         | PAPER-TAPE /switch(es)
         | PLOT /switch(es)
         | PRINT /switch(es)
         |        ---
         |        | EPHEMERAL
DEFAULT  |PROGRAM | KEEP argument
         |        | NO-EPHEMERAL
         |        |NONE
         |        ---
         | SUBMIT /switch(es)
         |      ---
         |      | ALLOW
         |      | DISALLOW
         | TAKE | 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 |  octal or symbolic length
               | memory location   |  from 1 to 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.

             ---
             | CARDS
             | COMPILE-SWITCHES file-type
             | PAPER-TAPE
             | PLOT
NO DEFAULT   | PRINT
             |          ---
             |          | EPHEMERAL
             | PROGRAM  | 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
              ---
              | /ALL
              | /DEFINED
NO TRAP JSYS  | /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

                        ---
                        | COPY-ON-WRITE
                    NO  | 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
                              help   file,   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.

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

                               o  the letters of the alphabet

                               o  the digits 0 through 9

                               o  the  symbols  _(underscore)  and   $
                                  (dollar sign)

                              To  get  information  about  the  system
                              characteristics    settings,   use   the
                              INFORMATION REMOTE-PRINTING  command  or
                              read               the              file
                              SYSTEM:REMOTE-PRINTING.CMD.

                              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:

                               o  an actual remote printer queue (such
                                  as XEROX defining SI$8700 on VAXNOD)

                               o  a LATprinter port or  service  (such
                                  as LN03 defining LBBNA129 on LAT990)

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

               ---
               | IMMEDIATE
SPOOLED-OUTPUT | 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                   sets   an   interrupt  character   that
@@NO                          displays  the   status   of   all  open,
@@PAGES                       non-execute files mapped to the  current
@@TOPS-10-PAGES               fork.  The display includes:

                               o  the  job  file  number.    The   JFN
                                  identifies  a  file to the job.  The
                                  user program uses  the  JFN  in  all
                                  references to the file.

                               o  the file specification.

                               o  file pages mapped to a process.

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

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

                               o  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.
                              Help files are provided for all  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.


                  ---
                  |  200
                  |  556
     TAPE DENSITY |  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

                  ---
                  | ANSI-ASCII
                  | CORE-DUMP
                  | HIGH-DENSITY
     TAPE FORMAT  | 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  help  file.   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

            ---
            | EVEN
TAPE PARITY | 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.

          ---
          | /ALL
          | /DEFINED
TRAP JSYS | /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.

              ---
              | /ALL
              | /DEFINED
TRAP NO JSYS  | /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
         @