Node:query-read-texts, Next:, Previous:set-expire, Up:Protocol Requests



query-read-texts [98] (10) Recommended


        query-read-texts [98] (( person     : Pers-No;
                                 conference : Conf-No ))
                -> ( Membership );

This call is used to find the number of unread texts in a conference. The data it returns is actually a membership structure which specifies which texts have been read. It is up to the client to transform the data to a more usable form. person is the person being queried and conference is the conference in question.

Calling query-read-texts does not require the session to be logged in.

Example:

        1 98 6 1
        =1 4 32 5 11 12 7 93 1 193 1 1 20 133
           3 { 135 136 137 } 5 43 8 3 12 7 93 1 193 1 01000000

This example finds the read texts for user 6 in conference 1. The returned data indicates that conference 1 is the fifth conference on the users' membership list (4; remember that the position starts its count at 0), user last read the conference on Monday July 12th, 1993 at 11:05:32 (32 5 11 12 7 93 1 193 1), that it is the membership in conference number 1 (1), that the person has assigned priority 20 to the conference (20) and that all articles up to and including local number 133 (133) plus articles 135, 136 and 137 (3 { 135 136 137 }) have been read. The membership was added by person 5 (5) at Monday July 12th, 1993 at 03:08:43 (43 8 3 12 7 93 1 193 1) and it is passive (01000000).

Error codes

undefined-person
person does not exist, or no access to person.
undefined-conference
Conference conference does not exist, or is secret.
conference-zero
conference is zero.
not-member
person is not a member of conference or insufficient privileges to find out if person is a member.