raidcom modify port

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

Sets the attribute of the specified port.

When you set a port attribute by options other than a -port_attribute option, the port type of the specified port must be one of the following:

  • FIBRE
  • FCoE
  • iSCSI

If these conditions are not satisfied, this command is rejected with EX_ENOOBJ.

When using an FCoE package, specify Port speed: 10G, Port topology: f_port. In this case, the port attribute cannot be changed.

When you set the T10 PI mode or specify the -request_id option, this command is executed asynchronously with the command input. Check the completion of this process using the raidcom get command_status command.

There is a limit to the number of asynchronous commands that can be accepted simultaneously. For details, see Maximum number of acceptable asynchronous commands.

The syntax is separated into 6 groups as follows. Syntaxes 2 through 6 can be used only for iSCSI ports. If you execute a command that includes options in syntax 3 with options in syntax 2, 4, 5, or 6, an error occurs.

When the {-t10pi {enable|disable} | -iscsi_virtual_port_mode {enable | disable} | -port_mode {scsi | nvme} -request_id auto | -delete_login_host_nqn} option is specified, if a failure occurs in a processor on an MP blade or a controller, this command cannot be run even on an MP blade or a controller on which no failure occurs.

Syntax

Syntax 1

raidcom modify port -port <port#>{[-port_speed <value>]
   [-loop_id <value>][-topology <topology>][-security_switch 
   {y | n}] | -port_attribute <port attribute> | -t10pi {enable|disable}
    | -iscsi_virtual_port_mode {enable|disable}| -port_mode {scsi | nvme} -request_id auto |
-delete_login_host_nqn}

Syntax 2

raidcom modify port -port <port#> [-mtu <value>]
   [-vlan_tagging_mode {enable|disable}] [-add_vlan_id <value>]
   [-delete_vlan_id <value>] [-modify_vlan_id <new value>]
   [-ipv4_address <address>] [-ipv4_subnetmask <subnet mask>]
   [-ipv4_gateway_address <address>] [-ipv6_mode {enable|disable}]
   [-ipv6_local_address {auto|<address>}] 
   [-ipv6_global_address {auto|<address>}]
   [-ipv6_gateway_address <address>] [-tcp_port <value>]
   [-selective_ack_mode {enable|disable}] 
   [-delayed_ack_mode {enable|disable}]
   [-window_size <size>] [-keep_alive_timer <value>]
   [-ipv6_global_address2 <address>]

Syntax 3

raidcom modify port -port <port#> [-isns_mode {enable|disable}]
   [-isns_server_address <IPv4 address|IPv6 address>]
   [-isns_port <iSNS TCP Port number>]

Syntax 4

raidcom modify port -port <port> -add_iscsi_virtual_port <value>
   -ipv6_mode {enable|disable} [-mtu <value>] 
   [-vlan_tagging_mode {enable|disable}] [-add_vlan_id <value>] 
   [-ipv4_address <address>] [-ipv4_subnetmask <subnet mask>]
   [-ipv4_gateway_address <address>] 
   [-ipv6_local_address {auto|<address>}] 
   [-ipv6_global_address {auto|<address>}]
   [-ipv6_gateway_address <address>] [-tcp_port <value>]
   [-selective_ack_mode {enable|disable}] 
   [-delayed_ack_mode {enable|disable}]
   [-window_size <size>] [-keep_alive_timer <value>]

Syntax 5

raidcom modify port -port <port> -modify_iscsi_virtual_port <value>
   [-mtu <value>] [-vlan_tagging_mode {enable|disable}]
   [-add_vlan_id <value>] [-delete_vlan_id <value>]
   [-modify_vlan_id <new value>]
   [-ipv4_address <address>] [-ipv4_subnetmask <subnet mask>]
   [-ipv4_gateway_address <address>] [-ipv6_mode {enable|disable}]
   [-ipv6_local_address {auto|<address>}] [-ipv6_global_address {auto|<address>}]
   [-ipv6_gateway_address <address>] [-tcp_port <value>]
   [-selective_ack_mode {enable|disable}] [-delayed_ack_mode {enable|disable}]
   [-window_size <size>] [-keep_alive_timer <value>]
   [-ipv6_global_address2 <address>]

Syntax 6

raidcom modify port -port <port> -delete_iscsi_virtual_port <value>

Syntax 7

