SECTION V

MISCELLANEOUS SYSTEM COMMANDS

There are three other system commands which have not been previously
mentioned:  ROSTER, SLEEP and STATUS.

ROSTER
Up to 16 user terminals (or Data Sets) may be logged on to the TSB
System at one time.  These terminals are numbered 0 through 15 by
the TSB System.  The ROSTER Command, initiated by the word ROSTER,
allows the operator to know what user IDcode is logged on at each
terminal.

The output from ROSTER is formatted into two lines of eight items
each.  The first line lists, from the left, the users logged on
to terminals 0 through 7.  The second line lists terminals 8
through 15.  An active terminal is denoted by the IDcode of the
user logged on to it; an inactive terminal is denoted by four dots
(....).  The same ID code can be active on more than one terminal.


Examples

           ROSTER
            ....  ....  ....  ....  ....  ....  A000  ....
            ....  ....  ....  ....  ....  ....  A000  ....

      User A000 is logged on terminal 6 and terminal 14.  The remaining ter-
minals are inactive.

           ROSTER
            ....  B453  ....  B555  ....  Q123  Z999  ....
            A000  ....  ....  ....  ....  ....  ....  A000




      User B453 is on terminal 1, B555 on terminal 3, Q123 on 5, Z999 on 6,
and User A000 on 8 and 15.  The other terminals are inactive.

           ROSTER
            ....  ....  ....  ....  ....  ....  ....  ....
            ....  ....  ....  ....  ....  ....  ....  ....

      This response indicates that no one is using the TSB System.





SLEEP
The SLEEP Command is used whenever the Time Shared Basic System
is to be shut down.  The command provides a systematic shut down
procedure that allows for easy start-up at a later time.

The format of the SLEEP Command is as follows:

                  SLEEP-character string

where character string is a message to be sent to all active users.


     SLEEP causes the following actions to be taken by the TSB System:

     1.  The character string message is sent to all active users.

     2.  All users are disconnected from the TSB System.

     3.  The entire current TSB System is dumped onto the disc.

     4.  The efficiency routine is run on the library portion of the TSB
         System.

     5.  If a magnetic tape unit is available, the entire TSB System will
         be dumped onto that tape for later reloading.

     6.  The question VERIFY? is asked.  If the answer is YES, the
         tape is verified; if NO, the message DONE is printed and the computer
         halts.  After a verification, if the tape is incorrect, the message
         "TAPE BAD OR TOO SHORT" is printed.  Otherwise, the message
         DONE is printed.

To make a second system copy, mount another tape and press the RUN button
after the first tape is made and (optionally) verified.

To resume operations after sleeping, consult Section VIII, RELOADING FROM
MAGNETIC TAPE or BBDL-LOADING TSB SYSTEM FROM THE DISC.




STATUS
The STATUS Command gives the operator information about the hard-
ware defined in the system and the use of disc storage.  STATUS
should be used at least once a day to record the location of the
essential parts of the TSB System.  (For diagnostic purposes in
case of TSB System failure see Section VIII.)

Disc address are printed as three decimal numbers, separated
by slashes, which specify the disc logical number, the track
number, and the sector number.  The disc address format is
D/TT/SSS.  For example, 0/22/013 means disc 0 track 22, sector
13.

The following information is output by STATUS:

Output Heading                       Information Supplied

      IDT           The location of the TSB System IDcode table and the
                    decimal number of words stored there.  Each distinct
                    user IDcode recognized by the TSB System requires an
                    eight word entry in the IDT.  This table is essential
                    to the TSB System.

      ADT           The location of the available disc table, and the deci-
                    mal number of words used.  This table is essential to
                    the TSB System.  Every two words in the ADT represents
                    a block of available disc storage.

      DIREC         Up to four disc locations of each track, each containing
                    a portion of the directory of user library programs.
                    The number of directory tracks allocated equals the num-
                    ber of discs that have been defined on the TSB System
                    (although there is no requirement that the directory
                    tracks be distributed throughout all four discs.  That
                    is, they all could be on the same disc).  The total



                    directory consists of an alphabetic list, ordered first
                    by IDcode and then by program or file name, of all the
                    library programs which have been saved by users.  Each
                    program requires an eight word entry.

      SYSTEM        The location of the five disc tracks containing the TSB
                    System modules.  These tracks may be regenerated without
                    loss of information.

      USERS         The location of the 16 disc tracks allocated to the 16
                    possible simultaneous users.  Output is organized simil-
                    arly to that of ROSTER.  These tracks are not essential
                    to the TSB System (i.e. they may be locked during loading
                    if faulty).

      MAG           The octal I/O channels of the magnetic tape unit, auto
      PHONES        disconnect board, and disc (0 through 3)*.  An entry of
      DISC          00 indicates the absence of the device.  The track length
                    in sectors is recorded for each disc.

      TRACKS        Four rows of 64 items each, corresponding to the maxi-
                    mum possible four discs of 64 tracks each.  A 0 indicates
                    the track is available, and a 1 indicates that the track
                    is inaccessable (either LOCKED or not defined).

*An asterisk after the magnetic tape unit select code indicates an HP 7970
 tape unit controller is used (magnetic tape unit interface board no. 18131).



Example:

STATUS
IDT 0/21/000 0024  ADR 0/21/001 0254

DIREC
0/22/00 0920  0/23/000 0000  0/24/000 0000  0/00/000 0000


SYSTEM 0/00/0000 0/01/000 0/02/000 0/03/000 0/04/000

USERS
0/05/000 0/06/000 0/07/000 0/08/000 0/09/000 0/10/000 0/11/014 0/12/000
0/13/000 0/14/000 0/15/000 0/16/000 0/17/000 0/18/000 0/19/000 0/20/000

 MAG= 21*  PHONES= 16  DISC= 14-128  17-128  00-000  00-000

 TRACKS
0 0000000000000000000000000000000000000000000000000000000000000000
1 0000000000000000000000000000000000000000000000000000000000000000
2 1111111111111111111111111111111111111111111111111111111111111111
2 1111111111111111111111111111111111111111111111111111111111111111

*An asterisk here indicates that an HP 7970 controller is being used (magnetic
 tape interface board no. 18131).