[MS-ASCMD]: ActiveSync Command Reference Protocol Specification

2.2.3.171 Wait
The Wait element is an optional child element of the Sync element in Sync command requests that
specifies the number of minutes that the server SHOULD delay a response.
All elements referenced in this section are defined in the AirSync namespace.
Command
request/response
Parent
elements
Child
elements
Data type
Number
allowed
Sync command request
(section 2.2.2.19.1)
Sync (section
2.2.3.155)
None
integer ([MS-
ASDTYPE] section
2.5)
0...1
(optional)
The result of including the Wait element as the child element of the Wait element in a Sync
command request is undefined. The server MAY return a protocol status error in response to such a
command request.
Valid values for the Wait element are 1 through 59. When the client requests a wait interval that is
outside the acceptable range, the server will send a response that includes a Status element
(section 2.2.3.152.16) value of 14 and a Limit element (section 2.2.3.82).
Either the Wait element or the HeartbeatInterval element (section 2.2.3.75.2) can be included in
a Sync command request, but not both. If both elements are included, the server response will
contain a Status element value of 4.
When the Wait element is used in a Sync request, it indicates to the server that a response
SHOULD be delayed either until the wait interval, which is indicated by the contents of the Wait
element, elapses or until any of the collections that are included in the request have changed.
It is at the discretion of the client to send the Wait element; the server is only guaranteed to
respond immediately when the Wait element is not present. The client typically wants a server
response immediately in the following cases:
•The client adds new items by using the Add element (section 2.2.3.7.2). In this case, an
immediate response is required because the client requires the server-provided item ID to track
changes to those new items.
•The client sends the server a Change element (section 2.2.3.23) that contains an important
update. In this case, a delayed response increases the possibility that the client has to resend the
change because of a lost connection.
Although the server is only guaranteed to respond immediately when the Wait element and the
HeartbeatInterval element are not present, the server SHOULD always respond immediately to a
Sync request that includes an Add element or a Change element, unless the addition or change
involves only flags.
A flagging change or a move out of (and not into) a folder which is being synced SHOULD NOT
cause the request to finish early.
2.2.3.172 WindowSize
The WindowSize element is an optional child element of the Collection element and the Sync
element in Sync command requests that specifies a maximum number of changed items in a
collection or a request that SHOULD be included in the synchronization response.
[MS-ASCMD] — v20110315
ActiveSync Command Reference Protocol Specification
Copyright © 2011 Microsoft Corporation.
Release: Tuesday, March 15, 2011
256 / 369