ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice. This document is provided "as is," and all express, implied, or statutory warranties, representations or conditions are disclaimed. Your opinion is great value and will help us improve the quality of our product documentation and offer better services to our customers.
Original Description:
Original Title
Sjzl20072522-ZXSS10 SS1b SoftSwitch Control Equipment Billing Command User Manual_161458
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice. This document is provided "as is," and all express, implied, or statutory warranties, representations or conditions are disclaimed. Your opinion is great value and will help us improve the quality of our product documentation and offer better services to our customers.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice. This document is provided "as is," and all express, implied, or statutory warranties, representations or conditions are disclaimed. Your opinion is great value and will help us improve the quality of our product documentation and offer better services to our customers.
Billing Command User Manual Version 1.01.50 ZTE CORPORATION ZTE Plaza, Keji Road South, Hi-Tech Industrial Park, Nanshan District, Shenzhen, P. R. China 518057 Tel: (86) 755 26771900 800-9830-9830 Fax: (86) 755 26772236 URL: http://support.zte.com.cn E-mail: doc@zte.com.cn
LEGAL INFORMATION
Copyright 2007 ZTE CORPORATION.
The contents of this document are protected by copyright laws and international treaties. Any reproduction or distribution of this document or any portion of this document, in any form by any means, without the prior written consent of ZTE CORPORATION is prohibited. Additionally, the contents of this document are protected by contractual confidentiality obligations.
All company, brand and product names are trade or service marks, or registered trade or service marks, of ZTE CORPORATION or of their respective owners.
This document is provided as is, and all express, implied, or statutory warranties, representations or conditions are disclaimed, including without limitation any implied warranty of merchantability, fitness for a particular purpose, title or non-infringement. ZTE CORPORATION and its licensors shall not be liable for damages resulting from the use of or reliance on the information contained herein.
ZTE CORPORATION or its licensors may have current or pending intellectual property rights or applications covering the subject matter of this document. Except as expressly provided in any written license between ZTE CORPORATION and its licensee, the user of this document shall not acquire any license to the subject matter herein.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice.
Users may visit ZTE technical support website http://ensupport.zte.com.cn to inquire related information.
The ultimate right to interpret this product resides in ZTE CORPORATION.
Revision History Date Revision No. Serial No. Reason for Issue Sep. 16, 2007 R1.0 sjzl20072522 Product upgrading
ZTE CORPORATION Values Your Comments & Suggestions! Your opinion is of great value and will help us improve the quality of our product documentation and offer better services to our customers. Please fax to (86) 755-26772236 or mail to Documentation R&D Department, ZTE CORPORATION, ZTE Plaza, A Wing, Keji Road South, Hi-Tech Industrial Park, Shenzhen, P. R. China 518057. Thank you for your cooperation! Document Name ZXSS10 SS1b SoftSwitch Control Equipment Billing Command User Manual Product Version V1.01.50 Document Revision Number R1.0 Serial No. sjzl20072522 Equipment Installation Date
Presentation: (Introductions, Procedures, Illustrations, Completeness, Level of Detail, Organization, Appearance) Good Fair Average Poor Bad N/A Accessibility: (Contents, Index, Headings, Numbering, Glossary) Good Fair Average Poor Bad N/A Your evaluation of this documentation I ntelligibility: (Language, Vocabulary, Readability & Clarity, Technical Accuracy, Content) Good Fair Average Poor Bad N/A Your suggestions for improvement of this documentation Please check the suggestions which you feel can improve this documentation: Improve the overview/introduction Make it more concise/brief Improve the Contents Add more step-by-step procedures/tutorials Improve the organization Add more troubleshooting information Include more figures Make it less technical Add more examples Add more/better quick reference aids Add more detail Improve the index Other suggestions __________________________________________________________________________ __________________________________________________________________________ __________________________________________________________________________ __________________________________________________________________________ __________________________________________________________________________ # Please feel free to write any comments on an attached sheet. If you wish to be contacted regarding your comments, please complete the following: Name Company Postcode Address Telephone E-mail This page is intentionally blank.
Contents
About This Manual ............................................................ i Purpose................................................................................ i Intended Audience ................................................................. i Prerequisite Skill and Knowledge.............................................. i What Is in This Manual ........................................................... i Conventions......................................................................... ii How to Get in Touch.............................................................. ii Declaration of RoHS Compliance..................................... v Chapter 1.......................................................................... 1 Common Billing Commands............................................. 1 Ordinary User Subscription Command (4210)............................ 1 SIP User Subscription Command (4190)................................. 10 SIP User Subscription Command (in Batch) (7299) .................. 12 User Deletion Command (4206) ............................................ 14 User Suspension Command (4209)........................................ 16 Parameters ........................................................................ 16 Service Access Command (4208) .......................................... 17 User Call Authority Modification Command (4204) ................... 18 Owing Fee Service Access/Suspension Command (4202) .......... 19 Number Change Command (Playing Announcement or Not Selection and Changing to Local or Non-Local Office Selection) (4202) .............................................................................. 21 Announcement Play Record Deletion Command (4054) (Number Change Announcement Cancellation) ..................................... 23 Not Ready for Service Command (4202)................................. 24 Public Telephone Billing Command (Polarity Reversal Function or 16Kc Billing Function) (4202)................................................ 25 Call Restriction Group Modification Command (4202) ............... 27 Commercial Group User Addition Command (Ordinary Call to Centrex Group Call Conversion Command) (4233) ................... 28 Commercial Group User Deletion Command (Group Call to Ordinary Call Conversion Command) (4234) ........................... 29 Ordinary User to ISDN User Conversion Command (4272).........30 ISDN User to Ordinary User Conversion Command (4274).........32 Parameters.........................................................................32 Ordinary Service Registration Command (4302).......................32 Ordinary Service Deletion Command (4303)............................33 MSN/DDI Service of ISDN User Creation Command (7324)........34 MSN/DDI Service of ISDN User Deletion Command (7326) ........34 Telephone Removal Command (7289) ....................................35 Ordinary User to V5 User Conversion Command (4835) ............37 V5 User to Ordinary User Conversion Command (4837) ............38 Chapter 2........................................................................41 Appendix ........................................................................41 Meaning of Service Enumeration Value (Corresponding to the TYPE Parameter of Ordinary Subscription Command) .......................41 Definition of Call Authority Enumeration .................................43 Figures............................................................................45 Tables.............................................................................47
About This Manual
Purpose This manual describes the frequently used billing commands on the ZXSS10 SS1b SoftSwitch Control Equipment. Intended Audience This manual is intended for engineers and technicians who perform operational activities on the ZXSS10 SS1b SoftSwitch Control Equipment. Prerequisite Skill and Knowledge To use this document effectively, users must have a general understanding of SoftSwitch technology. Familiarity with following aspects is helpful. ZXSS10 SoftSwitch system and its components ZXSS10 SoftSwitch interfaces ZXSS10 SoftSwitch hardware and software architecture What Is in This Manual This manual contains the following chapters: TAB L E 1 CHA PTER SUMMARY Chapter Summary Chapter 1, Common Billing Commands Describes the common billing commands in terms of their format, function and related parameters. Chapter 2, Appendix Describes the meaning of service enumeration value and Definition of call authority enumeration. Confidential and Proprietary Information of ZTE CORPORATION i
ZXSS10 SS1b SoftSwitch Control Equipment Billing Command User Manual
Conventions ZTE documents employ the following typographical conventions. Typographical Conventions TAB L E 2 TYPOGRAPHI CAL CONVENTI ONS Typeface Meaning Italics References to other Manuals and documents. Quotes Links on screens. Bold Menus, menu options, function names, input fields, radio button names, check boxes, drop- down lists, dialog box names, window names. CAPS Keys on the keyboard and buttons on screens and company name. Const ant wi dt h Text that you type, program code, files and directory names, and function names. [ ] Optional parameters. { } Mandatory parameters. | Select one of the parameters that are delimited by it. Note: Provides additional information about a certain topic.
Mouse Operation Conventions TAB L E 3 MOUSE OPERATI ON CONVENTI ONS Typeface Meaning Click Refers to clicking the primary mouse button (usually the left mouse button) once. Double-click Refers to quickly clicking the primary mouse button (usually the left mouse button) twice. Right-click Refers to clicking the secondary mouse button (usually the right mouse button) once. Drag Refers to pressing and holding a mouse button and moving the mouse.
How to Get in Touch The following sections provide information on how to obtain support for the documentation and the software. Customer Support If you have problems, questions, comments, or suggestions regarding your product, contact us by e-mail at ii Confidential and Proprietary Information of ZTE CORPORATION
About This Manual
support@zte.com.cn. You can also call our customer support center at (86) 755 26771900 and (86) 800-9830-9830. ZTE welcomes your comments and suggestions on the quality and usefulness of this document. For further questions, comments, or suggestions on the documentation, you can contact us by e-mail at doc@zte.com.cn; or you can fax your comments and suggestions to (86) 755 26772236. You can also browse our website at http://support.zte.com.cn, which contains various interesting subjects like documentation, knowledge base, forum and service request. Documentation Support Confidential and Proprietary Information of ZTE CORPORATION iii
ZXSS10 SS1b SoftSwitch Control Equipment Billing Command User Manual
This page is intentionally blank. iv Confidential and Proprietary Information of ZTE CORPORATION
Declaration of RoHS Compliance
To minimize the environmental impact and take more responsibility to the earth we live, this document shall serve as formal declaration that the ZXSS10 SS1b SoftSwitch Control Equipment manufactured by ZTE CORPORATION are in compliance with the Directive 2002/95/EC of the European Parliament - RoHS (Restriction of Hazardous Substances) with respect to the following substances: Lead (Pb) Mercury (Hg) Cadmium (Cd) Hexavalent Chromium (Cr (VI)) PolyBrominated Biphenyls (PBBs) PolyBrominated Diphenyl Ethers (PBDEs)
The ZXSS10 SS1b SoftSwitch Control Equipment manufactured by ZTE CORPORATION meet the requirements of EU 2002/95/EC; however, some assemblies are customized to client specifications. Addition of specialized, customer-specified materials or processes which do not meet the requirements of EU 2002/95/EC may negate RoHS compliance of the assembly. To guarantee compliance of the assembly, the need for compliant product must be communicated to ZTE CORPORATION in written form. This declaration is issued based on our current level of knowledge. Since conditions of use are outside our control, ZTE CORPORATION makes no warranties, express or implied, and assumes no liability in connection with the use of this information. Confidential and Proprietary Information of ZTE CORPORATION v
ZXSS10 SS1b SoftSwitch Control Equipment Billing Command User Manual
This page is intentionally blank. vi Confidential and Proprietary Information of ZTE CORPORATION
Ch a p t e r 1 Common Billing Commands
Ordinary User Subscription Command (4210) CREATE_XML_SDN:NET=?,LATA=?,SDN1=?,SDN2=?,DEVCODE= ?,IPADDR=?,DEVSTYLE=?,ATTRMOD=?,UNIT=?,SUBUNIT=?,CIR CUITNO=?,TYPE=?,PORTID=?,ENRIGHTO=?,ENRIGHTI=?,NAME =?; Format This command is used to complete the ordinary user subscription function (aiming at users that accessed through the access gateway). When defining a subscriber, both call authority and type of service you wish to register can be customized. Function S N Type Name Descriptio n Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOAR D SDN1 Start number 2-40 Mandatory 4 STR\KEYBOAR D SDN2 End number 0-40 Optional 5 STR\STRING DEVCODE Gateway device code 0-25 Optional 6 STR\STRING IPADDR IP address 0-16 Optional 7 INT\DWORD PORTID Port number 0- 429496 7295 Optional Confidential and Proprietary Information of ZTE CORPORATION 1
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
S N Type Name Descriptio n Range Selection 8 INT\WORD DEVSTYLE Gateway type 0- 65535 Mandatory 9 INT\WORD ATTRMOD User template number 0- 65535 Optional 10 STR\STRING TYPE Service type 0-5 Optional 11 STR\STRING ENRIGHT O Activated outgoing call authority type 0-5 Optional 12 STR\STRING ENRIGHTI Activated incoming call authority type 0-5 Optional 13 INT\WORD UNIT Unit number 0- 65535 Optional 14 INT\WORD SUBUNIT Sub-unit number 0- 65535 Optional 15 INT\WORD CIRCUITN O Circuit number 0- 65535 Optional 16 STR\STRING NAME TID name 2-40 Optional Note: for all the above parameters, no default values. Parameter Description Parameter NET is customized by the subscriber. For example, 1 indicates China Telecom. LATA is area code. For example, the area code of Nanjing is 025. SDN1 and SDN2 are start number and end number respectively. SDN2 is used only when the subscription is performed in batch. IPADDR is the IP address of the terminal such as access gateway IAD or AG. DEVCODE is the device code (domain name, such as [202.202.202.202]) or MAC address (at this moment, the input format of the MAC address is MAC: 00:B0:D0:8F:D0:F0) of the terminal such as access gateway IAD or AG. Select one of the two parameters when defining a subscriber. The parameter selection here depends on the gateway certification mode. If the gateway has no certification (with not only the IP address, but also the domain name), then select parameter IPADDR. If the gateway is certificated with the MGCP domain name (has domain name without the IP address. At this moment, the protocol type of the node must be the MGCP protocol), select parameter DEVCODE with ordinary domain name format. If the gateway is certificated with the MAC address (only with the MAC address without the domain name and IP address, 2 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands and the gateway protocol type is H248), select parameter DEVCODE with the MAC address format. DEVSTYLE is the device type of the terminal, which used to identify a certain device such as MSG5200 or MSG7200. In the following figure, the device represented by a certain number can be queried. Note: With regard to the AG device type (such as MSG5200, which has the unit number and subunit number. Widths of the unit number, subunit number, and circuit cannot be 0. FI GURE 1 SCREEN OF DEVI CE TYPE CONFI GURATI ON
ATTRMOD is the user template number. The user template number represents the collection of the basic attributes of the user, including DAS, call authority template, billing category, and terminal properties. In the interface of the following figure, data of the user template can be queried. Confidential and Proprietary Information of ZTE CORPORATION 3
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
FI GURE 2 SCREEN OF USER TEMPL ATE CONFI GURATI ON
UNIT is the unit number of the AG device, SUBUNIT is the subunit number, CIRCUITNO is the circuit number (the minimum value is 0), and PORTID is the port number of terminals such as IAD, that is the TID of the subscriber line. If the access device of the subscriber is AG device, parameters UNIT, SUBUNIT, and CIRCUITNO are used. If the access device of the subscriber is IAD device, parameter PORTID is used. TYPE, the of the service type of users, is a multi-instance parameter (refer to appendix 1 for its meaning). ENRIGHTO, the enumeration value with outgoing call authority, is also a multi-instance parameter (refer to appendix 1 for its meaning). ENRIGHTI the enumeration value with incoming call authority, is also a multi-instance parameter. Both service type and call authority data are defined on the user template. If the data on the template cannot meet the special needs of users, these parameters are used to customize the service data or call authority data of users. In this command, only parameters NET, LATA, SDN1, DEVCODE (or IPADDR), DEVSTYLE, and PORTID (or UNIT, SUBUNIT, and CIRCUITNO) are mandatory. This command has the following automatic functions: creating the subscriber, node, TID (if accessed through AG, only the TID resources can be created without the creation of the RTP resources), protocol attributes (including packet template and defaulted attribute template) of the node, call authority template of users, and registering new services. All created users have the access gateway. The protocol types cover H248, H323 and MGCP. Precaution With regard to the AG device, this command does not support the cross-subunit subscription in batch. Therefore, the maximum 4 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands number of users in a batch of subscription is 32 (number of circuits in a subunit). Examples Adding an IAD Subscriber without Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,IPADDR=102.102.102.102,DEVS TYLE=3,ATTRMOD=1,TYPE=1&2&3,PORTID=1,ENRIGHTO= 1&2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 with the IP address of access gateway (IAD) is 102.102.102.102, the device type is 3, and user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. Adding an IAD Subscriber with MGCP Domain Name Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,DEVCODE=[102.102.102.102],D EVSTYLE=3,ATTRMOD=1,TYPE=1&2&3,PORTID=1,ENRIGH TO=1&2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 with the domain name of the access gateway (IAD) is [102.102.102.102], the device type is 3, and the user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. Adding an IAD Subscriber with MAC Address Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,DEVCODE= MAC:00:B0:D0:8F:D0:F0,DEVSTYLE=3,ATTRMOD=1,TYPE=1 &2&3,PORTID=1,ENRIGHTO=1&2&7,ENRIGHTI=3&4 &5; Meaning: Create users from No. 5550000 to No. 5550031 with the MAC address of the access gateway (IAD) is 00B0D08FD0F0, Confidential and Proprietary Information of ZTE CORPORATION 5
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
the device type is 3, and the user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. Adding an IAD Subscriber without the Access Gateway Information of the Subscriber on the SS CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,IPADDR=102.102.102.102,DEVS TYLE=3,ATTRMOD=1,TYPE=1&2&3,PORTID=1,ENRIGHTO= 1&2&7,ENRIGHTI=3&4&5; Example 1 Meaning: Create users from No. 5550000 to No. 5550031 with device type 3 and user template 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. On the SS, add a node configured with IP address 102.102.102.102, no certification, H248 protocol, and node device type 3. Example 2 CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,DEVCODE=[102.102.102.102],D EVSTYLE=3,ATTRMOD=1,TYPE=1&2&3,PORTID=1,ENRIGH TO=1&2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 configured with the device type 3 and user template 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. On the SS, add a node configured with domain name [102.102.102.102], MGCP domain name certification, MGCP protocol, and node device type 3. CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031,DEVCODE= MAC:00:B0:D0:8F:D0:F0,DEVSTYLE=3,ATTRMOD=1,TYPE=1 &2&3,PORTID=1,ENRIGHTO=1&2&7,ENRIGHTI=3&4 &5; Example 3 Meaning: Create users from No. 5550000 to No. 5550031 configured with device type 3 and user template 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the 6 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. No. 1 port of the gateway is occupied. On the SS, add a node configured with MAC address 00B0D08FD0F0, MAC address certification, H248 protocol, and node device type 3. Adding an AG Subscriber without Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031, IPADDR=102.102.102.102,DEVSTYLE=5,ATTRMOD=1,TYPE= 1&2&3,UNIT=1,SUBUNIT=1,CIRCUITNO=1,ENRIGHTO=1 &2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 with the IP address of the access gateway (AG) is 102.102.102.102, device type is 5, and user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. The No. 1 unit and the No.1 circuit of the No.1 subunit of the gateway are occupied.
Adding an AG Subscriber with MGCP Domain Name Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031, DEVCODE=[102.102.102.102],DEVSTYLE=5,ATTRMOD=1,TYP E=1&2&3,UNIT=1,SUBUNIT=1,CIRCUITNO=1,ENRIGHTO= 1&2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 with the IP domain name of the AG is [102.102.102.102], device type is 5, user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. The No. 1 unit and the No.1 circuit of the No.1 subunit of the gateway are occupied. Confidential and Proprietary Information of ZTE CORPORATION 7
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Adding an AG Subscriber with MAC Address Certification on the Access Gateway CREATE_XML_SDN:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031, DEVCODE=MAC:00:B0:D0:8F:D0:F0,DEVSTYLE=5,ATTRMOD= 1,TYPE=1&2&3,UNIT=1,SUBUNIT=1,CIRCUITNO=1,ENRIG HTO=1&2&7,ENRIGHTI=3&4&5; Meaning: Create users from No. 5550000 to No. 5550031 with the MAC address of the AG is 00B0D08FD0F0, device type is 5, and user template is 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. The No. 1 unit and the No.1 circuit of the No.1 subunit of the gateway are occupied. Error Code Error Information Meaning Error Code Meaning 0x1AA9 Device number or the IP address, at least one of them should be entered. Device number or the IP address, at least one of them should be entered. 0x1A2B Users do not belong to the same office code Office codes of the start user and the end user are not consistent with each other. Three digit numbers where the user belongs to are not created. Or the three digit numbers are already created, but the gateway stack of the three digit numbers is 0. 0x1A1B Three digit numbers are not created. Create the three digit numbers first. 0x1AAE User numbers are not in the same gateway stack The gateway stack numbers of start user and end user are not consistent with each other. 0x1A7B User number (SDN) is already assigned The user number is already occupied. 0x1A93 There is no TID information of this port. No device type information matches to the parameter DEVSTYLE. 0x1A26 The MAC address is wrongly entered. The MAC address is wrongly entered. If the IP address is not entered along with the domain name parameter (ordinary domain name format), the device type and protocol type of the node should be the MGCP protocol. If the IP address is not entered along with the domain name parameter (MAC 0x1A77 Protocol type of the node is not MGCP or H.248. 8 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Error Code Error Information Meaning address format), the device type and protocol type of the node should be the H248 protocol. 0x1A1C Gateway stack of the node is not consistent with that of the three digit numbers. Gateway stack of the node is not consistent with that of the three digit numbers. The IP address is already occupied by any other node. The domain name of the node is not consistent with what is entered. 0x1A2D The IP address is already assigned. The entered device type is not consistent with that of the specified node or the protocol type of the entered device type is not consistent with that of the specified node. 0x1A94 The current gateway type is not consistent with the old one. The entered port number exceeds the maximum port number of the device. 0x1A92 This gateway has no such a port. The sum of the entered port number when performing the subscription in batch and the amount of subscriptions is bigger than the maximum port number of the device. 0x1AA7 The port resources of the TID user are insufficient. On the SS, there is no the entered IP address, but the domain name of a node is the same as the entered IP address. 0x1A3F The gateway device code already exists. There is no node under the gateway stack of the three digit numbers where the user belongs to. 0x1A33 The node (NODEID) does not exist. 0x1AAD The terminal domain name already exists. The terminal domain name already exists (with regard to the H323 user) The user template does not exist. Be care of that your user template number, the network type of the subscription user, area code, and the protocol type of the selected device type should be consistent with those of the user template on the SS. 0x1A96 The authority template does not exist. DAS on the gateway stack does not exist. 0x1A32 DAS does not exist 0x1A1A The specified restriction type There is the service conflict. Refer to the description of service Confidential and Proprietary Information of ZTE CORPORATION 9
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Error Code Error Information Meaning conflicts with the existing one. conflicts in national standards. 0x1A80 Do Not Disturb and Do Not Disturb in a certain time cannot be applied at the same time. Do Not Disturb and Do Not Disturb in a certain time cannot be applied at the same time. 0x1A41 Hotline service is already registered. Hotline service is already registered. 0x1A4B Call forwarding conflicts with out- group call forwarding. They cannot be registered at the same time. Call forwarding conflicts with out- group call forwarding. They cannot be registered at the same time. The secretary services cannot coexist with the forwarding services. 0x1A4F There is the service conflict. Reserved Reserved Reserved SIP User Subscription Command (4190) CREATE_SIPUSER:NET=?,LATA=?,SDN1=?,SDN2=?,ATTRMOD= ?,TYPE=?,ENRIGHTO=?,ENRIGHTI=?,AHREALM=?, PASSWD=?; Format This command is used to complete the SIP user subscription function (SIP users do not need to access the gateway). When defining a subscriber, both call authority and type of service you wish to register can be customized. Function SN Type Name Description Range Selec tion Parameters Manda tory 1 INT\BYTE NET Network type 0-32 2 INT\WORD LATA Local access and transport area code 0- 65535 Manda tory Manda tory 3 STR\KEYBO ARD SDN1 Start number 2-40 Option al 4 STR\KEYBO ARD SDN2 End number 0-40 5 INT\WORD ATTRM OD User template number 0- 65535 Option al 10 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands SN Type Name Description Range Selec tion Option al 6 STR\STRIN G TYPE Service type 0-5 Option al 7 STR\STRIN G ENRIG HTO Activated outgoing call authority type 0-5 Option al 8 STR\STRIN G ENRIG HTI Activated incoming call authority type 0-5 Option al 9 STR\STRIN G AHREA LM Certification domain 0-32 10 STR\STRIN G PASS WD Password 0-32 Option al Note: for all the above parameters, no default values. Parameter Description The detailed description of parameters NET, LATA, SDN1, SDN2, ATTRMOD, TYPE, ENRIGHTO, and ENRIGHTI are the same as that of the 4210 command. AHREALM is certification domain name of the SIP user, which can be customized. PASSWD is the password of the SIP user account. Example Adding a SIP User CREATE_SIPUSER:NET=2,LATA=25,SDN1= 5550000,SDN2=5550031, ATTRMOD=1,TYPE=1&2&3 ,ENRIGHTO=1&2&7,ENRIGHTI=3&4&5, AHREALM=ZTESS, PASSWD=12345678; Meaning: Create users from No. 5550000 to No. 5550031 with user template 1. The following services are registered: call forwarding on busy, call forwarding on no reply, three-party service. The following authority is given: outgoing rural call, national toll call, forwarding to the information console, incoming international toll call, trunk outgoing from SS local call, trunk outgoing SS rural call. The certification domain is ZTESS and the account password is 12345678. Error Code Error Information Meaning Error Code Meaning The user template does not exist. Be care of that your user template number, the network type of the subscription user, area code, and the protocol type of the selected device type should be consistent with those of the user template on the SS. 0x1A96 Authority template does not exist 0x1A2B Users do not belong to the same office code Office codes of the start user and the end user are not consistent with each other. Confidential and Proprietary Information of ZTE CORPORATION 11
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Error Code Error Information Meaning Three digit numbers where the user belongs to are not created. Or the three digit numbers are already created, but the gateway stack of the three digit numbers is 0. 0x1A1B Three digit numbers are not created. Create the three digit numbers first. The gateway stack numbers of start user and end user are not consistent with each other. 0x1AAE User numbers are not in the same gateway stack 0x1A7B User number (SDN) is already assigned The user number is already occupied. DAS is not assigned to the gateway stack of the three digit numbers where the user number belongs to. 0x1A32 DAS does not exist. 0x1A33 The node (NODEID) does not exist. There is no node under the gateway stack of the three digit numbers where the user belongs to. 0x1A20 Office code does not exist. Office code does not exist. 0x1A1A The specified restriction type conflicts with the existing one. There is the service conflict. Refer to the description of service conflicts in national standards. 0x1A80 Do Not Disturb and Do Not Disturb in a certain time cannot be applied at the same time. Do Not Disturb and Do Not Disturb in a certain time cannot be applied at the same time. 0x1A41 Hotline service is already registered. Hotline service is already registered. 0x1A4B Call forwarding conflicts with out- group call forwarding. They cannot be registered at the same time. Call forwarding conflicts with out- group call forwarding. They cannot be registered at the same time. 0x1A4F There is the service conflict. The secretary services cannot coexist with the forwarding services. SIP User Subscription Command (in Batch) (7299) APPEND_SIPUSEREX:NET=?,LATA=?,SDN1=?,NUM=?,ATTRMOD =?,AHREALM=?,PASSWD=?; Format Function 12 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands The function of this command is almost the same as that of the 4190 command. Usually, it is used for number release in batch. SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 INT\WORD NUM Number of subscriptions 1- 10000 Mandatory 5 INT\WORD ATTRMOD User template number 0- 65535 Optional 7 STR\STRING AHREALM Certification domain 0-32 Optional 7 STR\STRING PASSWD Password 0-32 Optional Note: for all the above parameters, no default values. Parameter Description None Example Adding a SIP User APPEND_SIPUSEREX:NET=2,LATA=25,SDN1= 5550000,NUM=10000, ATTRMOD=1, AHREALM=ZTESS, PASSWD=12345678; Meaning: Create users from No. 5550000 to No. 5559999 with user template 1, certification domain ZTESS, and account password 12345678. Error Code Meaning Confidential and Proprietary Information of ZTE CORPORATION 13
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
User Deletion Command (4206) DELETE_SDN:NET=?,LATA=?,SDN1=?, SDN2=?; If users are deleted, all data related to users are deleted. SN Type Name Description Range Selection 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start 2-40 Mandatory Error Code Error Information Meaning The user template does not exist. Be care of that your user template number, the network type of the subscription user, area code, and the protocol type of the selected device type should be consistent with those of the user template on the SS, or the authority template is not selected in the user template. 0x1A96 Authority template does not exist. Office codes of the start user and the end user are not consistent with each other. 0x1A2B Users do not belong to the same office code. Three digit numbers where the user belongs to are not created. Or the three digit numbers are already created, but the gateway stack of the three digit numbers is 0. 0x1A1B Three digit numbers are not created. Create the three digit numbers first. The gateway stack numbers of start user and end user are not consistent with each other. 0x1AAE User numbers are not in the same gateway stack 0x1A7B User number (SDN) is already assigned The user number is already occupied. There is no DAS selected in the template. 0x1A32 DAS does not exist. 0x1A20 Office code does not exist. Office code does not exist. Format Function Parameters 14 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands SN Type Name Description Range Selection number 4 STR\KEYBOARD SDN2 End number 0-40 Optional Note: for all the above parameters, no default values. Parameter Description Deleting users in batch is supported. Example Deleting Users in Batch DELETE_SDN:NET=2,LATA=25, SDN1= 5550000,SDN2=5550031; Meaning: Delete users from No. 5550000 to No. 5550031. Deleting a User DELETE_SDN:NET=2,LATA=25, SDN1= 5550000; Meaning: Delete user No. 5550000. Error Code Error Information Meaning Error Code Meaning The length of start number is not consistent with that of the end number. 0x1A1D Please enter user numbers with the same lengths. 0x1A1F The data requested by the command is too large. There are over 1000 records between the start number and the end number. 0x1A15 The specified record does not exist. The user does not exist. The user is a group user that cannot be directly deleted. 0x1A5A This number is in the group. Delete the group prior to the user. 0x1A8D This number is the virtual conference access code. This number is the virtual conference access code. This number belongs to an attendant console user. 0x1A8F This number is the standard attendant console desk number. The ISDN user cannot be deleted. 0x1A17 The parameter value is not reasonable. Confidential and Proprietary Information of ZTE CORPORATION 15
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
User Suspension Command (4209) DISABLE _SDN:NET=?,LATA=?,SDN1=?, SDN2=?,TAG=?; Format Function This command is used to suspend the user. Parameters SN Type Name Description Range Selection 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 INT\BYTE TAG Suspension mode 0-2 Optional Note: for all the above parameters, no default values. Parameter Description TAG=0, 1, 2 Here, 0, 1, and 2 indicate the full suspension, incoming suspension, and outgoing suspension respectively. Example Making the User Perform Full Suspension DISABLE _SDN: NET =1, LATA =25, SDN1="8880000", SDN2="8880999", TAG =0; Meaning: Make users from No. 8880000 to No. 8880999 perform the full suspension. Making the User Perform Partial Suspension DISABLE _SDN: NET =1, LATA =25, SDN1="8880000", SDN2="8880999", TAG =1; Meaning: Make users from No. 8880000 to No. 8880999 perform the outgoing service and incoming suspension. Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A15 The specified record does not exist. The user does not exist. 16 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Error Code Error Information Meaning 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. Service Access Command (4208) ENABLE _SDN:NET=?,LATA=?,SDN1=?, SDN2=?,TAG=?; Format This command is used for users to access the services. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 INT\BYTE TAG Service access mode 0-2 Optional Note: for all the above parameters, no default values. Parameter Description TAG=0, 1, 2 Here, 0, 1, and 2 indicate the full service access, incoming service access, and outgoing service access respectively. Example Making the User Access Full Service ENABLE _SDN: NET =1, LATA =25, SDN1="8880000", SDN2="8880999", TAG =0; Meaning: Make users from No. 8880000 to No. 8880999 access full service. Making the User Access Partial Service ENABLE _SDN: NET =1, LATA =25, SDN1="8880000", SDN2="8880999", TAG =1; Meaning: Make users from No. 8880000 to No. 8880999 perform the outgoing suspension and incoming service access. Confidential and Proprietary Information of ZTE CORPORATION 17
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A15 The specified record does not exist. The user does not exist. Office codes of the start user and the end user are not consistent with each other. 0x1A2B Users do not belong to the same office code. 0x1A20 Office code does not exist. Office code does not exist. User Call Authority Modification Command (4204) MODIFY_SUB_RIGHT:NET=?,LATA=?SDN1=?SDN2=?,ENRIGHT O=?, DISRIGHTO=?,,ENRIGHTI=?, DISRIGHTI=?; Format Function This command is used to modify the call authority of users. SN Type Name Description Range Selecti on Parameters Mandato ry 1 INT\BYTE NET Network type 0-32 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandato ry 3 STR\KEYBO ARD SDN1 Start number 2-40 Mandato ry 4 STR\KEYBO ARD SDN2 End number 0-40 Optional 5 STR\STRIN G ENRIGHT O Activated outgoing call authority type 0-5 Optional 6 STR\STRIN G ENRIGHTI Activated incoming call authority type 0-5 Optional 7 STR\STRIN G DISRIGH TO Deactivated outgoing call authority type 0-5 Optional 8 STR\STRIN G DISRIGH TI Deactivated incoming call authority type 0-5 Optional Note: for all the above parameters, no default values. Parameter Description ENRIGHTO, DISRIGHTO, ENRIGHTI, and DISRIGHTI indicate with outgoing call authority, without outgoing call 18 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands authority, with incoming call authority and without incoming call authority respectively. All of them are multi- mode parameters. Refer to Appendix 2 for their meanings. This command cannot guarantee the restoration of the call authority template used before. For instance, if the old call authority template is 1, execute ET=1, LATA=25, SDN1="8880000", SDN2="8880999", DISRIGHTO ="1"&"2"&"12"; After the execution of the command, the call authority template is changed to 6. At this moment, if you execute NET=1, LATA=25, SDN1="8880000", SDN2="8880999", DISRIGHTO="1"&"2"&"12", the call authority template cannot always be changed back to 1. Example Modifying User Call Authority 4204: NET =1, LATA =25, SDN1="8880000", SDN2="8880999", DISRIGHTO ="1"&"2"&"12"; Meaning: Modify the call authority of users No.8880000 to No.8880999 to make them have no authority to perform suburban and rural call of the local SS, national toll of the local SS, and high charge call. Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A15 The specified record does not exist. The user does not exist. Office codes of the start user and the end user are not consistent with each other. 0x1A2B Users do not belong to the same office code. 0x1A20 Office code does not exist. Office code does not exist. Owing Fee Service Access/Suspension Command (4202) MODIFY_SUB_ATTR:NET=?,LATA=?,SDN1=?,SDN2=?,DISTAG=? ,ENTAG=?ENPBXTAG=?,DISPBXTAG=?; Format This command is used to change the user attributes. Function SN Type Name Description Range Selectio n Parameters Confidential and Proprietary Information of ZTE CORPORATION 19
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
1 INT\BYTE NET Network type 0-32 Mandato ry 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandato ry 3 STR\KEYBO ARD SDN1 Start number 2-40 Mandato ry 4 STR\KEYBO ARD SDN2 End number 0-40 Optional 5 ENUM DISTAG Disable other attributes of the user 0-32 Optional 6 ENUM ENTAG Enable other attributes of the user 0-32 Optional 7 ENUM ENPBXTA G Enable other attributes of the user group 0-32 Optional 8 ENUM DISPBXTA G Disable other attributes of the user group 0-32 Optional Note: for all the above parameters, no default values. Parameter Description None Example Owing Fee MODIFY_SUB_ATTR:NET=1,LATA=758,SDN1="8880000",SDN2 ="8880000",ENTAG=4; Meaning: No.8880000 use owes fee. Owing Fee Service Access MODIFY_SUB_ATTR:NET=1,LATA=758,SDN1="8880000",SDN2 ="8880000",DISTAG=4; Meaning: Service for No.8880000 user resumes. Owing Fee Full Suspension 4202:NET=1,LATA=758,SDN1="8880000",SDN2="8880000",EN TAG=4,ENPBXTAG=5&6 Meaning: Owing fee full suspension happens to user No.8880000. Both outgoing and incoming calls cannot be performed. 20 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Resuming from Owing Fee Full Suspension 4202:NET=1,LATA=758,SDN1="8880000",SDN2="8880000",DI STAG=4,DISPBXTAG=5&6; Meaning: Owing fee full suspension happens of user No.8880000 is cancelled. Error Code Error Information Meaning Error Code Meaning The length of start number is not consistent with that of the end number. 0x1A1D Please enter user numbers with the same lengths. The user does not exist. 0x1A15 The specified record does not exist. 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. Number Change Command (Playing Announcement or Not Selection and Changing to Local or Non-Local Office Selection) (4202) MODIFY_SUB_ATTR:NET=?,LATA=?,SDN1=?,SDN2=?,OUTINTA G=?,CHGSDN=?,EXPIRE=?,TONESW=?; Format Function This command is used to change the number of a user. The change covers Play announcement due to number change, Do not play announcement when the number changes, Changed to be a local user and Changed to be a non-local user. SN Type Name Description Range Selection Parameters 1 INT\BYT E NET Network type 0-32 Mandatory 2 INT\WO RD LATA Local access and transport area code 0-65535 Mandatory 3 STR\KEY BOARD SDN1 Start number 2-40 Mandatory 4 STR\KEY BOARD SDN2 End number 0-40 Optional 5 INT\BYT E OUTINTA G Number change flag 0-4 Optional Confidential and Proprietary Information of ZTE CORPORATION 21
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
SN Type Name Description Range Selection 6 STR\KEY BOARD CHGSDN Number after change 0-41 Optional 7 STR\STR ING EXPIRE Number change expiration date 3-11 Optional 8 INT\BYT E TONESW Announcement play switch due to number change 0-2 Optional Note: for all the above parameters, no default values. Parameter Description None Example Changing Number to Be a Local User with Announcement Played MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899",OUTINTAG=4,CHGSDN="5550001",EXPIRE="2006- 08-09",TONESW=1; Meaning: It indicates that the user number 5550899 is changed to 5550001 of the local office. The number change expiration date is Aug. 9, 2006. Changing Number to Be a Non-Local User with Announcement Played MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899", OUTINTAG=4,CHGSDN="5550001",EXPIRE="2006-08- 09",TONESW=2; Meaning: It indicates that the user number 5550899 is changed to 5550001 of the non-local office. The number change expiration date is Aug. 9, 2006. Changing Number to Be a Local User Without Announcement Played MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550999",SDN2=" 5550999",OUTINTAG=4,CHGSDN="5550002",TONESW=0; Meaning: It indicates that the user number 5550899 is changed to 5550002 of the local office. Error Code Error Information Meaning Error Code Meaning The length of start number is not consistent with that of the end number. 0x1A1D Please enter user numbers with the same lengths. 22 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Error Code Error Information Meaning 0x1A15 The specified record does not exist. The user does not exist. 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. The date format of the number change is wrong. The format must be YYYY-MM-DD. 0x1ABB Please enter the valid date 0x1A65 The user number (SDN) does not exist. The new number after the number change does not exist.
Announcement Play Record Deletion Command (4054) (Number Change Announcement Cancellation) DELETE_CHANGE_SUB:SDN=?,LATA=?,NET=?; Format Function This command is used to change the number of a user. SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN Start number 2-40 Mandatory Note: for all the above parameters, no default values. Parameter Description None DELETE_CHANGE_SUB:SDN="52870009",LATA=25,NET=2; Example Meaning: Delete the announcement play record of user number 52870009. Error Code Error Information Meaning Error Code Meaning The announcement record of the user does not exist. 0x1A15 The specified record does not Confidential and Proprietary Information of ZTE CORPORATION 23
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Error Code Error Information Meaning exist. 0x1A20 Office code does not exist. Office code does not exist. Not Ready for Service Command (4202) MODIFY_SUB_ATTR:NET=?,LATA=?,SDN1=?,SDN2=? ENTAG=?; Format Function This command is used to make the user not ready for service. SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 ENUM ENTAG Not ready for service tag 0-16 Optional Note: for all the above parameters, no default values. Parameter Description None Example Enabling a User to the Not Ready for Service State MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899", ENTAG=8; Meaning: Enable user 5550899 to the Not Ready for Service state. Canceling the Not Ready for Service State MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899", DISTAG=8; Meaning: Cancel the Not Ready for Service state of user 5550899. 24 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A15 The specified record does not exist. The user does not exist. 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. The date format of the number change is wrong. The format must be YYYY-MM-DD. 0x1ABB Please enter the valid date 0x1A65 The user number (SDN) does not exist. The new number after the number change does not exist. Public Telephone Billing Command (Polarity Reversal Function or 16Kc Billing Function) (4202) MODIFY_SUB_ATTR:NET=?,LATA=?,SDN1=?,SDN2=?,OUTINTA G=?, REVKC=?; Format This command is used to change the number of a user. The change covers Play announcement due to number change, Do not play announcement when the number changes, Changed to be a local user and Changed to be a non-local user. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 INT\BYTE REVKC Signal type provided by the terminal 0-4 Optional Note: for all the above parameters, no default values. Confidential and Proprietary Information of ZTE CORPORATION 25
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
None Parameter Description Example Registering the Polarity Reversal Function of a User MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899", REVKC =1; Meaning: Register the polarity reversal function of user number 5550899. Canceling the Polarity Reversal Function of a User MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 6660001", REVKC =0; Meaning: Cancel the polarity reversal function of user number 5550899. Registering 16KC Function of a User MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899", REVKC =2; Meaning: Register the 16KC function of user number 5550899. Canceling 16KC Function of a User MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 6660001", REVKC =0; Meaning: Cancel the 16KC function of user number 5550899. Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A15 The specified record does not exist. The user does not exist. Office codes of the start user and the end user are not consistent with each other. 0x1A2B Users do not belong to the same office code. 0x1A20 Office code does not exist. Office code does not exist. 26 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Call Restriction Group Modification Command (4202) Format MODIFY_SUB_ATTR:NET=?,LATA=?,SDN1=?,SDN2=?, RCLGROUP=?; Function This command is used to modify the call restriction group of a user. SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 INT\WORD RCLGROUP Not ready for service tag 0- 65535 Optional Note: for all the above parameters, no default values. Parameter Description None Example Enabling a User to the Not Ready for Service State MODIFY_SUB_ATTR:NET=1,LATA=25,SDN1="5550899",SDN2=" 5550899",RCLGROUP =10; Meaning: Modify the call restriction group of user 5550899 to 10. Error Code Error Information Meaning Error Code Meaning The length of start number is not consistent with that of the end number. 0x1A1D Please enter user numbers with the same lengths. 0x1A15 The specified record does not exist. The user does not exist. 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. 0x1ABB Please enter the The date format of the number Confidential and Proprietary Information of ZTE CORPORATION 27
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Error Code Error Information Meaning valid date change is wrong. The format must be YYYY-MM-DD. 0x1A65 The user number (SDN) does not exist. The new number after the number change does not exist. Commercial Group User Addition Command (Ordinary Call to Centrex Group Call Conversion Command) (4233) APPEND_CTX_USER:CSGNO=?,CDN=?,SDN=?,NET=?,DAS=?,LA TA=?,NUM=?; Format This command is used to add an ordinary user to a group. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN Start number 2-40 Mandatory 4 STR\KEYBOARD CDN Group numbers 1-10 Mandatory 5 INT\ WORD CSGNO Group number 0- 65535 Mandatory 6 INT\WORD DAS DAS 0- 65535 Optional 7 STR\STRING NUM Number of addings 1- 65535 Mandatory Note: for all the above parameters except NO.7, no default values. The default value of No.7 is 1. Parameter Description None Example Adding Ordinary User to a Group Example 1: Add a user to the No.100 CENTREX group APPEND_CTX_USER:CSGNO=100,CDN="4101",SDN="4826607", NET=1,LATA=25,DAS=1; 28 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Meaning: Add a user for the No.100 CENTREX group. The intra- group number is 4101 and the user number is 4826607. Error Code Error Information Meaning Error Code Meaning 0x1A1D Please enter user numbers with the same lengths. The length of start number is not consistent with that of the end number. 0x1A2B Users do not belong to the same office code. Office codes of the start user and the end user are not consistent with each other. 0x1A20 Office code does not exist. Office code does not exist. 0x1A65 The user number (SDN) does not exist. The new number after the number change does not exist. Commercial Group User Deletion Command (Group Call to Ordinary Call Conversion Command) (4234) Format DELETE_CTX_USER: CSGNO=?, CDN1=?,CDN2=?; This command is used to change the group user to the ordinary user. Function SN Type Name Description Range Selection Parameters 1 STR\KEYBOARD CDN2 Start number 1-10 Mandatory 2 STR\KEYBOARD CDN1 Group numbers 1-10 Mandatory 3 INT\ WORD CSGNO Group number 0- 65535 Mandatory Note: for all the above parameters, no default values. Parameter Description None Example Deleting Ordinary User from Group User DELETE_CTX_USER: CSGNO=100, CDN1=4101,CDN2=4110; Meaning: Delete intra-group users 4101 through 4110 from the No.100 CENTREX group. Confidential and Proprietary Information of ZTE CORPORATION 29
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Ordinary User to ISDN User Conversion Command (4272) Format CREATE_ISUB:NET=?,LATA=?,SDN1=?,DCHANNELS=?,TAG=?,U OSR=?,UOSA=?; Function The premise to convert the ordinary user into an ISDN user is that the ordinary user is already successfully created, this user cannot register any service and TIDNAME needed by ISDN is also being created (BRA, PRI and RTP types). S N Type Name Descript ion Range Defaul t Value Selectio n Parameters Mandator y 1 INT\BYTE NET Network type 0-32 2 INT\WOR D LATA Local access and transport area code 0-65535 Mandator y Mandator y 3 STR\KEY BOARD SDN1 Start number 2-40 4 STR\KEY BOARD SDN2 End number 0-40 Optional 5 INT\DWO RD UOSR Booking indicatio n of supplem entary service 0- 4294967 295 0 Mandator y 6 INT\DWO RD UOSA Activatin g indicatio n of supplem entary service 0- 4294967 295 0 Mandator y 7 INT\WOR D BSCFU Call forwardi ng unconditi onal 0-65535 0 Mandator y 8 INT\WOR D BSCFB Call forwardi ng on busy 0-65535 0 Mandator y 9 INT\WOR D BSCFN R Call forwardi ng on no 0-65535 0 Mandator y 30 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands S N Type Name Descript ion Range Defaul t Value Selectio n reply 10 INT\WOR D STATU S ISDN state 0-65535 0 Mandator y 11 INT\DWO RD TAG Other attribute s 0- 4294967 295 0 Mandator y 12 INT\WOR D STATU S1 Circuit state 0-65535 0 Mandator y 13 INT\WOR D TAG1 Other attribute s of the circuit 0-65535 0 Mandator y 14 INT\WOR D DCHAN NELS Serial number of the D channel 0-65535 Mandator y 15 INT\BYTE DTIDN O Serial number reserved for the D channel 0-255 Mandator y 16 INT\DWO RD DNO Global D channel 0- 4294967 295 0 Mandator y Parameter Description Registration: UOSR=1 indicates CFU, UOSR=2 indicates CFB, and UOSR=4 indicates CFNR. Activation: UOSA=1 indicates CFU, UOSA=2 indicates CFB, and UOSA=4 indicates CFNR. Primary service category: 1-Voice service. 2-Unrestricted digital information, 4-3.1KHZ audio, 8-7KHZ telephone, 16- User telegraph, 32-Fourth fax, 64-videography, 128-Video phone, and 256-Second and third fax. BSCFU, BSCFB, or BSCFNR, registering one or more primary services, is the sum of the primary services. For instance: BSCFU=33 indicates that the voice and fourth fax are registered. Example Converting Ordinary User into ISDN User CREATE_ISUB:NET=2,LATA=25,SDN1="2180003",DCHANNELS= 4,TAG=0,UOSR=1,UOSA=0,BSCFU=0,BSCFB=0,BSCFNR=0,STA TUS=0,STATUS1=0,TAG1=0,DNO=5,DTIDNO=1; Confidential and Proprietary Information of ZTE CORPORATION 31
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Meaning: Create the No.2180002 ISDN user. The D channel of the user is 14, global channel is 6, and Forwarding unconditional service is registered. ISDN User to Ordinary User Conversion Command (4274) DELETE_ISUB:NET=?,LATA=?,SDN1=?, SDN2=?; Format Function This command is used to delete the ISDN user and convert it into an ordinary user. Parameters SN Type Name Description Range Selection 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 2-40 Optional Note: for all the above parameters, no default values. Example Deleting Users in Batch DELETE_ISUB:NET=2,LATA=25,SDN1="2180003",SDN2="2180 013"; Meaning: Deleting No. 2180003 to No.2180013 ISDN users. Ordinary Service Registration Command (4302) Format REG_NEWSRV:NET=?,LATA=?,SDN1=?,TYPE=?; This command can be used for users to register more than one supplementary service. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access 0- Mandatory 32 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands SN Type Name Description Range Selection and transport area code 65535 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 STR\STRING TYPE Service type 2-5 Mandatory Note: for all the above parameters, no default values. Parameter Description As for the service type parameters, refer to the service enumeration values in the attached file. Example Registering a Service REG_NEWSRV:NET=1,LATA=25,SDN1="4826606",TYPE="12"&" 13"; Meaning: Register the abbreviated dialing and hotline services for the No.4826606 user. Ordinary Service Deletion Command (4303) DELETE_NEWSRV:NET=?,LATA=?,SDN1=?,TYPE=?; Format This command can be used to delete more than one supplementary service. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Local access and transport area code 0- 65535 Mandatory 3 STR\KEYBOARD SDN1 Start number 2-40 Mandatory 4 STR\KEYBOARD SDN2 End number 0-40 Optional 5 STR\STRING TYPE Service type 2-5 Mandatory Note: for all the above parameters, no default values. Parameter Description As for the service type parameters, refer to the service enumeration values in the attached file. Example Confidential and Proprietary Information of ZTE CORPORATION 33
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Deleting a Service DELETE _NEWSRV:NET=1,LATA=25,SDN1="4826606",TYPE="12"&"13"; Meaning: Delete the abbreviated dialing and hotline services of the No.4826606 user. MSN/DDI Service of ISDN User Creation Command (7324) CREATE_MSN/DDI:SUBNUM=?,NUM=?,FLAG=?,NET=?,LATA=?; Format Function This command is used to create the MSN/DDI service of the ISDN user. SN Type Name Description Range Selection Parameters 1 STR\STRING SUBNUM Sub-number 2-41 Mandatory 2 STR\STRING NUM Default number 2-32 Mandatory 3 INT\BYTE FLAG Service type 1-2 Mandatory 4 INT\BYTE NET Network type 0-32 Optional 5 INT\WORD LATA Local access and transport area code 0- 65535 Optional Note: for all the above parameters, no default values. Parameter Description If the service type is 1, it indicates the MSN user, while when it is 2, it indicates the DDI user. Example Registering MSN Service CREATE_MSN/DDI:SUBNUM="52870000",NUM="52870001",FLA G=1,NET=0,LATA=0; Meaning: Register the MSN service for user No. 4826606. The sub-number is 52870000, while the default number is NUM="52870001". MSN/DDI Service of ISDN User Deletion Command (7326) DELETE_MSN/DDI:SUBNUM=?, NET=?,LATA=?; Format Function 34 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands This command is used to delete the MSN/DDI service of the ISDN user. SN Type Name Description Range Selection Parameters 1 STR\STRING SUBNUM Sub-number 2-41 Mandatory 2 INT\BYTE NET Network type 0-32 Optional 3 INT\WORD LATA Local access and transport area code 0- 65535 Optional Note: for all the above parameters, no default values. Parameter Description If the service type is 1, it indicates the MSN user, while when it is 2, it indicates the DDI user. Example Deleting MSN Service DELETE_MSN/DDI:SUBNUM="52870000", NET=0,LATA=0; Meaning: Delete the MSN service with sub-number as 52870000. Telephone Removal Command (7289) MOV_SDN:NET=?,LATA=?,SDN=?,LATA1=?,SDN1=?,TIDNAME= ?,NODEID=?; Format This command is used to complete the telephone removal (at present, this command is only used for ordinary user to remove the telephone) Function SN Type Name Description Range Selection Parameters 1 INT\BYTE NET Network type 0-32 Mandatory 2 INT\WORD LATA Original local access and transport area code of the user 0- 65535 Mandatory 3 STR\KEYBOARD SDN Original user number 2-40 Mandatory 4 INT\WORD LATA1 Original local access and transport area code of 0- 65535 Mandatory Confidential and Proprietary Information of ZTE CORPORATION 35
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
SN Type Name Description Range Selection the user 5 STR\KEYBOARD SDN1 New user number 2-40 Mandatory 6 INT\ WORD TIDNAME TID name 0-40 Mandatory 7 INT\WORD NODEID New node ID 0- 65535 Optional Note: for all the above parameters, no default values. Parameter Description This old user should be listed in the switch. New user and new user TID information are not occupied in the switch. The old user will be deleted after the telephone removal. Example Adding Ordinary User to a Group MOV_SDN:NET=1,LATA=25,SDN="52870001",LATA1=25,SDN1 ="52870002",TIDNAME="USER001002003"; Meaning: Remove user 52870001 to 52870002. TID name of the new port is USER001002003. The user node number keeps unchanged. MOV_SDN:NET=1,LATA=25,SDN="52870001",LATA1=25,SDN1 ="52870002",TIDNAME="USER001002003", NODEID=12; Meaning: Remove user 52870001 to 52870002. TID name of the new port is USER001002003. The user is removed to No.12 node.
Error Code Error Information Meaning Error Code Meaning 0x1A65 User number (SDN) does not exist. The original user number does not exist. 0x1A20 The office code does not exist. The office code of the new user number does not exist. 0x1A1B Three digit numbers are not created. Create the three digit numbers first. Three digit numbers of the new user number does not exist. 0x1A7B User number (SDN) is already assigned The user number is already occupied. 0x1A6F TID user resources are already occupied. The TID name of the user is already occupied. 0x1A33 The node (NODEID) does not exist. The node (NODEID) does not exist. 0x1A17 The parameter The user type is not consistent with 36 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Error Code Error Information Meaning value is not reasonable. the node type. Ordinary User to V5 User Conversion Command (4835) CREATE_V5_SUB:USER=?,DID=?,SDN=?,LATA=?,NET=?,ADDR2 =?,ADDR1=?,V5ID=?; Format Function The premise to convert the ordinary user into a V5 user is that the ordinary user is already successfully created and TIDNAME needed by V5 user is also being created (TIDNAME that need to create the trunk type and RTP type). Moreover, the port information of V5 is already configured. SN Type Name Description Range Selection Parameters 1 INT\BYTE V5ID Parameters of the V5 interface 1-255 Mandatory 2 INT\WORD ADDR1 Start address of the L3/EF address 0- 32767 Mandatory 3 INT\WORD ADDR2 End address of the L3/EF address 0- 32767 Optional 4 INT\BYTE NET Network type 0-32 Mandatory 5 INT\WORD LATA Local access and transport area code 1- 65535 Mandatory 6 STR\KEYBOARD SDN User number 2-40 Mandatory 7 INT\WORD DID DID 1- 65535 Optional 8 INT\BYTE USER User type 1-3 Mandatory Note: for all the above parameters, no default values. Parameter Description NET (Network type) is customized by the user. For instance, 1 indicates China Telecom. LATA (Local access and transport area code) is area code. For instance, the area code of Nanjing is 25. V5ID is an identifier of the V5 user. USER indicates the user type. 1 indicates the 2B+D user, 2 indicates the 30B+D user, and 3 indicates the PSTN user. DID is a reserved parameter. Confidential and Proprietary Information of ZTE CORPORATION 37
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
Creating V5 Users in Batch Example CREATE_V5_SUB: USER=3,DID=1,SDN="91090000",LATA=56,NET=0,ADDR2=1,A DDR1=0,V5ID=1; Meaning: Create a batch of V5 users. The identifier of the V5 interface is 1, the start address of the L3/EF address is 0, the end address of the L3/EF address is 1, network type is 0(current network), the area code is 56, the user numbers are 91090000 and 91090001, the user type is 3 (PSTN), and the DID is 1. Error Code Information Meaning Error Code Meaning 0x1AE6 This V5 interface does not exist. Information of the V5 interface is not configured. 0x1A20 Office code does not exist. Office code does not exist. 0x1A14 The same record already exists. The created V5 subscriber already exists. V5 User to Ordinary User Conversion Command (4837) DELETE_V5_SUB: V5ID=?, ADDR1=?, ADDR2=?, USER=?; Format This command is used to convert the V5 user into an ordinary user. Function SN Type Name Description Range Selection Parameters 1 INT\BYTE V5ID Parameters of the V5 interface 1-255 Mandatory 2 INT\WORD ADDR1 Start address of the L3/EF address 0-32767 Optional 3 INT\WORD ADDR2 End address of the L3/EF address 0-32767 Optional 4 INT\BYTE USER User type 1-3 Mandatory Note: for all the above parameters, no default values. Example Deleting V5 Users Information in Batch DELETE_V5_SUB: V5ID=1, ADDR1=22, ADDR2=77, USER=3; Meaning: Delete V5 PSTN users whose V5 interface is 1 and address is 22 through 77 in batch. 38 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 1 Common Billing Commands Deleting a Piece of V5 User Information DELETE_V5_SUB: USER=3, ADDR1=0, V5ID=1; Meaning: Delete V5 PSTN user whose V5 interface is 1 and address is 0. Error Code Information Meaning Error Code Meaning 0x1A15 The specified record does not exist. V5 user does not exist. Confidential and Proprietary Information of ZTE CORPORATION 39
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
This page is intentionally blank.
40 Confidential and Proprietary Information of ZTE CORPORATION
Ch a p t e r 2 Appendix
Meaning of Service Enumeration Value (Corresponding to the TYPE Parameter of Ordinary Subscription Command) Corresponding to the TYPE parameter of ordinary subscription command SN Meaning 0 Forwarding unconditional 1 Forwarding on busy 2 Forwarding on no reply 3 Three-party conversation 4 Conference call 5 Malicious call tracing 6 Call waiting 7 Caller number presentation 8 Caller number presentation restriction 12 Abbreviated dialing 13 Instant hot line 14 Delayed hot line 15 Outgoing call restriction 16 Do not disturb in a certain time 17 Do not disturb 18 Alarm clock service 19 Registered call on busy 20 Call back on busy Confidential and Proprietary Information of ZTE CORPORATION 41
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
SN Meaning 21 Absent service 23 Emergency call override 24 Inter-group call forwarding unconditional 25 Inter-group call forwarding on busy 26 Inter-group call forwarding on no reply 29 Forwarding national incoming call forbidden 30 Forwarding forbidden on national incoming call 33 Intra-group pickup 34 Extension forwarding 35 Extension pickup 38 Simple attendant console 41 Automatic locking 43 Called destination code connection 44 Called destination code restriction 45 Caller destination code connection 46 Caller destination code restriction 47 Missed call number presentation 50 Call transfer 51 Pre-payment 52 Forced release 53 Secretary services 55 Voice mailbox 56 IP call waiting 57 Virtual conference 58 Ringing current 59 Preset network 60 One-number to ring multiple phones 61 Offline service transfer 62 Caller number signing the trigger service 64 Fixed network CRBT 65 One number connect you 66 Anonymous call allowed 67 Anonymous call restricted 68 Anonymous call permanently restricted 128 Caller line identification provided 129 Caller line identification restricted 42 Confidential and Proprietary Information of ZTE CORPORATION
Chapter 2 Appendix SN Meaning 130 Connection line identification provided 131 Connection line identification restricted Definition of Call Authority Enumeration Description of parameters ENRIGHTO and ENRIGHTI of the ordinary subscription command is as follows: SN Meaning With/Without authority to perform call of the local SS 0 With/Without authority to perform suburban and rural call of the local SS 1 With/Without authority to perform national call of the local SS 2 With/Without authority to perform international call of the local SS 3 With/Without authority to perform local call of the SS outgoing from the trunk 4 With/Without authority to perform suburban and rural call of the SS outgoing from the trunk 5 With/Without authority to perform national call of the SS outgoing from the trunk 6 With/Without authority to forward the information console 7 With/Without authority to perform international call of the SS outgoing from the trunk 8 9 Charged special service 10 Commercial group authority 11 Authority outside group 12 High charge With/Without authority to perform local and network call of the SS outgoing from the IP 13 With/Without authority to perform national call of the SS outgoing from the IP 14 With/Without authority to perform international call of the SS outgoing from the IP 15
Confidential and Proprietary Information of ZTE CORPORATION 43
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
This page is intentionally blank. 44 Confidential and Proprietary Information of ZTE CORPORATION
Figures
Figure 1 Screen of Device Type Configuration........................3 Figure 2 Screen of User Template Configuration.....................4 Confidential and Proprietary Information of ZTE CORPORATION 45
ZXSS10 SS1b SoftSwitch Control Equipment Server Billing Command User Manual
This page is intentionally blank. 46 Confidential and Proprietary Information of ZTE CORPORATION
Tables
Table 1 Chapter Summary ...................................................i Table 2 Typographical Conventions ...................................... ii Table 3 Mouse Operation Conventions .................................. ii
Confidential and Proprietary Information of ZTE CORPORATION 47