Technical Reference: Communications, Volume 1

lb_$register Library Routine (NCS)

Purpose

Registers an object and an interface with the Location Broker.

void lb_$register ( object, object_type, object_interface, flags, annotation) void lb_$register ( sockaddr, slength, entry, status) uuid_$t *object; uuid_$t *object_type; uuid_$t *object_interface; b_$server_flag_t *flags; char annotation [ ]; socket_$addr_t *sockaddr; unsigned long slength; lb_$entry_t *entry; status_$t *status;

Description

The lb_$register routine registers with the Location Broker a specific interface to an object and the location of a server that exports that interface. This routine replaces an existing entry in the Location Broker database that matches the object, object_type, and object_interface parameters as well as both the address family and host in the socket address specified by the sockaddr parameter. If no such entry exists, the routine adds a new entry to the database.

If the flags parameter has a value of lb_$server_flag_local, the entry is registered only in the Local Location Broker (LLB) database at the host where the call is issued. Otherwise, the entry is registered in both the LLB and the Global Location Broker (GLB) databases.

Parameters

Input

object	Points to the Universal Unique Identifier (UUID) of the object being looked up.
object_type	Points to the UUID of the type being looked up.
object_interface	Points to the UUID of the interface being looked up.
flags	Points to the server that implements the interface. The value must be 0 or lb_$server_flag_local.
annotation	Specifies information, such as textual descriptions of the object and the interface. It is set in a 64-character array.
sockaddr	Points to the socket address of the server that exports the interface to the object.
slength	Specifies the length, in bytes, of the socket address (sockaddr) parameter.

Output

entry	Points to the copy of the entry that was entered in the Location Broker database.
status	Points to the completion status.

Examples

To register the bank interface to the bank_id object, enter:

lb_$register (&bank_id, &bank_$uuid, &bank_$if_spec.id, 0,
   BankName, &saddr, slen, &entry, &st);

Implementation Specifics

This Library Routine is part of Network Computing System in Network Support Facilities in Base Operating System (BOS) Runtime.

Related Information

Remote Procedure Call (RPC) Runtime Library (NCS) in AIX 5L Version 5.1 Communications Programming Concepts.