Node:local-to-global-reverse, Next:, Previous:set-connection-time-format, Up:Protocol Requests


local-to-global-reverse [121] (11) Recommended


    local-to-global-reverse [121] (( conf-no              : Conf-No;
                                     local-no-ceiling     : Local-Text-No;
                                     no-of-existing-texts : INT32 ))
                -> ( Text-Mapping );

This call retrieves information that makes it possible to convert no-of-existing-texts existing local text numbers smaller than local-no-ceiling to global text numbers, provided that there are that many local texts smaller than local-no-ceiling.

In other words, this request is just link local-to-global, but it searches backwards in the mapping.

The conf-no parameter specifies which conference to look up local numbers in. local-no-ceiling is the first number that the client is not interested in. no-of-existing-texts is the maximum number of texts the client wants information about. Legal values for no-of-existing-texts are 1-255 (inclusive).

The server will return a sparse or dense Text-Mapping depending on the how many deleted texts there are before local-no-ceiling.

As a special case, if local-no-ceiling is 0, information will be returned about the no-of-existing-texts highest-numbered texts.

Error codes

login-first
Login required before issuing this call.
long-array
no-of-existing-texts was larger than 255.
conf-zero
conf-no was set to 0.
undef-conf
The conference does not exist, or the client is not allowed to know that it exists.
access-denied
The conference exists, but the client is not allowed to retrieve information about the texts in the conference.