1	PHONEBOOK

	PhoneBook is a VMS utility function controlled by NoteBook, the VAX
Professional Notebook.  Its behavior is controlled by SYS$VPWFILES:VPW.TLB. 
The PhoneBook function is a system supported VPW function 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 may be invoked either from the VAX
Professional Workstation menu, or as a command, PHONEBOOK, PLIST, and ALIST. 
The command, PhoneBook, is made available at LOGIN.  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.  Modify existing phonebook entries
	5.  Exit.


  PHONEBOOK             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 required form is (xxx)-xxx-xxxx for uniformity of displays.
The (   )-   -  must be entered
2	EXTENSION

	Each PhoneBook number can also have an extension
consisting 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
The command 

	ALIST search_string

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

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

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

	The data for PhoneBook is kept in SYS$LOGIN:PHONEBOOK.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

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-8500 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	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 'Search for:' input prompt. 
2	MODIFY
     PhoneBook allows you to modify an existing entry. When
modify mode is entered, it prompts for a search string and then
starts displaying all records matching that locator. When the
proper locator is found it display the record and goes into enter
mode. Entering just a carriage return at each prompt will leave
the entry unchanged. Modify data fields as desired, and when data
entry is complete, the completed record will be displayed again
for verification. If the modification is accepted, the record is
updated. If any updates are done which change either the first or
last name, the file will be sorted before returning to the main
menu. 
2	DELETE
In delete mode, you are prompted for a search string to locate 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 'Search for:' prompt. 
2	DISPLAY
In display mode, you select a display format (address or phone
list) and then select records to display by entering a search
string. If a '*' is entered, all records in the phonebook are
displayed. The search 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

EXIT will leave cause PhoneBook to exit and the screen will be 
erased.  You also can ^Y out of PhoneBook at any time.

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 one in DELETE, DISPLAY or MODIFY mode. 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 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 name), just enter the company name.

You also have the option of selectively searching for entries only
within certain fields (such as company, area code, name, etc).
Multiple search strings should not be used for this unless all
search strings are expected to be in one of the fields selected.
