# configuration system

[//]: # (Attention! this is a generated markdown from casual-configuration-documentation - do not edit this file!)

System wide configuration, that is not bound to a particular domain. Contains configuration that is used when
building servers, executable, transaction resource proxies. 


## system.resource.Paths _(structure)_

property                | description
------------------------|----------------------------------------------------
[include : `[string]`]  | include paths to use during _build time_
[library : `[string]`]  | library path to use during _build time_

## system.resources _(list)_

Defines which `xa` resources that are to be used when building servers, executable, resource-proxies. This is 
also used runtime by the transaction-manager

property                  | description
--------------------------|----------------------------------------------------
key : `string`            | user supplied _key_ of the resource, used to correlate the resources in other configurations
xa_struct_name : `string` | the name of the `xa` struct for the particular resource implementation 
server : `string`         | name of the _resource proxy server_ that `transaction manager` delegates _prepare, commit, rollback_ to.
[libraries : `[string]`]  | libraries that is used link with the resource _build time_ 
[paths : `Path`]          | include and library paths, during _build time_


## examples 

Below follows examples in `yaml` and `json` _(casual can also handle `ini` and `xml`)_

### yaml
```` yaml
---
system:
  resources:
    - key: "db2"
      server: "rm-proxy-db2-static"
      xa_struct_name: "db2xa_switch_static_std"
      libraries:
        - "db2"
      paths:
        library:
          - "${DB2DIR}/lib64"
    - key: "rm-mockup"
      server: "rm-proxy-casual-mockup"
      xa_struct_name: "casual_mockup_xa_switch_static"
      libraries:
        - "casual-mockup-rm"
      paths:
        library:
          - "${CASUAL_HOME}/lib"
...

````
### json
```` json
{
    "system": {
        "resources": [
            {
                "key": "db2",
                "server": "rm-proxy-db2-static",
                "xa_struct_name": "db2xa_switch_static_std",
                "libraries": [
                    "db2"
                ],
                "paths": {
                    "library": [
                        "${DB2DIR}/lib64"
                    ]
                }
            },
            {
                "key": "rm-mockup",
                "server": "rm-proxy-casual-mockup",
                "xa_struct_name": "casual_mockup_xa_switch_static",
                "libraries": [
                    "casual-mockup-rm"
                ],
                "paths": {
                    "library": [
                        "${CASUAL_HOME}/lib"
                    ]
                }
            }
        ]
    }
}
````