5.2 Unloading a Specific Instance of a HAM

Through the use of the Type 0 HACB HAM_Instance_Unload (Function 0x09), specific instances of a HAM can be unloaded by the operator via a console command. The procedure is as follows.

  1. At the server console screen, the operator enters the following command: list storage adapters .

    With NWPA drivers loaded, the screen display shows a list of devices and the adapters associated with them as follows:

        [Vaaa-Ax] Adapter Name String[Vaaa-Ax–Dc:d] Device Name String

    where:

    Variable

    Meaning

    aaa

    the novellAssignedModuleID

    x

    Adapter instance number

    c

    SCSI ID, SATA port, or IDE channel

    d

    SCSI unit number, SATA port multiplier, or IDE master/slave

    Adapter name string

    ASCII string identifying the adapter

    Device name string

    ASCII string identifying the device
  2. To unload a specific HAM instance, the operator enters the following command:

    remove storage adapter ax

    where x is the same adapter instance number displayed previously for the instance to be unloaded. For example, if the following display resulted from the list storage adapters command:

    [VFFF-A1] Adapter 1

    [VFFF-A1-D1:0] SCSI CD ROM

    [VFFF-A1-D2:0] SCSI CD ROM

    [VFFF-A0] Adapter 0

    [VFFF-A0-D1:0] SCSI HARD DISK

    [VFFF-A0-D2:0] SCSI HARD DISK

    and it was desired to remove the HAM instance associated with the two CD drives without affecting the hard disks that are using a different instance of the same HAM (novellAssignedModuleID of FFF for this example), the operator would enter the following command:

    remove storage adapter a1

    NWPA then checks to verify that adapter number input is a valid option, and that the devices on Adapter 1 are not reserved or in use at that time. If they are, NWPA notifies the operator what devices are in use or reserved, and asks for permission to continue. If this is granted, NWPA then issues the HAM_Instance_Unload (Function 0x09) request to the appropriate HAM.

    See HACB Type Zero Functions for the HAM's required implementation of this function.

    If only one instance of the HAM is loaded, NWPA requests that OS to unload the module and does send the Instance Unload HACB.