AS2805_A Agent

The configuration for the OIG Agent for the AS2805_A interfaces is illustrated by the below example payload. The actual configuration record can be created by accessing the following resource:

http://<host:port>/api/generic/agentconfigurationas2805_a

Replace the <host:port> information with the respective information of the Oracle Insurance Gateway

{
    "code": "<code for the agent configuration record>",
    "typeConfig": {
        "hostPort": <any portnumber (*)>,
        "controlHost": "<ip-address or hostname of the AS2805_A interface>",
        "controlPort": <portnumber exposed by the aforementioned host>,
        "forwardingInstitution": "<a code that has been agreed upon by AS2805_A and the fund>",
        "receivingInstitution": "<the ISO code of the fund>",
        "idleTimeOut": <the maximum idle time of the channel before the OIG Agent sends an echo to AS2805_A>,
        "transactionTimeOut": <a value that AS2805_A will wait before time-out>,
        "lengthMessageIndicator": <specifies the amount of bytes to use for separating AS2805 messages>
    },
    "agentConfigurationIntegrations": [
        {
            "integration": {
                "type": "as2805_a",
                "code": "0200-170000"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0200-171000"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0420-170000"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0421-170000"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0200-290000"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0520"
            }
        },
        {
            "integration": {
                "type": "as2805_a",
                "code": "0521"
            }
        }
    ]
}

Agent Configuration Details

code

A free format code for the agent configuration resource.

typeConfig.hostPort

This is the port that is exposed by the OIG Agent, labeled as the data port. Note: that this currently is not used by the AS2805_A interface. At the moment this is only present to allow for simulated traffic.

typeConfig.controlHost

This is the IP-address or hostname that the AS2805_A interface is advertising for the OIG Agent to initiate the connection.

typeConfig.controlPort

This is the port number of the aformentioned typeConfig.controlHost that the AS2805_A interface is advertising for the OIG Agent to initiate the connection.

typeConfig.forwardingInstitution

This is the code that has been agreed upon by the AS2805_A interface and the FUND. Typically 8 characters long.

typeConfig.receivingInstitution

This is the ISO-code of the FUND. Typically 8 characters long.

typeConfig.idleTimeOut

This is the maximum idle time (in seconds) that the OIG Agent is going to wait before issuing an echo message to the AS2805_A interface, in order to determine whether the interface is still available. This is an optional value. The default for 30 (seconds).

typeConfig.transactionTimeOut

This is the maximum time (in seconds) that the AS2805_A interface is allowed to wait for a response, before considering the originating request as timed-out. This is an optional value. The default for AS2805_A is 30 (seconds).

typeConfig.lengthMessageIndicator

This value indicates how many bytes are to be used between AS2805_A and the OIG Agent to specify the length of an AS2805 message frame. The default value of this is 0, which indicates that no Message Length Indicator (MLI) is to be used. Values of AS2805_A effectively are 0 (for no MLI) or 2 (for a two bytes message length indicator).

agentConfigurationIntegrations

This effectively is the array of all known/established request messages that can be sent from AS2805_A to the OIG Agent. Check the section about AS2805_A Integration in this localization guide for more details.