NAME
  telephone

SYNOPSIS
  setup telephone
  telephone [-match=field] [-exact|-noexact] [-field1] [-field2] [...] name

DESCRIPTION

  The telephone command provides the Fermilab phone extensions, mail station,
  university affiliation (visitors) or lab section (employees), experiment
  number, and email address (when published) for all employees, visitors, and
  contractors at Fermilab.  Additionally, for on-site nodes (those within the
  fnal.gov (131.225) domain), id number, on-site pager numbers, and long-
  range pager numbers are provided (when published).

  You can find somebody based upon a match in any defined field (listed
  below) or portion thereof (with the -noexact option when necessary) and
  specify any defined field for output.  The name field is the value that
  you're trying to match.  The default field to match is the last name.

  By default, the output will contain the name, Fermilab extension(s), mail
  station, and email address (when published).  If you need other informa-
  tion, specify the desired fields as options on the command line.

  If you are unsure of the spelling, use the -noexact option and include only
  the portion of the name that you are sure of.

  New! You can now (as of telephone v1_2) use the -match=soundex (equivalent
  to -match=soundslike) option and give the spelling your best shot!  The
  "soundex code" of the last, first, and middle names is now a keyed field
  available for matching.  You enter a string that "sounds like" either the
  first, middle, or last name of somebody, and specify the -match=soundex
  option.  You will see a list of all persons whose last, first, or middle
  name "sounds like" the string you entered.  The soundex algorithm in use
  has been designed to match the State of Illinois Department of Motor Vehi-
  cles output; note that this means you must correctly match the first letter
  of the name.

  For some fields, the default is to perform an exact match.  For other
  fields, the default is an inexact match (match any portion of the field).
  At this time, wildcards and globbing are not supported.  The default value
  of the exact option is specified below in the list of available fields, and
  will usually suffice.

  The matching algorithm is case-insensitive; all data in the database is in
  uppercase, so the input is converted to upper case for matchine purposes.

  The allowable fields (both for matching on input, and for specifying as
  output) are:

  last
    Synonym for soundex.  (always set to be an exact match to the soundex
    code of the input string)

  name
    Entire name (first + middle + last) (default = non-exact match)

  idnumber
    Numerical portion of the ID (default = exact match)

  idtype
    Badge-type portion of the ID (N=employee, V=visitor, C=contractor)
    (default = exact match)

  id
    Entire ID field, in the form 12345X (default = exact match)

  email
    Email address (when published) (default = exact match)

  mail_station
    Fermilab mail station (default = exact match)

  extension
    Fermilab phone extension(s) (default = exact match)

  phone
    Synonym for extension.  (default = exact match)

  location
    Physical location (default = non-exact match)

  affiliation
    University affiliation or Fermilab Section name.  (default = non-exact
    match)

  university
    Synonym for affiliation.  (default = non-exact match)

  home_phone
    Home phone number (no spaces, no dashes; includes area code) (default =
    exact match)

  pager
    On-site pager number (default = exact match)

  lrpager
    Long-range pager number (no spaces, no dashes; includes area code)
    (default = exact match)

  po_box
    P.O. Box portion of the home address (default = non-exact match)

    Any portion of the home address (default = non-exact match)

  experiment
    Experiment number (default = non-exact match)

  full_text
    Match any portion of the record, or output the entire record (default =
    non-exact match)

  all
    Synonym for full_text.  (default = non-exact match)

  any
    Synonym for full_text.  (default = non-exact match)

EXAMPLES

  $ tele carpenter
    In this case, you'll get the default output values (name, extension(s),
    mail station, and email address) for anybody with the last name (default
    match field) of CARPENTER.

  $ tele -match=first lauri
    In this case, you're looking for the default output values for anybody in
    the database with a first name of "LAURI".

  $ tele -match=first -noexact lauri
    In this case, you'll get the output for all people with a first name
    which contains the string "LAURI", including "LAURIE", "LAURI", "ALLAU-
    RIET", etc.

  $ tele -match=phone -university -experiment 2214
    In this case, you're looking for the default output plus the university
    affiliation and experiment number for anybody with a Fermilab phone
    extension of 2214.

  $ tele -match=id -all 07429n
    In this case, you're looking for all available information on everybody
    with the ID number 07429N.

  $ tele -match=any XYZ -full
    In this case, you're looking for the complete output (all available
    values, subject to whether you're onsite or offsite) on all records with
    an XYZ in them.

  $ tele -match=mail_station 369
    In this case, you're looking for everybody at mail station 369.

  $ tele -match=soundex lauri
    In this case, you'll see everybody who has a last, first, or middle name
    that matches the soundex code for "lauri" -- i.e., names that start with
    the letter L and "sound like" lauri.

AUTHOR
  Lauri Loebel Carpenter (lauri@fnal.gov)
  Fermilab Computing Division
  with special thanks to
  Randolph J. Herber (herber@fnal.gov)
  for contributing the soundex algorithm and assisting with testing and
  development.