remove element(1m)                  OSF                  remove element(1m)




 NAME    [Toc]    [Back]
      remove element - Removes selected elements from a profile

 SYNOPSIS    [Toc]    [Back]
      rpccp remove element profile-entry-name {-d | -i if-id -m  member | -a
      annotation} [-s syntax]


 OPTIONS    [Toc]    [Back]
      -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.



 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 remove element(1m)       Open Software Foundation        remove element(1m)




      -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    [Toc]    [Back]
      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    [Toc]    [Back]
      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:


      -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    [Toc]    [Back]
      You need read permission and write permission to the CDS object entry
      (the target profile entry).

 NOTE    [Toc]    [Back]
      This command is replaced at Revision 1.1 by the dcecp command and may
      not be provided in future releases of DCE.

 EXAMPLES    [Toc]    [Back]
      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



 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 remove element(1m)       Open Software Foundation        remove element(1m)




       rpccp
      pccp> remove element -i Calendar_1_1  \
       -m /.:/LandS/anthro/Calendar_group  \
       /.:/LandS/anthro/molly_o_profile


 RELATED INFORMATION    [Toc]    [Back]
      Commands: add element(1m), remove profile(1m), show profile(1m)


 Hewlett-Packard Company            - 3 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96