Node:set-read-ranges, Next:, Previous:mark-as-unread, Up:Protocol Requests


set-read-ranges [110] (11) Recommended


        set-read-ranges [110] (( conference  : Conf-No;
                                 read-ranges : ARRAY Read-Range ))
                -> ( );

This call tells the server that the person issuing the call has read exactly those texts specified by read-ranges in conference conference. This call is typically used to migrate a membership from one person to another. It can also be used instead of set-unread or set-last-read.

The server may automatically extend the ranges with adjacent local text numbers that are deleted.

Example: 

        1 9 7 6
        =1 2 4 22 18 6 97 5 198 1 6 100 6 0 *
        2 110 6 3 { 1 20 23 23 25 28 }
        =2
        3 9 7 6
        =3 2 4 22 18 6 97 5 198 1 6 100 20 5 { 23 25 26 27 28 }

This example shows how person 7 originally had read everything up to and including local text number 6 in conference 6. After the call to set-read-ranges, the query-read-texts-old call reports that person 7 has read the local text numbers 1-20, 23 and 25-28.

Error codes


login-first
Login required before issuing this call.
undefined-conference
The conference conference does not exist or is secret.
conference-zero
conference is zero.
not-member
Not a member of conference conference.
local-text-zero
read-ranges contains the number 0.
no-such-local-text
read-ranges contains a local text number that never has existed.
long-array
The read-ranges array is too long. error-status indicates the maximum range allowed.
invalid-range
The first-read field in one of the ranges in read-ranges is greater than last-read. The error-status indicates the interval (0 for the first interval, 1 for the second, and so on).
invalid-range-list
The first-read field in one of the ranges in read-ranges is not greater than the last-read field of the previous range. The error-status indicates the interval (0 for the first interval, 1 for the second, and so on).