Loading Protected Address Spaces

You can create a protected address space when you load one or more modules. Use the following commands at the server console prompt.

Command

Description

Example

[LOAD] PROTECTED module_name

Loads one module into a new protected address space and names the space ADDRESS_SPACEn.

[LOAD] PROTECTED DATABASE.NLM
Creates a new address space called ADDRESS_SPACEn, where n is a number, and loads database.nlm into it.

[LOAD] RESTART module_name

Loads one module into a new protected space with restart functionality and names the space ADDRESS_SPACEn.
Restart functionality means that if the protected space abends, the system closes the space, cleans up its resources, restarts the space, and reloads the module into it.
To prevent the server from restarting a memory space that continues to fault, use the Memory Protection No Restart Interval parameter. (MONITOR > Available Options > Server Parameters > Memory.) See Memory Parameters for more information.

RESTART DATABASE.NLM
Creates a new address space called ADDRESS_SPACEn, where n is a number, and loads database.nlm into it. If the address space abends, the system will shut down the space, restart the space automatically, and reload database.nlm into it.

[LOAD] ADDRESS SPACE = space_name module_name

Loads one module into a protected space with a user-defined name.
Use this command when you want to create your own name for the space.
You can also use this command when you want to load more than one module into the same protected space. Repeat the command for each module you want to load into the space.
You can also include the restart option on the same command line.

[LOAD] ADDRESS_SPACE = DB_SPACE DATABASE.NLM
Creates a new address space called DB_SPACE and loads database.nlm into it.
[LOAD] ADDRESS_SPACE = DB_SPACE RESTART TEST.NLM
Loads test.nlm into the DB_SPACE address space and also adds restart functionality to the address space.

PROTECT filename

Use this command when you normally use a .ncf file to load multiple modules at once.
The command creates a protected space with the same name as the .ncf file and executes the .ncf file to load all the modules into the space.

PROTECT LOAD_DB
Creates an address space called LOAD_DB and executes load_db.ncf to load modules into the protected space.

PROTECTION RESTART space_name

Adds restart functionality to an existing address space.
If the protected space abends, the system closes the space, cleans up its resources, restarts the space, and reloads modules into it.
To prevent the server from restarting a memory space that continues to fault, use the Memory Protection No Restart Interval parameter. (MONITOR > Available Options > Server Parameters > Memory.) See Memory Parameters for more information.

PROTECTION RESTART ADDRESS_SPACE3
Adds restart functionality to ADDRESS_SPACE3.

PROTECTION NO RESTART space_name

Removes restart functionality from an existing address space.

PROTECTION NO RESTART ADDRESS_SPACE3
Removes restart functionality from ADDRESS_SPACE3.

Command	Description	Example
[LOAD] PROTECTED module_name	Loads one module into a new protected address space and names the space ADDRESS_SPACEn.	[LOAD] PROTECTED DATABASE.NLM Creates a new address space called ADDRESS_SPACEn, where n is a number, and loads database.nlm into it.
[LOAD] RESTART module_name	Loads one module into a new protected space with restart functionality and names the space ADDRESS_SPACEn. Restart functionality means that if the protected space abends, the system closes the space, cleans up its resources, restarts the space, and reloads the module into it. To prevent the server from restarting a memory space that continues to fault, use the Memory Protection No Restart Interval parameter. (MONITOR > Available Options > Server Parameters > Memory.) See Memory Parameters for more information.	RESTART DATABASE.NLM Creates a new address space called ADDRESS_SPACEn, where n is a number, and loads database.nlm into it. If the address space abends, the system will shut down the space, restart the space automatically, and reload database.nlm into it.
[LOAD] ADDRESS SPACE = space_name module_name	Loads one module into a protected space with a user-defined name. Use this command when you want to create your own name for the space. You can also use this command when you want to load more than one module into the same protected space. Repeat the command for each module you want to load into the space. You can also include the restart option on the same command line.	[LOAD] ADDRESS_SPACE = DB_SPACE DATABASE.NLM Creates a new address space called DB_SPACE and loads database.nlm into it. [LOAD] ADDRESS_SPACE = DB_SPACE RESTART TEST.NLM Loads test.nlm into the DB_SPACE address space and also adds restart functionality to the address space.
PROTECT filename	Use this command when you normally use a .ncf file to load multiple modules at once. The command creates a protected space with the same name as the .ncf file and executes the .ncf file to load all the modules into the space.	PROTECT LOAD_DB Creates an address space called LOAD_DB and executes load_db.ncf to load modules into the protected space.
PROTECTION RESTART space_name	Adds restart functionality to an existing address space. If the protected space abends, the system closes the space, cleans up its resources, restarts the space, and reloads modules into it. To prevent the server from restarting a memory space that continues to fault, use the Memory Protection No Restart Interval parameter. (MONITOR > Available Options > Server Parameters > Memory.) See Memory Parameters for more information.	PROTECTION RESTART ADDRESS_SPACE3 Adds restart functionality to ADDRESS_SPACE3.
PROTECTION NO RESTART space_name	Removes restart functionality from an existing address space.	PROTECTION NO RESTART ADDRESS_SPACE3 Removes restart functionality from ADDRESS_SPACE3.