Add an image catalog to a Map Configuration File on UNIX

Summary

Instructions provided describe how to add an image catalog to a map configuration file on UNIX. Image catalogs must be added to map configuration files manually using a text editor.

Procedure

1. Navigate to the /usr/tmp directory and create a new directory called 'ic_test'. For example:
   
   

   Code:
   cd /usr/tmp
   mkdir ic_test

   
   
2. Download the sample data. Navigate to the /usr/tmp/ic_test directory and uncompress the sample_ic.tar.gz file. Untar the contents of the tar file. For example:
   
   

   Code:
   cd /usr/tmp/ic_test
   gunzip sample_ic.tar.gz
   tar -xvf sample_ic.tar

   
   
   

   Warning:
    This example does not work if the example data and AXL file are not located in /usr/tmp/ic_test

   
   
3. Open the img_cat.axl file with a text editor such as the VI editor.
4. Manually add a new IMAGEWORKSPACE element to the AXL file, making sure to include the following required attributes: directory and name. For example,
   
   

   Code:
   <WORKSPACES>
   <SHAPEWORKSPACE name="shp_ws-0" directory="/usr/tmp/ic_test" /> 
   <IMAGEWORKSPACE name="img_ws-0" directory="/usr/tmp/ic_test" />      
   </WORKSPACES>

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

   Code:
   <IMAGEWORKSPACE name="img_ws-0" directory="/usr/tmp/ic_test" />      
   </WORKSPACES>
   <LAYER type="image" name="Image Catalog" visible="true" id="img_cat" >

   
   
   

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

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

   Code:
   <IMAGEWORKSPACE name="img_ws-0" directory="/usr/tmp/ic_test" />      
   </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, ArcIMS Administrator displays the following warning message: 'ImageServer: Layer Image Catalog cannot be created. Dataset not found'. The map service will build but the image catalog will not available in the client viewer.

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

   Code:
   <IMAGEWORKSPACE name="img_ws-0" directory="/usr/tmp/ic_test" />      
   </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.
9. Using ArcIMS Administrator, create a new map service called 'img_cat'. For the Map File, browse to /usr/tmp/ic_test and select img_cat.axl. For Virtual Server, select ImageServer1 and click OK.
   
   If the service fails to add, recheck the previous steps.