[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, 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);

Related Information

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

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]