Datafeed Toolbox™

reuters - Create Reuters^® sessions

Syntax

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

Arguments

Description

You must configure your environment before you use this function to connect to a Reuters data server. For more information, 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 directory containing the following files:

  • FDacsLib.dll

  • sass3j.dll

  • sipc32.dll

See Also

reuters.fetch

kx.tables

reuters.close