Unloading Protected Address Spaces

To unload a module from a protected space or to unload the space itself, use the following commands at the server console prompt.

Command

Description

Example

UNLOAD ADDRESS SPACE = space_name module_name

Unloads the specified module from the specified address space.
If the module is loaded into more than one address space, this command removes the module only from the designated address space.

UNLOAD ADDRESS SPACE = ADDRESS_SPACE1 DATABASE.NLM
Unloads database.nlm from ADDRESS_SPACE1, but does not remove the address space.

UNLOAD ADDRESS SPACE = space_name

Unloads all modules from the designated address space and removes the space.

UNLOAD ADDRESS SPACE = ADDRESS_SPACE1
Unloads all the modules from ADDRESS_SPACE1, closes ADDRESS_SPACE1, and returns its resources to the system.

UNLOAD KILL ADDRESS SPACE = space_name

Removes the address space but without unloading the modules first.
Use this command only if you know the space can't be unloaded with the UNLOAD ADDRESS SPACE command.

UNLOAD KILL ADDRESS SPACE=ADDRESS_SPACE1
Removes ADDRESS_SPACE1 without unloading modules . Returns the resources of ADDRESS_SPACE1 to the system.

If a module hangs while it is being unloaded with the UNLOAD ADDRESS SPACE command, the system waits a specified time and then displays the following error message:
<Module name> in <address space> did not unload yet. Killing the address space is the only way to remove the NLM. Should the address space be killed? Yes/No.

If you answer Yes, the system shuts down the address space without unloading modules from it. If you answer No, the system waits a specified time and displays the message again.

You can designate the amount of time before the message appears by setting the HUNG UNLOAD WAIT DELAY parameter. The default is 30 seconds. You can access the parameter in the MONITOR utility (MONITOR > Available Options > Server Parameters > Error Handling).
In some circumstances, the server might not completely clean up an address space that has faulted. This failure is caused by NLM programs that are not written to allow external cancellation.
When NetWare cannot clean up an address space after it faults, it sends an alert message to the server console. If you execute the PROTECTION console command, the address space will be listed as in the clean up failure state.

Because you cannot unload an address space that is in the clean up failure state, you must shut down and restart the server to recover the remaining resources from the address space.

Command	Description	Example
UNLOAD ADDRESS SPACE = space_name module_name	Unloads the specified module from the specified address space. If the module is loaded into more than one address space, this command removes the module only from the designated address space.	UNLOAD ADDRESS SPACE = ADDRESS_SPACE1 DATABASE.NLM Unloads database.nlm from ADDRESS_SPACE1, but does not remove the address space.
UNLOAD ADDRESS SPACE = space_name	Unloads all modules from the designated address space and removes the space.	UNLOAD ADDRESS SPACE = ADDRESS_SPACE1 Unloads all the modules from ADDRESS_SPACE1, closes ADDRESS_SPACE1, and returns its resources to the system.
UNLOAD KILL ADDRESS SPACE = space_name	Removes the address space but without unloading the modules first. Use this command only if you know the space can't be unloaded with the UNLOAD ADDRESS SPACE command.	UNLOAD KILL ADDRESS SPACE=ADDRESS_SPACE1 Removes ADDRESS_SPACE1 without unloading modules . Returns the resources of ADDRESS_SPACE1 to the system.