ADD_RANGE

swadm command

Syntax

swadm ADD_RANGE [-m Range_mode] [-p Port_range_start] [-r RPC_range_start] [-s Range_size]

Description

This command defines a new port range for use with this iProcess Engine node. You can then use the SET_RANGE command to place a server behind this port range.

The port range is stored as a record in the port_range_conf table.

Options

Option	Description
-m `Range_mode`	Defines how servers that use this port range configuration should allocate ports. Specify one of the following values: `0` - Do not use port or RPC ranges. A process can use any port number and RPC number (as assigned by the operating system). `1` - Use port ranges. A process must use a port number allocated from within the defined range, but can use any RPC number. `2` - Use RPC ranges. A process must use an RPC number allocated from within the defined range, but can use any port number. `3` - Use port ranges and RPC ranges. A process must use both a port number and an RPC number allocated from within the defined ranges. If this value is omitted the range mode defaults to `3`.
`-p` `Port_range_start`	The port number that the range should start from. (The range will therefore end at `Port_range_start` + `Range_size`.) If this value is omitted, the port range start value defaults to `10000`.
`-r` `RPC_range_start`	The RPC number that the range should start from. (The range will therefore end at `RPC_range_start` + `Range_size`.) If this value is omitted, the RPC range start value defaults to `400000`.
`-s` `Range_size`	The number of slots in the defined port and/or RPC number ranges. If this value is omitted, the range size value defaults to `20`.

Errors

The following error messages may be returned by this command.

Message	Description
`Unable to access the port_range_conf table`	`swadm` cannot update the iProcess Engine database. Examine the `sw_error` and `sw_warn` files, located in the `SWDIR\logs` directory, for more information about the cause of the error. See iProcess Engine Log Files for more information.

ADD_RANGE

Syntax

Description

Options

Errors

See Also