Who is Who Server Help

===============================================================================

HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP HELP
    THE HELP FILE IS BELINGUAL!!!  BE PATIENT TO PRINTOUT THE WHOLE FILE!!!

===============================================================================


     The address-guide  operates  with  Internet  users  via
letters exchange.

     To get information on the usage of  this  address-guide
just send letter with the single word HELP at the first line
to the address who_is_who@kiae.su.

     All observations and  proposals  may  be  sent  to  the
staff:
               Alexei Dolbin (dolbin@kiae.su)
                Serge Fedotov (fsi@kiae.su)

     Your suggestions are welcomed ;-).

     The address-guide  contains  information  on  following
topics:

______________________________________________________________________
| Field Tag    |  Contents of the field              |      Size     |
|--------------+-------------------------------------+---------------|
|  #L          | Tag of the English answer           | is not filled |
|  #OK         | Tag of the big answer               | is not filled |
|  %S          | site name                           |  20 chars     |
|  %D          | domain name                         |  40 chars     |
|  %P          | Post address   ( in Russian )       | 150 chars     |
|  #P          | Post address   ( in English )       | 150 chars     |
|  %C          | Abonent's name ( in Russian )       |  40 chars     |
|  #C          | Abonent's name ( in English )       |  40 chars     |
|  #E          | E-mail address                      |  55 chars     |
|  #T          | phone number                        |  30 chars     |
|  #F          | fax number                          |  30 chars     |
|  %O          | Abonent's institution ( in Russian )| 150 chars     |
|  #O          | Abonent's institution ( in English )| 150 chars     |
|  %H          | Post ( in Russian )                 |  40 chars     |
|  #H          | Post ( in English )                 |  40 chars     |
|  %Q          | Some good words about yourself      | 250 chars     |
+--------------+-------------------------------------+---------------+


     The address-guide stores information  both  in  Russian
and  in  English.   That's  why some fields of the guide are
duplicated  to  store  the  identical  information  in  both
languages.  These  fields  differ  in  tags.  The tag of the
field to store information in Russian begins with  the  per-
cent sign '%'.  The tag of the field to store information in
English begins with the number sign  '#'.   Each  field  tag
contains  only  one of the previously mentioned sign and the
Latin letter.

     The guide sends you  information  retrieved  either  in
Russian  or  in  English  language.  It is an error to place
simultaneously tags that correspond to Russian  and  English
pieces  of  information  in the same request of the "SELECT"
type.  For example, the request of the "SELECT" type  should
contain either %O or #O tags. The guide is CASE SENSITIVE.
Be carefull.

     To retrieve English piece of  information  the  request
has to contain #L field tag with no "arguments". To retrieve
Russian piece of information #L field tag should be absent.

     Because an answer may be big enough (more then  40  Kb)
there is #OK tag that means that an abonent agrees to accept
the whole retrieved data regardless to  its  size.  In  that
case  the  answer will be automatically fragmented and prop-
erly numbered.  If #OK tag is absent in the request and  the
real size of the answer is more then 40 Kb abonent retrieves
only the first part of the answer.

     Single e-mail letter may contain simultaneously several
requests to the address-guide.

     The  address-guide  operates  with  the  4   types   of
requests:  INSERT,  UPDATE,  DELETE,  SELECT  differ  in its
structure and meaning.

     Each letter has to be of the following structure:

    ---- Letter type  | <- It is either INSERT,UPDATE, DELETE or SELECT.
    Letter contents   | <- Field tags and corresponding data.
    ---- END          | <- This line has to finish request.

Abonents may execute  following  requests  to  the  address-
guide:

1)   "INSERT" To insert data in the address-guide.

         For example,

         ---- INSERT
         %S     kiae
         %D     kiae.su
         %P     123456, c.Moscow, Rogovaja st.200-10-189
         #P     123456, c.Moscow, Rogovaja st.200-10-189
         %C     Aleks Dolbin
         #C     Aleks V. Dolbin
         #E     dolbin@kiae.su
         #T     (8 095) 196 72 12
         #F     No
         %O     KI's Computing Cetner
         #O     KI's Computing Cetner
         %H     programmer
         #H     programmer
         %Q     Very dead shooter
         ---- END


     Note. You have to insert data considered to  be  impor-
     tant  to other address-guide users.  After execution of
     the request all this information will  be  inserted  in
     the address-guide.

2)   "SELECT" To retrieve data from the address-guide.

         For example,

         ---- SELECT
         #P     Moscow
         #C     Peter
         ---- END

     Note. You have to place field tags and patterns in  the
     request  to  execute  data  retrieval according to pat-
     terns. In this example will  be  retrieved  information
     about all abonents having string 'Moscow' in their post
     address field and string 'Peter' in their name field.

     Despite you place not all field tags in your request in
