Home
Categories
Dictionnary
Download
Project Details
Changes Log
Who We Are
FAQ
License

Network configuration


    1  Grammar
    2  Parsing of the XML File
       2.1  Network element
       2.2  Channel element
       2.3  Controlling the use of a property or direction
       2.4  Generic properties
       2.5  Socket protocols properties
          2.5.1  Specific TCP protocol properties
    3  Examples
       3.1  Simple example
       3.2  Two Channels
    4  Network notification mode
    5  Event Queue Size
    6  Notes

The XML Network configuration file specifies the configuration of the Network for a Client / Server communication. Note that it is only necessary to specify a common configuration properties Network if the communication is not basic.

Grammar

See the Network configuration Schema

Parsing of the XML File

The XML file root specifies the attributes of the Network. Each child "channel" XML node specifies the properties for one channel.

Network element

The Network element has several attributes:

Channel element

Controlling the use of a property or direction

It is possible to control if a "property" or "direction" will be applied by using the "engine" XML attribute:

Generic properties

Socket protocols properties

Specific TCP protocol properties

Examples

Simple example

<network>
  <channel name="channel1">
    <direction type="serverInput" port="8080" size="1000" />
    <direction type="serverOutput" port="8081" size="150" />
    <layerSet layers="*" />
  </channel>
</network>

In this example: Note that this example is equivalent to:

<network>
  <channel name="channel1">
    <direction type="input" port="8080" size="1000" engine="server" />
    <direction type="output" port="8081" size="150" engine="server" />
    <direction type="input" port="8081" size="150" engine="client" />
    <direction type="output" port="8080" size="1000" engine="client" />
    <layerSet layers="*" />
  </channel>
</network>

Two Channels

<network>
  <channel name="channel1">
    <direction type="serverInput" port="8080" size="1000" />
    <direction type="serverOutput" port="8081" size="150" />
    <layerSet appli="1" />
    <property key="protocol" value="tcp" />
  </channel>
  <channel name="channel2">
    <direction type="serverInput" port="8083" size="1000" />
    <direction type="serverOutput" port="8084" size="150" />
    <layerSet appli="2" />
    <property key="protocol" value="udp" />
  </channel>
</network>

In this example:

Network notification mode

The Network Network notification mode specifies when the Server will notify the A661_LAYER_ACTIVE notificaiton to the Client.

Event Queue Size

The "maximumEventQueue" property specifies the maximum queue size for the protocol Channels.The property value is an int and sets the number of Buffers which will be stored by the Protocol in case the Engine could not process them (typically if too much buffers have been received in a very short amount of time). This property can have the following values:

Notes

  1. It is important to consider that UDP sockets on Windows do not accept sockets which length is greater than 65535, so you should not define an input size of more than 65535 for UDP sockets. For TCP protocols, sockets will be truncated at the OS transfer layer if their length is greater than 65535. As TCP ensures that the blocks are sent in the correct order, it is however possible to recompose the initial sent buffer by merging the separate buffers

See Also


Category: server Category: client Category: conf Category: user Category: network

Copyright 2016 Dassault Aviation. All Rights Reserved. Documentation and source under the GPL v2 licence

Project Web Hosted by SourceForge.net Copyright 1999-2010 - Geeknet, Inc., All Rights Reserved About - Legal - Help