mqseries mqseries_get
(PECL mqseries >= 0.10.0)
mqseries_get — MQSeries MQGET
설명
mqseries_get( resource $hConn, resource $hObj, array &$md, array &$gmo, int &$bufferLength, string &$msg, int &$data_length, resource &$compCode, resource &$reason ): void
mqseries_get()(MQGET) 호출은 mqseries_open()(MQOPEN) 호출을 사용하여 열린 로컬 큐에서 메시지를 검색합니다.
매개변수
hConn
- 연결 핸들입니다.
이 핸들은 큐 관리자에 대한 연결을 나타냅니다.
hObj
- 개체 핸들입니다.
이 핸들은 사용할 개체를 나타냅니다.
md
- Message descriptor (MQMD).
gmo
- Get message options (MQGMO).
bufferLength
- 결과 버퍼의 예상 길이
msg
- 개체에서 검색된 메시지를 보유하는 버퍼입니다.
data_length
- 실제 버퍼 길이
compCode
- 완료 코드.
reason
- compCode를 규정하는 이유 코드.
반환 값
값이 반환되지 않습니다.
Examples
예제 #1 mqseries_get() 예제
<?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 connection to the testq queue
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 empty message descriptor.
$mdg = array();
// setup get message options
$gmo = array('Options' => MQSERIES_MQGMO_FAIL_IF_QUIESCING | MQSERIES_MQGMO_WAIT, 'WaitInterval' => 3000);
// get the message from the queue
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));
}
// close the object reference $obj
mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);
// disconnect from the queue manager.
mqseries_disc($conn, $comp_code, $reason);
?>
기타
- mqseries_conn() - MQSeries MQCONN
- mqseries_connx() - MQSeries MQCONNX
- mqseries_open() - MQSeries MQOPEN
- mqseries_put() - MQSeries MQPUT