the  answer  all  fields corresponding to English or Russian
information retrieved will be present according to  patterns
specified in the request.

     It  is  possible  to  specify  restricted  patterns  in
request.   If it is necessary to specify compound pattern at
the same field  tag  you  have  to  concatenate  strings  of
literals  by the percent '%' sign.  This sign in the pattern
means any number of characters between parts of  the  string
it separates.

    For example,

    #C     William%Maugham

This string means that will  be  retrieved  all  information
about mr.Maugham whose first name is William.

     During execution of the request  information  specified
at field tags is united in the logical condition by the log-
ical  'AND'  operators.   In  the  example  above  will   be
retrieved information about all abonents having string 'Mos-
cow' in their post address field AND string 'Peter' in their
name field.

3)   "UPDATE" To update data in the address-guide.

         For example,

         ---- UPDATE
         #E     dolbin@kiae.su
         #P     123479, c.Moscow, Petrovka st.38
         #T     (8 095) 146 11 22
         ---- END

     Note. In the request of the "UPDATE"  type  field  tags
     corresponding  to the updated fields are specified with
     the data to be updated. In that operation the  presence
     of the #E field is necessary. Some checks for authoriz-
     ing of such important operations as UPDATE  and  DELETE
     are   fulfiled.   These  operations  will  be  fulfiled
     succesfully in the case when your e-mail address is the
     same as the e-mail address of the person whose informa-
     tion your are correcting in the request.

4)   "DELETE" To delete your information from  the  address-
     guide.

         For example,

         ---- DELETE
         #E     dolbin@kiae.su
         ---- END


     Note.To delete information about yourself you  have  to
     specify  your  e-mail  address. All previous considera-
     tions on authorization of such operations are legal  in
     that case.


      Для получения инструкции по пользованию справочником необходимо
  отправить по адресу who_is_who@kiae.su письмо, содержащее единственное,
                      начинающееся с первой позиции,
                              слово "HELP".
      Все замечания, пожелания и предложения отправляйте по адресам:
                     dolbin@kiae.su, fsi@kiae.su
         Справочник содержит следующую информацию о каждом
              пользователе почтовой сети "RELCOM":


 __________________________________________________________________________
| Поле |         Cодержимое                       |      Pазмерность       |
|-------------------------------------------------|------------------------|
|  #L  | метка языка ответа                       |      не заполняется    |
|  #OK | метка безусловного ответа                |      не заполняется    |
|  %S  | сетевое имя машины                       |       20 символов      |
|  %D  | имя домена                               |       40 символов      |
|  %P  | почтовый адрес (по-русски)               |      150 символов      |
|  #P  | почтовый адрес (по-английски)            |      150 символов      |
|  %C  | имя пользователя (по-русски)             |       40 символов      |
|  #C  | имя пользователя (по-английски)          |       40 символов      |
|  #E  | адрес в электронной почте                |       55 символов      |
|  #T  | телефон пользователя                     |       30 символов      |
|  #F  | телефакс пользователя                    |       30 символов      |
|  %O  | место работы пользователя (по-русски)    |      150 символов      |
|  #O  | место работы пользователя (по-английски) |      150 символов      |
|  %H  | должность (по-русски)                    |       40 символов      |
|  #H  | должность (по-английски)                 |       40 символов      |
|  %Q  | немного о себе                           |      250 символов      |
|_________________________________________________|________________________|

       Всвязи с тем, что справочник может предоставлять информацию как на
       русском, так и на английском языке, некоторые поля содержат аналогичную
       информацию на обоих языках.
       Такие поля отличаются первым символом в метке поля. Английские
       начинаются с '#', русские - '%'. Буквы меток ТОЛЬКО латинские.
       Справочник выдает ответ либо только по-русски, либо только по-английски.
       При поисках в справочнике имеет значение регистр, в котором
       заностися/ищется информация.
       В письме типа "SELECT" нельзя одновременно помещать метки полей,
       содержащих аналогичную информацию на русском или английском языках:
       например, либо только %O, либо только #O.
       Для получения справок по-английски в письмо следует поместить
       "метку языка ответа" #L, не имеющую "аргументов". Для получения
       справок по-русски в письме метки #L быть не должно.

       Всвязи с тем, что объем ответа может быть значительным ( > 40Кб),
       введена метка #OK , означающая присылку ответа любого объема
       фрагментами приблизительно по 600 строк. Если эта метка в запросе
       отсутствует, будет передан усеченный ответ.
       В письме на имя who_is_who@kiae.su может одновременно содержаться
       несколько обращений к справочнику.
       Существует 4-е типа писем - INSERT, UPDATE, DELETE, SELECT, различных
       по своей структуре и назначению.

       Любое письмо имеет следующую структуру:



                            | Пояснение:
       ---- "тип письма"    | - это INSERT, UPDATE, DELETE или SELECT;
       "содержимое письма"  | - метки полей и информация по ним;
       ---- END             | - эта строка завершает письмо.


