SET_RANGE

swadm command

Syntax

swadm SET_RANGE Machine_ID [Port_range_ID]

This command can be used for the following actions:

•

place an iProcess Engine server behind a defined port range.

•

remove an iProcess Engine server from behind a defined port range.

This information is updated in the port_range_nodes table.

Option	Description
`Machine_ID`	The server ID of the machine that you want to add to or remove from a port range. You can use the `SHOW_SERVERS` command to find out the server IDs of servers in this iProcess Engine node.
`Port_range_ID`	If you want to: add the specified `Machine_ID` to a port range, specify the ID of the port range that you want to place this server behind. You can use the SHOW_RANGES command to find out what port range IDs are defined. remove the specified `Machine_ID` from the port range that it is currently placed behind, you should omit this parameter.

Option

Description

Machine_ID

The server ID of the machine that you want to add to or remove from a port range.

You can use the SHOW_SERVERS command to find out the server IDs of servers in this iProcess Engine node.

Port_range_ID

If you want to:

add the specified Machine_ID to a port range, specify the ID of the port range that you want to place this server behind.

You can use the SHOW_RANGES command to find out what port range IDs are defined.

remove the specified Machine_ID from the port range that it is currently placed behind, you should omit this parameter.

The following error messages may be returned by this command.

Message	Description
`Machine_ID` is not a valid logical machine ID. Use 'swadm SHOW_SERVERS' to see the correct list.	You have used a `Machine_ID` that does not exist. Re-run the command using the correct server ID.
The specified Port Range ID parameter is invalid.	You have used a `Port_range_ID` value that does not exist. Re-run the command using the correct `Port_range_ID` value.
Unable to add the specified iPE machines to the port range configuration. Check sw_error/sw_warn for more details.	`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.