Documentation Contents

User Documentation

Administrator Documentation

Index of terms

Technical Support

On-line Search

This script gives opportunity to cell phone user to access some selected information and services of his mail server, to which he gets connected usually through his mail client - in this case we are talking about Lotus Notes server. Access to these informations have only those users, who are registered on the mail server and have the right cell phone number set in their mailbox.

These informations and services are supported in present time:

• searching company's contacts - samples
• calendar + meeting creation - samples
• "Inbox" folder - samples
• reply to message - samples
• message forwarding - samples
• brief help - samples

Common command format is "?<command><parameters>" (always WITHOUT quotations). Parameters can be optionally separated by space. It is necessary only if it would modify the command.

Searching company's contacts

• "?g" – for acces to company's contacts.

• "?gn" - searching is limited only to the "Display Name" item (very fast searching).
• "?g" - basic searching, only person name, company name and its residence is searched.
• "?ga" - enhanced searching, complete address of person and company and all phone numbers are being searched also.

Every contact goes back as a separate SMS, the number of returned contacts is limited with script setting (ex: 5 contacts found. If more matching records is found, a special message is sent with the number of contacts found that recommends the user to give a better specification of his request.

Returned information is in format "Name Surname (available informations". Available informations are in this order:

• address, ZIP, place,
• BP: + business phone,
• BF: + business fax,
• HP: + home phone,
• HF: + home fax,
• M: + cell phone,
• C: + company name,
• W: + web page.

Samples

"?ga kladno" – person searching by city (or address part)

back to top of page

Calendar

Access to all planned appointments. Basic command is:

• "?c" - sends all meetings valid for today from now minus one hour (covers presently running meetings that don't have duration longer than 1 hour) till today's midnight.

• "?c offset" - offset tells the day relative to today:
  • "?c 0" - all today's meetings (from the beginning of the day),
  • "?c 1" - all tomorrow's meetings,
  • "?c 2" - all meetings for after-tomorrow, etc.

• "?c date" - access to meetings for entered day. The date can be entered in various formats, ex: appointments from 31st December 2000 can be requested like this:
  • "?c 2000 12 31"
  • "?c 00 12 31"
  • "?c 12 31"

Each meeting returns as a separated SMS. The count of returned meetings is not restricted.

Returned information is in format "1/3 #id# 31.12.00 15:30-16:00 F:from S:what T:text".
The meaning of each item is as following:

• "1/3" - "meeting number in this day" divide "summary count of found meetings",
• "#id#" - unique identification of meeting, which can be used if we want to receive more detailed info (it is generated by every request to the particular day so it can be used only to the next request for this day and in the time of few following days),
• "31.12.00 15:30-16:00" - the time range of planned meeting,
• "from" - SMTP address of the meeting creator,
• "what" - subject of appointment,
• "text" - meeting description limited with one SMS length (including previous informations).

• "?c id(or #id#)" or "?c any_text #id# any_text".

Parameter "id" is processed as text and therefore it must be entered including leading zeroes.

Samples

"?c 4 22" - all meetings from 22nd April actual year.

"1/3 #0003# 22.4.00 15:00-16:00 L:Albertov S:Tenis F:Ivan Lendl T:..." - sample message (or the first of three messages), that we could receive as a response to the previous request and which we can use for request for detailed informations about this meeting. "ID" parameter is in this case "0003".

If the cell phone doesn't allow to use received SMS, it is possible to enter a new (equivalent) command "?c #0003#" or "?c 0003" only.

back to top of page

Meeting creation

• "?cn hour[:minute] [year[month[day]]] [D[separator]duration] R[separator]partners [L[separator]place]
  [S[separator]subject] [T[separator]description]"
  • "hour" - time of meeting, hour (one- or two ciphered).
  • "minute" - time of meeting, minute (always two-ciphered), default value ":00"
  • "year" - date of meeting, year (one, two or four-ciphered). If not four-ciphered, value of 2000 is added. Optional, current year is default.
  • "month" - date of meeting, month (one- or two ciphered). If a year is entered, the month is always two-ciphered. Optional (if year is not entered), current month is default.
  • "day" - date of meeting, day (one- or two ciphered). In month is entered, the day is always two-ciphered. Optional (if month is not entered), current day is default.
  • "duration" - meeting duration in minutes. Optional, 30 minutes is default.
  • "partners" - list of partners (postal addresses separated with ";" or comma) which are to be invited.
  • "place" - place of meeting.
  • "subject" - meeting subject.
  • "description" - meeting description.

Creates a new meeting and invites partners.

Samples - date and time

"?cn 16 …" – meeting today at 16 hours

"?cn 15:30 4 …" – meeting the 4th day of this month at 15:30

"?cn 8 701 …" – meeting at June 1st this year, 8 hours

"?cn 9:30 10401 …" – meeting at April 1st 2001, 9:30

Samples - individual parameters

"?cn … D90 …" – meeting duration 90 minutes

"?cn … Ragassi,lendl …" – meeting with agassi and lendl partners

"?cn … R:Agassi Andre,Lendl Ivan S: …" – meeting with Agasi Andre a Lendl Ivan partners. Now separator was used, so spaces can be used in partner names. But using this format, partners must be stored in your contacts. Also the same separator must be used in other parameters.

"?cn … T:meeting description" – separator is used, so spaces are allowed.

"?cn … Tmeeting description" – separator wasn't used, but spaces are used though. It is possible if no separator was used in the whole message and argument is the last in message (no other will be detected).

Sample – complete meeting creation

"?cn 16 D120 Ragassi,lendl STournament TArranged by Datasys" – creates a new meeting today at 16:00, duration 120 minutes, invites partners agassi and lendl, subject Tournament, description Arranged by Datasys.

back to top of page

"Inbox" folder

• "?m" – Sends information about all unread messages.

Enhanced query: "?m offset [r|u|a] [h|n|l|a]". All items are optional (default values are listed further), but if any is entered, must be entered all previous. Meaning of each item is as follows:

• "offset" – sets the day relative to today - goes like this:
  • "?m 0" – today's messages
  • "?m 1" – yesterday's messages
  • "?m 2" – before yesterday's messages etc.
• "[r|u|a]" – message type:
  • "r" – read messages
  • "u" – unread messages only (default)
  • "a" – all messages
• "[h|n|l|a]" – priorities:
  • "h" – high priority messages only
  • "n" – normal priority messages only
  • "l" – low priority messages only
  • "a" – all messages with any priority.

• "2/5" – "message number inside matching messages" divided by "summary count of messages matching the request"
• "#id#" – unique identification of message which can be used if we want to receive more detailed informations (it is being generated again by every request containing the concrete messages, so it can be used only to the next request for this message)
• "from" – e-mail address of the sender
• "subject" – subject of message

• "?m id(or #id#)" or "?m any_text #id# any_text".

Last mentioned format allows to use received SMS (with info about the only message) as base for request for detailed information about this mesage.

"ID" parameter is being handled as text so it must be entered complete with the zeros at the beginning.

Warning: In some case "?m" query doesn't have to report correct information about all unread messages or return information that there is no new message even it such message exists. This is known problem when Lotus Notes server doesn't give current list of unread mails. In this case use more specific query like "?m 0 a" for today's messages, for example, which works correctly.

Messages received using "?m" (include enhanced version) are marked as read.

Samples

"?m 1 a" – all yesterday's messages with no regarding to their priority.

"?m 0 u h" – today's unread messages with high priority.

"1/1 #0004# F:Lendl Ivan S:Today at Albertov" – sample of message that we could receive as a response to the previous request which contains informations about only one e-mail and which can be used for request for more detailed info about this e-mail. "ID" parameter is in this case "0004". If the message contained informations about more e-mails and we would like to used it as a request, we will receive information about the first e-mail (from the listed) only.

If cell phone doesn't allow to re-use received SMS, or if the incoming message contains informations about more e-mails, it is possible to enter a new, equivalent command "?m #0004#" or only "?m 0004", where we enter only suitable "ID".

back to top of page

Reply to message

• "?r id(or #id#) reply_text"

• "id" or "#id#" – sets the only one message we are answering to. We can get it via "?m" command which grants access to incoming messages including their identificators.
• "reply_text" – required value, if it isn't entered, no action will be processed.

The answer is sent as a mail message from cell phone owner's mailbox to the address of sender of original mail message. Original message is indented and inserted behind the response text. Original message is also marked as read.

Samples

Request: "?m" – all unread messages.
Response: "1/1 #0004# F:Lendl Ivan S:Today at Albertov"
Request: "?m 0004" – more detailed info about message "0004".
Response: "D:9.5.00 8:00 F:Lend Ivan S:Today at Albertov T:Meet at 10h. Take a racket for me too."
Action: "?r 0004 settled" – response to message "0004".

back to top of page

Message forwarding

Mail message forwarding. Basic command is:

• "?f id(or #id#) recipient_list reply_text"

• "id" or "#id#" – sets the only one message which is being forwarded. We can get it via the "?m" command, which grants access to incoming message uncluding their identificators.
• "recipient_list" – list of comma or semicolon delimited e-mail addresses, where message will be forwarded to.
• "reply_text" – optional text

In the case that one or more recipients won't be recognized, the message with non-recognized recipients will be sent as a SMS to cell phone.

Samples

"?f 0004 sampras,agassi Expecting you." - message "0004" forward to both addresses listed above with the entered text.

back to top of page

Brief help

Brief help can be sent through the command:

• "??" – sends text file with help for all basic commands.
• "??command" – sends text file with syntax of specified command.

Samples

• "??g" sends syntax for company contacts searching request
• "??c" sends syntax for calendar searching request
• "??cn" sends syntax for a new meeting creation command.

back to top of page