English

How To: Incorporate ArcSDE raster data into an ArcIMS 9.x map service

Summary

Instructions provided demonstrate how to add ArcSDE raster data to an ArcIMS 9.0 map configuration file (AXL). ArcSDE raster layers must be added to map configuration files by manual edits using a text editor.

Procedure

This article assumes that a map configuration file with ArcSDE feature class layers has been created.

  1. Open a map configuration file using a text editor such as Notepad or WordPad.
  2. Verify that the SDEWORKSPACE element includes the correct information about the database where the ArcSDE raster data is stored. If the map configuration file does not include an SDEWORKSPACE element, edit the file to include the appropriate database information. For example,

    Code:
    <WORKSPACES>
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="TEST" user="TEST" encrypted="false" password="beehive" />
    </WORKSPACES>

  3. Add a new LAYER element to the map file, making sure to include the following required attributes: name, type, visible, and id. For example,

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="TEST" user="TEST" encrypted="false" password="beehive" />
    </WORKSPACES>
    <LAYER type="image" name="1996 DOQQ" visible="true" id="1996_doqq">


    Note:
    Refer to the ArcIMS ArcXML Programmer's Reference for optional LAYER attributes.

  4. Add a new DATASET element to the map file, making sure to include the following required attributes: name, type, and workspace. For example,

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="TEST" user="TEST" encrypted="false" password="beehive" />
    </WORKSPACES>
    <LAYER type="image" name="1996 DOQQ" visible="true" id="1996_doqq">
    <DATASET name="TEST.TEST.1996_DOQQ.RASTER" type="image" workspace="sde_ws-0" />


    Warning:
    The .RASTER extension must be added to the end of the dataset name specified in the name attribute for ArcSDE raster layers. If this extension is not included, then ArcIMS Administrator may create the map service but the following warning will be returned: "[ERR0928] ImageServer on <MACHINE_NAME>: Layer with ID <LAYER_ID> cannot be created. Dataset <LAYER_NAME> is missing, unknown type, or invalid."

  5. Add the closing LAYER element to the map configuration file.

    Code:
    <SDEWORKSPACE name="sde_ws-0" server="Helium" instance="port:6161" database="TEST" user="TEST" encrypted="false" password="beehive" />
    </WORKSPACES>
    <LAYER type="image" name="1996 DOQQ" visible="true" id="1996_doqq">
    <DATASET name="TEST.TEST.1996_DOQQ.RASTER" type="image" workspace="sde_ws-0" />
    </LAYER>


  6. Open ArcIMS Administrator and create an Image Map service for the map configuration file containing the ArcSDE raster data. If the map service fails to build, recheck the previous steps.
    Note:
    If the ArcSDE raster layer fails to add during map service creation, try using the .IMAGE extension instead of .RASTER for the DATASET name attribute. This may be the case if the raster layers were used in ArcSDE 8.3 and ArcSDE was then upgraded to 9.0

Related Information