Unloading Protected Address Spaces

To unload a module from a protected space or to unload the space itself, use the commands in the following table at the System Console prompt or in NetWare Remote Manager on the Address Space Information page (access by clicking Protected Memory link in the navigation frame).

To Enter this command at the System Console prompt Do this on the Address Space Information Page of NetWare Remote Manager Example

To	Enter this command at the System Console prompt	Do this on the Address Space Information Page of NetWare Remote Manager	Example
Unload a 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 = space_name module_name`	Click the link for the address space name. Click the link for name of the NLM on the NetWare Loadable Modules Information page. Click the Unload button on the Information page for that module.	`UNLOAD ADDRESS SPACE = ADDRESS_SPACE1 DATABASE.NLM` Unloads DATABASE.NLM from ADDRESS_SPACE1, but does not remove the address space unless it is the last module loaded.
Unload all modules from the designated address space and removes the space	`UNLOAD ADDRESS SPACE = space_name`	Click the Unload button in the Unload column of the Address Space Information table for the address you want to unload the modules from.	`UNLOAD ADDRESS SPACE = ADDRESS_SPACE1` Unloads all the modules from ADDRESS_SPACE1, closes ADDRESS_SPACE1, and returns its resources to the system.
Remove an address space 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 = space_name`	Click the Remove button in the Remove column of the Address Space Information table for the address space you want to remove.	`UNLOAD KILL ADDRESS SPACE=ADDRESS_SPACE1` Removes ADDRESS_SPACE1 without unloading modules and returns its resources to the system.

Unload a 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 = space_name module_name

Click the link for the address space name.

Click the link for name of the NLM on the NetWare Loadable Modules Information page.

Click the Unload button on the Information page for that module.

UNLOAD ADDRESS SPACE = ADDRESS_SPACE1 DATABASE.NLM

Unloads DATABASE.NLM from ADDRESS_SPACE1, but does not remove the address space unless it is the last module loaded.

Unload all modules from the designated address space and removes the space

UNLOAD ADDRESS SPACE = space_name

Click the Unload button in the Unload column of the Address Space Information table for the address you want to unload the modules from.

UNLOAD ADDRESS SPACE = ADDRESS_SPACE1

Unloads all the modules from ADDRESS_SPACE1, closes ADDRESS_SPACE1, and returns its resources to the system.

Remove an address space 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 = space_name

Click the Remove button in the Remove column of the Address Space Information table for the address space you want to remove.

UNLOAD KILL ADDRESS SPACE=ADDRESS_SPACE1

Removes ADDRESS_SPACE1 without unloading modules and returns its resources 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 (Error Handling category) parameter. The default is 30 seconds.

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 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.