JFIXClient Configuration
JFIXClient is configured through an XML document. A sample document is included
below:
<?xml version="1.0" ?>
<CLIENT>
<!>
<Protocol Version="FIX.4.2" />
<FIXServer Host="127.0.0.1" Port="8433" />
<!>
<Logging>
<Log Name="Dev"
File="../logs/jfixDev.txt"
Level="All"
Console="OFF"
/>
<Log Name="RawLog"
File="../logs/rawlog.txt"
Level="All"
Console="OFF"
Pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %m%n"
/>
</Logging>
<!>
<Session>
<Name Value="JFIXClient" />
<SenderID>
<FIXTAG Tag="SenderCompID" Value="TEST" />
<FIXTAG Tag="SenderSubID" Value="SenderSub1" />
</SenderID>
<TargetID>
<FIXTAG Tag="TargetCompID" Value="FIX01" />
<FIXTAG Tag="TargetSubID" Value="TargetSub1" />
</TargetID>
<PersistenceKey Value="../logs/jfc.dat" />
<SessionLog File="../logs/sessionlog.txt" EOFChar="~" ExpandTagNames="Yes" />
</Session>
<!>
<Driver>
<URL Value="../config/FIX42Buttons.xml" />
</Driver>
<!>
<FIXMsgTemplate URL="file:../config/template1.xml" />
</CLIENT>
Tags
Description:
This tag represents the "document name". It's worthless, and can actually be any value. For example, you can replace "CLIENT" with "WorthlessSteamingPile".
Attributes:
None
Sub-Tags:
None
Description:
Specifies the driver for the client.
Attributes:
- Classname - The (fully qualified) classname of an object to be used as a driver. (See Writing JFIXClient drivers for more information)
Sub-Tags:
- URL - Specifies a URL used to further configure the driver.
Description:
If present specifies a URL used to further configure the driver.
Attributes:
None
Sub-Tags:
- URL - Specifies a URL used to further configure the driver.
Description:
Specifies the FIX server to which the client should connect.
Attributes:
- Host - The hostname or IP address of the FIX server.
- Port - The port number on which the FIX server is listening.
Sub-Tags:
None
Description:
Binds a value to a particular FIX tag. For example, FIX tag 8 might be bound to "FIX.4.2"
Attributes:
- Tag - The numerical value of a FIX tag
- Value - A string value for a FIX tag. (e.g. "FIX.4.2")
Sub-Tags:
None
Description:
Used to parameterize a particular logger.
Attributes:
- Name - The name of the log
- File - A path to a disk file to which the log should be written
- Level - The severity level of the log
- Pattern - A string that specifies the format of each log entry. See http://h.foo.org for more information.
- Console - If set to "Yes" then logging to the console is enabled. "No" by default.
Sub-Tags:
None
Description:
Used to parameterize the logging subsystem
Attributes:
None
Sub-Tags:
- Log - Used to parameterize a particular logger.
Description:
If present, specifies a string to be used as the persistence key for this session. In the current implementation the key is used as a filename on the local store. Other implementations (or possibly future ones) might interpret the key as something else (such as a database table name)
Attributes:
- Value - The name of a file to be used as the persistent store for the session.
Sub-Tags:
None
Description:
Specifies the version of the FIX protocol that should be used.
Attributes:
- Version - A string identifying a version of the FIX protocol. This is the same value as the FIX BeginString tag (e.g. "FIX.4.2").
Sub-Tags:
None
Description:
Specifies the sender identity of the session.
Attributes:
None
Sub-Tags:
- FIXTag - Binds a value to a particular FIX tag. For example, FIX tag 8 might be bound to "FIX.4.2"
Description:
Used to parameterize the session object. Please note that this set of tags, attributes, and values are designed to work with the standard JFIXClient session objects. Independently written or adapted session objects can be parameterized differently.
Attributes:
- Name - The name of the session
Sub-Tags:
- SenderID - Specifies the sender identity of the session.
- TargetID - Specifies the target identity of the session.
- PersistenceKey - If present, specifies a string to be used as the persistence key for this session. In the current implementation the key is used as a filename on the local store. Other implementations (or possibly future ones) might interpret the key as something else (such as a database table name)
- SessionLog - If present, specifies a configuration for a session log. (See xxx for more information)
Description:
If present, specifies a configuration for a session log. (See xxx for more information)
Attributes:
- File - The name of the log file
- EOFChar - A character to use in place of the FIX field separator character. This makes the log files significantly more readable.
- ExpandTagNames - If set to "Yes" then tag names are expanded before they are logged. For example, tag #8 is expanded to "BeginString"
Sub-Tags:
None
Description:
Specifies the target identity of the session.
Attributes:
None
Sub-Tags:
- FIXTag - Binds a value to a particular FIX tag. For example, FIX tag 8 might be bound to "FIX.4.2"
Description:
Specifies a URL used to further configure the driver.
Attributes:
Sub-Tags:
None