Node:lookup-z-name, Next:, Previous:get-version-info, Up:Protocol Requests



lookup-z-name [76] (7) Recommended


        lookup-z-name [76] (( name          :   HOLLERITH;
                              want-pers     :   BOOL;
                              want-confs    :   BOOL ))
                -> ( ARRAY Conf-Z-Info );

This call looks up the name name in the server, and returns a list of all matching conferences and/or persons. If want-confs is true, then the result will include conferences that are not mailboxes. If want-pers is true, then the result will include conferences that are mailboxes.

See also re-z-lookup, for an alternative way to look up names.

Refer to Name Expansion, for details on the matching process.

Example:

    1 76 0H 1 1
    =1 4 { 15HTest Conference 0000 10 11HDavid Byers 1001 6
            21HTrains (-) Discussion 0000 11 4HJohn 1001 9 }
    2 76 0H 0 1
    =1 2 { 15HTest Conference 0000 10
           21HTrains (-) Discussion 0000 11 }
    3 76 3HT C 1 1
    =3 1 { 15HTest Conference 0000 10 }

This example shows three calls to lookup-z-name. The first call retrieves all conferences and persons in the server. The second request looks up the same name as the first, but this time the result is restricted to conferences. The final request requests all conferences and persons matching the pattern "T C".

Error codes

This call always succeeds.