raidcom modify port -port <port> {-port_speed <value> | -endpoint_security {enforce|enable|disable} [-forcible] -request_id auto}

Options and parameters

-port <port#>

Specifies the port number. For example:

  • CL1-A
[-port_speed <value> ]

Specifies the port speed (0, 1, 2, 4, 8, 10, 16, 32) as follows.

  • 0: AUTO
  • 1: 1G
  • 2: 2G
  • 4: 4G
  • 8: 8G
  • 10: 10G
  • 16: 16G
  • 32: 32G

The specifiable values differ depending on the type of the channel board or channel adapter.

If the target port is either of the following, the value you specify using this option is ignored even if you specify a valid value.
  • For VSP 5000 series, the port type is ISCSI.

To check the type of your channel board or channel adapter, see the Port Condition window of Device Manager - Storage Navigator or the Controller Chassis window of the maintenance utility.

[-loop_id <value> ]

Specifies the Loop ID (0x01-0xEF) of the Port.

If the port type is ISCSI, the value you specify using this option is ignored even if you specify a valid value.

[-topology <topology> ]

Specifies the topology of the Port as follows:

  • fl_port: fabric on and fcal
  • f_port: fabric on and PtoP
  • nl_port: fabric off and fcal
  • n_port: fabric off and PtoP

When you change the topology setting of a port, delete the remote path and external path defined for that port beforehand. If an LU path is defined for the port, make sure in advance that the host is not performing I/O processing and the state is not the host reserve (mounted).

If the port type is ISCSI, the value you specify using this option is ignored even if you specify a valid value.

[-security _switch {y | n} ]
Specifies whether to enable LUN security as follows:
  • y or yes: LUN security is enabled.
  • n or no: LUN security is disabled.
-port_attribute <port attribute>

Specifies the Port attribute as follows:

  • TAR: Fibre target port (target port)
  • MCU: MCU initiator port (initiator port)
  • RCU: RCU target port (RCU target port)
  • ELUN: External initiator port (External port)
  • ALL: Resets (removes the TAR attribute from) a bidirectional port.

If the port is a bidirectional port of VSP 5000 series, the storage system detects the appropriate attribute of the port, and then operates the port with the detected attribute. If TAR is specified as the attribute value for the bidirectional port, the port attribute is changed to TAR (Target), and the storage system treats the port as a target port. By specifying ALL as the attribute value for the port specified in the TAR attribute, the user can restore the operation with the appropriate port attribute.

If the port is a bidirectional port of VSP G130, G/F350, G/F370, G/F700, G/F900, VSP G200, G400, G600, G800 and VSP F400, F600, F800, you cannot change the attribute value. The storage system detects the appropriate attribute of the port, and then operates the port with the detected attribute.

If this port attribute is changed from Target or RCU Target to Initiator or External, the host group belonging to this port belongs to meta_resource.

-t10pi {enable|disable}

Specifies the T10 PI mode as follows:

  • enable: T10 PI mode is enable
  • disable: T10 PI mode is disable

When you change the T10 PI mode, the T10 PI mode of the ports which share the settings with the port are also changed. The user who executes the command must have authority of the specified port and the ports which share the settings with the port. Details about the ports which share the settings with the specified port, see the Provisioning Guide for the storage system.

-iscsi_virtual_port_mode {enable|disable}

Specifies the iSCSI virtual port mode as follows:

  • enable: iSCSI virtual port mode is enabled
  • disable: iSCSI virtual port mode is disabled

The setting of the iSCSI virtual port mode is shared among all ports on the channel adapter (CHA) or channel board (CHB) to which ports specified for -port <port> belong.

When you change the iSCSI virtual port mode, the iSCSI virtual port mode of the ports that share the settings with the port is also changed. The user who executes the command must have authority of the specified port and the ports that share the settings with the port. For details about the ports that share the settings with the specified port, see the Provisioning Guide for the storage system.

If you specify this option when the device does not support the iSCSI virtual port, an error occurs.

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

-port_mode {scsi | nvme} -request_id auto
Changes the operation mode of the port.
  • scsi: SCSI mode
  • nvme: NVMe mode

<request#> is a request ID assigned each time the command is run. For more information, see Request ID function.

-delete_login_host_nqn

Deletes the host NQN login information.

