[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

lb_$unregister Library Routine

Purpose

Removes an entry from the Location Broker database.

Syntax

void lb_$unregister (entry, status)
lb_$entry_t *entry;
status_$t *status;

Description

The lb_$unregister routine removes from the Location Broker database the entry that matches the value supplied in the entry parameter. The value of the entry parameter should be identical to that returned by the lb_$register routine when the database entry was created. However, the lb_$unregister routine does not compare all of the fields in the entry parameter. It ignores the flags field, the annotation field, and the port number in the saddr field.

This routine removes the entry from the Local Location Broker (LLB) database on the local host (the host that issues the call). If the flags field of the entry parameter is not the value lb_$server_flag_local, this routine also removes the entry from all replicas of the Global Location Broker (GLB) database.

Parameters

Input
entry Points to the entry being removed from the Location Broker database.
Output
status Points to the completion status.

Examples

To unregister the entry specified by the BankEntry results structure, which was obtained from a previous call to the lb_$register routine, enter:

lb_$unregister (&BankEntry, &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 Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]