Novell Doc: NW 6.5 SP8: Utilities Reference

1.173 UNLOAD

Purpose

Use this command at the System Console prompt to

Unload a module that was previously loaded with the LOAD command
Unload outdated NLM™ programs so that updated modules can be loaded

You can also use UNLOAD at workstations running Novell® Client™ software for client modules that have been previously linked with LOAD.

Syntax

UNLOAD NLM_name

UNLOAD ADDRESS SPACE=address_space [NLM_name]

UNLOAD KILL ADDRESS SPACE=address_space

Parameter	Use to
NLM_name	Specify the module you want to unload.
ADDRESS SPACE= address_space	Specify the address space you want to unload. This command unloads all modules from the address space, removes the space, and returns its resources to the system.
ADDRESS SPACE= address_space NLM_name	Specify the module you want to remove from the designated address space. This command unloads the specified module from the address space, but does not remove the address space.
KILL ADDRESS SPACE= address_space	Remove the specified address space, but without unloading modules from it first. Use this command only if you know the address space can't be unloaded any other way.

IMPORTANT:Before you unload a module, be sure to read the next section, Unloading Modules.

Unloading Modules

The UNLOAD command unlinks a loadable module from the operating system that was previous linked to the operating system with the LOAD command. (See Section 1.82, LOAD.) When you unload a module, all resources are returned to the system.

To unload a module from an address space, you can specify its address space.

NOTE:If an address is specified without a module, all modules in that address space will be unloaded.

Keep the following information in mind when unloading LAN drivers, name space modules, or disk drivers.

LAN Drivers

When you unload a LAN driver, the driver is unbound from all communication protocols and removed from all network boards it was linked to.

After a LAN driver is unloaded, users with network boards that require the unloaded driver receive the following error message:
```
Network error on Server <fileserver>: Error receiving from network. Abort, Retry?
```
If this occurs, do the following:
- Retry once to see if an alternate route to the NetWare server is available on another network.
- If the retry fails, retry again after the LAN driver is reloaded and bound to the communication protocol.
A user who receives the error message must reestablish a connection within 15 minutes. If the connection is broken for more than 15 minutes, the server watchdog terminates the station's connection.

If the LAN driver will be unloaded for 15 minutes or longer, have users log out before unloading the LAN driver.
Name Space Modules

Before unloading name space modules, dismount all volumes that are using the module. These volumes cannot be remounted until the module is loaded again.

To permanently delete a name space from a Traditional volume before you unload the name space module, use VREPAIR.
Disk Drivers

Before unloading a disk driver, dismount all volumes stored on the hard disks connected to the controller or host bus adapter.

If you don't dismount the volumes, the system warns you that the driver is in use and lists the volumes using the driver.

If you override the warning and unload the driver without dismounting the volumes, the server dismounts the volumes and notifies those who are using the volumes.

Examples

To unload MONITOR, enter

UNLOAD MONITOR
To unload the CLIB module from the address space for GroupWise®, enter

UNLOAD ADDRESS SPACE=GRPWISE CLIB
To unload all modules from the GroupWise address space and shut down the address space, enter

UNLOAD ADDRESS SPACE=GRPWISE
To shut down an address space that cannot be unloaded any other way, enter

UNLOAD KILL ADDRESS SPACE=ADDRESS_SPACE1