However, the login information about the host NQN of a host logged in to an NVM subsystem port or a discovery controller (which is an NVMe controller for discovering an NVM subsystem and whose NQN is fixed as nqn.2014-08.org.nvmexpress.discovery) on the specified port is not deleted.

To check the login status, verify if the connection between the host and the NVM subsystem or the NVMe controller is established by using the command that the host provides.

For details about how to verify the connection between the host and the NVM subsystem or the NVMe controller, see the procedure for verifying the subsystem NQN for the NVMe controller to which the host recognizes the connection in the Provisioning Guide for Open Systems.

[-mtu <value>]

Specifies the MTU value (1500/4500/9000) used during iSCSI communication. When you omit the specification, the MTU value is not changed.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-vlan_tagging_mode {enable|disable}]

Specifies the availability of Tag VLAN. When you omit the specification, the settings for the availability of Tag VLAN is not changed.

  • enable: enable Tag VLAN
  • disable: disable Tag VLAN

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-add_vlan_id <value>]

Specifies the adding VLAN ID (1-4094). When you omit the specification, the VLAN ID is not added.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This value can be set even if Tag VLAN is disabled. The setting is used when Tag VLAN is enabled.

If you specify a virtual port, Tag VLAN is enabled.

[-delete_vlan_id <value>]

Specifies the deleting VLAN ID (1-4094). Also, Tag VLAN is disabled. When you omit the specification, the VLAN ID is not deleted.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

The VLAN ID can be deleted even if Tag VLAN is disabled. If the VLAN ID is deleted, to enable Tag VLAN, make sure to add VLAN ID when Tag VLAN is enabled.

[-modify_vlan_id <new value>]

Specifies the VLAN ID (1 to 4094). The VLAN ID is changed to the specified ID. When you omit this specification, the VLAN ID is not changed.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This value can be set even if Tag VLAN is disabled. The setting is used when Tag VLAN is enabled.

If you specify this option for a port or virtual port for which VLAN ID is not set, an error occurs.

[-ipv4_address <address>]

Specifies the IPv4 address. When you omit the specification, the IPv4 address is not changed.

This option is required if you specify both -add_iscsi_virtual_port and -ipv6_mode disable.

You cannot specify following IPv4 addresses:

  • Network address (For example 192.168.10.0 or 0.120.10.1)
  • Broadcast address (For example 255.255.255.255 or 10.1.255.255)
  • Loopback address (For example 127.0.0.1)

For details about how to specify an IP address, see Methods for specifying IP addresses.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-ipv4_subnetmask <subnet mask>]

Specifies the IPv4 subnet mask. When you omit the specification, the IPv4 subnet mask is not changed.

This option is required if you specify both -add_iscsi_virtual_port and -ipv6_mode disable.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-ipv4_gateway_address <address>]

Specifies the IPv4 default gateway address. When you omit the specification, the IPv4 default gateway address is not changed.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-ipv6_mode {enable|disable}]

Specifies the availability of IPv6 mode. When you omit the specification, the settings for the availability of IPv6 mode is not changed.

  • enable: enable IPv6 mode
  • disable: disable IPv6 mode
Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This option is required if you specify -add_iscsi_virtual_port. The operation modes for iSCSI virtual ports are as follows:

  • enable: IPv6 address is enabled.
  • disable: IPv4 address is enabled. In this case, specify both -ipv4_address <address> and -ipv4_subnetmask <subnet mask>.

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

[-ipv6_local_address {auto|<address>}]

Specifies the IPv6 link local address. When you omit the specification, the IPv6 link local address is not changed.

When you specify "auto", the address is set automatically. When you set the address manually, enter the IPv6 address for <address>.

You cannot specify following IPv6 addresses:

  • Not set (For example ::)
  • Multicast address (For example ff00:1024:1215::01)
  • Loopback address (For example ::1)
Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This setting can be configured even if IPv6 mode is disabled. The configured value is used when IPv6 mode is enabled.

[-ipv6_global_address {auto|<address>}]

Specifies the IPv6 global address. When you omit the specification, the IPv6 global address is not changed.

When you specify "auto", the address is set automatically. When you set the address manually, enter the IPv6 address for <address>.

You cannot specify following IPv6 addresses:

  • Multicast address (For example ff00:1024:1215::01)
  • Loopback address (For example ::1)
Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This setting can be configured even if IPv6 mode is disabled. The configured value is used when IPv6 mode is enabled.

