options Element
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Defines options default values for IM session and MPOP behavior; options are static values chosen by the user.
Syntax
<options autoPublishMachineState="true"|"false" autoSubscribePresenceForContacts="true"|"false"/>
Attributes
Attribute |
Data Type |
Description |
|---|---|---|
autoPublishMachineState |
Boolean |
The default value of this attribute is true. |
autoSubscribePresenceForContacts |
Boolean |
The default value of this attribute is true. |
Element Information
Parent Element
Element |
Description |
|---|---|
Provides a server with required configuration information after the caller is authenticated using a logon request. |
Remarks
Options are static values chosen by the user. They define default values for MPOP and subscription behavior.
When autoPublishMachineState is true, the Communicator Web Access Server uses the UA parameter (see Setting Up Data Channels) of a polling request to publish the local machine state to remote subscribing users. The machine state is used when the user is in MPOP (Multi-point-of-presence) mode. That is, the user is signed in to Unified Communications on multiple devices. The Communicator Web Access server determines where IM messages are sent based on the machine state. The Communicator Web Access server combines the values of machine state and user state as an aggregate state value. The aggregate state value is used to advise remote users of a local user's online state.
autoSubscribePresenceForContacts dictates the behavior of a Communicator Web Access server when a local user adds a remote user to her contact list. When this attribute value is true, the added contact is also automatically subscribed to. A contact that is not subscribed to does not display current presence unless queried. Setting the attribute to false allows a client to reduce the amount of SIP traffic it must handle. For example, a client might be running on a mobile device. In this case, the bandwidth of the command and data channels can be limited. Rather than continuously receiving presence from all contacts, the client can make a single query for the presence of a contact at the time the local user initiates an IM. To manually subscribe to an added contact, make a subscribePresence request.
By default, a maximum of 200 remote users can subscribe to the presence of a user concurrently. The maximum value can be changed by an Office Communications Server administrator. Increasing the value can have a performance impact on the server.
Examples
<options autoPublishMachineState="true" autoSubscribePresenceForContacts = "false"/>