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.