[-ipv6_gateway_address <address>]

Specifies the IPv6 gateway address. When you omit the specification, the IPv6 gateway address is not changed.

You cannot specify following IPv6 addresses:

  • Multicast address (For example ff00:1024:1215::01)
  • Loopback address (For example ::1)
Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

This setting can be configured even if IPv6 mode is disabled. The configured value is used when IPv6 mode is enabled.

[-tcp_port <value>]

Specifies the TCP port number (1 - 65535) during iSCSI communication. When you omit the specification, the TCP port number is not changed.

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-selective_ack_mode {enable|disable}]

Specifies the availability of selective ACK. When you omit the specification, the settings of the selective ACK is not changed.

  • enable: enable selective ACK
  • disable: disable selective ACK
Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

[-delayed_ack_mode {enable|disable}]

Specifies the availability of delayed ACK. When you omit the specification, the settings of the delayed ACK is not changed.

  • enable: enable delayed ACK
  • disable: disable delayed ACK

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-window_size <size>]

Specifies the size of window. You can specify 64KB, 128KB, 256KB, 512KB, or 1024KB. The specifiable unit is m or M for mega byte, and k or K for kilo byte. When you omit the unit, Block (512 byte) is used. For example:

  • When you specify 1,024KB:

    -window_size 1M, -window_size 1m, -window_size 1024K, -window_size 1024k, or -window_size 2048

  • When you specify 256KB:

    -window_size 256K, -window_size 256k, -window_size 512

Note:

If this option is specified, the communications through the port are interrupted.

When you set the attribute value related to iSCSI, the communications through the specified port are interrupted, and an I/O error is reported to the SCSI command which is being executed. Therefore, if the attribute value related to iSCSI is set more than once continuously, troubles on I/O, for example the decreasing I/O throughput, and the failure in reading and writing, might occur. We recommend that you set the attribute value for iSCSI only when the I/O from the hosts does not exist.

[-keep_alive_timer <value>]

Specifies the value of the Keep Alive Timer (30 - 64800 seconds) during iSCSI communication.

When you omit the specification, the value of the Keep Alive Timer is not changed.

[-ipv6_global_address2 <address>]

Specifies the IPv6 global address2. You can specify this option for virtual ports for which the physical port ID or iSCSI virtual port ID is 0. If a value from 1 to 15 is specified as the iSCSI virtual port ID, an error occurs. When you omit this option, the IPv6 global address2 is not changed.

If you specify the IPv6 address automatically, specify auto for -ipv6_global_address. An EX_INVARG error occurs if you specify auto again when it is already specified.

If you want to specify IPv6 global address2 manually, you must also specify the IPv6 global address manually. When the IPv6 global address is already set manually, you do not need to change it. Type the IPv6 address for <address>.

The following IPv6 addresses cannot be set:

  • Multicast Address (Example: ff00:1024:1215::01)
  • Loopback Address (Example: ::1)

If you set this option when IPv6 mode is disabled, the setting is ignored.

If IPv6 has changed from enabled to disabled, the setting of this option is initialized.

[-isns_mode {enable|disable}]

Specifies the availability of iSNS service.

  • enable: enable iSNS service
  • disable: disable iSNS service

When you omit the specification, the settings of the iSNS service is not changed.

For this command, you can specify "e" as an alias of "enable" or "d" as an alias of "disable".

[-isns_server_address <IPv4 address|IPv6 address>]

Specifies the IP address of the iSNS server. You can specify both IPv4 and IPv6 address.

You cannot specify following IPv4 addresses:

  • Broadcast address (For example 255.255.255.255 or 10.1.255.255)
  • Loopback address (For example 127.0.0.1)

You cannot specify following IPv6 addresses:

  • Not set (For example ::)
  • Multicast address (For example ff00:1024:1215::01)
  • Loopback address (For example ::1)

When you omit the specification, the IP address of the iSNS server is not changed.

For details about how to specify an IP address, see Methods for specifying IP addresses.

[-isns_port <iSNS TCP Port number>]

Specifies the value of the TCP port in the iSNS server (1 - 65535).

When you omit the specification, the value of the TCP port in the iSNS server is not changed.

-add_iscsi_virtual_port <value>

