NAME

dr_cmd_drain - start memory drain on a system board.

SYNOPSIS

dr_cmd_drain sb

DESCRIPTION

Caution:

This command, which runs in the DR shell, is dangerous; do not use it. It is included here only for completeness. Instead, use the

drain(1M) command, which performs the same functions, but with the added security of safeguards and checks.

dr_cmd_drain determines the best way to vacate memory physically located on the designated system board. It may simply flush the memory, or copy it to memory available on another system board in the same domain. If a suitable target memory for the memory copy is not available when the dr_cmd_drain command is invoked, the request is denied. If the unavailability is due to run-time conditions and system load, you should retry the dr_cmd_drain operation at a later time.

The dr_cmd_drain operation also removes the system board from the target domain's board list in the domain_config(4) file on the SSP. (See domain_config(4) in the man Pages(4): Ultra Enterprise 10000 SSP File Formats.)

dr_cmd_drain begins execution, then quickly exits. Use drshow(1M) to monitor its progress.

OPTIONS

sb

The board number (0 to 15) of the system board to be drained.

EXIT STATUS

If dr_cmd_drain succeeds it returns a 0 result code in the dr_return global variable. If it fails, it returns a 1 and displays diagnostic messages.

Note:

Tcl parsing errors prevent DR commands from running which, in turn, leaves dr_return uninitialized. In such cases, the dr_return error code is meaningless. See dr (1M)for more information concerning return codes.

DIAGNOSTICS

See DIAGNOSTICS on drain(1M).

DR Administration Commands..dr_cmd_drain ( 1M ) SEE ALSO

dr_cmd_init(1M), dr_cmd_mem_info(1M)

Ultra Enterprise 10000 SSP 3.0 User's Guide