dr_cmd_eligible_detach(1m) (Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual)

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

dr_cmd_eligible_detach(1m)

NAME

dr_cmd_eligible_detach- verify a system board is eligible for DR detach

SYNOPSIS

dr_cmd_eligible_detach

sb

CAUTION

Only authorized service providers should use this command, which runs in the DR shell. Service providers: Be sure to run this eligibility check prior to initiating any DR attach activity when using the low-level DR shell command set. Initiating an attach operation on an ineligible board may cause a system failure.

DESCRIPTION

Use dr_cmd_eligible_detach to verify that a system board is eligible for a detach operation before using dr_cmd_drain(1M) to begin a DR drain operation.

Note -

This command is available only for DR 2.0 domains (that is, domains that use the DR daemon) on the Sun Enterprise 10000 server. You can use domain_status(1M) to determine the DR version running on the domain.

OPERANDS

The following operand is supported.

sb: The board number (0 to 15) of the system board to be checked

EXIT STATUS

dr_cmd_eligible_detach returns one of the following result codes to the dr_return global Tcl variable.

y: The specified system board is eligible to be detached.
n: The specified system board is not eligible to be detached. dr_cmd_eligible_detach sends additional information to stdout.
board_number: The specified system board is not eligible to be detached because system board board_number (0 to 15), a different system board in the target domain, is in an intermediate DR Detach state. That DR Detach operation must be completed before you can initiate a DR operation on another board (such as the one specified).

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.