*line   1: Unknown output type = 
>*line   1: UNKNOWN DIRECTIVE G


doc:style1.lay
$G
*line   2: UNKNOWN DIRECTIVE G
jhb:smmods.lay
$G
*line   3: FAULTY FORMAT AT .
$A tab=0.10",0.25",0.5",2.0",3.5",4.5"
APM Note 6.?
4 Oct 84
JHB

*line   5: UNKNOWN DIRECTIVE U
Files Giving Information About the System
$B1 $U
*line   6: UNKNOWN DIRECTIVE U
$U

The filestore provides useful systems information via a number of
special "files".  These are indistinguishable from real files to the
user but are generated "on-the-fly" by the filestore.

These special files include..

$:UNOS
$:PORTS
$:XNOS
$:DIRECTORIES
$:BITMAP.n                              for each partition n
$:TRACE

u:DIRECTORY                             for each user u

The system manager administration program maintains a database giving
information about owners of directories.  This lives in
MANAGR:ADMIN.DAT.

*line  24: UNKNOWN DIRECTIVE U
$B1 $U
($:UNOS)

bytes                   Field                   Comments

3                       User number (UNO)       decimal
*line  29: OVER TEXT T
4                       Filestore port ("Context") or -2decimal
$B0 $T3 $T6
2                       <sp><sp>
2                       User Station            hex
3                       User port               decimal
7                       User name               right-justified
1                       Priveleged indication ('!')
7                       Directory name          right-justified
2                       <sp><sp>
*line  37: OVER TEXT T
14                      Date and time user logged onDD/MM/YY HH:MM
$B0 $T3 $T6
2                       <sp><sp>
*line  39: OVER TEXT T
14                      Date and time UNO was last used"
$B0 $T3 $T6
2                       <sp><sp>
*line  41: OVER TEXT T
$B0 $T3 $T6
14                      Date and time XNO last used by this UNO"
1                       <linefeed>

78                      Total                   Fixed format

User station and port are blank for UNO = 0 [ANON] and UNO = -2 [?]

*line  48: UNKNOWN DIRECTIVE U
$B1 $U
($:PORTS)

Bytes                   Field                   Comments

*line  52: OVER TEXT T
3                       Filestore port ("Context")Decimal
$B1 $T3 $T6
4                       User Station            Hex
3                       User port
2                       <sp><sp>
*line  56: OVER TEXT T
14                      Date and time port was attachedDD/MM/YY HH:MM




$B0 $T3 $T6


2                       <sp><sp>
*line  58: OVER TEXT T
14                      Date and time port last used"
$B0 $T3 $T6
1                       <linefeed>

43                      Total                   Fixed format



























































*line  63: UNKNOWN DIRECTIVE U
$N $U


($:XNOS)

3                       XNO
3                       UNO associated with this XNO
3                       Filestore port ("Context")
1                       <sp>
21                      File name or "Special File"
*line  70: OVER TEXT T
5                       Next file block to be read* starts at 1
$B0 $T3 $T6
5                       Last extent read        * starts at 0
*line  72: OVER TEXT T
6                       Next disc block to be read*
$B0 $T3 $T6
3                       Current extent          *
1                       "/"                     *
3                       Extents in file         *
1                       <sp>
5                       Blocks in file
2                       <sp><sp>
14                      Time XNO was last active
1                       <sp>
1                       "R" (read operations) | "W" (write operations)
1                       "L" (last block has gone)
1                       <linefeed>

79                      Total                   ?Fixed format

*line  87: UNKNOWN DIRECTIVE U
$B1 $U
($:DIRECTORIES)

4                       Cache Slot
3                       <sp><sp><sp>
8                       Directory owner         left-justified
1                       "("
1                       partition
1                       "."
3                       user directory number
1                       ")"
5                       Reference count: No. of entities referencing
this directory:
                        1/Logged on user + 1/File open + 1/Default ??
5                       <sp><sp><sp><sp><sp>
5                       Time Stamp
                        "** Written **"
1                       <linefeed>

                        Total

*line 106: UNKNOWN DIRECTIVE U
$B1 $U
($:BITMAP.n (0 <= n <= max partition))
8000                    Bitmap of available pages on the filestore disc.
0 = ??; 1 = ??

*line 110: UNKNOWN DIRECTIVE U
$B1 $U
($:TRACE)

4                       Index of first trace record

4                       "Context"               *
4                       In (=0) | Out (=1)      *
56                      Text                    * String (55)

4                       Index of last trace record The file has TBUFFS
entries (see system:config.inc) each of format (the fields marked '*')
with a leading first entry pointer and trailing last entry pointer.





*line 124: UNKNOWN DIRECTIVE U
$N $U


(u:DIRECTORY)

The file consists of a complete list of the files of the directory, one
per line in date order (Last accessed file first).  Lines are of varying
length and terminate with a linefeed.

*line 130: UNKNOWN DIRECTIVE U
$B1 $U
(MANAGR:ADMIN.DAT)

