db2_connect
Returns a connection to a database
&reftitle.description;
resourcedb2_connect
stringdatabase
stringusername
stringpassword
arrayoptions
Creates a new connection to an IBM DB2 Universal Database, IBM Cloudscape,
or Apache Derby database.
&reftitle.parameters;
database
For a cataloged connection to a database, database
represents the database alias in the DB2 client catalog.
For an uncataloged connection to a database,
database represents a complete connection
string in the following format:
DRIVER={IBM DB2 ODBC DRIVER};DATABASE=database;HOSTNAME=hostname;PORT=port;PROTOCOL=TCPIP;UID=username;PWD=password;
where the parameters represent the following values:
database
The name of the database.
hostname
The hostname or IP address of the database server.
port
The TCP/IP port on which the database is listening for
requests.
username
The username with which you are connecting to the
database.
password
The password with which you are connecting to the database.
username
The username with which you are connecting to the database.
For uncataloged connections, you must pass a &null; value or empty
string.
password
The password with which you are connecting to the database.
For uncataloged connections, you must pass a &null; value or empty
string.
options
An associative array of connection options that affect the behavior
of the connection, where valid array keys include:
autocommit
Passing the DB2_AUTOCOMMIT_ON value turns
autocommit on for this connection handle.
Passing the DB2_AUTOCOMMIT_OFF value turns
autocommit off for this connection handle.
&reftitle.returnvalues;
Returns a connection handle resource if the connection attempt is
successful. If the connection attempt fails, db2_connect
returns &false;.
&reftitle.examples;
Creating a cataloged connection
Cataloged connections require you to have previously cataloged the target
database through the DB2 Command Line Processor (CLP) or DB2
Configuration Assistant.
]]>
&example.outputs;
Creating an uncataloged connection
An uncataloged connection enables you to dynamically connect to a
database.
]]>
&example.outputs;
Creating a connection with autocommit off by default
Passing an array of options to db2_connect enables
you to modify the default behavior of the connection handle.
DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
if ($conn) {
echo "Connection succeeded.\n";
if (db2_autocommit($conn)) {
echo "Autocommit is on.\n";
}
else {
echo "Autocommit is off.\n";
}
db2_close($conn);
}
else {
echo "Connection failed.";
}
?>
]]>
&example.outputs;
&reftitle.seealso;
db2_close
db2_pconnect