IServerObjectAdmin.Properties Property

The properties for the GIS server.

[Visual Basic .NET]
Public Property Properties As IPropertySet

[C#]
public IPropertySet Properties {get; set;}

[C++]
HRESULT get_Properties(
  IPropertySet** props
);

[C++]
HRESULT put_Properties(
  IPropertySet* props
);

[C++]
Parameters
props [out, retval]
  props is a parameter of type IPropertySet
props [in]
  props is a parameter of type IPropertySet

Product Availability

Remarks

The Properties property on IServerObjectAdmin returns the logging properties for the GIS server. The properties are for the GIS server's logging, and for server object creation timeout.

The GIS server logs its activity, including server object configuration sartup, shutdown, server context creation and shutdown, as well as errors generated through any failed operation or request in the GIS server.

You can control the logging properties through the PropertySet returned by Properties. The following is a description of the logging properties:

LogPath: this is the path to the location on disk that log files are writeen. By default, the LogPath is <install location>\log

LogSize: this is the size to which a single log file can graw (in MB) before a new logfile is created. By default, the LogSize is 10

LogLevel: this is a number between 0 and 5 which indicates the level of detail that the server logs. By default, the LogLevel is 3. The following is a description of the each log level:

• 0 (None): No logging
• 1 (Error): Serious problems that require immediate attention
• 2 (Warning): Problems that require attention
• 3 (Normal): Common administrative messages of the server
• 4 (Detailed): Very common messages from user use of the server, including server objects
• 5 (Debug): verbose messages to aid in troubleshooting

All aspects of logging can be changed when the GIS server is running. When they are changed, the server will immediatly use the new logging settings.

Server object creation may hang for a variety of reasons. To prevent this from adversly affecting the GIS server, it has a ConfigurationStartTimeout property which defines the maximim time in seconds a server object instance has to initialize itself before its creation is cancelled.

See Also