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

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

dr_cmd_eligible_attach(1m)

NAME

dr_cmd_eligible_attach- verify a system board is eligible for DR attach

SYNOPSIS

dr_cmd_eligible_attach

sb

CAUTION

Only authorized service providers should use this command, which runs in the DR shell. 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_attach to verify that a system board is eligible for an attach operation before using dr_cmd_init_attach(1M) to begin the Init Attach.

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_attach returns one of the following result codes to the dr_return global Tcl variable.

y: The specified system board is eligible to be attached.
n: The specified system board is not eligible to be attached. dr_cmd_eligible_attach sends additional information to stdout.
board_number: The specified system board is not eligible to be attached because system board board_number (0 to 15), a different system board in the target domain, is in an intermediate DR Attach state. That DR Attach 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.