Список содержимого

Bombus Help

The beginning of work

Requirements

For work of the program phone/smartphone/PDA with support Java MIDP-2.0, or color mobile phone Siemens with support MIDP-1.0 (except for SX1) is required. You can learn, what at your mobile device Java MicroEdition Profile (MIDP), having passed under the reference: http://www.jbenchmark.com/result.jsp

It is tested on following models of mobile devices:

Compatibility list

Also it is necessary, that the mobile device supported technology GPRS, has been connected to service GPRS-Internet and has been adjusted for work with it (GPRS-WAP has no attitude to Bombus). The profile java should have a necessary set of adjustments (adjustments differ for different models of phones, see the instruction). Besides the time-out (time from the beginning of idle time before end of current GPRS-session) should be not less than 200 seconds (for Siemens S75 set it 20 seconds). You can learn GPRS-settings from the operator of cellular communication.

Keys management

All windows
Joystick upwards/downwards,
2 / 8
To move on a line upwards/downwards
Joystick to the left /to the right,
4 / 6
To move on page upwards/downwards
Joystick action, 5,
left soft-button phones Siemens
To choose a line (action by default)
1 / 7 To move to the beginning/in the end of the list or the message
(Siemens) To begin/continue a writing of the message to contact under the cursor/current to contact
(Siemens) (quickly) the Cancelling (to pass in the previous window)
Roster (Contact-list)
0 Cyclic transition between contacts, for which are available unread messages
0 (long pressing) Inclusion/deenergizing of display an offline-contacts (is possible adjustment in parameter jad key_offlines). At an output from the application the condition of display is not kept
3 / 9 Moving upwards/downwards on headings of groups
9 (long pressing, only on SonyEricsson) Translation Bombus in a background operating mode (adjustment in parameter jad key_hide)
* (# in versions for Siemens) Long pressing is possible - blocking of the keyboard (adjustment in parameter jad key_lock)
# (* in versions for Siemens) Long pressing is possible - switching of a profile of the signal system on Vibra (adjustment in parameter jad key_vibra is possible)
MessageList
Joystick action, 5,
left soft-button phones Siemens
To leave back of messagelist (chat)
Joystick to the left/to the right,
4 / 6
At achievement of the beginning/end of the message transition to the previous/following message
* (brief pressing) To on/off display smiles
Mode of message typing
(Siemens) (quickly) To remember the typed text and to pass to messagelist
At loading, during display of an inscription Loading...
Any key To pass in a window of a choice of accounts (action of the button not instant since loading of the program is carried out)

Addition of existing/creation new Jabber account

Bombus is jabber-client, dialogue with users ICQ is possible ONLY after connection of transport, therefore do not try to enter into following fields the UIN, the password and as a server login.icq.com! To create account ICQ from it it is impossible for the same reason, for dialogue through ICQ at you should be already registered UIN

Account - a sheaf of a kind “a name the user (login) + the password”. The client is understood as any program, allowing to communicate in a network jabber. In a network jabber each user has the identifier, JID (Jabber ID). For example: mozilla@jabber.ru, where mozilla this name the user (login), and jabber.ru - a server on which there is a given account. Also in jabber there is an opportunity to leave in a network from one JID simultaneously at once from several clients. To distinguish them such concept as a resource has been entered. It is an any label. For example: mozilla@jabber.ru/Bombus. In this JID Bombus also there is a resource.

After the first start of the program you will see an empty window Accounts. You need to add/create a new account to begin dialogue. The command of the menu New Account opens the form with the following fields:

Username

A name of the user jabber. At registration of a new account on a server (in the bottom of the form there is a tick Register Account) the name of the user should be not it is borrowed

Password

The password for JID

Server

In the given field the necessary jabber-server is underlined. It is a field it is used for formation jid and for the instruction inside xml stream

Following Jabber-servers are most known:

Old Jabber-servers

Host name/IP (optional)

The IP-address of a jabber-server. The address is used at creation of a socket of a kind

socket://host:port

. It is necessary only in the event that in adjustments of phone fields DNS are not filled. If fields DNS and IP process of connection with a server will come to the end unsuccessfully are not filled, or long enough time will last.
The note: if the given field is not filled, it is considered that host=server

Port

Number of port of a jabber-server on which Bombus tries to establish connection. Value by default - 5222. This standard value used by jabber-servers.

use SSL

To use SSL-encrypting for connection with a jabber-server (it is supported not in all models of phones, see the instruction to phone).

plain-text password

Transfer of the password to the open kind (for communication with old servers)

SASL login

Establishment of connection with use SASL

conferences only

In this case there is no loading of roster. The given type of an input is used for a mode Conferences Only

proxy CONNECT

Establishment of connection through a proxy-server by method proxy CONNECT

Register Account

If to establish this tick Bombus will try to create a new account on the aforesaid you a server. If you have an existing account on this server it to put it is not necessary

Proxy name/IP

The field for input of a name of proxy-server or him IP-address

Proxy port

The field for input of port number of the proxy-server (specified above)

Keep-alive

Type of "keep-alive". Can accept following values:

Keep-alive period

Sets an interval of time in seconds between sents the chosen type of keep-alive for alive connection. Bombus periodically supports connection with a network for do not closing GPRS-session during of break send/receive data some time.

Important: the interval should be less, than GPRS-timeout in phone options, frequent breakages of connection will be observed differently

Range of keep-alive period can vary from 20 till 1500 seconds (25 minutes). By default 200 seconds

Note: for Siemens S75 this period should make 20 seconds, or patch JNTO is necessary

Resource

resource the client, by default “Bombus”

In Jabber you are able to log in several client programs simultaneously. You don’t need to have different Jabber accounts for work and for home. You can chat at home, then go to work, log in again with the same JID and your home Jabber client will not go offline after that

This is because Jabber has a thing named resources. When you log in, you are usually asked for for the Resource Name. For example, you could have a resource “Home” at your home Jabber client and “Work” at you work client

When other people look at “you” in their rosters, they usually see a list of resources you are available through. They could send a message to your particular resource, using these JIDs: you@jabber.org/Home or you@jabber.org/Work. You could even log in twice at the same computer through different Jabber clients and chat between different incarnations of yourself! more

Account name

The name of an account (any). The field can be left empty, thus Bombus as the name of an account will use JID a kind mozilla@jabber.ru/Bombus

To edit an account it is possible by means of a command Edit

After the termination of operations on creation/editing of an account it is necessary to keep given account

After addition/creation of account Bombus tries to incorporate to a server and to enter into a network. If to it it was not possible and has appeared the message Login failed it means, that the login or the password is incorrectly entered. If there was an inscription Failed, means or the server is incorrectly specified, or GPRS-connection, or any else problems with communication is incorrectly adjusted. During connection (or at a mistake) it is possible to choose in the menu a command Hide splash and to pass in an empty roster. If there was a mistake the message on it is written in Self-contact

Roster (Contact-list)

The roster (so in Jabber contact-list refers to) in Bombus is presented in the form of the list of the contacts incorporated in groups

The heading of a roster shows quantity of not read through messages, own status, online/total of the contacts, a current profile of the signal system

Here the total of elements is considered, namely: the usual contacts, the connected transports, own contacts (always it is more or equally to one), contacts in ignore-list, contacts in group Not-in-list. In an example on a picture on the right there is one not read through message, the status - online, 9 online-contacts in a roster, a silent profile Vibra

Contact in the list displays the status of the owner, presence of not read through messages, and also a resource. As a name of contact it is used nickname (pseudonym) or JID (if nickname has not been set)

In display of jabber-contacts after nickname through a virgule the resource, that is a line mozilla/Bombus resource Bombus shows means, that at this contact nickname mozilla. In the event that contact leaves in online at once from two resources simultaneously, in a roster there are two contacts to identical names, but to different resources

Each resource of contact has a priority. At sending from the outside on yours JID messages without the instruction of a resource (it is for example simple baggins@jabber.ru, instead of baggins@jabber.ru/Psi), it will come on that resource, which priority above. As the contacts connected through transports (in particular ICQ-transport), cannot see your resource, the message will receive a resource (at several online-resources) with the maximal priority

In Bombus it is possible to set a priority from a window Status by means of a command Edit

If the line with a name of contact is not located completely on the screen, Bombus gives an opportunity to read through its full contents by means of autoscrolling a line on which the cursor is established. Autoscrolling begins when the cursor remains motionless some time

Contacts to statuses online, chat, away, dnd, xa, offline are painted in different colors. Contacts from which the system message on a mistake has come have a special badge , this message on a mistake enters the name in their chat as status

In the event that contact contains unread messages, the status badge is replaced with a badge of an envelope

There is an opportunity to hide an offline-contacts from a roster (it is necessary to disconnect an option offline contacts in the menu Options). An Offline-contacts, containing unread messages, will remain are visible in a roster

In heading of group online/total of the contacts containing in it (2/5) shows. Groups can be turned off/developed, having established on the name of group the cursor, and having pressed button “Action”. If from the contact which is being curtailed group, the message comes, the group will be automatically developed. If the option offline contacts in the menu Options in a roster the groups having online-contacts show only is switched off

For fast change of a profile of the signal system with silent profile Vibra (the badge ) serves a key “*” (in versions for Siemens “#”). Change of a profile occurs by its long pressing

There is an opportunity to block the keyboard by means of long pressing a key “*” (in versions for Siemens “#”). To blocking there corresponds a badge . For a unblocking of the keyboard it is necessary to press and keep the same key repeatedly

Special groups

General

This virtual group contains all contacts which do not belong to one group, its name depends on imagination of the client.

Self-Contact

The group contains own contacts. Them more than one if you send with same JID by means of one more client. At a mistake own contact (with the same resource which is specified in a field Resource in adjustments of an account) contains the message in which the text of a mistake is displayed.

Transports

The group contains transports to various reports and services, here wrong contacts without formally get. This group does not depend on a condition of an option offline contacts in the menu Options so it is made that always it was possible to include/switch off the certain transport.

Ignore-List

The group contains contacts, messages from which will not be accompanied by the signal system, but will appear in a chat and to enter the name in history as usual messages. To include display of contacts in this group it is possible by means of an option Ignore-List in the menu Options. This option influences only display of group in a roster, messages from the contacts containing in it, will never be accompanied by any kind of the signal system.

Not-In-List

The group contains such contacts which were absent in a roster before from them any message has come.

Search results

The group contains results of last search through ICQ-transport or through jud (search on JID in network Jabber).

MessageList (chat)

The Chat represents the list of an exchange of messages with the certain contact. Also here changes of its status are displayed all

Status messages have a following format:

[15:00] online (Connected) [2]

[15:00] - This time of event

online - the actual status of contact

Connected - the status message (own status messages can be set from a window Status)

2 - priority

The Status message and a priority can be absent (for example at ICQ-contacts)

If exist unread messages (not necessarily from that contact, the chat with which is opened at present) in the right corner of heading of a chat there is a badge of an envelope . The message is considered read if the cursor has been induced at it or on any message below under the list

The command of the menu Quote (Citation) opens a window of a set of the message, containing the text of the message under the cursor

The command Clear List clears history of messages (for SonyEricsson press key C)

Many Jabber-clients support an exchange of events Message Composing. When the user starts to write the message, to its interlocutor event “message is written” sends . At a pause in a writing the interlocutor receives event “creation of the message is suspended”

Bombus, at reception of such events, accordingly displays a badge . Sending of own events is made at an input in the form of a set of the message, and at an output from this form. Support Message Composing works only in the event that clients from both communicating parties support it. For the contacts connected through transports (in particular ICQ), Message Composing does not work in connection with features of realization of transports. The given function joins a tick Composing event in the menu Options

The form of new message typing

In the form of a set of the new message it is possible to get, using a command New Message in the menu of a chat. For phones Siemens it is possible to press also in a roster, in a chat or in a window of viewing of the message the green button

The command Add Smile allows to add in the text of the message a smilie from the list which has opened in a window. Exists such useful opportunity, as Suspend Message (to postpone sending the message). It allows to remember the typed text in a window of a set of the message, to leave it, and then, if necessary, to continue its writing. It happens it is very useful, if during a set of own message the entering message comes. To remember the message, it is necessary to choose in the menu a command Suspend. For continuation of a set of the message in a chat there is a command Resume Message (to continue the message), at the same time it is possible to choose New Message and to begin a writing of the message with zero

The remark for owners of phones Siemens: to remember the message, it is enough to owners of phones Siemens to press the red button quickly only. If the message is remembered, the subsequent pressing of the green button in a roster (the cursor should stand on the same contact), in a chat or in a window of viewing of the message will execute a command Resume Message

Roster menu

Status> (set status)

Here it is possible to choose the corresponding status of presence at a network. At a choice of the status Offline Bombus breaks off connection with a server. Repeated connection will occur at a choice of the status which is distinct from Offline

The command of the menu Edit allows to establish a priority and the text of the message for the given presence status

The field Priority allows to set a priority which will receive Bombus at a choice of the status. If to establish a tick for all status types at all statuses the priority becomes same, as well as at what you edit

The field Message allows to set the status message. The status message usually contains the text which explains status

For example, [dnd] I Prepare for examination...

Inside of a network jabber you can see messages of all statuses, but for people outside of jabber (through transport ICQ) make sense only status messages for statuses chat, away, xa (is inaccessible), dnd. How users ICQ can see these messages, depends on their client

To break off connection and again to enter into a network, it is necessary to expose the status Offline, and then any other preferred status. Bombus will leave in a network with this status

Actions> (context menu for roster element)

Contents of it the menu depend on type of an element in a window of a roster on which the cursor is established. So, for transports in it the menu are two special commands - Logon and Logoff which allow to include/switch off transport. In connection with instability of transport icq.jabber.org the command Logon is especially actual, as allows to make attempt to include transport not stopping dialogue with users jabber or the contacts connected through other transports

Also the menu Actions> for transports does not contain a command Edit in order to prevent their “breakage”. For Self-contact there are no commands Edit, Subscription and Delete

vCard (information about user)

vCard in jabber is “card” of the owner of contact. The answer to inquiry vCard comes in the form of the message and is located in a chat of this contact. In vCard many users jabber contain volumetric photos which are not displayed yet, therefore be ready to long process. Also this command allows to look the information and on the users connected through transports

Client Version (information about client's version at contact)

The command Client info allows to learn the version of the client used by contact. It is actual only for contacts inside of a network jabber. For all contacts connected through transports, it gives out the version of transport (through transport the version of the client does not pass). The answer to inquiry is located in a chat. It is necessary to have in view of, what not all clients return the answer to this inquiry though the majority overwhelming them understands it

Edit (editing of contact name)

This command allows to change a name of contact for display in a roster and group in which it is. If manually to enter a name of nonexistent group the new group with such name will be created, contact will be placed in it

Subscription (authorization)

Subscription allows to receive notices on presence of contact in a network, that is you will not see the status of contact until then while it will not authorize you. That also you, and other party saw each other in a network, bilateral authorization is necessary. to means a direction from you to contact, from - a return direction. To authorize the contact, asking inquiry about subscription, it is necessary for you to send it the affirmative answer to this inquiry - a command Ask subscription. To request authorization there is a command Grant subscription

The command Remove deletes subscription at the chosen contact then it will not see you in a network. The inquiry of subscription comes in the form of the message and is located in a chat. To authorize the user asking about it, it is possible directly from a window of viewing of this inquiry an additional command Authorize. Contacts with subscription none are displayed by badges with a sign on a question, and contacts with from, ask - badges with two arrows

Delete (removal of contact)

The command deletes contact from a roster. After its choice the badge of the status of contact is replaced on and after the server will send acknowledgement on successful removal from a server roster, contact leaves from roster Bombus for ever

Send status (directly sending status)

It is accessible for transports and conferences

Sends the status to the chosen contact

Send file (file transfer)

Only for ZLib-version

Command for preparation and sendings of file to another jabber-contact which client supports of protocol IBB (XEP-0047: In-Band Bytestreams)

Add Contact (addition of contact)

Exists two ways to add contact. The first - to enter it JID completely into a field User JID, the second - to enter that costs up to a symbol in JID and to choose from the list Transport, actually transport or a current server. At a choice from the list of transports a field User JID autofilling. JID for the contacts connected through ICQ-transport jabber.ru looks so: 123456789@icq.jabber.org. That is for addition of ICQ-contact it is necessary to enter only it UIN into a field User JID and in the list Transports to choose icq.jabber.org. To add jabber-contact to other server generally to you it is necessary to enter it JID completely manually.

Name you can enter into a field that nickname contact under which it will be displayed in your roster (if you will not make it instead of nika will show JID).

Group is a field contains a name of group in which contact will be placed at addition. It is possible to choose existing group of the list Existing groups, or to enter its name manually. If the group which you have entered, still does not exist, it will be created.

After filling all fields you need to choose a command Add for end of process. Authorization automatically is requested of added contact. If a command of the menu of a roster Add Contact to choose when the cursor specifies one of contacts of group Not-In-List, the window of addition of contact will open with the filled field User JID which will contain JID this contact.

Alert profile> (eventing profile)

Profiles are responsible for the scheme of the signal system at receipt of the new message (in the future it is the menu will be expanded)

The command of the menu Set default establishes a profile which automatically will get out at start Bombus (by default). The profile is by default marked by a prefix “(default)” in it name

Conference (Multi-User Chat)

At an input in this item of the menu the special form with the following fields is displayed:

Room

In this field the name of a room to which the user wishes to be connected is underlined. The full list of accessible rooms of conference can be received, having addressed through Service Discovery to corresponding transport. For example, to conference.jabber.ru. By default in a field Room the name of a room Bombus

Is specified also there is an opportunity to create own room in conference. More detailed information on creation of the room and its adjustment can be looked here

at Host

In this field the server of conferences is underlined. By default - conference.jabber.ru

Nickname

In this field it is underlined preferred nickname (pseudonym). By default - the name of a current account (JID)

Password

In this field the personal password which can be demanded at connection to rooms of the conference, demanding input of the password is underlined. By default it is a field it is not filled

Message limit

In this field set the maximal number of the previous messages at an enter in conference. Can accept value no more than 20. By default: 20

Note: topic (theme) of conference is not considered for the message

Archive (message storage)

It’s intended for storage of selected messages with an opportunity of the subsequent insert in the form of a set new message of the body of the message, a theme of the message (if is available) and messages JID’s

There is an opportunity to keep the message, having chosen item of the menu to Archive

The context menu of archive has following commands:

In form of new message typing by a call of a command Archive in context menu will be present following commands:

Note: archive capacity depends on realization of the mobile device

Tools (jabber-tools menu)

Service Discovery

Service Discovery allows to look through services (services) on a server and to use them. Transports also concern to services. At the menu there is a command Server by means of which it is possible to see a tree of services of any server

To register transport, it is necessary to choose it and in a following level of a tree of services to use a command Register. The form of registration (usually with the instruction) with which it is necessary to fill will open. This form is under construction according to, accepted from a server. After that transport will be added in a roster

Also search in ICQ and in jud (jabber user directory) is supported. Search in ICQ is inside of transport in a tree Service Discovery (a command Search), and search in jud usually has a name “jud.server_name” and is in the first level of a tree. The form with fields for the search, accepted with a server opens

Remarks in occasion of a format of some fields: the field sex usually understands values female or male. For activization of a field online (is responsible for inclusion in results of search only those contacts who is in online at present) to fill with its any symbol (for example “1”) enough

After filling the form and a choice of a command Send there is a sending of data on a server. The window with results of search further opens. Pressing of a key action (5 or the button joystick) in it leads to display of a brief information on the found contact on which there is a cursor. The item authreq shows, whether contact of authorization demands at its addition in a roster, but current transport icq.jabber.org does not pay to it attention

The command of the menu Add allows to add contact in a roster. If after arrival of results of search to leave from Service Discovery in a roster it is possible to notice that there there was a new group Search results which contains results of last search. Contacts of this group can be sent messages (without their addition in a roster on a server), to look vCard, to add in a roster. This special group can be cleared, having guided the cursor on its name and having chosen in the menu the appeared command Discard Search

Current version Bombus supports only the report Service Discovery (JEP-0030) which supports the majority of jabber-servers. The out-of-date reports Jabber Browsing and Agent Information in Bombus are not realized. In particular, for this reason to connect transports on the servers using old reports, it is possible only by means of computer clients. The list of Russian servers with the old report at the moment of a writing of the documentation: jabber.rikt.ru, jabber.od.ua, jabber.te.ua, vzljot.ru

Privacy Lists

The given item of the menu Privacy Lists gives an opportunity to the user to adjust a policy of dialogue with the chosen user or with user group

The detailed description of mechanism Privacy Lists is accessible here

My vCard (Personal vCard)

The given item contains toolkit on work with vCard form, namely:

Refresh

Request vCard from server

Load Photo

To load a graphic representation from file system of the mobile device (JSR-75) in vCard

Clear Photo

To clear vCard of a graphic representation

Camera

Start builtin camera of mobile device

Publish

To publish vCard (to load vCard on server)

Options

Roster elements
Roster font

Note: the quantity of fonts in java depends on realization of the mobile device

Messages

At allow this option it is made original handshake, i.e. clients should receive under one message for acknowledgement (confirmation) of the fact of an opportunity of work with composing. So it is made from for existence of old clients, type Colibry IM, not understanding composing, accepting such messages as empty lines

Message font
Text wrapping
Sound

Choice of a file of a soundtrack (message.amr, message.mid, message.wav, tone sequence or no sounds)

Note: It is possible to hear to the sound file, having chosen a command Test sound in the menu on a software-key

Startup actions
Application
Automatic Away
Minutes before away
Time settings

For example: Moscow (GMT+3): years displacement 4, winter displacement 3. By default 3

Note: to correct Clock offset it is necessary AFTER installation GMT offset

Language

Account> (the editor of accounts)

The editor of accounts is in detail described in section Addition of existing/creation new account jabber. Remains only to mention about some it feature.

At quantity of accounts more than one, active is allocated with a badge online. To remove an account it is possible a command Delete. The command Delete does not delete an account from a server. To enter in the editor of accounts at start, it is necessary when the inscription Loading... is displayed to press any key. At start of the program there is a connection with last used account.

Minimize (only on SonyEricsson)

On phones SonyEricsson of the third generation (model k500, k700, s700, k750i) in the menu of a roster there is a command Minimize which translates Bombus in a background mode (turns off the application). There is an opportunity to use other functions of phone (with some restrictions). At entering message Bombus becomes more active it (is developed).

About (About the Program)

It is item me deduces a window in which the information on current (started) version Bombus is presented, the version of platform MIDP, model of phone and in some cases even the version of an insertion phone model on which at present it is started Bombus.

Also the reference to official site Bombus.
Is resulted also the information on a condition of internal phone memory (in kilobytes) is resulted. The general size of memory and free space of memory.

Quit (Output)

This item of the menu is created for correct end of work with the application and an output from it.

Special opportunities

Parameters of a jad-file

Some latent adjustments and special opportunities can be operated by means of parameters of a jad-file. It can be generated by means of the designer jad or to write manually. In phones Siemens of a series 65 folder storage is stored in the catalogue System on the latent disk.

Resolve Nicknames

In the menu Contact> transports there is a command Resolve Nicknames which automatically renames all the contacts connected through corresponding transport at which field Name (that is what are displayed in a roster in the form of 123456789@icq.jabber.org is not filled). These contacts receive names which undertake from a field NICK the vCard. Thus disappears necessity manually to rename the contacts connected through transports.

The note:

  1. If the field NICK is filled UIN in vCard Resolve Nicknames does not work.
  2. function Resolve Nicknames is realized not for all transports.