OSF DCE Application Development Guide--Core Components

DCE Host Services

TABLE 2-1. API Routines for Remote Server Management

________________________________________________________

API Routine Service Name for Binding

________________________________________________________

dced_server_create( ) srvrconf

________________________________________________________

dced_server_start( ) srvrconf

________________________________________________________

dced_server_disable_if( ) srvrexec

________________________________________________________

dced_server_enable_if( ) srvrexec

________________________________________________________

dced_server_stop() srvrexec

________________________________________________________

dced_object_read() srvrexec or srvrconf

________________________________________________________

dced_object_read_all( ) srvrexec or srvrconf

________________________________________________________

dced_server_modify_attributes( ) srvrconf

________________________________________________________

dced_server_delete( ) srvrconf

________________________________________________________

2.6.2 Conﬁguring Servers

Although administrators commonly use dcecp to conﬁgure servers remotely,

management applications can use dced API routines to conﬁgure a new server remotely

by creating server conﬁguration data, changing a remote server’s conﬁguration, and

deleting a server’s conﬁguration data.

2.6.2.1 Conﬁguring a New DCE Server

Management applications use the dced_server_create() routine to add a new server to a

host. After a server is conﬁgured, it can be remotely controlled by modifying its

conﬁguration attributes, starting and stopping it, enabling or disabling the RPC interfaces

it supports, and deleting its conﬁguration.

Conﬁguring the server involves describing the server for DCE by allocating and ﬁlling in

a server_t data structure, as shown in the following example. Note that not all server_t

ﬁelds are assigned values in this example.

int i;

dced_binding_handle_t dced_bh;

server_t conf, exec;

dced_string_t server_name;

uuid_t srvrconf_id, srvrexec_id;

dced_attr_list_t attr_list;

error_status_t status;

static service_t nil_service;

124245 Tandem Computers Incorporated 2− 19