db2_conn_errormsg(3) [php man page]

DB2_CONN_ERRORMSG(3)							 1						      DB2_CONN_ERRORMSG(3)

db2_conn_errormsg - Returns the last connection error message and SQLCODE value

SYNOPSIS

       string db2_conn_errormsg ([resource  $connection])

DESCRIPTION

       db2_conn_errormsg(3)  returns  an  error  message and SQLCODE value representing the reason the last database connection attempt failed. As
       db2_connect(3) returns FALSE in the event of a failed connection attempt, do not pass any parameters to	db2_conn_errormsg(3)  to  retrieve
       the associated error message and SQLCODE value.

	If,  however,  the connection was successful but becomes invalid over time, you can pass the $connection parameter to retrieve the associ-
       ated error message and SQLCODE value for a specific connection.

PARAMETERS

	      o $connection
		- A connection resource associated with a connection that initially succeeded, but which over time became invalid.

RETURN VALUES

	Returns a string containing the error message and SQLCODE value resulting from a failed connection attempt. If there is no  error  associ-
       ated with the last connection attempt, db2_conn_errormsg(3) returns an empty string.

EXAMPLES

       Example #1

	      Retrieving the error message returned by a failed connection attempt

	       The  following  example demonstrates how to return an error message and SQLCODE value after deliberately passing invalid parameters
	      to db2_connect(3).

	      <?php
	      $conn = db2_connect('badname', 'baduser', 'badpassword');
	      if (!$conn) {
		  print db2_conn_errormsg();
	      }
	      ?>

	      The above example will output:

	      [IBM][CLI Driver] SQL1013N  The database alias name
	      or database name "BADNAME" could not be found.  SQLSTATE=42705
	       SQLCODE=-1013

SEE ALSO

       db2_conn_error(3), db2_connect(3), db2_stmt_error(3), db2_stmt_errormsg(3).

PHP Documentation Group 												      DB2_CONN_ERRORMSG(3)

DB2_ROLLBACK(3) 							 1							   DB2_ROLLBACK(3)

db2_rollback - Rolls back a transaction

SYNOPSIS

       bool db2_rollback (resource  $connection)

DESCRIPTION

	Rolls back an in-progress transaction on the specified connection resource and begins a new transaction. PHP applications normally default
       to AUTOCOMMIT mode, so db2_rollback(3) normally has no effect unless AUTOCOMMIT has been turned off for the connection resource.

PARAMETERS

	      o $connection
		- A valid database connection resource variable as returned from db2_connect(3) or db2_pconnect(3).

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Rolling back a DELETE statement

	       In the following example, we count the number of rows in a table, turn off AUTOCOMMIT mode on a database connection, delete all	of
	      the  rows  in the table and return the count of 0 to prove that the rows have been removed. We then issue db2_rollback(3) and return
	      the updated count of rows in the table to show that the number is the same as before we issued the DELETE statement. The	return	to
	      the original state of the table demonstrates that the roll back of the transaction succeeded.

	      <?php
	      $conn = db2_connect($database, $user, $password);

	      if ($conn) {
		  $stmt = db2_exec($conn, "SELECT count(*) FROM animals");
		  $res = db2_fetch_array( $stmt );
		  echo $res[0] . "
";

		  // Turn AUTOCOMMIT off
		  db2_autocommit($conn, DB2_AUTOCOMMIT_OFF);

		  // Delete all rows from ANIMALS
		  db2_exec($conn, "DELETE FROM animals");

		  $stmt = db2_exec($conn, "SELECT count(*) FROM animals");
		  $res = db2_fetch_array( $stmt );
		  echo $res[0] . "
";

		  // Roll back the DELETE statement
		  db2_rollback( $conn );

		  $stmt = db2_exec( $conn, "SELECT count(*) FROM animals" );
		  $res = db2_fetch_array( $stmt );
		  echo $res[0] . "
";
		  db2_close($conn);
	      }
	      ?>

	      The above example will output:

	      7
	      0
	      7

SEE ALSO

       db2_autocommit(3), db2_commit(3).

PHP Documentation Group 													   DB2_ROLLBACK(3)