setnetworkport

The setnetworkport command configures one network port for TCP/IP connections.

Read syntax diagramSkip visual syntax diagram setnetworkport  -dev  storage_image_ID  -ipaddr  IP_address  -subnet  IP_mask  -gateway  IP_address  -primary  IP_address  -secondary  IP_address  port_ID  ...  "-"

Parameters

Notes:
  1. One or more of the optional parameters, -ipaddr, -subnet, -gateway, -primary, or -secondary, must be specified.
  2. Only one port can be set or modified at a time.
-dev storage_image_ID
(Optional) A fully qualified storage image ID. The storage image ID consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
-ipaddr IP_address
(Optional) The TCP/IP address for the designated port.
Note: Ports that are on the same server must be on different subnets.
-subnet IP_mask
(Optional) The TCP/IP subnet mask for the designated port.
Note: Ports that are on the same server must be on different subnets.
-gateway IP_address
(Optional) The gateway TCP/IP address for the designated port.
-primary IP_address
(Optional) The primary DNS TCP/IP address for the designated port.
-secondary IP_address
(Optional) The secondary DNS TCP/IP address for the designated port.
port_ID ... | -
(Required) The network port ID. This parameter accepts a fully qualified port ID, which includes the storage image ID, or a shortened version without the storage image ID when the -dev parameter is specified.
A port ID is prefixed with letter I and consists of four hexadecimal characters with the binary bit definition of trre eeee aaaa pppp (value is separated for readability), where:
  • t = port type (1= network port)
  • rr = reserved bits and set to zero
  • eeeee = enclosure number (value specified is 18 - 1F)
  • aaaa = adapter number
  • pppp = port number
The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example: Configuring a network port for TCP/IP connections

This example shows how to configure network port (IBM.2107-1300321/I9801) to use IP address 192.168.5.5.
dscli> setnetworkport -dev IBM.2107-1300321 -ipaddr 192.168.5.5 I9801  
Output
CMUC00250I setnetworkport: Network port I9801 successfully configured.