VMS Help RPC, rpccp, show_mapping  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    NAME
         show mapping - Shows the elements of either the local or
         remote endpoint map

    SYNOPSIS
         rpccp show mapping   [ host-address ]
         [ -i if-id   [ -v versions ]]

1 - OPTIONS

         -i Defines an interface identifier to be shown (optional).
            Only one interface can be shown in a single operation.
            If specified, only elements containing this interface
            identifier are shown.  The -i option can be qualified by
            the -v option. The value 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 to be shown (optional).  Each show
            mapping command accepts up to 32 -o options.

            The UUID is a hexadecimal string, for example:

            -o 3C6B8F60-5945-11C9-A236-08002B102989

         -v Indicates how a specified interface version is used
            (optional).  If used without the -i option, the -v option
            is ignored.  The possible combinations of versions for
            the -v option and their actions are as follows:

            ________________________________________________
            Versions     Action
            ________________________________________________
            all          The interface version is ignored.

            exact        Both the major and minor versions
                         must match the specified versions.

            compatible   The major version must match the
                         specified version, and the minor
                         version must be greater than or
                         equal to the specified version.

            major_only   The major version must match the
                         specified version; the minor
                         version is ignored.

            upto         The major and minor versions must
                         be less than or equal to those
                         specified.
            ________________________________________________

            If the -v option is absent, the command shows compatible
            version numbers.

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 show mapping command shows elements of an endpoint map.
         Each element corresponds to an object UUID, interface
         identifier, annotation, and binding information. The binding
         information contains an RPC protocol sequence, a network
         address, and an endpoint within square brackets
         (rpc-prot-seq:network-addr[endpoint]).

         The endpoint map can be either the local endpoint map or the
         endpoint map of a specified remote host. If entered without
         a remote host address, the command accesses the local
         endpoint map. For the local endpoint map, a show mapping
         command without any options displays all the map elements.
         For a remote endpoint map, map elements are accessible only
         for protocol sequences that are supported on both your
         system and the remote system.

         Note:  To ensure that you can remotely display all
                map elements from every remote endpoint map,
                run the RPC control program on a system that
                supports all of the protocol sequences
                available in your network environment.

         The options list a selected subset of map elements. The - i
         option selects a specific interface, and the -v option
         qualifies the -i option. The -o object selects a specific
         object; you can use from 0 to 32 -o options per command. The
         options work together to specify the subset of elements for
         the target protocol sequence(s).

4 - EXAMPLES

         The following commands start the control program and show
         the map elements in the local endpoint map that contain the
         specified interface identifier:

         $ rpccp
         rpccp> show mapping -i EC1EEB60-5943-11C9-A309-08002B102989,1.1

         The following rpccp show mapping command operates from the
         system prompt.  The command accesses the endpoint map of the
         remote host specified by the host address
         (ncadg_ip_udp:16.20.16.44) and displays the one map element
         that contains both the specified interface identifier and
         the specified object UUID:

         $ rpccp show mapping  \
         > -i EC1EEB60-5943-11C9-A309-08002B102989,1.1  \
         > -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528  \
         > ncadg_ip_udp:16.20.16.44