Command: fetchcomponents_by_attendee_error
Purpose.
Fetch a list of components that had errors while sending group scheduling messages.
Parameters.
Table 7–11
fetchcomponents_by_attendee_error Parameters
Parameter
|
Type
|
Purpose
|
Required
|
Default
|
attendee
|
string
|
The attendee’s calid to search on. The command searches
the calendars specified in the calid parameter for all errors in
events for this attendee.
If this parameter is not specified, the command searches the primary owner’s
calendars for all event errors for any attendee.
|
N
|
N/A
|
calid
|
string
|
A semicolon-separated list of calendar identifiers.
The calid can be supplied in two formats:
-
string - calendar identifier
-
mailto:rfc822addr - An email
address appended to “mailto:”. The address is mapped to a user with an
LDAP lookup, and then the user’s default calendar ID is used. Returns: X-SICS-EMAIL and X-NSCP-CALPROPS-RELATIVE-CALID
|
N
|
Current user’s calid
|
component-type
|
keyword (event, todo, all)
|
Indicates which components to return: event returns only
events
todo returns only todos
all returns both events and todos
If an invalid value is passed in, the system assumes all.
|
N
|
all
|
compressed
|
integer (0,1)
|
This parameter is deprecated in this release and might be deleted in future
releases.
For compressed=0, returns less data. Specifically, it does
not return the following parameters:rrules, rdates, exrules, and exdates.
For compressed=1, all recurrence data is returned.
|
N
|
0
|
emailorcalid
|
integer (0, 1)
|
0 = The calid is returned in the calendar
address part of the ATTENDEE and ORGANIZER properties.
The X-Token X-S1CS-EMAIL has the RFC 822 email address of the invitee
or organization.
1 = The email address is returned in the calendar address
part of the ATTENDEE and ORGANIZER properties.
The X-Token X-S1CS-CALID contains the calid value.
|
N
|
0
|
fetchorder
|
integer
|
Specifies the order in which the events and todos are returned.
The values are:
|
N
|
0
|
emailorcalid
|
integer (0, 1)
|
0 = Returns calid in calendar address
part of the attendee or organizer property and
returns the RFC 822 address of the invitee or organizer in X-S1CS-EMAIL.
1 = Returns the RFC 822 compliant email address in the calendar
address part of the attendee or organizer property,
and returns the calid in X-S1CS-CALID.
|
N
|
0
|
fmt-out
|
string
|
The format for the returned data.
Two format types:
text/calendar
text/xml
|
Y
|
text/calendar
|
id
|
unique identifier string
|
The session identifier.
|
Y
|
N/A
|
maxResults
|
integer
|
The maximum number of events and todos to be returned. When 0,
no maximum is applied and the command returns all events and todos found.
|
N
|
0
|
recurring
|
integer (0, 1)
|
1 = Returns all components in compressed form. Compressed
form has master entries plus exceptions.
0 = Returns components expanded, but without master record
and exceptions.
|
N
|
0 (not compressed)
|
relativealarm
|
integer (0, 4)
|
Return the alarm as relative or absolute.
0 = Return alarm values as absolute.
4 = Return alarms as originally created.
|
N
|
0 (absolute)
|
tzidout
|
standard time zone string
|
The time zone returned data is translated to.
|
N
|
Returns data in Zulu time
|
Description
Use this command to retrieve a list of events and todos that had errors when
sending group scheduling messages. This command works almost like fetchcomponents_by_range.
Output Format
The server returns data in the format specified by the fmt-out parameter.
If this parameter is not passed, the data is returned in the default text/calendar format.
maxResults Value
If you specify a maximum n, the command returns up to the
first n events and first n todos in the specified
range. For example, if you specify a maxResults value of 75, the returned data would contain the following variables
var maxResults=75 /* maximum cap passed in */
var size=75 /* event size is capped to 75 */
var todosize=28 /* todo size not affected since it is less than 75 */
If the maxResults parameter is set to 0 or
is not passed, then the returned data does not contain the var maxResults statement.
Returns
For each calendar specified in calid, the server returns
the events and todos that had errors for the specified attendee while sending group
scheduling messages.
For example, if the calid parameter specifies calendars cal1 and cal2, and the attendee parameter
specifies jdoe, then both cal1 and cal2 would be searched for events with errors that had jdoe as
an attendee. In the table that follows, cal1 and cal2 each have four events with associated attendees:
cal1 Events
|
cal2 Events
|
event - 1c1
attendee: jdoe
status: error
|
event - 1c2
attendee: john
status: OK
|
event - 2c1
attendee: susan
status: error
|
event - 2c2
attendee: jdoe
status: error
|
event - 3c1
attendee: jdoe
status: OK
|
event - 3c2
attendee: susan
status: OK
|
event - 4c1
attendee: john
status: OK
|
event - 4c2
attendee: susan
status: error
|
For attendee jdoe, the command returns: events 1c1 and 2c2.
The system uses the tzidout parameter to determine what time
zone to translate retrieved data into before returning it. If the tzidout parameter is missing, the system returns the data in Zulu time.
Error Codes
If the operation is successful, the error number of 0 is
appended to the error string. If the command fails for any reason, errno is Error Codes(42).