mqseries_strerror
(PECL mqseries >= 0.10.0)
mqseries_strerror — Returns the error message corresponding to a result code (MQRC).
Description
string mqseries_strerror
( int
$reason
)mqseries_strerror() returns the message that correspond to the reason result code.
Parameters
-
reason -
Reason code qualifying the compCode.
Return Values
string representation of the reason code message.
Examples
Example #1 mqseries_strerror() example
<?php
if ($comp_code !== MQSERIES_MQCC_OK) {
printf("open CompCode:%d Reason:%d Text:%s<br>\n", $comp_code, $reason, mqseries_strerror($reason));
exit;
}
?>
The above example will output:
Connx CompCode:2 Reason:2059 Text:Queue manager not available for connection.
Коментарии
There might be some error codes missing from the package depending on the MQ client version you are using. To prevent further versions from returning an empty error message simply use a function such as:
<?php
//... wrapper class ...
public function getErrorMessage ($errorCode) {
$errorString = mqseries_strerror($errorCode);
if (!empty($errorString)) {
return $errorString;
} else {
switch ($errorCode) {
// insert missing codes here
case 2537:
return "Channel is not available.";
case 2538:
return "Host is not available.";
case 2539:
return "Channel configuration error.";
case 2540:
return "Channel name is unknown.";
default:
return "Unexpected error ({$errorCode})";
}
}
}
// ... wrapper class ...
?>