lb_register(3ncs)lb_register(3ncs)Namelb_register - register an object and an interface with the Location
Broker
Syntax
#include <idl/c/lb.h>
void lb_$register(object, obj_type, obj_interface, flags, annotation,
location, location_length, entry, status)
uuid_$t *object;
uuid_$t *obj_type;
uuid_$t *obj_interface;
lb_$server_flag_t flags;
unsigned char annotation[64];
socket_$addr_t *location;
unsigned long location_length;
lb_$entry_t *entry;
status_$t *status;
Arguments
object The UUID of the object being registered.
obj_type The UUID of the type of the object being regis‐
tered.
obj_interface The UUID of the interface being registered.
flags Must be either lb_$server_flag_local (specifying
registration with only the LLB at the local host)
or 0 (specifying registration with both the LLB and
the GLB).
annotation A character array used only for informational pur‐
poses. This field can contain a textual descrip‐
tion of the object and the interface. For proper
display by the tool, the annotation should be ter‐
minated by a null character.
location The socket address of the server that exports the
interface to the object.
location_length The length, in bytes, of the socket address speci‐
fied by the location field.
entry A copy of the entry that was entered in the Loca‐
tion Broker database.
status The completion status. If the completion status
returned in is equal to status_$ok , then the rou‐
tine that supplied it was successful.
Description
The routine registers with the Location Broker an interface to an
object and the location of a server that exports that interface. This
routine replaces any existing entry in the Location Broker database
that matches object, obj_type, obj_interface, and both the address fam‐
ily and host in location; if no such entry exists, the routine adds a
new entry to the database.
If the flags parameter is the entry is registered only in the LLB data‐
base at the host where the call is issued. Otherwise, the flag should
be 0 to register with both the LLB and the GLB databases.
Examples
The following statement registers the interface to the object identi‐
fied by :
lb_$register (&bank_id, &bank_$uuid, &bank_$if_spec.id, 0,
BankName, &saddr, slen, &entry, &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_$update_failed The Location Broker was unable to register the
entry.
lb_$cant_access The Location Broker cannot access the database.
Among the possible reasons:
1. The database does not exist, and the Location
Broker cannot create it.
2. The database exists, but the Location Broker
cannot access it.
3. The GLB entry table is full.
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_unregister(3ncs)lb_register(3ncs)
