*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> rpccp_add_element (1m)              


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

 NAME    [Toc]    [Back]
      add element - Adds an element to a profile in a name service entry; if
      the specified entry does not exist, creates the entry.

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

 OPTIONS    [Toc]    [Back]
      -m        Defines a member name for the profile element to be added

      -d        Performs the add element operation on the default profile
                element. With the -d option, the -i and -p options are

      -i        Defines an interface identifier for the profile element to
                be added.  Only one interface can be added in a single
                operation.  An interface identifier is required, unless the
                default profile element is being added. With the -d option,
                the -i option is ignored.

                The value has the following form:


                The UUID is a hexadecimal string and the version numbers are
                a decimal string, for example:

                -i ec1eeb60-5943-11c9-a309-08002b102989,3.11

                Leading zeros in version numbers are ignored.

      -p        Defines a search priority for the new profile element.  The
                priority value is in the range 0 to 7, with zero having the
                highest priority. When a default element is added (with the
                -d option), the -p option is ignored. By default, a
                nondefault element is assigned a priority value of zero.

      -a        Defines an annotation string for the profile element.

                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

 add element(1m)          Open Software Foundation           add 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]
                Specifies the entry 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 add element command adds an element to a profile in a name service
      entry.  The name of the entry containing the profile and the entry
      name of the profile member in the new element are required.  The entry
      of a profile may have been created previously (by either the add entry
      or add element command).  But, if the specified entry does not exist,
      the add element command tries to create the entry.

      A profile element is a database record containing the following

      Interface identifier    [Toc]    [Back]
                This is the primary search key.  The interface identifier
                consists of the interface UUID and the interface version

      Member name    [Toc]    [Back]
                The entry name of one of the following kinds of name service

                  +  A server entry for a server offering the requested RPC
                     interface and object

                  +  A group corresponding to the requested RPC interface

                  +  A profile

      Priority value    [Toc]    [Back]
                The priority value (0 (zero) is the highest priority; 7 is
                the lowest) is designated by the creator of a profile
                element to help determine the order for using the element.
                NSI search operations select among like priority elements at
                random.  For the rpccp add element command, the default is

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

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

      Annotation string    [Toc]    [Back]
                The annotation string enables you to identify the purpose of
                the profile element. The annotation can be any textual
                information, for example, an interface name associated with
                the interface identifier or a description of a service or
                resource associated with a group.  The annotation string is
                not a search key for the import or lookup operations.

    Privilege Required    [Toc]    [Back]
      You need both read permission and write permission to the CDS object
      entry (the target profile entry).  If the entry does not exist, you
      also need insert permission to the parent directory.

 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 following command adds an element to the cell profile, /cell-
      profile, in the local cell:

      pccp> add element  \
       -i ec1eeb60-5943-11c9-a309-08002b102989,1.1  \
       -m /.:/Calendar_profile  \
       -a RefersToCalendarGroups  \

      The following control program commands start the control program, set
      up a user profile associated with the cell profile as its default
      element, and add a user-specific element for the Calendar V1.1
      interface, as follows:

      pccp>  add element  /.:/LandS/anthro/molly_o_profile  \
       -d   -m  /.:/cell-profile
      pccp>  add element  /.:/LandS/anthro/molly_o_profile  \
       -m  /.:/LandS/anthro/Calendar_group  \
       -i  ec1eeb60-5943-11c9-a309-08002b102989,1.1  \
       -a  Calendar_Version 1.1_Interface

      The added profile element contains the global name of the member
      (specified using its cell-relative name,
      /.:/LandS/anthro/Calendar_group) and the RPC interface identifier for
      the Calendar Version 1.1 interface.

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

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

      Commands: remove element(1m), remove profile(1m), show profile(1m)

 Hewlett-Packard Company            - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
[ Back ]
 Similar pages
Name OS Title
rpccp_add_member HP-UX Adds a member to a group in a name service entry; if the specified entry does not exist, creates the entry
rpccp_remove_profile HP-UX Removes all profile elements and the profile from the specified name service entry
rpccp_add_entry HP-UX Adds a name service entry to the name service database
cdevsw_add FreeBSD adds a cdevsw entry
dcecp_rpcprofile HP-UX A dcecp object that manages an RPC profile entry in CDS
DXmSvnSetComponentWidget Tru64 Adds an SVN subwidget component to an entry.
DXmSvnSetComponentPixmap Tru64 Adds a pixmap component to an entry.
unadvertise HP-UX Removes the global server entry from the cell profile
DXmSvnSetComponentText Tru64 Adds a read-only component string to an entry.
acl_add_perm Tru64 Adds a permission to a set of permissions belonging to an ACL entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service