NAME remove mapping - Removes specified elements from either the local or a remote endpoint map SYNOPSIS rpccp remove mapping [ host-address ] -b string-binding -i if-id [ -v versions ] [ -o object-uuid ]
1 – OPTIONS
-b Declares a string binding (required). You must also specify an interface identifier (using the -i option). Each command accepts up to 32 -b options. 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 placed within quotation marks (' ' or " "). Requirements vary from system to system, and you must conform to the usage rules of a system. -i Declares an interface identifier (required). Only one interface can be removed in a single operation. The interface identifier has the following form: interface-uuid,major-version.minor-version
2 – ARGUMENTS
host-address The host-address argument is a string binding that indicates where to find the target endpoint map. When accessing the local endpoint map, you can specify what protocol sequence to use (optional); ncadg_ip_udp: When accessing a remote endpoint map, you must specify both a protocol sequence and a network address for the remote system (required); for ncadg_ip_udp:16.20.16.44 An endpoint is unnecessary in local or remote host addresses, and the remove mapping command ignores any endpoint specified as part of a host address.
3 – DESCRIPTION
The remove mapping command removes one or more elements from an endpoint map. The target endpoint map can be either the local endpoint map or the endpoint map of a specified remote host. Each map element corresponds to an object UUID, interface identifier, annotation (optional), and binding information. The binding information contains an RPC protocol sequence, a network address, and an endpoint within brackets (rpc-prot-seq:network-addr[endpoint]). If entered without a remote host address as an argument, the command operates on the local endpoint map. 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).
4 – 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 \ > -b ncadg_ip_udp:16.20.16.64[3424] \ > -i EC1EEB60-5943-11C9-A309-08002B102989,1.1 \ > -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528 $ The following commands start the control program and remove an element from a remote endpoint map. The remove mapping command operates on the endpoint map of the remote host specified by the host address (ncadg_ip_udp:16.20.16.44) and removes the map element that contains the specified interface identifier, server address (specified as a string binding), and object UUID: $ rpccp rpccp> remove mapping \ > -b ncadg_ip_udp:16.20.16.64[3424] \ > -i EC1EEB60-5943-11C9-A309-08002B102989,1.1 \ > -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528 \ > ncadg_ip_udp:16.20.16.44 rpccp>