PreviousNext

remove mapping(8rpc)

Removes specified elements from the local endpoint map

Synopsis

rpccp remove mapping -b string-binding
-i interface-identifier
[-o object-uuid]

Options

-b string-binding
Specifies a string representation of a binding over which the server can receive remote procedure calls. At least one binding is required.

The value has the form of an RPC string binding, without an object UUID, for example:

-b ncadg_ip_udp:63.0.2.17[5347]

Note that depending on your system, string binding delimiters such as brackets ([ ]) may need to be preceded by an escape symbol (\) or put within quotation marks (' ' or " "). Requirements vary from system to system, and you must conform to the usage rules of a system.

-I interface-identifier
Specifies an interface identifier to remove from the local endpoint map. An interface identifier is required. Only one interface can be removed in a single operation. The interface identifier has the following form:

interface-uuid,major-version.minor-version

The UUID is a hexadecimal string and the version numbers are decimal strings, for example:

-i ec1eeb60-5943-11c9-a309-08002b102989,1.1

Leading zeros in version numbers are ignored.

-o object-uuid
Defines an object UUID that further determines the endpoint map elements that are removed (optional). Each remove mapping command accepts up to 32 -o options.

The UUID is a hexadecimal string, for example:

-o 3c6b8f60-5945-11c9-a236-08002b102989

Description
The remove mapping command removes server address information from the local endpoint map. Each element in the local endpoint map logically contains the following:

Interface ID, consisting of an interface UUID and versions (major and minor)

· Binding information

· Object UUID (optional)

· Annotation (optional)

This command requires one interface identifier (the -i option); at least one string binding (the -b option); and optionally, one or more object UUIDs (the -o option). Each instance of the command accepts from 1 to 32 -b options and from 0 to 32 -o options. The options work together to delimit the elements to be removed from the target endpoint map. The command removes any map element that contains the specified interface identifier, a specified string binding, and a specified object UUID (if any).

Notes
This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

Examples
The following command operates from the system prompt to remove a map element from the local endpoint map. The command removes only the map element that contains the specified interface identifier, server address (specified as a string binding), and object UUID.

$ rpccp remove mapping \
> -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
> -b ncadg_ip_udp:16.20.16.64[3424] \
> -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528

Related Information
Commands:

add mapping(8rpc)

show mapping(8rpc)

show server(8rpc)