/sys$common/syshlp/helplib.hlb DCE_RPC, rpccp, ARGUMENTS, remove_element  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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

   -d        Removes the default profile element.  With the -d option,
             the -a, -i, and -m options are ignored.

   -i        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.

   -m        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.

   -a        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 quotation marks into any annotation.

   -s        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

   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 add entry.

   The remove element command requires the entry name of the profile.
   The command also requires one of the following options:

   -d        The default profile option takes precedence over the other
             two options.

   -i        interface-id -m member-name An interface and member pair
             takes precedence over the -a option.

   -a annotation-string
             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 DCL command sets up a logical name Calendar_1_1, which
   represents the interface identifier of an RPC interface.  The
   control program commands set up a logical name for the interface
   identifier of the Calendar Version 1.1 RPC interface, run RPCCP, and
   remove an element from a profile, as follows:

        $ define Calendar_1_1 ec1eeb60-5943-11c9-a309-08002b102989,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
             remove profile
             show profile