IVM chsysstate Command

Purpose

Changes the state of a partition. This command is operable only in the Integrated Virtualization Manager environment.

Syntax

To activate a partition:

chsysstate -r lpar -o on { -n Name | --id PartitionID } [ -k KeylockPosition ] [ -b BootMode ] [ -m ManagedSystem ]

To perform a partition shutdown using the shutdown command on the client operating system:

chsysstate -r lpar -o osshutdown { -n Name | --id PartitionID } [ -m ManagedSystem ]

To perform a delayed partition shut down (white button shut down):

chsysstate -r lpar -o shutdown { -n Name | --id PartitionID } [ -m ManagedSystem ]

To perform an immediate partition shutdown (operator panel function 8):

chsysstate -r lpar -o shutdown --immed { -n Name | --id PartitionID } [ -m ManagedSystem ]

To perform an immediate restart of a partition (operator panel function 3):

chsysstate -r lpar -o shutdown --immed --restart { -n Name | --id PartitionID } [ -m ManagedSystem ]

To perform a restart of a partition after initiating a dump (operator panel function 22):

chsysstate -r lpar -o dumprestart { -n Name | --id PartitionID } [ -m ManagedSystem ]

To change the keylock position for a partition:

chsysstate -r lpar -o chkey -k KeylockPosition { -n Name | --id PartitionID } [ -m ManagedSystem ]

Description

The chsysstate command changes the state of a partition. To avoid data loss, it is recommended to use the shutdown facilities provided by the operating system in the partition.

Flags

-r ResourceType The type of resources to change: lpar Logical partition resources
-m ManagedSystem The name of the managed system. This attribute is optional because there is only one system to manage. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
-o Operation The type of operation to perform:
  • chkey: Change the keylock position
  • on: Power on
  • dumprestart: restart after initiating a dump
  • osshutdown: shut down using the client partition's shutdown command. This is the safest shutdown option, so should be used if available (RMC state must be active).
  • shutdown: shut down
-b BootMode Override the current power on mode setting. Valid values are:
  • norm: normal
  • dd: diagnostic with default boot list
  • ds: diagnostic with stored boot list
  • of: Open Firmware OK prompt
  • sms: System Management Services
-k KeylockPosition Keylock position. Valid values are:
  • norm: normal keylock
  • manual: manual keylock
--immed Force the state change immediately.
--restart Restart the partition. This flag is valid only if the --immed flag is also specified.

Exit Status

This command has a return code of zero on success.

Security

This command is not accessible by users with the ViewOnly role.

Examples

  1. To power on the partition with an ID of 2 and set the boot mode to System Management Services, type: 
    chsysstate -r lpar -o on --id 2 -b sms
  2. To shut down the partition with an ID of 3, type: 
    chsysstate -r lpar -o shutdown --id 3
  3. To immediately restart the partition with an ID of 3 using the client operating system's shutdown command, type: 
    chsysstate -r lpar -o osshutdown --restart --immed --id 3

Related Information

The lssyscfg command, the mksyscfg command, the rmsyscfg command, and the mkvt command.

Send feedback |  Rate this page