reuters

Create Reuters sessions

expand all in page

Description

The reuters function creates a reuters object. The reuters object represents an Enterprise Platform from Refinitiv™ connection.

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

Creation

Syntax

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

Description

example

c = reuters(session,servicename) creates a connection to the Enterprise Platform 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 Enterprise Platform.

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 Enterprise Platform 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 the Enterprise Platform 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 Refinitiv 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 Enterprise Platform 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 the Enterprise Platform 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 Refinitiv 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 Enterprise Platform 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 the Enterprise Platform 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 Enterprise Platform 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 the Enterprise Platform 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 Refinitiv 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 Enterprise Platform 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 the Enterprise Platform 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 Refinitiv 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 the Enterprise Platform 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 the Enterprise Platform 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

See Also

Topics

Introduced in R2008a

Datafeed Toolbox Documentation

Support