HMC Manual Reference Pages  - DUMP (1)

NAME
dump - perform dump operation

CONTENTS

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.

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*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss 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

Setting sys_firware to max, io, or virtualio
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

SEE ALSO
lsdump

Linux DUMP (1) June 2007
Generated by manServer 1.07 from dump.1 using man macros.