remove element(8rpc) — Maintenance
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
-dRemoves the default profile element. With the -d option, the -a, -i, and -m options are ignored.
-i if-idDefines 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 command uses the final instance. The -i and -m options take precedence over the -a option; if the default profile element is specified with the -d option, however, the -i and -m options are ignored.
The interface identifier 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 decimal strings, as in the following example:
-i ec1eeb60-5943-11c9-a309-08002b102989,1.1
Leading zeros in version numbers are ignored.
-m memberDefines 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. he -i and -m options take precedence over the -a option; if the default profile element is specified with the -d option, however, the -i and -m options are ignored.
-a annotation
Removes all elements 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 the use of " " (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
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 the add entry(8rpc) reference page.
The remove element command requires the entry name of the profile. You must also specify either -d, or -i and -m, or -a.
Privileges Required
You need r (read) and w (write) permission to the Cell Directory Service (CDS) object entry (the target profile entry).
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 sequence of commands sets up an environment variable Calendar_1_1, which represents the interface identifier of a remote procedure call (RPC) interface, exports it, and removes an element from a profile:
Calendar_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:
rpccp_add_element(8rpc), rpccp_remove_profile(8rpc), rpccp_show_profile(8rpc).