SECTION II

ID COMMANDS


The Time Shared Basic System provides the operator with five commands to
modify or examine the system ID table.  The ID table contains one entry for
every user recognized by the system, consisting of the following information:

              User's IDcode

              Password

              Total terminal time used to date (in minutes)

              Maximum terminal time allowed the user

              Amount of disc used for library storage (in sectors)

              Maximum amount of disc storage allowed

The IDcode A000 is reserved for the system operator.  The programs saved
by user-A000 become the publicly accessible library.  User-A000 also has
access to special library commands, PROTECT and UNPROTECT.  See Section VII
for complete details.

Use of ID Commands

The ID Commands taken together control who will have access to a particular
Time Shared Basic System and how much of the system's facilities each will be
allowed.  Each user's history with the system can be traced logically in the
ID Commands referencing his IDcode.  The user is entered into the system and
assigned a password with the NEWID Command.  Later that password may be
changed if the user finds that unauthorized persons have learned his password
and are using his IDcode (CHANGE Command).  Or the user may personally re-
quest the operator for more disc storage space or terminal time (CHANGE Com-
mand).  At some point an accounting process will take place and the user may
be charged for his total time and disc space used (REPORT Command).  At that
time the user's terminal time clock will probably be turned back to reflect
his payment for time used to date (RESET Command).  And eventually the user
may no longer desire the services of the system and his IDcode will be re-
moved (KILLID Command).


NEWID

The NEWID command is used to enter a new user into the system.
The command establishes a unique IDcode and password for each
user, plus maximum limits on terminal time and disc storage.

             NEWID-IDcode,password,time,disc

IDcode - Consists of a letter followed by three decimal digits.

password - Consists of 0 to 6 characters other than NULL (^@),
           RUBOUT, ALT-MODE, ESCAPE, COMMA, "_", space, RETURN
           (^M), LINEFEED (^J), or XOFF (^S).  Non-printing char-
           acters other than these are allowed.  Some characters
           can be made into non-printing characters by depressing
           the CONTROL KEY while striking the character.  This
           allows the user to define a secret password which is
           never printed out on the teleprinter.  Such a combin-
           ation is symbolized by superscript "c" following the
           character, for example Zc.

time - Specifies the maximum number of minutes of terminal time
       the user is allowed.  This number may not exceed 65535.

disc - Specifies the maximum number of disc sectors that the user
       is allowed for storage of his library programs and files.
       This number may not exceed 65535.
Examples of NEWID Commands NEWID-A000,MASTER,1000,1000 establishes user-A000 with the password MASTER, 1000 minutes of terminal time, and 1000 sectors (i.e., 64000 words) of disc storage.
NEWID-Q123,BS,100,100 establishes user-Q123 with the actual password BASIC where the A, I and C are non-printing characters. (Remember that A, I, and C are actually typed after the B and the S, but with the control key depressed.) User-Q123 is allowed 100 minutes of time an 100 sectors (i.e., 6400 words) of disc storage. The following diagnostic messages may be printed in response to a NEWID Command: Message Meaning ILLEGAL FORMAT Indicates that one of the parameters was illegal or missing DUPLICATE ENTRY Indicates that the specified IDcode already exists within the system. ID TABLE FULL Indicates that the ID-table cannot accomodate any more entries.

CHANGE

The operator may use the CHANGE command to modify any or all of
the parameters that were established with the NEWID Command.

             CHANGE-IDcode, [password], [time], [disc]

The parameters have the same meaning as in the NEWID Command.
Those in brackets may be missing, in which case they are not
changed.  However, the commas must be present if they are neces-
sary to keep the place of missing items (i.e., trailing commas
are not required).
Examples of CHANGE Commands CHANGE-Q123,BASIC changes the password of user-Q123 from BASIC to BASIC. The time remains at 100 minutes and the disc storage at 100 sectors. CHANGE-Q123,,1000 changes the terminal time allotment of user-Q123 from 100 minutes to 1000 minutes. The other parameters remain unchanged. CHANGE-Q123,,,500 changes the disc storage allotment of user-Q123 from 100 sectors to 500 sec- tors. The other parameters remain unchanged. The following diagnostics may be printed in response to a CHANGE Command:
Message Meaning ILLEGAL FORMAT Indicates that one of the parameters of the CHANGE Command was illegal or missing. NO SUCH ID Indicates that the specified IDcode could not be changed because it had not been previously entered into the system via a NEWID Command. Allotment of disc storage via the CHANGE or NEWID Commands does not actually reserve a particular area of disc for the user at that time, nor does it guarantee that he will be able to obtain that much when he wants it. The amount assigned is merely a limit which he is not permitted to exceed. When the user requests storage beyond his allotment, the following message is printed on the user teleprinter: FILE SPACE FULL When the user goes over his allotted terminal time, the system makes a note of the fact but does not abort the user. However, the next time that this user attempts to log onto the system, he will get the following message: NO TIME LEFT

KILLID

                           KILLID-IDcode

The KILLID Command gives the operator power to remove a user
from the system completely.  User-A000 may not be killed.  Any
disc files or library programs assigned to the user are removed
and the space is returned to the system.  If the specified user
is currently logged in at a terminal and executing, he will be
forcibly disconnected from the system.  If the user is connect-
ed via data phone, the system will hang up.  If the user's
teleprinter is directly connected to the system, it will
not remain active.  If the user attempts to log in with his old
IDcode, the following message will be printed:

                      ILLEGAL ACCESS
Examples of KILLID Commands KILLID-Q123 KILLID-S356

RESET

                       RESET-IDcode,time

The system maintains a clock of total terminal time used for
each user.  The operator may change the value recorded in the
clock with the RESET command.  If no time is specified, it is
assumed to be zero.  If no IDcode is specified, all users are
reset to zero.
Examples of RESET Commands If user Q123 has accumulated 100 minutes of terminal time, the command RESET-Q123,20 would reset his clock to 20 minutes of terminal time used. If user S356 had used 157 minutes of terminal time, the command RESET-S356,0 would reset his clock to zero. Or, RESET-S356 would accomplish the same thing. If no parameters are given, all users will be reset to 0 minutes used.

REPORT

The format for a REPORT Command is simply the word REPORT.  The
REPORT command causes a list of users to be printed out giving
the total terminal time and disc storage used by each.  The out-
put is in the following form:

                      IDcode time disc

where time is in minutes and disc is the number of sectors.
IDcodes are printed in alphabetic order and in ascending numer-
ical order when more than one IDcode begins with the same letter.
Example of a REPORT Command REPORT ID TIME DISC ID TIME DISC ID TIME DISC A000 07851 00112 K456 00023 00232 S356 00001 00000 NOTE: Each line of the REPORT ends with X-OFF return linefeed allowing a tape to be punched for automatic processing under program control.