OSF DCE Application Development Guide--Core Components

RPC and Other DCE Components
14.3.2.2 Examples of Searching for Server Entries
This subsection provides several examples of how the NSI import_next and
lookup_next operations search for binding information associated with a given RPC
interface and object in a namespace.
The examples in this guide use the following conventions:
• To simplify the following examples, each member name is represented by a leaf
name preceded by the symbol that represents the local cell (/.:). For example, the
full global name of the group for the Bulletin_board_interface is as follows:
/.../C=US/O=uw/OU=MadCity/LandS/bb_grp
The abridged name is /.:/LandS/bb_grp.
• Except for the nil interface UUID of the default profile, the examples avoid string
representations of actual UUIDs. Instead, the examples represent a UUID as a
value consisting of the name of the interface and the string if-uuid or of the name
of the object and the string object-uuid; for example:
calendar-if-uuid,1.0
laser-printer-object-uuid
• Profile elements in the examples are organized as follows (annotations are not
displayed):
interface-identifier member-name priority
For example,
2fac8900-31f8-11ca-b331-08002b13d56d,1.0 /.:/LandS/C_host_7 0
which, in the following examples, is represented as follows:
calendar-if-uuid,1.0 /.:/LandS/C_host_7 0
Note: The priority is a value of 0 to 7, with 0 having the highest search
priority and 7 having the lowest priority.
The first two examples begin with the personal profile of a user, Esther Rose, whose
user name is esther_r and whose profile has the leaf name of esther_r_profile.To
use this profile, Esther must specify its entry name to the client. Usually, a client
either uses the predefined RPC environment variable RPC_DEFAULT_ENTRY or
prompts for an entry name. For a client to use RPC_DEFAULT_ENTRY, the client
or user must have already set the variable to a directory service entry.
The following example illustrates six profile elements from the individual user profile
used in the first two examples. The six elements include five nondefault elements for
some frequently used interfaces and a default profile element. Each profile element is
displayed on three lines, but in an actual profile all the fields occupy a single record.
124245 Tandem Computers Incorporated 14− 31