remove element(1m) remove element(1m)NAME
remove element - Removes selected elements from a profile
SYNOPSIS
rpccp remove element profile-entry-name {-d | -i if-id -m member | -a
annotation} [-s syntax]
OPTIONS
Removes the default profile element. With the -d option, the -a, -i,
and -m options are ignored. Defines an interface identifier for the
profile element to be removed for a member specified with the -m
option. Only one interface and member pair can be removed in a single
operation. If you supply multiple instances of the -i option, the com‐
mand uses the final instance.
The -i and -m options take precedence over the -a option. However, if
the default profile element is specified (by the -d option), the -i and
-m options are ignored.
The interface identifier value has the following form:
interface-uuid,major-version.minor-version
The UUID is a hexadecimal string and the version numbers are decimal
strings, for example: -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 Lead‐
ing zeros in version numbers are ignored. Defines a member name for
the profile element to be removed. This option is required if the
interface identifier is specified. Only one interface and member can
be removed in a single operation. If you supply multiple instances of
the -m option, the command uses the final instance. Removes all ele‐
ments whose annotation fields match the specified annotation; in the
presence of -d option or -i and -m options, the -a option is ignored.
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
Indicates the 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 remove element command removes an element from a profile in the
name service database. For a description of the fields in a profile
element, see add entry(1m).
The remove element command requires the entry name of the profile. The
command also requires one of the following options: The default profile
option takes precedence over the other two options. interface-id -m
member-name An interface and member pair takes precedence over the -a
option. The annotation option takes effect only if neither the -d or
-i option is specified.
Privilege Required
You need read permission and write permission to the CDS object entry
(the target profile entry).
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 initial shell commands set up an environment variable Calendar_1_1,
which represents the interface identifier of an RPC interface. The
control program commands set up an environment variable for the inter‐
face identifier of the Calendar Version 1.1 RPC interface, run RPCCP,
and remove an element from a profile, as follows: $ Calen‐
dar_1_1=ec1eeb60-5943-11c9-a309-08002b102989,1.1 $ export Calendar_1_1
$ rpccp rpccp> remove element -i Calendar_1_1 \ > -m
/.:/LandS/anthro/Calendar_group \ > /.:/LandS/anthro/molly_o_profile
RELATED INFORMATION
Commands: add element(1m), remove profile(1m), show profile(1m)
remove element(1m)
