23.2 Set Parameters

Set parameters are NetWare operating system parameters, which configure such aspects as file systems, communications, directory services, licensing, SLP, and memory. For a list of parameters and their categories, use a utility (the SET command or Novell Remote Manager) or the ScanSettableParameters function with the scanCategory parameter set to -1.

For a description of these parameters, see the SET utility in the Utilities Reference manual:

The default parameter value gives maximum performance for most systems and seldom needs to be modified. Most parameters can be dynamically modified. However, a couple of conditions prevent dynamic modification. The System Console can be locked. When the console is locked, some parameters cannot be modified.

Also, a few parameters can only be modified at startup and their SET command must be written in the appropriate .NCF file, either startup.ncf in the server boot directory (default location: c:\nwserver) or autoexc.ncf in the sys:\system directory. To write values to these files, use the functions in File and Directory I/O Services in Volume 1.

In NetWare 6.x, a parameter can be either persistent or non-persistent. A persistent parameter retains its modified value, but a non-persistent parameter returns to its default value when the server is shut down and restarted. To retain a value other than the default for a non-persistent parameter, a SET command must be written to the appropriate .NCF file.

You use the following functions to interact with the SET parameters.

Function

Description

GetSettableParameterValue

Returns the value of the specified parameter.

RegisterSettableParameter

Adds a settable parameter to the NetWare operating system.

DeRegisterSettableParameter

Removes an application-defined settable parameter from the NetWare operating system.

ScanSettableParameters

Returns information about the SET parameters, such as all parameters, a specific category of parameters, or one parameter.

Although ScanSettableParameters can be configured to return the value of a specific parameter, it returns a lot of additional information. If all you need is the current value, use the GetSettableParameterValue function.

SetSettableParameterValue

Modifies the value of the specified parameter.