(PECL mqseries >= 0.10.0)
mqseries_put — MQSeries MQPUT
$hConn
, resource $hObj
, array &$md
, array &$pmo
, string $message
, resource &$compCode
, resource &$reason
)mqseries_put() ajoute un message dans une queue, ou une liste de distribution. La queue ou la liste de distribution doivent être ouvertes.
hConn
Gestionnaire de connexion.
Cette ressource représente la connexion au manager de queues.
hObj
Object handle.
Cette ressource représente l'objet à utiliser.
md
Ressource de message (MQMD).
pmo
Option d'ajout de message
message
Le message à mettre dans la queue.
compCode
Code de complétion.
reason
La raison qui qualifie le compCode.
Aucune valeur n'est retournée.
Exemple #1 Exemple avec mqseries_put()
<?php
// Ouvre une connexion vers le gestionnaire de file d'attente
mqseries_conn('WMQ1', $conn, $comp_code, $reason);
// $conn contient maintenant la référence vers la connexion au gestionnaire de file d'attente.
// Ouvre la connexion vers la file d'attente 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 contient maintenant la référence vers l'objet (TESTQ)
// Définit le tableau de description du message. Vérifie manuellement les références à MQSeries.
$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);
// Définit les options de transmission des messages.
$pmo = array('Options' => MQSERIES_MQPMO_NEW_MSG_ID|MQSERIES_MQPMO_SYNCPOINT);
// Place la message 'Ping' dans la file d'attente.
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, $reason, mqseries_strerror($reason));
}
// Ferme la référence à l'objet $obj
mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);
// Déconnecte le gestionnaire de file d'attente.
mqseries_disc($conn, $comp_code, $reason);
?>