LIST CONNECTIONS Command

  • Article

Continuously displays information about the named connections in the current database.

LIST CONNECTIONS   [TO PRINTER [PROMPT] | TO FILE FileName]   [NOCONSOLE]

Parameters

  • TO PRINTER [PROMPT]
    Directs output from LIST CONNECTIONS to a printer.

    In Visual FoxPro, you can include the optional PROMPT clause to display a Print dialog box before printing starts. Place PROMPT immediately after TO PRINTER.

  • TO FILE FileName
    Directs output from LIST CONNECTIONS to the file specified with FileName. If the file already exists and SET SAFETY is ON, Visual FoxPro displays a prompt asking if you want to overwrite the file.

  • NOCONSOLE
    Suppresses output to the main Visual FoxPro window or to the active user-defined window.

Remarks

The information displayed includes the names of named connections, datasources, and connection strings in the current database. Use DBGETPROP( ) to return additional information about connections in the current database.

Example

The following example assumes an ODBC data source called MyFoxSQLNT is available, and the user ID for the data source is "sa." The testdata database is opened, and a connection named Myconn is created. LIST CONNECTIONS is used to list the named connections in the database.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'data\testdata')

CREATE CONNECTION Myconn DATASOURCE "MyFoxSQLNT" USERID "sa"
CLEAR
LIST CONNECTIONS     && Lists named connections in the database

See Also

CREATE CONNECTION | DELETE CONNECTION | DBGETPROP( ) | DISPLAY CONNECTIONS | RENAME CONNECTION