lb_unregister(3ncs)lb_unregister(3ncs)Namelb_unregister - remove an entry from the Location Broker database
Syntax
#include <idl/c/lb.h>
void lb_$unregister(entry, status)
lb_$entry_t *entry;
status_$t *status;
Arguments
entry The entry being removed from the Location Broker database.
status The completion status. If the completion status returned in is
equal to status_$ok , then the routine that supplied it was suc‐
cessful.
Description
The routine removes from the Location Broker database the entry that
matches entry. The value of entry should be identical to that returned
by the routine when the database entry was created. However, does not
compare all of the fields in entry, the annotation field, and the port
number in the saddr field.
This routine removes the entry from the LLB database on the local host
(the host that issues the routine). If the flags field of entry is
equal to 0, it removes the entry from the GLB database. If the flags
field is equal to lb_$server_flag_local, it deletes only the LLB entry.
Examples
The following statement unregisters the entry specified by which was
obtained from a previous routine:
lb_$unregister (&BankEntry, &status);
Diagnostics
This section lists status codes for errors returned by this routine in
lb_$database_invalid
The format of the Location Broker database is out
of date. The database may have been created by an
old version of the Location Broker; in this case,
delete the out-of-date database and reregister any
entries that it contained. The LLB or GLB that was
accessed may be running out-of-date software; in
this case, update all Location Brokers to the cur‐
rent software version.
lb_$database_busy The Location Broker database is currently in use in
an incompatible manner.
lb_$not_registered The Location Broker does not have any entries that
match the criteria specified in the unregister rou‐
tine. The requested object, type, interface, or
combination thereof is not registered in the speci‐
fied database.
lb_$update_failed The Location Broker was unable to register or
unregister the entry.
lb_$cant_access The Location Broker cannot access the database.
Among the possible reasons:
1. The database does not exist.
2. The database exists, but the Location Broker
cannot access it.
lb_$server_unavailable
The Location Broker Client Agent cannot reach the
requested GLB or LLB. A communications failure
occurred or the broker was not running.
FilesSee Alsointro(3ncs), lb_register(3ncs)lb_unregister(3ncs)