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":
            "<ISO code of the fund>",
        "idleTimeOut":
            <maximum idle time 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 aforementioned 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. This way it determines whether the interface is still available. This is an optional value. The default for AS2805_A is 30 (seconds).

typeConfig.transactionTimeOut

This is the maximum time (in seconds) that the AS2805_A interface is allowed to wait for a response. After this time, the originating request is considered 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. Possible values for AS2805_A 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.