PHP 7.0.6 Released

mqseries_strerror

(PECL mqseries >= 0.10.0)

mqseries_strerrorReturns 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$reasonmqseries_strerror($reason));
        exit;
    }
?>

The above example will output:

Connx CompCode:2 Reason:2059 Text:Queue manager not available for connection.                    

User Contributed Notes

j dot romero dot 1214 at gmail dot com
3 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