/sys$common/syshlp/helplib.hlb DCE_RPC, rpccp, ARGUMENTS, remove_mapping *Conan The Librarian (sorry for the slow response - running on an old VAX) |
NAME remove mapping - Removes specified elements from the local endpoint map SYNOPSIS rpccp remove mapping -b string-binding -i interface-identifier [-o object-uuid] OPTIONS -b 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 placed within quotation marks (' ' or " "). Requirements vary from system to system, and you must conform to the usage rules of a system. -i 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 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). NOTE 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 show mapping show server
|