reuters

Create Reuters sessions

Description

The reuters function creates a reuters object. The reuters object represents a Reuters® Market Data System (RMDS) connection.

After you create a reuters object, you can use the object functions to retrieve data from RMDS and send data to RMDS.

Creation

Description

example

c = reuters(session,servicename) creates a connection to RMDS using the session name and sets the serviceName property.

example

c = reuters(session,servicename,user,position) creates a Reuters connection with Data Access Control System (DACS) authentication, and also sets the user and position properties.

example

c = reuters(session,servicename,[],[],1) creates a Reuters connection to access only real-time data from RMDS.

Input Arguments

expand all

Session name, specified as a character vector or string scalar to denote a Reuters session.

Example: 'myNS::remoteSession'

Data Types: char | string

Properties

expand all

Session name, specified as a Reuters session object to denote the Reuters session.

This reuters function sets this property using the session input argument.

Example: [1x1 com.reuters.rfa.internal.session.SessionImpl]

User name, specified as a character vector or string scalar to denote your Reuters user identification.

Example: 'mw335'

Data Types: char | string

IP address, specified as a character vector or string scalar to identify the machine running the Reuters data server.

Example: '111.222.333.444/net'

Data Types: char | string

This property is read-only.

MATLAB application identifier, specified as the value '182'. Reuters assigns this value to identify the MATLAB application.

Reuters standard principal identity, specified as a Reuters Standard Principal Identity object.

Example: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]

Reuters client, specified as a Reuters client object.

Example: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]

Service name, specified as a character vector or string scalar that indicates the service for connecting to the Reuters data server.

Example: 'dIDN_RDF'

Data Types: char | string

Event queue, specified as a Reuters event queue object.

Example: [90 com.reuters.rfa.internal.common.EventQueueImpl]

Event source, specified as a Reuters event source object.

Example: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]

Event source interest specification, specified as a Reuters event source interest specification object.

Example: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]

Handle for the event stream, specified as a Reuters handle object.

Example: [1x1 com.reuters.rfa.internal.common.HandleImpl]

Historical data field list, specified as a Reuters field names list object.

Example: [369 com.reuters.ts1.TS1DefDb]

Object Functions

expand all

closeRelease connections to Reuters data servers
fetchRequest data from Reuters data servers
getRetrieve properties of Reuters session objects
historyRequest data from Reuters Time Series One
stopUnsubscribe securities
addricCreate Reuters Instrument Code
contribContribute data to Reuters data feed
deletericDelete Reuters Instrument Code

Examples

collapse all

Create an RMDS connection. Then, retrieve current data for a security. The current data you see when completing this example can differ from the output data shown.

Connect to RMDS with the session name 'myNS::remoteSession' and the service name 'dIDN_RDF' without DACS authentication. c is a Reuters connection object.

session = 'myNS::remoteSession';
servicename = 'dIDN_RDF';
c = reuters(session,servicename)
c =    

  reuters with properties:

                             session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
                                user: []
                            position: []
                         application: '182'
                          standardPI: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
                              client: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
                         serviceName: 'dIDN_RDF'
                          eventQueue: [90 com.reuters.rfa.internal.common.EventQueueImpl]
                marketDataSubscriber: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]
    marketDataSubscriberInterestSpec: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]
                     mdsClientHandle: [1x1 com.reuters.rfa.internal.common.HandleImpl]
                               defDb: [369 com.reuters.ts1.TS1DefDb]

Retrieve the current data for the Google® security using the Reuters session object c.

sec = 'GOOG.O';

d = fetch(c,sec)
d = 

     PROD_PERM: 74.00
    RDNDISPLAY: 66.00
    DSPLY_NAME: 'DELAYED-15GOOGLE'
    ...

d contains many Thomson Reuters™ market data fields. This output shows the product permissions information, PROD_PERM, the display information for the IDN terminal device, RDNDISPLAY, and the expanded name for the instrument, DSPLY_NAME.

Close the Reuters connection.

close(c)

Create an RMDS connection using the DACS authentication. Then, retrieve current data for a security. The current data you see when completing this example can differ from the output data shown.

Connect to RMDS using DACS authentication with the following:

  • Session name 'myNS::remoteSession'

  • Service name 'dIDN_RDF'

  • User name 'ab123'

  • Data server IP address '111.222.333.444/net'

c is a Reuters connection object.

session = 'myNS::remoteSession';
servicename = 'dIDN_RDF';
user = 'ab123';
position = '111.222.333.444/net';

c = reuters(session,servicename, ...
    user,position)
c = 
 
  reuters with properties:

                         session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
                            user: 'mw335'
                        position: '111.222.333.444/net'
                     application: '182'
                      standardPI: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
                          client: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
                     serviceName: 'dIDN_RDF'
                      eventQueue: [0 com.reuters.rfa.internal.common.EventQueueImpl]
            marketDataSubscriber: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]
marketDataSubscriberInterestSpec: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]
                 mdsClientHandle: [1x1 com.reuters.rfa.internal.common.HandleImpl]
                           defDb: []

Retrieve the current data for the Google security using the Reuters session object c.

sec = 'GOOG.O';

d = fetch(c,sec)
d = 

     PROD_PERM: 74.00
    RDNDISPLAY: 66.00
    DSPLY_NAME: 'DELAYED-15GOOGLE'
    ...

d contains many Thomson Reuters market data fields. This output shows the product permissions information, PROD_PERM, the display information for the IDN terminal device, RDNDISPLAY, and the expanded name for the instrument, DSPLY_NAME.

