RFC 274






NETWORK WORKING GROUP                                E. FORMAN
REQUEST FOR COMMENTS # 274                           MITRE
NIC # 7901                                           1 November 1971
CATEGORIES  F, G
UPDATES:    NONE
OBSOLETES:  NONE


              ESTABLISHING A LOCAL GUIDE FOR NETWORK USAGE


     Actual experiences and experimentation with network systems and
subsystems will be an important supplement to existing NIC
documentation.  For this reason, MITRE, to facilitate local user
access to network resources, is planning to establish a local GUIDE TO
NETWORK USAGE to supplement the Resources Notebook and other NIC
documentation.  The Guide will be tailored to the needs of MITRE users
and will contain information on network systems and subsystems.  (We
cannot precisely define systems and subsystems at this time but as an
example of what we have in mind, TENNEX at SRI is a system and NLS is
a subsystem.)

     The Guide will be implemented under NLS in much the same fashion
as the NIC LOCATOR SYSTEM.  Information gathered that is appropriate
for the NIC but not yet included will be submitted for inclusion in
the NIC.

     Attached is an outline of the proposed NLS files for the Guide
System.  The information included in the Guide will be sufficiently
detailed to enable local users who are unfamiliar with the network,
its terminology, and stores of reference material to utilize resources
at foreign hosts via the network.

     Sites will be included in the Guide as local users gain
experience with systems and subsystems located at the remote sites.
Therefore, the sites most likely to be in the Guide will be those that
can be used to support MITRE projects.

     We are planning to coordinate our efforts in this undertaking
with a similar effort at the National Bureau of Standards.  We believe
that such endeavors will result in valuable contributions to the NIC,










                                                                [Page 1]

particularly to the Network Resources Notebook.  Although the Guide
will be tailored for MITRE users, it will contain information of
general interest to other network users and will be made accessible to
them through NLS.

     The Guide should become operational during December 1971.  Any
comments on proposed contents of the Guide are welcome.  Anyone
wishing to cooperate in this effort should contact E. Forman at MITRE.



       [ This RFC was put into machine readable form for entry ]
       [ into the online RFC archives by BBN Corp. under the   ]
       [ direction of Alex McKenzie.                   12/96   ]





































                                                                [Page 2]

ATTACHMENT


     An NLS "Site File" will be built for each site at which a
resource is presently available to network users at MITRE.  Initial
files will be for those sites that offer resources that are of
specific interest to the local community.  A RESOURCE LOCATOR FILE
will contain a table of contents of the SITE FILES and a list of the
subsystems surveyed for each of these sites.  The headings in the
table of contents will contain links to the corresponding online site
file documents.



<MITRE> RESOURCE-LOCATOR

  O         Output processor directives

  1         Text indicating how to use this file



  2         Site identification
               (Link)
     2A     Subsystem list (with links)



  3         Next site



  4         Next site



    ...






















                                                                [Page 3]

<MITRE> SITE-FILE (one for each site)

  O         Output processor directives

  1         Text indicating how to use this file

  2         Subsystem list (with links)

  3         Periods of system availability
  4         Accounts
  4         Accounts
     4A        List of accounts at site established by MITRE personnel
       4A1     For each account indicate:
               -  users
               -  who is allowed to use this account
               -  restrictions on use of system or subsystem with
                  with this account
               -  who to ask for password and ID (if the account
                  is open to use by all, list password and allowable
                  ID's)
       4A2     Next account
     4B        How to establish a new account

  5         System charges (special subsystem charges--if any--
            will be listed with subsystem entry)



  6         System Documentation
     6A        Title
               -  Brief description
               -  NIC reference number
               -  link
               -  on hand at local station
               -  local users who have copy
               -  where to order

  7         Log in procedures (special log in procedures for sub-
            systems (if any) will be listed with the subsystem entry)



  8         Special considerations when used with the following
            local (network user) equipment:
     8A        With devices -----, -----
               -  NIC reference numbers
               -  links
               -  list of special considerations when used with this
                  system (e.g., special characteristics, half or
                  full duplex)
     8B        With devices
    ...



                                                                [Page 4]

<MITRE> SITE-FILE (continued)

  9         Comments on system usage and performance such as
            reliability, availability, recent user experience,
            bugs, differences from documentation (similar to NIC
            Journal Folklore)

 10         Subsystem " "
    10A       Brief capability description
              References and links
    10B       Subsystem documentation
     10B1       Title
                -  brief description
                NIC reference number
                -  link
                -  on hand at local station?
                -  local users who have copy
                -  where to order
     10B2       Next document

    10C       Periods of availability--same as system or list
              special subsystem availability times
    10D       Special subsystem charges if any
    10E       Log in procedures-if special log in procedure needed
              for subsystem
    10F       Special considerations when used with the following
              local (network user) equipment:
     10F1       With devices -----, -----
                  -  NIC reference numbers
                  -  links
                  -  list of special considerations when used with
                     this subsystem (e.g., special characteristics,
                     half or full duplex)
     10F2       With devices -----, -----
    ...

    10G       Comments on subsystem usage and performance such as
              reliability, availability, recent user experience, bugs,
              differences from documentation (similar to NIC
              Journal Folklore)

 11           Subsystem " "
    ...








                                                                [Page 5]