Documentation

reuters

Create Reuters sessions

Syntax

r = reuters (sessionName, serviceName)
r = reuters (sessionName, serviceName, user, position)

Arguments

r

Reuters® session object created with reuters.

sessionName

Name of the Reuters session, of the form myNameSpace::mySession.

serviceName

Name of the service you use to connect to the data server.

user

User ID you use to connect to the data server.

position

IP address of the data server to which you connect to retrieve data.

Description

You must configure your environment before you use this function to connect to a Reuters data server. For details, see Reuters Data Service Requirements.

r = reuters (sessionName, serviceName) starts a Reuters session where sessionName is of the form myNameSpace::mySession and serviceName specifies the name of the service you use to connect to the data server.

r = reuters (sessionName, serviceName, user, position) starts a Reuters session where sessionName is of the form myNameSpace::mySession and serviceName is the service to use, user is the user ID, and position is the IP address of the machine to which you connect to retrieve data. Use this form of the command if you require DACS authentication.

Examples

Connecting to Reuters Data Servers

Connect to a Reuters data server with session name 'myNS::remoteSession' and service name 'dIDN_RDF':

r = reuters ('myNS::remoteSession', 'dIDN_RDF')
r =    
session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
user: []
serviceName: 'dIDN_RDF'
standardPI: 
[1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
eventQueue: [Error]
marketDataSubscriber: 
[1x1 com.reuters.rfa.internal.session. 
MarketDataSubscriberImpl]
marketDataSubscriberInterestSpec: 
[1x1 com.reuters.rfa.session.MarketDataSubscriber
InterestSpec]
client:
[1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
mdsClientHandle:
[1x1 com.reuters.rfa.internal.common.HandleImpl]

    Note:   If you do not use the Reuters DACS authentication functionality, the following error message appears:

    com.reuters.rfa.internal.connection.ConnectionImpl
    initializeEntitlementsINFO:
    com.reuters.rfa.connection.ssl.myNS.RemoteConnection 
    DACS disabled for connection myNS::RemoteConnection
    

Connecting to Reuters Data Servers Using DACS Authentication

  1. Connect to a Reuters data server using DACS authentication, with session name 'myNS::remoteSession', service name 'dIDN_RDF', user id 'ab123', and data server IP address '111.222.333.444/net':

    r = reuters ('myNS::remoteSession', 'dIDN_RDF', ...
    'ab123', '111.222.333.444/net')

  2. Add the following to your connection configuration:

    dacs_CbeEnabled=false
    dacs_SbePubEnabled=false
    dacs_SbeSubEnabled=false
  3. If you are running an SSL connection, add the following to your connection configuration:

    dacs_GenerateLocks=false

Connecting to Reuters Data Servers Without DACS Authentication

Connect to a Reuters data server with session name 'myNS::remoteSession' and service name 'dIDN_RDF', without using DACS:

r = reuters ('myNS::remoteSession', 'dIDN_RDF')

Establishing an RTIC (TIC-RMDS Edition) Connection to Reuters Data Servers

  • Non-DACs-enabled

    Make an RTIC (TIC-RMDS Edition) connection to a Reuters data server without DACS authentication, with session name 'myNS::remoteRTICSession', service name 'IDN_RDF':

    r = reuters ('myNS::remoteRTICSession','IDN_RDF')

    This RTIC connection depends on the key subscriber RVConnection. Your RVConnection configuration should look as follows:

    The RTICConnection configuration is referenced by the session remoteRTICSession, as shown in the following figure.

    Messages like the following may appear in the MATLAB® Command Window when you establish a non-DACs-enabled connection. These messages are informational and can safely be ignored.

    Oct 5, 2007 2:28:31 PM 
    com.reuters.rfa.internal.connection.
    ConnectionImpl initializeEntitlements
    INFO: com.reuters.rfa.connection.ssl....
    			myNS.RemoteConnection
    DACS disabled for connection myNS::RemoteConnection
    
  • DACs-enabled

    Make an RTIC (TIC-RMDS Edition), DACS-enabled connection to a Reuters data server, with session name 'myNS::remoteRTICWithDACs', service name 'IDN_RDF', user id 'ab123', and data server IP address '111.222.333.444/net':

    r = reuters ('myNS::remoteRTICWithDACs', 'IDN_RDF', ...
    'ab123', '111.222.333.444/net')

    This RTIC connection depends on the key subscriber RVConnection. Your RVConnection configuration should look as follows:

    Messages like the following may appear in the MATLAB Command Window when you establish a DACs-enabled connection. These messages are informational and can be ignored safely.

    Oct 5, 2007 2:27:14 PM ...
    com.reuters.rfa.internal.connection.
    ConnectionImpl$ConnectionEstablishmentThread runImpl
    INFO: com.reuters.rfa.connection.sass3.myNS.RTICwithDacs
    Connection successful: ...
    				componentName :myNS::RTICwithDacs, 
    subscriberRVConnection: 
    {service: 9453, network: 192.168.107.0;225.2.2.8, 
    daemon: tcp:192.168.107.131:9450} 
    Oct 5, 2007 2:27:14 PM 
    com.reuters.rfa.internal.connection.sass3....
    				Sass3LoggerProxy log
    INFO: com.reuters.rfa.connection.sass3.myNS.RTICwithDacs
    SASS3JNI: Received advisory from RV session@
    (9453,192.168.107.0;225.2.2.8,tcp:192.168.107.131:9450):
     _RV.INFO.SYSTEM.RVD.CONNECTED
    Oct 5, 2007 2:27:14 PM 
    com.reuters.rfa.internal.connection.ConnectionImpl 
    makeServiceInfo
    WARNING: com.reuters.rfa.connection.sass3....
    				myNS.RTICwithDacs
    Service list configuration has no 
    				alias defined for network 
    serviceName IDN_RDF
    

    If messages like the following appear in the MATLAB Command Window when you establish a DACs-enabled connection:

    SEVERE: com.reuters.rfa.entitlements._Default.Global
    DACS initialization failed: 
    com.reuters.rfa.dacs.AuthorizationException:
    Cannot start the DACS Library thread due to - 
    Cannot locate JNI library - RFADacsLib
    

    Then add an entry to the $MATLAB/toolbox/local/librarypath.txt file that points to the folder containing the following files:

    • FDacsLib.dll

    • sass3j.dll

    • sipc32.dll

Was this topic helpful?