Compaq AA-Q88CE-TE manual Partition Naming, Life Cycle of a Partition

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–2Partition Management