Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

bdl

Bloomberg Data License connection

The bdl function provides the connection to the Bloomberg® Data License.

There are other functions that connect to different Bloomberg services: Bloomberg Desktop (blp), Bloomberg Server (blpsrv), and Bloomberg B-PIPE® (bpipe). For details about these Bloomberg services, see Comparing Bloomberg Connections.

For details about Bloomberg connection requirements, see Data Server Connection Requirements. To ensure a successful Bloomberg connection, perform the required steps before executing bdl. For details, see Installing Bloomberg and Configuring Connections.

Syntax

c = bdl(username,password,hostname,portnumber,decrypt)
c = bdl(username,password,hostname,portnumber,decrypt,authtype,keyfile,passphrase)

Description

example

c = bdl(username,password,hostname,portnumber,decrypt) connects to the Bloomberg Data License server using the Secure File Transfer Protocol (SFTP). bdl uses these input arguments:

  • Bloomberg Data License SFTP server login name username

  • Bloomberg Data License SFTP server password password

  • Bloomberg Data License SFTP server name hostname

  • Bloomberg Data License SFTP server port number portnumber

  • Decryption code decrypt

example

c = bdl(username,password,hostname,portnumber,decrypt,authtype,keyfile,passphrase) connects to the Bloomberg Data License server using key authentication. Specify the full path to the key file keyfile and the pass phrase passphrase.

Examples

collapse all

Create the Bloomberg Data License connection c. This code assumes the following:

  • The Bloomberg Data License SFTP server login name is 'xxxxx'.

  • The Bloomberg Data License SFTP server password is 'xxxxxxxx'.

  • The Bloomberg Data License SFTP server name is 'dlsftp.bloomberg.com'.

  • The Bloomberg Data License SFTP port number is 30206.

  • The decryption code is 'nAcLeZ'.

username = 'xxxxx';
password = 'xxxxxxxx';
hostname = 'dlsftp.bloomberg.com';
portnumber = 30206;
decrypt = 'nAcLeZ';

c = bdl(username,password,hostname,portnumber,decrypt)
c =

bdl with properties:
 
          Login: 'xxxxx'
       Hostname: 'dlsftp.bloomberg.com'
           Port: 30206
     AuthOption: 'password'
        KeyFile: ''
     Connection: [1x1 com.bloomberg.datalic.api.ExtendedFTPConnection]

c returns the Bloomberg Data License connection object with these properties:

  • Bloomberg Data License SFTP server login name

  • Bloomberg Data License SFTP server name

  • Bloomberg Data License SFTP port number

  • Authentication type is the default password authentication

  • Key file is blank

  • Bloomberg Data License API object

Close the Bloomberg Data License connection.

close(c)

Create the Bloomberg Data License connection c. This code assumes the following:

  • The Bloomberg Data License SFTP server login name is 'xxxxx'.

  • The Bloomberg Data License SFTP server password is 'xxxxxxxx'.

  • The Bloomberg Data License SFTP server name is 'dlsftp.bloomberg.com'.

  • The Bloomberg Data License SFTP port number is 30206.

  • The decryption code is 'nAcLeZ'.

  • The authentication type is 'key'.

  • The full path to the key file is 'c:\temp\mykeyfile'.

  • The pass phrase is 'mykeyphrase'.

username = 'xxxxx';
password = 'xxxxxxxx';
hostname = 'dlsftp.bloomberg.com';
portnumber = 30206;
decrypt = 'nAcLeZ';
authtype = 'key';
keyfile = 'c:\temp\mykeyfile';
passphrase = 'mykeyphrase';

c = bdl(username,password,hostname,portnumber,decrypt,authtype,...
        keyfile,passphrase)
c =

bdl with properties:
 
          Login: 'xxxxx'
       Hostname: 'dlsftp.bloomberg.com'
           Port: 30206
     AuthOption: 'key'
        KeyFile: 'c:\temp\mykeyfile'
     Connection: [1x1 com.bloomberg.datalic.api.ExtendedFTPConnection]

c returns the Bloomberg Data License connection object with these properties:

  • Bloomberg Data License SFTP server login name

  • Bloomberg Data License SFTP server name

  • Bloomberg Data License SFTP port number

  • Authentication type is key authentication

  • Full path to the key file

  • Bloomberg Data License API object

Close the Bloomberg Data License connection.

close(c)

Input Arguments

collapse all

User name, specified as a character vector or string scalar to denote your Bloomberg Data License SFTP server login name.

Data Types: char | string

Password, specified as a character vector or string scalar to denote your Bloomberg Data License SFTP server password.

Data Types: char | string

Server name, specified as a character vector or string scalar to denote the Bloomberg Data License SFTP server name.

Data Types: char | string

Port number, specified as a numeric scalar to identify the Bloomberg Data License SFTP port number of the machine where the Bloomberg Data License server is running.

Data Types: double

Decryption code, specified as a character vector or string scalar to denote the DES encryption key.

Data Types: char | string

Authentication type, specified as one of the preceding values. If you specify 'password', you must supply the Bloomberg Data License SFTP server password. If you specify 'key', you must provide a key file name and a pass phrase.

Key file, specified as a character vector or string scalar to denote the full path for the private key file. Use this argument only when authentication type authtype is 'key'.

Data Types: char | string

Pass phrase, specified as a character vector or string scalar. bdl uses this phrase to decrypt the key file. Use this argument only when authentication type authtype is 'key'.

Data Types: char | string

Output Arguments

collapse all

Bloomberg Data License connection, returned as a connection object with these properties.

Property

Description

Login

Bloomberg Data License SFTP server login name

Hostname

Bloomberg Data License SFTP server name

Port

Bloomberg Data License SFTP port number of the machine where the Bloomberg Data License server is running

AuthOption

Authentication type

KeyFile

Full path to the key file

Connection

Bloomberg Data License API object

Tips

  • For details about Bloomberg Data License, see the relevant guides by entering DLSD and clicking <GO> in the Bloomberg terminal.

Introduced in R2015a

Was this topic helpful?