InfoX-AAA Interface Developer Guide - MML
InfoX-AAA Interface Developer Guide - MML
InfoX-AAA Interface Developer Guide - MML
V200R002
Issue 04
Date 2007-12-29
Part Number
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute the warranty of any kind, express or implied.
Contents
5.2.8 ACK to the Command for Modifying the Information About a CDMA User .................................5-19
5.2.9 Command for Changing the Password of an AN User ....................................................................5-21
5.2.10 ACK to the Command for Changing the Password of an AN User ...............................................5-22
5.2.11 Command for Modifying the User Password in the Self-Service System .....................................5-23
5.2.12 ACK to the Command for Modifying the User Password in the Self-Service System..................5-25
5.2.13 Command for Recharging a CDMA Local Prepaid Account.........................................................5-26
5.2.14 ACK to the Command for Recharging a CDMA Local Prepaid Account .....................................5-27
5.2.15 Command for Querying the Bill of a CDMA Account..................................................................5-28
5.2.16 ACK to the Command for Querying for a Bill of a CDMA Local Prepaid Account .....................5-30
5.2.17 Command for Querying for the Start Time and Accumulative Usage of a Service .......................5-32
5.2.18 ACK to Command for Querying for the Start Time and Accumulative Usage of a Service..........5-33
6.2.28 ACK to Command for Querying for the Start Time and Accumulative Usage of a Service..........6-44
Figures
Tables
Table 3-5 Parameters of the command for changing the operator password.....................................................3-7
Table 3-6 Parameters of the ACK command.....................................................................................................3-8
Table 4-1 Parameters of the command for adding a broadband user ................................................................4-2
Table 4-5 Parameters of the command for deleting a broadband user ............................................................4-15
Table 4-6 Parameters of the ACK command...................................................................................................4-17
Table 4-7 Parameters of the command for querying the user information......................................................4-18
Table 4-35 Parameters of the command for querying the session information ...............................................4-61
Table 4-36 Parameters of the ACK command.................................................................................................4-63
Table 5-1 Parameters for the command for adding a CDMA user ....................................................................5-2
Table 5-11 Parameters for the command for changing the user password in the self-service system.............5-24
Table 5-12 Parameters of the ACK command.................................................................................................5-25
Table 5-13 Parameters for the command for recharging a CDMA local prepaid account...............................5-26
Table 6-11 Parameters of the command for deleting WCDMA users in batches ............................................6-23
Table 6-12 Parameters of the ACK command.................................................................................................6-24
Table 6-13 Parameters of the command for resetting a WCDMA user...........................................................6-25
Table 7-1 Parameters of the command for adding a WiMAX user ...................................................................7-2
Table 7-2 Parameters of the ACK command.....................................................................................................7-5
Table 7-3 Parameters of the command for deleting a WiMAX user .................................................................7-6
Table 7-4 Parameters of the ACK command.....................................................................................................7-7
Table 7-5 Parameters of the command for modifying the information about a WiMAX user. .........................7-8
Table 7-6 Parameters of the ACK command...................................................................................................7-12
Table 7-7 Parameters of the command for querying for the information about a WiMAX user.....................7-13
Table 7-8 Parameters of the ACK command...................................................................................................7-14
Table 7-9 Parameters of the command for changing the password of a WiMAX user ...................................7-17
Table 7-10 Parameters of the ACK command.................................................................................................7-18
Table 7-11 Parameters of the command for recharging a prepaid WiMAX user ............................................7-19
Table 7-12 Parameters of the ACK command.................................................................................................7-21
Table 7-13 Parameters of the command for querying for the bill of a WiMAX user......................................7-22
Table 7-14 Parameters of the ACK command.................................................................................................7-23
Purpose
This document describes the commands, functions, parameters, and instances of the MML
interfaces. The MML interfaces consist of the operator management, broadband service,
CDMA service, WCDMA service, and WiMAX service.
Related Versions
The following table lists the product versions related to this document.
infoX-AAA V200R002
Intended Audience
This document is intended for:
Application Developer
Organization
This document consists of seven parts and is organized as follows.
Chapter Description
Chapter Description
4 MML Interfaces for This chapter describes the MML interfaces for the CDMA
CDMA Service service.
5 MML Interfaces for This chapter describes the MML interfaces for the
WCDMA Service WCDMA service.
6 MML Interfaces for This chapter describes the MML interfaces for the WiMAX
WCDMA Service service.
7 Appendix This chapter lists the ChSecksum’s codes, acronyms, and
abbreviations.
Conventions
Symbol Conventions
The following symbols may be found in this document. They are defined as follows.
Symbol Description
General Conventions
Convention Description
Convention Description
Courier New Terminal display is in Courier New.
Command Conventions
Convention Description
GUI Conventions
Convention Description
Keyboard Operation
Format Description
Key Press the key. For example, press Enter and press Tab.
Key 1+Key 2 Press the keys concurrently. For example, pressing
Ctrl+Alt+A means the three keys should be pressed
concurrently.
Key 1, Key 2 Press the keys in turn. For example, pressing Alt, A means
the two keys should be pressed in turn.
Mouse Operation
Action Description
Update History
Updates between document versions are cumulative. Therefore, the latest document version
contains all updates made to previous versions.
1 Overview
Section Describes
1.1 Position of the Billing The position of the billing system in the network.
System in the Network
1.2 Format of the Message The format of the MML Server message.
That Supports the MML
Server Interface
Operator
infoX-AAA
MML/Socket/TCP/IP
Internet
Access ISP
IP Core Network
Network
User
Intranet
MML Server
As the server that manages the service, the Man Machine Language Server (MML Server) is
an important part of the infoX-AAA system.
The functions of the MML Server are as follows:
z System management
z Service management
z User management
z Charging management
z Operating log management
In addition, the MML Server provides an open MML interface and a service management
function based on the interface. The third-party system, such as the billing system, can
manage the user data through the MML interface. The management includes adding a user,
deleting a user, and changing the user password.
Billing System
As the client of the MML Server, the billing system provides a platform for carriers to manage
the business. The carrier then can manage the user data by accessing the billing system.
The session ID is a unique ID for an operator of the billing system to log in to the MML Server. The
billing system specifies the session ID. The value is an integer.
z Transaction
After the session is created successfully, the operator of the billing system can send the
MML request to the MML Server through a session. One MML request is a transaction
between the operator and the MML Server.
When an operator sends the MML request to the MML Server, a transaction starts. When
the MML Server returns the MML response to the operator, the transaction ends.
On a session initiated by the billing client, multiple concurrent transactions are not
recommended. The MML Server, however, can process multiple concurrent transactions.
z Operation
An operation is a specific task of the service application, which is run by the operator on
the client of the billing system. For example, the operator queries the balance of a card.
The transaction ID in the MML request sent to the MML Server must map the current
operation. When the MML Server returns the response, the client finds the current
operation according to the transaction ID of the response. Then, the client proceed with
the operation.
An operation contains only one interactive transaction between the billing system and the
MML Server.
z Heartbeat message
An message = Start flag + Size + Message header + Session header + Transaction header +
Operation information + Checksum
z Message header = Version number + Terminal ID + Service name
z Session header = Session ID + Session control word + Reserved session word
z Transaction header = Transaction ID + Transaction control word + Reserved transaction
word
Table 1-1 lists the fields in an ordinary message.
A heartbeat message must be sent between the bill system and MML Server every 60 seconds. If one
party cannot receive 10 responses of the heartbeat message from the other in succession, it indicates that
the bill system and MML Server are disconnected.
Section Describes
2.1 Overview The objective and prerequisite for developing the billing
system, and the operating flows of the billing system.
2.2 Instance An instance of developing the billing client.
2.3 Interconnection Debugging The interconnection debugging between the billing
system and the MML Server.
2.4 FAQ How to troubleshoot the problems during the debugging.
2.1 Overview
Objective
The objective of development is to enables the billing system to communicate with the MML
Server.
Prerequisite
Before developing the billing system, obtain the IP address and port number of the server
where the MML Server resides. The port number of the MML Server is 19999 by default.
The billing system has a super administrator on the MML Server. The login name is billopr. The initial
password is TELLIN.
Operating Flow
Figure 2-1 shows the operating flow of the billing system.
login
login ACK
operation1
operation1 ACK
......
......
operationN
operationN ACK
logout
logoutACK
4. The MML Server operates internally according to the message from the billing system.
After the operation is complete, the MML Server returns the operation ACK message.
5. The billing system sends the logout message to the MML Server requesting the logout.
6. The MML Server receives the logout message and returns the logout ACK message.
z The operation message is a message initiated by the billing system. The number of the operation
messages is specified by the billing system. The billing system can also send the operation requests
consecutively.
z If the operator does not operate for more than one hour after login, the session between the billing
system and the MML Server is released.
2.2 Instance
The following is an instance for developing the billing system:
The billing system must be able to encode the ordinary message and heartbeat message.
msglen+=len;
sendLen=msglen+MSG_COMM_LEN;
memset(sendBuff,' ',MAX_MSG_LEN);
len=0;
//Encapsulating Start flag.
strncpy(sendBuff+len, MSG_STARTTAG, MSG_STARTTAG_LEN);
len+=MSG_STARTTAG_LEN;
//Encapsulating Size
p=Int2ToHex(msglen);
strncpy(sendBuff+len, p, MSG_INFOLEN_LEN);
len+=MSG_INFOLEN_LEN;
//Encapsulating Message header.
strncpy(sendBuff+len, MSG_VERSION, MAX_LEN_VERSION);
len+=MAX_LEN_VERSION;
strncpy(sendBuff+len, MSG_TERMINAL, MAX_LEN_TERMINAL);
len+=MAX_LEN_TERMINAL;
strncpy(sendBuff+len,sendMsg.service, strlen(sendMsg.service));
len+=MAX_LEN_SERVNAME;
//Encapsulating Session header.
p=Int4ToHex(sendMsg.snLogin);
strncpy(sendBuff+len, p, MAX_LEN_DLGID);
len+=MAX_LEN_DLGID;
strncpy(sendBuff+len,pDlg[sendMsg.dlgCtrl],strlen(pDlg[sendMsg.dlgCtrl
]));
len+=MAX_LEN_DLGCTRL;
strncpy(sendBuff+len, MSG_DLGRSVD, MAX_LEN_DLGRSVD);
len+=MAX_LEN_DLGRSVD;
//Encapsulating Transaction header.
p=Int4ToHex(sendMsg.sequence);
strncpy(sendBuff+len, p, MAX_LEN_TXID);
len+=MAX_LEN_TXID;
strncpy(sendBuff+len,pTx[sendMsg.txCtrl],strlen(pTx[sendMsg
.txCtrl]));
len+=MAX_LEN_TXCTRL;
strncpy(sendBuff+len, MSG_TXRSVD, MAX_LEN_TXRSVD);
len+=MAX_LEN_TXRSVD;
//Encapsulating Operation information.
strncpy(sendBuff+len, sendMsg.cmd, cmdlen);
//Encapsulating Checksum.
len=MSG_STARTTAG_LEN + MSG_INFOLEN_LEN;
GetChkSum(msglen,sendBuff+len,chksum);
len=sendLen-MSG_CHKSUM_LEN;
strncpy(sendBuff+len, chksum, MSG_CHKSUM_LEN);
return Success;
The billing system must be able to decode the ordinary message and heartbeat message.
break;
recMsg.dlgCtrl=tmpInt;
strncpy(tmpStr, recBuff+len, MAX_LEN_DLGRSVD);
tmpStr[MAX_LEN_DLGRSVD]='\0';
len+=MAX_LEN_DLGRSVD;
//Decoding Transaction header.
strncpy(tmpStr, recBuff+len, MAX_LEN_TXID);
tmpStr[MAX_LEN_TXID]='\0';
len+=MAX_LEN_TXID;
HexToInt4(tmpStr,tmpInt);
recMsg.sequence=tmpInt;
strncpy(tmpStr, recBuff+len, MAX_LEN_TXCTRL);
tmpStr[MAX_LEN_TXCTRL]='\0';
len+=MAX_LEN_TXCTRL;
StrTrim(tmpStr);
for(tmpInt=0;tmpInt<4;tmpInt++) if(strcmp(pTx[tmpInt],tmpStr)==0)
break;
recMsg.txCtrl=tmpInt;
strncpy(tmpStr, recBuff+len, MAX_LEN_TXRSVD);
tmpStr[MAX_LEN_TXRSVD]='\0';
len+=MAX_LEN_TXRSVD;
//Decoding Operation information.
tmpInt=msglen-(MAX_HEAD_LEN);
strncpy(tmpStr, recBuff+len, tmpInt);
tmpStr[tmpInt]='\0';
len+=tmpInt;
StrTrim(tmpStr);
strcpy(recMsg.cmd, tmpStr);
//Decoding Checksum.
strncpy(tmpStr, recBuff+len, MSG_CHKSUM_LEN);
tmpStr[MSG_CHKSUM_LEN]='\0';
len=MSG_STARTTAG_LEN + MSG_INFOLEN_LEN;
GetChkSum(msglen,recBuff+len,chksum);
if(strncmp(tmpStr,chksum,MSG_CHKSUM_LEN) != 0)
{
printf("Msg chksum error.");
return Failure;
}
//Printing messages after decoding
PrintMsg(recMsg);
return Success;
}
The billing system sends a message to the MML Server and receives the returned result from
the MML Server.
The referential codes are as follows:
//Content irrelevant to message sending and receiving is omitted.
......
//Sending a message.
send(m_sockfd,sendBuff,sendLen,0);
outp_strm(sendBuff);
//Receiving a message.
while(1)
{
recLen=recv( m_sockfd, recBuff, sizeof(recBuff),0 );
if(recLen>0)
{
printf("\nreceive login ack message...\n\n");
outp_strm(recBuff);
//Decoding a message and obtaining the operation result.
Decode(recMsg,recBuff,recLen,TYPE_OF_CMD_MSG);
break;
}
}
The heartbeat message must be sent to and fro between the bill system and MML Server every 60
seconds. If one party cannot receive the response of the heartbeat message from the other party for 10
times in succession, it indicates that the bill system and MML Server are disconnected. You need release
the current connection and reconnect them.
----End
If the NIC name is unknown, you can run the ifconfig –a command to view the NIC information.
The snoop command is an internal command of the Solaris system. To use the snoop command, refer to
the related documents of Solaris. When the operating system of the server is Suse, run the tcpdump
command to capture packets. To use the command, refer to the related documents of Suse.
For detailed meaning of the preceding captured packets, see Table 1-1.
----End
2.4 FAQ
2.4.1 Connecting the MML Server Fails
Symptom
When you debug the interconnection between the billing system and the MML Server, the
billing system fails to connect to the MML Server.
Solution
Check the IP address in the caa.cfg file of the MML Server. If the IP address is configured
incorrectly, check the configuration file and restart the two-node cluster where the MML
Server resides. Then connect the billing system with the MML Server again.
Solution
z The command codes are incorrectly entered. The MML command does not exist in the
specified service process.
z The MML command is incorrect in grammar. Check the MML command.
Section Describes
3.1 Introduction The functions of the MML interfaces for the operator
management.
3.2 MML Commands The MML commands relevant to the operator
management.
3.1 Introduction
The MML interfaces of the infoX-AAA supports the operator management. Through the
MML interfaces, you can log in to and out of the infoX-AAA, and modify the operator
password as a billing operator.
In the MML commands of the operator management, the services of the command for
changing the operator password and the matching ACK commands are named OPRM. Other
commands, however, do not contain service names.
The acknowledgement (ACK) command is used for the infoX-AAA to respond to the running of an
MML command. For example, the ACK command of login is the response of the command for logging
in to the infoX-AAA.
Function
This command is used to log in to the infoX-AAA.
Parameter Description
Table 3-1 lists the parameters of the command for logging in to the infoX-AAA.
Instance
The following is an instance of running the command for logging in to the infoX-AAA.
z Scenario
− The USER parameter is billopr.
− The PSWD parameter is TELLIN.
z Command
login billopr TELLIN internal
Function
This command is used to the respond to the command for logging in to the infoX-AAA.
Parameter Description
Table 3-2 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for logging in to the
infoX-AAA.
z Command
ACK:LOGIN: RETN=0, DESC=Success, ATTR=ROLEID & ROLENAME & CREATOR & AGENT
ID & AGENTNAME & SERVKEY & USER & LVLID & SCPID
RESULT="7|BILLopr|billopr|200000|Administrator 280 Agent|280|billopr|999|100",;
If an operator fails to log in, the message returned does not contain the ATTR and RESULT parameters.
The DESC parameter describes the cause of the failure.
Function
This command is used to log out of the infoX-AAA system.
Parameter Description
Table 3-3 lists the parameters of the command for logout.
Instance
The following is an instance of running the command for logging in to the infoX-AAA.
z Scenario
An operator of the billing system logs out.
z Command
LOGOUT:
Function
This command is used to respond to the logout of an operator.
Parameter Description
Table 3-4 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for logout.
z Command
ACK:LOGOUT:RETN=0,DESC=”Succeeded”;
Function
This command is used to change the operator password.
Parameter Description
Table 3-5 lists the parameters of the command for changing the operator password.
Table 3-5 Parameters of the command for changing the operator password
Instance
The following is an instance of running the command for changing the operator password.
z Scenario
− The OLDPSWD parameter is TELLIN.
− The NEWPSWD parameter is 123456.
− The CFMPSWD parameter is 123456.
z Command
CHG OPRM OWNPSWD:OLDPSWD=TELLIN,NEWPSWD=123456,CFMPSWD=123456;
Function
This command is used to respond to the command for changing the operator password.
Parameter Description
Table 3-6 lists the parameters of the ACK command.
Instance
The following is an instance of running the command for logging in to the infoX-AAA.
z Scenario
The infoX-AAA responds to the successful running of the command for changing the operator
password.
z Command
ACK:CHG OPRM OWNPSWD:RETN=0,DESC="Modifying password succeeded."
Section Describes
4.1 Introduction
The MML interfaces of the infoX-AAA supports the broadband service. Through the MML
interfaces, you can add and delete a broadband user, and modify and query the user
information in the billing system.
In the MML commands of the broadband service, the services of all the MML commands are
named C280.
The acknowledgement (ACK) command is used for the infoX-AAA to respond to the running of an
MML command. For example, the ACK command of adding a broadband user is the response of the
command for adding a broadband user to the infoX-AAA.
Function
This command is used to add a broadband user.
Parameter Description
Table 4-1 lists parameters of the command for adding a broadband user.
Instance
The following is an instance of running the command for adding a broadband user.
z Scenario
− The USERID parameter is sun.
− The LOGINNAME parameter is sun.
− The PSWD parameter is 123456.
− The DOMAIN parameter is domain-usr-psw.
− The MAXUSERNUMBER parameter is 1.
− The user type is prepaid. That is, the PAYTYPE parameter is 2.
− The number of the restricted port is 1. That is, the LIMITFLAG parameter is 1.
− The ACCESSPOLICYID parameter is 2.
− The USERTEMPLATE parameter is 4.
− The payment mode of the user is by cash. That is, the PAYMODE parameter is 1.
− The user is a common user. That is, the USERTYPE parameter is 0.
− The IPADDRESS parameter is 168430090.
− The IPMASK parameter is –256.
z Command
ADD C280 USER: MAXUSERNUMBER=1, PAYTYPE="2", IPMASK=-256, USERNAME="sun",
IPADDRESS=168430090, PAYMODE=1, ACCESSPOLICYID=2, USERADDRESS="", USERTYPE=0,
DESCRIPTION="", USERTEMPLATE=4, MOBILE="", IDNUMBER="",
LOGINNAME="sun@domain-usr-psw", LIMITFLAG=1, COMPANY="", PSWD="123456"
The IP address and subnet mask exist in the command for adding a broadband user must be integers.
The ACCOUNTNUMBER and BATCH parameters cannot coexist.
The values of LOGINNAME and USERID cannot coexist and cannot be null at the same time.
Function
This command is used to respond to the command for adding a broadband user.
Parameter Description
Table 4-2 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for adding a
broadband user.
z Command
ACK: ADD C280 USER:RETN=0,DESC="Adding user succeeded";
Function
This command is used to modify the information about a broadband user.
Parameter Description
Table 4-3 lists the parameters of the command for modifying the information about a
broadband user.
Table 4-3 Parameters of the command for modifying the user information
Instance
The following is an instance of running the command for changing the information about a
broadband user.
z Scenario
Modify the mobile phone number of a broadband user.
− The COMPANY parameter is A.
− The MOBILE parameter is 13851771240.
− The USERADDRESS parameter is china.
− The PHONE parameter is 0755-21569856.
− The ZIPCODE parameter is 110056.
− The IDNUMBER parameter is 321322198402212000.
− The USERNAME parameter is sun.
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The MAXUSERNUMBER parameter is 1.
− The user type is prepaid. That is, the PAYTYPE parameter is 2.
− The ACCESSPOLICYID parameter is 2.
− The USERTEMPLATE parameter is 4.
− The IPADDRESS parameter is 168430090.
− The IPMASK parameter is –256.
z Command
MOD C280 USER: COMPANY="company A", MOBILE="13851771240", USERADDRESS="china",
PHONE="0755-21569856", ZIPCODE="110056", IPMASK=-256, USERTEMPLATE=4, IPPOOLID=-1,
IPADDRESS=168430090, ACCESSPOLICYID=2, LOGINNAME="sun@domain-usr-psw", USERNAME="sun",
MAXUSERNUMBER=1, IDNUMBER="321322198402212000
The IP address and subnet mask exist in the command for modifying the information about a broadband
user must be integers.
The ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same time.
Function
This command is used to respond to the command for modifying the information on a
broadband user.
Parameter Description
Table 4-4 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for modifying the
information about a broadband user.
z Command
ACK:MOD C280 USER:RETN=0,DESC="Modifying user information succeeded";
Function
This command is used to delete a broadband user.
Parameter Description
Table 4-5 lists the parameters of the command for deleting a broadband user.
Instance
The following is an instance of running the command for deleting a broadband user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− Delete the user information that need not be reserved. That is, the REMOVEALL
parameter is 1.
− The SCPID parameter is 100.
z Command
DEL C280 USER: REMOVEALL=0, LOGINNAME=sun@domain-usr-psw, SCPID=100
The values of LOGINNAME or ACCOUNTNUMBER cannot coexist and cannot be null at the same
time.
Function
This command is used to respond to the command for deleting a broadband user.
Parameter Description
Table 4-6 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for deleting a
broadband user.
z Command
ACK:DEL C280 USER:RETN=0,DESC="Deleting the user information succeeded.";
Function
This command is used to query the information about a broadband user.
Parameter Description
Table 4-7 lists the parameters of the command for querying the information about a
broadband user.
Table 4-7 Parameters of the command for querying the user information
Instance
The following is an instance of running the command for querying the information about a
broadband user.
z Scenario
z When querying the information about a broadband user, you must enter the value of a parameter.
z The values of LOGINNAME and ACCOUNTNUMBER cannot coexist.
z The values of ACCOUNTNUMBER and USERID cannot coexist.
Function
This command is used to respond to the command for querying information on a broadband
user.
Parameter Description
Table 4-8 lists the parameters of the ACK command.
RESULT List of queried data. Lines are Result set returned when an operation
separated by the & symbol and command is run.
parameters are separated by the |
symbol.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for modifying the
information about a broadband user.
z Command
QUERY C280 USER:RETN=0,DESC="Querying user
succeeded",TOTAL=1,FINISHED=1,START=0,ROWNUM=1,
ATTR=LOGINNAME & ACCOUNTNUMBER & USERID & USERNAME & IDNUMBER & CONTACTMAN & PAYMODE
& COMPANY & USERADDRESS & BANK & BANKACCOUNT & PHONE & PAYPHONE & ZIPCODE & MOBILE &
EMAIL & BP & DESCRIPTION & SERVICELEVEL & MAXUSERNUMBER & IPADDRESS & IPMASK & STATUS
& TEMPLATEID & TEMPLATENAME & IPPOOLID & IPPOOLTYPE & IPPOOLNAME & LIMITFLAG & LIMITPORT
& ACCESSPOLICYID & AREAID & PROVIDERID & ACCPROFID & ACCPROFNAME & REGISTERTIME &
UNREGISTERTIME ,RESULT="sun@domain-
usr-psw|test00000001|20070621103842351235|sun|||1||||||||||||2|1|168430090|-256|1|4
|commontemplet|-1|||1||2|-1|200000|-1||20070621103842||;
Function
This command is used to query an account.
Parameter Description
Table 4-9 lists the parameters of the command for querying an account.
Instance
The following is an instance of running the command for querying the account information
about a broadband user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
z Command
QUERY C280 ACCOUNT:LOGINNAME=sun@domain-usr-psw;
The values of ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same
time.
Function
This command is used for the infoX-AAA to respond to the command for querying an account
Parameter Description
Table 4-10 lists the parameters of the ACK command.
ATTR List or queried attributes. Fields are Must be the following strings:
separated by ampersands (&). ACCOUNTNUMBER &
Including the following parameters: LOGINNAME & SERID
z ACCOUNTNUMBER: account & SERVICELEVEL &
z LOGINNAME : Login name and CONSUMERIGHT &
domain in the form of login BATCH & SEQUENCE &
name@domain. PROVIDERID & STATUS &
SUBSTATE & USESTATE &
z USERID: User ID. It can be ignored. RELAT
z SERVICELEVEL: Service type IVEDAYS & COUNTTOTAL
0: Agent card & ACCOUNTLEFT &
1: Postpaid Card (Type A) LIMITTYPE &
2: Rechargeable Prepaid Card (Type LIMITACCDAY &
B) LIMITACCLEFTDAY &
3: Non-Rechargable Prepaid Card AREAID & FIRSTUSEDATE
(Type C) & SERVICESTART &
z CONSUMERIGHT: reserved field SERVICESTOP &
0: access and content LASTUSEBEGINTIME &
1: only access LASTUSEENDTIME &
2: only content LIMITACCMONTH &
3: commissioned sales point LIMITACCLEFTMONTH &
4: only VOIP LIMITFLAG & LIMITPORT
z BATCH: batch. & CREDITFLAG &
CREDITUNION &
z SEQUENCE: sequence number of a CREDITACCLEFT &
batch. REALNAME & PHONE &
z PROVIDERID: Agent ID. It can be ACCESSPOLICYID &
ignored. REGISTERTIME &
z STATUS: status of a card. UNREGISTERTIME
0: not activated.
1: activated
2: to be deleted
3: Idle
z SUBSTATE: whether the card is
available.
0: no
1: yes
z USESTATE: whether a card is being
used.
0: No
1: Yes
z RELATIVEDAYS: relative validity
period. The validity period starts
from the first use.
z COUNTTOTAL: total amount in a
card
z ACCOUNTLEFT: balance of a card
z LIMITTYPE: reserved field
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying the
account information about a broadband user.
z Command
QUERY C280 ACCOUNT:RETN=0,DESC="Querying account succeeded",ATTR= ACCOUNTNUMBER &
LOGINNAME & USERID & SERVICELEVEL & CONSUMERIGHT & BATCH & SEQUENCE & PROVIDERID & STATUS
& SUBSTATE & USESTATE & RELATIVEDAYS & COUNTTOTAL & ACCOUNTLEFT & LIMITTYPE & LIMITACCDAY
& LIMITACCLEFTDAY & AREAID & FIRSTUSEDATE& SERVICESTART & SERVICESTOP & LASTUSEBEGINTIME
& LASTUSEENDTIME & LIMITACCMONTH & LIMITACCLEFTMONTH & LIMITFLAG & LIMITPORT & CREDITFLAG
& CREDITUNION & CREDITACCLEFT & REALNAME & PHONE & ACCESSPOLICYID & REGISTERTIME &
UNREGISTERTIME,RESULT="test00000001|sun@domain-usr-psw|20070621103842351235|2|1|200
7062100|1|200000|1|1|0|365|5000|5000|0|0||-1|00000000|20070621|20080620|||0||1||0|0
||sun||2|20070621103842||",;
Function
This command is used to activate an account.
Parameter Description
Table 4-11 lists the parameters of the command for activating an account.
Instance
The following is an instance of running the command for activating an account.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
z Command
ACT C280 ACCOUNT:LOGINNAME=sun@ domain-usr-psw
The values of ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same
time.
Function
This command is used to respond to the command for activating an account.
Parameter Description
Table 4-12 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for activating an
account.
z Command
ACK:ACT C280 ACCOUNT:RETN=0,DESC="Enabling the account succeeded.";
Function
This command is used for operators to deactivate an account.
Parameter Description
Table 4-13 lists the parameters of the command for deactivating an account.
Instance
The following is an instance of running the command for deactivating an account.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The SCPID parameter is 100.
z Command
DEACT C280 ACCOUNT:LOGINNAME=sun@domain-usr-psw
The values of LOGINNAME and USERID cannot be coexist and cannot be null at the same time.
Function
This command is used to respond to the command for deactivating an account.
Parameter Description
Table 4-14 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for deactivating an
account.
z Command
ACK:DEACT C280 ACCOUNT:RETN=0,DESC="Disabling the account succeeded.";
Function
This command is used for operators to reset an account.
Parameter Description
Table 4-15 lists the parameters of the command for resetting an account.
Instance
The following is an instance of running the command for resetting an account.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
z Command
RESET C280 ACCOUNT:LOGINNAME=sun@ domain-usr-psw
The values of ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same
time.
Function
This command is used to respond to the command for resetting an account.
Parameter Description
Table 4-16 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for resetting an
account.
z Command
ACK:RESET C280 ACCOUNT:RETN=0,DESC="Resetting the account succeeded.";
Function
This command is used to change a password.
Parameter Description
Table 4-17 lists the parameters of a command for changing a password.
Instance
The following is an instance of running the command for changing the password.
z Scenario
− The login name is sun.
− The home domain of the user is domain-usr-psw.
The value of LOGINNAME or ACCOUNTNUMBER cannot coexist and cannot be null at the same
time.
The values of PASSWORD and CHKPASSWORD must be the same.
Function
This command is used for the infoX-AAA to respond to the command for changing a
password.
Parameter Description
Table 4-18 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for changing a
password.
z Command
ACK: MOD C280 PASSWD:RETN=0,DESC="Modifying the password succeeded.";
Function
This command is used to restrict a port used.
Parameter Description
Table 4-19 lists the parameters of the command for restricting a port.
Instance
The following is an instance of running the command for restricting a port.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The number of the restricted port is 1. That is, the LIMITFLAG parameter is 1.
− The LIMITPORT parameter is 1000–4568.
z Command
SET C280 LMTPORT: LIMITFLAG=1, LOGINNAME=sun@domain-usr-psw, LIMITPORT=1000-4568
Function
This command is used to respond to the command for restricting a port.
Parameter Description
Table 4-20 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for restricting a
port.
z Command
ACK:SET C280 LMTPORT:RETN=0,DESC="Setting restricted port succeeded.";
Function
This command is used for recharge an account by cash.
Parameter Description
Table 4-21 lists the parameters for recharging an account by cash.
Instance
The following is an instance of running the command for recharging an account by cash.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The CHGVAL parameter is 2000.
z Command
CHARGE C280 ACCOUNT:CHGVAL=2000,LOGINNAME="sun@domain-usr-psw";
The values of ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same
time.
Function
This command is used to respond to the command for recharge an account by cash.
Parameter Description
Table 4-22 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for recharging an
account by cash.
z Command
Function
This command is used to roll back cash recharge.
Parameter Description
Table 4-23 lists the parameters of the command for rolling back the cash recharge.
Table 4-23 Parameters of the command for rolling back the cash recharge
Instance
The following is an instance of running the command for rolling back the cash recharge.
z Scenario
The sequence number of an operation is 2.
z Command
BACK C280 CHARGE: SN=2
4.2.24 ACK to the Command for Rolling Back the Cash Recharge
Command
ACK: BACK C280 CHARGE
Function
This command is used to respond to the command for rolling back the cash recharge.
Parameter Description
Table 4-24 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for rolling back the
cash recharge.
z Command
ACK: BACK C280 CHARGE:RETN=0,DESC="Rolling back the cash recharge succeeded.";
Function
This command is used for operators to query a recharge record.
Parameter Description
Table 4-25 lists the parameters of the command for querying a recharge record,
Instance
The following is an instance of running the command for querying a recharge record.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The BEGINTIME parameter is 20070521000000.
− The ENDTIME parameter is 20070621235959.
− The recharge type is normal. That is, the CHARGETYPE parameter is 1.
z Command
QUERY C280
CHARGE:ENDTIME=20070621235959,CHARGETYPE=1,LOGINNAME=sun@domain-usr-psw,STATE=2,BEG
INTIME=20070521000000,
The value of LOGINNAME or ACCOUNTNUMBER cannot coexist and cannot be null at the same
time.
The BEGINTIME and ENDTIME must coexist and cannot be null at the same time.
The values of both BEGINTIME and ENDTIME must be entered.
Function
This command is used to respond to the command for querying cash recharge records.
Parameter Description
Table 4-26 lists the parameters of the ACK command.
ATTR List or attributes names that are z Ordinary recharge records that are
separated by the & symbol. queried must be the following strings:
The attributes are as follows: SN & LOGINNAME &
CHARGENUMBER &
z SN: sequence number of an CHARGETYPE & CHARGETIME
operation. & CHARGEACCOUNT &
z Login name and domain in the BEFOREACCOUNT &
form of login name@domain. AFTERACCOUNT & PROVIDERID
z CHARGENUMBER: & OPERATOR & STATE
rechargable card number. z Recharge rollback records that are
z CHARGETYPE: type of queried must be the following strings:
recharge. SN & LOGINNAME &
CHARGENUMBER &
z CHARGETIME: recharge CHARGETYPE & CHARGETIME
time. & CHARGEACCOUNT &
z CHARGEACCOUNT: BEFOREACCOUNT &
recharge amount. AFTERACCOUNT & PROVIDERID
z BEFOREACCOUNT: balance & OPERATOR & STATE &
before recharge. OPTIME & WITHDRAWER &
ChargeSN
z AFTERACCOUNT: balance
after recharge.
z PROVIDERID: ID of the cash
recharge agent.
z OPERATOR: cash recharge
operator.
z STATE: status of cash
recharge records .
z 1: Normal (default)
z 2: Rollback
z OPTIME: rollback duration in
the form of
YYYYMMDDHHMMSS.
z WITHDRAWER: account of
an operator who performs
rollback.
z CHARGESN: sequence
number of a recharge log.
RESULT List of queried data. Lines are Result set returned when an operation
separated by the & symbol and command is run.
parameters are separated by the |
symbol.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying a
recharge record of a broadband user.
z Command
QUERY C280 CHARGE:RETN=0,DESC="Querying recharging record
succeeded.",TOTAL=1,FINISHED=1,START=0, ROWNUM=1,ATTR=SN & LOGINNAME & CHARGENUMBER &
CHARGETYPE & CHARGETIME & CHARGEACCOUNT & BEFOREACCOUNT & AFTERACCOUNT & PROVIDERID &
OPERATOR &
STATE,RESULT="1|sun@domain-usr-psw||1|2007-06-2113:59:02|2000|5000|7000|200000|unsa
dm|2|20070621140142|unsadm|1",;
Function
This command is used to query a bill.
Parameter Description
Table 4-27 lists the parameters of the command for querying a bill.
Instance
The following is an instance of running the command for querying a bill.
z Scenario
− The DOMAIN parameter is domain-usr-psw.
− The BILLTIME parameter is 20060501000000.
z Command
QUERY C280 BILL:LOGINNAME="sun@domain-usr-psw",BILLTIME="20060501000000";
The values of LOGINNAME and ACCOUNTNUMBER cannot coexist and cannot be null at the same
time.
Function
This command is used for the infoX-AAA to respond to the command for querying a bill.
Parameter Description
Table 4-28 lists the parameters of the ACK command.
ATTR List or queried attributes. Fields are Must be the following strings:
separated by ampersands (&). ACCOUNTNUMBER &
Including the following attributes: LOGINNAME
z ACCOUNTNUMBER: Card & SERVICEKEY &
number. SERVICELEVEL & PROVIDERID
z Login name and domain in the & LOGICPORTNO
form of login name@domain. & SERVICESTARTTIME &
z SERVICEKEY: service key. BEGINTIME
z SERVICELEVEL: service type. & ENDTIME & CHARGEMODE &
CHARGECLASS & FEE &
z PROVIDERID: ID of the agent SENDBYTES
z LOGICPORTNO: logical port & RECEIVEBYTES &
reported by the ISN SENDPACKES
z SERVICESTARTTIME: start & RECEIVEPACKES &
time of the service. TIMELENGTH
z BEGINTIME: start time of the & CONTENTTITLE & BILLTYPE
charging. & ACCOUNTREASON & SN &
z BEGINTIME: end time of the SERVICEITEMID &
charging. SERVICEITEMNAME
z CHARGEMODE: charging & USERIP & ISNIP &
mode. LOGICALPORTNO
z 0: flow-based
z 1: duration-based
z 2: based on flow and duration
z 3: Piece-based
z CHARGECLASS: charging type.
z FEE: fee to be paid.
z SENDBYTES: Upstream
bandwidth in Kilobytes.
z RECEIVEBYTES: Downstream
bandwidth in Kilobytes.
z SENDPACKES: number of
upstream packets.
z RECEIVEPACKES: number of
downstream packets
z TIMELENGTH: online duration.
z CONTENTTITLE: name of a
content.
z BILLTYPE: type of a bill.
z ACCOUNTREASON: Charging
reason, that is, cause for
generating bills.
z SN: Sequence number.
z SERVICEITEMID: ID of a
service.
z SERVICEITEMNAME: Name of
a service.
4-50 z USERIP:
HuaweiIPTechnologies
address of the user
Proprietary Issue 04 (2007-12-29)
assigned by the device.
z ISNIP: IP of the ISN, in the form
of a string.
infoX-AAA
Interface Developer Guide - MML 4 MML Interfaces for Broadband Service
RESULT List of queried data. Lines are Result set returned when an operation
separated by the & symbol and command is carried out.
parameters are separated by the |
symbol.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying a bill.
z Command
ACK:QUERY C280 BILL:RETN=0,DESC="Querying the bill
succeeded.",TOTAL=1,FINISHED=1,START=0
,ROWNUM=1,ATTR=ACCOUNTNUMBER & LOGINNAME & SERVICEKEY & SERVICELEVEL & PROVIDERID &
LOGICPORTNO & SERVICESTARTTIME & BEGINTIME & ENDTIME & CHARGEMODE & CHARGECLASS & FEE
& SENDBYTES & RECEIVEBYTES & SENDPACKES & RECEIVEPACKES
& TIMELENGTH & CONTENTTITLE & BILLTYPE & ACCOUNTREASON & SN & SERVICEITEMID &
SERVICEITEMNAME & USERIP & ISNIP &
LOGICALPORTNO,RESULT="test00000001|sun@domain-usr-psw|280|2|200000||20060608012740|
20060608012740|20060608012744||-1|0|0.000000|0.000000|0.000000|0.000000|4|11|1|2|10
002000000000000001|-1||0.0.0.1|10.164.26.127||",;
Function
The command is used to order a broadband service.
Parameter Description
Table 4-29 lists the parameters of the command for ordering a broadband service.
Instance
The following is an instance of running the command for ordering a broadband service.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The SERVICEID parameter is 100.
z Command
ADD C280 ORDER:SERVICEID=100,LOGINNAME="sun@domain-usr-psw"
Function
This command is used to respond to the command for ordering a broadband service.
Parameter Description
Table 4-30 lists the parameters of the ACK command.
RETN Returned value z 1015: The service is not contained in the visibility
of the ACK table of service domains.
command. z 1016: This account has already subscribed the VPDN
service.
z 1017: The service cannot be subscribed by the
account.
z 1021: The accounts of the batch cannot subscribe this
service.
z 1022: The service has been subscribed for all the
accounts of this batch.
z 1023: Access service has been subscribed for the
accounts of this batch.
z 1024: This account has already subscribed the VPDN
service.
z 1500: Sorry, the user does not belong to the current
operator. (The prompt is valic when the system is in
the area management mode.)
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for ordering a
service.
z Command
ACK:ADD C280 ORDER:RETN=0,DESC="Subscribing the service for account succeeded.";
Function
This command is used for operators to cancel subscriptions.
Parameter Description
Table 4-31 lists the parameters of the command for canceling a service order.
Instance
The following is an instance of running the command for canceling a service order.
z Scenario
The operator cancels an ordered service of a user.
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The SERVICEID parameter is 100.
z Command
DEL C280 ORDER:SERVICEID=100,LOGINNAME="sun@domain-usr-psw"
Function
This command is used to respond to the command for canceling an ordered service.
Parameter Description
Table 4-32 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for canceling an
ordered service.
z Command
ACK:DEL C280 ORDER:RETN=0,DESC="Cancelling the service for account succeeded.";
Function
This command is used to query an ordered service.
Parameter Description
Table 4-33 lists the parameters of the command for querying an ordered service.
Instance
The following is an instance of running the command for querying an ordered service.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
z Command
QUERY C280 ORDER:LOGINNAME=sun@domain-usr-psw;
The values of ACCOUNTNUMBER and LOGINNAME cannot coexist and cannot be null at the same
time.
Function
This command is used to respond to the command for querying an ordered service.
Parameter Description
Table 4-34 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
query the information about an ordered service.
z Command
QUERY C280 ORDER:RETN=0,DESC="Querying the service by account
succeeded.",TOTAL=1,FINISHED=1,START=0, ROWNUM=1,ATTR=LOGINNAME &SERVICEID &
ORDERTIME & STATUS & SERVICENAME
&SERVICETYPE,RESULT="sun@domain-usr-psw|100|20070621143808|1|test_service|1|",;
Function
This command is used to query the information about the sessions of the broadband user.
Parameter Description
Table 4-35 lists the parameters of the command for querying the session information about the
user.
Table 4-35 Parameters of the command for querying the session information
Instance
The following is an instance of running the command for querying the session information
about a user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is domain-usr-psw.
− The service type that the user uses is AAA service. That is, the SERVICEFLAG
parameter is AAA.
− The SCPID parameter is 100.
z Command
QUERY C280 USERSESS:SERVICEFLAG=AAA,DOMAIN="domain-usr-psw",USERNAME="sun"
,SCPID=100;
Function
This command is used to respond the command for querying the information about the user
sessions.
Parameter Description
Table 4-36 lists the parameters of the ACK command.
ATTR For the AAA service, the parameters are as In the AAA service, the
follows: stings must be as follows:
z USERNAME: login name. USERNAME & USERIP
z USERIP: IP address of the user. & ISNIP &
NASPORTID &
z ISNIP: IP address of the ISN device. ACCUTIME &
z NASPORTID: port type. It is used to judge ACCTSESSIONID &
whether the user accesses the Wireless Local INPUTVOLUMN &
Area Network (WLAN). OUTPUTVOLUMN
z SERSTARTTIME: time when the user goes In the SSS service, the
online stings must be as follows:
z ACCTSESSIONID: session ID. INTERFACEALIAS &
z INPUTVOLUMN: downlink traffic flow. INTERFACEDESC &
INTERFACENAME &
z OUTPUTVOLUMN: uplink traffic flow. IPADDRESS &
For the SSS service, the parameters are as USERNAME &
follows: LOGINTIME &
z INTERFACEALIAS: alias SERVICECLASS &
USERSESSIONID &
z INTERFACEDESC: description of the NASIDENTIFIER
interface that the user accesses.
z INTERFACENAME: name of the interface
that the user accesses.
z IPADDRESS: IP address of the user.
z USERNAME: login name of the user.
z LOGINTIME: the time when the user accesses
the network.
z SERVICECLASS: service type.
z USERSESSIONID: AcctSessionId of the
basic access service of the user.
z NASIDENTIFIER: identifier of the device.
List of queried attributes. Fields are separated by
the & symbol.
RESULT List of queried data. Lines are separated by the Result set returned when
& symbol and parameters are separated by the | an operation command is
symbol. run.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying the
session information about a user.
z Command
Section Describes
5.1 Introduction The functions of the MML interfaces in the CDMA service.
5.2 MML Commands The MML commands relevant to the CDMA service.
5.1 Introduction
The MML interfaces of the infoX-AAA supports the CDMA service. Through the MML
interfaces, you can add and delete a CDMA user, and modify and query for the user
information in the billing system.
In the MML commands of the CDMA service, the services of all the MML commands are
named C270.
The acknowledgement (ACK) command is used for the infoX-AAA to respond to the running of an
MML command. For example, the ACK command of adding a CDMA user is the response of the
command for adding a CDMA user to the infoX-AAA.
Function
The command is used to register a CDMA user.
Parameter Description
Table 5-1 lists the parameters of the command for adding a CDMA user.
Table 5-1 Parameters for the command for adding a CDMA user
NOTE
AN = Access Network
MN = Mobile Network
Instance
The following is an instance of running the command for adding a CDMA user.
z Scenario
− The DOMAIN parameter is usr-psw-imsi.
− The user needs to be authenticated. That is, the ISAUTH parameter is 1.
− The AUTHFAILCNTTRH parameter is 0.
− The mode of assigning the IP address is static. That is, the IPASSIGN parameter is 1.
− The IP parameter is 168430090. The IPMASK parameter is –256.
− The UZID parameter is 12.
− The EXTTEMPLET parameter is 2.
1. The IP address and subnet mask in the command for adding a CDMA user must be integers.
2. The values of LOGINNAME, PSWD, and MSID are subject to Authtype of a domain.
z When Authtype of a domain is 0, LOGINNAME, PSWD, and MSID can be omitted.
z When Authtype of a domain is 1, MSID cannot be omitted.
z When Authtype of a domain is 4, LOGINNAME cannot be omitted.
z When Authtype of a domain is 5, LOGINNAME and MSID cannot be omitted.
z When Authtype of a domain is 6, LOGINNAME and PSWD cannot be omitted.
z When Authtype of a domain is 7, LOGINNAME, PSWD, and MSID cannot be omitted.
3. The CHGVAL parameter can be used only for the local prepaid CDMA user.
4. When the system does not support the local prepaid mode but the payment is in prepaid mode,
MDN cannot be omitted or null.
5. The values of IP, IPMASK, and IPPOOLID are subject to the mode of assigning the IP
addresses.
z When IPASSIGN is 0, IP, IPMASK, and IPPOOLID must be omitted.
z When IPASSIGN is 1, IP and IPMASK cannot be omitted; IPPOOLID must be omitted.
z When IPASSIGN is 2, IP and IPMASK must be omitted.
Function
The command is used to respond to the command for adding a CDMA user.
Parameter Description
Table 5-2 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for adding a CDMA
user.
z Command
ACK:ADD C270 ACCOUNT:RETN=0,DESC="Succeeded in adding a CDMA subscriber.";
Function
The command is used to deregister a CDMA user.
Parameter Description
Table 5-3 lists the parameters of the command for deleting a CDMA user.
Table 5-3 Parameters for the command for deleting a CDMA user
Instance
The following is an instance of running the command for deleting a CDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− Delete all the user information. That is, the REMOVEALL parameter is 1.
z Command
DEL C270 ACCOUNT: DOMAIN=usr-psw-imsi, REMOVEALL=0, LOGINNAME=sun;
The LOGINNAME and MSID cannot coexist and cannot be null at the same time.
Function
The command is used to respond to the command for deregistering a CDMA user.
Parameter Description
Table 5-4 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for deleting a
CDMA user.
z Command
ACK:DEL C270 ACCOUNT:RETN=0,DESC="Succeeded in deleting the CDMA subscriber.";
Function
This command is used to query for the information about a CDMA user.
Parameter Description
Table 5-5 lists the parameters of the command for querying for the information about a
CDMA user.
Table 5-5 Parameters for the command for querying for the information about a CDMA user
Instance
The following is an instance of running the command for querying for the information about a
CDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
z Command
QUERY C270 ACCOUNT:DOMAIN=usr-psw-imsi,LOGINNAME=sun
The LOGINNAME and MSID cannot coexist and cannot be null at the same time.
Function
The command is used to respond to the command for querying information of a CDMA user.
Parameter Description
Table 5-6 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying for the
information about a CDMA user.
z Command
ACK:QUERY C270 ACCOUNT:RETN=0, DESC=" Succeeded in querying the CDMA subscriber",
TOTAL=1, FINISHED=1, START=0, ROWNUM=1, ATTR=DOMAIN & LOGINNAME & USERGROUPID &
NEWUSERGROUPID & NEWGRPEFFECTTIME & USERGROUPNAME & NEWUSERGROUPNAME & GROUPSTATE
& USERTYPE & PAYMENTMODE & MSID & ANMSID & IP & EXTTEMPLET & STATUS & REGTIME & DEREGTIME
& MDN & IPASSIGN & IPMASK & RK & NEEDIRS & AUTHTYPE & LOCKFLAG & LOCKTIME & PSWERRORCOUNT
& IPPOOLNAME & IPPOOLID & ACCOUNTLEFT & IPPOOLTYPE & ISAUTH & MSIDENTIFIER & UIMID
& AUTHFAILCNTTRH & SSDSYNCNTTRH & SERVICESTOP & UZID & TEMPLATENAME,
RESULT="-1|test|21|-1|20380101000000|21||0|1|1|4644765|4644765|-1|-1|0|20080101
005755||123456789|0|-1||0|6|||||-1|0||1|0||0|0|20380101000000|-1|",;
Function
This command is used to modify the information about a CDMA user.
Parameter Description
Table 5-7 lists the parameters of the command for modifying the information about a CDMA
user.
Table 5-7 Parameters for the command for modifying the information about a CDMA user
Instance
The following is an instance of running the command for modifying the information about a
CDMA user.
z Scenario 1
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The EXTTEMPLET parameter is 2.
− The payment type is prepaid. That is, the PAYMENTMODE parameter is 2.
− The user status is normal. That is, the STATUS parameter is 0.
− The MSID parameter is 1234.
− The GROUPID parameter is 1.
− The new MDN is 13851771249.
− The mode of assigning the IP address is static. That is, the IPASSIGN parameter is 2.
− The IPPOOLID parameter is 3.
1. The IP address and subnet mask in the command for modifying a CDMA user must be integers.
2. The values of LOGINNAME, PSWD, and MSID are subject to the Authtype of a domain.
z When Authtype of a domain is 0, the parameters LOGINNAME, PSWD, and MSID can be
omitted.
z When Authtype of a domain is 1, the MSID cannot be omitted.
z When Authtype of a domain is 4, the LOGINNAME parameter cannot be omitted.
z When Authtype of a domain is 5, the LOGINNAME and MSID cannot be omitted.
z When Authtype of a domain is 6, the LOGINNAME and PSWD cannot be omitted.
z When Authtype of a domain is 7, the LOGINNAME, PSWD, and MSID cannot be omitted.
3. The CHGVAL parameter can be used only for the local prepaid CDMA user.
4. When the system does not support the local prepaid mode but the payment is in prepaid mode,
MDN cannot be omitted or null.
5. The values of IP, IPMASK, and IPPOOLID are subject to the mode of assigning the IP
addresses.
z When IPASSIGN is 0, IP, IPMASK, and IPPOOLID must be omitted.
z When IPASSIGN is 1, IP and IPMASK cannot be omitted. The IPPOOLID must be omitted.
z When IPASSIGN is 2, IP and IPMASK must be omitted.
z Scenario 2
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The user group needs to be replaced. That is, the REPLACEGRPFLAG parameter
is 1.
− The NEWUSERGROUPID parameter is 77.
− The effective time of the new user group is 2008-01-01-00:00:00. That is, the
NEWGRPEFFECTTIME parameter is 20080101000000. The parameter can be
null. If the parameter is null and the command is used to modify the information
about a user group, you can set the effective time of the new user group according to
the NDT or the current time.
z Command
MOD C270 ACCOUNT:DOMAIN="usr-psw-imsi", LOGINNAME=sun, REPLACEGRPFLAG=1,
NEWUSERGROUPID=77,NEWGRPEFFECTTIME=20080101000000
Function
The command is used to respond to the command for modifying information of a CDMA user.
Parameter Description
Table 5-8 lists the parameters for the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
modify the information about a CDMA user.
z Command
ACK:MOD C270 ACCOUNT:RETN=0,DESC="Succeeded in modifying the CDMA subscriber.";
Function
This command is used to change the password of an AN user.
Parameter Description
Table 5-9 lists the parameters of the command for changing the password of an AN user.
Table 5-9 Parameters of the command for changing the password of an AN user
Instance
The following is an instance of running the command for changing the password of an AN
user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The ANPSWD parameter is 000000.
z Command
MOD C270 ANPWD: ANPSWD=000000,DOMAIN=usr-psw-imsi,LOGINNAME=sun
The LOGINNAME and DOMAIN parameters must be omitted at the same time or coexist.
Function
The command is used to respond to the command for changing the password of an AN user.
Parameter Description
Table 5-10 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for changing the
user password.
z Command
ACK: MOD C270 ANPWD:RETN=0, DESC=" Changing AN password succeeded";
Function
The command is used to modify the user password in the self-service system.
Parameter Description
Table 5-11 lists the parameters of the command for changing the user password in the
self-service system.
Table 5-11 Parameters for the command for changing the user password in the self-service system
Instance
The following is an instance of running the command for changing the user password in the
self-service system.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The OLDPASSWD parameter is 123456.
− The NEWPASSWD parameter is 654321.
z Command
MOD C270 PASSWD: DOMAIN=usr-psw-imsi, OLDPASSWD=123456, NEWPASSWD=654321,
LOGINNAME=sun
Function
The command is used for the infoX-AAA system to respond to the command for modifying
the user password in the self-service system.
Parameter Description
Table 5-12 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for changing the
user password in the self-service system.
z Command
ACK: MOD C270 PASSWD:RETN=0,DESC="Succeeded in changing the CDMA subscriber
password.";
Function
This command is used to recharge a CDMA local prepaid account.
Parameter Description
Table 5-13 lists the parameters of the command for recharging a CDMA local prepaid
account.
Table 5-13 Parameters for the command for recharging a CDMA local prepaid account
Instance
The following is an instance of running the command for recharging a CDMA local prepaid
account.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The CHGVAL parameter is 2000 cents.
z Command
CHARGE C270 ACCOUNT: LOGINNAME=sun, DOMAIN=usr-psw-imsi, CHGVAL=2000
The LOGINNAME and MSID cannot coexist and cannot be null at the same time.
Function
The command is used to respond to the command for recharging a CDMA local prepaid
account.
Parameters Description
Table 5-14 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for recharging a
local prepaid CDMA user.
z Command
ACK:CHARGE C270 ACCOUNT:RETN=0, DESC="Cash recharging succeeded.";
Function
This command is used to query for the bill of a CDMA account.
Parameters Description
Table 5-15 lists the parameters of the command for querying a bill.
Instance
The following is an instance of running the command for querying for a bill.
z Scenario
− The LOGINAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
− The BILLTIME parameter is 20060901010101.
z Command
QUERY C270 BILL:LOGINNAME=sun, DOMAIN=usr-psw-imsi, BILLTIME=20060901010101
Function
The command is used to respond to the command for querying for a bill of a CDMA local
prepaid account.
Parameter Description
Table 5-16 lists the parameters of the ACK command.
ATTR List of query attribute The value must be the following string:
names that are STREAMNUMBER & LOGINNAME &
separated by the & DOMAIN & USERIP & ACCOUNTREASON &
symbol. MDN & SERVICESTARTTIME & STARTTIME
Including the & ENDTIME & SESSIONTIME &
following parameters: SESSIONVOLUME & FEE & RATEPOLICYIDX
z LOGINNAME: & GROUPID & SERVICEID
login name.
z ACCOUNTREASO
N: bill type.
z MDN: mobile phone
number.
z SERVICESTARTTI
ME: time of access.
z STARTTIME: time
of last request.
z ENDTIME: time of
current request.
z SESSIONTIME:
session duration.
z SESSIONVOLUME
: session volume.
z FEE: online fee.
RESULT List of queried data. Result set returned by the operation command
Every two lines are according to the actual situation.
separated by the &
symbol, and every two
parameters are
separated by the |
symbol.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying for a
bill.
z Command
ACK: QUERY C270 BILL:RETN=0, DESC="Querying the bill succeeded.", TOTAL=211,
FINISHED=1, START=200, ROWNUM=11, ATTR=STREAMNUMBER & L
OGINNAME & DOMAIN & USERIP & ACCOUNTREASON & MDN & SERVICESTARTTIME & STARTTIME &
ENDTIME & SESSIONTIME & SESSIONVOLUME & FEE & RATEPOLICYIDX & GROUPID & SERVICEID,
RESULT="211|sun|usr-psw-imsi|10.164.9.72|2||20060916180725|20060
916180725|20060916180726|3|0|1|3|1|10000|&217|sun|usr-psw-imsi|10.164.9.72|2||2
0060916180731|20060916180731|20060916180732|3|0
|1|3|1|10000|&218|sun|usr-psw-imsi|10.164.9.72|2||20060916180732|
20060916180732|20060916180733|3|0|1|3|1|10000|&219|sun|-1|10.164.9.72|2||200609
16180733|20060916180733|20060916180734|3|0|1|3|1|10000|&220|sun|1|10.164.9.72|2
||20060916180734|20060916180734|20060916180735|3|0|1|3|1|10000|&221|sun|-1|10.1
64.9.72|2||20060916180734|20060916180734|20060916180737|3|0|1|3|1|10000|",
Function
The command is used for CDMA users to query for the start time and accumulative service
usage of a service.
Parameter Description
Table 5-17 lists the parameters of the QUERY C270 USAGE command.
Instance
The following is an instance of running the command to query for the start time and
accumulative service usage of a service.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
z Command
QUERY C270 USAGE:LOGINNAME="sun",DOMAIN="usr-psw-imsi"
z If a user omits the service ID in the command, the user can query for the start periods and
accumulative service usage of the services in the user group that the user belongs to. Currently, one
user group can associate with only one service.
z If the user enters the ID of a service in the command, the user can query for the start time and
accumulative service usage of the service.
5.2.18 ACK to Command for Querying for the Start Time and
Accumulative Usage of a Service
Command
ACK: QUERY C270 USAGE
Function
The command is used to respond to the command for CDMA users to query for the start time
and accumulative service usage of a service.
Parameter Description
Table 5-18 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for CDMA users to
query for the start time and accumulative service usage of a service.
z Command
ACK:QUERY C270 USAGE: RETN=0, DESC="Querying for the service start time and
accumulative service usage succeeded.", TOTAL=1, FINISHED=1, START=0, ROWNUM=1,
ATTR= LASTDEDUCTTIME & ACCUTIME & ACCUFLOW, RESULT="20071101000000|32600|0|",;
Section Describes
6.1 Introduction The functions of the MML interfaces in the WCDMA service.
6.2 MML Commands The commands MML relevant to the WCDMA service.
6.1 Introduction
The MML interfaces of the infoX-AAA supports the WCDMA service. Through the MML
interfaces, you can add and delete a WCDMA user, and modify and query the user
information in the billing system.
In the MML commands of the WCDMA service, the value of Service name of all the MML
commands are C260.
The acknowledgement (ACK) command is used for the infoX-AAA to respond to the running of an
MML command. For example, the ACK command of adding a WCDMA user is the response of the
command for adding a WCDMA user to the infoX-AAA.
Function
The command is used to add a WCDMA user.
Parameter Description
Table 6-1 lists the parameters of the command for adding a WCDMA user.
Instance
The following is an instance of running the command for adding a WCDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The USERGROUPID parameter is 12.
− The PAIDTYPE parameter is 2. The USERTYPE parameter is 1.
− The CHARGEAMOUNT parameter is 5000.
− The PSWD parameter is 123456.
− The DOMAIN parameter is usr-psw-callnum.
− The TEMPLATEID parameter is 1.
− The IPADDRESS parameter is 16843009. The IP address is 1.1.1.1 in the dotted
format.
− The IPMASK parameter –256. The IP address is 255.255.255.0 in the dotted format.
− The MSID parameter is 13851771249.
− The RESETINTERVAL parameter is 1 day.
− The APNNAME parameter is test-apn.
− The IMSI parameter is 111111111.
1. When you add a WCDMA user who is a prepaid user, the value of MSID cannot be omitted.
2. The IP address and subnet mask exist in the command for adding a WCDMA user must be
integers.
3. Whether to enter the values of LOGINNAME, PSWD, and MSID is subject to the value of
Authtype of a domain.
z When Authtype of a domain is 0, LOGINNAME, PSWD, and MSID can be omitted.
z When Authtype of a domain is 1, MSID cannot be omitted.
z When Authtype of a domain is 5, LOGINNAME and MSID cannot be omitted.
z When Authtype of a domain is 6, LOGINNAME and PSWD cannot be omitted.
z When Authtype of a domain is 7, LOGINNAME, PSWD, and MSID cannot be omitted.
4. The IPADDRESS, IPMASK, and IPPOOLID parameters are connected in the following manner:
z The IPADDRESS and IPMASK parameters cannot exist at the same time or must coexist.
z When IPADDRESS, IPMASK, and IPPOOLID coexist, IPADDRESS or IPPOOLID must be –1.
When IPADDRESS is –1, IPMASK must also be –1.
z If only IPADDRESS and IPMASK exist, IPADDRESS cannot be –1.
z If only IPPOOLID exists, IPPOOLID cannot be –1.
Function
The command is used to respond to the command for adding a WCDMA user.
Parameter Description
Table 6-2 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for adding a
WCDMA user.
z Command
ACK:ADD C260 ACCOUNT: RETN=0, DESC="Succeeded in registering the WCDMA user.";
Function
The command is used to delete a WCDMA user.
Parameter Description
Table 6-3 lists the parameters of the command for deleting a WCDMA user.
Instance
The following is an instance of running the command for deleting a WCDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-callnum.
− Do not delete all the user information. That is, the REMOVEALL parameter is 0.
z Command
DEL C260 ACCOUNT: DOMAIN=-1,REMOVEALL=0,LOGINNAME=sun
In the command for deleting the WCDMA user, you can enter the values of LOGINNAME and
DOMAIN; or enter the value of MSID.
Function
The command is used for the infoX-AAA system to respond to the command for deleting a
WCDMA user.
Parameter Description
Table 6-4 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for deleting a
WCDMA user.
z Command
ACK:DEL C260 ACCOUNT: RETN=0, DESC="Succeeded in deregistering the WCDMA
user.",TOTAL=1, FINISHED=1, START=0, ROWNUM=1, ATTR=USERNAME, RESULT="sun|0|"
Function
This command is used to query for the information of a WCDMA user.
Parameter Description
Table 6-5 lists the parameters of the command for querying for the information about a
WCDMA user.
Table 6-5 Parameters of the command for querying for the user information
Instance
The following is an instance of running the command for querying the information about a
WCDMA user.
z Scenario
− The LOGINNAME parameter is 13800000000.
− The DOMAIN parameter is nanjing.
z Command
QUERY C260 ACCOUNT:DOMAIN=nanjing,LOGINNAME=13800000000
In the command for querying for the WCDMA user information, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for querying for the information about a
WCDMA user.
Parameter Description
Table 6-6 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying a
WCDMA user.
z Command
ACK:QUERY C260 ACCOUNT:RETN=0, DESC="Succeeded in querying the WCDMA user.", TOTAL=1,
FINISHED=1, START=0, ROW
NUM=1, ATTR=APNNAME & LOGINNAME & DOMAIN & MSID & IMSI & IPADDRESS & IPMASK & IPPOOLID
& IPPOOLNAME & IPPOOLTYPE & MAXUSERNUMBER & TEMPLATEID &
TEMPLATENAME & TEMPLATETYPE & RESETINTERVAL & STATUS & LOCKFLAG & PWATTEMPT
& LOCKTIME & REGTIME & DEREGTIME & AUTHTYPE & USERGROUPID & GROUPNAME & PAIDTYPE
& USERTYPE & NEWGROUPID & NEWGROUPNAME & NEWGROUPEFFECTTIME
& ACCOUNTLEFT & RESERVETOTAL,
RESULT="|13800000000|nanjing|4444|465777|-1|-1|-1|||0|-1|||1|0||||2007081311013
9||0|2|34|2|1|-1||20380101000000|500000|0|";
Function
This command is used to modify information about a WCDMA user.
Parameter Description
Table 6-7 lists the parameters of the command for modifying the information about a
WCDMA user.
Table 6-7 Parameters of the command for modifying the user information
Parameter Description Whether Whether Value Range
Can Be Can Be
Omitted Null
Instance
The following is an instance of running the command for modifying the information about a
WCDMA user.
z Scenario
Modify the user information about the WCDMA user sun.
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-callnum.
− The TEMPLATEID parameter is 1.
− The user status is normal. That is, the STATUS parameter is 0.
− The IPMASK parameter is –1.
− The IPADDRESS parameter is –1.
− The IPPOOLID parameter is 2.
− The MSID parameter is 13851771249.
− The RESETINTERVAL parameter is 1.
− The APNNAME parameter is test-apn.
− The IMSI parameter is 111111111.
− The MAXUSERNUMBER parameter is 5.
− The NEWGROUPID parameter is 25.
− The NEWEFFECTTIME parameter is 20080808000000.
z Command
MOD C260 ACCOUNT: DOMAIN=usr-psw-callnum, TEMPLATEID=1, STATUS=0, IPMASK=-1,
IPPOOLID=2, IPADDRESS=-1, MSID="13851771249", IMSI="111111111", NEWEFFECTTIM
E=20080808000000,LOGINNAME="sun", RESETINTERVAL=1, MAXUSERNUMBER=5,
NEWGROUPID=25,APNNAME="test-apn";
In the command for modifying the WCDMA user information, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for modifying the information about a
WCDMA user.
Parameter Description
Table 6-8 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
modify the information about a WCDMA user.
z Command
ACK:MOD C260 ACCOUNT:RETN=0,DESC="Succeeded in modifying the WCDMA user.";
Function
This command is used to add WCDMA users in batches.
Parameter Description
Table 6-9 lists the parameters of the command for adding WCDMA users in batches.
Table 6-9 Parameters of the command for adding WCDMA users in batches
Instance
The following is an instance of running the command for adding WCDMA users in batches.
z Scenario
− The USERGROUPID parameter is 5.
− The PAIDTYPE parameter is 2. The USERTYPE parameter is 1.
− The STARTMSID parameter is 13800000000.
− The ENDMSID parameter is 13800009999.
− The DOMAIN parameter is usr-psw-callnum.
− The APNNAME parameter is test-apn.
z Command
ADD C260 BATCHACCOUNT: STARTMSID="13800000000", DOMAIN="usr-psw-callnum",
PAIDTYPE=2, USERTYPE=1,USERGROUPID=5, ENDMSID="13800009999", APNNAME=test-apn
Function
This command is used to respond to the command for adding WCDMA users in batches.
Parameter Description
Table 6-10 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for adding
WCDMA users in batches.
z Command
ADD C260 BATCHACCOUNT:RETN=0, DESC="Adding batch account succeeded.";
Function
This command is used to delete WCDMA users in batches.
Parameter Description
Table 6-11 lists the parameters of the command for deleting WCDMA users in batches.
Table 6-11 Parameters of the command for deleting WCDMA users in batches
Instance
The following is an instance of running the command for deleting WCDMA users in batches.
z Scenario
− The start mobile phone number is 13800000000.
− The end mobile phone number is 13800009999.
z Command
DEL C260 BATCHACCOUNT:STARTMSID=13800000000,ENDMSID=13800009999;
Function
This command is used to respond to the command for deleting WCDMA users in batches.
Parameter Description
Table 6-12 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for deleting
WCDMA users in batches.
z Command
DEL C260 BATCHACCOUNT: RETN=0, DESC="Deleting batch account succeeded.";
Function
This command is used to reset a WCDMA user.
Parameter Description
Table 6-13 lists the parameters of the command for resetting a WCDMA user.
Instance
The following is an instance of running the command for resetting a WCDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-callnum.
− The MSID parameter is 13851771249.
z Command
RESET C260 USERCON: LOGINNAME=sun, DOMAIN=usr-psw-callnum, MSID=13851771249;
In the command for changing the password of the WCDMA user, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
This command is used to respond to the command for resetting a WCDMA user.
Parameter Description
Table 6-14 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for resetting a
WCDMA user.
z Command
RESET C260 USERCON: RETN=0, DESC="Succeed in resetting the concurrent number of
account.";
Function
This command is used to change the password of a WCDMA user.
Parameter Description
Table 6-15 lists the parameters of the command for changing the password of a WCDMA
user.
Table 6-15 Parameters of the command for changing the password of a WCDMA user
Instance
The following is an instance of running the command for changing the password of a
WCDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
− The PSWD parameter is 000000.
z Command
MOD C260 ACCOUNT: DOMAIN=test-usr-psw-msid, LOGINNAME=sun, PSWD=000000
In the command for changing the password of the WCDMA user, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for changing the password of a WCDMA
user.
Parameter Description
Table 6-16 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
change the password of a WCDMA user.
z Command
ACK: MOD C260 ACCOUNT:RETN=0,DESC="Modifying password succeeded.";
Function
The command is used to unlock a WCDMA user.
Parameter Description
Table 6-17 lists the parameters of the command for unlocking a WCDMA user.
Instance
The following is an instance of running the command for unlocking the WCDMA user.
z Scenario
− The LOGINNAME parameter is sun.
− The LOCKFLAG parameter is 0.
− The DOMAIN parameter is test-usr-psw-msid.
z Command
MOD C260 ACCOUNT:LOCKFLAG=0,DOMAIN="test-usr-psw-msid ",LOGINNAME="sun"
In the command for unlocking the WCDMA user, you can enter the values of LOGINNAME and
DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for unlocking a WCDMA user.
Parameter Description
Table 6-18 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for unlocking the
WCDMA user.
z Command
ACK: MOD C260 ACCOUNT:RETN=0,DESC="Succeeded in unlocking the WCDMA user.";
Function
This command is used to recharge a prepaid WCDMA account.
Parameter Description
Table 6-19 lists the parameters of the command for recharging a prepaid WCDMA account.
Table 6-19 Parameters of the command for recharging a prepaid WCDMA account
Instance
The following is an instance of running the command for recharging a prepaid WCDMA
account.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
− The CHGVAL parameter is 5000.
z Command
CHARGE C260 ACCOUNT: LOGINNAME="sun", DOMAIN="test-usr-psw-msid", CHGVAL=5000
In the command for recharging the prepaid WCDMA account, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
This command is used to respond to the command for recharging a prepaid WCDMA account.
Parameter Description
Table 6-20 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for recharging a
prepaid WCDMA account.
z Command
ACK: CHARGE C260 ACCOUNT:RETN=0, DESC="Cash recharge succeeded.";
Function
The command is used to order a service for a WCDMA user.
Parameter Description
Table 6-21 lists the parameters of the command for ordering a service for a WCDMA user.
Table 6-21 Parameters of the command for ordering a service for a WCDMA user
Instance
The following is an instance of running the command for ordering a service for the WCDMA
user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is nanjing.
− The SERVICEID parameter is 2.
z Command
ADD C260 ORDER:DOMAIN="nanjing",SERVICEID="2",LOGINNAME="sun"
In the command for ordering a service for the WCDMA user, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for ordering a service for a WCDMA user.
Parameter Description
Table 6-22 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
order a service for the WCDMA user.
z Command
ACK: ADD C260 ORDER:RETN=0,DESC="Add order service success.";
Function
The command is used to cancel the order of a WCDMA user.
Parameter Description
Table 6-23 lists the parameters of the command for canceling the order of a WCDMA user.
Table 6-23 Parameters of the command for canceling the order of a WCDMA user
Instance
The following is an instance of running the command for canceling the order of the WCDMA
user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is nanjing.
− The SERVICEID parameter is 2.
z Command
DEL C260 ORDER:DOMAIN="nanjing",SERVICEID=2,LOGINNAME="sun"
In the command for canceling the order of the WCDMA user, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
The command is used to respond to the command for canceling the order of a WCDMA user.
Parameter Description
Table 6-24 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
cancel the order of the WCDMA user.
z Command
ACK: DEL C260 ORDER:RETN=0,DESC="Canceling the order succeeded";
Function
This command is used to query for the bills of a WCDMA user.
Parameter Description
Table 6-25 lists the parameters of the command for querying for the bills of a WCDMA user.
Table 6-25 Parameters of the command for querying for the bills of a WCDMA user
Instance
The following is an instance of running the command for querying for the bills of a WCDMA
user.
z Scenario
− The LOGINNAME parameter is 13800000000.
− The DOMAIN parameter is nanjing.
− The BILLTIME parameter is 20070801000000.
z Command
QUERY C260 BILL:BILLTIME="20070801000000", DOMAIN="nanjing",
LOGINNAME="13800000000"
In the command for querying for the bills of a WCDMA account, you can enter the values of
LOGINNAME and DOMAIN; or enter the value of MSID.
Function
This command is used to respond to the command for querying for the bills of a WCDMA
user.
Parameter Description
Table 6-26 lists the parameters of the ACK command.
ATTR List of query attribute names that are The value must be the following
separated by the & symbol. string:
The attribute names are as follows: STREAMNUMBER &
z STREAMNUMBER: stream number ACCOUNTREASON &
USERNAME & DOMAIN &
z ACCOUNTREASON: reason for USERTYPE & APNNAME &
accounting USERIP & IMSI &
z USERNAME: login name CALLINGST
z DOMAIN: domain name ATIONID & SESSIONID &
z USERTYPE: user type CHARGEID & PDPTYPE &
SERVICESTARTTIME &
z APNNAME: APN that a user belongs STARTTIME & ENDTIME &
to TIMELENGTH &
z USERIP: user's IP address CHARGEVOLUMN & FEE &
z IMSI: IMSI number of the user's GROUPID & SERVICEID &
mobile phone SERVICENAME & SGSNIP &
GGSNIP & RATINGGROUP &
z CALLINGSTATIONID: calling TERMCAUSE
number
z SESSIONID: session ID
z CHARGEID: ID of the charge policy
z PDPTYPE: Packet Data Protocol
(PDP) type
z SERVICESTARTTIME: online
duration
z STARTTIME: time when the previous
accounting request is sent
z ENDTIME: current request time
z TIMELENGTH: Charging duration
z CHARGEVOLUMN: charging volume
z FEE: fee for the Internet access
z GROUPID: ID of the user group
z SERVICEID: service ID
z SERVICENAME: service name
z SGSNIP: IP address of the serving
GPRS support node (SGSN)
z GGSNIP: IP address of the gateway
GPRS support node (GGSN)
z RATINGGROUP: flag of the rating
group
z TERMCAUSE: reason why the session
terminates
z MSID: mobile phone number
z USERNAME: User's login name
z DOMAIN: home domain of the user
z USERIP: user's IP address
z CORRELATIONID: ID of the
accounting session
Issue 04 (2007-12-29) z ACCOUNTREASON:
Huawei Technologiesaccounting
Proprietary 6-41
reason
z SERVICENAME: service name
z STARTTIME: start time of the
infoX-AAA
6 MML Interfaces for WCDMA Service Interface Developer Guide - MML
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying for the
bills of the WCDMA user.
z Command
ACK: QUERY C260 BILL:RETN=0, DESC="Querying the bill succeeded.", TOTAL=3,
FINISHED=1, START=0, ROWNUM=3, ATTR=STREAMNUMBER & ACCOUNTREASON & USERNAME & DOMAIN
& USERTYPE & APNNAME & USERIP & IMSI & CALLINGSTATIONID & SESSIONID & CHARGEID &
PDPTYPE & SERVICESTARTTIME & STARTTIME & ENDTIME & TIMELENGTH & CHARGEVOLUMN & FEE
& GROUPID & SERVICEID & SERVICENAME & SGSNIP & GGSNIP & RATINGGROUP & TERMCAUSE,
RESULT="2|3|13800000000|nanjing|1||10.164.108.208|
imsi-test|13800000000|s59773:huawei|1|0|20070808093458|20070808093458|
20070813054829|418411|0|418411|2|1|FtpService|||1|-1|&3|3|13800000000|nanjing
|1||10.164.108.208|imsi-test|13800000000|s59773:huawei|1|0|20070808095603|
20070808095603|20070813060934|418411|0|418411|2|1|FtpService|||1|-1|&1|3|
13800000000|nanjing|1||10.164.108.208|imsi-test|13800000000|s59773:huawei|1|0|
20070808103244|20070808103244|20070809030857|59773|0|59773|2|1|FtpService|||1|-
1|";
Function
The command is used for WCDMA users to query for the start time and accumulative service
usage of a service.
Parameter Description
Table 6-27 lists the parameters of the QUERY C260 USAGE command.
Instance
The following is an instance of running the command to query for the start time and
accumulative service usage of a service.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is usr-psw-imsi.
z Command
QUERY C260 USAGE:LOGINNAME="sun",DOMAIN="usr-psw-imsi"
z If a user omits the service ID in the command, the user can query for the start periods and
accumulative service usage of the services in the user group that the user belongs to. Currently, one
user group can associate with only one service.
z If the user enters the ID of a service in the command, the user can query for the start time and
accumulative service usage of the service.
6.2.28 ACK to Command for Querying for the Start Time and
Accumulative Usage of a Service
Command
ACK: QUERY C260 USAGE
Function
The command is used to respond to the command for WCDMA users to query for the start
time and accumulative service usage of a service.
Parameter Description
Table 6-28 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for WCDMA users
to query for the start time and accumulative service usage of a service.
z Command
ACK:QUERY C260 USAGE: RETN=0, DESC="Querying for the service start time and
accumulative service usage succeeded.", TOTAL=1, FINISHED=1, START=0, ROWNUM=1,
ATTR= LASTDEDUCTTIME & ACCUTIME & ACCUFLOW, RESULT="20071101000000|32600|0|",;
Section Describes
7.1 Introduction The functions of the MML interface in the WiMAX service.
7.2 MML Commands The MML commands relevant to the WiMAX service.
7.1 Introduction
The MML interfaces of the infoX-AAA supports the WiMAX service. Through the MML
interfaces, you can add and delete a WiMAX user, and modify and query for the user
information in the billing system.
In the MML commands of the WiMAX service, the services of all the MML commands are
named C330.
The acknowledgement (ACK) command is used for the infoX-AAA to respond to the running of an
MML command. For example, the ACK command for adding a WiMAX user is the response of the
command for adding a WiMAX user to the infoX-AAA.
Function
This command is used to add a WiMAX user.
Parameter Description
Table 7-1 lists the parameters of the command for adding a WiMAX user.
Instance
The following is an instance of running the command for adding a WiMAX user.
z Scenario
− The DOMAIN parameter is test-usr-psw-msid.
− The TEMPLATEID parameter is 1.
− The mode of assigning the IP address is static. That is, the IPASSIGNWAY
parameter is 1.
− The IPADDRESS parameter is 168430090.
− The IPMASK parameter is –256.
− The BSID parameter is 111111111111
− The MSID parameter is 222222222222.
− The USERGROUPID parameter is 12.
− The LOGINNAME parameter is sun. The PSWD parameter is 123456.
− The payment type is prepaid. That is, the PAIDTYPE parameter is 2.
− The CHARGEAMOUNT parameter is 5000 cents.
z Command
ADD C330
USER:DOMAIN=test-usr-psw-msid,TEMPLATEID=1,IPASSIGNWAY=1,IPMASK=-256,BSID=11111
1111111,CHARGEAMOUNT=5000,IPADDRESS=168430090,MSID=222222222222,USERGROUPID=12,
LOGINNAME=sun,PAIDTYPE=2,PSWD=123456
1. The IP address and subnet mask in the command for adding a WiMAX user must be integers.
2. The values of LOGINNAME, PSWD, and MSID are subject to Authtype of a domain.
z When Authtype of a domain is 1, MSID cannot be omitted.
z When Authtype of a domain is 3, PSWD and MSID cannot be omitted.
z When Authtype of a domain is 5, LOGINNAME and MSID cannot be omitted.
z When Authtype of a domain is 6, LOGINNAME and PSWD cannot be omitted.
z When Authtype of a domain is 7, LOGINNAME, PSWD, and MSID cannot be omitted.
3. The parameters IPADDRESS, IPMASK, and IPPOOLID are connected in the following manner:
z When IPASSIGNWAY is 0, IPAddress, IPMASK, and IPPOOLID must be omitted.
z When IPASSIGNWAY is 1, IPADDRESS and IPMASK cannot be omitted, but IPPOOLID must
be omitted.
z When IPASSIGNWAY is 2, IPADDRESS and IPMASK must be omitted, but IPPOOLID cannot
be omitted.
4. Whether to enter the value of BSID is subject to the user group type. When the user group type is
fixed user, the value of BSID must be entered; otherwise, you need not enter the value of BSID.
Function
The command is used to respond to the command for adding a WiMAX user.
Parameter Description
Table 7-2 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for adding a
WiMAX user.
z Command
ACK:ADD C330 USER: RETN=0, DESC="Adding user succeeded.";
Function
This command is used to delete a WiMAX user.
Parameter Description
Table 7-3 lists the parameters of the command for deleting a WiMAX user.
Instance
The following is an instance of running the command for deleting a WiMAX user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
− Delete all the user information. That is, the REMOVEALL parameter is 1.
z Command
DEL C330 USER: LOGINNAME=sun, DOMAIN=test-usr-psw-msid, REMOVEALL=1;
If the command for deleting a WiMAX user does not contain REMOVEALL, REMOVEALL is 0.
That is, all the user information is reserved.
Function
This command is used to respond to the command for deleting a WiMAX user.
Parameter Description
Table 7-4 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
delete the information about a WiMAX user.
z Command
ACK:DEL C330 USER:RETN=0,DESC=" Deleting user succeeded.";
Function
This command is used to modify the information about a WiMAX user.
Parameter Description
Table 7-5 lists the parameters of the command for modifying the information about a WiMAX
user.
Table 7-5 Parameters of the command for modifying the information about a WiMAX user.
Instance
The following is an instance of running the command for modifying the information about a
WiMAX user.
z Scenario
When you modify the information about a WiMAX user , the parameter values are as
follows:
− The LOGINAME parameter is sun.
− The LOGINNAME parameter is test-usr-psw-msid.
− The TEMPLATEID parameter is 1.
− The user status is normal. That is, the STATUS parameter is 0.
− The BSID parameter is 111111111111
− The MSID parameter is 222222222222.
− The USERGROUPID parameter is 12.
− The paid type is prepaid. That is, the PAIDTYPE parameter is 2.
− The IPPOOLID parameter is 1.
− The NEWUSERGROUPID parameter is 25.
− The NEWGRPEFFECTTIME parameter is 20070714000000.
z Command
MOD C330 USER:DOMAIN=test-usr-psw-msid, TEMPLATEID=1, IPASSIGNWAY=2, IPPOOLID=1,
STATUS=0, NEWUSERGROUPID=25, BSID=111111111111, NEWGRPEFFECTTIME=20070714000000,
MSID="222222222222", USERGROUPID=12, LOGINNAME=sun
1. The IP address and subnet mask in the command for adding a WiMAX user must be integers.
2. The values of LOGINNAME, PSWD, and MSID are subject to Authtype of a domain.
z When Authtype of a domain is 1, the MSID cannot be omitted.
z When Authtype of a domain is 3, the PSWD and MSID cannot be omitted.
z When Authtype of a domain is 5, the LOGINNAME and MSID cannot be omitted.
z When Authtype of a domain is 6, the LOGINNAME and PSWD cannot be omitted.
z When Authtype of the DOMAIN is 7, the LOGINNAME, PSWD, and MSID cannot be omitted.
3. The parameters IPADDRESS, IPMASK, and IPPOOLID are connected in the following manner:
z When IPASSIGNWAY is 0, IPAddress, IPMASK, and IPPOOLID must be omitted.
z When IPASSIGNWAY is 1, IPADDRESS and IPMASK cannot be omitted, but IPPOOLID must
be omitted.
z When IPASSIGNWAY is 2, IPADDRESS and IPMASK must be omitted, but IPPOOLID cannot
be omitted.
4. Whether to enter the value of BSID is subject to the user group type. When the user group type is
fixed user, the value of BSID must be entered; otherwise, you need not enter the value of BSID.
Function
The command is used for the infoX-AAA system to respond to the command for modifying
the information about a WCDMA user.
Parameter Description
Table 7-6 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
modify the information about a WiMAX user.
z Command
ACK: MOD C330 USER: RETN=0, DESC="Modifying user succeeded.";
Function
This command is used to query for the information about a WiMAX user.
Parameter Description
Table 7-7 lists the parameters of the command for querying for the information about a
WiMAX user.
Table 7-7 Parameters of the command for querying for the information about a WiMAX user
Parameter Description Whether Whether Value Range
Can Be Can Be
Omitted Null
Instance
The following is an instance of running the command for querying for the information about a
WiMAX user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
z Command
QUERY C330 USER: LOGINNAME=sun , DOMAIN= test-usr-psw-msid
Function
This command is used to respond to the command for querying for the information about a
WiMAX user.
Parameter Description
Table 7-8 lists the parameters of the ACK command.
ATTR List of query attribute names that are The value must be the following
separated by the & symbol. string:
The following parameters are LOGINNAME & DOMAIN &
included: USERGROUPID &
z LOGINNAME: login name USERGROUPNAME &
PAIDTYPE & MSID &
z DOMAIN: home domain IPASSIGNWAY & IPADDRESS &
z USERGROUPID: user group ID IPMASK & IPPOOLID &
z USERGROUPNAME: user group IPPOOLNAME & TEMPLATEID
name & TEMPLATENAME &
NEWUSERGROUPID &
z PAIDTYPE: paid type of the NEWUSERGROUPNAME &
WiMAX user NEWGRPEFFECTTIME & BSID &
z MSID: MSID of a WiMAX user STATUS
z IPASSIGNWAY: mode of
assigning the IP address
z IPADDRESS: IP address that is
assigned statically
z IPMASK: subnet mask of the IP
address
z IPPOOLID: ID of the IP address
pool
z IPPOOLNAME: name of the IP
address pool
z TEMPLATEID: template ID
z TEMPLATENAME: template
name
z NEWUSERGROUPID: new user
group ID
z NEWUSERGROUPNAME: new
user group name
z NEWGRPEFFEC TTIME: time
when the new user group takes
effect
z BSID: BSID that a user belongs to
z STATUS: status of a user
RESULT List of queried data. Every two lines Result set returned by the operation
are separated with the & symbol, and command based on the actual
every two parameters are separated situation.
with the | symbol.
Instance
The following is an instance how to run the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
query for the information about a WiMAX user.
z Command
ACK: QUERY C330 USER: RETN=0, DESC="Modifying user succeeded.", TOTAL=1, FINISHED=1,
START=0, ROWNUM=1,ATTR =LOGINNAME & DOMAIN & USERGROUPID & USERGROUPNAME & PAIDTYPE
& MSID & IPASSIGNWAY & IPADDRESS & IPMASK & IPPOOLID & IPPOOLNAME & TEMPLATEID &
TEMPLATENAME & NEWUSERGROUPID & NEWUSERGROUPNAME & NEWGRPEFFECTTIME & BSID & STATUS,
RESULT=
"sun|-1|2|mhq_test1|1|222222222222|0|-1|-1|-1||-1||-1||20380101000000|111111111
111|0|",;
Function
This command is used to change the password of a WiMAX user.
Parameter Description
Table 7-9 lists the parameters of the command for changing the password of a WiMAX user.
Table 7-9 Parameters of the command for changing the password of a WiMAX user
Instance
The following is an instance of running the command for changing the password of a WiMAX
user.
z Scenario
− The LOGINNAME parameter is sun.
− The LOGINNAME parameter is test-usr-psw-msid.
− The PSWD parameter is 000000.
z Command
MOD C330 PASSWD: DOMAIN=test-usr-psw-msid, LOGINNAME=sun, PSWD=000000
Function
The command is used to respond to the command for changing the password of a WiMAX
user.
Parameter Description
Table 7-10 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command for changing the password of a
WiMAX user.
z Scenario
The infoX-AAA responds to the successful running of the command for the operator to
change the password of a WiMAX user.
z Command
ACK:MOD C330 PASSWD:RETN=0,DESC="Modifying password succeeded.";
Function
This command is used to recharge a prepaid WiMAX user.
Parameter Description
Table 7-11 lists the parameters of the command for recharging a prepaid WiMAX user.
Table 7-11 Parameters of the command for recharging a prepaid WiMAX user
Instance
The following is an instance of running the command for recharging a prepaid WiMAX user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
− The CHGVAL parameter is 5000 cents.
z Command
CHARGE C330 ACCOUNT: LOGINNAME="sun", DOMAIN="test-usr-psw-msid", CHGVAL=5000
Function
This command is used to respond to the command for recharging a prepaid WiMAX user.
Parameter Description
Table 7-12 lists the parameters of the ACK command.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for recharging a
prepaid WiMAX user.
z Command
ACK:CHARGE C330 ACCOUNT:RETN=0, DESC="Cash recharge succeeded.";
Function
This command is used to query for the bill of a WiMAX user.
Parameter Description
Table 7-13 lists the parameters of the command for querying for the bill of a WiMAX user.
Table 7-13 Parameters of the command for querying for the bill of a WiMAX user
Instance
The following is an instance of running the command for querying for the bill of a WiMAX
user.
z Scenario
− The LOGINNAME parameter is sun.
− The DOMAIN parameter is test-usr-psw-msid.
− The BILLTIME parameter is 20070601000000.
z Command
QUERY C330 BILL: BILLTIME="20070601000000", DOMAIN="test-usr-psw-msid",
LOGINNAME="sun"
Function
This command is used to respond to the command for querying for the bill of a WiMAX user.
Parameter Description
Table 7-14 lists the parameters of the ACK command.
ATTR List of query attribute names The value must be the following string:
that are separated by the & MSID & USERNAME & DOMAIN &
symbols. USERIP & CORRELATIONID &
The included parameters are ACCOUNTREASON & SERVICENAME &
as follows: SERVICESTARTTIME & STARTTIME &
z MSID: ID of the mobile ENDTIME & SESSIONTIME &
station SESSIONVOLUME & RATEPOLICYIDX
& FEE & USERGROUPID & SERVICEID
z USERNAME: user login
name
z DOMAIN: home domain
of the user
z USERIP: user IP address
z CORRELATIONID:
RADIUS session ID
z ACCOUNTREASON:
accounting reason
z SERVICENAME: service
name
z SERVICESTARTTIME:
access time
z STARTTIME: last request
time
z ENDTIME: current
request time
z SESSIONTIME: session
duration
z SESSIONVOLUME:
session volume
z RATEPOLICYIDX:
charge policy
z FEE: fee for Internet
access in this time
z USERGROUPID: user
group ID
z SERVICEID: service ID
RESULT List of queried data. Every Result set returned by the operation
two lines are separated by command based on the actual situation.
the & symbol, and every
two parameters are separated
with the | symbol.
Instance
The following is an instance of running the ACK command.
z Scenario
The infoX-AAA responds to the successful running of the command for querying for the
bill of a WiMAX user.
z Command
ACK: QUERY C330 BILL:RETN=0, DESC="Querying the bill succeeded.", TOTAL=2,
FINISHED=1, START=0, ROWNUM=2, ATTR= MSID & USERNAME & DOMAIN & USERIP & COR
RELATIONID & ACCOUNTREASON & SERVICENAME & SERVICESTARTTIME & STARTTIME & ENDTIME
& SESSIONTIME & SESSIONVOLUME & RATEPOLICYIDX & FEE & USERGROUPID & SERVICEID,
RESULT="
222222222222|sun|test-usr-psw-msid|10.10.10.1|00000021|2|month5000|200706092340
00|20070609234000|20070610001320|2000|2048000|4|2000|12|4|&222222222222|sun|tes
t-usr-psw-msid|||5|month5000|20070609234000|20070609234000|20070701000000|0|0|4
|5000|12|4|";
A Checksum’s code
A
AAA Authentication, Authorization and Accounting
ACD Automatic Call Distributor
ADP Voice Mailbox Interface Card
API Application Program Interface
ASCII American Standard Code for Information Interchange
ASN Access Service Network
ASN-GW ASN Gateway
B
BCD Binary Coded Decimal
BOD Bandwidth On Demand
BS Base Station
C
CAD Computer Aided Design
CCP Common Communication Proxy
CCS Call Center Server
CDMA Code Division Multiple Access
CDR Call Detail Record
CHAP Challenge Handshake Authentication Protocol
CID Call Instance Data
COA Care-of-Address
COM Component Object Model
D
DB Database
DCOM Distributed Component Object Model
DHCP Dynamic Host Configuration Protocol
DLL Data Link Layer
DRV Dual Tone Number Receiving & Drive Board
E
EAP Extensible Authentication Protocol
FAX Facsimile
FP Fax Peripheral
G
GGSN Gateway GPRS Support Node
GSL Global Service Logic
GUI Graphic User Interface
H
HA Home Agent
HLR Home Location Register
I
ICD Intelligent Call Distribution
ID Identity
IKE Internet Key Exchange
INT Integration
INtess Intelligent Service System
IMSI International Mobile Station Identity
IP Intelligent Peripherals
IPsec IP Security
IRC Call Routing Control
ISCC Integrated Service Control Center
ISDN Integrated Services Digital Network
ISP Internet Service Provider
IVR Interactive Voice Response
L
LAC Link Access Control
M
MAC Medium Access Control
MIP Mobile Internet Protocol
MML Man Machine Language
MS Mobile Station
MSID Mobile Station ID
MSK Master Session Key
N
NAI Network Access Identifier
NT Network Terminal
O
ODBC Open Database Connectivity
OPS Operator Service
P
PAP Password Authentication Protocol
PC Personal Computer
PCF Packet Control Function
PDSN Packet Data Serving Node
PHB Per Hop Behavior
PPP Point-to-Point Protocol
Q
QoS Quality of Service
R
RADIUS Remote Authentication Dial In User Service
S
SCE Service Creation Environment
SIB Service Independent Block
SIG Signal Tone Board
SIP Simple Internet Protocol
SM Switching Module
SMP Service Management Point
SMS Service Management System
SMSC Short Message Service Center
SMTP Simple Mail Transfer Protocol
SOAP Simple Object Access Protocol
SP Service Provider
SPT Special Tone Board
SQL Structured Query Language
SSD Service Support Data
SSP Service Switching Point
T
TCP Transmission Control Protocol
TTS Text To Speech
U
UDHI User Data Head Indicator
UDP User Datagram Protocol
UL Uplink
V
VP Voice Peripheral
W
WCDMA Wide Code Division Multiple Access
WIN Wireless Intelligent Network
WCDMA Wide Code Division Multiple Access
Index
broadband
B response to the command for modifying a
broadband password, 5-33
registering a broadband User, 5-4 broadband
broadband port restriction, 5-34
response to the command for registering a broadband
broadband user, 5-7 response to the command for port restriction, 5-35
broadband broadband
modifying a broadband user, 5-10 cash recharge, 5-36
broadband broadband
response to the command for modifying a response to the command for cash recharge, 5-37
broadband user, 5-13 broadband
broadband rolling back cash recharge, 5-39
deregistering a broadband user, 5-15 broadband
broadband response to the command for rolling back cash
response to the command for deregistering a recharge, 5-39
broadband User, 5-16 broadband
broadband querying recharge records, 5-40
querying a broadband user, 5-17 broadband
broadband response to the command for querying recharge
response to the command for querying broadband records, 5-42
user information, 5-18 broadband
broadband querying bills, 5-45
querying an account, 5-21 broadband
broadband response to the command for querying bills, 5-46
response to the command for querying an account, broadband
5-22 command for subscribing to broadband services,
broadband 5-49
activating an account, 5-26 broadband
broadband response to the command for subscribing to a
response to the command for activating an account, broadband service, 5-51
5-27 broadband
broadband unsubscribing a broadband service, 5-54
deactivating an account, 5-28 broadband
broadband response to the command for unsubscribing a
response to the command for deactivating an broadband service, 5-55
account, 5-29 broadband
broadband querying subscribed broadband services, 5-57
resetting an account, 5-30 broadband
broadband response to the command for querying subscribed
response to the command for resetting an account, services, 5-58
5-31
broadband
modifying a password, 5-32
i.