mqseries_put(3) [php man page]

MQSERIES_PUT(3) 							 1							   MQSERIES_PUT(3)

mqseries_put - MQSeries MQPUT

SYNOPSIS

       void  mqseries_put  (resource  $hConn, resource	$hObj, array  &$md, array  &$pmo, string  $message, resource  &$compCode, resource  &$rea-
       son)

DESCRIPTION

	The mqseries_put(3) (MQPUT) call puts a message on a queue or distribution list. The queue or distribution list must already be open.

PARAMETERS

	      o $hConn
		-Connection handle.This handle represents the connection to the queue manager.

	      o $hObj
		-Object handle.This handle represents the object to be used.

	      o $md
		-Message descriptor (MQMD).

	      o $pmo
		-Put message options (MQPMO).

	      o $message
		-The actual message to put onto the queue.

	      o $compCode
		-Completion code.

	      o $reason
		-Reason code qualifying the compCode.

RETURN VALUES

       No value is returned.

EXAMPLES

       Example #1

	      mqseries_put(3) example

	      <?php
	      // open connection to the queue manager
		  mqseries_conn('WMQ1', $conn, $comp_code, $reason);
	      // $conn now hold the reference to the connection to the queue manager.

	      // open the connectio to the testq queueu
		  mqseries_open(
			      $conn,
			      array('ObjectName' => 'TESTQ'),
			      MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_FAIL_IF_QUIESCING | MQSERIES_MQOO_OUTPUT,
			      $obj,
			      $comp_code,
			      $reason);
	      // $obj now holds the reference to the object (TESTQ)

	      // setup the message descriptor array. Check MQSeries reference manuals.
		  $md = array(
			      'Version' => MQSERIES_MQMD_VERSION_1,
			      'Expiry' => MQSERIES_MQEI_UNLIMITED,
			      'Report' => MQSERIES_MQRO_NONE,
			      'MsgType' => MQSERIES_MQMT_DATAGRAM,
			      'Format' => MQSERIES_MQFMT_STRING,
			      'Priority' => 1,
			      'Persistence' => MQSERIES_MQPER_PERSISTENT);

	      // setup the put message options.
		  $pmo = array('Options' => MQSERIES_MQPMO_NEW_MSG_ID|MQSERIES_MQPMO_SYNCPOINT);

	      // put the message 'Ping' on the queueu.
		  mqseries_put($conn, $obj, $md, $pmo, 'Ping', $comp_code, $reason);

		  if ($comp_code !== MQSERIES_MQCC_OK) {
		      printf("put CompCode:%d Reason:%d Text:%s<br>
", $comp_code, $reason, mqseries_strerror($reason));
		  }

	      // close the object reference $obj
		  mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);

	      // disconnect from the queue manager.
		  mqseries_disc($conn, $comp_code, $reason);

	      ?>

SEE ALSO

       mqseries_conn(3), mqseries_connx(3), mqseries_open(3), mqseries_get(3).

PHP Documentation Group 													   MQSERIES_PUT(3)

OCI_ERROR(3)															      OCI_ERROR(3)

oci_error - Returns the last error found

SYNOPSIS

       array oci_error ([resource  $resource])

DESCRIPTION

	Returns the last error found.

	The function should be called immediately after an error occurs. Errors are cleared by a successful statement.

PARAMETERS

	      o $resource
		-  For	most  errors,  $resource  is  the resource handle that was passed to the failing function call. For connection errors with
		oci_connect(3), oci_new_connect(3) or oci_pconnect(3) do not pass $resource.

RETURN VALUES

	If no error is found, oci_error(3) returns FALSE. Otherwise, oci_error(3) returns the error information as an associative array.

       oci_error(3) Array Description

       +----------+--------------------------------------+---+
       |Array key |					 |   |
       |	  |					 |   |
       |	  |		    Type		 |   |
       |	  |					 |   |
       |	  |		Description		 |   |
       |	  |					 |   |
       +----------+--------------------------------------+---+
       |	  |					 |   |
       |  code	  |					 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  integer		 |   |
       |	  |					 |   |
       |	  |	  The Oracle error number.	 |   |
       |	  |					 |   |
       |	  |					 |   |
       | message  |					 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		   string		 |   |
       |	  |					 |   |
       |	  |	   The Oracle error text.	 |   |
       |	  |					 |   |
       |	  |					 |   |
       | offset   |					 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  integer		 |   |
       |	  |					 |   |
       |	  |  The byte position of  an  error  in |   |
       |	  | the  SQL  statement. If there was no |   |
       |	  | statement, this is 0		 |   |
       |	  |					 |   |
       |	  |					 |   |
       | sqltext  |					 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		   string		 |   |
       |	  |					 |   |
       |	  |  The SQL statement	text.  If  there |   |
       |	  | was  no  statement, this is an empty |   |
       |	  | string.				 |   |
       |	  |					 |   |
       +----------+--------------------------------------+---+
EXAMPLES

       Example #1

	      Displaying the Oracle error message after a connection error

	      <?php
	      $conn = oci_connect("hr", "welcome", "localhost/XE");
	      if (!$conn) {
		  $e = oci_error();   // For oci_connect errors do not pass a handle
		  trigger_error(htmlentities($e['message']), E_USER_ERROR);
	      }
	      ?>

       Example #2

	      Displaying the Oracle error message after a parsing error

	      <?php
	      $stid = oci_parse($conn, "select ' from dual");  // note mismatched quote
	      if (!$stid) {
		  $e = oci_error($conn);  // For oci_parse errors pass the connection handle
		  trigger_error(htmlentities($e['message']), E_USER_ERROR);
	      }
	      ?>

       Example #3

	      Displaying the Oracle error message, the problematic statement, and the position of the problem of an execution error

	      <?php
	      $stid = oci_parse($conn, "select does_not_exist from dual");
	      $r = oci_execute($stid);
	      if (!$r) {
		  $e = oci_error($stid);  // For oci_execute errors pass the statement handle
		  print htmlentities($e['message']);
		  print "
<pre>
";
		  print htmlentities($e['sqltext']);
		  printf("
%".($e['offset']+1)."s", "^");
		  print  "
</pre>
";
	      }
	      ?>

PHP Documentation Group 													      OCI_ERROR(3)