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

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

 SYNOPSIS

   rpccp show mapping [host-address] [-i if-id [-v versions]]
                      [-o object-uuid [ -o object-uuid...]]

 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.

   -v        Indicates how a specified interface version is used
             (optional).  If it is used without the -i option, the
             -v option is ignored.  The possible combinations of
             versions for the -v option and their actions are
             described in the following table.

                 ________________________________________________
                 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 ver-
                              sion is ignored.

                 upto         The major version must be less than
                              or equal to that specified.  If the
                              major versions are equal, the minor
                              version must be less than or equal
                              to that specified.
                 ________________________________________________

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

   -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

 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 which protocol sequence
             to use (optional); for example,

                  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 example,

                  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.

 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- protseq: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.

   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).

 NOTES
   Note that 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.

   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 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

 RELATED INFORMATION
   Commands: remove mapping
             show server