HMC Manual Reference Pages - DUMP (1)

NAME

dump - perform dump operation

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

dump -m managed-system -t sys -o set -a "attributes"
[--help]

DESCRIPTION

dump sets the system dump parameters for the managed-system. This operation is only supported for POWER6 and later servers.

OPTIONS

-m The name of the managed system for which to set the system dump parameters. 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. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.

-t The type of dump for which to set the dump parameters. Valid values are sys for system dump.

-o The dump operation to perform. Valid values are set to set the system dump parameters.

-a The configuration data needed to set the system dump parameters. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in double quotes.
The format of the configuration data is as follows:
attribute-name=value,attribute-name=value,...
Valid attribute names:
as_needed
Specifies when to collect system dumps.
Valid values:
0 - do not collect system dumps
1 - collect system dumps as necessary
Setting as_needed to 0 will remove the
ability of service personnel to diagnose
server errors. Do not set as_needed to 0
unless directed to do so by your hardware
service representative.
sys_hardware
Specifies how much hardware data to
collect when a system dump occurs.
Valid values:
auto - collect hardware data based on the
system dump event that occurred
max - collect as much hardware data as
possible
Setting sys_hardware to max will cause
system dumps to take longer to complete.
Do not set sys_hardware to max unless
directed to do so by your hardware
service representative.
sys_firmware
Specifies how much system firmware data
to collect when a system dump occurs.
Valid values:
auto - collect the primary data in
memory owned by system
firmware
max - collect the primary data in
memory owned by system
firmware plus all TCEs
io - collect the primary data in
memory owned by system
firmware plus all PCI TCEs
virtualio - collect the primary data in
memory owned by system
firmware plus all virtual I/O
TCEs
hps - collect the primary data in
memory owned by system
firmware plus all High
Performance Switch (HPS) TCEs
hcaio - collect the primary data in
memory owned by system
firmware plus all Host
Channel Adapter (HCA) TCEs
Setting sys_firware to max, io,
virtualio, hps, or hcaio will cause
system dumps to take longer to complete.
Do not set sys_firware to one of these
values unless directed to do so by your
hardware service representative.

--help Display the help text for this command and exit.

EXAMPLES

Set the system dump parameters for managed system sys1:
dump -m sys1 -t sys -o set -a "sys_hardware=auto,
sys_firmware=auto"

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - DUMP (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-m	The name of the managed system for which to set the system dump parameters. 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. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.
-t	The type of dump for which to set the dump parameters. Valid values are sys for system dump.
-o	The dump operation to perform. Valid values are set to set the system dump parameters.
-a	The configuration data needed to set the system dump parameters. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in double quotes. The format of the configuration data is as follows: attribute-name=value,attribute-name=value,... Valid attribute names: as_needed Specifies when to collect system dumps. Valid values: 0 - do not collect system dumps 1 - collect system dumps as necessary Setting as_needed to 0 will remove the ability of service personnel to diagnose server errors. Do not set as_needed to 0 unless directed to do so by your hardware service representative. sys_hardware Specifies how much hardware data to collect when a system dump occurs. Valid values: auto - collect hardware data based on the system dump event that occurred max - collect as much hardware data as possible Setting sys_hardware to max will cause system dumps to take longer to complete. Do not set sys_hardware to max unless directed to do so by your hardware service representative. sys_firmware Specifies how much system firmware data to collect when a system dump occurs. Valid values: auto - collect the primary data in memory owned by system firmware max - collect the primary data in memory owned by system firmware plus all TCEs io - collect the primary data in memory owned by system firmware plus all PCI TCEs virtualio - collect the primary data in memory owned by system firmware plus all virtual I/O TCEs hps - collect the primary data in memory owned by system firmware plus all High Performance Switch (HPS) TCEs hcaio - collect the primary data in memory owned by system firmware plus all Host Channel Adapter (HCA) TCEs Setting sys_firware to max, io, virtualio, hps, or hcaio will cause system dumps to take longer to complete. Do not set sys_firware to one of these values unless directed to do so by your hardware service representative.
--help	Display the help text for this command and exit.