Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)

Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529) Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)

master272.com
from master272.com More from this publisher
26.10.2014 Views

AdfinX Real Time 1.0 Library - User's Guide 2. ADXRTLIST 2.1. ADXRTLIST PROPERTIES 2.1.1. Source Source Name of the data source as a string. Arguments None Error Handling Depends on the value of the DebugLevel general property, as follows: RT_DEBUG_NO If the source is already known as invalid or down, an exception is raised. If the status of the source is unknown, then the process continues without any warning or error. RT_DEBUG_IMMEDIATE When using SSL, the source is checked for validity. If it is not valid an exception is raised before setting a new property value. If the source is unknown or down an exception is raised. It is important to note that in this mode the setting of the Source property could be very slow. Example Public list as AdxRtList Set list = New AdxRtList 'Declare as global variable' 'Create an instance of the list object. This syntax is more efficient than when only the new instruction is used. Otherwise, before execution, Visual Basic will test each statement containing list for the value Nothing. ' list.Source = "IDN_SELECTFEED" 'Set the source name to "IDN_SELECTFEED"' 2.1.2. Mode Mode This property describes various behavioural aspects of the AdxRtList object. In particular, it determines how the list object will deliver data update events to the client application. The allowed parameters are: FRQ : The frequency of regularly generated events. If the list’s StartUpdates method was called with the run mode value RT_MODE_ONTIME or RT_MODE_ONTIME_IF_UPDATED, OnTime events will be triggered at this frequency. The minimum frequency is one event per second. FRQ:iH set a frequency of one event every i hours. FRQ:iM set a frequency of one event every i minutes. FRQ:iS set a frequency of one event every i seconds. The default frequency is one event every 10 seconds. 10

AdfinX Real Time 1.0 Library - User's Guide TIMEOUT : The maximum time in seconds to allow for the arrival of data images for the items of the list. TIMEOUT:i set a timeout period of i seconds. By default, its value is zero, indicating that no timeout is in effect. Arguments None Example Public list as AdxRtList Set list = New AdxRtList 'Declare as global variable' 'Create an instance of the list object. This syntax is more efficient than when only the new instruction is used. Otherwise, before execution, Visual Basic will test each statement containing list for the value Nothing. ' list.Source = "IDN_SELECTFEED" 'Set the source name to "IDN_SELECTFEED"' list.StartUpdates RT_MODE_TIME list.Mode = "FRQ:10s" 2.1.3. DebugLevel DebugLevel This property defines the support for debugging provided by the AdxRtList object. It takes a value from the RT_DebugLevel enumeration. Arguments None 2.1.4. ErrorMode ErrorMode This property sets the error mode for the object. When an error is detected, this property is consulted to see what action should be taken by the object to inform the user of the application. It must be assigned a value from the AdxErrorMode enumeration. By default the error mode is set to EXCEPTION. Arguments None 2.1.5. ErrorCode ErrorCode This property retrieves the error code of the latest error encountered by the object as an integer value. If the ErrorMode property of the object is set to NO_EXCEPTION, this value must be consulted by the client application to determine whether an error has occurred. 11

<strong>AdfinX</strong> <strong>Real</strong> <strong>Time</strong> <strong>1.0</strong> <strong>Library</strong> - <strong>User</strong>'s <strong>Guide</strong><br />

TIMEOUT : The maximum time in seconds to allow for the arrival of data images for the<br />

items of the list.<br />

TIMEOUT:i set a timeout period of i seconds.<br />

By default, its value is zero, indicating that no timeout is in effect.<br />

Arguments<br />

<strong>No</strong>ne<br />

Example<br />

Public list as AdxRtList<br />

Set list = New AdxRtList<br />

'Declare as global variable'<br />

'Create an instance of the list object. This syntax is more<br />

efficient than when only the new instruction is used. Otherwise,<br />

before execution, Visual Basic will test each statement<br />

containing list for the value <strong>No</strong>thing. '<br />

list.Source = "IDN_SELECTFEED"<br />

'Set the source name to "IDN_SELECTFEED"'<br />

list.StartUpdates RT_MODE_TIME<br />

list.Mode = "FRQ:10s"<br />

2.1.3. DebugLevel<br />

DebugLevel<br />

This property defines the support for debugging provided by the AdxRtList object. It takes a value<br />

from the RT_DebugLevel enumeration.<br />

Arguments<br />

<strong>No</strong>ne<br />

2.1.4. ErrorMode<br />

ErrorMode<br />

This property sets the error mode for the object. When an error is detected, this property is consulted<br />

to see what action should be taken by the object to inform the user of the application. It must be<br />

assigned a value from the AdxErrorMode enumeration.<br />

By default the error mode is set to EXCEPTION.<br />

Arguments<br />

<strong>No</strong>ne<br />

2.1.5. ErrorCode<br />

ErrorCode<br />

This property retrieves the error code of the latest error encountered by the object as an integer value.<br />

If the ErrorMode property of the object is set to NO_EXCEPTION, this value must be consulted by the<br />

client application to determine whether an error has occurred.<br />

11

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!