NAME

add element - Adds an element to a profile in a name service entry

SYNOPSIS

rpccp add element  profile-entry-name -m member {-d | -i if-id [-p priority]}
[-a annotation] [-s syntax]

OPTIONS

-m memberDefines a member name for the profile element to be added (required). 

-dPerforms the add element operation on the default profile element.  With the ­-d option, the -i and ­-p options are ignored. 

-i if-idDefines an interface identifier for the profile element to be added.  Only one interface can be added in a single operation.  An interface identifier is required, unless the default profile element is being added.  With the ­-d option, the ­-i option is ignored. 

The value has the following form:

interface-uuid,major-version.minor-version

The Universal Unique Identifier (UUID) is a hexadecimal string and the version numbers are a decimal string, for example:

-i ec1eeb60-5943-11c9-a309-08002b102989,3.11

Leading zeros in version numbers are ignored. 

-p priorityDefines a search priority for the new profile element.  The priority value is in the range 0 to 7, with zero having the highest priority.  When a default element is added (with the ­-d option), the ­-p option is ignored.  By default, a nondefault element is assigned a priority value of zero. 

-a annotation
Defines an annotation string for the profile element.

Note that the shell supports quotation marks around the annotation field of profile elements, which allows you to include internal spaces in an annotation; the control program does not.  To specify or refer to annotations from within the control program, limit each annotation to an unbroken alphanumeric string; for example, CalendarGroup.  To refer to annotations from the system prompt, do not incorporate quotation marks into any annotation. 

-s syntaxIndicates the name syntax of the entry name (optional).  The only value for this option is the dce name syntax, which is the default name syntax.  Until an alternative name syntax becomes available, specifying the ­-s option is unnecessary. 

ARGUMENTS

profile-entry-name
Specifies the entry name of the target profile. For an entry in the local cell, you can omit the cell name and specify only the cell-relative name.

DESCRIPTION

The add element command adds an element to a profile in a name service entry.  The name of the entry containing the profile and the entry name of the profile member in the new element are required.  The entry of a profile may have been created previously (by either the add entry or add element command).  But if the specified entry does not exist, the add element command tries to create the entry. 

A profile element is a database record containing the following fields:

       •interface identifier This is the primary search key. The interface identifier consists of the interface UUID and the interface version numbers.

       •member name The entry name of one of the following kinds of name service entries:

       —
A server entry for a server offering the requested remote procedure call (RPC) interface and object

       —
A group corresponding to the requested RPC interface

       —
A profile

       •priority_value The priority value (0 (zero) is the highest priority; 7 is the lowest) is designated by the creator of a profile element to help determine the order for using the element. NSI search operations select among like priority elements at random. For the rpccp add element command, the default is 0. 

       •annotation string The annotation string enables you to identify the purpose of the profile element.  The annotation can be any textual information, for example, an interface name associated with the interface identifier or a description of a service or resource associated with a group. The annotation string is not a search key for the import or lookup operations.

Privileges Required

You need both r (read) permission and w (write) permission to the Cell Directory Service (CDS) object entry (the target profile entry).  If the entry does not exist, you also need insert permission to the parent directory. 

NOTES

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

EXAMPLES

     1.The following command adds an element to the cell profile, /cell-profile, in the local cell:

rpccp> add element -i ec1eeb60-5943-11c9-a309-08002b102989,1.1  \
       -m /.:/Calendar_profile -a RefersToCalendarGroups /.:/cell-profile

     2.The following commands start the control program, set up a user profile associated with the cell profile as its default element, and add a user-specific element for the Calendar Version 1.1 interface:

rpccp> add element  /.:/LandS/anthro/molly_o_profile -d -m  /.:/cell-profile
rpccp> add element  /.:/LandS/anthro/molly_o_profile \
       -m  /.:/LandS/anthro/Calendar_group  \
       -i  ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
       -a  Calendar_Version 1.1_Interface

The added profile element contains the global name of the member (specified by /.:/LandS/anthro/Calendar_group, its cell-relative name) and the RPC interface identifier for the Calendar Version 1.1 interface. 

RELATED INFORMATION

Commands:

rpccp_remove_element(8rpc), rpccp_remove_profile(8rpc), rpccp_show_profile(8rpc)