Close the Reuters connection.

close(c)

Create an RMDS connection for real-time data retrieval. Then, retrieve real-time data for a security. The current data you see when completing this example can differ from the output data shown.

Connect to RMDS with the session name 'myNS::remoteSession' and the service name 'IDN_SELECTFEED'. Leave the user name and DACS position blank. Specify the last argument as 1 to retrieve only real-time data. c is a Reuters connection object.

session = 'myNS::remoteSession';
servicename = 'IDN_SELECTFEED';

c = reuters(session,servicename,[],[],1)
c = 

  reuters with properties:

                         session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
                            user: []
                        position: []
                     application: '182'
                      standardPI: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
                          client: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
                     serviceName: 'IDN_SELECTFEED'
                      eventQueue: [1 com.reuters.rfa.internal.common.EventQueueImpl]
            marketDataSubscriber: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]
marketDataSubscriberInterestSpec: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]
                 mdsClientHandle: [1x1 com.reuters.rfa.internal.common.HandleImpl]
                           defDb: []

Retrieve real-time data. The rtdemo event handler function returns the real-time Reuters data for the Google security to the MATLAB workspace variable A.

sec = 'GOOG.O';
eventhandler = 'rtdemo';

subs = fetch(c,sec,eventhandler);

Close the Reuters connection.

close(c)

Create an RMDS connection using the RTIC (TIC-RMDS Edition). Then, retrieve current data for a security. The current data you see when completing this example can differ from the output data shown.

Connect to RMDS using an RTIC (TIC-RMDS Edition) connection without DACS authentication. Use the session name 'myNS::remoteRTICSession' and the service name 'IDN_RDF'. The Reuters connection object c appears in the MATLAB workspace.

session = 'myNS::remoteRTICSession';
servicename = 'IDN_RDF';

c = reuters(session,servicename)
c = 
 
  reuters with properties:

                             session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
                                user: []
                            position: []
                         application: '182'
                          standardPI: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
                              client: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
                         serviceName: 'IDN_RDF'
                          eventQueue: [0 com.reuters.rfa.internal.common.EventQueueImpl]
                marketDataSubscriber: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]
    marketDataSubscriberInterestSpec: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]
                     mdsClientHandle: [1x1 com.reuters.rfa.internal.common.HandleImpl]
                               defDb: []

Retrieve the current data for the Google security using the Reuters session object c.

sec = 'GOOG.O';

d = fetch(c,sec)
d = 

     PROD_PERM: 74.00
    RDNDISPLAY: 66.00
    DSPLY_NAME: 'DELAYED-15GOOGLE'
    ...

d contains many Thomson Reuters market data fields. This output shows the product permissions information, PROD_PERM, the display information for the IDN terminal device, RDNDISPLAY, and the expanded name for the instrument, DSPLY_NAME.

Close the Reuters connection.

close(c)

Create an RMDS connection using the RTIC (TIC-RMDS Edition) with DACS authentication. Then, retrieve current data for a security. The current data you see when completing this example can differ from the output data shown.

Connect to RMDS using an RTIC (TIC-RMDS Edition) connection with DACS authentication, and specify the following:

  • Session name 'myNS::remoteRTICWithDACs'

  • Service name 'IDN_RDF'

  • User name 'ab123'

  • Data server IP address '111.222.333.444/net'

c is a Reuters connection object.

session = 'myNS::remoteRTICWithDACs';
servicename = 'IDN_RDF';
user = 'ab123';
position = '111.222.333.444/net';

c = reuters(session,servicename, ...
    user,position)
c = 
 
  reuters with properties:

                             session: [1x1 com.reuters.rfa.internal.session.SessionImpl]
                                user: 'mw427'
                            position: '192.168.107.130'
                         application: '182'
                          standardPI: [1x1 com.reuters.rfa.common.StandardPrincipalIdentity]
                              client: [1x1 com.mathworks.toolbox.datafeed.MatlabReutersClient]
                         serviceName: 'IDN_RDF'
                          eventQueue: [2 com.reuters.rfa.internal.common.EventQueueImpl]
                marketDataSubscriber: [1x1 com.reuters.rfa.internal.session.md.MarketDataSubscriberImpl]
    marketDataSubscriberInterestSpec: [1x1 com.reuters.rfa.session.MarketDataSubscriberInterestSpec]
                     mdsClientHandle: [1x1 com.reuters.rfa.internal.common.HandleImpl]
                               defDb: []

Retrieve the current data for the Google security using the Reuters session object c.

sec = 'GOOG.O';

d = fetch(c,sec)
d = 

     PROD_PERM: 74.00
    RDNDISPLAY: 66.00
    DSPLY_NAME: 'DELAYED-15GOOGLE'
    ...

d contains many Thomson Reuters market data fields. This output shows the product permissions information, PROD_PERM, the display information for the IDN terminal device, RDNDISPLAY, and the expanded name for the instrument, DSPLY_NAME.

Close the Reuters connection.

close(c)

Tips

  • You can connect to the Reuters data server without DACS authentication. For example, use this code.

    c = reuters('myNS::remoteSession','IDN_CONFLATED');

  • When you connect to RMDS without DACS authentication, ignore these informational messages if they appear in the Command Window.

    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
    

  • When you connect to RMDS with DACS authentication, ignore these informational messages if they appear in the Command Window.

    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
    

Introduced in R2008a