If your client receives a property request (RX_PROP_QUERY) that you are willing to answer, your client can do so by sending a TX_PROP_ANNOUNCE message to the requesting client.
It is not necessary to receive an RX_PROP_QUERY message before sending a TX_PROP_ANNOUNCE message. You may, for example, wish to send out unsolicited messages to everyone in your contact list announcing that you have just gotten on-line.
The format for a TX_PROP_ANNOUNCE message is:
TX_PROP_ANNOUNCE tag address property_and_value
where
| tag | is a unique label for this message; |
| address | is the address of the requesting client; and |
| property_and_value | is an envelop whose data field names both the property that was queried and that property's value. |
The contents of the property's data field is formatted as follows:
property=value
where, of course, property is the name of the property and value is its value. The manner in which the value is represented depends on the property, and is defined individually for each property. It may be text or binary.
Sending this message will cause the other client to receive an RX_PROP_ANNOUNCE message.