Add an image catalog to a Map Configuration File

Summary

Instructions provided will explain the steps to add an image catalog to a map configuration file. Image catalogs must be added to map configuration files manually using a text editor.

Procedure

1. Create a folder at the C:\ root level called ex_imgcat.
2. Download the sample data. Extract the contents of the WinZip file to C:\ex_imgcat.
   
   

   Warning:
   This example will not work if the example data are not located in C:\ex_imgcat.

   
   
3. Open a text editor such as WordPad or Notepad and open img_cat.axl from C:\ex_imgcat.
   
   

   Note:
   It may be necessary to change 'Files of Type' to 'All Files' to see img_cat.axl.

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

   Code:
   <WORKSPACES>
   <SHAPEWORKSPACE name="shp_ws-0" directory="C:\ex_imgcat" />
   <IMAGEWORKSPACE name="img_ws-0" directory="C:\ex_imgcat" />
   </WORKSPACES>

   
   
5. 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:
   <IMAGEWORKSPACE name="img_ws-0" directory="C:\ex_imgcat" />
   </WORKSPACES>
   <LAYER type="image" name="Image Catalog" visible="true" id="img_cat" >
   

   
   
   

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

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

   Code:
   <IMAGEWORKSPACE name="img_ws-0" directory="C:\ex_imgcat" />
   </WORKSPACES>
   <LAYER type="image" name="Image Catalog" visible="true" id="img_cat" >
   <DATASET name="img_cat.dbf" type="image" workspace="img_ws-0" />
   

   
   
   

   Warning:
   The .dbf extension must be added to the end of the image catalog name specified in the name attribute for the DATASET name element. If this extension is not included, then ArcIMS Administrator will display a warning yielding the following message: "ImageServer: Layer Image Catalog cannot be created. Dataset not found."
   
   The map service will build but the image catalog will not be available in the client viewer.

   
   
7. Add the closing LAYER element to the map configuration file. For example,
   
   

   Code:
   <IMAGEWORKSPACE name="img_ws-0" directory="C:\ex_imgcat" />
   </WORKSPACES>
   <LAYER type="image" name="Image Catalog" visible="true" id="img_cat" >
   <DATASET name="img_cat.dbf" type="image" workspace="img_ws-0" />
   </LAYER>

   
   
   
8. Save img_cat.axl and close the text editor.
   
   

   Note:
   Click Yes if the prompt appears with the following message: 'You are about to save the document in a Text-Only format, which will remove all formatting. Are you sure you want to do this?'

   
   
9. Using ArcIMS Administrator, create a new map service called img_cat. For Map File, browse to C:\ex_imgcat and select img_cat.axl. For Virtual Server, select ImageServer1 and click OK.
   
   If the service fails to add, recheck the previous steps.