English

How To: Change message levels of ArcIMS Spatial Server log files

Summary

ArcIMS 3.1, 4.0, 4.0.1. See below for ArcIMS 9.x.

Four levels of messages are supported in the ArcIMS Spatial Server log files:

· on: When "on" is specified, all map configuration file and error messages are written to the log files. The "on" message level was the only level available in ArcIMS 3.0.

· off: When "off" is specified, no messages are written to the log files. This improves the performance of the ArcIMS Spatial Server since the log files are not accessed, opened, or written to. However, error messages, requests, responses, and information in the map configuration file are not recorded.

· minimal: When "minimal" is specified, a notification that a request was received and a response generated, the time to process the request, and any error messages are logged.

· error: The default is "error". When "error" is specified, only error messages from the ArcIMS Spatial Server are written.

For development and debugging, either "on" or "minimal" should be used. For production, "error" or "off" should be used. In all cases, the double quotes are a part of the notation.

ArcIMS 9.0

Five levels of messages are supported in the ArcIMS Spatial Server log files:

· full verbose logging (4): All failed and log errors, warnings, and INFO1, INFO2, and INFO3 messages will be logged. This level of logging costs the most in terms of processing resources but provides the most information. You can use the alternate values of on or all for this value.

· errors, warnings, and some informational messages (3): All failed and log errors, warnings, and INFO1 messages will be logged. You can use the alternate value of minimal for this value.

· errors and warnings only (2): All failed and log errors plus all warnings will be logged. You can also use the alternate value of warning for this value. This is the default setting.

· errors only (1): All failed and log error messages will be logged. You can also use the alternate value of error for this value.

· No logging (0): No messages are written to the log files.

For development and debugging, either "4" or "3" should be used. For production, "1" or "0" should be used. In all cases, the double quotes are a part of the notation.

Procedure

The aimsserver.cfg file is used to define the level of messages written to the log files. Edit this file as needed to reflect the level desired.

  1. Navigate to and start the aimsserver.cfg file in a text editor:

    On Windows, the file is located at <ArcIMS Installation Directory>/server/etc.

    On Linux/Unix, the file is at <ArcIMS Installation Directory>/etc.

  2. ArcIMS 3.1, 4.0, 4.0.1 (see below for 9.x)

    Find and edit the logfiles attribute.

    By default, logfiles is set to "error". You can substitute "error" with "on", "off" or "minimal".

    Code:
    <AIMSSERVER debug="false" logfiles="error">
    <RESOURCES>
    <RESOURCEBUNDLE name="aimsaxl" path="System" />
    <RESOURCEBUNDLE name="aimsserver" path="System" />
    <RESOURCEBUNDLE name="aimsutil" path="System" />
    <RESOURCEBUNDLE name="aimssde" path="System" />
    <RESOURCEBUNDLE name="aimsins" path="System" />
    <RESOURCEBUNDLE name="aimsshp" path="System" />
    <RESOURCEBUNDLE name="aimsdbf" path="System" />
    <RESOURCEBUNDLE name="aimsaxlprsr" path="System" />
    </RESOURCES>
    </AIMSSERVER>

    ArcIMS 9.0
    Find and edit the logfiles attribute.

    By default, logfiles is set to "2". You can substitute "2" with "0", "1", "3" or "4".

    Code:
    <AIMSSERVER debug="false"
    logpath=""
    logmaxsize=""
    savefiles="true"
    logfiles="2" >
    <RESOURCES>
    <RESOURCEBUNDLE name="aimsaxl" path="System" />
    <RESOURCEBUNDLE name="aimsserver" path="System" />
    <RESOURCEBUNDLE name="aimsutil" path="System" />
    <RESOURCEBUNDLE name="aimssde" path="System" />
    <RESOURCEBUNDLE name="aimsins" path="System" />
    <RESOURCEBUNDLE name="aimsshp" path="System" />
    <RESOURCEBUNDLE name="aimsdbf" path="System" />
    <RESOURCEBUNDLE name="aimsaxlprsr" path="System" />
    </RESOURCES>
    </AIMSSERVER>


    For additional information refer to the ArcIMS Help topic "Change settings for error messaging".
  3. Save and close the file.
  4. Stop and restart ArcIMS Monitor service.
    <a href='http://support.esri.com/en/knowledgebase/techarticles/detail/14360' target='_blank'>How To: Stop and start the ArcIMS services or processes</a>

Related Information