PHP Conference Nagoya 2025

mqseries_strerror

(PECL mqseries >= 0.10.0)

mqseries_strerrorReturns the error message corresponding to a result code (MQRC)

Description

mqseries_strerror(int $reason): string

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.

add a note

User Contributed Notes 1 note

up
-2
j dot romero dot 1214 at gmail dot com
11 years ago
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 ...
?>
To Top