startdump - start dump

startdump {-m managed-system | -e managed-frame} -t {pss | sp | sys} [-s {a | b | p | s}] [--help]

startdump initiates a dump on the managed-system or the managed-frame. The lsdump command can be used to determine when the dump has completed and is available. The getdump command can then be used to offload the dump from the managed-system or the managed-frame to the Hardware Management Console (HMC).

-m

The name of the managed system on which to initiate the dump. The name may either be the userdefined 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. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same userdefined name. This option is required when initiating a service processor dump or a platform dump. This option is not valid otherwise.

-e

The name of the managed frame on which to initiate the dump. The name may either be the userdefined name for the managed frame, or be in the form tttt-mmm*ssssssss, where tttt is the type, mmm is the model, and ssssssss is the serial number of the managed frame. The tttt-mmm*ssssssss form must be used if there are multiple managed frames with the same user-defined name. This option is required when initiating a power subsystem dump. This option is not valid otherwise.

-t

The dump to initiate. Valid values are pss for a power subsystem dump, sp for a service processor dump, or sys for a platform dump. When a service processor dump is started on the primary service processor, all communications between the HMC and the managed-system will be halted. When the dump has completed, communications will be resumed. When a platform dump is started, the managed-system will be halted. When the dump has completed, the managed-system will be restarted.

-s

When initiating a power subsystem dump, use this option to specify the side of the managed frame's bulk power assembly (BPA) on which to initiate the dump. Valid values are a for side A and b for side B. When initiating a service processor dump, use this option to specify the service processor on which to initiate the dump. Valid values are p for the primary service processor and s for the secondary service processor. If this option is not specified, the service processor dump will be initiated on the primary service processor.

--help

Display the help text for this command and exit.

Initiate a platform dump (confirmation will be required) on the managed system 9406-570*12345678:

startdump -m 9406-570*12345678 -t sys

Initiate a service processor dump (confirmation will be required) on the primary service processor on the managed system sys1:

startdump -m sys1 -t sp -s p

Initiate a power subsystem dump on side A of the BPA for the managed frame myFrame:

startdump -e myFrame -t pss -s a

None

None

getdump, lsdump