tcpcmdmode command

This command displays and changes the timeout of the TCP command-mode sessions that are used by IBM Systems Director software for out-of-band communication with the management module. This command is also used to enable or disable the TCP command-mode sessions.

Table 1. tcpcmdmode command
Function What it does Command Valid targets
Display TCP command-mode session status and timeout Displays the secure and non-secure TCP command-mode session status (maximum number of sessions) and timeout. tcpcmdmode
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set TCP command-mode session timeout Sets the secure and non-secure TCP command-mode session timeout value. tcpcmdmode -t timeout

where timeout is from 0 seconds (no timeout) to 4294967295 seconds, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Disable TCP command-mode sessions Disables TCP command-mode sessions that are used by IBM Systems Director software for out-of-band communication with the management module. This applies to both read and write operations. tcpcmdmode -status 0
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Enable and set number of TCP command-mode sessions Enables TCP command-mode and sets the maximum number of sessions that can be used by IBM Systems Director software for out-of-band communication with the management module. For read operations, all of the values from 1 to 20, inclusive, mean enabled.
Note: The advanced management module supports a combined total of up to 20 secure and non-secure TCP command-mode sessions.
tcpcmdmode -status number_sessions

where number_sessions is from 1 to 20, inclusive. (A value of 0 disables TCP command-mode sessions.) If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Disable secure TCP command-mode sessions Disables secure TCP command-mode sessions that are used by IBM Systems Director software for out-of-band communication with the management module. This applies to both read and write operations. tcpcmdmode -sstatus 0
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Enable and set number of secure TCP command-mode sessions Enables secure TCP command-mode and sets the maximum number of sessions that can be used by IBM Systems Director software for out-of-band communication with the management module. For read operations, all of the values from 1 to 20, inclusive, mean enabled.
Note: The advanced management module supports a combined total of up to 20 secure and non-secure TCP command-mode sessions.
tcpcmdmode -sstatus number_sessions

where number_sessions is from 1 to 20, inclusive. (A value of 0 disables secure TCP command-mode sessions.) If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Example: To enable a maximum of three TCP command-mode sessions for the primary management module, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  tcpcmdmode -status 3
               
To enable a maximum of five secure TCP command-mode sessions for the primary management module, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  tcpcmdmode -sstatus 5
               
To set the TCP command-mode session timeout for the primary management module to 6 minutes, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  tcpcmdmode -t 360
               
To display the TCP command-mode session status and timeout for the primary management module, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  tcpcmdmode
               

The following example shows the information that is returned from these commands:

               system:mm[1]> tcpcmdmode -status 3
OK
system:mm[1]> tcpcmdmode -sstatus 5
OK
system:mm[1]> tcpcmdmode -t 360
OK
system:mm[1]> tcpcmdmode
-status 3 connections
-sstatus 5 connections
-t 360 seconds
system:mm[1]>