MAP Programmer's Manual
Total Page:16
File Type:pdf, Size:1020Kb
Dialogic® DSI Protocol Stacks MAP Programmer's Manual September 2018 U14SSS www.dialogic.com Section 1 Introduction Copyright and Legal Notice Copyright © 1991-2018 Dialogic Corporation. All Rights Reserved. You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation at the address provided below. All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation and its affiliates or subsidiaries (“Dialogic”). Reasonable effort is made to ensure the accuracy of the information contained in the document. However, Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors, inaccuracies or omissions that may be contained in this document. INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN A SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC, DIALOGIC ASSUMES NO LIABILITY WHATSOEVER, AND DIALOGIC DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY. Dialogic products are not intended for use in certain safety-affecting situations. Please see http://www.dialogic.com/company/terms-of-use.aspx for more details. Due to differing national regulations and approval requirements, certain Dialogic products may be suitable for use only in specific countries, and thus may not function properly in other countries. You are responsible for ensuring that your use of such products occurs only in the countries where such use is suitable. For information on specific products, contact Dialogic Corporation at the address indicated below or on the web at www.dialogic.com. It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties. Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic. More detailed information about such intellectual property is available from Dialogic’s legal department at 3300 Boulevard de la Côte-Vertu, Suite 112, Montreal, Quebec, Canada H4R 1P8. Dialogic encourages all users of its products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and disclaims any responsibility related thereto. These intellectual property licenses may differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements. Dialogic, Dialogic Pro, Veraz, Brooktrout, Diva, BorderNet, PowerMedia, PowerVille, PowerNova, MSaaS, ControlSwitch, I-Gate, Cantata, TruFax, SwitchKit, Eiconcard, NMS Communications, SIPcontrol, Exnet, EXS, Vision, inCloud9, and NaturalAccess, among others as well as related logos, are either registered trademarks or trademarks of Dialogic Corporation and its affiliates or subsidiaries. Dialogic's trademarks may be used publicly only with permission from Dialogic. Such permission may only be granted by Dialogic’s legal department at 3300 Boulevard de la Côte-Vertu, Suite 112, Montreal, Quebec, Canada H4R 1P8. Any authorized use of Dialogic's trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic’s trademarks requires proper acknowledgement. The names of actual companies and products mentioned herein are the trademarks of their respective owners. Publication Date: September 2018 Document reference: U14SSS 2 MAP Programmer's Manual Issue 27 REVISION HISTORY ISSUE DATE CHANGES 27 07-Sep-18 MAP-SS-INVOCATION-NOTIFY service added. MAPPN_pdn_gw_name parameter maximum length is now 255. Report Cause may now be reported by OPEN-CNF message. 26 25-Jul-17 Parameter added to MAP-SEND-ROUTING-INFO request. Added Extension Container parameters. MAPPN_long_fwd_to_num value corrected. Version and parameter information updated for USSD services. 25 24-Mar-17 MAP-SEND-ROUTING-INFO-FOR-SM service updated to MAP Release 14. Index of Supported MAP Services added (Appendix D). Added MAPSWE_MISMATCH_USER_PRIM error code. Added MAPPN_dialog_abort_type parameter. The MAPPN_user_rsn parameter is now optional for User Aborts. 24 17-Feb-17 MAP-ANY-TIME-INTERROGATION, MAP-SEND-ROUTING-INFO, MAP-PROVIDE- SUBSCRIBER-INFO and MAP-NOTEMM-EVENT services updated to support MAP release 14 Specifications. Correction to LongForwardToNumber parameter used for MAP-SEND-ROUTING- INFO (v3) and MAP-RESUME-CALL-HANDLING services. Service Request tables renamed in document. 23 17-Oct-16 Update to support extended MAPPN_QOS parameter. Added MAPPN_cpt_indicator parameter. MAP-UPDATE-LOCATION and MAP-RESTORE-DATA services updated to support MAP release 5 Specification. Updated lengths of MSC and SGSN number parameters. 22 29-Apr-15 Maximum total configurable dialog range increased to 1M dialogs. MAP_MSG_CONFIG message now uses version 1 format. Added MAPF_EXT_DID option and MAPPN_DID parameter. Added MAPPN_DIALOG_TYPE parameter. Added MAPPN_dlg_idle_timeout parameter. 21 11-Sep-14 Added the proprietary UPDATE-DEVICE-CONFIGURATION service. Added parameters for LocationInformationEPS table. Added options to control default TCAP QoS. 20 31-Jul-14 Added Routing Indicator ID (RIID) parameter. Added parameters for MAP-SUBSCRIBER-LOCATION-REPORT and MAP-SEND- ROUTING-INFO-FOR-LCS services. Authentication set parameters revised and their reception corrected when TCAP- Segmentation is used. Diameter Identity parameter allows 255 characters. MAP User parameters greater than 255 octets are now allowed using the Code Shift parameter. Update explanation of ExternalSignalInfo type parameters. 19 03-Apr-13 CurrentSecurityContext data added to MAP-SEND-IDENTIFICATION service. 18 22-Feb-13 Parameters added to MAP-UPDATE-GPRS-LOCATION, MAP-CANCEL-LOCATION and MAP-PURGE-MS services. Parameters added to SEND-AUTHENTICATION-INFO service to support EPS. Corrected document which erroneously indicated that MAP incoming user dialogue IDs should have the most significant bit set. 3 Section 1 Introduction 17 17-Aug-12 MAP-NOTIFY-SUBSCRIBER-DATA-MODIFIED service added. ProvideSubscriberLocation service updated to add more parameters. Additions to MAP-V3 error parameters for some services. Check_IMEI parameter MAPPN_requestedequipinfo made optional. Update possible errors for ProvideSubscriberLocation. Indicate that REPORT-SM-DELIVERY-STATUS can have errors for V1 and V2. 16 29-Feb-12 Make clear the operations where the ‘net_sig_info’ and ‘network_sig_info’ parameters are used. Clarify use of MAPPN_diag_info parameter. Added parameters to INFORM-SERVICE-CENTRE, READY-FOR-SM, SEND- ROUTING-INFO-FOR-SM and REPORT-SM-DELIVERY-STATUS. Documented use of ASN.1 BIT STRING parameters. Added provider reason for Idle Timeout. 15 26-Jul-11 Added documentation on use of MSISDN and Alerting Pattern parameters for USSR, USSN and PUSSR services. Mandatory parameter information for service responses updated. MAPSWE_USER_INVOKE_ID_UNKNOWN error code added. Changed UESBI parameter range now 1 to 16. Parameters added to return REJECT component data to the MAP-User. All Selective Trace events are enabled after configuration. 14 21-Jun-10 Support for GET_PASSWORD and REGISTER_PASSWORD services under MAP v1. Configuration option flags added - MAPF_QOS_TRANSPARENT and MAPF_NO_IND_AFTER_NOTICE Corrections to parameter definitions. 13 19-Oct-09 Support for INTERROGATE-SS service under MAP v1. 12 13-Jul-09 Support for SEND-AUTHENTICATION-INFO, ANY-TIME-MODIFICATION, RESET, SET-REPORTING-STATE, STATUS-REPORT, REMOTE-USER-FREE, REGISTER-CC- ENTRY and ERASE-CC-ENTRY services. Added parameters to ANY-TIME-INTERROGATION-ACK, PROVIDE-SUBSCRIBER- INFO-ACK and SEND-ROUTING-INFO-ACK. Additional Configuration Trace information. 11 30-Sep-08 Updates to trace mask definitions Support for MAP Handover Services MAP-PREPARE-HANDOVER, MAP-PREPARE- SUBSEQUENT-HANDOVER- MAP-PROCESS-ACCESS-SIGNALLING, MAP- FORWARD-ACCESS-SIGNALLING and MAP-AUTHENTICATE-FAILURE-REPORT V3 Support for CHECK IMEI operation Added Application Context Negotiation documentation 10 25-Feb-08 Added new messages Network Context Configuration Request and Read Module Status, V3 Support for MAP-SEND-AUTHENTICATION-INFO operation. New status in confirmation messages and new Software error indications Support for MAP-SEND-PARAMETERS, MAP-ACTIVATE-TRACE-MODE, MAP- DEACTIVE-TRACE-MODE and MAP-TRACE-SUBSCRIBER-ACTIVITY operations. Updated document for MAP-FAILURE-REPORT, MAP-FORWARD-CHECK-SS- INDICATION, MAP-NOTE-MS-PRESENT-FOR-GPRS and MAP-PURGE-MS operations. 9 17-Jun-05 Support for MAP-CHECK-IMEI, MAP-PROVIDE-SUBSCRIBER-LOCATION, MAP- SUBSCRIBER-LOCATION-REPORT, MAP-ACTIVATE-SS, MAP-DEACTIVATE-SS, MAP-REGISTER-SS, MAP-ERASE-SS,