...
Configuring System Actions
(TODO: explain where the pentaho.xml file lives)
You configure a system action by adding information about the action sequence that is to be run as a system action to the <system-action> node of the pentaho.xml file. For instance, if your action sequence is called usernameToRegion.xaction, it exists in the repository under samples/filters, you want the action sequence to run when the user logs in, with the output placed in session scope, and you want the output of the action sequence to be available in a portlet, you would write this xml element:
...