promessaging::MRS - promessaging MRS SOAP client module
use promessaging::MRS; $mrs_object = promessaging::MRS->new(); $result = $mrs_object->MSISDNResolve($userid, $password, $serviceprofile, $msisdn); $servererror = $mrs_object->getError();
The following methods are provided by the promessaging::MRS class:
new
$mrs_object = promessaging::MRS->new();
Creates and returns a new MRS-object. Returns 0 if an error occured.
MSISDNResolve
$result = $mrs_object->MSISDNResolve($userid, $password, $serviceprofile, $msisdn); $result = $mrs_object->MSISDNResolve($userid, $password, $serviceprofile, $msisdn, $retries, $interval_timeout, $interval_na);
Performs a SOAP-request.
Parameter description: - $userid: promessaging user-id (required) - $password: promessaging password (required) - $serviceprofile: promessaging service-profile (required) - $msisdn: GSM number (required) - $retries: number of retries if request fails (optional, default is zero) - $interval_timeout: seconds between retries if the error is a timeout on server-side (optional, default is zero) - $interval_na: seconds between retries if the service is not available (optional, default is 300)
MSISDNResolve returns: - a hash if the SOAP-request was successful: $return->{"response"} if subscriber is available or $return->{"faultcode"} and $return->{"faultstring"} if the server returned a fault - a number less than zero if a transport/server-error occured.
getError
$errstr = $mrs_object->getError();
Returns a string which describes the transport/server-error.
get_xml_request
$xml = $mrs_object->get_xml_request();
Returns the XML which was sent to the SOAP-server.
get_xml_response
$xml = $mrs_object->get_xml_response();
Returns the XML which was received by the SOAP-server.
MRS.pm provides the capibility to resolve the MCC (Mobile Country Code) and MNC (Mobile Network Code) for a given MSISDN (Mobile Station International ISDN Number, see E.164) of a mobile subscriber. Based upon information the service also delivers detailed data about the name of the home operator, country, timezone and other data.
Also additional information about the on/offline status of the mobile subscriber and its current location (on country basis) can be retrieved depending on the provisioned service profile.
The service (MSISDN Resolver Service) is built as a client/server achitecture based on the Simple Object Access Protocol (SOAP), the client exchanges with the server XML-encapsulated data transfered via HTTP.
The MRS client submits a request to the server and in return receives the needed information or a exception if a failure or error occurs.
The MRS server will process the query and try to lookup the subscriber via its direct SS7 access to MNOs (Mobile Network Operator) worldwide. If the subscriber does exist the MRS server will send the data back to the client or an exception if the subscriber is unknown or not reachable for other reasons.
Long description
Missing promessaging userid
Missing promessaging password
Missing MSISDN (international format)
Missing Service Profile
Wrong value in parameter MSISDN
The requesting promessaging account is not allowed to use this service
Unknown promessaging user
Invalid promessaging user
Invalid promessaging password
The requesting promessaging account is not allowed to use this service profile
The requested MSISDN does not exist
The requested MSISDN is absent
An unspecified/generic error occured, End2End administrators will be informed
Timeout on HLR lookup
Teleservice not provisioned
Call bared
CUG-reject
Facility not supported
System failure
Data missing
Unexpected data value
The MRS service is not available at the moment
The MRS.pm module is property of End2End Denmark (E2E). Copyright End2End Denmark. All rights reserved.
Support & Information
hotline@end2endmobile.com for general/technical enquiries or search http://www.end2endmobile.com
MRS.pm by Peter Friedrich
POD by Christian Malter
1 POD Error
The following errors were encountered while parsing the POD:
You forgot a '=back' before '=head1'
To install promessaging::MRS, copy and paste the appropriate command in to your terminal.
cpanm
cpanm promessaging::MRS
CPAN shell
perl -MCPAN -e shell install promessaging::MRS
For more information on module installation, please visit the detailed CPAN module installation guide.