Warnings and Tips

This section contains tips for creating your own ADL files.

When you create your own ADL file, make sure that you change only values, and not tags, inside the ADL file.
Do not edit the AdapterDefinition section except for the direction and the name of the adapter.
Certain characters, such as "<" and ">", have special meanings in XML and should not be used in the values inside an ADL file. If you need to use one of these characters as part of a value, the best solution is to surround it by special delimiters that tell the XML processor to treat the characters as literals rather than as part of the language. The delimiters are "<![CDATA[" and "]]>". An example is shown below:
```
<Documentation>
	<![CDATA[
   Inside these delimiters, the following characters will be 
   treated as literals rather than as XML language elements: 
      < > & ' "
   (i.e. the greater than sign, less than sign, ampersand, 
   single quote, and double quote).  
	]]>
	</Documentation>
```
For a complete and up-to-date list of special characters, see the XML standards.
```
XML 1.0: http://www.w3.org/TR/2004/REC-xml-20040204/
XML 1.1: http://www.w3.org/TR/2004/REC-xml11-20040204/
```
In particular, see sections 2.2 and 2.4 of each.
When you upgrade yourSybase CEP Engine, the Sybase CEP Studio installation program deletes and then re-creates the directory that has the ADL files. Any ADL files you have added will be lost. Each ADL file that you create should be backed up in a location outside your c8 directory.
When you upgrade, you should not copy your backed-up ADL files to your new directory; you should instead create new ADL files based on the structure of the ADL files in your upgraded Sybase CEP system, but with the same types of customizations as were in the backed-up ADL files that you built yourself.