READ-1

This example shows how to read VEVENTs that overlap a time range read
on several calendars.  It is assumed that the client has authenticated
to cal.example.com.


C: 10 SENDDATA
S: 10 2.0.1
C: CONTENT-TYPE: text/calendar; method=READ; component=VCOMMAND
C:
C: BEGIN:VCALENDAR
C: VERSION:2.1
C: METHOD:READ;VEVENT;relcal2,://bobo.ex.com/relcal3
C: BEGIN:VCOMMAND

    # The search criteria are specified in a VQUERY component

C: BEGIN:VQUERY
C: MAXRESULTS:20
C: MAXSIZE:17000000

    # These are the maximum number of components (VEVENTS in this case) which
    # can be returned, as well as the maximum number of octets which they may
    # occupy.  (These limits are per calendar ?)

C: QUERYNAME:MyViewRange

    # Queries can be named.  We're still working out the details of how
    # this will be used

C: QUERY:SELECT (DTSTART,DTEND,SUMMARY,UID);
C:  FROM VEVENT;
C:  WHERE (DTEND >= 19990310T080000Z AND DTSTART <= 19990310T190000Z);
C:  ORDERBY (DTSTART ASC, DTEND, UID, SUMMARY)

    # SELECT indicates the properties of the VEVENTS which should be returned.
    # WHERE indicates the criteria for selecting VEVENTS. ORDERBY indicates the
    # order in which they should be returned.

C: END:VQUERY
C: END:VCOMMAND
C: END:VCALENDAR
C: .

    # The "." on a line by itself terminates the data.
    # The server sends each response separately, with a result code.

S: 10 2.0 cap://cal.example.com/relcal2
S: Content-type: text/calendar; Method=RESPONSE; Component=VDATA; Optinfo=VERSION
2.1
S: Content-Transfer-Encoding: 7bit
S:
S: BEGIN:VCALENDAR
S: VERSION:2.1
S: METHOD:RESPONSE
S: BEGIN:VDATA
S: BEGIN:VEVENT
S: DTSTART:19990310T090000Z
S: DTEND:19990310T100000Z
S: UID:1234
S: SUMMARY:Big time meeting
S: END:VEVENT
S: BEGIN:VEVENT
S: DTSTART:19990310T130000Z
S: DTEND:19990310T133000Z
S: UID:5678
S: SUMMARY:small time meeting
S: END:VEVENT
S: END:VDATA
S: END:VCALENDAR
S: .

    # Events are returned in ascending order by DTSTART.
    # The calendar is indicated fully qualified.

S: 10 2.0 cap://bobo.ex.com/relcal3
S: Content-type: text/calendar; Method=RESPONSE; Component=VDATA; Optinfo=VERSION
2.1
S: Content-Transfer-Encoding: 7bit
S:
S: BEGIN:VCALENDAR
S: VERSION:2.1
S: METHOD:RESPONSE
S: BEGIN:VDATA
S: BEGIN:VEVENT
S: DTSTART:19990310T140000Z
S: DTEND:19990310T143000Z
S: UID:1919191
S: SUMMARY:Summer budget meeting
S: END:VEVENT
S: END:VDATA
S: END:VCALENDAR
S: .