Compaq AA-Q88CE-TE - Manual (Page 42)

Partition Management
3.2 Partition Naming
3.2 Partition Naming
A prerequisite for partition management is the ability to identify a partition in
the system that is to be the subject of management commands. For this purpose,
partitions have been given names, which may be drawn from a number of sources
described below.
3.2.1 Default Partition Names
Unless supplied by one of the methods described below, partitions receive
automatically generated default names. They allow system operators access
to the partition command set without the need to change existing application
programs or site configuration procedures.
3.2.2 Programmer Supplied Names
An extension to the rtr_open_channel( ) call allows the application programmer
to supply a name when opening a server channel. The pkeyseg argument
specifies an additional item of type rtr_keyseg_t , assigning the following values:
• ks_type = rtr_keyseg_partition , indicating that a partition name is being
passed.
• code_example>(ks_lo_bound) should point to the null-terminated string to use
for the partition name.
• code_example>(ks_hi_bound) must be NULL.
Using this model, the partition segments and key ranges served by the server are
still specified by the server when the channel is opened.
3.2.3 System Manager Supplied Partition Names
Partitions can be defined by the system manager through the use of the code_
example>(create partition) system management command, or through use of
rtr_open_channel( ) flag arguments. The system manager can set partition
characteristics with this command and applications can open channels to the
partition by name. See the Section 3.4 for an example of passing a partition
name with
rtr_open_channel( ) .
3.2.4 Name Format and Scope
A valid partition name must contain no more than 63 characters in length and
can combine alphanumeric characters (abc123), the plus sign (+), the underscore
(_), and the dollar sign ($). Partition names must be unique within a facility
name and should be referenced on the command line with the facility name when
using partition commands. Partition names exist only on the backend where the
partition resides. You won’t see the partition names at the RTR routers.
3.3 Life Cycle of a Partition
3–2 Partition Management