Skip to main content
Version: Current

Key system files - process.xml

Now let us consider a few files that are vital for configuring your application.

First, your application must have a -processes.xml file. For example, if your application is called 'bravo', then the file will be called bravo-processes.xml.

The purpose of this file is to specify the main characteristics of each of the services (or modules) in your application. If you don't define a module here, it will not be a part of your application.

So, if you add a new module, you must add its details to your application's -processes.xml file.

Characteristics that are defined for each module include:

  • the name of the script file
  • the language used by the script file
  • the classpath - any additional JAR files that the module needs in order to run
  • the logging level for the module

It is important to know that whenever you run the command genesisInstall, an enriched version of this file is put in your application's generated folder. And thereafter, it is this enriched version of the file that the system refers to whenever it starts or runs. So, if you change your version of the file, you need to run genesisInstall to make sure that your changes are put into effect.

Here is an example of a generated processes.xml file for an application that has:

  • a data server
  • a request server
  • an event handler
  • a consolidator
<processes>
  <process name="POSITION_APP_DATASERVER">
    <groupId>POSITION_APP</groupId>
    <start>true</start>
    <options>-Xmx256m</options>
    <module>genesis-pal-dataserver</module>
    <package>global.genesis.dataserver.pal</package>
    <script>position_app-dataserver.kts</script>
    <language>pal</language>
    <classpath>quickfixj-core-*.jar</classpath>
  </process>
  <process name="POSITION_APP_REQUEST_SERVER">
    <groupId>POSITION_APP</groupId>
    <start>true</start>
    <options>-Xmx256m</options>
    <module>genesis-pal-requestserver</module>
    <package>global.genesis.requestreply.pal</package>
    <script>position_app-reqrep.kts</script>
    <language>pal</language>
  </process>
  <process name="POSITION_APP_EVENT_HANDLER">
    <groupId>POSITION_APP</groupId>
    <start>true</start>
    <options>-Xmx256m -DRedirectStreamsToLog=true</options>
    <module>genesis-pal-eventhandler</module>
    <package>global.genesis.eventhandler.pal</package>
    <script>position_app-eventhandler.kts</script>
    <classpath>position_app-messages*,position_app-eventhandler*</classpath>
    <language>pal</language>
  </process>
  <process name="POSITION_APP_CONSOLIDATOR">
      <groupId>POSITION_APP</groupId>
      <start>true</start>
      <options>-Xmx256m -DRedirectStreamsToLog=true  -DXSD_VALIDATE=false</options>
      <module>consolidator2</module>
      <package>global.genesis.consolidator2</package>
      <config>position_app-consolidator2.xml</config>
      <loggingLevel>INFO,DATADUMP_OFF</loggingLevel>
      <dependency>POSITION_APP_EVENT_HANDLER</dependency>
  </process>
  
</processes>

You can find more information about this subject in our reference page on the -process.xml file.