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 shut down 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, use the shutdown facilities provided by the operating system in the partition.

Flags

Flag name	Description
-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`: Changes the keylock position `consoleservice`: Disables a remote service session for the IBM® i partition (operator panel function 65) followed by the activation of the dedicated service tools for the IBM i partition (operator panel function 21). `dston`: Activates dedicated service tools for the IBM i partition (operator panel function 21). `dumprestart`: Restarts after initiating a dump `iopdump`: Allows use of the IOP control storage dump (operator panel function 70). This operation is valid for IBM i partitions only. `iopreset`: Resets or reloads the failed IOP (operator panel function 67). This operation is valid for IBM i partitions only. `on`: Power on `osshutdown`: Shuts 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). `remotedston`: Enables a remote service session for the IBM i partition (operator panel function 66). `retrydump`: Retries the dump on the IBM i partition and restarts the partition when the dump is complete (operator panel function 34). `shutdown`: Shuts down `remotedstoff`: Disables a remote service session for the IBM i partition (operator panel function 65).
-i IPL Source	The IPL source that will be used when activating the IBM i partition. You can also use the IVM chsyscfg command command to complete this task. If this flag is not specified, then the current IPL source will be used. Valid values are: a b c d
-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 0 on success.

Security

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

Examples

To power on the partition with an ID of 2 and set the boot mode to System Management Services, type the following command:
```
chsysstate -r lpar -o on --id 2 -b sms
```
To shut down the partition with an ID of 3, type the following command:
```
chsysstate -r lpar -o shutdown --id 3
```
To immediately restart the partition with an ID of 3 using the client operating system's shutdown command, type the following command:
```
chsysstate -r lpar -o osshutdown --restart --immed --id 3
```
To select the IPL source before activating an IBM i logical partition, type the following command:
```
chsysstate -r lpar -o [-i <IPL Source>]
```

Related Information

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

Last updated: Wed, November 18, 2020