cdscache create

cdscache create server_name -binding server_binding

Options

-binding server_binding
The required -binding option lets you specify the binding information for a CDS server. This option takes a server_binding argument which is the protocol sequence and network address of the server node. The string format is as follows:
protocol-sequence:network-address

The dcecp format is as follows:
{protocol-sequence network-address}

A protocol-sequence is a character string identifying the network protocols used to establish a relationship between a client and server. Protocol sequences have a specific format that depends on the network address that is supplied in the binding; for example ncacn_ip_tcp (for connection-based protocol) or ncadg_ip_udp (for datagram protocol). The network-address is a string representing the network address of the server node.

Description
The cdscache create operation creates knowledge of a server in the local client's cache. The server_name_list argument is a list of one or more simple names for the cached server. (An example of a simple name simple name is pelican, as opposed to a cell-relative name like /.:/hosts/pelican/self.) This command is typically used to manually provide configuration information to a client that cannot automatically configure itself. This is required, for instance, to give the client addressing information about a server across a WAN. Once the client knows about one server, it can find other servers through referrals. The command returns an empty string on success.

Privileges Required
You must have w (write) permission to the client system, /.:/hosts/hostname/cds-clerk.

Examples
The following command creates knowledge of the server pelican in the client's cache:

dcecp> cdscache create pelican -binding ncacn_ip_tcp:16.20.15.25
dcecp>