1	PHONEBOOK

	PhoneBook is a VMS procedure which will allow the user to 
maintain and use a list phone numbers and addresses which can be
recalled on command.  PhoneBook can either be used interactively
or it can be used as a VMS foreign command.  To invoke it interactively
either type   CMD PHONEBOOK or define the foreign commands

	PLIST:=="@SYS$SYSROOT:[SYSMGR.CMDFIL]PLIST NUMBER "
	ALIST:=="@SYS$SYSROOT:[SYSMGR.CMDFIL]PLIST ADDRESS " .

If the foreign commands PLIST and ALIST are defined (for Phone_List and
Address_List) the following commands are available

  PLIST                 Enter interactive mode with PhoneBook.
  PLIST  search_string  Display all phone numbers belonging to
                        entries with the specified name_string.
  ALIST  search_string  Display all phone numbers and addresses
                        belonging to entries with the specified
                        name_string.
2	NAME
	Each PHONEBOOK entry has a first and last name.  The last name
may be up to 15 characters long and the first name may be up to 10
characters long.  If a carriage return is entered for the last name,
PHONEBOOK returns to the menu. A ^Z (control-Z) on any input will
also force a return to the menu.
2	NUMBER
	Each PHONEBOOK phone number consists of up to 14 characters.
The recomended form is (xxx)-xxx-xxxx for uniformity of displays.
Each phone number can have an extension of up to 4 digits.
2	COMPANY
	The company name can be up to 20 characters long.   It is 
an optional entry
2	Address
	The address consists of:

		Street Address:	30 character maximum
		City		15 character maximum
		State		 2 character maximum
		ZIP		 5 character maximum

All address entries are optional.
2	COMMENT
	The comment field in PHONEBOOK may be up to 40 characters long.
	Its entry is optional.
2	ALIST
	If the symbol ALIST is defined as a foreign command
the command 

	ALIST search_string

will produce the output (if the search string is found) of the form

	Last_name   ,First_name   Phone #  Extension
					   Company
					   Address
					   City, State, Zip
					   Comment
For example,  ALIST DOWNWARD   might display

	Downward   , James     (313)-769-8500x362
						KMS Fusion, Inc.
						3941 Research Park Dr.
						Ann Arbor, Mi  48106
						Resident DEC guru.
2	DATA_FILE

	The data for PhoneBook is kept in SYS$LOGIN:PLIST.FIL.  This
file may be edited, BUT the locations of the various starting positions
within each record MUST NOT BE CHANGED.  If you edit the file, you do 
so at your own risk.
2	PLIST

	If the symbol PLIST is defined as a foreign command
the command 

	PLIST search_string

will produce the output (if the search string is found) of the form

	Last_name   ,First_name   Phone #  Extension    Comment

For example, the command  PLIST DOWNWARD   might produce the output

	Downward      ,James     (313)-769-8500x 362	Resident DEC guru.

Note that the search string could also have been DEC or James and this
record (with possibly others would have been displayed).


2	INTERACTIVE_USE
	In its interactive mode, PhoneBook gives the user the option
to:
	1.  Add new phone numbers to the list.
	2.  Display phone numbers/addresses for a given last name.
	3.  Delete phone number entries.
	4.  Exit.
2	ADD
	When you enter ADD mode PhoneBook prompts for the
following information.

	Last name			 15 characters max
	First name			 10 characters max
	Phone number (xxx)-nnn-mmmm	 14 characters max
	Extension (xxxx)		  4 characters max
	Company name			 20 characters max
	Address				 30 characters max
	City				 15 characters max
	State				  2 characters max
	ZIP				  5 characters max
	Comment				 40 characters max

PhoneBook will reprompt if the length of th entered data exceeds
the maximum allowed for the entry.  If a RETURN is entered in
response to the last name entry request, PhoneBook returns to
the menu page.  When an entry is completed, PhoneBook will display
the entry in its entirity and ask if it is correct.  If a Y[es]
is answered, it will be entered in to the data file.  A N[o]
returns you to the 'Last Name:' input prompt. 
2	DELETE
In delete mode, you are prompted for the last name of an
entry to delete. Each entry which matches the entered string
will be displayed together with a prompt asking if that
entry should be deleted.  If a Y[es] is answered the entry
will be deleted.  A ^Y during the delete process will wipe
out all deletions made.  All deletions become permanent if a
RETURN is entered in response to the 'Last Name:' prompt. 
2	DISPLAY
In display mode, the you enter a last name to display and choose 
whether or not to also display the addresses.  The name string 
entered can be just the desired last name, part of the last name,
a unique search string (ie a company name) or some combination
of search strings each seperated by a "," from the other search
strings.  
2	EXIT

If numbers have been added to the phone book, PhoneBook will sort 
the  phone book list upon exiting.  This takes a while, be patient. 
otherwise it will just close any open files and exit.

2	SEARCH_STRINGS

     When used to display phone numbers or addresses, PhoneBook
either accepts a search string as part of the command line or 
prompts for a last name.  At this point, either a simple last name
(or part of one) or a complex search string may be entered. A
complex search string consists of multiple search strings (no 
spaces) seperated by ","s.  For example if you know your phone book
contains entries for several people named Smith and that the SMITH
of interest works for KMS you might enter   SMITH,KMS  as the
search string.  Only the data for the entry with the last name
Smith, and with the company KMS would be found.  Likewise to list
all people working for the same company (you for got the person's 
