dismiss Step into the future! Click here to switch to the beta php.net site
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

Network> <mqseries_set
[edit] Last updated: Fri, 28 Jun 2013

view this page in

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.                    



add a note add a note User Contributed Notes mqseries_strerror - [1 notes]
up
0
j dot romero dot 1214 at gmail dot com
5 months 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 ...
?>

 
show source | credits | stats | sitemap | contact | advertising | mirror sites