Adds the virtual port to the port for which iSCSI virtual port mode is enabled. Specify the iSCSI virtual port ID (1 to 15) for <value>. Either IPv4 or IPv6 must be set. When you specify IPv4, select disable for -ipv6_mode, and specify both -ipv4_address <address> and -ipv4_subnetmask <subnet mask>. For IPv6, select enable for -ipv6_mode.

An error occurs if you specify this option in any of the following cases:

  • The specified iSCSI virtual port is already registered.
  • The iSCSI virtual port mode is disabled.
  • The device does not support the iSCSI virtual port mode.
-modify_iscsi_virtual_port <value>

Edits virtual port information of the port for which iSCSI virtual port mode is enabled.

Specify the iSCSI virtual port ID (0 to 15) for <value>.

When you change settings from IPv6 to IPv4 for iSCSI virtual ports whose IDs are from 1 to 15, select disable for -ipv6_mode, then set both -ipv4_address <address> and -ipv4_subnetmask <subnet mask>.

An error occurs if you specify this option in any of the following cases:

  • The virtual port of the specified iSCSI virtual port ID is not found.
  • The iSCSI virtual port mode is disabled.
  • The device does not support the iSCSI virtual port mode.
-delete_iscsi_virtual_port <value>

Deletes the virtual port from the port for which iSCSI virtual port mode is enabled.

Specify the iSCSI virtual port ID (1 to 15) for <value>.

An error occurs if you specify this option in any of the following cases:

  • The virtual port of the specified iSCSI virtual port ID is not found.
  • The iSCSI virtual port mode is disabled.
  • The device does not support the iSCSI virtual port mode.
-endpoint_security{enforce|enable|disable}[-forcible] -request_id auto
Specifies the endpoint security encryption setting for mainframe ports.
  • enforce: Enables endpoint security encryption. The connection cannot be established if endpoint security encryption is not supported on the host.
  • enable: Enables endpoint security encryption. The connection can be established even if endpoint security encryption is not supported on the host.
  • disable: Disables endpoint security encryption.

    Specify "-forcible" (which enables forced configuration mode) if you want to permit disconnection of the host when the endpoint security encryption setting is changed.

    <request#> (request ID) is assigned each time the command is run with the -request_id auto option. For more information, see Request ID function.

Returned values

One of the values shown below is returned to exit() so that you can check the execution results using a user program or a script.

  • 0 Normal termination
  • EX_ENOSUP The host does not support IPv6. For details, see the Command Control Interface Installation and Configuration Guide.
  • Other than 0 and EX_ENOSUP Abnormal termination. For details, see the Command Control Interface User and Reference Guide.

Examples

Changing the port attributes (the Loop ID and the topology of the port) of a port CL3-E.

# raidcom modify port -port CL3-E -loop_id 0xAB -topology fl_port

Changing the port attributes of the port CL3-E to the External initiator port (ELUN).

# raidcom modify port -port CL3-E -port_attribute ELUN

When you enable the IPv6 of the port CL3-E, and automate the settings of the Global address.

# raidcom modify port -port CL3-E -ipv6_mode enable 
-ipv6_global_address auto

When you enable the iSNS service of the port CL3-E, and set the IP address to the iSNS server:

# raidcom modify port -port CL3-E -isns_mode enable 
-isns_server_address fe80::209:6bff:febe:3c17

When you enable the T10 PI mode of the port CL3-E:

# raidcom modify port -port CL3-E -t10pi enable

When you enable the virtual port mode of the port CL3-E:

# raidcom modify port -port CL3-E -iscsi_virtual_port_mode enable

When you add virtual port 1 to the port CL3-E using IPv4 to set IP address:10.213.46.63, subnet mask: 255.255.254.0:

#raidcom modify port -port CL3-E -add_iscsi_virtual_port 1 -ipv6_mode disable -ipv4_address 10.213.46.63 -ipv4_subnetmask 255.255.254.0

When you change the operation mode of the port CL3-E to NVMe mode:

# raidcom modify port -port CL3-E -port_mode nvme -request_id auto

When you delete the login information about the host NQN that is logged in to the port CL3-E:

# raidcom modify port -port CL3-E -delete_login_host_nqn

When you change the endpoint security encryption setting for the port CL3-E to “enable” (the connection can be established even if endpoint security encryption is not supported on the host):

# raidcom modify port -port CL3-E -endpoint_security enable -request_id auto