add element(1m) add element(1m)NAME
add element - Adds an element to a profile in a name service entry; if
the specified entry does not exist, creates the entry.
SYNOPSIS
rpccp add element profile-entry-name -m member {-d | -i if-id [-p
priority]} [-a annotation] [-s syntax ]
OPTIONS
Defines a member name for the profile element to be added (required).
Performs the add element operation on the default profile element.
With the -d option, the -i and -p options are ignored. Defines 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 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 num‐
bers are ignored. Defines a search priority for the new profile ele‐
ment. 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. 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. Indicates 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
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-rela‐
tive 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:
This is the primary search key. The interface identifier consists of
the interface UUID and the interface version numbers. The entry name
of one of the following kinds of name service entries: A server entry
for a server offering the requested RPC interface and object A group
corresponding to the requested RPC interface A profile 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. 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 opera‐
tions.
Privilege Required
You need both read permission and write permission to the CDS object
entry (the target profile entry). If the entry does not exist, you
also need insert permission to the parent directory.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and may
not be provided in future releases of DCE.
EXAMPLES
The following command adds an element to the cell profile, /cell-pro‐
file, in the local cell: $ rpccp rpccp> add element \ > -i
ec1eeb60-5943-11c9-a309-08002b102989,1.1 \ > -m /.:/Calendar_profile
\ > -a RefersToCalendarGroups \ > /.:/cell-profile The following con‐
trol program 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 V1.1 interface, as follows: $
rpccp rpccp> add element /.:/LandS/anthro/molly_o_profile \ > -d
-m /.:/cell-profile rpccp> rpccp> add element
/.:/LandS/anthro/molly_o_profile \ > -m /.:/LandS/anthro/Calen‐
dar_group \ > -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 \ > -a
Calendar_Version 1.1_Interface rpccp>
The added profile element contains the global name of the member (spec‐
ified using its cell-relative name, /.:/LandS/anthro/Calendar_group)
and the RPC interface identifier for the Calendar Version 1.1 inter‐
face.
RELATED INFORMATION
Commands: remove element(1m), remove profile(1m), show profile(1m)
add element(1m)