The document must comply with the XML Document Type Definition bdf.dtd. This file is included in the Apama installation's etc directory. This description of the file format is presented for troubleshooting purposes and general background information.

When you create a new block as part of a project in Software AG Designer, the best practice is to locate it in the project's default blocks directory. This directory is found in the project's catalogs directory. The block directory has a name in the form <project_name> blocks. So, for example, the default block directory of a project named My_Project will be catalogs\My_Project blocks.

If you place your block in the Apama project's default block directory, scenarios created in the project will automatically find them and make them available in Event Modeler when you are displaying the scenario.

Software AG Designer assigns the name of the file as follows:

For example, the block whose <name> attribute is Database Retrieval would be defined in the file Database Retrieval v1.0.bdf and stored in a folder called Database Retrieval.bdf. This convention makes it easy to browse multiple versions of the block within a block catalog when using the Event Modeler. Note that this naming and folder placement (and creation) is all done automatically.