mqseries_put

(PECL mqseries >= 0.10.0)

mqseries_putMQSeries MQPUT

Beschreibung

mqseries_put ( resource $hConn , resource $hObj , array &$md , array &$pmo , string $message , resource &$compCode , resource &$reason ) : void

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

Parameter-Liste

hConn

Connection handle.

This handle represents the connection to the queue manager.

hObj

Object handle.

This handle represents the object to be used.

md

Message descriptor (MQMD).

pmo

Put message options (MQPMO).

message

The actual message to put onto the queue.

compCode

Completion code.

reason

Reason code qualifying the compCode.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Beispiele

Beispiel #1 mqseries_put() 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>\n"$comp_code$reasonmqseries_strerror($reason));
    }

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

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

Siehe auch