Parameters Description
6 MML Interfaces for WCDMA Service
6.2.26 ACK to the Command for Querying for the Bills of a WCDMA User
Command
ACK: QUERY C260 BILL
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.
Table 6-26 Parameters of the ACK command
Parameter Description Value Range
RETN Return codes of the ACK command. A decimal integer.
The return codes are as follows:
z 0: Querying the bill succeeded.
z 3: The transaction control flag is incorrect.
z 7: Internal system error.
z 8: The parameter is incorrect.
z 11: Operation timeout.
z 12: You are unauthorized to access the data.
z 14: The database operation failed.
z 1001: Sorry, the WCDMA user does not exist.
z 1290: The postpaid subscribe cannot query bill.
z 1292: Sorry, the bill does not exist.
DESC Description of the return codes. A string of 0 to 256 bytes.
z When RETN is 0, this
parameter is Querying the bill succeeded.
z When RETN is another return code, this parameter is the matching message.
TOTAL Total number of lines of the query results.
A decimal integer.
6-40 Huawei Technologies Proprietary Issue 04 (2007-12-29)
Parameter Description Value Range
FINISHED Flag that shows whether the operation is complete.
z 0: incomplete
z 1: complete START Start line number of the current batch. A decimal integer.
ROWNUM Number of record s in the current batch. A decimal integer.
Issue 04 (2007-12-29) Huawei Technologies Proprietary 6-41
Parameter Description Value Range
ATTR List of query attribute names that are separated by the & symbol.
The attribute names are as follows:
z STREAMNUMBER: stream number
z ACCOUNTREASON: reason for accounting
z USERNAME: login name
z DOMAIN: domain name
z USERTYPE: user type
z APNNAME: APN that a user belongs to
z USERIP: user's IP address
z IMSI: IMSI number of the user's mobile phone
z CALLINGSTATIONID: calling 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
z ACCOUNTREASON: accounting reason
z SERVICENAME: service name
z STARTTIME: start time of the h i
The value must be the following string:
STREAMNUMBER &
ACCOUNTREASON &
USERNAME & DOMAIN &
USERTYPE & APNNAME &
USERIP & IMSI &
CALLINGST
ATIONID & SESSIONID &
CHARGEID & PDPTYPE &
SERVICESTARTTIME &
STARTTIME & ENDTIME &
TIMELENGTH &
CHARGEVOLUMN & FEE &
GROUPID & SERVICEID &
SERVICENAME & SGSNIP &
GGSNIP & RATINGGROUP &
TERMCAUSE
6-42 Huawei Technologies Proprietary Issue 04 (2007-12-29)
Parameter Description Value Range
z SERVICESTARTTIME: online duration
z ENDTIME: end time of the charging
z SESSIONTIME: session duration
z SESSIONVOLUME: session volume
z RATEPOLICYIDX: charge policy
z FEE: fee for Internet access this time
z USERGROUPID: ID of the user group
z SERVICEID: service ID RESULT List of the queried data. Every two
parameters are separated with the &
symbol, and every two parameter values are separated with the | symbol.
Result set returned by the operation command based on the actual situation.
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|";
6.2.27 Command for Querying for the Start Time and Accumulative Usage of a Service
Command
QUERY C260 USAGE
Issue 04 (2007-12-29) Huawei Technologies Proprietary 6-43
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.
Table 6-27 Parameters of the QUERY C260 USAGE command
Parameter Description Whether
Can Be
LOGINNAME Login name of a CDMA user (If no domain is
applicable to the customer, set LOGINNAME to login name@-1).
No No A string of 1 to 20 bytes.
The value can consist of letters, numerals, periods, minus signs, underlines, or a combination of the preceding characters.
DOMAIN Domain that a
CDMA user belongs to.
No No A string of 1 to 40 bytes.
The value can consist of letters, numerals, periods, or minus signs, or a combination of the preceding characters. It cannot start or end with a period or minus sign.
SERVICEID ID of the service that a CDMA user wants to query for.
Yes No A positive integer from 1 to 2147483647.
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"
6-44 Huawei Technologies Proprietary Issue 04 (2007-12-29)
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.
Issue 04 (2007-12-29) Huawei Technologies Proprietary 6-45 Table 6-28 Parameters of the ACK command
Parameter Description Value Range
RETN Returned value of the ACK command. A decimal integer.
z 0: Querying for the service start time and accumulative service usage succeeded.
z 3: The transaction control flag is incorrect.
z 7: Internal error.
z 8: The parameter is incorrect.
z 11: The operation timed out.
z 12: You are
unauthorized to access the data.
z 14: The database operation failed.
z 1294: Sorry, only a prepaid user can query for the service usage.
z 1295: Sorry, the service subscribed by the subscriber does not exist.
DESC Cause of the error. A string of 0 to 256
bytes.
z When RETN is 0, this parameter is Querying for the service start time and
accumulative service usage succeeded.
z When RETN is another return code, this parameter is the matching message.
TOTAL Total number of lines of queried results. A decimal integer.
FINISHED Whether the operation is complete. z 0: no
z 1: yes
START Start line number in the current batch. A decimal integer.
ROWNUM Number of records in the current batch. A decimal integer.
6-46 Huawei Technologies Proprietary Issue 04 (2007-12-29)
Parameter Description Value Range
ATTR List of query attribute names that are separated by the & symbol.
Including the following parameters:
z LASTDEDUCTTIME: Last time the basic fee is deducted (time a service is enabled for a user. If 19700101000000 is returned, it indicates that the service is not enabled.)
z ACCUTIME: accumulative duration, in seconds. When the value is greater than 0, the parameter is valid.
z ACCUFLOW: accumulative volume, in KB.
When the value is greater than 0, the parameter is valid.
The value must be the following string:
LASTDEDUCTTIME &
ACCUTIME &
ACCUFLOW
RESULT List of queried data.Every two lines are separated by the & symbol, and every two parameters are separated by the | symbol.
Result set returned by the operation command according to the actual situation.
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|",;
Issue 04 (2007-12-29) Huawei Technologies Proprietary 7-1