rpcprofile add

rpcprofile add profile_name_list
{-default | -member member_name_list [-interface interface_id]
[-priority priority] [-annotation annotation]}

Options

-member member_name_list
This required option declares the name of a member to be added to the specified profile entry. The member_name_list argument is a list of names of one or more members to be added to all of the specified profiles.

See Data Structures for the format of the interface identifier.

-interface interface_id
Required when the -default option is not used, this option declares the interface identifier of an RPC interface. The add operation operates on only one interface_id.

-priority priority
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. By default, a nondefault element is assigned a priority value of zero.

-annotation annotation
Defines an annotation string for the profile element. You can include internal spaces in an annotation by enclosing the string in quotation marks.

-default
Performs the operation on the default profile member. When you use the -default option, all other options except -member are illegal.

Description
The rpcprofile add operation adds a member to the specified profile entry in the CDS. The profile_name_list argument is a list of names of RPC profiles to have members added to. The value of the required -member option is a list of names which are references to an RPC entry, RPC group, or RPC profile (that is, they do not have to actually exist).

The operation accepts the -interface, -priority, and -annotation options with one value (not a list) each. All members are added to each profile identified in the argument list. It also accepts a -default option to indicate that the member being added is the default profile member. (If you specify the -default option, the only other option that can be supplied is -member.) This operation returns an empty string on success. If member_name_list contains the names of duplicate or existing members, the duplicates are ignored, and no errors are generated.

Privileges Required
You need i (insert) permission to the parent directory. You also need both r (read) permission and w (write) permission to the CDS object entry (the target profile entry).

Examples
The following command adds an element to the cell profile, /.:/cell-profile, in the local cell:

dcecp> rpcprofile add /.:/cell-profile \
> -member /.:/Calendar_profile \
> -interface ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
> -annotation RefersToCalendarGroups
dcecp>

The following commands set up a user profile associated with the cell profile as its default element, and add a user-specific element for the Calendar Version 1.1 interface:

dcecp> rpcprofile add /.:/LandS/anthro/molly_o_profile \
> -default /.:/cell-profile
dcecp>

dcecp> rpcprofile add /.:/LandS/anthro/molly_o_profile \
> -member {/.:/LandS/anthro/Calendar_group} \
> -interface {ec1eeb60-5943-11c9-a309-08002b102989 1.1} \
> -annotation {Calendar_Version 1.1_Interface}
dcecp>

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.