The Patch Bay is represented in Nucleus as the component /atg/dynamo/messaging/MessagingManager. The definitionFile property of the MessagingManager component names the XML file that configures Patch Bay. The value of this property is:
/atg/dynamo/messaging/dynamoMessagingSystem.xmlThe name refers to a file within the Dynamo CONFIGPATH, and should not be changed. For example, if the CONFIGPATH includes /work/atg2007.3/home/localconfig, then the XML file might be found at /work/atg2007.3/home/localconfig/atg/dynamo/messaging/dynamoMessagingSystem.xml. For more information about Dynamo CONFIGPATHs, see the Managing Properties Files section in the Nucleus: Organizing JavaBean Components chapter.
As with properties files found in the CONFIGPATH, the DMS configuration file might appear at several points in the CONFIGPATH. In this case, the configuration files are automatically combined at runtime into a single virtual file, using Dynamo’s file combination feature (see XML File Combination in the Nucleus: Organizing JavaBean Components chapter). The resulting file is then used by the messaging system. This allows multiple applications to layer on top of each other, forming a single configuration file out of multiple configuration files. The overall file used by the messaging system is a combination of all those files, in the order they are found in the CONFIGPATH.
Depending on how many ATG products you have installed, the configuration file may be compiled from the files with the pathname /atg/dynamo/messaging/dynamoMessagingSystem.xml within the various Dynamo configuration JAR files, using Dynamo’s XML file combination rules. To modify the DMS configuration file, you should not edit any of the files in these JAR files. Instead, create a file with the pathname /atg/dynamo/messaging/dynamoMessagingSystem.xml and place it in your own application module or in the <ATG2007.3dir>/home/localconfig directory.
To view the full (combined) DMS configuration file on your system, use the Component Browser in the Administration interface. Go to the page for the /atg/dynamo/messaging/MessagingManager component, and in the Properties table, click on the definitionFiles property. The resulting page displays the CONFIGPATH file name, the URL of the DTD, the pathnames of the source files that were combined to make up the configured value, and the full combined text of the XML file. Appendix D, DMS Configuration File Tags shows the DTD for the Patch Bay configuration file, which provides a description of all of the tags used in the file.
This section discusses:
