Hot Swap monitor: hsmon

Name

hsmon

Purpose

Monitors the Hot Swap manager.

Usage

hsmon [ options ]

where options are:

Option

Description

s

Stops hsmon.

i PCIbus,slot

Inserts a board. Initiates management-driven insertion.

e PCIbus,slot

Extracts a board. Initiates management-driven extraction.

g PCIbus,slot

Gets the state of the specified slot.

q

Terminates hsmon.

?

Displays the hsmon Help screen and terminates.


Description

hsmon traces all messages from the Hot Swap manager. Use this utility for installation verification and diagnostics.

To run on a remote host, the utility must physically reside on the remote host. Use a separate third-party utility such as telnet, rsh, or rexec to invoke the utility.

Procedure

Step

Action

1

Make sure the Hot Swap manager and Hot Swap driver are running.

2

To launch the Hot Swap monitor, enter:

hsmon

Hot Swap manager messages display in this format:

direction destination pci_bus, pci_slot hsmessage

where:

Field

Description

direction

Indicates the direction of the message:

> indicates an output message

< indicates an input message

destination

Label given to an application (for example, hsmon) or the label for querying a board (for example, QSlotI).

pci_bus, pci_slot

CompactPCI bus and slot location.

hsmessage

Hot Swap manager message indicating the Hot Swap state or message.


3

Insert a board.

The following messages appear:

HSM_BOARD_PHYSICALLY_INSERTED
HSM_P0_S0 Board is inserted
HSM_BOARD_CONFIGURED
HSM_S0_S1 Board is configured
HSM_S1_S1I Device instance is created
HSM_PREPARE_BOARD
HSM_S1I_S1B Board preparation requested
HSM_S1B_S2 Board is ready
HSM_BOARD_READY

If the Hot Swap manager does not properly detect the board, the final two lines of Hot Swap messages shown in each of the previous examples are replaced by the following:

HSM_S1B_S1BF Failed to prepare board

4

Enter s to stop the Hot Swap monitor. The following messages display:

Stopping monitor...
monitor stopped.

5

Enter q to quit.


Board extraction messages

When you remove a CG board, hsmon displays the following messages:

Board type

Action and messages

CG 6000C,
CG 6100C, and CG 6500C boards

Flip board handles:

HSM_BOARD_EXTRACTION_CONFIGURED
HSM_EXTRACT_PENDING
HSM_S2_S2R Handle is opened
HSM_BOARD_EXTRACTION_UNCONFIGURED
HSM_DRIVER_NO_CHANNELS
HSM_S2R_S1U Board UNpreparation requested
HSM_UNPREPARE_BOARD
HSM_BOARD_STOPPED
HSM_S1U_S0 Extraction is authorized

Physically extract board:

HSM_BOARD_PHYSICALLY_EXTRACTED
HSM_S0_P0 Board is extracted

CG 6565C

Flip board handles:

HSM_BOARD_EXTRACTION_CONFIGURED
HSM_EXTRACT_PENDING
HSM_S2_S2R Handle is opened
HSM_BOARD_EXTRACTION_UNCONFIGURED
HSM_DRIVER_NO_CHANNELS
HSM_S2R_S1U Board UNpreparation requested
HSM_UNPREPARE_BOARD
HSM_BOARD_STOPPED
HSM_S1U_P0 'Surprise extraction'
HSM_BOARD_PHYSICALLY_EXTRACTED

For CG 6565C boards, all Hot Swap messages are displayed when the board handles are flipped. The utility does not display separate messages when the board is physically extracted.