# Initiating board insertion and extraction in software

You can initiate insertion or extraction by using the:

- hsmon utility

- Hot Swap EMC managed object keyword Board.boardname.Command.

These actions correspond to the user actions of opening and closing the board ejector handles.

Use hsmgr utility to monitor the Hot Swap manager messages generated when a board is inserted or extracted.

## Using the hsmon utility

To start hsmon in console mode, enter the following command:

hsmon

Once hsmon is started, initiate extraction by entering:

e PCIbus,slot

where PCIbus and slot are the PCI bus and slot location of the board.

To initiate insertion, enter the following command:

i PCIbus,slot

## Using the Board.boardname.Command keyword

To initiate extraction, set the keyword as follows:

Board.boardname.Command=Extract

where boardname is the name of the board to extract.

To initiate insertion, set the keyword as follows:

Board.boardname.Command=Insert

Board.boardname.Command is a write-only keyword. You cannot query it to learn if a board is inserted or extracted. To determine the Hot Swap state of a board, use Board.boardname.State.

For details on Hot Swap EMC managed object keywords, refer to Hot Swap EMC keyword summary.

## Debugging with the Hot Swap manager

For debugging purposes, use the hsmgr utility to run the Hot Swap manager in console mode. In this mode, Hot Swap manager messages display as boards are inserted and extracted. To learn more about the hsmgr utility and other NMS OAM utilities, refer to the NMS OAM System User's Manual.