beautypg.com

Compaq AA-Q88CE-TE User Manual

Page 131

background image

CREATE PARTITION

/CONCURRENT (D)
/NOCONCURRENT

Specifies that concurrent servers are allowed for this partition.

/KEYn=keysegdesc

Specifies a partition key segment. Up to nine key segments may be defined for
a partition (KEY1, KEY2,... up to KEY9). (If more than nine key segements are
required, a named partiton can be created using the

rtr_open_channel( )

call.)

The syntax of the KEYn qualifier is:

/KEYn=

(type_of_key=[signed|unsigned|string], -

length_of_key=nnnn, -
offset_of_key=nnnn, -
low_bound=[string|nnnn] -
high_bound=[string|nnnn]

type_of_key=

Specifies the field type of the key. The

key-type

must be one of

unsigned

,

signed

or

string

. The default is

unsigned

.

length_of_key=nnnn

Specifies the length of the key field in enqueued messages

in bytes. For signed or unsigned ints, length may be either one, two, four or eight
bytes. The default value for

key-length

is four bytes.

offset_of_key=nnnn

Specifies the offset of the key within the messages in bytes.

The default is zero, that is, the key is at the start of the messages.

low_bound=

Specifies the lower bound of the key range that servers in the

partition will service. The interpretation of

low-bound

depends on the key type; if

the key is of type string then it is interpreted as text, otherwise it is interpreted
as a numeric value. The default for

low-bound

is the smallest possible value that

can fit in the specified key type.

If the key bound value length is less than the key length (given in

length_of_key

), the key bound will automatically be null-padded to the required

length.

high_bound=

Specifies the upper bound of the key range that servers in the

partition will service. The interpretation of

high-bound

depends on the key type.

If the key is of type string then it is interpreted as text, otherwise it is interpreted
as a numeric value. The default for

high-bound

is the largest possible value that

can fit in the specified key type.

If the key bound value length is less than the key length (given in

length_of_key

), the key bound will automatically be null-padded to the required

length.

If the specified key range overlaps that of an existing partition in the facility, or
if the key segment description conflicts with an existing definition, the command
fails.

/FACILITY

Specifies the name of the facility in which the partition is being created.

/NODE[=node-list]
/NODE=default-node-list (D)

Specifies that the command is executed on all nodes specified in

node-list

. If

node-list

is omitted then the command is executed only on the node where the

command was issued.

RTR Command Line Interface 6–55