RPC
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help RPC *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
The Remote Procedure Call (RPC) service provides connections between
individual procedures in an application across heterogeneous systems
in a transparent way.
o The process or daemon which maintains the local
endpoint map for RPC servers and looks up endpoints
for RPC clients is called DCE Daemon (DCED). It allows
client/server RPC applications to register their specific
endpoints. Registering endpoints allows remote clients of
the application to find the server application's entry
point on the system.
The DCE daemon can be started or stopped with the
command files DCE$RPC_STARTUP.COM and DCE$RPC_SHUTDOWN.COM,
which are located in SYS$COMMON:[SYSMGR].
o The rpccp control program accesses DCE$RPCCP.EXE, the RPC
control program. RPCCP also supports showing the elements
of the local endpoint map and removing elements from it.
| 1 - Admin Intro |
intro
NAME
Introduction to the DCE daemon and RPC control program
commands
DESCRIPTION
RPC provides two administrative facilities, the DCE
daemon and the RPC control program.
o The DCE daemon is a process that provides the endpoint
map service, which maintains the local endpoint map for
local RPC servers and looks up endpoints for RPC
clients. An endpoint is the address of a specific
instance of a server executing in a particular address
space on a given system (a server instance). Each
endpoint can be used on a system by only one server at
a time.
An endpoint map is a database where servers register
their binding information, including endpoints, for
each of their RPC interfaces and the associated RPC
objects. Each combination of binding information,
interface identifier, and object UUID uses a distinct
element in the local endpoint map.
Running the DCE$RPC_STARTUP.COM procedure starts the
RPC daemon. The DCE$RPC_SHUTDOWN.COM procedure is used
to stop the RPC daemon.
o The control program provides a set of commands for managing
endpoint maps. The control program supports showing endpoint
map elements and removing any set of map elements from the
local endpoint map or from any remote endpoint map.
The rpccp command starts the RPC control program
(DCE$RPCCP.EXE).
EXIT VALUES
The RPC control program reports RPC error messages on the
command line. If the command executes successfully, the
value returned is 1 (one); otherwise, the value is an OpenVMS
DCE error status.
RELATED INFORMATION
Type HELP RPC for help about:
Commands: dced rpccp
STARTING and STOPPING RPC:
The RPC daemon can be started or stopped with the two new command files
DCE$RPC_STARTUP.COM and DCE$RPC_SHUTDOWN.COM, which are located in
SYS$COMMON:[SYSMGR].
STARTING:
To start the DCE daemon, execute DCE$RPC_STARTUP.COM.
The following options may be specified:
[NO]CONFIRM - Turns user prompting on or off. CONFIRM is the
default.
STOPPING:
To stop the Remote Procedure Call daemon execute
DCE$RPC_SHUTDOWN.COM. The following options may
be specified in any order.
[NO]CONFIRM - Turns user prompting on or off. CONFIRM is the
default.
CLEAN - Deletes all entries from the RPC endpoint database.
Note: The DCE daemon must not be stopped if any DCE components
or RPC applications are running on the system.
| 2 - rpccp |
NAME
rpccp - Starts the RPC control program
SYNOPSIS
rpccp [ rpccp-command ]
2.1 - ARGUMENTS
rpccp-command
Specifies one of the following control program
commands:
exit Leaves the RPC control program.
help Displays a list of commands or the possible options
of a specified command.
quit Leaves the RPC control program.
remove mapping
Removes specified elements from the local endpoint
map or from the endpoint map of a specified remote
host.
show mapping
Shows the elements of the local endpoint map.
2.2 - DESCRIPTION
The RPC control program (rpccp) provides a set of commands
for managing the endpoint map.
You can use control program commands from within the control
program or from the system prompt (represented here as a $).
o From inside the control program:
You can start and enter the control program using the
rpccp command alone, without any argument. The control
program then displays the control program prompt
(rpccp>), as follows:
$ rpccp
rpccp>
You can then enter any control program command, for
example:
rpccp> show mapping
You leave the control program and return to the system
prompt using the exit or quit command.
If you enter invalid input, the control program
displays the valid commands.
o From the system prompt:
Interactively or in a command procedure, enter the
rpccp command with an internal command of the control
program as the first argument.
2. 2.1 - Arguments and Options
Except for the exit and quit commands, rpccp commands have
one or more options. Each option is identified by a hyphen
(-) followed by a letter; for example, -s. Some options
require arguments.
___________________________________________________________
Function At System Prompt Inside Control Program
___________________________________________________________
Strings within Supported Not required
quotation marks
Wildcard Supported Unsupported
substitution
___________________________________________________________
2. 2.2 - RPC Control Program Commands
_________________________________________________________
Scope Command Unsupported in RPC-only
Configuration
_________________________________________________________
All entries add entry X
remove entry X
show entry X
Server entry export X
import X
show server X
unexport X
Group add member X
remove group X
remove member X
show group X
Profile add element X
remove element X
remove profile X
show profile X
Endpoint map remove mapping
show mapping
____________________________________________________
2.3 - help
NAME
help - Displays a list of commands or the options of a
specified command
SYNOPSIS
rpccp help [ rpccp-command ]
ARGUMENTS
rpccp-command
Specifies one of the following control commands:
exit
quit
2. 3.1 - DESCRIPTION
The help command displays information about the RPCCP
command set or the options and argument associated with a
specific command.
2. 3.2 - EXAMPLES
The following command operates from the system prompt to
display the internal commands of the control program:
$ rpccp help
The following commands start the control program and display
the syntax of the remove entry command:
$ rpccp
rpccp> help remove entry
2. 3.3 - RELATED_INFORMATION
Type HELP RPC for help about:
Commands: remove mapping, rpccp, show mapping
2.4 - 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 ]
2. 4.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. 4.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.
2. 4.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).
2. 4.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>
2.5 - show_mapping
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 ]]
2. 5.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. 5.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.
2. 5.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).
2. 5.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
|
|
