NAME

define cached server - Creates knowledge of a server in the local clerk’s cache

SYNOPSIS

cdscp define cached server name tower value

ARGUMENTS

nameA simple name for the cached server. 

tower valueThe protocol sequence and network address of the server node.  The format is 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.  There are two choices of protocol sequence, depending on the network address that is supplied in the binding: ncacn_ip_tcp or ncadg_ip_udp.  For the network-address, specify an Internet address using the common Internet address notation.  For more information about this format, see the OSF DCE Application Development Reference. 

DESCRIPTION

The define cached server command creates knowledge of a server in the local clerk’s cache.  This command is typically used to manually provide configuration information to a clerk that cannot automatically configure itself.  This is required, for instance, to give the clerk addressing information about a server across a wide area network (WAN).  Once the clerk knows about one server, it can find other servers through referrals. 

Privileges Required

You must have w (write) permission to the clerk. 

NOTES

This command is replaced at DCE Version 1.1 by the dcecp command and may not be provided in future releases of DCE. 

EXAMPLES

The following command creates knowledge of the server nrl in the local clerk’s cache:

cdscp> define cached server nrl tower ncacn_ip_tcp:16.20.15.25

RELATED INFORMATION

Commands:

clear_cached_server(8cds), dump_clerk_cache(8cds), show_cached_server(8cds). 

Books: OSF DCE Application Development Reference.