php man page for yaz_es

YAZ_ES(3)								 1								 YAZ_ES(3)

yaz_es - Prepares for an Extended Service Request

SYNOPSIS
       void yaz_es (resource  $id, string  $type, array  $args)

DESCRIPTION
	This  function	prepares for an Extended Service Request. Extended Services is family of various Z39.50 facilities, such as Record Update,
       Item Order, Database administration etc.

       Note

	       Many Z39.50 Servers do not support Extended Services.

	The yaz_es(3) creates an Extended Service Request packages and puts it into a queue of operations. Use yaz_wait(3) to send the	request(s)
       to  the	server.  After	completion  of	yaz_wait(3)  the  result  of  the  Extended  Service  operation  should be expected with a call to
       yaz_es_result(3).

PARAMETERS
	      o $id
		- The connection resource returned by yaz_connect(3).

	      o $type
		- A string which represents the type of the Extended Service: itemorder (Item Order), create (Create Database), drop  (Drop  Data-
		base), commit (Commit Operation), update (Update Record), xmlupdate (XML Update). Each type is specified in the following section.

	      o $args
		- An array with extended service options plus package specific options. The options are identical to those offered in the C API of
		ZOOM C. Refer to the ZOOM Extended Services.

RETURN VALUES
	No value is returned.

EXAMPLES
       Example #1

	      Record Update

	      <?php
	      $con = yaz_connect("myhost/database");
	      $args = array (
		  "record" => "<gils><title>some title</title></gils>",
		  "syntax" => "xml",
		  "action" => "specialUpdate"
	      );
	      yaz_es($con, "update", $args);
	      yaz_wait();
	      $result = yaz_es_result($id);
	      ?>

SEE ALSO
       yaz_es_result(3).

PHP Documentation Group 														 YAZ_ES(3)