This document is archived and information here might be outdated. Recommended version. |
Provides access to members that control the behavior and properties of a server directory to administrators. Note: the IServerDirectory interface has been superseded by IServerDirectory2. Please consider using the more recent version.
Name | Description | |
---|---|---|
CleaningMode | The mode by which the files in the server directory are cleaned (by age, by size or none). | |
Description | The description of the server directory. | |
MaxFileAge | The maximum age (in seconds) a file can be in the server directory before it is deleted, if the cleaning mode is by file age. | |
Path | The path of the server directory. | |
URL | The URL of the virtual directory that maps to the physical directory as described by the Path property. |
Classes | Description |
---|---|
ServerDirectory | The ServerDirectory object which provides information about the ServerDirectory. |
A server directory is a location on a file system that the GIS server is configured to clean up files it writes. By definitition, a server directory can be written to by all container machines. Files in a server directory can be cleaned based on file age, or based on when the file was last accessed. The maximum file age or tim esince last accessed is a property of a server directory. If the ClenaingMode is esriDCAbsolute, then all files created by the GIS server that are older than the maximum age are automatically cleaned up by the GIS server. If the ClenaingMode is esriDCSliding, then all files created by the GIS server that have not been access for a duration defined by maximum age are automatically cleaned up by the GIS server.
Note that when creating files in a server directory, they must be prefixed with "_ags_" in order to be cleaned up by the GIS server. Any files in a server directory not prefixed with "_ags_" will not be cleaned up.
The IServerDirectory interface allows you to configure the properties of a server directory to add it to the GIS Server. You must set the Path, CleaningMode, MaxFileAge (if cleaning mode is absolute or sliding) properties for the server directory which will be the directories path on disk. The Description and URL are optional.
The URL property is the virtual directory that corresponds to the physical directory specified by the Name property. Server objects (such as a map server object) can use the Name property to write their output files to a directory where they will be cleaned up, and can pass back to clients the URL for the locaiton of the files they write. Clients (for example web applications) will then not require direct access to the physical directory.
Use the AddServerDirectory method on IServerObjectAdmin to add the new server directory to your GIS Server.