Пользователь может проводить следующие операции со справочником:

1) INSERT - поместить в справочник информацию о себе :

Пример:

---- INSERT                                    | Пояснение :
%S     kiae                                    |
%D     kiae.su                                 | Указать анкетные данные,
%P     123456, г.Москва, ул.Роговая 200-10-189 | которые пользователь
#P     123456, c.Moscow, Rogovaja st.200-10-189| считает нужным поместить
%C     Долбин Алексей                          | в справочник.
#C     Dolbin Aleksei                          |
#E     dolbin@kiae.su                          |
#T     (8 095) 196 - 72 -12                    |
#F     No                                      |
%O     ИВЦ ИАЭ им.И.B.Курчатова                |
#O     KI's Computing Cetnre                   |
%H     програмист                              |
#H     programmer                              |
%Q     Очень симпатичный человек               |
---- END                                       |

       При этом в справочник будет помещена вся
       указанная выше информация.

2) SELECT - произвести выборку информации из справочника :


---- SELECT                                   | Примечание:
%P     Москва                                 | Указать имена полей и
%C     Алексей                                 | шаблон для поиска данных
---- END                                      | о пользователях сети.

       Во всех полях допустимо указание усеченного шаблона поиска.
       Если необходимо задать сложный шаблон поиска, содержащий
       конкатенацию литер (образцов поиска), то задаваемые
       образцы поиска пишутся через символ '%'.
       Символ '%' внутри шаблона поиска означает любое количество символов
       между указанными цепочками литер в шаблоне. Поэтому, если Вы
       сомневаетесь или ленитесь что-либо писать, смело ставьте % !
       Например,
       %C     Федотов%Игоревич
       Что значит:"Найти господина с фамилией Федотов и отчеством Игоревич"

       Перечисленные в письме типа SELCT поля объединяются
       при поиске оператором логическое "И".

       В данном примере из базы производится выборка всей информации
       о тех пользователях, у которых в каких-либо частях полей %P и %C
       присутствуют слова 'Москва' и 'Сергей'.

3) UPDATE - изменить полностью или частично свои данные:

Пример:

---- UPDATE                                   | Примечание:
#E     dolbin@kiae.su                         |
%P     123479, г.Москва, ул.Петровка 38       | Указать имена полей,
#P     123479, c.Moscow, Petrovka st.38       | содержимое которых
#T     (8 095) 146 11 22                      | должно быть изменено.
---- END                                      |

       В полях %P, #P, и #T старая информация
       будет заменена указанной выше. При этом наличие поля
       #E обязательно.

4) DELETE - удалить всю информацию о себе из справочника:

Пример:

---- DELETE                                   | Примечание:
#E     dolbin@kiae.su                         | Указать содержимое
---- END                                      | поля #E.

       При этом в справочнике будет уничтожена вся информация
       о данном пользователе, но только самим этим пользователем.


     The address-guide  operates  with  Internet  users  via
letters exchange.

     To get information on the usage of  this  address-guide
just send letter with the single word HELP at the first line
to the address who_is_who@kiae.su.

     All observations and  proposals  may  be  sent  to  the
staff:
               Alexei Dolbin (dolbin@kiae.su)
                Serge Fedotov (fsi@kiae.su)

     Your suggestions are welcomed ;-).

     The address-guide  contains  information  on  following
topics:

______________________________________________________________________
| Field Tag    |  Contents of the field              |      Size     |
|--------------+-------------------------------------+---------------|
|  #L          | Tag of the English answer           | is not filled |
|  #OK         | Tag of the big answer               | is not filled |
|  %S          | site name                           |  20 chars     |
|  %D          | domain name                         |  40 chars     |
|  %P          | Post address   ( in Russian )       | 150 chars     |
|  #P          | Post address   ( in English )       | 150 chars     |
|  %C          | Abonent's name ( in Russian )       |  40 chars     |
|  #C          | Abonent's name ( in English )       |  40 chars     |
|  #E          | E-mail address                      |  55 chars     |
|  #T          | phone number                        |  30 chars     |
|  #F          | fax number                          |  30 chars     |
|  %O          | Abonent's institution ( in Russian )| 150 chars     |
|  #O          | Abonent's institution ( in English )| 150 chars     |
|  %H          | Post ( in Russian )                 |  40 chars     |
|  #H          | Post ( in English )                 |  40 chars     |
|  %Q          | Some good words about yourself      | 250 chars     |
+--------------+-------------------------------------+---------------+


     The address-guide stores information  both  in  Russian
