User Guide

Database connection functions 85
Arguments
catalog, schema
■ The catalog argument is the initial catalog value.
■ The schema argument is the initial schema value.
Returns
An object that contains the new values in the catalog and schema properties. If either
property is not defined, it indicates that the user cancelled the dialog box.
MMDB.testConnection()
Availability
Dreamweaver UltraDev 4.
Description
This function tests connection settings. It displays a modal dialog box that describes the
results.
Arguments
serverPropertiesArray
This function expects a single argument, an array object that contains values from the
following list, which are appropriate for the current server model. For properties that do not
apply to the connection being tested, set them to empty (
"").
■ The type argument indicates, when useHTTP is a false value, which DLL to use for
connecting to a database at design time to test connection settings.
■ The string argument is the ADO connection string or JDBC URL.
■ The dsn argument is the data source name.
■ The driver argument is the JDBC driver.
■ The username argument is the user name.
■ The password argument is the password.
■ The useHTTP argument is a Boolean value. A value of true specifies that Dreamweaver
should use an HTTP connection at design time; otherwise, Dreamweaver uses a DLL.
Returns
A Boolean value: true if the connection test is successful; false otherwise.
000_DW_API_Print.book Page 85 Wednesday, July 20, 2005 11:58 AM