Product Home Page | Developer Site | Version | |
The noninteractive functionality described in this section is used to enable and disable ASP in virtual hosts. The scriptable interface (configure-server
) is described in the following table.
Note | To enable or disable ASP processing for a virtual host using the Sun ONE ASP Administration Console, see Enabling ASP for a Virtual Host. Expert users of Sun ONE ASP can also make manual changes to casp.cnfg, as described in Editing the Sun ONE ASP Configuration File. |
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 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.
|
In this section:
Examples: Removing Virtual Hosts
Copyright © 2003 Sun Microsystems, Inc. All rights reserved.