array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.mqseries-get.php', 1 => 'mqseries_get', 2 => 'MQSeries MQGET', ), 'up' => array ( 0 => 'ref.mqseries.php', 1 => 'Funciones de mqseries', ), 'prev' => array ( 0 => 'function.mqseries-disc.php', 1 => 'mqseries_disc', ), 'next' => array ( 0 => 'function.mqseries-inq.php', 1 => 'mqseries_inq', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mqseries/functions/mqseries-get.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mqseries_get

(PECL mqseries >= 0.10.0)

mqseries_get — MQSeries MQGET

Descripción

mqseries_get(
    resource $hConn,
    resource $hObj,
    array &$md,
    array &$gmo,
    int &$bufferLength,
    string &$msg,
    int &$data_length,
    resource &$compCode,
    resource &$reason
): void

mqseries_get() lee un mensaje de una cola local, que ha sido abierta con la función mqseries_open().

Parámetros

hConn
Gestor de conexión. Este recurso representa la conexión al gestor de colas.
hObj
Gestor de objeto. Este recurso representa el objeto a utilizar.
md
Recurso de mensaje (MQMD).
gmo
Opciones de mensaje
bufferLength
Tamaño esperado del buffer de resultado
msg
Buffer que contiene el mensaje leído desde el objeto.
data_length
Tamaño real del buffer
compCode
Código de finalización.
reason
La razón que califica el compCode.

Valores devueltos

No se retorna ningún valor.

Ejemplos

Ejemplo #1 Ejemplo con mqseries_get()

<?php
// Abre la conexión hacia el gestor de colas
mqseries_conn('WMQ1', $conn, $comp_code, $reason);
// $conn contiene ahora la referencia a la conexión al gestor de colas.

// Abre la conexión hacia la cola de prueba testq
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 contiene ahora la referencia al objeto (TESTQ)

// Define un descriptor de mensaje vacío.
$mdg = array();
// Define las opciones de recuperación de mensajes
$gmo = array('Options' => MQSERIES_MQGMO_FAIL_IF_QUIESCING | MQSERIES_MQGMO_WAIT, 'WaitInterval' => 3000);

// Recupera los mensajes desde la cola
mqseries_get($conn, $obj, $mdg, $gmo, 255, $msg, $data_length, $comp_code, $reason);
if ($comp_code !== MQSERIES_MQCC_OK) {
printf("GET CompCode:%d Reason:%d Text:%s<br>", $comp_code, $reason, mqseries_strerror($reason));
}

// Cierra la referencia al objeto $obj
mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);

// Desconecta del gestor de colas
mqseries_disc($conn, $comp_code, $reason);

?>

Ver también