and  in  English.   That's  why some fields of the guide are
duplicated  to  store  the  identical  information  in  both
languages.  These  fields  differ  in  tags.  The tag of the
field to store information in Russian begins with  the  per-
cent sign '%'.  The tag of the field to store information in
English begins with the number sign  '#'.   Each  field  tag
contains  only  one of the previously mentioned sign and the
Latin letter.

     The guide sends you  information  retrieved  either  in
Russian  or  in  English  language.  It is an error to place
simultaneously tags that correspond to Russian  and  English
pieces  of  information  in the same request of the "SELECT"
type.  For example, the request of the "SELECT" type  should
contain either %O or #O tags. The guide is CASE SENSITIVE.
Be carefull.

     To retrieve English piece of  information  the  request
has to contain #L field tag with no "arguments". To retrieve
Russian piece of information #L field tag should be absent.

     Because an answer may be big enough (more then  40  Kb)
there is #OK tag that means that an abonent agrees to accept
the whole retrieved data regardless to  its  size.  In  that
case  the  answer will be automatically fragmented and prop-
erly numbered.  If #OK tag is absent in the request and  the
real size of the answer is more then 40 Kb abonent retrieves
only the first part of the answer.

     Single e-mail letter may contain simultaneously several
requests to the address-guide.

     The  address-guide  operates  with  the  4   types   of
requests:  INSERT,  UPDATE,  DELETE,  SELECT  differ  in its
structure and meaning.

     Each letter has to be of the following structure:

    ---- Letter type  | <- It is either INSERT,UPDATE, DELETE or SELECT.
    Letter contents   | <- Field tags and corresponding data.
    ---- END          | <- This line has to finish request.

Abonents may execute  following  requests  to  the  address-
guide:

1)   "INSERT" To insert data in the address-guide.

         For example,

         ---- INSERT
         %S     kiae
         %D     kiae.su
         %P     123456, c.Moscow, Rogovaja st.200-10-189
         #P     123456, c.Moscow, Rogovaja st.200-10-189
         %C     Aleks Dolbin
         #C     Aleks V. Dolbin
         #E     dolbin@kiae.su
         #T     (8 095) 196 72 12
         #F     No
         %O     KI's Computing Cetner
         #O     KI's Computing Cetner
         %H     programmer
         #H     programmer
         %Q     Very dead shooter
         ---- END


     Note. You have to insert data considered to  be  impor-
     tant  to other address-guide users.  After execution of
     the request all this information will  be  inserted  in
     the address-guide.

2)   "SELECT" To retrieve data from the address-guide.

         For example,

         ---- SELECT
         #P     Moscow
         #C     Peter
         ---- END

     Note. You have to place field tags and patterns in  the
     request  to  execute  data  retrieval according to pat-
     terns. In this example will  be  retrieved  information
     about all abonents having string 'Moscow' in their post
     address field and string 'Peter' in their name field.

     Despite you place not all field tags in your request in
the  answer  all  fields corresponding to English or Russian
information retrieved will be present according to  patterns
specified in the request.

     It  is  possible  to  specify  restricted  patterns  in
request.   If it is necessary to specify compound pattern at
the same field  tag  you  have  to  concatenate  strings  of
literals  by the percent '%' sign.  This sign in the pattern
means any number of characters between parts of  the  string
it separates.

    For example,

    #C     William%Maugham

This string means that will  be  retrieved  all  information
about mr.Maugham whose first name is William.

     During execution of the request  information  specified
at field tags is united in the logical condition by the log-
ical  'AND'  operators.   In  the  example  above  will   be
retrieved information about all abonents having string 'Mos-
cow' in their post address field AND string 'Peter' in their
name field.

3)   "UPDATE" To update data in the address-guide.

         For example,

         ---- UPDATE
         #E     dolbin@kiae.su
         #P     123479, c.Moscow, Petrovka st.38
         #T     (8 095) 146 11 22
         ---- END

     Note. In the request of the "UPDATE"  type  field  tags
     corresponding  to the updated fields are specified with
     the data to be updated. In that operation the  presence
     of the #E field is necessary. Some checks for authoriz-
     ing of such important operations as UPDATE  and  DELETE
     are   fulfiled.   These  operations  will  be  fulfiled
     succesfully in the case when your e-mail address is the
     same as the e-mail address of the person whose informa-
     tion your are correcting in the request.

4)   "DELETE" To delete your information from  the  address-
     guide.

         For example,

         ---- DELETE
         #E     dolbin@kiae.su
         ---- END


     Note.To delete information about yourself you  have  to
     specify  your  e-mail  address. All previous considera-
     tions on authorization of such operations are legal  in
     that case.