Manages a dynamically reconfigurable slot, such as, a hot plug slot.
To Identify a Hot Plug Slot
drslot -i { -s Slot | -l DeviceName } -c ConnectorType
To Prepare a Hot Plug Slot for Configuring Devices
drslot -a -s slot -c ConnectorType [ -I ]
To Prepare a Hot Plug Slot for Removal of a Device
drslot -r { -s slot | -l DeviceName} -c ConnectorType [ -I ]
To Prepare a Hot Plug Slot for Removal and Replacement of a Device
drslot -R { -s slot | -l DeviceName } -c ConnectorType [ -I ]
The drslot command manages dynamically reconfigurable slots, that is, hot plug slots. Hot plug slots are the plug-in points for connecting entities which can be configured without turning the system power off or rebooting the operating system. For the add (-a) operation, the slot must be specified directly by using the -s flag, giving the unique identifier for the slot. For the identify (-i), the remove (-r), and the replace (-R) operations, the slot may be specified directly with the -s flag, or indirectly. The slot may be specified indirectly by using the -l flag giving the logical name for a device connected to the slot. The drslot command determines to which slot the specified device is connected and manages that slot.
Notes:
- The remove and replace operations fail unless the device connected to the identified slot has been unconfigured. For more information on how to successfully unconfigure a device, see Managing Hot Plug Connectors in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.
- After an add or replace operation, you must run the cfgmgr command in order to make the new device active and ready for use by the operating system.
Note: Do not use the -a, -i, -r, -R flags together.
| -a | Prepares a hot plug slot for configuring the device(s) connected to it. The slot is first identified to you and you are prompted for confirmation of the slot. Next, you are prompted for confirmation that the device has been connected to the slot. Upon confirmation that the device has been connected, the slot is prepared and the device is made ready for configuration. |
| -c ConnectorType | Specifies the ConnectorType of the Slot on which you are operating. For example, the ConnectorType for a hot plug PCI slot is pci. This flag is must be specified with the -a, -i, -r, and -R flags. |
| -i | Identifies a hot plug slot. The identification of the slot is hardware dependent. For example, if a slot has an LED associated with it, issuing the drslot -i command may cause the LED to flash. |
| -I | Specifies that the identification step should be skipped when using the -a (add), -r (remove), and -R (replace) flags. This flag should only be used when you are sure you have already identified the proper slot. |
| -l DeviceName | Specifies the DeviceName, which is the logical device name of the device connected to the slot to be managed. This flag must be used for the -i (identify), -r (remove) or -R (replace) flags if the -s flag is not used. |
| -r | Prepares a hot plug slot for removal of a device that has been previously unconfigured with the rmdev command, or the SMIT, or Web-based System Manager equivalent. The slot is identified and you are prompted for confirmation of the slot. If a visual indicator is associated with the slot, it is turned off. Finally, the slot is prepared for device removal and you are prompted for confirmation that the device has been removed from the slot. |
| -R | Prepares a hot plug slot for the removal of a device that has been previously unconfigured and the replacement with an identical device. The device must be unconfigured with the rmdev command, or the SMIT or Web-based System Manager equivalent. drslot identifies the slot and you are prompted for confirmation of the slot. Next, the slot is prepared for the replacement of the device. You are then prompted to confirm that the device has been replaced. Upon confirmation that the device has been replaced in the hot plug slot, the slot is prepared and the device is made ready for configuration. |
| -s Slot | Specifies the Slot on which drslot should operate. This flag is required for the add (-a) operation. This flag must be used for the identify (-i), remove (-r) or replace (-R) operations if the the -l flag is not used. The format of Slot is Platform/ConnectorType dependent. |
In this example, there is an LED associated with this slot. The system may display a message similar to the following:
The visual indicator of the specified PCI slot has been set to the identify state. Press Enter to continue or enter x to exit.
The LED for the slot specified by U0.1-P1-I3 flashes until the you press the Enter key.
No confirmation prompt is given for identifying the slot. There will be a confirmation prompt displayed when it is time to put the new adapter into the slot, and a message similar to the following displays:
The visual indicator for the specified PCI slot has been set to the action state. Insert the PCI card into the identified slot, connect any devices to be configured, and press Enter to continue. Enter x to exit.
After connecting the adapter, press Enter, and the slot is prepared.
The system displays messages similar to the following:
The visual indicator of the specified PCI slot has been set to the identify state. Press Enter to continue or enter x to exit.
The LED for the PCI slot blinks to identify the slot. Pressing any key but the Enter key exits the command. Pressing Enter continues with this slot. If continuing, the LED for the PCI slot is changed to the action state and the system displays a message similar to the following:
The visual indicator for the specified PCI slot has been set to the action state. Replace the PCI card in the identified slot, reconnect any devices to be configured, and press Enter to continue. Enter x to exit. Exiting now leaves the PCI slot in the removed state.
/usr/sbin/drslot
The lsslot command, rmdev command, the cfgmgr command.
For information about Hot Plug Management and PCI Hot Plug Support for PCI Adapters, see PCI Hot Plug Management in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.
For information about using PCI Hot Plug Support for PCI Adapters, see Managing Hot Plug Connectors in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.