User Guide

66 Server Management ActionScript Language Reference
scope String; specifies the value to set for the tag specified by the key parameter. If the
value specified is a simple string, it is set as the tag data for the specified tag. If the value is
valid XML, for example, <foo>bar</foo>, the XML is added as a child tag to the specified tag.
If the value is an empty string, the specified tag is removed.
■ "/" specifies Server.xml. You must have server administrator privileges to access most parts
of this file. The only section that does not require server administrator privileges is the
<VirtualHost> section that contains administrators for the vhost that the caller belongs to.
■ "Users" specifies Users.xml for server administrators.
■ "Logger" specifies Logger.xml.
■ "Adaptor:<adaptor_name>" specifies Adaptor.xml. The <adaptor_name> is the name of
the adaptor of interest. You must have server administrator privileges to access this file. If
<adaptor_name> is not the name of the adaptor the caller is connected to, the call fails.
■ "Adaptor:<adaptor_name>/VHost:<vhost_name>" specifies VHost.xml. <vhost_name>
is the name of the vhost of interest. If <adaptor_name> is not the name of the adaptor the
caller is connected to, or <vhost_name> is not the name of the vhost that the caller is
connected to, the call fails.
■ "Adaptor:<adaptor_name>/VHost:<vhost_name>/Users" specifies Users.xml for vhost
administrators.
■ "Adaptor:<adaptor_name>/VHost:<vhost_name>/App[:<app_name>] specifies
Application.xml. If no <app_name> is specified, then the default Application.xml is
assumed. Otherwise, the application specific application.xml for the specified application
is used. If the specified application is not defined, or the application does not have an
application specific application.xml, the call fails.
Returns
If the call succeeds, the server sends a reply information object with a level property of
status and a code property of NetConnection.Call.Success. The value of the
configuration key is changed.
If the call fails, the server sends a reply information object with a
level property of error, a
code property of NetConnection.Call.BadValue, and a description property that
contains a string describing the cause of the failure.
This call fails if the specified configuration key cannot be found or if you do not have
permissions to change its value.
TIP
To determine the adaptor or virtual host to which you’re connected, use the
getAdminContext() method.