HELPLIB.HLB  —  RPC  rpccp  remove_mapping
    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>
Close Help