Changing casp.cnfg Settings

The noninteractive functionality described in this section is used to list, modify, create, and delete settings in casp.cnfg, the Sun ONE Active Server Pages configuration file. This functionality is useful primarily for Internet Service Providers and other users who need to make changes to several ASP engines quickly and simultaneously.

For most users, modifications to casp.cnfg should be made using the Sun ONE ASP Administration Console. For more information about using the Administration Console to manage the ASP Server, see Managing the ASP Server. Expert users of Sun ONE ASP can also make manual changes to casp.cnfg, as described in Editing the Sun ONE ASP Configuration File.

The scriptable interface (configure-server) is described in the following table.


Function	Explanation
function=configure-engine	Allows you to change casp.cnfg settings.
Parameters
engine [0-9]= <path\|name*> (user specified)	If a path is specified, the full path information will be used to identify the ASP engine being modified. If a name is specified (such as asp-server-3000), the path is assumed to reside within the current installation.
section (user specified)	This is the section within casp.cnfg (such as section=default machine) that contains the key you want to add, delete, modify, or view.
key (user specified)	This is the key in the specified section that you want to add, delete, modify, or view.
value (user specified)	This is the value for the key.
mode=<add\|del\|view> (default=add)	Determines which action(s) to take with the provided parameters: - The "add" mode adds the specified key/value under the specified section. If that key is already associated with a value, it will be overwritten. - The "del" mode removes any entry with the specified key under the specified section. - The "view" mode prints the current contents of the specified key to stdout, in the following format: <casp.cnfg>: <section>: <key>: <value> Caution: Using mode=del could prevent the ASP engine from starting. It is strongly recommended that mode=del be used sparingly, if at all. Appropriate uses are listed in Deleting casp.cnfg Settings.
override=<yes\|no>	This parameter specifies whether error checking should be provided when modifying a section/key value. This checking disallows creating new keys or modifying or viewing keys that are not user configurable. Caution: It is strongly recommended that you do not use override=yes. Doing so could render your server inoperable.