Node:lookup-z-name, Next:set-last-read, Previous:get-version-info, Up:Protocol Requests
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".
bad-bool
want-pers and want-confs must be either 0 or
1.