mqseries_get

(PECL mqseries >= 0.10.0)

mqseries_get — MQGET MQSeries

Descrição

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

A chamada mqseries_get() (MQGET) recupera uma mensagem de uma fila local que foi aberta usando a chamada mqseries_open() (MQOPEN).

Parâmetros

hConn

Identificador de conexão.

Este identificador representa a conexão ao gerenciador de filas.

hObj

Identificador de objeto.

Este identificador representa o objeto a ser usado.

md

Descritor de mensagem (MQMD).

gmo

Opções de mensagem de obtenção (MQGMO).

bufferLength

Comprimento esperado do buffer de resultado.

msg

Buffer contendo a mensagem que foi recuperada do objeto.

data_length

Comprimento real do buffer.

compCode

Código de conclusão.

reason

Código de razão que qualifica o código de conclusão.

Valor Retornado

Nenhum valor é retornado.

Examples

Exemplo #1 Exemplo de mqseries_get() 

<?php
// abre conexão com o gerenciador de filas
    mqseries_conn('WMQ1', $conn, $comp_code, $reason);
// $conn agora contém a referência à conexão com o gerenciador de filas

// abre a conexão com a fila 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 agora contém a referência ao objeto (TESTQ)

// configura um descritor de mensagem vazio
    $mdg = array();
// configura opções de recebimento de mensagens
    $gmo = array('Options' => MQSERIES_MQGMO_FAIL_IF_QUIESCING | MQSERIES_MQGMO_WAIT, 'WaitInterval' => 3000);

// recebe a mensagem da fila
    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));
    }

// fecha a referência do objeto $obj
    mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);

// desconecta do gerenciador de filas
    mqseries_disc($conn, $comp_code, $reason);

?>

Veja também

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
＋adicionar nota

Notas de Usuários

Não há notas de usuários para esta página.