This is an indexed sequential file of 128-byte records comprising a
header record followed by one record for each top-level directory.
Directory records are sorted in increasing alphabetical order.

Header Record
4                       Number of directory records in file (not
counting header)
104                     Index into file.  This is an integerarray
A('A'-'Z')              Entries are record numbers, counting from the
header (= 0)            and indicate the point from which a search
should start.
10                      Spare

Directory Records
8                       Directory ID            String (7)

36                      {Prenames               String (35)
16                      {Surname                String (15)
or..

52                      {Description            String (51)

16                      Supervisor              String (15)
2                       Group                   Shortinteger
*line 155: OVER TEXT T
2                       Bitmap of F'stores this no. is on.Shortinteger
$B0 $T3 $T6
10                      Creation Date           String (9)
*line 157: OVER TEXT T
10                      Date after which directory may be deletedString
$B0 $T3 $T6
(9)
*line 158: OVER TEXT T
$B0 $T3 $T6
28                      Mail Address of owner or supervisorString (27)

The Description option is used for systems directories.  All
"Description" strings start with '!'.

The Dates are string(8)s with one extra byte for alignment.

Groups:
0: Unknown                              1: Essential systems directories
2: Additional Systems directories       3: Staff
4: Postgrads                            5: CS4
6: CS3                                  7: CS2
8: CS1                                  9: IS1
10: Visitors                            11: Public directories
12: Other Departments                   13: ERCC
Bit 15: "Trusted" bit                   Bit 14: "Ex-" bit
Bit 13: Laser printer bit               Bit 12: Female Bit

FS accredit bits
Bit 0: alpha                            Bit 1: bravo
Bit 2: charlie                          Bit 3: portable
Bit 4: vax                              Bit 5: old

The Include file MANAGR:ADDEFS.INC contains specs for the above record






formats.  MANAGR:ADMIN.INC contains the routines FIND DIR and SHOW DIR
which access the database.  NOTE: The format of the database is a quick
fudge and is far from ideal.  Anyone writing utilites which use it are
advised to contact JHB first: The format may change with little notice
and access should be channeled through MANAGR:ADMIN.INC where possible,
which may entail adding new routines.

*line 189: UNKNOWN DIRECTIVE U
$B1 $U
(MANAGR:NS.DAT) *** Note *** This facility is still under development
and may change without notice.  If you are writing software to use it
you are advised to notify JHB.  This file is a pair of tables, indexed
by station number giving a short and long destription of the APM at the
specified station number.  The short table is intended for quick name
<-> address translation and the long one is a database for housekeeping
and general reference.  The table comprises 128 8-byte fields followed
by 128 64-byte fields.  All "strings" are stored as bytearrays padded to
right with characters <= ' ' with no length byte. (To save space) The
8-byte fields are simply the station short names in station number
order.  APMs are designated by names starting with an '@' character.
The 64-byte fields are records of type NS LFM (specified in
MANAGR:NSDEFS.INC) in station number order..

bytes                   Field                   Comments
1                       "In" or "On" designationsee note [5]
1                       "Room" designation      see note [5]
*line 214: OVER TEXT T
31                      Long text name of stationBytearray padded
$B0 $T3 $T6
1                       Case Number             see note [6]
8                       Spare
4                       Supplementary address information (eg Room
number)                                         Bytearray padded
18                      Backplane Map.          see note [7]

64                      Total

[5]                     These fields taken with the long text name give
a "user-friendly" description of the location. "In"/"On" takes values..
'I'                     In
'O'                     On
'A'                     At
' '                     No special description

"Room" takes values..
'R'                     to indicate the description refers to someone's
room
'T'                     to indicate it is the something-or-other
' '                     No special description

Examples..
'I''R' John Butler -> In John Butler's Room
'O''T' Test Rig -> On the Test Rig

[6] Note to systems staff - This field may cause alignment problems if
moved
[7] The backplane map should indicate what is in each of the 16
backplane slots plus an indication of what mouse and display is being
used.  Position is irrelevant.  Each entry can take the value..

'A'                     0.5 Mb Memory Board
'B'                     1.0 Mb Memory Board
'C'                     Processor Board (8 MHz)
'D'                     Processor Board (10 MHz)






'E'                     Ethernet Board
'G'                     Level 1 Graphics
'H'                     Level 1.5 Graphics
'J'                     Level 2 Graphics
'L'                     2.0 Mb Memory Board
'M'                     Mouse
'X'                     MIT Graphics Monitor
'Y'                     DJR/MIT Monitor

MANAGR:NS.INC contains a set of routines for accessing the file.  It is
suggested that all NS.DAT access be channeled through these routines
(adding new ones if necessary) so the file format can be changed without
too much difficulty. (Which will be necessary if ISO-style Ethernet
addresses are to be handled or if the A.T.  Ethernet address space
overlaps that of KB.





















































Program stopped
