# 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.