SYBASE_SET_MESSAGE_HANDLER(3)											     SYBASE_SET_MESSAGE_HANDLER(3)

sybase_set_message_handler - Sets the handler called when a server message is raised

SYNOPSIS

       bool sybase_set_message_handler (callable  $handler, [resource  $link_identifier])

DESCRIPTION

       sybase_set_message_handler(3)  sets  a user function to handle messages generated by the server. You may specify the name of a global func-
       tion, or use an array to specify an object reference and a method name.

PARAMETERS

	      o $handler
		- The handler expects five arguments in the following order: message number, severity, state, line  number  and  description.  The
		first four are integers. The last is a string. If the function returns FALSE, PHP generates an ordinary error message.

	      o $link_identifier
		- If the link identifier isn't specified, the last opened link is assumed.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      sybase_set_message_handler(3) callback function

	      <?php
		  function msg_handler($msgnumber, $severity, $state, $line, $text)
		  {
		      var_dump($msgnumber, $severity, $state, $line, $text);
		  }

		  sybase_set_message_handler('msg_handler');
	      ?>

       Example #2

	      sybase_set_message_handler(3) callback to a class

	      <?php
		  class Sybase {
		      function handler($msgnumber, $severity, $state, $line, $text)
		      {
			  var_dump($msgnumber, $severity, $state, $line, $text);
		      }
		  }

		  $sybase= new Sybase();
		  sybase_set_message_handler(array($sybase, 'handler'));
	      ?>

       Example #3

	      sybase_set_message_handler(3) unhandled messages

	      <?php
		  // Return FALSE from this function to indicate you can't handle
		  // this. The error is printed out as a warning, the way you're used
		  // to it if there is no handler installed.
		  function msg_handler($msgnumber, $severity, $state, $line, $text)
		  {
		      if (257 == $msgnumber) {
			  return false;
		      }
		      var_dump($msgnumber, $severity, $state, $line, $text);
		  }

		  sybase_set_message_handler('msg_handler');
	      ?>

NOTES

       Note

	      This function is only available when using the CT library interface to Sybase, and not with the DB library.

PHP Documentation Group 											     SYBASE_SET_MESSAGE_HANDLER(3)