PHP Manual
Prev |  | Next

# yaz_es

(PECL)

yaz_es -- Prepares for an Extended Service Request

## Description

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

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

> Note: Many Z39.50 Servers do not support Extended Services.

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

## Parameters

id

  The connection resource returned by yaz_connect().

type

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

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()

Prev | Home | Next
yaz_es_result | Up | yaz_get_option