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 command 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
       Leading	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 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 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  quota-
       tion  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 pro-
       file  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 interface identifier of the Calendar Version 1.1 RPC interface, run RPCCP,
       and remove an element from a profile, as follows: $ 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: add element(1m), remove profile(1m), show profile(1m)

																remove element(1m)