DB2_PCLOSE(3)								 1							     DB2_PCLOSE(3)

db2_pclose - Closes a persistent database connection

SYNOPSIS

       bool db2_pclose (resource  $resource)

DESCRIPTION

	This function closes a DB2 client connection created with db2_pconnect(3) and returns the corresponding resources to the database server.

       Note

	       This function is only available on i5/OS in response to i5/OS system administration requests.

	If  you  have a persistent DB2 client connection created with db2_pconnect(3), you may use this function to close the connection. To avoid
       substantial connection performance penalties, this function should only be used in rare cases when the  persistent  connection  has  become
       unresponsive or the persistent connection will not be needed for a long period of time.

PARAMETERS

	      o $connection
		- Specifies an active DB2 client connection.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Closing a persistent connection

	       The following example demonstrates a successful attempt to close a connection to an IBM DB2 i5/OS database.

	      <?php
	      $conn = db2_pconnect('', '', '');
	      $rc = db2_pclose($conn);
	      if ($rc) {
		  echo "Connection was successfully closed.";
	      }
	      ?>

	      The above example will output:

	      Connection was successfully closed.

SEE ALSO

       db2_close(3), db2_pconnect(3).

PHP Documentation Group 													     DB2_PCLOSE(3)