PPS Service MML Command Reference Guide (V500R002C01B020 - 01)

PPS Prepaid & Postpaid Card Service
V500R002C01B020
MML Command Reference Guide
Issue
01
Date
2008-01-28
Huawei Proprietary and

Confidential Copyright Huawei
Technologies Co., Ltd
Huawei Technologies Co., Ltd. provides customers with comprehensive technical support and service. For
any assistance, please contact our local office or company headquarters.
Huawei Technologies Co., Ltd.

Address:
Huawei Industrial Base

Bantian, Longgang
Shenzhen 518129
People's Republic of China
Website:
http://www.huawei.com
Email:
support@huawei.com
Copyright 2008 Huawei Technologies Co., Ltd. All rights reserved.

No part of this document may be reproduced or transmitted in any form or by any means without prior
written consent of Huawei Technologies Co., Ltd.
Trademarks and Permissions

and other Huawei trademarks are the property 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 the statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Huawei Proprietary and

Confidential Copyright Huawei
Technologies Co., Ltd

Contents
Contents
About This Document ................................................................................................................ 1

1 Introduction to PPS-BMML System ...................................................................................1-1
About This Chapter .................................................................................................................................... 1-1
1.1 System Overview.................................................................................................................................. 1-2
1.2 Advantages of BMML .......................................................................................................................... 1-2
1.2.1 Data Types Supported.................................................................................................................. 1-2
1.2.2 Service Logic Processing Capability............................................................................................ 1-2
1.2.3 Transaction Processing Capability ............................................................................................... 1-2
1.3 System Structure................................................................................................................................... 1-3
1.3.1 Software Architecture.................................................................................................................. 1-3
1.3.2 Process Introduction .................................................................................................................... 1-4
1.4 Typical BMML Command Flows .......................................................................................................... 1-5
1.4.1 Installation of BMML ................................................................................................................. 1-5
2 Description of PPS-BMML Commands .............................................................................2-1

About This Chapter .................................................................................................................................... 2-1
2.1 General Information.............................................................................................................................. 2-2
2.2 Categorization of BMML Commands.................................................................................................... 2-6
2.3 Service Management........................................................................................................................... 2-12
2.3.1 Adding Access Code Surcharge Settings .................................................................................... 2-12
2.3.2 Querying Access Code Surcharge Settings ................................................................................. 2-13
2.3.3 Deleting Access Code Surcharge Settings .................................................................................. 2-14
2.3.4 Adding Language Selection Settings.......................................................................................... 2-15
2.3.5 Querying Language Selection Settings....................................................................................... 2-17
2.3.6 Deleting Language Selection Settings ........................................................................................ 2-18
2.3.7 Adding Service Calling Blacklist Settings .................................................................................. 2-19
2.3.8 Querying Service Calling Blacklist Settings............................................................................... 2-20
2.3.9 Deleting Service Calling Blacklist Settings ................................................................................ 2-22
2.3.10 Adding Destination Black List Number Settings....................................................................... 2-23
2.3.11 Querying Destination Black List Number Settings.................................................................... 2-25
2.3.12 Deleting Destination Black List Number Settings..................................................................... 2-26
Issue 01 (2008-01-28)
Huawei Technologies Proprietary

Contents
2.3.13 Adding Calling Numbers without IVA ..................................................................................... 2-27

2.3.14 Querying Calling Numbers without IVA .................................................................................. 2-28
2.3.15 Deleting Calling Numbers without IVA.................................................................................... 2-30
2.3.16 Adding Access Code Settings................................................................................................... 2-31
2.3.17 Modifying Access Code Settings ............................................................................................. 2-38
2.3.18 Querying Access Code Settings ............................................................................................... 2-46
2.3.19 Deleting Access Code Settings................................................................................................. 2-47
2.3.20 Querying Service Information Settings .................................................................................... 2-49
2.3.21 Querying Service Configuration Information ........................................................................... 2-50
2.4 Service Provider ................................................................................................................................. 2-51
2.4.1 Listing SPs................................................................................................................................ 2-51
2.4.2 Counting the Total Number of SPs............................................................................................. 2-52
2.4.3 Querying Relevant Information of an SP.................................................................................... 2-53
2.4.4 Querying Relevant Parameter Information of an SP ................................................................... 2-54
2.4.5 Querying Relevant Charge Information of an SP........................................................................ 2-56
2.4.6 Querying Relevant Information of SP Access Codes .................................................................. 2-57
2.4.7 Querying Relevant Information of SP Features .......................................................................... 2-58
2.4.8 Querying Information in the Usage Bonus Log Table ................................................................. 2-59
2.4.9 Querying the Usage Bonus Information Table ............................................................................ 2-61
2.4.10 Adding Called Screen Based on Calling Numbers .................................................................... 2-62
2.4.11 Querying Called Screen Based on Calling Numbers ................................................................. 2-63
2.4.12 Deleting Called Screen Based on Calling Numbers .................................................................. 2-65
2.4.13 Adding Information in the Recharge Prolongation Table........................................................... 2-66
2.4.14 Modifying Information in the Recharge Prolongation Table...................................................... 2-67
2.4.15 Querying Information in the Recharge Prolongation Table........................................................ 2-68
2.4.16 Deleting Information in the Recharge Prolongation Table......................................................... 2-70
2.4.17 Adding Information to the Recharge Bonus Table..................................................................... 2-71
2.4.18 Modifying Information in the Recharge Bonus Table ............................................................... 2-72
2.4.19 Querying Information from the Recharge Bonus Table ............................................................. 2-74
2.4.20 Deleting Information in the Recharge Bonus Table................................................................... 2-76
2.4.21 Querying Serve Level Settings................................................................................................. 2-77
2.4.22 Querying Time Slot Settings .................................................................................................... 2-79
2.4.23 Querying Customer Ser. Center Number Settings ..................................................................... 2-80
2.4.24 Querying Day Category Settings.............................................................................................. 2-81
2.4.25 Querying Virtual Calling Number Settings ............................................................................... 2-83
2.4.26 Querying Holiday Category Settings........................................................................................ 2-84
2.4.27 Querying Abbreviated Account Screen Numbers...................................................................... 2-85
2.4.28 Querying Statistics Called/Callee Number Settings .................................................................. 2-87
2.4.29 Querying Route Information .................................................................................................... 2-88
2.5 Product Management .......................................................................................................................... 2-89
2.5.1 Listing Products ........................................................................................................................ 2-89
2.5.2 Counting the Total Number of Products ..................................................................................... 2-91
ii
Issue 01 (2008-01-28)

Contents
2.5.3 Querying Relevant Information of Products ............................................................................... 2-92

2.5.4 Querying the Access Codes Distributed to Products ................................................................... 2-93
2.5.5 Modifying Product Parameters .................................................................................................. 2-95
2.5.6 Querying Product Charge Package............................................................................................. 2-96
2.5.7 Querying the Product Level Parameters Table ............................................................................ 2-97
2.5.8 Querying Product Level Calling Category Number Screen ......................................................... 2-99
2.5.9 Querying Access Code and Nested Call Methods Distributed at Product Level ..........................2-101
2.5.10 Querying Callee and Time Based Message Setting ..................................................................2-102
2.5.11 Querying the Product Level Familiarity Number Configuration...............................................2-104
2.5.12 Querying the Product Level Caller and Time based Message Settings......................................2-105
2.6 Batch Management ............................................................................................................................2-107
2.6.1 Listing Batches ........................................................................................................................2-107
2.6.2 Counting Batches .....................................................................................................................2-109
2.6.3 Querying Batch ........................................................................................................................2-110
2.6.4 Querying Batch Discount ......................................................................................................... 2-111
2.6.5 Querying the Batch Level Parameters Table ..............................................................................2-113
2.6.6 Creating a Batch of Cards.........................................................................................................2-115
2.6.7 Activating a Batch of Cards ......................................................................................................2-124
2.6.8 Deactivating a Batch of Cards ..................................................................................................2-127
2.6.9 Modifying a Batch of Cards......................................................................................................2-129
2.6.10 Deleting a Batch of Cards.......................................................................................................2-135
2.6.11 Adding the Caller Binding Category Screen Information .........................................................2-137
2.6.12 Querying the Caller Binding Category Screen Information......................................................2-139
2.6.13 Deleting the Caller Binding Category Screen Information .......................................................2-140
2.6.14 Adding Batch Abbreviated Numbers .......................................................................................2-141
2.6.15 Modifying Batch Abbreviated Numbers..................................................................................2-143
2.6.16 Querying Batch Abbreviated Numbers....................................................................................2-144
2.6.17 Deleting Batch Abbreviated Numbers .....................................................................................2-146
2.6.18 Querying the Batch Level Binding Calling Number Screen Settings ........................................2-147
2.6.19 Querying the Batch Level Time Based Message Settings.........................................................2-149
2.6.20 Adding Calling Category Screen at Batch Level ......................................................................2-150
2.6.21 Querying Calling Category Screen at Batch Level ...................................................................2-151
2.6.22 Deleting Calling Category Screen at Batch Level ....................................................................2-152
2.6.23 Adding Green Numbers at Batch Level ...................................................................................2-154
2.6.24 Deleting Green Numbers at Batch Level .................................................................................2-155
2.6.25 Querying Green Numbers at Batch Level ................................................................................2-156
2.6.26 Cancelling Batch Operations of Cards.....................................................................................2-157
2.6.27 Querying the Reason for Deleting Cards in Batches ................................................................2-158
2.6.28 Loading Cards in Batches.......................................................................................................2-159
2.6.29 Unloading Cards in Batches....................................................................................................2-162
2.6.30 Importing Cards in Batches ....................................................................................................2-164
2.6.31 Querying Statuses of Batch Level Parameters .........................................................................2-176
Issue 01 (2008-01-28)
iii

Contents
2.6.32 Adding Batch Level Parameters..............................................................................................2-177

2.6.33 Modifying Batch Level Parameters .........................................................................................2-184
2.6.34 Deleting Batch Level Parameters ............................................................................................2-191
2.7 Single Card Management Settings......................................................................................................2-192
2.7.1 Listing Single Cards in a Batch.................................................................................................2-192
2.7.2 Counting Single Cards in a Batch .............................................................................................2-196
2.7.3 Querying the Information About a Card ....................................................................................2-199
2.7.4 Modifying the Information of a Single Card..............................................................................2-201
2.7.5 Changing the Password of a Card .............................................................................................2-210
2.7.6 Binding a Calling Number........................................................................................................2-211
2.7.7 Unbinding a Calling Number....................................................................................................2-213
2.7.8 Changing the Card-Binding Password.......................................................................................2-214
2.7.9 Querying the Binding Status of a Calling Number(or a Card Number).......................................2-216
2.7.10 Adding the Calling Screen Information ...................................................................................2-218
2.7.11 Querying the Calling Screen Information ................................................................................2-219
2.7.12 Deleting the Calling Screen Information .................................................................................2-221
2.7.13 Adding the Called Screen Information ....................................................................................2-223
2.7.14 Querying the Called Screen Information .................................................................................2-224
2.7.15 Deleting the Called Screen Information ..................................................................................2-226
2.7.16 Adding the Abbreviated Number.............................................................................................2-227
2.7.17 Modifying the Abbreviated Number........................................................................................2-229
2.7.18 Querying the Abbreviated Number..........................................................................................2-230
2.7.19 Deleting the Abbreviated Number...........................................................................................2-232
2.7.20 Querying Familiarity Number and Relating Discount ..............................................................2-233
2.7.21 Querying Card Number PIN ...................................................................................................2-235
2.7.22 Deducting Charge...................................................................................................................2-236
2.7.23 Recharging by a Card .............................................................................................................2-238
2.7.24 Verifying the Card Validity .....................................................................................................2-241
2.7.25 Querying the Information of Online-Sale Cards ......................................................................2-243
2.7.26 Selling Cards Online ..............................................................................................................2-244
2.7.27 Querying Historical Records...................................................................................................2-246
2.7.28 Recharging.............................................................................................................................2-247
2.7.29 Correcting Recharge...............................................................................................................2-248
2.7.30 Querying Recharge Logs ........................................................................................................2-250
2.7.31 Adding Familiarity Numbers ..................................................................................................2-251
2.7.32 Querying Familiarity Numbers ...............................................................................................2-253
2.7.33 Deleting Familiarity Numbers.................................................................................................2-254
2.7.34 Card-related Users Settings.....................................................................................................2-255
2.7.35 Cancelling Card-related Users Settings ...................................................................................2-256
2.7.36 Adding Abbreviated Accounts Settings ...................................................................................2-257
2.7.37 Querying Abbreviated Account Numbers or Card Numbers.....................................................2-258
2.7.38 Deleting Abbreviated Accounts Settings..................................................................................2-260
iv
Issue 01 (2008-01-28)

Contents
2.7.39 Adding Green Numbers at Subscriber Level............................................................................2-261

2.7.40 Querying Green Numbers at Subscriber Level ........................................................................2-262
2.7.41 Deleting Green Numbers at Subscriber Level..........................................................................2-263
2.7.42 Querying Single User Logs.....................................................................................................2-264
2.7.43 Setting Blacklists....................................................................................................................2-266
2.7.44 Resetting Single Cards............................................................................................................2-267
2.7.45 Modifying Validity Dates of Single Cards ...............................................................................2-268
2.7.46 Clearing Single Card Blacklists ..............................................................................................2-269
2.7.47 Resetting Accumulated Call Cost of Single Cards ...................................................................2-270
2.7.48 Resetting Usage Points Level of Single Cards .........................................................................2-271
2.7.49 Setting Call Type Screen for Single Cards...............................................................................2-272
2.7.50 Querying Main-Child Cards....................................................................................................2-274
2.7.51 Querying Modifiable State of the Single Card Maintenance Interface ......................................2-275
2.8 CDRs ManagementSettings................................................................................................................2-277
2.8.1 Querying Service Bills .............................................................................................................2-277
2.8.2 Querying Operation Bills..........................................................................................................2-279
2.8.3 Querying Bills..........................................................................................................................2-281
2.8.4 Querying Statistical Bill Information ........................................................................................2-283
2.9 User Template Management ...............................................................................................................2-285
2.9.1 Adding User Template ..............................................................................................................2-285
2.9.2 Modifying User Template .........................................................................................................2-292
2.9.3 Querying User Template...........................................................................................................2-298
2.9.4 Deleting User Template ............................................................................................................2-300
2.9.5 Querying Blacklists in Batches .................................................................................................2-301
2.9.6 Querying Balance Modification Logs .......................................................................................2-302
2.9.7 Querying Bonus Logs...............................................................................................................2-303
2.9.8 Querying Sales Bonus Logs......................................................................................................2-305
2.9.9 Querying BMML Deduction Logs ............................................................................................2-306
2.9.10 Querying Card Creation Information.......................................................................................2-308
2.9.11 Querying Batch Operation Logs..............................................................................................2-309
2.9.12 Querying Operation Types of Logs .........................................................................................2-311
2.10 Charging Matrix Management ..........................................................................................................2-313
2.10.1 Querying the Charging Mode..................................................................................................2-313
2.10.2 Querying the Adjusted Charging Class Index ..........................................................................2-314
2.10.3 Querying the Charging Class Index.........................................................................................2-315
2.10.4 Querying the Daily Charge Rate Modulator ............................................................................2-316
2.10.5 Querying the Weekly Charge Rate Modulator .........................................................................2-318
2.10.6 Querying the Holiday Charge Rate Modulator.........................................................................2-319
2.10.7 Querying the International Charging Matrix............................................................................2-320
2.10.8 Querying the National Charging Matrix ..................................................................................2-322
2.10.9 Querying the Local Group Charging Matrix............................................................................2-323
2.10.10 Querying Charge Index Table ...............................................................................................2-324
Issue 01 (2008-01-28)

Contents
2.10.11 Querying Charge Measure Table ...........................................................................................2-326

2.11 Additional Management ...................................................................................................................2-327
2.11.1 Querying Currency Types .......................................................................................................2-327
2.11.2 Querying Voice Information....................................................................................................2-328
2.11.3 Querying Language Types ......................................................................................................2-329
2.11.4 Querying Charge Rules...........................................................................................................2-330
2.11.5 Querying All Access Codes.....................................................................................................2-332
2.11.6 Querying the Voice Menu Tree................................................................................................2-333
2.11.7 Querying Card Types ..............................................................................................................2-334
2.11.8 Querying the SDP in Service Area ..........................................................................................2-335
2.11.9 Querying the Batch File Format ..............................................................................................2-337
2.11.10 Querying the Bonus Template ...............................................................................................2-338
2.11.11 Querying the Function Status During Batch Import ...............................................................2-339
2.11.12 Querying the Service Version ................................................................................................2-340
2.11.13 Querying the Service Configuration Information ...................................................................2-342
2.11.14 Querying Time Segments......................................................................................................2-342
2.11.15 Query Government Tax Logs ................................................................................................2-344
2.11.16 Query Password Modification Log........................................................................................2-346
vi
Issue 01 (2008-01-28)

Figures
Figures
Figure 1-1 Software Architecture................................................................................................................ 1-3
Issue 01 (2008-01-28)
vii

Tables
Tables
Table 2-1 Description of the general errors in the MML commands............................................................. 2-2
Table 2-2 Description of the common parameters for the MML commands ................................................. 2-4
Table 2-3 List of commands ....................................................................................................................... 2-6
Table 2-4 Description of the input parameters of: ADD PPS ACCSUR...................................................... 2-12
Table 2-5 Description of the output parameters of: ADD PPS ACCSUR.................................................... 2-12
Table 2-6 Description of the input parameters of: LIST PPS ACCSUR...................................................... 2-13
Table 2-7 Description of the output parameters of: LIST PPS ACCSUR.................................................... 2-13
Table 2-8 Description of the input parameters of: DELE PPS ACCSUR.................................................... 2-14
Table 2-9 Description of the output parameters of: DELE PPS ACCSUR .................................................. 2-15
Table 2-10 Description of the input parameters of: ADD PPS LANGSELECT .......................................... 2-16
Table 2-11 Description of the output parameters of: ADD PPS LANGSELECT......................................... 2-16
Table 2-12 Description of the input parameters of: LIST PPS LANGSELECT .......................................... 2-17
Table 2-13 Description of the output parameters of: LIST PPS LANGSELECT......................................... 2-17
Table 2-14 Description of the input parameters of: DELE PPS LANGSELECT......................................... 2-18
Table 2-15 Description of the output parameters of: DELE PPS LANGSELECT....................................... 2-19
Table 2-16 Description of the input parameters of: ADD PPS CALLINGBLK........................................... 2-19
Table 2-17 Description of the output parameters of: ADD PPS CALLINGBLK......................................... 2-20
Table 2-18 Description of the input parameters of: QRY PPS CALLINGBLK ........................................... 2-20
Table 2-19 Description of the output parameters of: QRY PPS CALLINGBLK ......................................... 2-21
Table 2-20 Description of the input parameters of: DELE PPS CALLINGBLK......................................... 2-22
Table 2-21 Description of the output parameters of: DELE PPS CALLINGBLK ....................................... 2-22
Table 2-22 Description of the input parameters of: ADD PPS DESTBLKLST........................................... 2-23
Table 2-23 Description of the output parameters of: ADD PPS DESTBLKLST ......................................... 2-23
Table 2-24 Description of the input parameters of: LIST PPS DESTBLKLST ........................................... 2-25
Table 2-25 Description of the output parameters of: LIST PPS DESTBLKLST ......................................... 2-25
Issue 01 (2008-01-28)
ix

Tables
Table 2-26 Description of the input parameters of: DELE PPS DESTBLKLST ......................................... 2-26
Table 2-27 Description of the output parameters of: DELE PPS DESTBLKLST ....................................... 2-27
Table 2-28 Description of the input parameters of: ADD PPS NOIVACALLLIST ..................................... 2-28
Table 2-29 Description of the output parameters of: ADD PPS NOIVACALLLIST ................................... 2-28
Table 2-30 Description of the input parameters of: LIST PPS NOIVACALLLIST ..................................... 2-29
Table 2-31 Description of the output parameters of: LIST PPS NOIVACALLLIST ................................... 2-29
Table 2-32 Description of the input parameters of: DELE PPS NOIVACALLLIST ................................... 2-30
Table 2-33 Description of the output parameters of: DELE PPS NOIVACALLLIST.................................. 2-30
Table 2-34 Description of the input parameters of: ADD PPS ACCESSCODE .......................................... 2-32
Table 2-35 Description of the output parameters of: ADD PPS ACCESSCODE ........................................ 2-38
Table 2-36 Description of the input parameters of: MOD PPS ACCESSCODE.......................................... 2-39
Table 2-37 Description of the output parameters of: MOD PPS ACCESSCODE........................................ 2-45
Table 2-38 Description of the input parameters of: DISP PPS ACSCODE ................................................. 2-46
Table 2-39 Description of the output parameters of: DISP PPS ACSCODE ............................................... 2-47
Table 2-40 Description of the input parameters of: DELE PPS ACCESSCODE......................................... 2-48
Table 2-41 Description of the output parameters of: DELE PPS ACCESSCODE....................................... 2-48
Table 2-42 Description of the output parameters of: DISP PPS SRVPARA................................................ 2-49
Table 2-43 Description of the input parameters of: DISP PPS SRVCONFIG.............................................. 2-50
Table 2-44 Description of the output parameters of: DISP PPS SRVCONFIG............................................ 2-50
Table 2-45 Description of the output parameters of: LIST PPS SP............................................................. 2-51
Table 2-46 Description of the output parameters of: COUNT PPS SP........................................................ 2-52
Table 2-47 Description of the input parameters of: DISP PPS SPINFO...................................................... 2-53
Table 2-48 Description of the output parameters of: DISP PPS SPINFO.................................................... 2-53
Table 2-49 Description of the input parameters of: DISP PPS SPPARA..................................................... 2-54
Table 2-50 Description of the output parameters of: DISP PPS SPPARA................................................... 2-54
Table 2-51 Description of the input parameters of: DISP PPS SPCHRGINFO ........................................... 2-56
Table 2-52 Description of the output parameters of: DISP PPS SPCHRGINFO ......................................... 2-56
Table 2-53 Description of the output parameters of: LIST PPS SPACCESSCODE .................................... 2-58
Table 2-54 Description of the input parameters of: DISP PPS SPFEATURES............................................ 2-59
Table 2-55 Description of the output parameters of: DISP PPS SPFEATURES.......................................... 2-59
Table 2-56 Description of the input parameters of: LIST PPS ACCUMBNSLOG ...................................... 2-60
Table 2-57 Description of the output parameters of: LIST PPS ACCUMBNSLOG .................................... 2-60
Table 2-58 Description of the input parameters of: LIST PPS SPACCUMBONUS .................................... 2-61
Issue 01 (2008-01-28)

Tables
Table 2-59 Description of the output parameters of: LIST PPS SPACCUMBONUS .................................. 2-62
Table 2-60 Description of the input parameters of: ADD PPS CALLEDSRCOFCLI.................................. 2-63
Table 2-61 Description of the output parameters of: ADD PPS CALLEDSRCOFCLI................................ 2-63
Table 2-62 Description of the input parameters of: LIST PPS CALLEDSRCOFCLI.................................. 2-64
Table 2-63 Description of the output parameters of: LIST PPS CALLEDSRCOFCLI................................ 2-64
Table 2-64 Description of the input parameters of: DELE PPS CALLEDSRCOFCLI ................................ 2-65
Table 2-65 Description of the output parameters of: DELE PPS CALLEDSRCOFCLI .............................. 2-65
Table 2-66 Description of the input parameters of: ADD PPS SPPROLONGDATA ................................... 2-66
Table 2-67 Description of the output parameters of: ADD PPS SPPROLONGDATA ................................. 2-67
Table 2-68 Description of the input parameters of: MODI PPS SPPROLONGDATA................................. 2-67
Table 2-69 Description of the output parameters of: MODI PPS SPPROLONGDATA............................... 2-68
Table 2-70 Description of the input parameters of: LIST PPS SPPROLONGDATA ................................... 2-69
Table 2-71 Description of the output parameters of: LIST PPS SPPROLONGDATA ................................. 2-69
Table 2-72 Description of the input parameters of: DELE PPS SPPROLONGDATA ................................. 2-70
Table 2-73 Description of the output parameters of: DELE PPS SPPROLONGDATA ............................... 2-70
Table 2-74 Description of the input parameters of: ADD PPS SPRECHRGBNS........................................ 2-71
Table 2-75 Description of the output parameters of: ADD PPS SPRECHRGBNS ...................................... 2-72
Table 2-76 Description of the input parameters of: MODI PPS SPRECHRGBNS...................................... 2-73
Table 2-77 Description of the output parameters of: MODI PPS SPRECHRGBNS.................................... 2-74
Table 2-78 Description of the input parameters of: LIST PPS SPRECHRGBNS ........................................ 2-75
Table 2-79 Description of the output parameters of: LIST PPS SPRECHRGBNS ...................................... 2-75
Table 2-80 Description of the input parameters of: DELE PPS SPRECHRGBNS ...................................... 2-76
Table 2-81 Description of the output parameters of: DELE PPS SPRECHRGBNS .................................... 2-77
Table 2-82 Description of the input parameters of: LIST PPS SERVLEVEL.............................................. 2-78
Table 2-83 Description of the output parameters of: LIST PPS SERVLEVEL............................................ 2-78
Table 2-84 Description of the input parameters of: LIST PPS TIMESLOT ................................................ 2-79
Table 2-85 Description of the output parameters of: LIST PPS TIMESLOT .............................................. 2-79
Table 2-86 Description of the input parameters of: LIST PPS CSC............................................................ 2-80
Table 2-87 Description of the output parameters of: LIST PPS CSC.......................................................... 2-81
Table 2-88 Description of the input parameters of: LIST PPS DAYCAT.................................................... 2-82
Table 2-89 Description of the output parameters of: LIST PPS DAYCAT.................................................. 2-82
Table 2-90 Description of the input parameters of: LIST PPS VIRTUALCLI ............................................ 2-83
Table 2-91 Description of the output parameters of: LIST PPS VIRTUALCLI........................................... 2-83
Issue 01 (2008-01-28)
xi

Tables
Table 2-92 Description of the input parameters of: LIST PPS HOLIDAYCAT........................................... 2-84
Table 2-93 Description of the output parameters of: LIST PPS HOLIDAYCAT......................................... 2-85
Table 2-94 Description of the input parameters of: LIST PPS ABBRACCSCR.......................................... 2-86
Table 2-95 Description of the output parameters of: LIST PPS ABBRACCSCR........................................ 2-86
Table 2-96 Description of the input parameters of: LIST PPS STATCLIDST............................................. 2-87
Table 2-97 Description of the output parameters of: LIST PPS STATCLIDST........................................... 2-87
Table 2-98 Description of the input parameters of: LIST PPS ROUTEINFO ............................................. 2-88
Table 2-99 Description of the output parameters of: LIST PPS ROUTEINFO ........................................... 2-89
Table 2-100 Description of the input parameters of: LIST PPS PRODUCT ............................................... 2-90
Table 2-101 Description of the output parameters of: LIST PPS PRODUCT ............................................. 2-90
Table 2-102 Description of the input parameters of: COUNT PPS PRODUCT .......................................... 2-91
Table 2-103 Description of the output parameters of: COUNT PPS PRODUCT ........................................ 2-91
Table 2-104 Description of the input parameters of: DISP PPS PDTINFO................................................. 2-92
Table 2-105 Description of the output parameters of: DISP PPS PDTINFO ............................................... 2-92
Table 2-106 Description of the input parameters of: LIST PPS PDTACSCODE ........................................ 2-94
Table 2-107 Description of the output parameters of: LIST PPS PDTACSCODE ...................................... 2-94
Table 2-108 Description of the input parameters of: MODI PPS PDTPARA.............................................. 2-95
Table 2-109 Description of the output parameters of: MODI PPS PDTPARA ............................................ 2-95
Table 2-110 Description of the input parameters of: LIST PPS PDTCHGPKG .......................................... 2-96
Table 2-111 Description of the output parameters of: LIST PPS PDTCHGPKG......................................... 2-97
Table 2-112 Description of the input parameters of: LIST PPS PDTPARA ................................................ 2-98
Table 2-113 Description of the output parameters of: LIST PPS PDTPARA .............................................. 2-98
Table 2-114 Description of the input parameters of: LIST PPS CALLCATSCR ......................................... 2-99
Table 2-115 Description of the output parameters of: LIST PPS CALLCATSCR ......................................2-100
Table 2-116 Description of the input parameters of: LIST PPS NESTCALL.............................................2-101
Table 2-117 Description of the output parameters of: LIST PPS NESTCALL...........................................2-101
Table 2-118 Description of the input parameters of: LIST PPS CALLEETMMSG....................................2-102
Table 2-119 Description of the output parameters of: LIST PPS CALLEETMMSG..................................2-103
Table 2-120 Description of the input parameters of: LIST PPS FAMILYNUMSCR ..................................2-104
Table 2-121 Description of the output parameters of: LIST PPS FAMILYNUMSCR ................................2-104
Table 2-122 Description of the input parameters of: LIST PPS CLRTIMMSG..........................................2-105
Table 2-123 Description of the output parameters of: LIST PPS CLRTIMMSG........................................2-106
Table 2-124 Description of the input parameters of: LIST PPS BATCH....................................................2-107
xii
Issue 01 (2008-01-28)

Tables
Table 2-125 Description of the output parameters of: LIST PPS BATCH..................................................2-108
Table 2-126 Description of the input parameters of: COUNT PPS BATCH ..............................................2-109
Table 2-127 Description of the output parameters of: COUNT PPS BATCH.............................................2-109
Table 2-128 Description of the input parameters of: DISP PPS BATCH ...................................................2-110
Table 2-129 Description of the output parameters of: DISP PPS BATCH.................................................. 2-111
Table 2-130 Description of the input parameters of: DISP PPS BATCHDISCOUNT ................................2-112
Table 2-131 Description of the output parameters of: DISP PPS BATCHDISCOUNT ..............................2-112
Table 2-132 Description of the input parameters of: DISP PPS BATCHPARA..........................................2-113
Table 2-133 Description of the output parameters of: DISP PPS BATCHPARA........................................2-113
Table 2-134 Description of the input parameters of: CREATE PPS BATCH .............................................2-115
Table 2-135 Description of the output parameters of: CREATE PPS BATCH ...........................................2-119
Table 2-136 Description of the input parameters of: ACTIVATE PPS BATCHCARD ...............................2-124
Table 2-137 Description of the output parameters of: ACTIVATE PPS BATCHCARD .............................2-126
Table 2-138 Description of the input parameters of: DEACTIVATE PPS BATCH ....................................2-127
Table 2-139 Description of the output parameters of: DEACTIVATE PPS BATCH...................................2-129
Table 2-140 Description of the input parameters of: MODI PPS BATCH .................................................2-130
Table 2-141 Description of the output parameters of: MODI PPS BATCH................................................2-134
Table 2-142 Description of the input parameters of: DELE PPS BATCH..................................................2-135
Table 2-143 Description of the output parameters of: DELE PPS BATCH................................................2-137
Table 2-144 Description of the input parameters of: ADD PPS BDINGSCRCAT......................................2-138
Table 2-145 Description of the output parameters of: ADD PPS BDINGSCRCAT....................................2-138
Table 2-146 Description of the input parameters of: LIST PPS BDINGSCRCAT......................................2-139
Table 2-147 Description of the output parameters of: LIST PPS BDINGSCRCAT....................................2-139
Table 2-148 Description of the input parameters of: DELE PPS BDINGSCRCAT....................................2-140
Table 2-149 Description of the output parameters of: DELE PPS BDINGSCRCAT..................................2-141
Table 2-150 Description of the input parameters of: ADD PPS BATCHABBR .........................................2-142
Table 2-151 Description of the output parameters of: ADD PPS BATCHABBR .......................................2-142
Table 2-152 Description of the input parameters of: MODI PPS BATCHABBR .......................................2-143
Table 2-153 Description of the output parameters of: MODI PPS BATCHABBR .....................................2-144
Table 2-154 Description of the input parameters of: LIST PPS BATCHABBR .........................................2-145
Table 2-155 Description of the output parameters of: LIST PPS BATCHABBR .......................................2-145
Table 2-156 Description of the input parameters of: DELE PPS BATCHABBR .......................................2-146
Table 2-157 Description of the output parameters of: DELE PPS BATCHABBR......................................2-147
Issue 01 (2008-01-28)
xiii

Tables
Table 2-158 Description of the input parameters of: LIST PPS BINDCALLSCR......................................2-148
Table 2-159 Description of the output parameters of: LIST PPS BINDCALLSCR....................................2-148
Table 2-160 Description of the input parameters of: QRY PPS TIMEMSG...............................................2-149
Table 2-161 Description of the output parameters of: QRY PPS TIMEMSG.............................................2-149
Table 2-162 Description of the input parameters of: ADD PPS BATCATSCR ..........................................2-150
Table 2-163 Description of the output parameters of: ADD PPS BATCATSCR ........................................2-151
Table 2-164 Description of the input parameters of: LIST PPS BATCATSCR ..........................................2-151
Table 2-165 Description of the output parameters of: LIST PPS BATCATSCR.........................................2-152
Table 2-166 Description of the input parameters of: DELE PPS BATCATSCR.........................................2-153
Table 2-167 Description of the output parameters of: DELE PPS BATCATSCR.......................................2-153
Table 2-168 Description of the input parameters of: ADD PPS BATGREEN ............................................2-154
Table 2-169 Description of the output parameters of: ADD PPS BATGREEN ..........................................2-154
Table 2-170 Description of the input parameters of: DELE PPS BATGREEN ..........................................2-155
Table 2-171 Description of the output parameters of: DELE PPS BATGREEN.........................................2-155
Table 2-172 Description of the input parameters of: LIST PPS BATGREEN ............................................2-156
Table 2-173 Description of the output parameters of: LIST PPS BATGREEN ..........................................2-156
Table 2-174 Description of the input parameters of: STOP PPS BATCHOPR ...........................................2-157
Table 2-175 Description of the output parameters of: STOP PPS BATCHOPR .........................................2-158
Table 2-176 Description of the input parameters of: LIST PPS DELREA .................................................2-158
Table 2-177 Description of the output parameters of: LIST PPS DELREA ...............................................2-158
Table 2-178 Description of the input parameters of: LOAD PPS BATCARD............................................2-160
Table 2-179 Description of the output parameters of: LOAD PPS BATCARD..........................................2-161
Table 2-180 Description of the input parameters of: UNLOAD PPS BATCARD ......................................2-162
Table 2-181 Description of the output parameters of: UNLOAD PPS BATCARD ....................................2-164
Table 2-182 Description of the input parameters of: IMPORT PPS BATCHCARD...................................2-165
Table 2-183 Description of the output parameters of: IMPORT PPS BATCHCARD .................................2-175
Table 2-184 Description of the input parameters of: DISP PPS BATMODISTATE ...................................2-176
Table 2-185 Description of the output parameters of: DISP PPS BATMODISTATE..................................2-176
Table 2-186 Description of the input parameters of: ADD PPS BATCHPARA..........................................2-177
Table 2-187 Description of the output parameters of: ADD PPS BATCHPARA........................................2-184
Table 2-188 Description of the input parameters of: MODI PPS BATCHPARA........................................2-184
Table 2-189 Description of the output parameters of: MODI PPS BATCHPARA......................................2-190
Table 2-190 Description of the input parameters of: DELE PPS BATCHPARA ........................................2-191
xiv
Issue 01 (2008-01-28)

Tables
Table 2-191 Description of the output parameters of: DELE PPS BATCHPARA ......................................2-191
Table 2-192 Description of the input parameters of: LIST PPS CARD .....................................................2-192
Table 2-193 Description of the output parameters of: LIST PPS CARD....................................................2-196
Table 2-194 Description of the input parameters of: COUNT PPS CARD ................................................2-197
Table 2-195 Description of the output parameters of: COUNT PPS CARD ..............................................2-198
Table 2-196 Description of the input parameters of: LIST PPS CARDINFO.............................................2-199
Table 2-197 Description of the output parameters of: LIST PPS CARDINFO...........................................2-199
Table 2-198 Description of the input parameters of: MODI PPS CARDINFO ..........................................2-201
Table 2-199 Description of the output parameters of: MODI PPS CARDINFO.........................................2-209
Table 2-200 Description of the input parameters of: CHNG PPS CARDPSWD ........................................2-210
Table 2-201 Description of the output parameters of: CHNG PPS CARDPSWD ......................................2-211
Table 2-202 Description of the input parameters of: BIND PPS CARD ....................................................2-212
Table 2-203 Description of the output parameters of: BIND PPS CARD ..................................................2-212
Table 2-204 Description of the input parameters of: UNBIND PPS CARD...............................................2-213
Table 2-205 Description of the output parameters of: UNBIND PPS CARD.............................................2-214
Table 2-206 Description of the input parameters of: MODI PPS BNDPSWD ...........................................2-215
Table 2-207 Description of the output parameters of: MODI PPS BNDPSWD .........................................2-216
Table 2-208 Description of the input parameters of: LIST PPS CALLBND ..............................................2-216
Table 2-209 Description of the output parameters of: LIST PPS CALLBND ............................................2-217
Table 2-210 Description of the input parameters of: ADD PPS CARDCALLINGSCREEN ......................2-218
Table 2-211 Description of the output parameters of: ADD PPS CARDCALLINGSCREEN.....................2-219
Table 2-212 Description of the input parameters of: LIST PPS CARDCALLINGSCREEN ......................2-220
Table 2-213 Description of the output parameters of: LIST PPS CARDCALLINGSCREEN ....................2-220
Table 2-214 Description of the input parameters of: DELE PPS CARDCALLINGSCREEN.....................2-221
Table 2-215 Description of the output parameters of: DELE PPS CARDCALLINGSCREEN...................2-222
Table 2-216 Description of the input parameters of: ADD PPS CARDCALLEDSCREEN........................2-223
Table 2-217 Description of the output parameters of: ADD PPS CARDCALLEDSCREEN......................2-224
Table 2-218 Description of the input parameters of: LIST PPS CARDCALLEDSCREEN........................2-225
Table 2-219 Description of the output parameters of: LIST PPS CARDCALLEDSCREEN ......................2-225
Table 2-220 Description of the input parameters of: DELE PPS CARDCALLEDSCREEN ......................2-226
Table 2-221 Description of the output parameters of: DELE PPS CARDCALLEDSCREEN ....................2-227
Table 2-222 Description of the input parameters of: ADD PPS ABBRDIAL.............................................2-228
Table 2-223 Description of the output parameters of: ADD PPS ABBRDIAL...........................................2-228
Issue 01 (2008-01-28)
xv

Tables
Table 2-224 Description of the input parameters of: MODI PPS ABBRDIAL...........................................2-229
Table 2-225 Description of the output parameters of: MODI PPS ABBRDIAL.........................................2-230
Table 2-226 Description of the input parameters of: LIST PPS ABBRDIAL.............................................2-231
Table 2-227 Description of the output parameters of: LIST PPS ABBRDIAL...........................................2-231
Table 2-228 Description of the output parameters of: DELE PPS ABBRDIAL .........................................2-233
Table 2-229 Description of the input parameters of: DISP PPS CARDFLYNUMBER ..............................2-234
Table 2-230 Description of the output parameters of: DISP PPS CARDFLYNUMBER ............................2-234
Table 2-231 Description of the input parameters of: DISP PPS CARDPIN ...............................................2-235
Table 2-232 Description of the output parameters of: DISP PPS CARDPIN .............................................2-235
Table 2-233 Description of the input parameters of: DEDU PPS CARD...................................................2-236
Table 2-234 Description of the output parameters of: DEDU PPS CARD.................................................2-237
Table 2-235 Description of the input parameters of: CARDRECHG PPS CARD......................................2-238
Table 2-236 Description of the output parameters of: CARDRECHG PPS CARD ....................................2-239
Table 2-237 Description of the input parameters of: LOGGING PPS CARD ............................................2-242
Table 2-238 Description of the output parameters of: LOGGING PPS CARD ..........................................2-242
Table 2-239 Description of the input parameters of: LIST PPS OLCARD ................................................2-243
Table 2-240 Description of the output parameters of: LIST PPS OLCARD ..............................................2-243
Table 2-241 Description of the input parameters of: SALE PPS OLCARD...............................................2-244
Table 2-242 Description of the output parameters of: SALE PPS OLCARD .............................................2-245
Table 2-243 Description of the input parameters of: LIST PPS RECORDINFO........................................2-246
Table 2-244 Description of the output parameters of: LIST PPS RECORDINFO......................................2-246
Table 2-245 Description of the input parameters of: RECHG PPS CARD.................................................2-247
Table 2-246 Description of the output parameters of: RECHG PPS CARD...............................................2-248
Table 2-247 Description of the input parameters of: CORRECT PPS CARDRECHG ...............................2-248
Table 2-248 Description of the output parameters of: CORRECT PPS CARDRECHG .............................2-249
Table 2-249 Description of the input parameters of: LIST PPS RECHGLOG ...........................................2-250
Table 2-250 Description of the output parameters of: LIST PPS RECHGLOG .........................................2-250
Table 2-251 Description of the input parameters of: ADD PPS CARDFLYNUMBER ..............................2-252
Table 2-252 Description of the output parameters of: ADD PPS CARDFLYNUMBER ............................2-252
Table 2-253 Description of the input parameters of: LIST PPS CARDFLYNUMBER ..............................2-253
Table 2-254 Description of the output parameters of: LIST PPS CARDFLYNUMBER.............................2-253
Table 2-255 Description of the input parameters of: DELE PPS CARDFLYNUMBER.............................2-254
Table 2-256 Description of the output parameters of: DELE PPS CARDFLYNUMBER...........................2-254
xvi
Issue 01 (2008-01-28)

Tables
Table 2-257 Description of the input parameters of: ASSOCIATE PPS USER..........................................2-255
Table 2-258 Description of the output parameters of: ASSOCIATE PPS USER ........................................2-256
Table 2-259 Description of the input parameters of: CANCEL PPS USER ...............................................2-257
Table 2-260 Description of the output parameters of: CANCEL PPS USER .............................................2-257
Table 2-261 Description of the input parameters of: ADD PPS ABBRACCO ...........................................2-257
Table 2-262 Description of the output parameters of: ADD PPS ABBRACCO .........................................2-258
Table 2-263 Description of the input parameters of: LIST PPS ABBRACCO ...........................................2-259
Table 2-264 Description of the output parameters of: LIST PPS ABBRACCO .........................................2-259
Table 2-265 Description of the input parameters of: DELE PPS ABBRACCO..........................................2-260
Table 2-266 Description of the output parameters of: DELE PPS ABBRACCO........................................2-261
Table 2-267 Description of the input parameters of: ADD PPS GREENLIST ...........................................2-261
Table 2-268 Description of the output parameters of: ADD PPS GREENLIST .........................................2-262
Table 2-269 Description of the input parameters of: LIST PPS GREENLIST ...........................................2-262
Table 2-270 Description of the output parameters of: LIST PPS GREENLIST .........................................2-263
Table 2-271 Description of the input parameters of: DELE PPS GREENLIST..........................................2-264
Table 2-272 Description of the output parameters of: DELE PPS GREENLIST........................................2-264
Table 2-273 Description of the input parameters of: LIST PPS SUBOPRLOG .........................................2-265
Table 2-274 Description of the output parameters of: LIST PPS SUBOPRLOG........................................2-265
Table 2-275 Description of the input parameters of: SET PPS CARDBLKLIST .......................................2-266
Table 2-276 Description of the output parameters of: SET PPS CARDBLKLIST .....................................2-267
Table 2-277 Description of the input parameters of: RESET PPS USESTATE ..........................................2-268
Table 2-278 Description of the output parameters of: RESET PPS USESTATE ........................................2-268
Table 2-279 Description of the input parameters of: MODI PPS SRVDATE .............................................2-269
Table 2-280 Description of the output parameters of: MODI PPS SRVDATE ...........................................2-269
Table 2-281 Description of the input parameters of: CLR PPS CARDBLKLST........................................2-270
Table 2-282 Description of the output parameters of: CLR PPS CARDBLKLST......................................2-270
Table 2-283 Description of the input parameters of: RESET PPS USAGEFEE .........................................2-271
Table 2-284 Description of the output parameters of: RESET PPS USAGEFEE .......................................2-271
Table 2-285 Description of the input parameters of: RESET PPS ACCLEVEL.........................................2-272
Table 2-286 Description of the output parameters of: RESET PPS ACCLEVEL.......................................2-272
Table 2-287 Description of the input parameters of: SET PPS CALLSCREEN.........................................2-273
Table 2-288 Description of the output parameters of: SET PPS CALLSCREEN.......................................2-274
Table 2-289 Description of the input parameters of: LIST PPS CARDRELA............................................2-274
Issue 01 (2008-01-28)
xvii

Tables
Table 2-290 Description of the output parameters of: LIST PPS CARDRELA..........................................2-275
Table 2-291 Description of the input parameters of: DISP PPS CARDMODISTATE ................................2-276
Table 2-292 Description of the output parameters of: DISP PPS CARDMODISTATE ..............................2-276
Table 2-293 Description of the input parameters of: LIST PPS SRVCDRS...............................................2-278
Table 2-294 Description of the output parameters of: LIST PPS SRVCDRS .............................................2-278
Table 2-295 Description of the input parameters of: LIST PPS OPRCDRS...............................................2-279
Table 2-296 Description of the output parameters of: LIST PPS OPRCDRS.............................................2-280
Table 2-297 Description of the input parameters of: LIST PPS CDRS ......................................................2-281
Table 2-298 Description of the output parameters of: LIST PPS CDRS ....................................................2-282
Table 2-299 Description of the input parameters of: LIST PPS STATISTICBILL .....................................2-284
Table 2-300 Description of the output parameters of: LIST PPS STATISTICBILL ...................................2-284
Table 2-301 Description of the input parameters of: ADD PPS USERTEMP ............................................2-286
Table 2-302 Description of the output parameters of: ADD PPS USERTEMP ..........................................2-291
Table 2-303 Description of the input parameters of: MODI PPS USERTEMP ..........................................2-293
Table 2-304 Description of the output parameters of: MODI PPS USERTEMP ........................................2-298
Table 2-305 Description of the input parameters of: LIST PPS USERTEMP ............................................2-298
Table 2-306 Description of the output parameters of: LIST PPS USERTEMP ..........................................2-299
Table 2-307 Description of the input parameters of: DELE PPS USERTEMP...........................................2-300
Table 2-308 Description of the output parameters of: DELE PPS USERTEMP.........................................2-300
Table 2-309 Description of the input parameters of: LIST PPS BLACKLIST ...........................................2-301
Table 2-310 Description of the output parameters of: LIST PPS BLACKLIST .........................................2-301
Table 2-311 Description of the input parameters of: LIST PPS BALMODLOG........................................2-302
Table 2-312 Description of the output parameters of: LIST PPS BALMODLOG......................................2-303
Table 2-313 Description of the input parameters of: LIST PPS BONUSLOG ...........................................2-304
Table 2-314 Description of the output parameters of: LIST PPS BONUSLOG .........................................2-304
Table 2-315 Description of the input parameters of: LIST PPS SELLBONLOG .......................................2-305
Table 2-316 Description of the output parameters of: LIST PPS SELLBONLOG .....................................2-306
Table 2-317 Description of the input parameters of: LIST PPS FEEDEDU...............................................2-307
Table 2-318 Description of the output parameters of: LIST PPS FEEDEDU.............................................2-307
Table 2-319 Description of the input parameters of: LIST PPS CREDETAIL ...........................................2-308
Table 2-320 Description of the output parameters of: LIST PPS CREDETAIL .........................................2-309
Table 2-321 Description of the input parameters of: LIST PPS BATCHLOG............................................2-310
Table 2-322 Description of the output parameters of: LIST PPS BATCHLOG..........................................2-310
xviii
Issue 01 (2008-01-28)

Tables
Table 2-323 Description of the input parameters of: LIST PPS OPERATE ...............................................2-311
Table 2-324 Description of the output parameters of: LIST PPS OPERATE .............................................2-312
Table 2-325 Description of the input parameters of: LIST PPS CHARGEMODE .....................................2-313
Table 2-326 Description of the output parameters of: LIST PPS CHARGEMODE ...................................2-313
Table 2-327 Description of the input parameters of: LIST PPS ACTI .......................................................2-314
Table 2-328 Description of the output parameters of: LIST PPS ACTI .....................................................2-314
Table 2-329 Description of the input parameters of: LIST PPS CTI..........................................................2-315
Table 2-330 Description of the output parameters of: LIST PPS CTI........................................................2-316
Table 2-331 Description of the input parameters of: LIST PPS NORMALDISCOUNT ............................2-317
Table 2-332 Description of the output parameters of: LIST PPS NORMALDISCOUNT ..........................2-317
Table 2-333 Description of the input parameters of: LIST PPS WEEKDISCOUNT..................................2-318
Table 2-334 Description of the output parameters of: LIST PPS WEEKDISCOUNT ................................2-318
Table 2-335 Description of the input parameters of: LIST PPS HOLIDAYDISCOUNT............................2-319
Table 2-336 Description of the output parameters of: LIST PPS HOLIDAYDISCOUNT..........................2-320
Table 2-337 Description of the input parameters of: LIST PPS ICM.........................................................2-321
Table 2-338 Description of the output parameters of: LIST PPS ICM.......................................................2-321
Table 2-339 Description of the input parameters of: LIST PPS NCM .......................................................2-322
Table 2-340 Description of the output parameters of: LIST PPS NCM .....................................................2-322
Table 2-341 Description of the input parameters of: LIST PPS LGCM .....................................................2-323
Table 2-342 Description of the output parameters of: LIST PPS LGCM ...................................................2-324
Table 2-343 Description of the input parameters of :LIST PPS CHGINDEX ............................................2-325
Table 2-344 Description of the output parameters of :LIST PPS CHGINDEX ..........................................2-325
Table 2-345 Description of the input parameters of :LIST PPS CHGMSR ................................................2-326
Table 2-346 Description of the output parameters of :LIST PPS CHGMSR ..............................................2-326
Table 2-347 Description of the output parameters of: LIST PPS CURRENCYTYPE................................2-328
Table 2-348 Description of the output parameters of: LIST PPS VOICEINFO..........................................2-329
Table 2-349 Description of the output parameters of: LIST PPS LANGUAGETYPE................................2-330
Table 2-350 Description of the input parameters of: LIST PPS CHARGERULE ......................................2-331
Table 2-351 Description of the output parameters of: LIST PPS CHARGERULE.....................................2-331
Table 2-352 Description of the output parameters of: LIST PPS ACSCODE.............................................2-332
Table 2-353 Description of the input parameters of: LIST PPS VOICETREE...........................................2-333
Table 2-354 Description of the output parameters of: LIST PPS VOICETREE .........................................2-334
Table 2-355 Description of the output parameters of: LIST PPS CARDTYPE ..........................................2-335
Issue 01 (2008-01-28)
xix

Tables
Table 2-356 Description of the input parameters of: LIST PPS SDPNO....................................................2-336
Table 2-357 Description of the output parameters of: LIST PPS SDPNO..................................................2-336
Table 2-358 Description of the output parameters of: LIST PPS FILEFORMAT.......................................2-337
Table 2-359 Description of the input parameters of: LIST PPS BONUSTMP ...........................................2-338
Table 2-360 Description of the output parameters of: LIST PPS BONUSTMP .........................................2-338
Table 2-361 Description of the input parameters of: LIST PPS CARDFLGINFO .....................................2-339
Table 2-362 Description of the output parameters of: LIST PPS CARDFLGINFO....................................2-340
Table 2-363 Description of the input parameters of: DISP PPS VERSION ...............................................2-341
Table 2-364 Description of the output parameters of: DISP PPS VERSION..............................................2-341
Table 2-365 Description of the output parameters of: DISP PPS CONFIG................................................2-342
Table 2-366 Description of the input parameters of: LIST PPS TIMESEG................................................2-343
Table 2-367 Description of the output parameters of: LIST PPS TIMESEG..............................................2-343
Table 2-368 Description of the input parameters of: QRY PPS GOVTAXLOG.........................................2-344
Table 2-369 Description of the output parameters of: QRY PPS GOVTAXLOG.......................................2-345
Table 2-370 Description of the input parameters of: QRY PPS PASSWDMODLOG.................................2-346
Table 2-371 Description of the output parameters of: QRY PPS PASSWDMODLOG...............................2-347
xx
Issue 01 (2008-01-28)

Issue 01 (2008-01-28)
Tables
xxi

Contents
Contents
About This Document ................................................................................................................ 1
Issue 01 (2008-01-28)

About This Document
About This Document

Purpose
The PPS Prepaid & Postpaid Card Service MML Command Reference Guide describes the
system overview, categorization of commands, and operations of various commands.
Related Versions
The following table lists the product versions related to this document.
Product Name
Version
PPS Prepaid & Postpaid

Card Service
V500R002C01B020_01
Intended Audience
The manual is intended for the PPS Service SMAP Operator.
Organization
This document consists of 2 chapters and is organized as follows.
Chapter
Content
Introduction to PPS-BMML
System
This chapter describes the PPS-BMML system overview,

the advantages of the PPS-BMML system, software
architecture of the BMML system, and BMML command
flows.
Issue 01 (2008-01-28)

About This Document
Chapter
Content
Description of PPS-BMML
Commands
This chapter describes the general information of BMML

commands such as general errors, common parameters,
coding scheme of the system parameters, and execution of
the commands, the categorization of BMML commands. It
also describes the operations related to:
Service Management
Service Provider
Product Management
Batch Management
Single Card Management Settings
CDRs Management Settings
User Template Management
Charging Matrix Management
Additional Management
The description of tasks for chapter 2 is organized as follows.

Block
Description
Command Name
This block describes the name of the MML Command.
Command Function
This block describes the function of the MML Command.
Input Parameters
This block describes the input parameters of the MML

Command.
Output Parameters
This block describes the output parameters of the MML

Command.
Example
This block describes an example for the MML Command
Conventions
Symbol Conventions
The symbols that may be found in this document are defined as follows.
Symbol
Description
Indicates a hazard with a high level of risk that, if not avoided,
will result in death or serious injury.
Indicates a hazard with a medium or low level of risk which, if
not avoided, could result in minor or moderate injury.
Issue 01 (2008-01-28)

Symbol
About This Document
Description
Indicates a potentially hazardous situation that, if not avoided,
could cause equipment damage, data loss, and performance
degradation, or unexpected results.
Indicates a tip that may help you solve a problem or save time.
Provides additional information to emphasize or supplement
important points of the main text.
General Conventions
Convention
Description
Times New Roman
Normal paragraphs are in Times New Roman.
Boldface
Names of files, directories, folders, and users are in

boldface. For example, log in as user root.
Italic
Book titles are in italics.
Courier New
Terminal display is in Courier New.
Command Conventions
Convention
Description
Boldface
The keywords of a command line are in boldface.
Italic
Command arguments are in italics.
[]
Items (keywords or arguments) in square brackets [ ] are

optional.
{ x | y | ... }
Alternative items are grouped in braces and separated by

vertical bars. One is selected.
[ x | y | ... ]
Optional alternative items are grouped in square brackets

and separated by vertical bars. One or none is selected.
{ x | y | ... } *
Alternative items are grouped in braces and separated by

vertical bars. A minimum of one or a maximum of all can
be selected.
GUI Conventions
Convention
Description
Boldface
Buttons, menus, parameters, tabs, windows, and dialog titles

are in boldface. For example, click OK.
Issue 01 (2008-01-28)

About This Document
Convention
Description
>
Multi-level menus are in boldface and separated by the ">"

signs. For example, choose File > Create > Folder.
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
Click
Select and release the primary mouse button without

moving the pointer.
Double-click
Press the primary mouse button twice continuously and

quickly without moving the pointer.
Drag
Press and hold the primary mouse button and move the
pointer to a certain position.
Issue 01 (2008-01-28)
PPS Prepaid and Postpaid Card Service

Contents
Contents
1 Introduction to PPS-BMML System ...................................................................................1-1
About This Chapter ...................................................................................................................................... 1-1
1.1 System Overview ................................................................................................................................... 1-2
1.2 Advantages of BMML ............................................................................................................................ 1-2
1.2.1 Data Types Supported .................................................................................................................... 1-2
1.2.2 Service Logic Processing Capability .............................................................................................. 1-2
1.2.3 Transaction Processing Capability.................................................................................................. 1-2
1.3 System Structure..................................................................................................................................... 1-3
1.3.1 Software Architecture .................................................................................................................... 1-3
1.3.2 Process Introduction ...................................................................................................................... 1-4
1.4 Typical BMML Command Flows ............................................................................................................ 1-5
1.4.1 Installation of BMML.................................................................................................................... 1-5
2 Description of PPS-BMML Commands .............................................................................2-1

About This Chapter ...................................................................................................................................... 2-1
2.1 General Information ............................................................................................................................... 2-2
2.2 Categorization of BMML Commands...................................................................................................... 2-6
2.3 Service Management ............................................................................................................................ 2-12
2.3.1 Adding Access Code Surcharge Settings....................................................................................... 2-12
2.3.2 Querying Access Code Surcharge Settings.................................................................................... 2-13
2.3.3 Deleting Access Code Surcharge Settings..................................................................................... 2-14
2.3.4 Adding Language Selection Settings ............................................................................................ 2-15
2.3.5 Querying Language Selection Settings ......................................................................................... 2-17
2.3.6 Deleting Language Selection Settings........................................................................................... 2-18
2.3.7 Adding Service Calling Blacklist Settings..................................................................................... 2-19
2.3.8 Querying Service Calling Blacklist Settings ................................................................................. 2-20
2.3.9 Deleting Service Calling Blacklist Settings................................................................................... 2-22
2.3.10 Adding Destination Black List Number Settings ......................................................................... 2-23
2.3.11 Querying Destination Black List Number Settings ...................................................................... 2-25
2.3.12 Deleting Destination Black List Number Settings ....................................................................... 2-26
2.3.13 Adding Calling Numbers without IVA ........................................................................................ 2-27
2.3.14 Querying Calling Numbers without IVA..................................................................................... 2-28
2.3.15 Deleting Calling Numbers without IVA ...................................................................................... 2-30
Issue 01 (2008-01-28)

Contents
2.3.16 Adding Access Code Settings ..................................................................................................... 2-31

2.3.17 Modifying Access Code Settings ................................................................................................ 2-38
2.3.18 Querying Access Code Settings.................................................................................................. 2-46
2.3.19 Deleting Access Code Settings ................................................................................................... 2-47
2.3.20 Querying Service Information Settings ....................................................................................... 2-49
2.3.21 Querying Service Configuration Information .............................................................................. 2-50
2.4 Service Provider ................................................................................................................................... 2-51
2.4.1 Listing SPs .................................................................................................................................. 2-51
2.4.2 Counting the Total Number of SPs ............................................................................................... 2-52
2.4.3 Querying Relevant Information of an SP ...................................................................................... 2-53
2.4.4 Querying Relevant Parameter Information of an SP...................................................................... 2-54
2.4.5 Querying Relevant Charge Information of an SP .......................................................................... 2-56
2.4.6 Querying Relevant Information of SP Access Codes ..................................................................... 2-57
2.4.7 Querying Relevant Information of SP Features ............................................................................. 2-58
2.4.8 Querying Information in the Usage Bonus Log Table.................................................................... 2-59
2.4.9 Querying the Usage Bonus Information Table .............................................................................. 2-61
2.4.10 Adding Called Screen Based on Calling Numbers....................................................................... 2-62
2.4.11 Querying Called Screen Based on Calling Numbers.................................................................... 2-63
2.4.12 Deleting Called Screen Based on Calling Numbers..................................................................... 2-65
2.4.13 Adding Information in the Recharge Prolongation Table ............................................................. 2-66
2.4.14 Modifying Information in the Recharge Prolongation Table ........................................................ 2-67
2.4.15 Querying Information in the Recharge Prolongation Table .......................................................... 2-68
2.4.16 Deleting Information in the Recharge Prolongation Table ........................................................... 2-70
2.4.17 Adding Information to the Recharge Bonus Table ....................................................................... 2-71
2.4.18 Modifying Information in the Recharge Bonus Table .................................................................. 2-72
2.4.19 Querying Information from the Recharge Bonus Table................................................................ 2-74
2.4.20 Deleting Information in the Recharge Bonus Table ..................................................................... 2-76
2.4.21 Querying Serve Level Settings ................................................................................................... 2-77
2.4.22 Querying Time Slot Settings....................................................................................................... 2-79
2.4.23 Querying Customer Ser. Center Number Settings........................................................................ 2-80
2.4.24 Querying Day Category Settings ................................................................................................ 2-81
2.4.25 Querying Virtual Calling Number Settings ................................................................................. 2-83
2.4.26 Querying Holiday Category Settings .......................................................................................... 2-84
2.4.27 Querying Abbreviated Account Screen Numbers ........................................................................ 2-85
2.4.28 Querying Statistics Called/Callee Number Settings..................................................................... 2-87
2.4.29 Querying Route Information ...................................................................................................... 2-88
2.5 Product Management ............................................................................................................................ 2-89
2.5.1 Listing Products........................................................................................................................... 2-89
2.5.2 Counting the Total Number of Products........................................................................................ 2-91
2.5.3 Querying Relevant Information of Products.................................................................................. 2-92
2.5.4 Querying the Access Codes Distributed to Products...................................................................... 2-93
2.5.5 Modifying Product Parameters ..................................................................................................... 2-95
ii
Issue 01 (2008-01-28)

Contents
2.5.6 Querying Product Charge Package ............................................................................................... 2-96

2.5.7 Querying the Product Level Parameters Table .............................................................................. 2-97
2.5.8 Querying Product Level Calling Category Number Screen............................................................ 2-99
2.5.9 Querying Access Code and Nested Call Methods Distributed at Product Level.............................2-101
2.5.10 Querying Callee and Time Based Message Setting.....................................................................2-102
2.5.11 Querying the Product Level Familiarity Number Configuration .................................................2-104
2.5.12 Querying the Product Level Caller and Time based Message Settings ........................................2-105
2.6 Batch Management ..............................................................................................................................2-107
2.6.1 Listing Batches ...........................................................................................................................2-107
2.6.2 Counting Batches........................................................................................................................2-109
2.6.3 Querying Batch...........................................................................................................................2-110
2.6.4 Querying Batch Discount ............................................................................................................ 2-111
2.6.5 Querying the Batch Level Parameters Table ................................................................................2-113
2.6.6 Creating a Batch of Cards ...........................................................................................................2-115
2.6.7 Activating a Batch of Cards.........................................................................................................2-124
2.6.8 Deactivating a Batch of Cards .....................................................................................................2-127
2.6.9 Modifying a Batch of Cards ........................................................................................................2-129
2.6.10 Deleting a Batch of Cards .........................................................................................................2-135
2.6.11 Adding the Caller Binding Category Screen Information............................................................2-137
2.6.12 Querying the Caller Binding Category Screen Information ........................................................2-139
2.6.13 Deleting the Caller Binding Category Screen Information..........................................................2-140
2.6.14 Adding Batch Abbreviated Numbers..........................................................................................2-141
2.6.15 Modifying Batch Abbreviated Numbers ....................................................................................2-143
2.6.16 Querying Batch Abbreviated Numbers ......................................................................................2-144
2.6.17 Deleting Batch Abbreviated Numbers........................................................................................2-146
2.6.18 Querying the Batch Level Binding Calling Number Screen Settings...........................................2-147
2.6.19 Querying the Batch Level Time Based Message Settings ...........................................................2-149
2.6.20 Adding Calling Category Screen at Batch Level ........................................................................2-150
2.6.21 Querying Calling Category Screen at Batch Level .....................................................................2-151
2.6.22 Deleting Calling Category Screen at Batch Level.......................................................................2-152
2.6.23 Adding Green Numbers at Batch Level......................................................................................2-154
2.6.24 Deleting Green Numbers at Batch Level....................................................................................2-155
2.6.25 Querying Green Numbers at Batch Level ..................................................................................2-156
2.6.26 Cancelling Batch Operations of Cards .......................................................................................2-157
2.6.27 Querying the Reason for Deleting Cards in Batches...................................................................2-158
2.6.28 Loading Cards in Batches..........................................................................................................2-159
2.6.29 Unloading Cards in Batches ......................................................................................................2-162
2.6.30 Importing Cards in Batches.......................................................................................................2-164
2.6.31 Querying Statuses of Batch Level Parameters............................................................................2-176
2.6.32 Adding Batch Level Parameters ................................................................................................2-177
2.6.33 Modifying Batch Level Parameters ...........................................................................................2-184
2.6.34 Deleting Batch Level Parameters...............................................................................................2-191
Issue 01 (2008-01-28)
iii

Contents
2.7 Single Card Management Settings........................................................................................................2-192

2.7.1 Listing Single Cards in a Batch ...................................................................................................2-192
2.7.2 Counting Single Cards in a Batch................................................................................................2-196
2.7.3 Querying the Information About a Card.......................................................................................2-199
2.7.4 Modifying the Information of a Single Card ................................................................................2-201
2.7.5 Changing the Password of a Card ................................................................................................2-210
2.7.6 Binding a Calling Number ..........................................................................................................2-211
2.7.7 Unbinding a Calling Number ......................................................................................................2-213
2.7.8 Changing the Card-Binding Password .........................................................................................2-214
2.7.9 Querying the Binding Status of a Calling Number(or a Card Number) .........................................2-216
2.7.10 Adding the Calling Screen Information......................................................................................2-218
2.7.11 Querying the Calling Screen Information...................................................................................2-219
2.7.12 Deleting the Calling Screen Information....................................................................................2-221
2.7.13 Adding the Called Screen Information .......................................................................................2-223
2.7.14 Querying the Called Screen Information....................................................................................2-224
2.7.15 Deleting the Called Screen Information .....................................................................................2-226
2.7.16 Adding the Abbreviated Number ...............................................................................................2-227
2.7.17 Modifying the Abbreviated Number ..........................................................................................2-229
2.7.18 Querying the Abbreviated Number ............................................................................................2-230
2.7.19 Deleting the Abbreviated Number .............................................................................................2-232
2.7.20 Querying Familiarity Number and Relating Discount.................................................................2-233
2.7.21 Querying Card Number PIN......................................................................................................2-235
2.7.22 Deducting Charge .....................................................................................................................2-236
2.7.23 Recharging by a Card................................................................................................................2-238
2.7.24 Verifying the Card Validity........................................................................................................2-241
2.7.25 Querying the Information of Online-Sale Cards .........................................................................2-243
2.7.26 Selling Cards Online.................................................................................................................2-244
2.7.27 Querying Historical Records .....................................................................................................2-246
2.7.28 Recharging ...............................................................................................................................2-247
2.7.29 Correcting Recharge .................................................................................................................2-248
2.7.30 Querying Recharge Logs...........................................................................................................2-250
2.7.31 Adding Familiarity Numbers .....................................................................................................2-251
2.7.32 Querying Familiarity Numbers..................................................................................................2-253
2.7.33 Deleting Familiarity Numbers ...................................................................................................2-254
2.7.34 Card-related Users Settings .......................................................................................................2-255
2.7.35 Cancelling Card-related Users Settings......................................................................................2-256
2.7.36 Adding Abbreviated Accounts Settings ......................................................................................2-257
2.7.37 Querying Abbreviated Account Numbers or Card Numbers .......................................................2-258
2.7.38 Deleting Abbreviated Accounts Settings ....................................................................................2-260
2.7.39 Adding Green Numbers at Subscriber Level ..............................................................................2-261
2.7.40 Querying Green Numbers at Subscriber Level ...........................................................................2-262
2.7.41 Deleting Green Numbers at Subscriber Level ............................................................................2-263
iv
Issue 01 (2008-01-28)

Contents
2.7.42 Querying Single User Logs .......................................................................................................2-264

2.7.43 Setting Blacklists ......................................................................................................................2-266
2.7.44 Resetting Single Cards ..............................................................................................................2-267
2.7.45 Modifying Validity Dates of Single Cards..................................................................................2-268
2.7.46 Clearing Single Card Blacklists.................................................................................................2-269
2.7.47 Resetting Accumulated Call Cost of Single Cards......................................................................2-270
2.7.48 Resetting Usage Points Level of Single Cards............................................................................2-271
2.7.49 Setting Call Type Screen for Single Cards .................................................................................2-272
2.7.50 Querying Main-Child Cards ......................................................................................................2-274
2.7.51 Querying Modifiable State of the Single Card Maintenance Interface.........................................2-275
2.8 CDRs ManagementSettings .................................................................................................................2-277
2.8.1 Querying Service Bills................................................................................................................2-277
2.8.2 Querying Operation Bills ............................................................................................................2-279
2.8.3 Querying Bills ............................................................................................................................2-281
2.8.4 Querying Statistical Bill Information...........................................................................................2-283
2.9 User Template Management.................................................................................................................2-285
2.9.1 Adding User Template ................................................................................................................2-285
2.9.2 Modifying User Template ...........................................................................................................2-292
2.9.3 Querying User Template .............................................................................................................2-298
2.9.4 Deleting User Template...............................................................................................................2-300
2.9.5 Querying Blacklists in Batches....................................................................................................2-301
2.9.6 Querying Balance Modification Logs ..........................................................................................2-302
2.9.7 Querying Bonus Logs .................................................................................................................2-303
2.9.8 Querying Sales Bonus Logs ........................................................................................................2-305
2.9.9 Querying BMML Deduction Logs...............................................................................................2-306
2.9.10 Querying Card Creation Information .........................................................................................2-308
2.9.11 Querying Batch Operation Logs ................................................................................................2-309
2.9.12 Querying Operation Types of Logs ............................................................................................2-311
2.10 Charging Matrix Management............................................................................................................2-313
2.10.1 Querying the Charging Mode ....................................................................................................2-313
2.10.2 Querying the Adjusted Charging Class Index.............................................................................2-314
2.10.3 Querying the Charging Class Index ...........................................................................................2-315
2.10.4 Querying the Daily Charge Rate Modulator...............................................................................2-316
2.10.5 Querying the Weekly Charge Rate Modulator............................................................................2-318
2.10.6 Querying the Holiday Charge Rate Modulator ...........................................................................2-319
2.10.7 Querying the International Charging Matrix ..............................................................................2-320
2.10.8 Querying the National Charging Matrix.....................................................................................2-322
2.10.9 Querying the Local Group Charging Matrix ..............................................................................2-323
2.10.10 Querying Charge Index Table ..................................................................................................2-324
2.10.11 Querying Charge Measure Table..............................................................................................2-326
2.11 Additional Management .....................................................................................................................2-327
2.11.1 Querying Currency Types..........................................................................................................2-327
Issue 01 (2008-01-28)

Contents
2.11.2 Querying Voice Information ......................................................................................................2-328

2.11.3 Querying Language Types.........................................................................................................2-329
2.11.4 Querying Charge Rules .............................................................................................................2-330
2.11.5 Querying All Access Codes .......................................................................................................2-332
2.11.6 Querying the Voice Menu Tree ..................................................................................................2-333
2.11.7 Querying Card Types ................................................................................................................2-334
2.11.8 Querying the SDP in Service Area .............................................................................................2-335
2.11.9 Querying the Batch File Format.................................................................................................2-337
2.11.10 Querying the Bonus Template..................................................................................................2-338
2.11.11 Querying the Function Status During Batch Import ..................................................................2-339
2.11.12 Querying the Service Version ..................................................................................................2-340
2.11.13 Querying the Service Configuration Information......................................................................2-342
2.11.14 Querying Time Segments ........................................................................................................2-342
2.11.15 Query Government Tax Logs...................................................................................................2-344
2.11.16 Query Password Modification Log ..........................................................................................2-346
vi
Issue 01 (2008-01-28)

Figures
Figures
Figure 1-1 Software Architecture ................................................................................................................. 1-3
Issue 01 (2008-01-28)
vii

Tables
Tables
Table 2-1 Description of the general errors in the MML commands .............................................................. 2-2
Table 2-2 Description of the common parameters for the MML commands ................................................... 2-4
Table 2-3 List of commands ......................................................................................................................... 2-6
Table 2-4 Description of the input parameters of: ADD PPS ACCSUR ....................................................... 2-12
Table 2-5 Description of the output parameters of: ADD PPS ACCSUR...................................................... 2-12
Table 2-6 Description of the input parameters of: LIST PPS ACCSUR ....................................................... 2-13
Table 2-7 Description of the output parameters of: LIST PPS ACCSUR...................................................... 2-13
Table 2-8 Description of the input parameters of: DELE PPS ACCSUR...................................................... 2-14
Table 2-9 Description of the output parameters of: DELE PPS ACCSUR.................................................... 2-15
Table 2-10 Description of the input parameters of: ADD PPS LANGSELECT ............................................ 2-16
Table 2-11 Description of the output parameters of: ADD PPS LANGSELECT .......................................... 2-16
Table 2-12 Description of the input parameters of: LIST PPS LANGSELECT ............................................ 2-17
Table 2-13 Description of the output parameters of: LIST PPS LANGSELECT .......................................... 2-17
Table 2-14 Description of the input parameters of: DELE PPS LANGSELECT .......................................... 2-18
Table 2-15 Description of the output parameters of: DELE PPS LANGSELECT......................................... 2-19
Table 2-16 Description of the input parameters of: ADD PPS CALLINGBLK ............................................ 2-19
Table 2-17 Description of the output parameters of: ADD PPS CALLINGBLK .......................................... 2-20
Table 2-18 Description of the input parameters of: QRY PPS CALLINGBLK............................................. 2-20
Table 2-19 Description of the output parameters of: QRY PPS CALLINGBLK........................................... 2-21
Table 2-20 Description of the input parameters of: DELE PPS CALLINGBLK........................................... 2-22
Table 2-21 Description of the output parameters of: DELE PPS CALLINGBLK......................................... 2-22
Table 2-22 Description of the input parameters of: ADD PPS DESTBLKLST............................................. 2-23
Table 2-23 Description of the output parameters of: ADD PPS DESTBLKLST........................................... 2-23
Table 2-24 Description of the input parameters of: LIST PPS DESTBLKLST............................................. 2-25
Table 2-25 Description of the output parameters of: LIST PPS DESTBLKLST........................................... 2-25
Table 2-26 Description of the input parameters of: DELE PPS DESTBLKLST........................................... 2-26
Issue 01 (2008-01-28)
ix

Tables
Table 2-27 Description of the output parameters of: DELE PPS DESTBLKLST ......................................... 2-27
Table 2-28 Description of the input parameters of: ADD PPS NOIVACALLLIST....................................... 2-28
Table 2-29 Description of the output parameters of: ADD PPS NOIVACALLLIST..................................... 2-28
Table 2-30 Description of the input parameters of: LIST PPS NOIVACALLLIST ....................................... 2-29
Table 2-31 Description of the output parameters of: LIST PPS NOIVACALLLIST ..................................... 2-29
Table 2-32 Description of the input parameters of: DELE PPS NOIVACALLLIST ..................................... 2-30
Table 2-33 Description of the output parameters of: DELE PPS NOIVACALLLIST ................................... 2-30
Table 2-34 Description of the input parameters of: ADD PPS ACCESSCODE ............................................ 2-32
Table 2-35 Description of the output parameters of: ADD PPS ACCESSCODE .......................................... 2-38
Table 2-36 Description of the input parameters of: MOD PPS ACCESSCODE ........................................... 2-39
Table 2-37 Description of the output parameters of: MOD PPS ACCESSCODE ......................................... 2-45
Table 2-38 Description of the input parameters of: DISP PPS ACSCODE................................................... 2-46
Table 2-39 Description of the output parameters of: DISP PPS ACSCODE................................................. 2-47
Table 2-40 Description of the input parameters of: DELE PPS ACCESSCODE .......................................... 2-48
Table 2-41 Description of the output parameters of: DELE PPS ACCESSCODE......................................... 2-48
Table 2-42 Description of the output parameters of: DISP PPS SRVPARA.................................................. 2-49
Table 2-43 Description of the input parameters of: DISP PPS SRVCONFIG ............................................... 2-50
Table 2-44 Description of the output parameters of: DISP PPS SRVCONFIG ............................................. 2-50
Table 2-45 Description of the output parameters of: LIST PPS SP .............................................................. 2-51
Table 2-46 Description of the output parameters of: COUNT PPS SP ......................................................... 2-52
Table 2-47 Description of the input parameters of: DISP PPS SPINFO ....................................................... 2-53
Table 2-48 Description of the output parameters of: DISP PPS SPINFO ..................................................... 2-53
Table 2-49 Description of the input parameters of: DISP PPS SPPARA ...................................................... 2-54
Table 2-50 Description of the output parameters of: DISP PPS SPPARA..................................................... 2-54
Table 2-51 Description of the input parameters of: DISP PPS SPCHRGINFO............................................. 2-56
Table 2-52 Description of the output parameters of: DISP PPS SPCHRGINFO ........................................... 2-56
Table 2-53 Description of the output parameters of: LIST PPS SPACCESSCODE ...................................... 2-58
Table 2-54 Description of the input parameters of: DISP PPS SPFEATURES ............................................. 2-59
Table 2-55 Description of the output parameters of: DISP PPS SPFEATURES............................................ 2-59
Table 2-56 Description of the input parameters of: LIST PPS ACCUMBNSLOG........................................ 2-60
Table 2-57 Description of the output parameters of: LIST PPS ACCUMBNSLOG...................................... 2-60
Table 2-58 Description of the input parameters of: LIST PPS SPACCUMBONUS ...................................... 2-61
Table 2-59 Description of the output parameters of: LIST PPS SPACCUMBONUS .................................... 2-62
Issue 01 (2008-01-28)

Tables
Table 2-60 Description of the input parameters of: ADD PPS CALLEDSRCOFCLI ................................... 2-63
Table 2-61 Description of the output parameters of: ADD PPS CALLEDSRCOFCLI.................................. 2-63
Table 2-62 Description of the input parameters of: LIST PPS CALLEDSRCOFCLI.................................... 2-64
Table 2-63 Description of the output parameters of: LIST PPS CALLEDSRCOFCLI.................................. 2-64
Table 2-64 Description of the input parameters of: DELE PPS CALLEDSRCOFCLI.................................. 2-65
Table 2-65 Description of the output parameters of: DELE PPS CALLEDSRCOFCLI................................ 2-65
Table 2-66 Description of the input parameters of: ADD PPS SPPROLONGDATA..................................... 2-66
Table 2-67 Description of the output parameters of: ADD PPS SPPROLONGDATA................................... 2-67
Table 2-68 Description of the input parameters of: MODI PPS SPPROLONGDATA................................... 2-67
Table 2-69 Description of the output parameters of: MODI PPS SPPROLONGDATA................................. 2-68
Table 2-70 Description of the input parameters of: LIST PPS SPPROLONGDATA..................................... 2-69
Table 2-71 Description of the output parameters of: LIST PPS SPPROLONGDATA................................... 2-69
Table 2-72 Description of the input parameters of: DELE PPS SPPROLONGDATA ................................... 2-70
Table 2-73 Description of the output parameters of: DELE PPS SPPROLONGDATA ................................. 2-70
Table 2-74 Description of the input parameters of: ADD PPS SPRECHRGBNS.......................................... 2-71
Table 2-75 Description of the output parameters of: ADD PPS SPRECHRGBNS........................................ 2-72
Table 2-76 Description of the input parameters of: MODI PPS SPRECHRGBNS ....................................... 2-73
Table 2-77 Description of the output parameters of: MODI PPS SPRECHRGBNS...................................... 2-74
Table 2-78 Description of the input parameters of: LIST PPS SPRECHRGBNS.......................................... 2-75
Table 2-79 Description of the output parameters of: LIST PPS SPRECHRGBNS........................................ 2-75
Table 2-80 Description of the input parameters of: DELE PPS SPRECHRGBNS........................................ 2-76
Table 2-81 Description of the output parameters of: DELE PPS SPRECHRGBNS ...................................... 2-77
Table 2-82 Description of the input parameters of: LIST PPS SERVLEVEL ............................................... 2-78
Table 2-83 Description of the output parameters of: LIST PPS SERVLEVEL ............................................. 2-78
Table 2-84 Description of the input parameters of: LIST PPS TIMESLOT .................................................. 2-79
Table 2-85 Description of the output parameters of: LIST PPS TIMESLOT ................................................ 2-79
Table 2-86 Description of the input parameters of: LIST PPS CSC ............................................................. 2-80
Table 2-87 Description of the output parameters of: LIST PPS CSC............................................................ 2-81
Table 2-88 Description of the input parameters of: LIST PPS DAYCAT...................................................... 2-82
Table 2-89 Description of the output parameters of: LIST PPS DAYCAT.................................................... 2-82
Table 2-90 Description of the input parameters of: LIST PPS VIRTUALCLI .............................................. 2-83
Table 2-91 Description of the output parameters of: LIST PPS VIRTUALCLI ............................................ 2-83
Table 2-92 Description of the input parameters of: LIST PPS HOLIDAYCAT............................................. 2-84
Issue 01 (2008-01-28)
xi

Tables
Table 2-93 Description of the output parameters of: LIST PPS HOLIDAYCAT........................................... 2-85
Table 2-94 Description of the input parameters of: LIST PPS ABBRACCSCR............................................ 2-86
Table 2-95 Description of the output parameters of: LIST PPS ABBRACCSCR.......................................... 2-86
Table 2-96 Description of the input parameters of: LIST PPS STATCLIDST............................................... 2-87
Table 2-97 Description of the output parameters of: LIST PPS STATCLIDST............................................. 2-87
Table 2-98 Description of the input parameters of: LIST PPS ROUTEINFO ............................................... 2-88
Table 2-99 Description of the output parameters of: LIST PPS ROUTEINFO ............................................. 2-89
Table 2-100 Description of the input parameters of: LIST PPS PRODUCT................................................. 2-90
Table 2-101 Description of the output parameters of: LIST PPS PRODUCT ............................................... 2-90
Table 2-102 Description of the input parameters of: COUNT PPS PRODUCT............................................ 2-91
Table 2-103 Description of the output parameters of: COUNT PPS PRODUCT .......................................... 2-91
Table 2-104 Description of the input parameters of: DISP PPS PDTINFO .................................................. 2-92
Table 2-105 Description of the output parameters of: DISP PPS PDTINFO................................................. 2-92
Table 2-106 Description of the input parameters of: LIST PPS PDTACSCODE .......................................... 2-94
Table 2-107 Description of the output parameters of: LIST PPS PDTACSCODE ........................................ 2-94
Table 2-108 Description of the input parameters of: MODI PPS PDTPARA................................................ 2-95
Table 2-109 Description of the output parameters of: MODI PPS PDTPARA.............................................. 2-95
Table 2-110 Description of the input parameters of: LIST PPS PDTCHGPKG ............................................ 2-96
Table 2-111 Description of the output parameters of: LIST PPS PDTCHGPKG .......................................... 2-97
Table 2-112 Description of the input parameters of: LIST PPS PDTPARA .................................................. 2-98
Table 2-113 Description of the output parameters of: LIST PPS PDTPARA ................................................ 2-98
Table 2-114 Description of the input parameters of: LIST PPS CALLCATSCR........................................... 2-99
Table 2-115 Description of the output parameters of: LIST PPS CALLCATSCR........................................2-100
Table 2-116 Description of the input parameters of: LIST PPS NESTCALL ..............................................2-101
Table 2-117 Description of the output parameters of: LIST PPS NESTCALL.............................................2-101
Table 2-118 Description of the input parameters of: LIST PPS CALLEETMMSG .....................................2-102
Table 2-119 Description of the output parameters of: LIST PPS CALLEETMMSG....................................2-103
Table 2-120 Description of the input parameters of: LIST PPS FAMILYNUMSCR....................................2-104
Table 2-121 Description of the output parameters of: LIST PPS FAMILYNUMSCR..................................2-104
Table 2-122 Description of the input parameters of: LIST PPS CLRTIMMSG ...........................................2-105
Table 2-123 Description of the output parameters of: LIST PPS CLRTIMMSG .........................................2-106
Table 2-124 Description of the input parameters of: LIST PPS BATCH .....................................................2-107
Table 2-125 Description of the output parameters of: LIST PPS BATCH ...................................................2-108
xii
Issue 01 (2008-01-28)

Tables
Table 2-126 Description of the input parameters of: COUNT PPS BATCH ................................................2-109
Table 2-127 Description of the output parameters of: COUNT PPS BATCH ..............................................2-109
Table 2-128 Description of the input parameters of: DISP PPS BATCH .....................................................2-110
Table 2-129 Description of the output parameters of: DISP PPS BATCH ................................................... 2-111
Table 2-130 Description of the input parameters of: DISP PPS BATCHDISCOUNT..................................2-112
Table 2-131 Description of the output parameters of: DISP PPS BATCHDISCOUNT ................................2-112
Table 2-132 Description of the input parameters of: DISP PPS BATCHPARA ...........................................2-113
Table 2-133 Description of the output parameters of: DISP PPS BATCHPARA .........................................2-113
Table 2-134 Description of the input parameters of: CREATE PPS BATCH...............................................2-115
Table 2-135 Description of the output parameters of: CREATE PPS BATCH .............................................2-119
Table 2-136 Description of the input parameters of: ACTIVATE PPS BATCHCARD.................................2-124
Table 2-137 Description of the output parameters of: ACTIVATE PPS BATCHCARD ...............................2-126
Table 2-138 Description of the input parameters of: DEACTIVATE PPS BATCH ......................................2-127
Table 2-139 Description of the output parameters of: DEACTIVATE PPS BATCH ....................................2-129
Table 2-140 Description of the input parameters of: MODI PPS BATCH ...................................................2-130
Table 2-141 Description of the output parameters of: MODI PPS BATCH .................................................2-134
Table 2-142 Description of the input parameters of: DELE PPS BATCH....................................................2-135
Table 2-143 Description of the output parameters of: DELE PPS BATCH..................................................2-137
Table 2-144 Description of the input parameters of: ADD PPS BDINGSCRCAT .......................................2-138
Table 2-145 Description of the output parameters of: ADD PPS BDINGSCRCAT .....................................2-138
Table 2-146 Description of the input parameters of: LIST PPS BDINGSCRCAT .......................................2-139
Table 2-147 Description of the output parameters of: LIST PPS BDINGSCRCAT .....................................2-139
Table 2-148 Description of the input parameters of: DELE PPS BDINGSCRCAT......................................2-140
Table 2-149 Description of the output parameters of: DELE PPS BDINGSCRCAT....................................2-141
Table 2-150 Description of the input parameters of: ADD PPS BATCHABBR...........................................2-142
Table 2-151 Description of the output parameters of: ADD PPS BATCHABBR .........................................2-142
Table 2-152 Description of the input parameters of: MODI PPS BATCHABBR.........................................2-143
Table 2-153 Description of the output parameters of: MODI PPS BATCHABBR.......................................2-144
Table 2-154 Description of the input parameters of: LIST PPS BATCHABBR ...........................................2-145
Table 2-155 Description of the output parameters of: LIST PPS BATCHABBR .........................................2-145
Table 2-156 Description of the input parameters of: DELE PPS BATCHABBR .........................................2-146
Table 2-157 Description of the output parameters of: DELE PPS BATCHABBR .......................................2-147
Table 2-158 Description of the input parameters of: LIST PPS BINDCALLSCR .......................................2-148
Issue 01 (2008-01-28)
xiii

Tables
Table 2-159 Description of the output parameters of: LIST PPS BINDCALLSCR .....................................2-148
Table 2-160 Description of the input parameters of: QRY PPS TIMEMSG.................................................2-149
Table 2-161 Description of the output parameters of: QRY PPS TIMEMSG...............................................2-149
Table 2-162 Description of the input parameters of: ADD PPS BATCATSCR ............................................2-150
Table 2-163 Description of the output parameters of: ADD PPS BATCATSCR ..........................................2-151
Table 2-164 Description of the input parameters of: LIST PPS BATCATSCR ............................................2-151
Table 2-165 Description of the output parameters of: LIST PPS BATCATSCR ..........................................2-152
Table 2-166 Description of the input parameters of: DELE PPS BATCATSCR ..........................................2-153
Table 2-167 Description of the output parameters of: DELE PPS BATCATSCR.........................................2-153
Table 2-168 Description of the input parameters of: ADD PPS BATGREEN..............................................2-154
Table 2-169 Description of the output parameters of: ADD PPS BATGREEN............................................2-154
Table 2-170 Description of the input parameters of: DELE PPS BATGREEN ............................................2-155
Table 2-171 Description of the output parameters of: DELE PPS BATGREEN ..........................................2-155
Table 2-172 Description of the input parameters of: LIST PPS BATGREEN..............................................2-156
Table 2-173 Description of the output parameters of: LIST PPS BATGREEN ............................................2-156
Table 2-174 Description of the input parameters of: STOP PPS BATCHOPR.............................................2-157
Table 2-175 Description of the output parameters of: STOP PPS BATCHOPR...........................................2-158
Table 2-176 Description of the input parameters of: LIST PPS DELREA...................................................2-158
Table 2-177 Description of the output parameters of: LIST PPS DELREA.................................................2-158
Table 2-178 Description of the input parameters of: LOAD PPS BATCARD .............................................2-160
Table 2-179 Description of the output parameters of: LOAD PPS BATCARD............................................2-161
Table 2-180 Description of the input parameters of: UNLOAD PPS BATCARD ........................................2-162
Table 2-181 Description of the output parameters of: UNLOAD PPS BATCARD ......................................2-164
Table 2-182 Description of the input parameters of: IMPORT PPS BATCHCARD.....................................2-165
Table 2-183 Description of the output parameters of: IMPORT PPS BATCHCARD...................................2-175
Table 2-184 Description of the input parameters of: DISP PPS BATMODISTATE .....................................2-176
Table 2-185 Description of the output parameters of: DISP PPS BATMODISTATE ...................................2-176
Table 2-186 Description of the input parameters of: ADD PPS BATCHPARA ...........................................2-177
Table 2-187 Description of the output parameters of: ADD PPS BATCHPARA .........................................2-184
Table 2-188 Description of the input parameters of: MODI PPS BATCHPARA .........................................2-184
Table 2-189 Description of the output parameters of: MODI PPS BATCHPARA .......................................2-190
Table 2-190 Description of the input parameters of: DELE PPS BATCHPARA..........................................2-191
Table 2-191 Description of the output parameters of: DELE PPS BATCHPARA........................................2-191
xiv
Issue 01 (2008-01-28)

Tables
Table 2-192 Description of the input parameters of: LIST PPS CARD .......................................................2-192
Table 2-193 Description of the output parameters of: LIST PPS CARD .....................................................2-196
Table 2-194 Description of the input parameters of: COUNT PPS CARD ..................................................2-197
Table 2-195 Description of the output parameters of: COUNT PPS CARD ................................................2-198
Table 2-196 Description of the input parameters of: LIST PPS CARDINFO ..............................................2-199
Table 2-197 Description of the output parameters of: LIST PPS CARDINFO ............................................2-199
Table 2-198 Description of the input parameters of: MODI PPS CARDINFO ............................................2-201
Table 2-199 Description of the output parameters of: MODI PPS CARDINFO ..........................................2-209
Table 2-200 Description of the input parameters of: CHNG PPS CARDPSWD..........................................2-210
Table 2-201 Description of the output parameters of: CHNG PPS CARDPSWD ........................................2-211
Table 2-202 Description of the input parameters of: BIND PPS CARD......................................................2-212
Table 2-203 Description of the output parameters of: BIND PPS CARD....................................................2-212
Table 2-204 Description of the input parameters of: UNBIND PPS CARD ................................................2-213
Table 2-205 Description of the output parameters of: UNBIND PPS CARD ..............................................2-214
Table 2-206 Description of the input parameters of: MODI PPS BNDPSWD .............................................2-215
Table 2-207 Description of the output parameters of: MODI PPS BNDPSWD ...........................................2-216
Table 2-208 Description of the input parameters of: LIST PPS CALLBND................................................2-216
Table 2-209 Description of the output parameters of: LIST PPS CALLBND ..............................................2-217
Table 2-210 Description of the input parameters of: ADD PPS CARDCALLINGSCREEN........................2-218
Table 2-211 Description of the output parameters of: ADD PPS CARDCALLINGSCREEN ......................2-219
Table 2-212 Description of the input parameters of: LIST PPS CARDCALLINGSCREEN ........................2-220
Table 2-213 Description of the output parameters of: LIST PPS CARDCALLINGSCREEN ......................2-220
Table 2-214 Description of the input parameters of: DELE PPS CARDCALLINGSCREEN ......................2-221
Table 2-215 Description of the output parameters of: DELE PPS CARDCALLINGSCREEN ....................2-222
Table 2-216 Description of the input parameters of: ADD PPS CARDCALLEDSCREEN..........................2-223
Table 2-217 Description of the output parameters of: ADD PPS CARDCALLEDSCREEN........................2-224
Table 2-218 Description of the input parameters of: LIST PPS CARDCALLEDSCREEN..........................2-225
Table 2-219 Description of the output parameters of: LIST PPS CARDCALLEDSCREEN........................2-225
Table 2-220 Description of the input parameters of: DELE PPS CARDCALLEDSCREEN........................2-226
Table 2-221 Description of the output parameters of: DELE PPS CARDCALLEDSCREEN ......................2-227
Table 2-222 Description of the input parameters of: ADD PPS ABBRDIAL ..............................................2-228
Table 2-223 Description of the output parameters of: ADD PPS ABBRDIAL.............................................2-228
Table 2-224 Description of the input parameters of: MODI PPS ABBRDIAL ............................................2-229
Issue 01 (2008-01-28)
xv

Tables
Table 2-225 Description of the output parameters of: MODI PPS ABBRDIAL ..........................................2-230
Table 2-226 Description of the input parameters of: LIST PPS ABBRDIAL...............................................2-231
Table 2-227 Description of the output parameters of: LIST PPS ABBRDIAL.............................................2-231
Table 2-228 Description of the output parameters of: DELE PPS ABBRDIAL...........................................2-233
Table 2-229 Description of the input parameters of: DISP PPS CARDFLYNUMBER ................................2-234
Table 2-230 Description of the output parameters of: DISP PPS CARDFLYNUMBER ..............................2-234
Table 2-231 Description of the input parameters of: DISP PPS CARDPIN .................................................2-235
Table 2-232 Description of the output parameters of: DISP PPS CARDPIN ...............................................2-235
Table 2-233 Description of the input parameters of: DEDU PPS CARD.....................................................2-236
Table 2-234 Description of the output parameters of: DEDU PPS CARD...................................................2-237
Table 2-235 Description of the input parameters of: CARDRECHG PPS CARD........................................2-238
Table 2-236 Description of the output parameters of: CARDRECHG PPS CARD......................................2-239
Table 2-237 Description of the input parameters of: LOGGING PPS CARD..............................................2-242
Table 2-238 Description of the output parameters of: LOGGING PPS CARD............................................2-242
Table 2-239 Description of the input parameters of: LIST PPS OLCARD ..................................................2-243
Table 2-240 Description of the output parameters of: LIST PPS OLCARD ................................................2-243
Table 2-241 Description of the input parameters of: SALE PPS OLCARD.................................................2-244
Table 2-242 Description of the output parameters of: SALE PPS OLCARD...............................................2-245
Table 2-243 Description of the input parameters of: LIST PPS RECORDINFO .........................................2-246
Table 2-244 Description of the output parameters of: LIST PPS RECORDINFO........................................2-246
Table 2-245 Description of the input parameters of: RECHG PPS CARD ..................................................2-247
Table 2-246 Description of the output parameters of: RECHG PPS CARD ................................................2-248
Table 2-247 Description of the input parameters of: CORRECT PPS CARDRECHG.................................2-248
Table 2-248 Description of the output parameters of: CORRECT PPS CARDRECHG ...............................2-249
Table 2-249 Description of the input parameters of: LIST PPS RECHGLOG .............................................2-250
Table 2-250 Description of the output parameters of: LIST PPS RECHGLOG ...........................................2-250
Table 2-251 Description of the input parameters of: ADD PPS CARDFLYNUMBER ................................2-252
Table 2-252 Description of the output parameters of: ADD PPS CARDFLYNUMBER ..............................2-252
Table 2-253 Description of the input parameters of: LIST PPS CARDFLYNUMBER ................................2-253
Table 2-254 Description of the output parameters of: LIST PPS CARDFLYNUMBER ..............................2-253
Table 2-255 Description of the input parameters of: DELE PPS CARDFLYNUMBER ..............................2-254
Table 2-256 Description of the output parameters of: DELE PPS CARDFLYNUMBER.............................2-254
Table 2-257 Description of the input parameters of: ASSOCIATE PPS USER............................................2-255
xvi
Issue 01 (2008-01-28)

Tables
Table 2-258 Description of the output parameters of: ASSOCIATE PPS USER..........................................2-256
Table 2-259 Description of the input parameters of: CANCEL PPS USER.................................................2-257
Table 2-260 Description of the output parameters of: CANCEL PPS USER ...............................................2-257
Table 2-261 Description of the input parameters of: ADD PPS ABBRACCO.............................................2-257
Table 2-262 Description of the output parameters of: ADD PPS ABBRACCO...........................................2-258
Table 2-263 Description of the input parameters of: LIST PPS ABBRACCO .............................................2-259
Table 2-264 Description of the output parameters of: LIST PPS ABBRACCO ...........................................2-259
Table 2-265 Description of the input parameters of: DELE PPS ABBRACCO ...........................................2-260
Table 2-266 Description of the output parameters of: DELE PPS ABBRACCO .........................................2-261
Table 2-267 Description of the input parameters of: ADD PPS GREENLIST.............................................2-261
Table 2-268 Description of the output parameters of: ADD PPS GREENLIST ...........................................2-262
Table 2-269 Description of the input parameters of: LIST PPS GREENLIST .............................................2-262
Table 2-270 Description of the output parameters of: LIST PPS GREENLIST ...........................................2-263
Table 2-271 Description of the input parameters of: DELE PPS GREENLIST ...........................................2-264
Table 2-272 Description of the output parameters of: DELE PPS GREENLIST .........................................2-264
Table 2-273 Description of the input parameters of: LIST PPS SUBOPRLOG ...........................................2-265
Table 2-274 Description of the output parameters of: LIST PPS SUBOPRLOG .........................................2-265
Table 2-275 Description of the input parameters of: SET PPS CARDBLKLIST.........................................2-266
Table 2-276 Description of the output parameters of: SET PPS CARDBLKLIST.......................................2-267
Table 2-277 Description of the input parameters of: RESET PPS USESTATE ............................................2-268
Table 2-278 Description of the output parameters of: RESET PPS USESTATE ..........................................2-268
Table 2-279 Description of the input parameters of: MODI PPS SRVDATE...............................................2-269
Table 2-280 Description of the output parameters of: MODI PPS SRVDATE.............................................2-269
Table 2-281 Description of the input parameters of: CLR PPS CARDBLKLST .........................................2-270
Table 2-282 Description of the output parameters of: CLR PPS CARDBLKLST .......................................2-270
Table 2-283 Description of the input parameters of: RESET PPS USAGEFEE...........................................2-271
Table 2-284 Description of the output parameters of: RESET PPS USAGEFEE.........................................2-271
Table 2-285 Description of the input parameters of: RESET PPS ACCLEVEL...........................................2-272
Table 2-286 Description of the output parameters of: RESET PPS ACCLEVEL.........................................2-272
Table 2-287 Description of the input parameters of: SET PPS CALLSCREEN...........................................2-273
Table 2-288 Description of the output parameters of: SET PPS CALLSCREEN.........................................2-274
Table 2-289 Description of the input parameters of: LIST PPS CARDRELA .............................................2-274
Table 2-290 Description of the output parameters of: LIST PPS CARDRELA ...........................................2-275
Issue 01 (2008-01-28)
xvii

Tables
Table 2-291 Description of the input parameters of: DISP PPS CARDMODISTATE..................................2-276
Table 2-292 Description of the output parameters of: DISP PPS CARDMODISTATE ................................2-276
Table 2-293 Description of the input parameters of: LIST PPS SRVCDRS.................................................2-278
Table 2-294 Description of the output parameters of: LIST PPS SRVCDRS...............................................2-278
Table 2-295 Description of the input parameters of: LIST PPS OPRCDRS ................................................2-279
Table 2-296 Description of the output parameters of: LIST PPS OPRCDRS ..............................................2-280
Table 2-297 Description of the input parameters of: LIST PPS CDRS........................................................2-281
Table 2-298 Description of the output parameters of: LIST PPS CDRS......................................................2-282
Table 2-299 Description of the input parameters of: LIST PPS STATISTICBILL .......................................2-284
Table 2-300 Description of the output parameters of: LIST PPS STATISTICBILL .....................................2-284
Table 2-301 Description of the input parameters of: ADD PPS USERTEMP ..............................................2-286
Table 2-302 Description of the output parameters of: ADD PPS USERTEMP ............................................2-291
Table 2-303 Description of the input parameters of: MODI PPS USERTEMP ............................................2-293
Table 2-304 Description of the output parameters of: MODI PPS USERTEMP ..........................................2-298
Table 2-305 Description of the input parameters of: LIST PPS USERTEMP ..............................................2-298
Table 2-306 Description of the output parameters of: LIST PPS USERTEMP ............................................2-299
Table 2-307 Description of the input parameters of: DELE PPS USERTEMP ............................................2-300
Table 2-308 Description of the output parameters of: DELE PPS USERTEMP ..........................................2-300
Table 2-309 Description of the input parameters of: LIST PPS BLACKLIST.............................................2-301
Table 2-310 Description of the output parameters of: LIST PPS BLACKLIST...........................................2-301
Table 2-311 Description of the input parameters of: LIST PPS BALMODLOG..........................................2-302
Table 2-312 Description of the output parameters of: LIST PPS BALMODLOG........................................2-303
Table 2-313 Description of the input parameters of: LIST PPS BONUSLOG .............................................2-304
Table 2-314 Description of the output parameters of: LIST PPS BONUSLOG ...........................................2-304
Table 2-315 Description of the input parameters of: LIST PPS SELLBONLOG.........................................2-305
Table 2-316 Description of the output parameters of: LIST PPS SELLBONLOG.......................................2-306
Table 2-317 Description of the input parameters of: LIST PPS FEEDEDU ................................................2-307
Table 2-318 Description of the output parameters of: LIST PPS FEEDEDU ..............................................2-307
Table 2-319 Description of the input parameters of: LIST PPS CREDETAIL.............................................2-308
Table 2-320 Description of the output parameters of: LIST PPS CREDETAIL ...........................................2-309
Table 2-321 Description of the input parameters of: LIST PPS BATCHLOG .............................................2-310
Table 2-322 Description of the output parameters of: LIST PPS BATCHLOG............................................2-310
Table 2-323 Description of the input parameters of: LIST PPS OPERATE .................................................2-311
xviii
Issue 01 (2008-01-28)

Tables
Table 2-324 Description of the output parameters of: LIST PPS OPERATE ...............................................2-312
Table 2-325 Description of the input parameters of: LIST PPS CHARGEMODE .......................................2-313
Table 2-326 Description of the output parameters of: LIST PPS CHARGEMODE .....................................2-313
Table 2-327 Description of the input parameters of: LIST PPS ACTI .........................................................2-314
Table 2-328 Description of the output parameters of: LIST PPS ACTI .......................................................2-314
Table 2-329 Description of the input parameters of: LIST PPS CTI............................................................2-315
Table 2-330 Description of the output parameters of: LIST PPS CTI..........................................................2-316
Table 2-331 Description of the input parameters of: LIST PPS NORMALDISCOUNT ..............................2-317
Table 2-332 Description of the output parameters of: LIST PPS NORMALDISCOUNT ............................2-317
Table 2-333 Description of the input parameters of: LIST PPS WEEKDISCOUNT....................................2-318
Table 2-334 Description of the output parameters of: LIST PPS WEEKDISCOUNT..................................2-318
Table 2-335 Description of the input parameters of: LIST PPS HOLIDAYDISCOUNT..............................2-319
Table 2-336 Description of the output parameters of: LIST PPS HOLIDAYDISCOUNT............................2-320
Table 2-337 Description of the input parameters of: LIST PPS ICM...........................................................2-321
Table 2-338 Description of the output parameters of: LIST PPS ICM.........................................................2-321
Table 2-339 Description of the input parameters of: LIST PPS NCM .........................................................2-322
Table 2-340 Description of the output parameters of: LIST PPS NCM .......................................................2-322
Table 2-341 Description of the input parameters of: LIST PPS LGCM.......................................................2-323
Table 2-342 Description of the output parameters of: LIST PPS LGCM.....................................................2-324
Table 2-343 Description of the input parameters of :LIST PPS CHGINDEX..............................................2-325
Table 2-344 Description of the output parameters of :LIST PPS CHGINDEX ............................................2-325
Table 2-345 Description of the input parameters of :LIST PPS CHGMSR..................................................2-326
Table 2-346 Description of the output parameters of :LIST PPS CHGMSR................................................2-326
Table 2-347 Description of the output parameters of: LIST PPS CURRENCYTYPE..................................2-328
Table 2-348 Description of the output parameters of: LIST PPS VOICEINFO ...........................................2-329
Table 2-349 Description of the output parameters of: LIST PPS LANGUAGETYPE .................................2-330
Table 2-350 Description of the input parameters of: LIST PPS CHARGERULE ........................................2-331
Table 2-351 Description of the output parameters of: LIST PPS CHARGERULE ......................................2-331
Table 2-352 Description of the output parameters of: LIST PPS ACSCODE ..............................................2-332
Table 2-353 Description of the input parameters of: LIST PPS VOICETREE.............................................2-333
Table 2-354 Description of the output parameters of: LIST PPS VOICETREE...........................................2-334
Table 2-355 Description of the output parameters of: LIST PPS CARDTYPE............................................2-335
Table 2-356 Description of the input parameters of: LIST PPS SDPNO .....................................................2-336
Issue 01 (2008-01-28)
xix

Tables
Table 2-357 Description of the output parameters of: LIST PPS SDPNO ...................................................2-336
Table 2-358 Description of the output parameters of: LIST PPS FILEFORMAT ........................................2-337
Table 2-359 Description of the input parameters of: LIST PPS BONUSTMP .............................................2-338
Table 2-360 Description of the output parameters of: LIST PPS BONUSTMP ...........................................2-338
Table 2-361 Description of the input parameters of: LIST PPS CARDFLGINFO .......................................2-339
Table 2-362 Description of the output parameters of: LIST PPS CARDFLGINFO .....................................2-340
Table 2-363 Description of the input parameters of: DISP PPS VERSION .................................................2-341
Table 2-364 Description of the output parameters of: DISP PPS VERSION ...............................................2-341
Table 2-365 Description of the output parameters of: DISP PPS CONFIG..................................................2-342
Table 2-366 Description of the input parameters of: LIST PPS TIMESEG .................................................2-343
Table 2-367 Description of the output parameters of: LIST PPS TIMESEG ...............................................2-343
Table 2-368 Description of the input parameters of: QRY PPS GOVTAXLOG ..........................................2-344
Table 2-369 Description of the output parameters of: QRY PPS GOVTAXLOG.........................................2-345
Table 2-370 Description of the input parameters of: QRY PPS PASSWDMODLOG ..................................2-346
Table 2-371 Description of the output parameters of: QRY PPS PASSWDMODLOG ................................2-347
xx
Issue 01 (2008-01-28)

1 Introduction to PPS-BMML System
Introduction to PPS-BMML System
About This Chapter

The following table lists the contents of this chapter.
Section
Describes
1.1 System Overview
This section describes the overview of the system.
1.2 Advantages of BMML
This section describes the advantages of BMML system
1.3 System Structure
This section describes the software architecture and the

process.
1.4 Typical BMML Command

Flows
This section describes the BMML command flow.
Issue 01 (2008-01-28)
1-1

1.1 System Overview

The Service Management Point (SMP) provides an open interface protocol, which is
composed of standardized Man-Machine Language (MML) commands. The SMP open
interface interacts with the Service Management Agent Point (SMAP) through the Socket
connection, using the MML as the uniform interface standard.
Any third party who follows the interface protocol can develop and operate the software at the
SMP side using MML commands. Users can send MML commands to the background
through the foreground program to store required data and perform service operations.
The MML commands in this manual are applied in the PPS service.
1.2 Advantages of BMML

1.2.1 Data Types Supported
Data types refer to basic data types used in Intelligent Network (IN) programs, such as integer
and character type. The MML can only process data of the types supported.
MML supports not only basic data types, but also Java data types. It has a strong processing
capability.
1.2.2 Service Logic Processing Capability

Service logic processing capability means that MML programs own the service logic function.
From the inside, service logic reflects the relationships among multiple relevant execution
statements and indicates whether MML can provide service functions. From the outside, it
shows that the MML provides service functions.
MML has a strong capability of processing complex service logic.
1.2.3 Transaction Processing Capability

During the execution of SQL, MML supports the concept of transaction. In the IN system,
transactions include the transactions in the database and distributive transactions (such as
SMP/SCP). In a transaction, the execution result of all the SQLs in the database can only be
successful or failed.
In addition, MML has a strong capability of processing transactions.
1.
Data Capacity
Data capacity indicates that programs support batch operations, for example, querying
bills, querying a batch of card records and querying card numbers according to the card
states.
The MML has the data capacity feature. It supports data return in packages and batch
operations, such as querying bills.
2.
1-2
File Operation
Issue 01 (2008-01-28)

File operations refer to operations on network or local files and directories, including
creating, deleting, reading and writing, and modifying files. In addition, the operations of
input and output streams are included, such as redirection and pipe operation.
MML supports file operation.
3.
Service data function

The program can add, delete, modify, and synchronize service data.
The MML can refresh the memory and bear the function of service data processing.
4.
Concurrent processing capability

Concurrent processing capability refers to number of commands which can be processed
concurrently.
MML can process over 70 commands per second.
5.
Adaptability
When the internal parameters of a program are changed, it has no influence on the
invocation interface for development of the third party.
MML is adaptable and expandable. If optional parameters and the content of the ATTR
parameter of the MML interface are changed, it has no influence on the invocation
interface for development of the third party.
1.3 System Structure

This section introduces contents involved in communication between the WebSMAP server
and SMP through MML.
1.3.1 Software Architecture

Figure 1-1 Software Architecture
SMP
SMP
SCPAGT
SCPAGT
SCP
SYSM
Browser
WEB SMAP
Server
CAA
CAA
SRVM
PPS
DBAGT
DBAGT
SECU
SECU
DB
DB
VOT
MML
other
communication
protocols
CMC
CMC
CAA: Client Access Agent

SRVM: Service Manager
Issue 01 (2008-01-28)
LCA
LCA
SMP: Service Management Point

SECU: Security Manager
1-3


PPS: Prepaid Card Service
SYSM: System Manager
CMC: Call Management Center
MML: Man-Machine Language
DB: Database
SCPAGT: Service Control Point Agent

DBAGT: Database Agent
LCA: Local Configuration Administrator
SCP: Service Control Point
The DBAGT mentioned in the manual refers to the SMS-Common Server
1.3.2 Process Introduction

1.
Client access agent (CAA)

The CAA provides a service interface for the client, accessing and authenticating
different functional entities and processing messages beforehand. Different CAAs can be
started for accessing different entities. SMP can access such entities as SMAP and
WebSMAP.
2.
Service center process SRVM

SRVM is the core of the entire system. It processes different transactions accessed by
CAAs and transits communication among different processes in the system.
System service process, including SECU, DBAGT and SYSM, providing basic functions
for other processes.
3.
Call management center (CMC)

The CMC provides the feature of relative transparent locations. If process A wants to use
the service of process B, A only needs to know the service name of B. The address
information can be obtained from the CMC.
4.
Local configuration agent (LCA)

The LCA reads the configuration file sms.cfg, and starts and manages each process
according to the configured process information, ensuring that each process can start
immediately after abnormal exit.
5.
Database agent (DBAGT)

The database agent enables the entire MML to access the database and provides the
flexible database configuration capability on two layers. The database and DBAGT can
be configured on different machines in the network mode, and the DBAGT can also be
configured on another machine according to system requirements. DBAGT provides
basic functions of adding, deleting and modifying database tables and functions of
performing transaction and storage processes.
The database process should be executed from the sms_common_serv file and not from sms_db_agent.
6.
SCP agent process SCPAGT is the processing process of communication between SMP
and SCP/SDP. It sends required messages to the SCP/SDP for interaction and receives
the messages returned from the SCP/SDP.
7.
Security agent (SECU)

The SECU encapsulates authentication-related operations into a process for operator
management and security agent. Authentication data are read from the database and
saved in the memory.
1-4
Issue 01 (2008-01-28)

1.4 Typical BMML Command Flows

An MML command is sent from the client, and then transmitted to the SRVM through the
CAA. The SRVM processes the message in the following operations.
Operation authentication.
Judging the service name in the message.
Transmitting the message to the corresponding service according to the service name.
Take the PPS service as an example. After receiving a message, the PPS service sends the
message to DBAGT, SYSM and SECU, and then sends back the message to SRVM. After that,
the SRVM returns the message to the CAA and client.
1.4.1 Installation of BMML

For information on installation of BMML, please refer IIS PSV500R002C01B020_Installation
Guide .doc
Issue 01 (2008-01-28)
1-5

2 Description of PPS-BMML Commands
Description of PPS-BMML Commands
About This Chapter

The following table lists the contents of this chapter.
Section
Describes
2.1 General Information
This section describes the general errors, common

parameters, coding scheme and the execution of BMML
command.
2.2 Categorization of BMML

Commands
This section provides the list of commands applicable for

this service
2.3 Service Management
This section provides the command and its information.
2.4 Service Provider
2.5 Product Management
2.6 Batch Management
2.7 Single Card Management

Settings
2.8 CDRs
ManagementSettings
2.9 User Template

Management
2.10 Charging Matrix

Management
2.11 Additional Management
Issue 01 (2008-01-28)
2-1

2.1 General Information

The commands given in this section are for PPS service.
General Errors
Description of the general errors in the MML commands is shown in Table 2-1. The following
specific error information for the RETN parameter output by the MML commands is not
included in description of common errors.
Table 2-1 Description of the general errors in the MML commands
2-2
Parameter Value
Description
0000
Success
0004
Syntax error or invalid command code.
0007
System internal error.
0008
Input command parameter error.
0011
Operation timeout.
0012
Data access authorization failed.
0014
Database operation on SMP failed.
0014
Database operation on SCP failed.
0042
Executing distributed transaction failed.
1000
The service name does not exist.
1001
The User Identifier does not exist.
1002
The SDU number does not exist.
1003
The service key does not exist.
1011
The service provider does not exist.
1012
The product does not exist.
1013
The end date cannot be earlier than the start date.
1014
The batch does not exist.
1015
The card is in use.
1016
The card number does not exist.
1017
The binding flag is disabled.
1018
The batch has already been locked.
Issue 01 (2008-01-28)

Parameter Value
Description
1019
The end date time cannot be earlier than the start date time.
1020
The batch parameter has not been set.
1021
The service public parameter does not exist.
1022
The service provider parameter does not exist.
1023
The product parameter does not exist.
1024
The system node information does not exist.
1025
The service provider features does not exist.
1026
The service calling screen type is not configured.
1027
The service provider calling screen type is not configured.
1028
The product calling screen type is not configured.
1029
The batch calling screen type is not configured.
1030
The card calling screen type is not configured.
1031
The service called screen type is not configured.
1032
The service provider called screen type is not configured.
1033
The product called screen type is not configured.
1034
The batch called screen type is not configured.
1035
The card called screen type is not configured.
1036
No calling screen information was deleted.
1037
No called screen information was deleted.
1038
The screen number has already existed.
1039
The area does not exist.
1040
The service has not been loaded.
1041
The service provider parameter which is related to the

charge does not exist.
1042
The service parameter XX has not been set.
1043
The currency type does not exist.
1044
The service configuration parameter does not exist.
1045
The parameter SIMCALLFLAG is disabled when the

product is prepaid.
1046
The service provider license parameter is not set.
1047
The caller binding feature license amount of the service is

not set.
Issue 01 (2008-01-28)
2-3

Parameter Value
Description
1048
The familiarity number feature license amount of the service

is not set.
1049
The accumulated usage bonus feature license amount of the

service is not set.
1050
The abbreviation account feature license amount of the

service is not set.
1051
The postpaid feature license amount of the service is not set.
Common Parameters
Table 2-2 Description of the common parameters for the MML commands
2-4
Parameter
name
Parameter
description
Value range
Output value description
RETN
Indicates the
success or failure
execution after
an MML
command is
returned.
A numerical
string of 1 to 5
digits.
The return value 0 indicates

that the operation is
successful.
Other values are codes of
error information. For
details, refer to Table 2-1.
DESC
Description of
the return result
A character
string of 0-256.
The parameter can be used as

the output on the interface of
a client.
For example, a result of
success is returned in case of
successful query.
ATTR
Indicates the set

of attributes
returned after
running the
query command.
It includes the
database fields
that have been
queried as per
condition.
A character
string of 0-256.
The fields are separated by

ampersands (&).
RESULT
Contains the
values of the
fields selected
from the
database as per
query condition.
A character
string of 0-256.
The records are separated by

ampersand (&) and the fields
in each record are separated
by a pipe |.
TOTAL
Total number of
records in the
An integer in
the range 0 to
None
Issue 01 (2008-01-28)

Parameter
name
Parameter
description
Value range
Output value description
query result.
2147483647.
START
Serial number of
the first record in
the current batch.
An integer in
the range 0 to
2147483647.
None
NUMOF
Total number of
records returned
for the current
batch.
An integer in
the range 0 to
200.
None
FINISHED
It is a flag that
indicates if the
last record is
returned.
0: No
1: Yes
None
The output of an MML Command is returned by batches, with 200 records at most in a batch.
Coding Scheme of the System Errors

0-999: general system error code
1000-1099: customized error code
Executing an MML Command

To execute an MML command, the user must have corresponding operation authority. For
example, PRM subscriber can only execute the MML commands corresponding to the PRM
service respectively.
1.
Descriptions involved in this manual are based on the assumption that you have the
authority to do the corresponding operation:
Parameters in the brackets [] are optional.
Parameters without the brackets [] are compulsory.
The MML commands should not contain these character & # |! " \ ' , %
2.
The encryption of the passwords in subscriber service commands should be performed at

the client side if the ENCRPTFLG in the public service parameter is enabled and they
will not be encrypted by the MML Commands. This is applicable only if the passwords
are provided in the subscriber service commands
3.
The debug mode for MML processes can be turned off by setting the DEBUG_ON
parameter to 0 in the /sms_run/shell/env.rc file in the home directory.
The load and unload route data can be executed only when the SSN is in loaded state. Similarly unload
SSN command can be executed only when the route for that SSN is in unloaded state.
Issue 01 (2008-01-28)
2-5

2.2 Categorization of BMML Commands

The table below has the list of all MML Commands.
Table 2-3 List of commands
MML Function
MML Commands
Service Management
Adding Access Code Surcharge Settings

Querying Access Code Surcharge Settings
Deleting Access Code Surcharge Settings
Adding Language Selection Settings
Querying Language Selection Settings
Deleting Language Selection Settings
Adding Service Calling Blacklist Settings
Querying Service Calling Blacklist Settings
Deleting Service Calling Blacklist Settings
Adding Destination Black List Number Settings
Querying Destination Black List Number Settings
Deleting Destination Black List Number Settings
Adding Calling Numbers without IVA
Querying Calling Numbers without IVA
Deleting Calling Numbers without IVA
Adding Access Code Settings
Modifying Access Code Settings
Querying Access Code Settings
Deleting Access Code Settings
Querying Service Information Settings
Querying Service Configuration Information
Service Provider
Listing SPs
Counting the Total Number of SPs
Querying Relevant Information of an SP
Querying Relevant Parameter Information of an SP
Querying Relevant Charge Information of an SP
Querying Relevant Information of SP Access Codes
2-6
Issue 01 (2008-01-28)

MML Function
MML Commands
Querying Relevant Information of SP Features
Querying Information in the Usage Bonus Log Table
Querying the Usage Bonus Information Table
Adding Called Screen Based on Calling Numbers
Querying Called Screen Based on Calling Numbers
Deleting Called Screen Based on Calling Numbers
Adding Information in the Recharge Prolongation Table
Modifying Information in the Recharge Prolongation Table
Querying Information in the Recharge Prolongation Table
Deleting Information in the Recharge Prolongation Table
Adding Information to the Recharge Bonus Table
Modifying Information in the Recharge Bonus Table
Querying Information from the Recharge Bonus Table
Deleting Information in the Recharge Bonus Table
Querying Serve Level Settings
Querying Time Slot Settings
Querying Customer Ser. Center Number Settings
Querying Day Category Settings
Querying Virtual Calling Number Settings
Querying Holiday Category Settings
Querying Abbreviated Account Screen Numbers
Querying Statistics Called/Callee Number Settings
Querying Route Information
Product Management
Listing Products
Counting the Total Number of Products
Querying Relevant Information of Products
Querying the Access Codes Distributed to Products
Modifying Product Parameters
Querying Product Charge Package
Querying the Product Level Parameters Table
Querying Product Level Calling Category Number Screen
Issue 01 (2008-01-28)
2-7

MML Function
MML Commands
Querying Access Code and Nested Call Methods Distributed at
Product Level
Querying Callee and Time Based Message Setting
Querying the Product Level Familiarity Number Configuration
Querying the Product Level Caller and Time based Message
Settings
Batch Management
Listing Batches
Counting Batches
Querying Batch
Querying Batch Discount
Querying the Batch Level Parameters Table
Creating a Batch of Cards
Activating a Batch of Cards
Deactivating a Batch of Cards
Modifying a Batch of Cards
Deleting a Batch of Cards
Adding the Caller Binding Category Screen Information
Querying the Caller Binding Category Screen Information
Deleting the Caller Binding Category Screen Information
Adding Batch Abbreviated Numbers
Modifying Batch Abbreviated Numbers
Querying Batch Abbreviated Numbers
Deleting Batch Abbreviated Numbers
Querying the Batch Level Binding Calling Number Screen
Settings
Querying the Batch Level Time Based Message Settings
Adding Calling Category Screen at Batch Level
Querying Calling Category Screen at Batch Level
Deleting Calling Category Screen at Batch Level
Adding Green Numbers at Batch Level
Deleting Green Numbers at Batch Level
Querying Green Numbers at Batch Level
2-8
Issue 01 (2008-01-28)

MML Function
MML Commands
Cancelling Batch Operations of Cards
Querying the Reason for Deleting Cards in Batches
Loading Cards in Batches
Unloading Cards in Batches
Importing Cards in Batches
Querying Statuses of Batch Level Parameters
Adding Batch Level Parameters
Modifying Batch Level Parameters
Deleting Batch Level Parameters
Single Card
Management Settings
Listing Single Cards in a Batch

Counting Single Cards in a Batch
Querying the Information About a Card
Modifying the Information of a Single Card
Changing the Password of a Card
Binding a Calling Number
Unbinding a Calling Number
Changing the Card-Binding Password
Querying the Binding Status of a Calling Number(or a Card
Number)
Adding the Calling Screen Information
Querying the Calling Screen Information
Deleting the Calling Screen Information
Adding the Called Screen Information
Querying the Called Screen Information
Deleting the Called Screen Information
Adding the Abbreviated Number
Modifying the Abbreviated Number
Querying the Abbreviated Number
Deleting the Abbreviated Number
Recharging by a Card
Verifying the Card Validity
Issue 01 (2008-01-28)
2-9

MML Function
MML Commands
Querying the Information of Online-Sale Cards
Selling Cards Online
Querying Historical Records
Querying Single User Logs
Setting Blacklists
Resetting Single Cards
Modifying Validity Dates of Single Cards
Clearing Single Card Blacklists
Resetting Accumulated Call Cost of Single Cards
Resetting Usage Points Level of Single Cards
Setting Call Type Screen for Single Cards
Querying Main-Child Cards
Querying Modifiable State of the Single Card Maintenance
Interface
CDRs
ManagementSettings
Querying Service Bills

Querying Operation Bills
Querying Bills
Querying Statistical Bill Information
User Template
Management
Adding User Template

Modifying User Template
Querying User Template
Deleting User Template
Querying Blacklists in Batches
Querying Balance Modification Logs
Querying Bonus Logs
Querying Sales Bonus Logs
Querying BMML Deduction Logs
Querying Card Creation Information
Querying Batch Operation Logs
Querying Operation Types of Logs
Charging Matrix
2-10
Querying the Charging Mode
Issue 01 (2008-01-28)

MML Function
MML Commands
Management
Querying the Adjusted Charging Class Index

Querying the Charging Class Index
Querying the Daily Charge Rate Modulator
Querying the Weekly Charge Rate Modulator
Querying the Holiday Charge Rate Modulator
Querying the International Charging Matrix
Querying the National Charging Matrix
Querying the Local Group Charging Matrix
Additional
Management
Querying Currency Types

Querying Voice Information
Querying Language Types
Querying Charge Rules
Querying All Access Codes
Querying the Voice Menu Tree
Querying Card Types
Querying the SDP in Service Area
Querying the Batch File Format
Querying the Bonus Template
Querying the Function Status During Batch Import
Querying the Service Version
Querying the Service Configuration Information
Querying Time Segments
Query Government Tax Logs
Query Password Modification Log
Issue 01 (2008-01-28)
2-11

2.3 Service Management

2.3.1 Adding Access Code Surcharge Settings
Command Name
ADD PPS ACCSUR
Command Function
This command is used to add surcharge details for an access code.
Input Parameters
ADD PPS ACCSUR: ACCESSCODE=, CURRENCYTYPE=, SURCHARGE=,
[USERIDENTIFIER=,]
Table 2-4 Description of the input parameters of: ADD PPS ACCSUR
Parameter
Description
Value Range
ACCESSCODE
It is the access code

of PPS service.
[Value Range]
A numerical string of 1 to 24 digits.
CURRENCYTYPE
It is the currency ID.
[Value Range]
An integer in [0, 15].
SURCHARGE
It is the surcharge
for an access code.
[Value Range]
An integer in [0, 32767].
USERIDENTIFIER
It is the identifier of
the user.
[Value Range]
An integer from [1-28] digits including
-1.
The default value is -1.
Output Parameters
ACK: ADD PPS ACCSUR: RETN =, DESC =
Table 2-5 Description of the output parameters of: ADD PPS ACCSUR
Parameter
RETN
Description
It is the return value of the command, a numerical string of 1-5 digits.
9121: Access Code does not exist.
2251: Currency type already exists for the given Access Code.
1043: The currency type does not exist.
For details, refer to Table 2-2 and Table 2-1

DESC
2-12
If the operation is successful, then it contains description of successful

operation.
Issue 01 (2008-01-28)

Parameter
Description
If the operation fails, then it contains error cause description.
It is a string of 0 to 256 characters.
Example
ADD PPS ACCSUR: ACCESSCODE=200, CURRENCYTYPE=1, SURCHARGE=500,
USERIDENTIFIER=-1
2.3.2 Querying Access Code Surcharge Settings

Command Name
LIST PPS ACCSUR
Command Function
This command is used to query detailed surcharge information of a specific access code.
Input Parameters
LIST PPS ACCSUR: ACCESSCODE= [,USERIDENTIFIER=]
Table 2-6 Description of the input parameters of: LIST PPS ACCSUR
Parameter
Description
Value Range
ACCESSCODE

of PPS service.
[Value Range]
USERIDENTIFIER
the user.
[Value Range]
-1.
Output Parameters
ACK: LIST PPS ACCSUR: RETN=, DESC=[, TOTAL=, SN=, NUMOF=, FINISHED=,
ATTR=, RESULT=]
Table 2-7 Description of the output parameters of: LIST PPS ACCSUR
Parameter
Description
RETN
It is the return value of the command, a numerical string of 1-5

digits.
9121: Access Code does not Exist.
For details, refer to Table 2-2 and Table 2-1.
Issue 01 (2008-01-28)
2-13

Parameter
Description
DESC
If the operation is successful, then it contains description of

successful operation.
ATTR
It is the list of attribute names separated from each other by &.

The ATTR has the following value:
accessCode& currencyName& surcharge& userIdentifier
RESULT
It is the query result. The values are separated by | and are in the
same order as in ATTR list. The records are separated by &.
TOTAL
It is the total number of queried records. It is a non-negative

integer.
FINISHED
It is a flag that indicates the last record returned.

0: No
1: Yes
SN
It is the serial number of the first record of the current batch. It is a

non-negative integer.
NUMOF
It is the number of records returned in the current batch.
Example
LIST PPS ACCSUR: ACCESSCODE=200
2.3.3 Deleting Access Code Surcharge Settings

Command Name
DELE PPS ACCSUR
Command Function
This command is used to delete surcharge details for each currency for a given access code.
Input Parameters
DELE PPS ACCSUR: ACCESSCODE=, CURRENCYTYPE= [,USERIDENTIFIER=]
Table 2-8 Description of the input parameters of: DELE PPS ACCSUR
2-14
Parameter
Description
Value Range
ACCESSCODE
It is the access code of PPS

service.
[Value Range]
A numeric string of 1 to 24
digits.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
CURRENCYTYPE
It is the currency ID.
[Value Range]
String of length 0 to 256.
Multiple deletions are possible
by separating currency id by &
USERIDENTIFIER
It is the identifier of the

user.
[Value Range]
An integer from [1-28] digits
including -1.
Output Parameters
ACK: DELE PPS ACCSUR: RETN =, DESC = , [ATTR=], [RESULT=]
Table 2-9 Description of the output parameters of: DELE PPS ACCSUR
Parameter
Description
RETN

DESC

operation.
ATTR
It is the list of attribute names separated from each other by &. The
ATTR has the following value:
total& successNum&failNum
RESULT
It is the query result. The values are separated by | and are in the same
order as in ATTR list. The records are separated by &.
Example
DELE PPS ACCSUR: ACCESSCODE=200, CURRENCYTYPE=1
Or
DELE PPS ACCSUR: ACCESSCODE=200, CURRENCYTYPE=1&2
2.3.4 Adding Language Selection Settings

Command Name
ADD PPS LANGSELECT
Issue 01 (2008-01-28)
2-15

Command Function
This command is used to map the language selected by the user to the language at the access
code level.
Input Parameters
ADD PPS LANGSELECT: ACCESSCODE=, USERCHOOSE=, ACTUALCHOOSE=;
Table 2-10 Description of the input parameters of: ADD PPS LANGSELECT
Parameter
Description
Value Range
ACCESSCODE

service.
[Value Range]
A numerical string of 1 to 24
digits.
USERCHOOSE
It is the number dialed by the

user to select announcement
language type.
[Value Range]
It is the language in which the

system plays announcement
[Value Range]
An integer equal to or greater
than 1.
ACTUALCHOOSE
It is in the range1 to Max.

Language Number set in the
Access Code Settings
(Service level) window.Max
Language Number can be
[1-9].
Output Parameters
ACK: ADD PPS LANGSELECT: RETN =, DESC =
Table 2-11 Description of the output parameters of: ADD PPS LANGSELECT
Parameter
Description
RETN

2281: Multiple language selection is not configured for given

accesscode.
2322: Userchoose already exists for given accesscode.
2321: Userchoose should not be more than max languages select

setting at accesscode level.
9121: The access code does not exist.
2323: Actual choose does not exist.

DESC
2-16

Issue 01 (2008-01-28)

Example
ADD PPS LANGSELECT: ACCESSCODE=122, USERCHOOSE=1,
ACTUALCHOOSE=2;
2.3.5 Querying Language Selection Settings

Command Name
LIST PPS LANGSELECT
Command Function
This command is used to query language select settings details at access code level.
Input Parameters
LIST PPS LANGSELECT: ACCESSCODE=
Table 2-12 Description of the input parameters of: LIST PPS LANGSELECT
Parameter
Description
Value Range
ACCESSCODE

of PPS service.
[Value Range]
Output Parameters
ACK: LIST PPS LANGSELECT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
NUMOF =, ATTR =, RESULT =]
Table 2-13 Description of the output parameters of: LIST PPS LANGSELECT
Parameter
Description
RETN

digits.
2281: Multiple language selection is not configured for given

accesscode.
9121: The access code does not exist.

DESC
ATTR
Issue 01 (2008-01-28)


2-17

Parameter
Description
accessCode&userChoose&actualChoose
RESULT
TOTAL

integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS LANGSELECT: ACCESSCODE=123
2.3.6 Deleting Language Selection Settings

Command Name
DELE PPS LANGSELECT
Command Function
This command is used to delete language select settings details at access code level.
Input Parameters
DELE PPS LANGSELECT: ACCESSCODE=, USERCHOOSE =
Table 2-14 Description of the input parameters of: DELE PPS LANGSELECT
2-18
Parameter
Description
Value Range
ACCESSCODE

service.
[Value Range]
digits.
USERCHOOSE
It is the number dialed by the

user to select announcement
language type.
[Value Range]
It is in the range 1 to Max.

Language Number set in the
Access Code Settings (Service
level) window.Max Language
Number can be [1-9].
Issue 01 (2008-01-28)

Output Parameters
ACK: DELE PPS LANGSELECT: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-15 Description of the output parameters of: DELE PPS LANGSELECT
Parameter
RETN
Description
For details, refer to Table 2-2and Table 2-1.
DESC
ATTR

operation.
It is the list of attribute names separated from each other by &. The ATTR
has the following value:
total& successNum&failNum
RESULT
Example
DELE PPS LANGSELECT: ACCESSCODE=122, USERCHOOSE=1&2&3
Or
DELE PPS LANGSELECT: ACCESSCODE=122, USERCHOOSE=1
2.3.7 Adding Service Calling Blacklist Settings

Command Name
ADD PPS CALLINGBLK
Command Function
This command is used to blacklist calling number.
Input Parameters
ADD PPS CALLINGBLK: CALLINGNUM =, SDUID=
Table 2-16 Description of the input parameters of: ADD PPS CALLINGBLK
Parameter
Description
Value Range
CALLINGNUM
It is the complete
calling number or its
segment
[Value Range]
digits.
Issue 01 (2008-01-28)
2-19

Parameter
Description
Value Range
SDUID
It contains the ID of the

SDU where data is
added.
[Value Range]
An integer in the range 1 to
65535.
Output Parameters
ACK: ADD PPS CALLINGBLK: RETN=, DESC=
Table 2-17 Description of the output parameters of: ADD PPS CALLINGBLK
Parameter
RETN
Description
1021: The service public parameter does not exist.
2331: Calling number blacklist feature is not enabled
2341: Calling Number is already blacklisted.

DESC

operation.
Example
ADD PPS CALLINGBLK: CALLINGNUM =1234, SDUID=101
2.3.8 Querying Service Calling Blacklist Settings

Command Name
QRY PPS CALLINGBLK
Command Function
This command is used to query blacklisted calling number.
Input Parameters
QRY PPS CALLINGBLK: [CALLINGNUM =], SDUID=
Table 2-18 Description of the input parameters of: QRY PPS CALLINGBLK
2-20
Parameter
Description
Value Range
CALLINGNUM
It is the complete calling
[Value Range]
Issue 01 (2008-01-28)

Parameter
SDUID
Description
Value Range
number or its segment

SDU where data is added.
[Value Range]
An integer from [1-65535].
Output Parameters
ACK: QRY PPS CALLINGBLK: RETN=, DESC=[, TOTAL=, SN=, NUMOF=,
FINISHED=, ATTR=, RESULT=]
Table 2-19 Description of the output parameters of: QRY PPS CALLINGBLK
Parameter
RETN
Description
2331: Calling number blacklist feature is not enabled.

DESC
ATTR

callingNumber&fraudTimes&blacklistSource&blacklistTime
RESULT
TOTAL
It is the total number of queried records. It is a non-negative integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Example
QRY PPS CALLINGBLK: CALLINGNUM =1234, SDUID=101
Issue 01 (2008-01-28)
2-21

2.3.9 Deleting Service Calling Blacklist Settings

Command Name
DELE PPS CALLINGBLK
Command Function
This command is used to release blacklisted calling number.
Input Parameters
DELE PPS CALLINGBLK: CALLINGNUM =, SDUID=
Table 2-20 Description of the input parameters of: DELE PPS CALLINGBLK
Parameter
Description
Value Range
CALLINGNUM

number or its segment
[Value Range]
digits.
SDUID

SDU where data is added.
[Value Range]
An integer from [1-65535].
Output Parameters
ACK: DELE PPS CALLINGBLK: RETN=, DESC=[, ATTR=, RESULT=]
Table 2-21 Description of the output parameters of: DELE PPS CALLINGBLK
Parameter
RETN
Description

2331: Calling number blacklist feature is not enabled

DESC
ATTR

operation.
total& successNum& failNum
RESULT
2-22
Issue 01 (2008-01-28)

Example
DELE PPS CALLINGBLK: CALLINGNUM =1234&3456, SDUID=101
Or
DELE PPS CALLINGBLK: CALLINGNUM =1234, SDUID=101
2.3.10 Adding Destination Black List Number Settings

Command Name
ADD PPS DESTBLKLST
Command Function
This command is used to blacklist destination number or its prefix at service level.
Input Parameters
ADD PPS DESTBLKLST: COUNTRYCODE=, AREACODE=,
SCREENNUMBER=[,USERIDENTIFIER=]
Table 2-22 Description of the input parameters of: ADD PPS DESTBLKLST
Parameter
Description
Value Range
COUNTRYCODE
It is the country
code of the calling
number.
[Value Range]
A numerical string in the range -1 to
99999999
AREACODE
It is the area code of

the calling number.
[Value Range]
99999999
SCREENNUMBER
It is the destination
number or prefix to
be screened.
[Value Range]
the user.
[Value Range]
including -1.
USERIDENTIFIER
It is numerical string of 1 to 20 digits.
Output Parameters
ACK: ADD PPS DESTBLKLST: RETN=, DESC=
Table 2-23 Description of the output parameters of: ADD PPS DESTBLKLST
Parameter
Description
RETN
Issue 01 (2008-01-28)
2-23

Parameter
Description
2061: The destination blacklist configuration already exist.
DESC

operation.
Example
ADD PPS DESTBLKLST: COUNTRYCODE=222, AREACODE=333,
SCREENNUMBER=1234, USERIDENTIFIER=-1,
2-24
Issue 01 (2008-01-28)

2.3.11 Querying Destination Black List Number Settings

Command Name
LIST PPS DESTBLKLST
Command Function
This command is used to query destination blacklist number or its prefix at service level.
Input Parameters
LIST PPS DESTBLKLST: [USERIDENTIFIER=]
Table 2-24 Description of the input parameters of: LIST PPS DESTBLKLST
Parameter
Description
Value Range
USERIDENTIFIER
the user.
[Value Range]
including -1.
Output Parameters
ACK: LIST PPS DESTBLKLST: RETN=0, DESC=[, TOTAL=, SN=, NUMOF=,
Table 2-25 Description of the output parameters of: LIST PPS DESTBLKLST
Parameter
Description
RETN

DESC
ATTR

operation.
countryCode& areaCode& screenNumber& userIdentifier
RESULT
TOTAL
FINISHED
Issue 01 (2008-01-28)
2-25

Parameter
Description
0: No
1: Yes
SN

NUMOF
Example
LIST PPS DESTBLKLST: USERIDENTIFIER = 1
2.3.12 Deleting Destination Black List Number Settings

Command Name
DELE PPS DESTBLKLST
Command Function
This command is used to delete blacklisted destination number or its prefix at service level.
Input Parameters
DELE PPS DESTBLKLST: COUNTRYCODE=, AREACODE=, SCREENNUMBER=
[,USERIDENTIFIER=]
Table 2-26 Description of the input parameters of: DELE PPS DESTBLKLST
Parameter
Description
Value Range
COUNTRYCODE
It is the country
code of the calling
number.
[Value Range]
99999999
AREACODE
It is the area code of

the calling number.
[Value Range]
99999999
SCREENNUMBER
number or prefix to
be screened
[Value Range]
the user.
[Value Range]
including -1.
USERIDENTIFIER
2-26
It is numerical string of 1 to 20 digits.
Issue 01 (2008-01-28)

Output Parameters
ACK: DELE PPS DESTBLKLST: RETN=, DESC=[, TOTAL=, SN=, NUMOF=,
Table 2-27 Description of the output parameters of: DELE PPS DESTBLKLST
Parameter
RETN
Description
DESC
ATTR

operation.
RESULT
Example
DELE PPS DESTBLKLST: COUNTRYCODE=22&43, AREACODE=44&76,
SCREENNUMBER=123&333, USERIDENTIFIER=-1
Or
DELE PPS DESTBLKLST: COUNTRYCODE=22, AREACODE=76,
SCREENNUMBER=333, USERIDENTIFIER=-1
2.3.13 Adding Calling Numbers without IVA

Command Name
ADD PPS NOIVACALLLIST
Command Function
This command is used to add calling numbers for which IVA/VAT will not be applied .
Input Parameters
ADD PPS NOIVACALLLIST: [USERIDENTIFIER=,] PSTNNUMBER=,
Issue 01 (2008-01-28)
2-27

Table 2-28 Description of the input parameters of: ADD PPS NOIVACALLLIST
Parameter
Description
Value Range
USERIDENTIFIER
the user.
[Value Range]
including -1.
PSTNNUMBER
It is the calling
number.
[Value Range]
Output Parameters
ACK: ADD PPS NOIVACALLLIST: RETN =, DESC =
Table 2-29 Description of the output parameters of: ADD PPS NOIVACALLLIST
Parameter
Description
RETN

2011: The PSTN number already exists.
DESC

operation.
Example
ADD PPS NOIVACALLLIST: USERIDENTIFIER=-1, PSTNNUMBER= 0755654321
2.3.14 Querying Calling Numbers without IVA

Command Name
LIST PPS NOIVACALLLIST
Command Function
The command is used to list all calling numbers without IVA.
Input Parameters
LIST PPS NOIVACALLLIST: [USERIDENTIFIER=]
2-28
Issue 01 (2008-01-28)

Table 2-30 Description of the input parameters of: LIST PPS NOIVACALLLIST
Parameter
Description
Value Range
USERIDENTIFIER
the user.
[Value Range]
including -1.
Output Parameters
ACK: LIST PPS NOIVACALLLIST: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-31 Description of the output parameters of: LIST PPS NOIVACALLLIST
Parameter
Description
RETN

digits.
DESC
ATTR


userIdentifier&pstnNumber
RESULT
TOTAL

integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS NOIVACALLLIST: USERIDENTIFIER=-1
Issue 01 (2008-01-28)
2-29

2.3.15 Deleting Calling Numbers without IVA

Command Name
DELE PPS NOIVACALLLIST
Command Function
This command is used to delete calling numbers for which IVA/VAT will not be applied.
Input Parameters
DELE PPS NOIVACALLLIST: [USERIDENTIFIER=,] PSTNNUMBER=,
Table 2-32 Description of the input parameters of: DELE PPS NOIVACALLLIST
Parameter
Description
Value Range
USERIDENTIFIER
It is the identifier of the

user.
[Value Range]
-1.
PSTNNUMBER
It is the calling
number.
[Value Range]
Output Parameters
ACK: DELE PPS NOIVACALLLIST: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-33 Description of the output parameters of: DELE PPS NOIVACALLLIST
Parameter
Description
RETN

DESC

operation.
ATTR
RESULT
2-30
Issue 01 (2008-01-28)

Example
DELE PPS NOIVACALLLIST: USERIDENTIFIER=-1, PSTNNUMBER=123456
Or
DELE PPS NOIVACALLLIST: USERIDENTIFIER=-1, PSTNNUMBER=123456&22
2.3.16 Adding Access Code Settings

Command Name
ADD PPS ACCESSCODE
Command Function
This command is used to add access code settings parameters.
Input Parameters
ADD PPS ACCESSCODE:
ACCESSCODE=[,OVSACFLAG=][,VIRTUALCALLINGNUM=][,
ACCESSCODETYPE=][, ACCESSCODECLASS=][, IPCHARGERULE=]
[,IPADJUSTCHGCLASS=][,CHARGERULE=][,ADJUSTCHGCLASS=][,WELCOMEMSG
=][,WELCOMEMSGFORMGT=][,LANGUAGECHOICEFLAG=][,MAXLANGUAGENU
M=][,DEFAULTLANGUAGETYPE=][,MAXPCFAILRETRIES=][,DEFAULRETRY=][,FIR
STDIGITTIMEOUT=][,INTERDIGITTIMEOUT=][,WELCOMEMSGFLAG=][,INCOMIN
GCHGFLAG=][,CHRGEDURATIONFLAG=][,MAXAUTHRETRY=][,NOPASSAUTHFLA
G=][,SCLINGPOS=][,SCLINGLEN=][,AUTHMODE=][,FIXEDLENFLAG=][,CARDNUM
LEN=][,PINLEN=], [MINLOFCARDHAVEPIN=][, MAXLOFCARDHAVEPIN =][,
AFTERPCTIMEOUTFLG=][,NUMFORPCTIMEOUT=][,CHOICEFORSNDLANG=][,SND
LANGTYPE=][,LANGSELMSG=][,CALLINGSCREENTYPE=][,AUTHRETRYEXPIREA
CT=][,AUTHFAILPSTNNUM=][,AUTHTOMSGID=],[,ACCFUNFLG=][,CALLBACKDEL
AY=][,WEBVIRTCALLINGNUM=][USERIDENTIFIER=][ RAUTHMODE=,][ RFIXE
DLENFLAG=,][ RMINLOFCARDHAVEPN= ,][ RMAXLOFCARDHAVEPN= ,][
RCARDNUMLEN=,][ RPINLEN=,][ DEFAREACODE=,]
Issue 01 (2008-01-28)
2-31

Table 2-34 Description of the input parameters of: ADD PPS ACCESSCODE
2-32
Parameter
Description
Value Range
ACCESSCODE
It is the access
code of PPS
service.
[Value Range]
digits.
-1 indicates "United Voucher
Center
OVSACFLAG
It is a flag used to
trigger service
access codes in
countries without
the IN.
[Value Range]
0: access codes of home country
1: access codes of countries
without the IN
VIRTUALCALLINGNUM
It is the number of
a virtual calling
party.
[Value Range]
digits.
ACCESSCODETYPE
It indicates the
type of access
codes.
[Value Range]
0: PSTN and Management
1: IP and Management
2: IP, PSTN and Management
3: Only Management
4: PSTN
5: IP
6: IP and PSTN
ACCESSCODECLASS
It indicates the
functions of access
codes.
[Value Range]
0: access code of the direct digit
collection mode
1: access code of one-stage digit
collection in the mode of caller
binding
2: access code of two-stage digit
binding
3: access code of common
two-stage digit collection
4: access code of common
two-stage digit collection and
bound two-stage digit collection
5: WebCall AccessCode
IPCHARGERULE
It is the charge
rule for incoming
IP calls.
[Value Range]
It is an integer in the range 1 to
2147483647.
IPADJUSTCHGCLASS
It is the adjust
charge class for
incoming IP calls.
[Value Range]
100.
CHARGERULE
It is the charge
rule for incoming
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
PSTN calls.
2147483647.
ADJUSTCHGCLASS
It is the adjust
charge class for
incoming PSTN
calls.
[Value Range]
100.
WELCOMEMSG
It is the codes of
welcome
messages.
[Value Range]
2147483647.
WELCOMEMSGFORMGT
It is the welcome
message ID of the
management
function.
[Value Range]
2147483647.
LANGUAGECHOICEFLAG
It is a flag that
indicates the
language selection.
[Value Range]
0: No
1: Choose one from multiple
choices
2: Choose one from two choices
MAXLANGUAGENUM
It is the maximum
number of
language types.
[Value Range]
9.
DEFAULTLANGUAGETYPE
It is the default
language type.
[Value Range]
2147483647.
MAXPCFAILRETRIES
It is the maximum
PC operation
retries.
[Value Range]
10.
DEFAULRETRY
It is the universal
retries.
[Value Range]
10.
FIRSTDIGITTIMEOUT
It is the PC
operation
first-digit timeout
time.
[Value Range]
20.
INTERDIGITTIMEOUT
It is the PC
operation
inter-digit timeout
time.
[Value Range]
20.
WELCOMEMSGFLAG
It is a flag that
indicates whether
to prompt
welcome message.
[Value Range]
0: No
1: Yes
Value must be 1 when
LANGUAGECHOICEFLAG is
set to 2.
INCOMINGCHGFLAG
It is a flag that
indicates whether
[Value Range]
0: None
Issue 01 (2008-01-28)
2-33

Parameter
2-34
Description
Value Range
to generate bills
for incoming calls.
1: Charge the calling number

2: Charge the card (from service
entry)
3: Charge the card (from
destination answers)
CHRGEDURATIONFLAG
It is a flag
indicating whether
to generate the
billed charge
duration.
[Value Range]
0: No
1: Yes
MAXAUTHRETRY
It is the maximum
number of times
card number and
PIN authentication
can be retried.
[Value Range]
10.
NOPASSAUTHFLAG
It is a flag that
indicates whether
to play voice when
authentication
fails.
[Value Range]
0: No
1: Yes
SCLINGPOS
It is the location of
special calling
party.
[Value Range]
24.
SCLINGLEN
It is the length of
special calling
party.
[Value Range]
7
AUTHMODE
It is the card
number and PIN
receiving mode.
[Value Range]
0: Together
1: Separately
FIXEDLENFLAG
It is the fixed
length option.
[Value Range]
The value can be 0, 1 or 2 when
AUTHMODE is set to 0.
The value can be 0, 1, 2 or 3
when AUTHMODE is set to 1.
0: Card
1: PIN
2: Card & PIN
3: None
CARDNUMLEN
It is the card
number length.
[Value Range]
20.
It is enabled when the card
number is of fixed length.
PINLEN
It is length of PIN.
[Value Range]
8.
It is enabled when the PIN is of
Issue 01 (2008-01-28)

Parameter
Description
Value Range
fixed length.
MINLOFCARDHAVEPIN
It is the minimum
number length of a
card with PIN.
[Value Range]
20.
MAXLOFCARDHAVEPIN
It is the maximum
number length of a
card with PIN.
[Value Range]
20.
AFTERPCTIMEOUTFLG
It is a flag that
indicates the
process mode after
timeout PC digit
collection.
[Value Range]
0: Retry
1: Connect to a destination
2: Prompt and release
NUMFORPCTIMEOUT
It is the number
connected after
timeout PC digit
collection.
[Value Range]
It is a character string of 2 to 20
digits.
CHOICEFORSNDLANG
It is the selection
code of second
language.
[Value Range]
It is an alphanumeric string of 2
digit containing 0 to 9,A to F,*
or #
It is enabled only when
set to 2.
SNDLANGTYPE
It is the type of
second language.
[Value Range]
It ranges from 1 to Max.
Language Number, which is set
in the Access Code Settings
(Service level) window.Max
Language Number can be [1-9].
set to 2.
LANGSELMSG
It is the voice
codes of language
selection.
[Value Range]
2147483647.
CALLINGSCREENTYPE
It indicates the
calling screen
type.
[Value Range]
0: None
1: Permitted
2: Restricted
AUTHRETRYEXPIREACT
It is a flag that
indicates the
process mode
when
authentication of
card number and
[Value Range]
0: Release
Issue 01 (2008-01-28)
2-35

Parameter
Description
Value Range
password exceeds
the retry times.
AUTHFAILPSTNNUM
number when
authentication of
card number and
password exceeds
the retrying times
limit.
[Value Range]
digits
AUTHTOMSGID
It is the target
voice ID after
timeout PC digit
collection.
[Value Range]
2147483647.
ACCFUNFLG
It is a flag that
indicates access
code functions.
[Value Range]
It is a binary string of 20 digits.
Each digit indicates the function
of an access code.
Char at position 1: indicating
whether to charge based on
incoming trunk
0: No
1: Yes
Char2: indicating whether to
support the call back function
0: No
1: Yes
Char3: indicating whether to
support call back flexible
routing
0: No
1: Yes
Char4: indicating whether the
welcome message is
interruptible
0: No
1: Yes
The default value is 0.
It is enabled only when the
value of
WELCOMEMSGFLAG is set
to 1.
CALLBACKDELAY
It is the call back

deferral time.
[Value Range]
2147483647.
WEBVIRTCALLINGNUM
It is the web call

virtual calling
number.
[Value Range]
It is the identifier
[Value Range]
USERIDENTIFIER
2-36
It is a numerical string of 2 to
20 digits.
Issue 01 (2008-01-28)

Parameter
RAUTHMODE
RFIXEDLENFLAG
Description
Value Range
of the user.
including -1.
It is a flag that
indicates
recharge card
pin collection
method.
[Value Range]
It is a flag that
indicates
whether the card
or pin length is
fixed or not.
[Value Range]
0: Together
1: Seperately
None
Card Fixed
PIN Fixed
Both
RMINLOFCARDHAVEPN
[Value Range]
It indicates the
minimum length An integer from [3-20] digits.
of a recharge
card with PIN.
RMAXLOFCARDHAVEPN
It indicates the
maximum
length of a
recharge card
with PIN.
[Value Range]
An integer from [3-20] digits..
RCARDNUMLEN
It indicates the
length of the
Recharge
[Value Range]
An integer from [3-20] digits.
RPINLEN
It indicates the
length of the
Recharge PIN.
[Value Range]
DEFAREACODE
The default area [Value Range]

code is only area An integer from [2-20] digits or
NULL.
code or a local
number head.
Issue 01 (2008-01-28)
2-37

Output Parameters
ACK: ADD PPS ACCESSCODE:
RETN =, DESC =
Table 2-35 Description of the output parameters of: ADD PPS ACCESSCODE
Parameter
Description
RETN

2202: Charge rule does not exists.
2203: Message configuration does not exist.
2204: Language configuration does not exist.
2191: Access code already exists

DESC

operation.
Example
ADD PPS ACCESSCODE: ACCESSCODE =1122, OVSACFLAG=1,
VIRTUALCALLINGNUM=0456565, ACCESSCODETYPE=0,
ACCESSCODECLASS=0,CHARGERULE=2, ADJUSTCHGCLASS=1,
WELCOMEMSG=100, WELCOMEMSGFORMGT=100, LANGUAGECHOICEFLAG=0,
DEFAULTLANGUAGETYPE=23, MAXPCFAILRETRIES=9, DEFAULRETRY=8,
FIRSTDIGITTIMEOUT=4, INTERDIGITTIMEOUT=7, WELCOMEMSGFLAG=0,
INCOMINGCHGFLAG=0, MAXAUTHRETRY=4, NOPASSAUTHFLAG=0,
SCLINGPOS=0533, SCLINGLEN=4, AUTHMODE=0, FIXEDLENFLAG=2,
CARDNUMLEN=4, PINLEN=3, MINLOFCARDHAVEPIN=4,
MAXLOFCARDHAVEPIN=4, CHOICEFORSNDLANG=ADF022, LANGSELMSG=4566,
CALLINGSCREENTYPE=0, AUTHRETRYEXPIREACT=0,
AUTHFAILPSTNNUM=98456678 AUTHTOMSGID=890766, ACCFUNFLG=11110000,
CALLBACKDELAY=234
2.3.17 Modifying Access Code Settings

Command Name
MOD PPS ACCESSCODE
Command Function
This command is used to modifying access code settings parameters.
2-38
Issue 01 (2008-01-28)

Input Parameters
MOD PPS ACCESSCODE:
ACCESSCODE=[,OVSACFLAG=][,VIRTUALCALLINGNUM=][,
ACCESSCODETYPE=][, ACCESSCODECLASS=][, IPCHARGERULE=]
[,IPADJUSTCHGCLASS=][,CHARGERULE=][,ADJUSTCHGCLASS=][,WELCOMEMSG
=][,WELCOMEMSGFORMGT=][,LANGUAGECHOICEFLAG=][,MAXLANGUAGENU
M=][,DEFAULTLANGUAGETYPE=][,MAXPCFAILRETRIES=][,DEFAULRETRY=][,FIR
STDIGITTIMEOUT=][,INTERDIGITTIMEOUT=][,WELCOMEMSGFLAG=][,INCOMIN
GCHGFLAG=][,CHRGEDURATIONFLAG=][,MAXAUTHRETRY=][,NOPASSAUTHFLA
G=][,SCLINGPOS=][,SCLINGLEN=][,AUTHMODE=][,FIXEDLENFLAG=][,CARDNUM
LEN=][,PINLEN=], [MINLOFCARDHAVEPIN=][, MAXLOFCARDHAVEPIN =][,
AFTERPCTIMEOUTFLG=][,NUMFORPCTIMEOUT=][,CHOICEFORSNDLANG=][,SND
LANGTYPE=][,LANGSELMSG=][,CALLINGSCREENTYPE=][,AUTHRETRYEXPIREA
CT=][,AUTHFAILPSTNNUM=][,AUTHTOMSGID=],[,ACCFUNFLG=][,CALLBACKDEL
AY=][ ,WEBVIRTCALLINGNUM=][,USERIDENTIFIER=][ RAUTHMODE=,][ RFIX
EDLENFLAG=,][ RMINLOFCARDHAVEPN= ,][ RMAXLOFCARDHAVEPN=,
][ RCARDNUMLEN=,][ RPINLEN= ,][ DEFAREACODE=,]
Table 2-36 Description of the input parameters of: MOD PPS ACCESSCODE
Parameter
Description
Value Range
ACCESSCODE
It is the access
code of PPS
service.
[Value Range]
-1 indicates "United Voucher Center"
OVSACFLAG
It is a flag
used to trigger
service access
codes in
countries
without the
IN.
[Value Range]
0 or 1
0: access codes of home country
1: access codes of countries without
the IN
VIRTUALCALLINGNUM
It is the
number of a
virtual calling
party.
[Value Range]
ACCESSCODETYPE
It indicates the
type of access
codes.
[Value Range]
0: PSTN and Management
1: IP and Management
2: IP, PSTN and Management
3: Only Management
4: PSTN
5: IP
6: IP and PSTN
ACCESSCODECLASS
It indicates the
functions of
access codes
[Value Range]
0: access code of the direct digit
collection mode
1: access code of one-stage digit
binding
2: access code of two-stage digit
Issue 01 (2008-01-28)
2-39

Parameter
Description
Value Range
binding
3: access code of common two-stage
digit collection
4: access code of common two-stage
digit collection and bound two-stage
digit collection
5: WebCall AccessCode
2-40
IPCHARGERULE
It is the charge
rule for
incoming IP
calls.
[Value Range]
2147483647.
IPADJUSTCHGCLASS
It is the adjust
charge class
for incoming
IP calls.
[Value Range]
It is an integer in the range 0 to 100.
CHARGERULE
It is the charge
rule for
incoming
PSTN calls.
[Value Range]
2147483647.
ADJUSTCHGCLASS
It is the adjust
charge class
for incoming
PSTN calls.
[Value Range]
WELCOMEMSG
It is the codes
of welcome
messages.
[Value Range]
2147483647.
WELCOMEMSGFORMGT
It is the
welcome
message IDs
of the
management
function.
[Value Range]
2147483647.
LANGUAGECHOICEFLAG
It is a flag that
indicates
language
selection.
[Value Range]
0: No
1: Choose one from multiple choices
2: Choose one from two choices
MAXLANGUAGENUM
It is the
maximum
number of
language
types.
[Value Range]
DEFAULTLANGUAGETYP
E
It is the
default
language type.
[Value Range]
2147483647.
MAXPCFAILRETRIES
It is the
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
maximum PC
operation
retries.
DEFAULRETRY
It is the
universal
retries.
[Value Range]
FIRSTDIGITTIMEOUT
It is the PC
operation
first-digit
timeout time.
[Value Range]
INTERDIGITTIMEOUT
It is the PC
operation
inter-digit
timeout time.
[Value Range]
WELCOMEMSGFLAG
It is a flag that
indicates
whether to
prompt
welcome
message.
[Value Range]
0: No
1: Yes
Value must be 1 when
LANGUAGECHOICEFLAG is set
to 2.
INCOMINGCHGFLAG
It is a flag that
indicates
whether to
generate bills
for incoming
calls.
[Value Range]
0: None
1: Charge the calling number
2: Charge the card (from service
entry)
3: Charge the card (from destination
answers)
CHRGEDURATIONFLAG
It is a flag that
indicates
whether to
generate the
billed charge
duration.
[Value Range]
0: No
1: Yes
MAXAUTHRETRY
It is the
maximum
number of
times card
number and
PIN
authentication
can be retried.
[Value Range]
NOPASSAUTHFLAG
It is a flag that
indicates
whether to
play voice
when
authentication
[Value Range]
0: No
1: Yes
Issue 01 (2008-01-28)
2-41

Parameter
Description
Value Range
fails.
2-42
SCLINGPOS
It is the
location of
special calling
party.
[Value Range]
SCLINGLEN
It is the length
of special
calling party.
[Value Range]
It is an integer in the range
AUTHMODE
It is the card
number and
PIN receiving
mode.
[Value Range]
0: Together
1: Separately
FIXEDLENFLAG
It is the fixed
length option.
[Value Range]
The value can be 0, 1 or 2 when
The value can be 0, 1, 2 or 3 when
0: Card
1: PIN
2: Card & PIN
3: None
CARDNUMLEN
It is the card
number
length.
[Value Range]
It is enabled when the card number is
of fixed length.
PINLEN
It is length of
PIN.
[Value Range]
It is enabled when the PIN is of fixed
length.
MINLOFCARDHAVEPIN
It is the
minimum
number length
of a card with
PIN.
[Value Range]
MAXLOFCARDHAVEPIN
It is the
maximum
number length
of a card with
PIN.
[Value Range]
AFTERPCTIMEOUTFLG
It is a flag that
indicates the
process mode
after timeout
PC digit
collection.
[Value Range]
0: Retry
2: Prompt and release
NUMFORPCTIMEOUT
It is the
[Value Range]
to 7
Issue 01 (2008-01-28)

Parameter
Description
Value Range
number
connected
after timeout
PC digit
collection.
digits.
CHOICEFORSNDLANG
It is the
selection code
of second
language.
[Value Range]
It is an alphanumeric string of 2 digit
containing 0 to 9,A to F,* or #
to 2.
SNDLANGTYPE
It is the type
of second
language.
[Value Range]
LANGSELMSG
It is the voice
codes of
language
selection.
[Value Range]
2147483647.
CALLINGSCREENTYPE
It indicates the
calling screen
type.
[Value Range]
0: None
1: Permitted
2: Restricted
AUTHRETRYEXPIREACT
It is a flag that
indicates the
process mode
when
authentication
of card
number and
password
exceeds the
retry times.
[Value Range]
0: Release
AUTHFAILPSTNNUM
It is the
destination
number when
authentication
of card
number and
password
exceeds the
retrying times
limit.
[Value Range]
digits
Issue 01 (2008-01-28)
It ranges from 1 to Max. Language

Number, that is set in the Access
Code Settings(Service level)
window.Max Language Number can
be [1-9].
to 2.
2-43

Parameter
Description
Value Range
AUTHTOMSGID
It is the target
voice ID after
timeout PC
digit
collection.
[Value Range]
2147483647.
ACCFUNFLG
It is a flag that
indicates
access code
functions.
[Value Range]
It is a binary string of 20 digits.
Each digit indicates the function of
an access code.
Char1: indicating whether to charge
based on incoming trunk
0: No
1: Yes
Char2: indicating whether to support
the call back function
0: No
1: Yes
Char3: indicating whether to support
call back flexible routing
0: No
1: Yes
Char4: indicating whether the
welcome message is interruptible
0: No
1: Yes
It is enabled only when the value of
WELCOMEMSGFLAG is set to 1.
CALLBACKDELAY
It is the call
back deferral
time.
[Value Range]
2147483647.
WEBVIRTCALLINGNUM
It is the web
call virtual
calling
number
[Value Range]
USERIDENTIFIER
It is the
identifier of
the user.
[Value Range]
including -1.
RAUTHMODE
It is a flag
that
indicates
recharge
card pin
collection
method.
[Value Range]
It is a flag
[Value Range]
RFIXEDLENFLAG
2-44
It is a numerical string of 2 to 20
digits.
0: Together
1: Seperately
Issue 01 (2008-01-28)

Parameter
RMINLOFCARDHAVEPN
RMAXLOFCARDHAVEPN
Description
Value Range
that
indicates
whether the
card or pin
length is
fixed or not.
None
Card Fixed
PIN Fixed
Both
It indicates
the
minimum
length of a
recharge
card with
PIN.
[Value Range]
It indicates
the
maximum
length of a
recharge
card with
PIN.
[Value Range]
RCARDNUMLEN
[Value Range]
It indicates
the length of An integer from [3-20] digits.
the Recharge
RPINLEN
[Value Range]
It indicates
the length of An integer from [2-8] digits.
the Recharge
PIN.
DEFAREACODE
[Value Range]
The default
area code is An integer from [2-20] digits or
NULL.
only area
code or a
local number
head.
Output Parameters
ACK: MOD PPS ACCESSCODE: RETN =, DESC =
Table 2-37 Description of the output parameters of: MOD PPS ACCESSCODE
Parameter
Description
RETN
Issue 01 (2008-01-28)
2-45

Parameter
Description
9121: Access Code does not Exist
2201: Max language number cannot be reduced since , language is

already configured for it.
2202: Charge rule does not exists.
2203: Message configuration does not exists.
2204: Language configuration does not exists.

DESC

operation.
Example
MOD PPS ACCESSCODE: ACCESSCODE =1122, OVSACFLAG=1
2.3.18 Querying Access Code Settings

Command Name
DISP PPS ACSCODE
Command Function
This command is used to query access code settings parameters.
Input Parameters
DISP PPS ACSCODE: ACCESSCODE =
Table 2-38 Description of the input parameters of: DISP PPS ACSCODE
Parameter
Description
Value Range
ACCESSCODE
It is the access code of

PPS service.
[Value Range]
Output Parameters
ACK: DISP PPS ACSCODE: RETN =, DESC = [, ATTR =, RESULT =]
2-46
Issue 01 (2008-01-28)

Table 2-39 Description of the output parameters of: DISP PPS ACSCODE
Parameter
Description
RETN

DESC

operation.
ATTR
ACCESSCODE&OVSACFLAG&VIRTUALCALLINGNUM&
ACCESSCODETYPE&ACCESSCODECLASS&IPCHARGERULE&
IPADJUSTCHGCLASS&CHARGERULE&ADJUSTCHGCLASS&
WELCOMEMSG&WELCOMEMSGFORMGT&LANGUAGECHOICE
FLAG&MAXLANGUAGENUM&DEFAULTLANGUGETYPE&
MAXPCFAILRETRIES&DEFAULTRETRY&FIRSTDIGITTIMEOUT
&INTERDIGITTIMEOUT&CHARGEDURATIONFLAG&MAXAUTH
RETRY& NOPASSAUTHFLAG&AUTHMODE& FIXEDLENFLAG&
CARDNUMLEN&PINLEN&MINLOFCARDHAVEPIN&MAXLOFCA
RDHAVEPIN&AFTERPCTIMEOUTFLG&NUMFORPCTIMEOUT&
WELCOMEMSGFLAG&INCOMINGCHGFLAG&CHOICEFORSNDL
ANG&SNDLANGTYPE&LANGSELMSG&CALLINGSCREENTYPE
&AUTHRETRYEXPIREACT&AUTHFAILPSTNNUM&AUTHTOMS
GID&HAVEDATAFLG&CALLBACKDELAY&SCLINGPOS&SCLIN
GLEN&ACCFUNCFLG&USERIDENTIFIER&RAUTHMODE&RFIX
EDLENFLAG&RMINLOFCARDHAVEPN&RMAXLOFCARDHAVE
PN&RCARDNUMLEN&RPINLEN&DEFAREACODE&MAXUSERC
HOOSE
RESULT
Example
DISP PPS ACSCODE: ACCESSCODE = 123456
2.3.19 Deleting Access Code Settings

Command Name
DELE PPS ACCESSCODE
Command Function
This command is used to delete access code settings parameters.
Issue 01 (2008-01-28)
2-47

Input Parameters
DELE PPS ACCESSCODE: ACCESSCODE=,[ USERIDENTIFIER=]
Table 2-40 Description of the input parameters of: DELE PPS ACCESSCODE
Parameter
Description
Value Range
ACCESSCODE

of PPS service.
[Value Range]
To support multiple deletion, access
codes should be separated with an
ampersand (&) from each other.
USERIDENTIFIER
the user.
[Value Range]
including -1.
Output Parameters
ACK: DELE PPS ACCESSCODE: RETN =, DESC = [,ATTR=, RESULT=]
Table 2-41 Description of the output parameters of: DELE PPS ACCESSCODE
Parameter
RETN
Description
9121: Access Code does not Exist
2181: Access code is in use.

DESC
ATTR

operation.
RESULT
Example
DELE PPS ACCESSCODE: ACCESSCODE=200706
Or
DELE PPS ACCESSCODE: ACCESSCODE=200706&200705
2-48
Issue 01 (2008-01-28)

2.3.20 Querying Service Information Settings

Command Name
DISP PPS SRVPARA
Command Function
This command is used to query details of the service level parameters.
Input Parameters
DISP PPS SRVPARA
Output Parameters
ACK: DISP PPS SRVPARA: RETN=, DESC= [, ATTR=, RESULT =]
Table 2-42 Description of the output parameters of: DISP PPS SRVPARA
Parameter
RETN
Description
9101: Record of service level parameters does not exist.
9102: The service level parameter is not allowed to configure multiple

records.

DESC
ATTR

operation.
USERIDENTIFIER& CALLINGBLKFLG& CALLINGBLKCOUNT&
CALLINGBLKCLEARFLG& CALLINGBLKCLEARHRS&
SMAPCLGBLKCLRHRS& CALLEDSCREENTYPE&
CALLINGSCREENTYPE& PLAYVOICETYPE& SPECIALNUMFLG&
PQROFLOCAL& PQROFTOLL& PQROFINTCALL&
CHARGINGPOINT& INTERIMCDRFLAG& INTERVALOFINTCDR&
SERVICESTATFLAG& CALLEVENTSTATFLG&
CARDUNIQUEFLAG& COMPLEXPWDFLAG&
VIRTUALCHGCLASS& AIRTIMEFLG& CHARGEONDISTANCE&
GSNCREATETYPE& GSNLENGTH& FUNCTIONFLG&
HAVEDATAFLG& MAXLOCKTIME& DEFAULTSDUID&
MINLENOFACC& MAXLENOFACC& REDIRECTPREFIX&
PLYMSSGFEID& VOICEFILEID& MAXMESSAGEID&
CURRENTMESSAGEID& MINMESSAGEID
RESULT
Issue 01 (2008-01-28)
2-49

Example
DISP PPS SRVPARA:
2.3.21 Querying Service Configuration Information

Command Name
DISP PPS SRVCONFIG
Command Function
This command is used to query service configuration information.
Input Parameters
DISP PPS SRVCONFIG: SERVICEKEY =, ITEMNAME =
Table 2-43 Description of the input parameters of: DISP PPS SRVCONFIG
Parameter
Description
Value Range
SERVICEKEY
It is the service key.
[Value Range]
2147483647
ITEMNAME
It is the name of
service
configuration
information.
[Value Range]
It is a character string of 1 to 20 digits.
Output Parameters
ACK: DISP PPS SRVCONFIG: RETN=0, DESC=[, TOTAL=, SN=, NUMOF=, FINISHED=,
ATTR=, RESULT=]
Table 2-44 Description of the output parameters of: DISP PPS SRVCONFIG
Parameter
Description
RETN

DESC

operation.
ATTR
2-50
Issue 01 (2008-01-28)

Parameter
Description
STRVALUE& INTVALUE& DECVALUE
RESULT
Example
DISP PPS SRVCONFIG: SERVICEKEY = 1, ITEMNAME = acnc
2.4 Service Provider

2.4.1 Listing SPs
Command Name
LIST PPS SP
Command Function
This command is used to list all SP IDs and names.
Input Parameters
LIST PPS SP
Output Parameters
ACK: LIST PPS SP: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =, ATTR
=, RESULT =]
Table 2-45 Description of the output parameters of: LIST PPS SP
Parameter
Description
RETN

digits.
DESC
ATTR
Issue 01 (2008-01-28)


2-51

Parameter
Description
SPID& SPNAME
RESULT
TOTAL

integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SP:
2.4.2 Counting the Total Number of SPs

Command Name
COUNT PPS SP:
Command Function
This command is used to list the total number of service providers.
Input Parameters
COUNT PPS SP
Output Parameters
ACK: COUNT PPS SP: RETN =, DESC = [, TOTAL =]
Table 2-46 Description of the output parameters of: COUNT PPS SP
Parameter
Description
RETN

digits.
DESC
2-52

Issue 01 (2008-01-28)

Parameter
Description
TOTAL

integer.
Example
COUNT PPS SP:
2.4.3 Querying Relevant Information of an SP

Command Name
DISP PPS SPINFO
Command Function
This command is used to query the information of a specified SP.
Input Parameters
DISP PPS SPINFO: SPID =
Table 2-47 Description of the input parameters of: DISP PPS SPINFO
Parameter
Description
Value Range
SPID
It is the unique identifier of the

SP.
[Value Range]
999.
Output Parameters
ACK: DISP PPS SPINFO: RETN =, DESC = [ATTR =, RESULT =]
Table 2-48 Description of the output parameters of: DISP PPS SPINFO
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

operation.
2-53

Parameter
Description
ATTR
SPID& SPNAME& SPMACHARGERULE
RESULT
Example
DISP PPS SPINFO: SPID = 123
2.4.4 Querying Relevant Parameter Information of an SP

Command Name
DISP PPS SPPARA
Command Function
This command is used to query parameter information about an SP.
Input Parameters
DISP PPS SPPARA: [SPID =]
Table 2-49 Description of the input parameters of: DISP PPS SPPARA
Parameter
Description
Value Range
SPID
It is the unique identifier of

the SP.
[Value Range]
It is an integer in the range -1 to 999.
Default is -1.
Output Parameters
ACK: DISP PPS SPFEATURES: RETN =, DESC = [, TOTAL=, FINISHED =, SN =,
NUMOF =, ATTR=, RESULT=]
Table 2-50 Description of the output parameters of: DISP PPS SPPARA
2-54
Parameter
Description
RETN

DESC

operation.
Issue 01 (2008-01-28)

Parameter
ATTR
Description
SPID&SPNAME&CARDBLKLSTCOUNT&CARDBLKLSTLOGFLAG
&MODPINLOGFLAG&CALLEDSCREENTYPE&USEDUPRECHARG
EFLAG&RECHARGELOGFLAG&FIRSTPLYBALFLG&PLYBALMIN
BALANCE&PLYBALMINDAYBAL&PLAYBALMINMONBAL&NO
ANSWERTIME&MAXCALLFAILRETRIES&REDIALFLAG&REDIA
LKEY&CALLINGSCREENTYPE&MAXMANAGEMENTTIMES&EN
CRYPTFLAG&ENCRYPTKEY&ACSURCHRGFLG&CSCFLAG&TW
ODIGITNUMFLAG&ACCUMBONUSFLAG&ACCUMCOEFFICIENT
A&ACCUMCOEFFICIENTB&ACCUMBONUSLOGFLG&PROPRINCI
PLE&MAXVALIDPERIOD&CARDBINDINGFLAG&ABBRACCTFLA
G&ABBRACCTSCRTYPE&FAMILYNUMFLAG&RECHGNEWCARD
FLG&PLAYVALIDDATEFLG&THRESHOLDLORH&DEFAULTCSC
NUMBER&CSCCHARGEMETHOD&CSCMAXDURATION&CALLE
DSCRTYPEOFCLI&PLAYBALINSUFFFLG&PLAYBALLNUSUFFFL
G&MINRESETTIME&SRVUNBINDSMAPFLG&FINALDISCOUNTM
TD&FREETIMESFORMGT&NOIVALSGFLG&BONUSPERIOD&HA
VEDATAFLG&CONTROLFLG&GSNHEAD&QUERYCALLTIMES&
CURRENCYTYPE&CURRENCYNAME&DISPLAYUNIT&RATIO&V
OICEMAILNUMBER&VMCHARGEMETHOD&VMMAXDURATION
&SMSCFEPID&UVCRESID&UVCBONUSRESID&UVCPROLONGRE
SID&ALTCURRENCYTYPE&SERVICEMENUID&MENULEVEL&M
GMTKEY&REDIALMSGID&PLAYVALIDITYBALFLG&CSCCONN
ECTMTDFLG&CSCMSGID
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS SPPARA: SPID = 123
Issue 01 (2008-01-28)
2-55

2.4.5 Querying Relevant Charge Information of an SP

Command Name
DISP PPS SPCHRGINFO
Command Function
This command is used to query the charge information of a specified SP.
Input Parameters
DISP PPS SPCHRGINFO: [SPID =] [, CURRENCY =]
Table 2-51 Description of the input parameters of: DISP PPS SPCHRGINFO
Parameter
Description
Value Range
SPID

the SP.
[Value Range]
999.
CURRENCY
It is the currency types

defined in the system
currency definition table.
[Value Range]
Output Parameters
ACK: DISP PPS SPCHRGINFO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-52 Description of the output parameters of: DISP PPS SPCHRGINFO
Parameter
Description
RETN

DESC
ATTR

operation.
SPID&SPNAME&CURRENCYID&QUERYBALFEE&CHANGEPINFE
E&QU
ERYABBRNUMFEE&SETABBRNUMFEE&RECHARGEFEE&MAXR
CHARGEFEE&ADDFEE&BINDINGMGTFEE&ABBRA
CCTFEE&FAMILYNUMFEE&QUERYVALIDDATEFEE&CSCSURC
2-56
Issue 01 (2008-01-28)

Parameter
Description
HARGE&PLYAVLTIMEBEFFEE&DSPCLIFEE&PL
YAFTCOSTFEE&AUTHPINFEE&NUMBERSYSTEM&NUMBERSYS
TEMTYPE&RATIO2MINUNIT&SETLANGUEFEE&
QUERYINFOFEE&PAYMENTFEE&QUERYBILLFEE&UPPERAMO
UNTLMT&LOWERAMOUNTLMT&CURRENCYTYPE&
CURRENCYNAME&DISPLAYUNIT&RATIO&VMMAILFEE&MINB
ALANCEFORUBP&MAXBALANCEFORUBP&SMSCM
ANAGEFEE&MDFEE&FEPVERSION
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS SPCHRGINFO: SPID = 123, CURRENCY = 1
2.4.6 Querying Relevant Information of SP Access Codes

Command Name
LIST PPS SPACCESSCODE
Command Function
This command is used to query information of all SP access codes.
Input Parameters
LIST PPS SPACCESSCODE
Output Parameters
ACK: LIST PPS SPACCESSCODE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Issue 01 (2008-01-28)
2-57

Table 2-53 Description of the output parameters of: LIST PPS SPACCESSCODE
Parameter
Description
RETN

DESC

operation.
ATTR
SPID&SPNAME&ACCESSCODE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SPACCESSCODE:
2.4.7 Querying Relevant Information of SP Features

Command Name
DISP PPS SPFEATURES
Command Function
This command is used to display the relevant features of a specific SP. If no SP is specified,
all SP information is displayed.
Input Parameters
DISP PPS SPFEATURES: [SPID =]
2-58
Issue 01 (2008-01-28)

Table 2-54 Description of the input parameters of: DISP PPS SPFEATURES
Parameter
Description
Value Range
SPID

the SP.
[Value Range]
Output Parameters
ACK: DISP PPS SPFEATURES: RETN =, DESC = [, TOTAL=, FINISHED =, SN =,
NUMOF =, ATTR=, RESULT=]
Table 2-55 Description of the output parameters of: DISP PPS SPFEATURES
Parameter
Description
RETN

DESC
ATTR

operation.
SPID&SPNAME&RGTCARDBLKCLEAR&RGTRECHARGE&RGT
DAILYLM
TTYPE&RGTMTHLMTTYPE&RGTVLDPRDTYPE&RGTPLYDRT
NAVL&RGTPLYBAL&RGTPLYDRTN&RGTPLYCOST&
RGTPLYNEWBAL&RGTBEEP&RGTSMAPCARDBLKCLR&RGTP
ROBATION&SPMAXCALLTIME
RESULT
Example
DISP PPS SPFEATURES: SPID = 123
2.4.8 Querying Information in the Usage Bonus Log Table

Command Name
LIST PPS ACCUMBNSLOG
Issue 01 (2008-01-28)
2-59

Command Function
This command is used to display relevant information in the usage bonus log table based on
specified start time, end time and card number.
Input Parameters
LIST PPS ACCUMBNSLOG: CARDNO =, STARTDATETIME =, ENDDATETIME =
Table 2-56 Description of the input parameters of: LIST PPS ACCUMBNSLOG
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
STARTDATETIME
It is the start time of

recharge.
[Value Range]
It is a numerical string of 14 digits in
format YYYYMMDDHHMMSS.
ENDDATETIME
It is the end time of

recharge.
[Value Range]
Output Parameters
ACK: LIST PPS ACCUMBNSLOG: RETN =, DESC = [, TOTAL=, FINISHED =, SN=,
Table 2-57 Description of the output parameters of: LIST PPS ACCUMBNSLOG
Parameter
Description
RETN

DESC
ATTR

operation.
CARDNO& USAGEFEEAFTER& RECORDTIME&
CURRENTACCUMLEVEL& UPGRADELEVELTO&
ACCOUNTLEFTBEF& ACCOUNTLEFTAFTER& BONUS&
CURRENCYTYPE& CURRENCYNAME& DISPLAYUNIT& RATIO
2-60
RESULT
TOTAL
Issue 01 (2008-01-28)

Parameter
Description
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS ACCUMBNSLOG: STARTTIME = 20000102000000, ENDTIME =
30000707000000, ACCOUNTNUMBER = 123
2.4.9 Querying the Usage Bonus Information Table

Command Name
LIST PPS SPACCUMBONUS
Command Function
This command is used to display relevant information from the usage bonus information table
of a specific SP and a specific currency type.
Input Parameters
LIST PPS SPACCUMBONUS: SPID =, CURRENCYTYPE =
Table 2-58 Description of the input parameters of: LIST PPS SPACCUMBONUS
Parameter
Description
Value Range
SPID
It is the unique
identifier of the SP.
[Value Range]
999.
CURRENCYTYPE
It is the currency types

defined in the system
currency definition
table.
[Value Range]
Output Parameters
ACK: LIST PPS SPACCUMBONUS: RETN =, DESC = [, TOTAL=, FINISHED=, SN=,
NUMOF=, ATTR=, RESULT=]
Issue 01 (2008-01-28)
2-61

Table 2-59 Description of the output parameters of: LIST PPS SPACCUMBONUS
Parameter
Description
RETN

DESC

operation.
ATTR
SPID& CURRENTLEVEL& LOWACCUMTHRESHOLD&
HIGHACCUMTHRESHOLD& UPGRADELEVELTO&
CURRENCYTYPE& BONUS& CURRENCYNAME& DISPLAYUNIT&
RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SPACCUMBONUS: SPID = 123, CURRENCYTYPE = 1
2.4.10 Adding Called Screen Based on Calling Numbers

Command Name
ADD PPS CALLEDSRCOFCLI
Command Function
This command is used to add called screen based on calling numbers.
Input Parameters
ADD PPS CALLEDSRCOFCLI: SPID =, CALLNO =, SRCCALLEDNUM =
2-62
Issue 01 (2008-01-28)

Table 2-60 Description of the input parameters of: ADD PPS CALLEDSRCOFCLI
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
CALLNO
It is the calling
number.
[Value Range]
It is a numerical string of 2 to 20 digits.
SRCCALLEDNUM
It is the screened
called number or its
head.
[Value Range]
Output Parameters
ACK: ADD PPS CALLEDSRCOFCLI: RETN =, DESC =
Table 2-61 Description of the output parameters of: ADD PPS CALLEDSRCOFCLI
Parameter
RETN
Description
8421: The called screen information based on the calling number to be

added has already existed.
8422: The service provider does not support the called screen function
based on the calling number.

DESC

operation.
Example
ADD PPS CALLEDSRCOFCLI: SPID = 123, CALLNO = 0755123456,
SRCCALLEDNUM = 0755654321
2.4.11 Querying Called Screen Based on Calling Numbers

Command Name
LIST PPS CALLEDSRCOFCLI
Command Function
This command is used to query called screen based on calling numbers.
Issue 01 (2008-01-28)
2-63

Input Parameters
LIST PPS CALLEDSRCOFCLI: SPID =
Table 2-62 Description of the input parameters of: LIST PPS CALLEDSRCOFCLI
Parameter
Description
Value Range
SPID
It is the unique identifier of the SP.
[Value Range]
999.
Output Parameters
ACK: LIST PPS CALLEDSRCOFCLI: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-63 Description of the output parameters of: LIST PPS CALLEDSRCOFCLI
Parameter
Description
RETN

DESC

operation.
ATTR
USERIDENTIFIER& SPID& SPNAME&
CALLINGPARTYNUMBER& SCREENNUMBER
RESULT
TOTAL
FINISHED

0: No
2-64
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS CALLEDSRCOFCLI: SPID = 123
2.4.12 Deleting Called Screen Based on Calling Numbers

Command Name
DELE PPS CALLEDSRCOFCLI
Command Function
This command is used to delete called screen based on calling numbers.
Input Parameters
DELE PPS CALLEDSRCOFCLI: SPID = [, CALLNO =] [, SRCCALLEDNUM =]
Table 2-64 Description of the input parameters of: DELE PPS CALLEDSRCOFCLI
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
CALLNO
It is the calling
number.
[Value Range]
SRCCALLEDNUM
It is the screened
called number or its
head.
[Value Range]
Output Parameters
ACK: DELE PPS CALLEDSRCOFCLI: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-65 Description of the output parameters of: DELE PPS CALLEDSRCOFCLI
Parameter
Description
RETN

DESC
ATTR

operation.
TOTAL& SUCCESSNUM& FAILNUM
Issue 01 (2008-01-28)
2-65

Parameter
Description
RESULT
Example
DELE PPS CALLEDSRCOFCLI: SPID = 123, CALLNO = 123456
2.4.13 Adding Information in the Recharge Prolongation Table

Command Name
ADD PPS SPPROLONGDATA
Command Function
This command is used to add information in the recharge prolongation table of a specified SP.
Input Parameters
ADD PPS SPPROLONGDATA: SPID =, CURRENCYTYPE =, RECHARGEFEE =,
PROLONGDATE =
Table 2-66 Description of the input parameters of: ADD PPS SPPROLONGDATA
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
It is an integer in the range 0 to 15
RECHARGEFEE
It is the threshold of
recharge amount.
[Value Range]
268435455.
PROLONGDATE
It is the date to
which recharge
prolongs.
[Value Range]
Output Parameters
ACK: ADD PPS SPPROLONGDATA: RETN =, DESC =
2-66
Issue 01 (2008-01-28)

Table 2-67 Description of the output parameters of: ADD PPS SPPROLONGDATA
Parameter
RETN
Description
8663: Duplicate Recharge prolongation information.

8702:A record with the Recharge Fee of Default must be configured

DESC

operation.
Example
ADD PPS SPPROLONGDATA: SPID = 123, CURRENCYTYPE = 1, RECHARGEFEE =
0, PROLONGDATE = 0
2.4.14 Modifying Information in the Recharge Prolongation Table

Command Name
MODI PPS SPPROLONGDATA
Command Function
This command is used to modify information in the recharge prolongation table of a specified
SP.
Input Parameters
MODI PPS SPPROLONGDATA: SPID =, CURRENCYTYPE =, RECHARGEFEE = [,
NEWRECHARGEFEE =] [, NEWPROLOGDATE =]
Table 2-68 Description of the input parameters of: MODI PPS SPPROLONGDATA
Parameter
Description
Value Range
SPID
It is the unique
identifier of a service
provider.
[Value Range]
CURRENCYTYPE
It is the currency type.
[Value Range]
RECHARGEFEE
recharge amount.
[Value Range]
268435455.
NEWRECHARGEFEE
recharge amount after
[Value Range]
Issue 01 (2008-01-28)
2-67

Parameter
NEWPROLOGDATE
Description
Value Range
modification.
268435455.
It is the date to which

recharge prolongs after
modification.
[Value Range]
Output Parameters
ACK: MODI PPS SPPROLONGDATA: RETN =, DESC =
Table 2-69 Description of the output parameters of: MODI PPS SPPROLONGDATA
Parameter
RETN
Description
8721: The recharge mode of prolonging period to be modified does not

exist.
8662: With the service provider and currency type specified, there must
be at least one record with the value of Recharge Fee set to the default
value.
8663: Duplicate Recharge prolongation information.

DESC

operation.
Example
MODI PPS SPPROLONGDATA: SPID = 123, CURRENCYTYPE = 1, RECHARGEFEE =
0, PROLOGDATE = 0
2.4.15 Querying Information in the Recharge Prolongation Table

Command Name
LIST PPS SPPROLONGDATA
Command Function
This command is used to query information in the recharge prolongation table of a specified
SP and currency type.
Input Parameters
LIST PPS SPPROLONGDATA: SPID =, CURRENCYTYPE = [, RECHARGEFEE =]
2-68
Issue 01 (2008-01-28)

Table 2-70 Description of the input parameters of: LIST PPS SPPROLONGDATA
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
RECHARGEFEE
recharge amount.
[Value Range]
268435455.
Output Parameters
ACK: LIST PPS SPPROLONGDATA: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-71 Description of the output parameters of: LIST PPS SPPROLONGDATA
Parameter
Description
RETN

DESC

operation.
ATTR
SPID& CURRENCYTYPE& RECHARGEFEE& PROLONGDATE&
CURRENCYNAME& DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-69

Example
LIST PPS SPPROLONGDATA: SPID = 123, CURRENCYTYPE = 1
2.4.16 Deleting Information in the Recharge Prolongation Table

Command Name
DELE PPS SPPROLONGDATA
Command Function
This command is used to delete information in the recharge prolongation table of a specified
SP.
Input Parameters
DELE PPS SPPROLONGDATA: SPID =, CURRENCYTYPE =, RECHARGEFEE =
Table 2-72 Description of the input parameters of: DELE PPS SPPROLONGDATA
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
RECHARGEFEE
recharge amount.
[Value Range]
268435455.
Output Parameters
ACK: DELE PPS SPPROLONGDATA: RETN =, DESC =
Table 2-73 Description of the output parameters of: DELE PPS SPPROLONGDATA
Parameter
RETN
Description
8701: The recharge mode of prolonging period to be deleted does not

exist.
8702: A record with the Recharge Fee of Default must be configured.

DESC
2-70

operation.
Issue 01 (2008-01-28)

Parameter
Description
Example
DELE PPS SPPROLONGDATA: SPID = 123, CURRENCYTYPE = 1, RECHARGEFEE =
1, PROLONGDATE = 1
2.4.17 Adding Information to the Recharge Bonus Table

Command Name
ADD PPS SPRECHRGBNS
Command Function
This command is used to add information of an SP to recharge bonus table.
Input Parameters
ADD PPS SPRECHRGBNS: SPID =, CURRENCYTYPE =, RECHARGE =,
PROMOTIONTYPE =, STARTDATETIME =, ENDDATETIME =, PROMOTIONAMOUNT
=
Table 2-74 Description of the input parameters of: ADD PPS SPRECHRGBNS
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
RECHARGEFEE
It is the threshold
of recharge
amount.
[Value Range]
268435455.
PROMOTIONTYPE
It is the type of
recharge
preference.
[Value Range]
0: preference by percentage
1: preference by value
STARTDATETIME
It is the start time

of preference.
[Value Range]
the format of YYYYMMDDHHMMSS.
ENDDATETIME

preference.
[Value Range]
the format of YYYYMMDDHHMMSS.
PROMOTIONAMOUNT
It is the preference
amount or
[Value Range]
Issue 01 (2008-01-28)
2-71

Parameter
Description
Value Range
percentage.
If PROMOTIONTYPE is 0: preference
by percentage
If PROMOTIONTYPE is 1: preference
by value
Output Parameters
ACK: ADD PPS SPRECHRGBNS: RETN =, DESC =
Table 2-75 Description of the output parameters of: ADD PPS SPRECHRGBNS
Parameter
RETN
Description
8601: The time segment of recharge bonus entered and the time
segment already existed are partially overlapped. Please note time
segments must either completely overlap or must not overlap at all.
8602: One record with the recharge set to Default must be

configured in recharge promotion data during the current time
segment.
8603: Duplicate Recharge.

DESC


Example
ADD PPS SPRECHRGBNS: SPID = 123, CURRENCYTYPE = 1, RECHARGE = 0,
PROMOTIONTYPE = 0, STARTDATETIME = 20060201090702, ENDDATETIME =
20060304050202, PROMOTIONAMOUNT = 1
2.4.18 Modifying Information in the Recharge Bonus Table

Command Name
MODI PPS SPRECHRGBNS
Command Function
This command is used to modify information of an SP in recharge bonus table.
2-72
Issue 01 (2008-01-28)

Input Parameters
MODI PPS SPRECHRGBNS: SPID =, CURRENCYTYPE =, STARTDATETIME =,
ENDDATETIME =, RECHARGE = [, NEWSTARTDATETIME =] [, NEWENDDATETIME
=] [, NEWRECHARGE =] [, NEWPROMOTIONTYPE =] [, NEWPROMOTIONAMOUNT
=]
Table 2-76 Description of the input parameters of: MODI PPS SPRECHRGBNS
Parameter
Description
Value Range
SPID
It is the unique
provider.
[Value Range]
It is an integer in the range 0
to 999.
CURRENCYTYPE
It is the currency type.
[Value Range]
to 15.
RECHARGEFEE
recharge amount.
[Value Range]
1 to 268435455.
STARTDATETIME

preference.
[Value Range]
It is a numerical string of 14
digits in the format of
YYYYMMDDHHMMSS.
ENDDATETIME

preference.
[Value Range]
YYYYMMDDHHMMSS.
NEWSTARTDATETIME

preference after
modification.
[Value Range]
YYYYMMDDHHMMSS.
NEWENDDATETIME

preference after
modification.
[Value Range]
YYYYMMDDHHMMSS.
NEWRECHARGE
recharge amount after
modification.
[Value Range]
to 268435455.
NEWPROMOTIONTYPE
It is the recharge
preference type after
modification.
[Value Range]
0: preference by percentage
1: preference by value
NEWPROMOTIONAMOUNT
It is the recharge
bonus amount or
preference percentage
after modification.
[Value Range]
When
PROMOTIONTYPE is set
to 0, it is an integer in [0,
268435455].
When
Issue 01 (2008-01-28)
2-73

Parameter
Description
Value Range
PROMOTIONTYPE is set
to 1, it is an integer in [0,
100].
Make sure that at least one of the following five optional parameters is entered:
NEWSTARTDATETIME
NEWENDDATETIME
NEWRECHARGE
NEWPROMOTIONTYPE
NEWPROMOTIONAMOUNT
Output Parameters
ACK: MODI PPS SPRECHRGBNS: RETN =, DESC =
Table 2-77 Description of the output parameters of: MODI PPS SPRECHRGBNS
Parameter
RETN
Description
8641: The recharge bonus mode to be modified does not exist.
8642: NEWRECHARGE must be equal to 0 when the value of the

time segment is set to default value.

DESC

operation.
Example
MODI PPS SPRECHRGBNS: SPID = 123, CURRENCYTYPE = 1, RECHARGE = 0,
NEWPROMOTIONTYPE = 0, STARTDATETIME = 20060201090707, ENDDATETIME =
20060304050505, NEWPROMOTIONAMOUNT = 1
2.4.19 Querying Information from the Recharge Bonus Table

Command Name
LIST PPS SPRECHRGBNS
2-74
Issue 01 (2008-01-28)

Command Function
This command is used to query information of an SP in recharge bonus table.
Input Parameters
LIST PPS SPRECHRGBNS: SPID =, CURRENCYTYPE = [, STARTDATETIME =] [,
ENDDATETIME =] [, RECHARGE =]
Table 2-78 Description of the input parameters of: LIST PPS SPRECHRGBNS
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
STARTDATETIME

preference.
[Value Range]
the format of
YYYYMMDDHHMMSS.
ENDDATETIME

preference.
[Value Range]
the format of
YYYYMMDDHHMMSS.
RECHARGE
recharge amount.
[Value Range]
268435455. The default value is 0.
Output Parameters
ACK: LIST PPS SPRECHRGBNS: RETN =, DESC = [, TOTAL =, FINISHED, SN =,
Table 2-79 Description of the output parameters of: LIST PPS SPRECHRGBNS
Parameter
Description
RETN

DESC
ATTR
Issue 01 (2008-01-28)

operation.
2-75

Parameter
Description
SPID& CURRENCYTYPE& RECHARGE&
PROMOTIONTYPE&STARTDATETIME&ENDDATETIME&
PROMOTIONAMOUNT& CURRENCYNAME& DISPLAYUNIT&
RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SPRECHRGBNS: SPID = 0, CURRENCYTYPE = 0, STARTDATETIME =
10000101000000, ENDDATETIME = 20000101000000, RECHARGE = 120
2.4.20 Deleting Information in the Recharge Bonus Table

Command Name
DELE PPS SPRECHRGBNS
Command Function
This command is used to delete information of an SP in recharge bonus table.
Input Parameters
DELE PPS SPRECHRGBNS: SPID =, CURRENCYTYPE =, RECHARGE =,
STARTDATETIME =, ENDDATETIME =
Table 2-80 Description of the input parameters of: DELE PPS SPRECHRGBNS
2-76
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCYTYPE
It is the currency
type.
[Value Range]
STARTDATETIME
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
preference.

the format of
YYYYMMDDHHMMSS.
ENDDATETIME

preference.
[Value Range]
the format of
YYYYMMDDHHMMSS.
RECHARGE
recharge amount.
[Value Range]
268435455. The default value is 0.
Output Parameters
ACK: DELE PPS SPRECHRGBNS: RETN =, DESC =
Table 2-81 Description of the output parameters of: DELE PPS SPRECHRGBNS
Parameter
Description
RETN

8621: The recharge bonus mode to be deleted does not exist.
DESC

operation.
Example
DELE PPS SPRECHRGBNS: SPID = 123, CURRENCYTYPE = 0, RECHARGE =10,
STARTDATETIME = 20060201090702, ENDDATETIME = 20060304050505
2.4.21 Querying Serve Level Settings

Command Name
LIST PPS SERVLEVEL
Command Function
This command is used to query serve level settings for an SP.
Issue 01 (2008-01-28)
2-77

Input Parameters
LIST PPS SERVLEVEL: SPID=,
Table 2-82 Description of the input parameters of: LIST PPS SERVLEVEL
Parameter
Description
Value Range
SPID
It is the unique
provider.
[Value Range]
999.
Output Parameters
ACK: PPS SERVLEVEL:RETN=, DESC=[, TOTAL=, SN=, NUMOF=, FINISHED=,
ATTR=, RESULT=]
Table 2-83 Description of the output parameters of: LIST PPS SERVLEVEL
Parameter
Description
RETN

1011: The service provider does not exist.
2271- Serve Level Range Is Not Configured For The Service Provider.
DESC
ATTR

operation.
spID& productID& countryCode& areaCode& callingNum& serveLevel
RESULT
TOTAL
FINISHED

0: No
2-78
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS SERVLEVEL: SPID=2
2.4.22 Querying Time Slot Settings

Command Name
LIST PPS TIMESLOT
Command Function
This command is used to query information of a time slot settings at service provider level.
Input Parameters
LIST PPS TIMESLOT: SPID=
Table 2-84 Description of the input parameters of: LIST PPS TIMESLOT
Parameter
Description
Value Range
SPID

a service provider.
[Value Range]
It is an integer in the range -1 to
999.-1 is default.
Output Parameters
ACK: LIST PPS TIMESLOT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
=, ATTR =, RESULT =]
Table 2-85 Description of the output parameters of: LIST PPS TIMESLOT
Parameter
Description
RETN

2301: Charging Point should be set to SCP at service level.

DESC
ATTR

operation.
spID& chargeRule& startTime& endTime& dHCategory& modality
Issue 01 (2008-01-28)
2-79

Parameter
Description
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS TIMESLOT: SPID=123
2.4.23 Querying Customer Ser. Center Number Settings

Command Name
LIST PPS CSC
Command Function
This command is used to query the relevant information of a customer ser. center setting at
service provider level.
Input Parameters
LIST PPS CSC: SPID=[,USERIDENTIFIER=]
Table 2-86 Description of the input parameters of: LIST PPS CSC
2-80
Parameter
Description
Value Range
SPID
It is the unique identifier

of a service provider.
[Value Range]
999.
USERIDENTIFIER
It is the identifier of a
user.
[Value Range]
It is an integer from 1 to 28 digits
including -1.
Default value is -1.
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS CSC: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-87 Description of the output parameters of: LIST PPS CSC
Parameter
RETN
Description
2311: Flag for Customer Ser. Center Number not set.
1022: The service provider parameter does not exist.

DESC
ATTR

operation.
spID& languageType& cscNumber
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CSC: SPID=123
2.4.24 Querying Day Category Settings

Command Name
LIST PPS DAYCAT
Command Function
This command is used to query day category information for an service provider.
Issue 01 (2008-01-28)
2-81

Input Parameters
LIST PPS DAYCAT: SPID =
Table 2-88 Description of the input parameters of: LIST PPS DAYCAT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
-1 is default.
Output Parameters
ACK: LIST PPS DAYCAT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-89 Description of the output parameters of: LIST PPS DAYCAT
Parameter
Description
RETN

1011- The service provider does not exist.

DESC
ATTR

operation.
startDay& endDay& dayCategory
2-82
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS DAYCAT: SPID = 123
2.4.25 Querying Virtual Calling Number Settings

Command Name
LIST PPS VIRTUALCLI
Command Function
This command is used to query the virtual calling number settings for Bill and INAP based on
the service provider and Call Type or Caller/Callee.
Input Parameters
LIST PPS VIRTUALCLI: SPID=, DISPMODE=
Table 2-90 Description of the input parameters of: LIST PPS VIRTUALCLI
Parameter
Description
Value Range
SPID
It is the unique identifier

of a service provider.
[Value Range]
999.
DISPMODE
It is the display mode for

query.
[Value Range]
0- Based On Call Type
1- Based On Caller Callee
Output Parameters
ACK: LIST PPS VIRTUALCLI: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-91 Description of the output parameters of: LIST PPS VIRTUALCLI
Parameter
RETN
Description
1011 - The service provider does not exist..
2101 - Service provider Bill or INAP flag is not set.

DESC
Issue 01 (2008-01-28)

operation.
2-83

Parameter
Description
ATTR
countryCode& areaCode& calledNumSeg& callType& vCligGenMet&
vCliNum& sendClingNumFlag& vCalleeFlag
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS VIRTUALCLI: SPID=1, DISPMODE=1
2.4.26 Querying Holiday Category Settings

Command Name
LIST PPS HOLIDAYCAT
Command Function
This command is used to query the holiday category settings at service provider level.
Input Parameters
LIST PPS HOLIDAYCAT: SPID =
Table 2-92 Description of the input parameters of: LIST PPS HOLIDAYCAT
2-84
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
-1 is default.
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS HOLIDAYCAT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-93 Description of the output parameters of: LIST PPS HOLIDAYCAT
Parameter
RETN
Description
1021- The service public parameter does not exist.

DESC
ATTR

operation.
spId& spName& startDay& endDay& holidayCat
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS HOLIDAYCAT: SPID =123
2.4.27 Querying Abbreviated Account Screen Numbers

Command Name
LIST PPS ABBRACCSCR
Issue 01 (2008-01-28)
2-85

Command Function
This command is used to query the abbreviated account screen numbers at service provider
level.
Input Parameters
LIST PPS ABBRACCSCR: SPID =
Table 2-94 Description of the input parameters of: LIST PPS ABBRACCSCR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS ABBRACCSCR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-95 Description of the output parameters of: LIST PPS ABBRACCSCR
Parameter
Description
RETN

2041: Abbreviated account flag is disbaled at service provider level.
2042: Abbreviated Screen Type is disabled at Service Provider level

DESC
ATTR

operation.
spId& spName& countryCode& screenNumber& screenType
2-86
RESULT
TOTAL
FINISHED

0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
Description
SN

NUMOF
Example
LIST PPS ABBRACCSCR: SPID =123
2.4.28 Querying Statistics Called/Callee Number Settings

Command Name
LIST PPS STATCLIDST
Command Function
This command is used to query the settings of called/callee number statistics.
Input Parameters
LIST PPS STATCLIDST: SPID =
Table 2-96 Description of the input parameters of: LIST PPS STATCLIDST
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
Output Parameters
ACK: LIST PPS STATCLIDST: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-97 Description of the output parameters of: LIST PPS STATCLIDST
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

2-87

Parameter
Description
ATTR
spId& spName& clidNumber& categoryFlag
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS STATCLIDST: SPID =123
2.4.29 Querying Route Information

Command Name
LIST PPS ROUTEINFO
Command Function
This command is used to list the routing information at service provider level.
Input Parameters
LIST PPS ROUTEINFO: SPID=,
Table 2-98 Description of the input parameters of: LIST PPS ROUTEINFO
2-88
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS ROUTEINFO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-99 Description of the output parameters of: LIST PPS ROUTEINFO
Parameter
RETN
Description
2211: Serve level configuration is not set at sp level.
2271: Serve Level Range Is Not Configured For The Service Provider.

DESC
ATTR

operation.
serveLevel&countryCode&areaCode&startTime&
endTime&callType&adjustChargeClass& outgoingPrefix&CalledNumber
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS ROUTEINFO: SPID=1234,
2.5 Product Management

2.5.1 Listing Products
Command Name
LIST PPS PRODUCT
Issue 01 (2008-01-28)
2-89

Command Function
The command is used to list all products.
Input Parameters
LIST PPS PRODUCT: [SPID =,] [BATCH =]
Table 2-100 Description of the input parameters of: LIST PPS PRODUCT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
BATCH
It is the unique
identifier of a batch.
[Value Range]
It is a alphanumerical string of 1 to
10 digits, containing az or AZ or
09.
Output Parameters
ACK: LIST PPS PRODUCT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-101 Description of the output parameters of: LIST PPS PRODUCT
Parameter
Description
RETN

DESC

operation.
ATTR
SPID& PRODUCTID& PRODUCTNAME
RESULT
TOTAL
FINISHED
SN
2-90
0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
Description
NUMOF
Example
LIST PPS PRODUCT: SPID = 123, BATCH = 1234
2.5.2 Counting the Total Number of Products

Command Name
COUNT PPS PRODUCT
Command Function
This command is used to count all products of a specified SP.
Input Parameters
COUNT PPS PRODUCT: SPID =
Table 2-102 Description of the input parameters of: COUNT PPS PRODUCT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
Output Parameters
ACK: COUNT PPS PRODUCT: RETN =, DESC = [, TOTAL =]
Table 2-103 Description of the output parameters of: COUNT PPS PRODUCT
Parameter
RETN
Description
DESC
TOTAL
Issue 01 (2008-01-28)

operation.
2-91

Example
COUNT PPS PRODUCT: SPID = 123
2.5.3 Querying Relevant Information of Products

Command Name
DISP PPS PDTINFO
Command Function
This command is used to query relevant information of a product owned by a specified SP.
Input Parameters
DISP PPS PDTINFO: SPID =, PRODUCTID =
Table 2-104 Description of the input parameters of: DISP PPS PDTINFO
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is 2 or an integer in the range 0 to
999.
Output Parameters
ACK: DISP PPS PDTINFO: RETN =, DESC = [, TOTAL=, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-105 Description of the output parameters of: DISP PPS PDTINFO
Parameter
Description
RETN

DESC
ATTR
2-92

operation.
Issue 01 (2008-01-28)

Parameter
Description
PRODUCTID& PRODUCTNAME& PREFIXOFBILL&
CHARGERULE& MNTCOSTFLAG& MNTCOST&
MINLENOFCARD& MAXLENOFCARD& MINLENOFPIN&
MAXLENOFPIN& BINDFLAG& CURRENCYTYPE&
ENABLEFLAG& URBANVALUE& INTERURBANVALUE&
INTERNATIONALVALUE& CPPVALUE& STARTDATE&
PREWARNING& ACMACCMAXALLOW& CREINFANCFLAG&
TIMEZONEFG& TIMEZONE& MAXCALLFLAG& MAXCALLS&
LOCDISCOUNT& NATDISCOUNT& INTERDISCOUNT&
CREATEDATE& CARDTYPE& SERVICEID& UBPFLAG&
CHARGEPACKAGEFLG& MINRECHARGELIMIT&
MAXRECHARGELIMIT& LIMITFORLCALL& LIMITFORNCALL&
LIMITFORICALL& FUNCTIONFLG& LOCALCALLBTYPE&
MDTIME& MDFIRSTINTERVAL& MDINTERVAL&
MDCALLTIMES& BANKFEID
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS PDTINFO: SPID = 123, PRODUCTID = 345
2.5.4 Querying the Access Codes Distributed to Products

Command Name
LIST PPS PDTACSCODE
Command Function
This command is used to query the access code distributed to a product. If only SPID is
entered, the system queries the access codes of all products of the specified SP. If both SPID
and product ID is entered, the system queries the access code of the specified product of the
specified SP.
Input Parameters
LIST PPS PDTACSCODE: SPID = [, PRODUCTID =]
Issue 01 (2008-01-28)
2-93

Table 2-106 Description of the input parameters of: LIST PPS PDTACSCODE
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
Output Parameters
ACK: LIST PPS PDTACSCODE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-107 Description of the output parameters of: LIST PPS PDTACSCODE
Parameter
Description
RETN

DESC

operation.
ATTR
PRODUCTID& PRODUCTNAME& ACCESSCODE& PRIMSGGRP&
SNDMSGGRP& T1M& T4& WELCOMEMSGFLAG&
WELCOMEMSG& CALLBACKDELAY& ACCFUNCFLG&
USEFLAG& FUNCTREEID& FUNCTREENAME
RESULT
TOTAL
FINISHED

2-94
0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS PDTACSCODE: SPID = 123, PRODUCTID = 1234
2.5.5 Modifying Product Parameters

Command Name
MODI PPS PDTPARA
Command Function
This command is used to modify the product level parameters of a specified product.
Input Parameters
MODI PPS PDTPARA: SPID =, PRODUCTID = [, LOCALDISCOUNT=] [,
NATIONALDISCOUNT =] [, INTERDISCOUNT =]
Table 2-108 Description of the input parameters of: MODI PPS PDTPARA
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is 2 or an integer in the range 0
to 999.
LOCALDISCOUNT
It is the discount for

local calls.
[Value Range]
100.
NATIONALDISCOUNT

national calls.
[Value Range]
100.
INTERDISCOUNT

international calls.
[Value Range]
100.
Output Parameters
ACK: MODI PPS PDTPARA: RETN =, DESC =
Table 2-109 Description of the output parameters of: MODI PPS PDTPARA
Parameter
Description
RETN

Issue 01 (2008-01-28)
2-95

Parameter
Description
DESC

operation.
Example
MODI PPS PDTPARA: SPID = 123, PDTID = 456, LOCALDISCOUNT = 80,
NATIONALDISCOUNT = 10, INTERDISCOUNT = 11
2.5.6 Querying Product Charge Package

Command Name
LIST PPS PDTCHGPKG
Command Function
This command is used to query the charge package information of a specified product.
Input Parameters
LIST PPS PDTCHGPKG: SPID =, PRODUCTID = [, PACKAGEID =]
Table 2-110 Description of the input parameters of: LIST PPS PDTCHGPKG
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
to 999.
PACKAGEID
It is the unique
identifier of a
product charge
package.
[Value Range]
Output Parameters
ACK: LIST PPS PDTCHGPKG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
2-96
Issue 01 (2008-01-28)

Table 2-111 Description of the output parameters of: LIST PPS PDTCHGPKG
Parameter
Description
RETN

DESC

operation.
ATTR
spName& productName& packageId& packageName& adjustValue&
userChoose
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS PDTCHGPKG: SPID = 1, PRODUCTID = 1, PACKAGEID = 1
2.5.7 Querying the Product Level Parameters Table

Command Name
LIST PPS PDTPARA
Command Function
This command is used to query product level parameter information.
Input Parameters
LIST PPS PDTPARA: SPID = [, PRODUCTID =]
Issue 01 (2008-01-28)
2-97

Table 2-112 Description of the input parameters of: LIST PPS PDTPARA
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
Output Parameters
ACK: LIST PPS PDTPARA: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-113 Description of the output parameters of: LIST PPS PDTPARA
Parameter
Description
RETN

8801: The charging rule for the product of the service provider is not
configured.
DESC
ATTR

operation.
SPID& PRODUCTID& PRODUCTNAME& ENABLEFLAG&
PDTCHARGERULE& CHARGERULENO& CHARGERULENAME&
SENDCLINGNUMFLG& CALLEDSCREENTYPE&
CALLINGSCREENTYPE& PREFIXOFBILL& MAXLENOFDN&
MINLENOFDN& SAMECURRENCYFLG& CURRENCYTYPE&
CURRENCYNAME& DISPLAYUNIT& RATIO& MCOSTFLG&
MINLENOFCARD& MAXLENOFCARD& MINLENOFPIN&
MAXLENOFPIN& MAXNUMOFCARD& PDTPAYTYPE&
USETIMEZONEOFPDT& TIMEZONEOFPDT& BINDINGFLG&
BINDINGMULTICLN& BINDEDPROCESS& GUARDTIME&
AUTOUNBINDINGFLAG& MINBALANCE& SERVICEIDENTIFY&
COUNTRYCODE& CONFIRMINTERFLG& CREDITFLAG&
MINBALFORLCALL& MINBALFORNCALL&
MINBALFORICALL& MINBALFORCCALL& PDTCREDIT&
ALARMTIME& BEEPINTERVAL& BEEPDURATION&
STARTDAYOFMTHLMT& LOCALDISCOUNT&
NATIONALDISCOUNT& INTERDISCOUNT& CREATEDDATE&
MAXCALLFLAG& MAXCALLS& BLOCKEDDATETIME&
FMLSCREENFLAG& NESTCALLFLAG& CARDPREFIXINCDR&
HAVEDATAFLG& CUSTANNONCALLER& CUSTANNONDEST&
2-98
Issue 01 (2008-01-28)

Parameter
Description
PACKETSELVOICEID& UBPFLAG& CHARGEPACKAGEFLG&
BINDRECHARGEFLG& EXPIRERCHRGPERIOD&
BALANCELOWELIMIT& LOCALCALLCHRGTYPE&
NATIONCALLCHRTYPE& OVERSEACALLCHRTYPE&
MINRECHARGELIMIT& MAXRECHARGELIMIT&
LIMITFORLCALL& LIMITFORNCALL& LIMITFORICALL&
FUNCTIONFLG& LOCALCALLBTYPE& MDTIME&
MDFIRSTINTERVAL& MDINTERVAL& MDCALLTIMES&
BANKFEID
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS PDTPARA: SPID = 123
2.5.8 Querying Product Level Calling Category Number Screen

Command Name
LIST PPS CALLCATSCR
Command Function
This command is used to query all the calling category numbers for a specified product, batch
or SP.
Input Parameters
LIST PPS CALLCATSCR: [SPID=][, PRODUCTID =][,BATCHNAME=]
Table 2-114 Description of the input parameters of: LIST PPS CALLCATSCR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Issue 01 (2008-01-28)
2-99

Parameter
Description
Value Range
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCHNAME
It is the unique
Batch Name.
[Value Range]
It is an alphanumerical string of
length 1 to 10, containing az or AZ
or 09.
Output Parameters
ACK: LIST PPS CALLCATSCR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-115 Description of the output parameters of: LIST PPS CALLCATSCR
Parameter
RETN
Description
1011 - The service provider does not exist.
1012: The product does not exist
1014: The batch does not exist.

DESC
ATTR

operation.
spID& spName& productID& productName& batchName&
callingCategory
2-100
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS CALLCATSCR: SPID=1234, PRODUCTID =12
Or
LIST PPS CALLCATSCR: BATCHNAME=aaa
2.5.9 Querying Access Code and Nested Call Methods Distributed

at Product Level
Command Name
LIST PPS NESTCALL
Command Function
This command is used to query all the access code and nested call methods associated with a
product and SP.
Input Parameters
LIST PPS NESTCALL: SPID=, PRODUCTID =
Table 2-116 Description of the input parameters of: LIST PPS NESTCALL
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
Output Parameters
ACK: LIST PPS NESTCALL: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-117 Description of the output parameters of: LIST PPS NESTCALL
Parameter
RETN
Description
1011 - The service provider does not exist.

2141: Product level Invoke Non PPS Services Flag is disabled.
Issue 01 (2008-01-28)
2-101

Parameter
Description
DESC

operation.
ATTR
spID& spName&productID&productName& accessCode&nestcallMTD
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS NESTCALL: SPID=1234, PRODUCTID =12
2.5.10 Querying Callee and Time Based Message Setting

Command Name
LIST PPS CALLEETMMSG
Command Function
This command is used to query callee and time based message setting.
Input Parameters
LIST PPS CALLEETMMSG: SPID=, PRODUCTID =
Table 2-118 Description of the input parameters of: LIST PPS CALLEETMMSG
2-102
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
identifier of a
product.

999.
Output Parameters
ACK: LIST PPS CALLEETMMSG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-119 Description of the output parameters of: LIST PPS CALLEETMMSG
Parameter
RETN
Description
1012: The product does not exist.
2151: Product level callee and time based message flag is disabled.

DESC
ATTR

operation.
productID&spID&spName&productName&countryCode&
calledNumber&timeIndex&messageID&interruptableFlag
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CALLEETMMSG: SPID=12, PRODUCTID =12
Issue 01 (2008-01-28)
2-103

2.5.11 Querying the Product Level Familiarity Number

Configuration
Command Name
LIST PPS FAMILYNUMSCR
Command Function
This command is used to query product level familiarity number configuration.
Input Parameters
LIST PPS FAMILYNUMSCR: SPID =, PRODUCTID=;
Table 2-120 Description of the input parameters of: LIST PPS FAMILYNUMSCR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
Output Parameters
ACK: LIST PPS FAMILYNUMSCR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-121 Description of the output parameters of: LIST PPS FAMILYNUMSCR
Parameter
Description
RETN

2161: Product level familiarity number screen type flag is not enabled

DESC
ATTR

operation.
spID& spName& productID& productName& screenNumber&
2-104
Issue 01 (2008-01-28)

Parameter
Description
screenType
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS FAMILYNUMSCR: SPID = 123, PRODUCTID = 11;
2.5.12 Querying the Product Level Caller and Time based

Message Settings
Command Name
LIST PPS CLRTIMMSG
Command Function
This command is used to query product level message ID configuration corresponding to the
time index and Calling Number.
Input Parameters
LIST PPS CLRTIMMSG: SPID =, PRODUCTID=;
Table 2-122 Description of the input parameters of: LIST PPS CLRTIMMSG
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
Issue 01 (2008-01-28)
2-105

Output Parameters
ACK: LIST PPS CLRTIMMSG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-123 Description of the output parameters of: LIST PPS CLRTIMMSG
Parameter
RETN
Description
2171: Product level caller and time based message flag is disabled.

DESC
ATTR

operation.
spID& spName& productID& productName& callingNumber&
timeIndex& messageID& interruptableFlag
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CLRTIMMSG: SPID = 123, PRODUCTID = 11;
2-106
Issue 01 (2008-01-28)

2.6 Batch Management

2.6.1 Listing Batches
Command Name
LIST PPS BATCH
Command Function
This command is used to list all batches of a product of an SP. If the operator enters the start
date and end date, the system queries the batch information of the specified product during the
specified time segment. Else, the system queries all batch information of the specified product
of the specified SP.
Input Parameters
LIST PPS BATCH: [SPID =] [, PRODUCTID =] [, BATCH =] [, STARTDATE =] [,
ENDDATE =] [, PROBATIONFLAG =]
Table 2-124 Description of the input parameters of: LIST PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
It is an alphanumerical string
containing az or AZ or 09.
STARTDATE
It is the start date of

the validity period
of the created batch
of cards.
[Value Range]
It is a value smaller than or equal to the
end date, in the format of
YYYYMMDD.
ENDDATE
It is the end date of

the validity period
of cards.
[Value Range]
It is a value greater than or equal to the
start date, in the format of
YYYYMMDD.
PROBATIONFLAG
It is the probation
card.
[Value Range]
0: No
Issue 01 (2008-01-28)
1: Yes
2-107

Output Parameters
ACK: LIST PPS BATCH: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-125 Description of the output parameters of: LIST PPS BATCH
Parameter
RETN
Description
2701: The date is disabled.
2702: The service provider does not have the product.
2703: The product of the service provider does not have the batch.
2704: The service provider does not have the batch.
2705: The product does not have the batch.

DESC
ATTR

operation.
SPID& PRODUCTID& BATCHDESC& BATCH& AREA&
CARDVALUE& TOTALCARD& TOTALVAL& MINSN& MAXSN&
TEMPLATE& TYPE& SDUID& CURRENCYNAME& CARDTYPE&
EXPIDATE& MINCARDNUMBER& MAXCARDNUMBER&
CURRENCYTYPE& DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BATCH: SPID = 123, PRODUCTID = 234
2-108
Issue 01 (2008-01-28)

2.6.2 Counting Batches

Command Name
COUNT PPS BATCH
Command Function
This command is used to count the batches of a product of an SP. If the operator enters the
start date and end date, the system counts the batches of the specified product during the
specified time segment. Else, the system counts all batches of the specified product of the
specified SP.
Input Parameters
COUNT PPS BATCH: SPID =, PRODUCTID = [, STARTDATE =] [, ENDDATE =]
Table 2-126 Description of the input parameters of: COUNT PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
to 999.
STARTDATE

the validity period
of cards.
[Value Range]
It is a value smaller than or equal to
the end date, in the format of
YYYYMMDD.
ENDDATE

the validity period
of cards.
[Value Range]
It is a value greater than or equal to
the start date, in the format of
YYYYMMDD.
Output Parameters
ACK: COUNT PPS BATCH: RETN =, DESC = [, TOTAL =]
Table 2-127 Description of the output parameters of: COUNT PPS BATCH
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

operation.
2-109

Parameter
TOTAL
Description
Example
COUNT PPS BATCH: SPID = 123, PRODUCTID = 234
2.6.3 Querying Batch

Command Name
DISP PPS BATCH
Command Function
This command is used to list the information of a batch of cards belonging to an SP.
Input Parameters
DISP PPS BATCH: SPID = [, PRODUCTID =], BATCH =
Table 2-128 Description of the input parameters of: DISP PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: DISP PPS BATCH: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
2-110
Issue 01 (2008-01-28)

Table 2-129 Description of the output parameters of: DISP PPS BATCH
Parameter
Description
RETN

DESC

operation.
ATTR
BATCH& BATCHDESC& DAILYLIMITTYPE& DAILYLIMIT&
MONTHLYLIMITFLAG& MONTHLYLIMIT& ENABLEDATE&
MESSAGEID& CALLEDSCREENTYPE& CALLINGSCREENTYPE&
PERIODA& PERIODB& DISCOUTFGPERCALLTYPE&
LOCALDISCOUNT& NATIONALDISCOUNT& INTERDISCOUNT&
BEGIN_DATE& EXPIRE_DATE& MINSN& MAXSN&
CARD_TYPE& CARD_MASK& GEN_TYPE& MINCARDNO&
MAXCARDNO& TOTAL_COUNT& CARDACCOUNT&
TOTALACCOUNT& AREAID& CURRENCYTYPE&
PROBATIONFLAG& SPID& SPNAME& PRODUCTID&
PRODUCTNAME& TIMEUNIT
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS BATCH: SPID = 123, PRODUCTID = 234, BATCH = 345
2.6.4 Querying Batch Discount

Command Name
DISP PPS BATCHDISCOUNT
Issue 01 (2008-01-28)
2-111

Command Function
This command is used to query batch discount of a product for an SP.
Input Parameters
DISP PPS BATCHDISCOUNT: [SPID =,] [PRODUCTID =,] [BATCH =,]
[CURRENCYTYPE =]
Table 2-130 Description of the input parameters of: DISP PPS BATCHDISCOUNT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
It is an alphanumerical string containing
az or AZ or 09.
CURRENCYTYPE
It is the currency
type
[Value Range]
Output Parameters
ACK: DISP PPS BATCHDISCOUNT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-131 Description of the output parameters of: DISP PPS BATCHDISCOUNT
Parameter
Description
RETN

DESC
ATTR

operation.
BATCH& CURRENCYTYPE& COUNTRYCODE& AREACODE&
CALLEDNUMBER& DISCOUNTRATE
RESULT
2-112
Issue 01 (2008-01-28)

Parameter
Description
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS BATCHDISCOUNT: BATCH = 123, CURRENCYTYPE = 1
2.6.5 Querying the Batch Level Parameters Table

Command Name
DISP PPS BATCHPARA
Command Function
This command is used to query batch level parameter information.
Input Parameters
DISP PPS BATCHPARA: BATCH =
Table 2-132 Description of the input parameters of: DISP PPS BATCHPARA
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: DISP PPS BATCHPARA: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-133 Description of the output parameters of: DISP PPS BATCHPARA
Parameter
Description
RETN
Issue 01 (2008-01-28)
2-113

Parameter
Description
DESC
ATTR

operation.
PRODUCTNAME& SPNAME& USERIDENTIFIER& BATCH&
MESSAGEID& CALLEDSCREENTYPE& CALLINGSCREENTYPE&
ENABLEFLAG& PERIODA& PERIODB& INTERRUPTIBLEFLAG&
DAILYLIMITTYPE& DAILYLIMIT& MONTHLYLIMITFLAG&
MONTHLYLIMIT& BINDCALLINGSCRFLG& BINDCATSCRFLG&
CALLTYPESCREEN& INTERNATIONALCALL&
NATIONALCALL& LOCALCALL& CPPURBANCALL&
CPPINTERURBANCALL& BLOCKEDDATETIME&
NESTCALLFLAG& DESTBLACKLISTFLG& MODPINFLG&
BASECHGCLS& EXTCHGCLS1& EXTCHGCLS2&
CHGCURRENCYTYPE& CURRENCYID& CURRENCYNAME&
HAVEDATAFLG& INUSEDDAYSFLG& INUSEDDAYSPERCYL&
INUSEDDAYSMSGID& AUTHPINFLG& FUNCTREEID&
FUNCTREENAME& BATCHFUNCFLG& TIMESCREENINDEX&
TIMEINDEX& TIMESEGNAME& ABBRDIALONBTHFLG&
CUSTANNONTIME& MAXCALLTIMES& SETLANGVOICEID&
SERVICEKEY1& SERVICEKEY2& SERVICEKEY3&
SERVICEKEY4& SERVICEKEY5& SERVICEKEY6&
SERVICEKEY7& SERVICEKEY8& TOSECONDFLAG
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS BATCHPARA: BATCH = 000001
2-114
Issue 01 (2008-01-28)

2.6.6 Creating a Batch of Cards

Command Name
CREATE PPS BATCH
Command Function
This command helps you to create a batch of cards of a particular product for a SP.
Input Parameters
CREATE PPS BATCH: SPID =, PRODUCTID =, AREAID =, SDUID =, BATCH =,
BATCHDESC =, TEMPLATEID =, QUANTITY = [, FACEVALUE =], CURRENCY =,
METHOD = [, INITCARDNO =], PROBATIONFLAG = [, PROBATIONBAL =],
STARTDATE = [, ENDDATE =], AUTODELFLAG =, DISPLAYCLIFLG = [, GSNHEAD =],
CARDMASK =, PINMASK = [, DIRECTDIALPSTN =], CALLTYPESCR =,
CLNCATSCRFLAG = [, SIMCALLFLAG =] [, DMLIMITFLAG =] [,BONUSFLAG =] [,
BONUSTEMPLATEID =] [, MAINCARDNO =] [, PERIODBONUS =] [,
RECHARGINGFLG =] [, UBPFUNCFLG =] [,SMFLAG=][, SENDDURATIONFLAG=][,
SENDCOSTFLAG=][, SENDBALFLAG=][, CALLFUNCFLAG=][, MESSFUNCFLAG=]
Table 2-134 Description of the input parameters of: CREATE PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
AREAID
It is the ID of the
area to which the
card belongs.
[Value Range]
99999999.
SDUID
It is the node
number of the SDU.

65535.
BATCH
It is the unique
[Value Range]
BATCHDESC
It is the description
of the batch.
[Value Range]
It is a character string of 255 digits
TEMPLATEID
It is the template ID.
[Value Range]
268435455
QUANTITY
It is the number of
issued cards.
[Value Range]
FACEVALUE
It is the card face
[Value Range]
Issue 01 (2008-01-28)
2-115

Parameter
Description
Value Range
value.

268435455
CURRENCY
It is the currency
type defined in the
system currency
definition table.
[Value Range]
METHOD
It is the method of
card creation.
[Value Range]
0: indicating sequence
INITCARDNO
It is the start card

number of a batch of
cards.
[Value Range]
PROBATIONFLAG
It is the flag of
probation cards.
[Value Range]
0: not probation card
PROBATIONBAL
1: probation card
It is the usable call

duration (seconds)
for the probation
card.
[Value Range]
STARTDATE

service.
[Value Range]
It is in the format of YYYYMMDD
or in the format of
YYYYMMDDHHMMSS
ENDDATE

service.
[Value Range]
It is in the format of YYYYMMDD
or in the format of
YYYYMMDDHHMMSS
AUTODELFLAG
It is the flag of
automatic deletion.
[Value Range]
0: No

2147483647
It is available when the
PROBATIONFLAG is set to 1.
DISPLAYCLIFLG
2-116
1: indicating random
1: Yes
It is the flag
indicating whether
to display the calling
number on the
telephone set of the
called number.
[Value Range]
GSNHEAD
It is the head of the

card number.
[Value Range]
It is an alphanumerical string of 0 to
16 digit containing az or AZ or 09.
CARDMASK
It is the mask of the

card.
[Value Range]
20 digit containing 09 or x.
0: according to the product level

setting
1: Yes, display the caller
2: No, do not display the caller
Issue 01 (2008-01-28)

Parameter
Description
Value Range
PINMASK
It is the mask of the

password.
[Value Range]
It is an alphanumerical string of 1 to 8
digit containing 09 or x.
DIRECTDIALPSTN
It is the direct dial

PSTN number.
[Value Range]
digits, and is enabled when the called
screen type is set to 3.
CALLTYPESCR
It is the calling type

screen.
[Value Range]
0: No
CLNCATSCRFLAG
SIMCALLFLAG
DMLIMITFLAG
BONUSFLAG
It is the flag
indicating calling
category screen.
1: Yes
[Value Range]
0: None
1: Permitted
2: Restricted
It is the flag
indicating
simultaneous call.
[Value Range]
It is the flag
indicating monthly
limit and daily limit.
[Value Range]
It is the flag
indicating whether
the batch cards have
bonus cards.
[Value Range]
0: not bonus cards
0: No
1: Yes
It is a character.
The value 0 indicates card level.
1: bonus cards
The default value is 0 when it is not

set.
BONUSTEMPLATEID
MAINCARDNO
Issue 01 (2008-01-28)
It is the bonus
template ID.
It is the flag
indicating whether
the account is a
main-account or
child-account.
[Value Range]

268435455
It is enabled when BONUSFLAG

is set to 1.
[Value Range]
digits.
2: The card is neither main account

nor child account
1: The card is main account
Others: The card is child account,

and the parameter indicates the
cards main-account.
The default value is 2 when the

parameter does not exist.
2-117

Parameter
Description
Value Range
PERIODBONUS
It is the validity
period presented to
end users.
[Value Range]

32767
The unit is day.

RECHARGINGFLG
It is the flag
indicating the
recharge card.
[Value Range]
0: one-off recharge card
1: multi-time recharge card
2: non-recharge card

UBPFUNCFLG
It is the flag
indicating whether
to support the UBP
function.
[Value Range]
0: No
1: Yes

SMFLAG
It is the flag
indicating whether
to support the short
message function.
[Value Range]
0: No
1: Yes

It is enabled when
CALLFUNCFLAG is set to 1 and
the product supports the short
message function.
When it is set to 1, at least one of
SENDDURATIONFLAG,
SENDCOSTFLAG or
SENDBALFLAG must be set to 1.
SENDDURATIONFL
AG
It is the flag
indicating whether
to send the call
duration.
[Value Range]
0: No
1: Yes

It is enabled when SMFLAG is set to
1.
SENDCOSTFLAG
It is the flag
indicating whether
to send the call cost.
[Value Range]
0: No
1: Yes

1.
SENDBALFLAG
2-118
It is the flag
indicating whether
to send the card
[Value Range]
No
Issue 01 (2008-01-28)

Parameter
Description
Value Range
balance.
1: Yes

1.
CALLFUNCFLAG
It is the flag
indicating whether
the card supports the
call function.
[Value Range]
0: No
1: Yes

MESSFUNCFLAG
It is the flag
indicating whether
to support the voice
message function.
[Value Range]
0: No
1: Yes

It is enabled when
the product supports the voice
message function.
Output Parameters
ACK: CREATE PPS BATCH: RETN =, DESC =
Table 2-135 Description of the output parameters of: CREATE PPS BATCH
Parameter Name
Description
RETN
Refers to the return value of the command.

It is a numeric string of 1 to 5 digits.
Issue 01 (2008-01-28)
5401: The batch has already existed.
5402: The template does not exist.
5403: The template does not belong to the service provider.
5404: The binding flag of the product must be unrestricted or

close when license does not support calling binding feature.
5405: The binding flag of the product must be unrestricted or

close when the service provider does not support calling
binding feature.
5406: The template parameter is disabled: the card type does

not exist.
5407: The template parameter is disabled: the card type of the

probation card should be 0 or 2 or 4 or 6 or 8 or A.
5408: The template parameter is disabled: the card type

should be 0 or 2 or 4 or 6 or 8 or A, when the service provider
recharge has no recharge feature.
5409: The service provider can not create probation card when
2-119

Parameter Name
Description
the service provider probation feature is None
2-120
5410: The length of the card mask must be X-Y.
5411: The length of the card mask and the pin mask must be
X-Y, when the pinflag is 1.
5412: The length of the pin mask must be X-Y.
5413: The length of the batch name must be X-Y.
5414: The template parameter is disabled: the card blacklist

clear time must be 1999999999 when card blacklist clear
flag is 1.
5415: The template parameter is disabled: the government tax

rate must be 0100000.
5416: The template parameter is disabled: the maxcalls must

be null when maxcallflag is 0.
5417: The template parameter is disabled: the maxcalls must

be 110 when maxcallflag is 1.
5418: The template parameter is disabled: the credit limit

must be 065535.
5419: The template parameter is disabled: the maximum

recharge times must be 02147483647.
5420: The template parameter is disabled: the familiarity

number discount must be 0100 when the familiarity number
flag is 1.
5421: The template parameter is disabled: the maximum

familiarity number must be 010 when the familiarity number
flag is 1.
5422: The template parameter is disabled: the validity period

type must be 04.

must be 0 when the validity period type is 0 or 4.

must be 11000 when the validity period type is 1 or 2 or 3.
5425: The template parameter is disabled: the daily limit type

must be 02.
5426: The template parameter is disabled: the monthly limit

flag must be 01.
5427: The template parameter is disabled: the daily limit must

be 1268435455 when the daily limit type is 1 or 2.

must be 1268435455 when the monthly limit flag is 1.
5429: The template parameter is disabled: the play duration

available flag must be 01.
5430: The template parameter is disabled: the play balance

flag must be 08.

flag must be 01.
5432: The template parameter is disabled: the play cost flag
Issue 01 (2008-01-28)

Parameter Name
Description
must be 01.
Issue 01 (2008-01-28)
5433: The template parameter is disabled: the play new

balance flag must be 08.

can not be less than the daily limit when the monthly limit
flag and the daily limit type are all 1.

must be 1 when the play balance flag is 3 or 6.

must be 1 when the play new balance flag is 3 or 6.

flag must be 1 when the play balance flag is 4 or 7.

flag must be 1 when the play new balance flag is 4 or 7.

flag or the daily limit type must be 1 when the play new
balance flag is 5 or 8.

flag or the daily limit type must be 1 when the play balance
flag is 5 or 8.

flag and the play cost flag can not be set to 1 at the same time
when the play new balance flag is not 0.
5442: The template parameter is disabled: the maxcallflag

must be 01.
5443: The template parameter is disabled: the card black clear

flag must be 01.
5444: The template parameter is disabled: the face value must

be 0268435455.
5445: The template parameter is disabled: the called screen

type must be 03.
5446: The template parameter is disabled: the discount rate

must be 0255 when the probation flag is 0.
5447: The template parameter is disabled: the beep flag must

be 03.
5448: The template parameter is disabled: the calling screen

type must be 02.
5449: The template parameter is disabled: the bind flag must

be 01.
5450: The template parameter is disabled: the accumulate flag

must be 01.
5451: The template parameter is disabled: the abbr account

flag must be 01.
5452: The template parameter is disabled: the familiarity

number flag must be 01.
5453: The template parameter is disabled: the call type must
2-121

Parameter Name
Description
be 13.
2-122
5454: The template parameter is disabled: the pin flag must be

01.
5455: The template parameter is disabled: the recharge flag

must be 01.
5456: The currency type does not exist.
5457: The currency type must be set in the service provider

charge parameters.
5458: The issue number of one batch card can not exceed the
service limit: X pieces.
5459: The usable card resource of the product is X pieces, it is

not enough to issue the batch cards.
5460: X card(s) have existed in the card number scope

decided by the alterable part of the card mask.
5461: X card(s) have existed in the card number scope

decided by the alterable part of the card mask; it is not enough
to issue the batch cards.
5462: The card number segment for service provider is

disabled.
5463: The card number segment for area is disabled.
5464: The batch card was created and loaded successfully, but
updating the card status failed.
5465: The batch card was created successfully, but loading the
batch card failed.
5466: The batch card was created successfully, but the

password encryption failed because the batch card has not
been loaded.
5467: The currency type must be the same as the currency

type of the product.
5468: Password random number of beginning is the same as

last time.
5469: Have repeat 100 times, exist more special card number.
5470: Have repeat 100 times, can not generate new card
number.
5471: Hash of small batch password is too little.
5472: The most repeat times of password is over 10 times of

average repeat times.
5473: The hash of batch password is too little.
5474: The card type should be 0 or 2 or 4 or 6 or 8 or A, when

the product pay type is 1.
5475: The pay type of the product is postpaid, but the service
does not support postpaid feature.
5476: The pay type of the product is postpaid, but the service
provider does not support postpaid feature.
5477: The card resource of the service is used up.
Issue 01 (2008-01-28)

Parameter Name
Issue 01 (2008-01-28)
Description
5478: The card resource of the service is XX piece(s).
5479: The card resource of the service provider is used up.
5480: The card resource of the service provider is XX

piece(s).
5481: The bind feature card resource of the service is used up.
5482: The bind feature card resource of the service is XX

piece(s).
5483: The accumulate feature card resource of the service is

used up.
5484: The accumulate feature card resource of the service is

XX piece(s).
5485: The abbreviation account feature card resource of the

service is used up.
5486: The abbreviation account feature card resource of the

service is XX piece(s).
5487: The familiarity number feature card resource of the

service is used up.

service is XX piece(s).
5489: The postpaid feature card resource of the service is used

up.
5490: The postpaid feature card resource of the service is XX

piece(s).
5491: The bind feature card resource of the service provider is

used up.
5492: The bind feature card resource of the service provider is

XX piece(s).
5493: The accumulate feature card resource of the service

provider is used up.
5494: The accumulate feature card resource of the service

provider is XX piece(s).
5495: The abbr account feature card resource of the service

5496: The abbr account feature card resource of the service


service provider is used up.

service provider is XX piece(s).
5499: The postpaid feature card resource of the service

5900: The postpaid feature card resource of the service

5901: The batch parameter is disabled: the daily limit type

must be 02.
2-123

Parameter Name
Description
5902: The batch parameter is disabled: the monthly limit flag

must be 01.
5903: The batch parameter is disabled: the daily limit must be

1268435455 when the daily limit type is 1 or 2.
5904: The batch parameter is disabled: the monthly limit must

be 1268435455 when the monthly limit flag is 1.

DESC
Refers to the description of the error cause.

It is a string of 0 to 256 characters digits.
Number of cards created should be less than the SP and system level liecense value.
Example
CREATE PPS BATCH: SPID = 123, PRODUCTID = 234, AREAID = 1234, SDUID = 501,
BATCH = 2005031501, BATCHDESC = Fourth, TEMPLATEID = 10, QUANTITY = 200,
FACEVALUE = 100, CURRENCY = 1, METHOD = 0, PROBATIONFLAG = 1,
STARTDATE = 20050101, AUTODELFLAG = 1, DISPLAYCLIFLG = 1, CARDMASK =
10, PINMASK = 20
2.6.7 Activating a Batch of Cards

Command Name
ACTIVATE PPS BATCHCARD
Command Function
This command is used to activate a batch of cards.
Input Parameters
ACTIVATE PPS BATCHCARD: [ SPID=,] BATCH=[, CARDTYPE= ,
STARTSN=,ENDSN=][,EXPTYPE=,EXPDATE=][,BALTYPE=,BALANCE=]
Table 2-136 Description of the input parameters of: ACTIVATE PPS BATCHCARD
2-124
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
BATCH
It is the unique
[Value Range]
CARDTYPE
It is the type of
entering a card.
[Value Range]
1: entering the sequence number
Issue 01 (2008-01-28)

Parameter
Description
Value Range
STARTSN
It is the start
sequence number or
start card number of
a batch.
2: entering the card number
[Value Range]
It indicates the start sequence number
of a batch when CARDTYPE is set to
1. It is an integer in the range 0 to
9999999.
It indicates the start card number of a
batch when CARDTYPE is set to 2. It
is a numeric string of 2 to 20 digits.
ENDSN
It is the end
sequence number or
end card number of
a batch.
[Value Range]
It indicates the end sequence number
1. It is an integer in [0, 9999999].
It indicates the end card number of a
EXPTYPE
EXPDATE
It is the type of
expiry date.
It is the expiry date

of the card.
[Value Range]
0: earlier than the expiry date
1: equal to the expiry date
2: earlier than or equal to the expiry

date
3: later than the expiry date
4: later than or equal to the expiry

data
[Value Range]
It is a numeric string of 8 digits.
Format: YYYYMMDD
BALTYPE
BALANCE
It is the type of card

balance.
It is the card
balance.
[Value Range]
0: less than the balance

1: equal to the balance

2: less than or equal to the balance
3: more than the balance
4: more than or equal to the balance
[Value Range]
268435455.
Output Parameters
ACK: ACTIVATE PPS BATCHCARD: RETN =, DESC = [, TOTAL=, FINISHED=, SN=,
Issue 01 (2008-01-28)
2-125

Table 2-137 Description of the output parameters of: ACTIVATE PPS BATCHCARD
Parameter Name
Description
RETN

3201: No card need to be activated according to the condition.
3202: The cards' data of the batch does not accord with SDU,
please activate the cards of the batch using SMAP.
3203: The cards of batch can not be activated, because the

number of activated cards has reached upper limit.
3204: The cards of batch can not be activated, because the PPS
service can allow only another X such cards to be activated.

number of activated cards with caller binding feature has
reached upper limit.
3206: The cards with caller binding feature of batch can not be
activated, because the PPS service can allow only another X
such cards to be activated.

number of activated cards with accumulated usage bonus
feature has reached upper limit.
3208: The cards with accumulated usage bonus feature of batch

can not be activated, because the PPS service can allow only
another X such cards to be activated.

number of activated cards with abbreviation account feature has
3210: The cards with abbreviation account feature of batch can

not be activated, because the PPS service can allow only

number of activated cards with familiarity number feature has
3212: The cards with familiarity number feature of batch can

not be activated, because the PPS service can allow only

number of activated cards with postpaid feature has reached
upper limit.
3214: The cards with postpaid feature of batch can not be

activated, because the PPS service can allow only another X
such cards to be activated.

DESC
2-126

Issue 01 (2008-01-28)

Parameter Name
Description
ATTR

ERRORID& ERRORINFO
RESULT
TOTAL

integer.
SN
Refers to the flag indicating whether the stop command is run.

0: No
1: Yes
2: Returned in the first batch
NUMOF
Refers to the number of successful operations.
FINISHED

0: No
1: Yes
Number of cards created should be less than the SP and system level liecense value.
Example
ACTIVATE PPS BATCHCARD: SPID = 123, BATCH = 456
2.6.8 Deactivating a Batch of Cards

Command Name
DEACTIVATE PPS BATCH
Command Function
This command is used to deactivate cards in batches.
Input Parameters
DEACTIVATE PPS BATCH: [SPID=], BATCH=[, CARDTYPE= ,
Table 2-138 Description of the input parameters of: DEACTIVATE PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Issue 01 (2008-01-28)
2-127

Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
CARDTYPE
It is the type of
entering a card.
[Value Range]
STARTSN
It is the start
sequence number or
a batch.
[Value Range]
1.It is an integer in [0. 9999999].
ENDSN
It is the end
sequence number or
end card number of
a batch.
[Value Range]
1. It is an integer in [0, 9999999].
EXPTYPE
EXPDATE
BALTYPE
BALANCE
2-128
It is the type of
expiry date.
[Value Range]

date

data

of the card.
[Value Range]

balance
[Value Range]
It is the card
balance.

the format of YYYYMMDD.

[Value Range]
268435455.
Issue 01 (2008-01-28)

Output Parameters
ACK: DEACTIVATE PPS BATCH: RETN =, DESC =[, TOTAL=, FINISHED=, SN=,
Table 2-139 Description of the output parameters of: DEACTIVATE PPS BATCH
Parameter
RETN
Description
DESC
ATTR

operation.
ERRORID& ERRORINFO
RESULT
TOTAL
FINISHED
SN
NUMOF
0: No
1: Yes
It is the flag indicating whether the stop command is run.

0: No
1: Yes
Example
DEACTIVATE PPS BATCH: SPID = 123, BATCH = 456
2.6.9 Modifying a Batch of Cards

Command Name
MODI PPS BATCH
Command Function
This command is used to modify a batch of cards of a specified product for an SP.
Issue 01 (2008-01-28)
2-129

Input Parameters
MODI PPS BATCH: SPID = [, PRODUCTID=], BATCH = [,CARDBLKCLEARFLAG=]
[,CARDBLKCLEARTIME=] [,PLYDURATIONAVAILFG=] [,PLYBALANCEFLAG=]
[,PLYDURATIONFLAG=] [,PLYCOSTFLAG=] [,PLYNEWBALFLAG=]
[,SERVICESTART=] [,SERVICESTOP=] [,MONTHLYLIMITFLAG=]
[,MONTHLYLIMIT=] [,DAILYLIMITTYPE=] [,DAILYLIMIT=] [,MAXCALLFLAG=]
[,MAXCALLS=] [,CALLEDSCREENTYPE=] [,DIRECTDIALPSTN=]
[,CALLINGSCREENTYPE=] [,VALIDITYPERIODTYPE=] [,VALIDITYPERIOD=]
[,ENABLEFLAG =] [,AUTODELFLAG=] [, DISCOUNTRATE=] [ ,PERIODBONUS =] [,
RECHARGINGFLG =]
Table 2-140 Description of the input parameters of: MODI PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service
provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
identifier of a
batch.
[Value Range]
CARDBLKCLEARFLAG
It is the flag
indicating the
card blacklist
automatic
clearing.
[Value Range]
It is the card
blacklist
clearing time
(in hours).
[Value Range]
It is the flag
indicating the
available
duration
prompt.
[Value Range]
It is the flag
indicating
whether to
give a balance
prompt.
[Value Range]
CARDBLKCLEARTIME
PLYDURATIONAVAILFG
PLYBALANCEFLAG
2-130
0: No
1: Yes

999999999.
0: No
1: Yes
0: not playing
1: playing a balance prompt in any

cases
2: playing a balance prompt when

the card balance is less than the
minimum balance

the card daily limit is less than the
Issue 01 (2008-01-28)

Parameter
Description
Value Range
minimum daily limit

the card monthly limit is less than
the minimum monthly limit

minimum balance, when the card
daily limit is less than the minimum
daily limit, or when the card
monthly limit is less than the
minimum monthly limit

minimum balance, or when the card
daily limit


minimum daily limit, or when the
card monthly limit is less than the
Values 1, 3, 5, 6 and 8 are enabled

only when the daily limit by amount is
enabled.
Values 2, 4, 5, 7 and 8 are enabled
only when the monthly limit by
amount is enabled.
PLYDURATIONFLAG
PLYCOSTFLAG
Issue 01 (2008-01-28)
It is the flag
indicating
whether to
give call
duration
prompt.
[Value Range]
It is the flag
indicating
whether to
give a call fee
prompt.
[Value Range]
0: No
0: No
1: Yes
The parameters
PLYDURATIONFLAG,
PLYCOSTFLAG and
PLYNEWBALFLAG cannot be set
to 1 at the same time.
1: Yes
The parameters
PLYDURATIONFLAG,
PLYCOSTFLAG and
2-131

Parameter
Description
Value Range
PLYNEWBALFLAG
SERVICESTART
SERVICESTOP
It is the flag
indicating
whether to
give a new
balance
prompt.
[Value Range]
0: No
It is the start
date of
validity
period.
[Value Range]
It is the end
date of
validity
period..
[Value Range]
1: Yes
The parameters
PLYDURATIONFLAG,
PLYCOSTFLAG and
It is the current date in the format of

YYYYMMDD or
YYYYMMDDHHMMSS.
It is the current date+ 365 days.

The end date should be later than the
start date.
It is in the format of
YYYYMMDDHHMMSS or
YYYYMMDDHHMMSS.
MONTHLYLIMITFLAG
MONTHLYLIMIT
It is the flag
indicating the
monthly limit.
[Value Range]
0: none
It is the
monthly limit.
[Value Range]
1: money

268435455.
MONTHLYLIMITFLAG is set to 1.
It is disabled for recharge cards.
When DAILYLIMITTYPE is set to 1
(sum of money), the monthly limit
must be equal to or greater than the
daily limit.
DAILYLIMITTYPE
DAILYLIMIT
It is the daily
limit type.
It is the daily
limit.
[Value Range]
0: none
1: sum of money
2: times
[Value Range]
268435455.
DAILYLIMITTYPE is set to 1 or 2.
2-132
Issue 01 (2008-01-28)

Parameter
Description
Value Range
MAXCALLFLAG
It is the flag
indicating the
maximum
follow-on
calls
restriction.
[Value Range]
0: No
MAXCALLS
It is the
maximum
follow-on
calls.
[Value Range]
CALLEDSCREENTYPE
It is the called
screen type.
[Value Range]
0: None
DIRECTDIALPSTN
It is the direct
dial PSTN
number.
1: Yes
1: Permitted
2: Restricted
3: Direct Dial
[Value Range]
digits.
It is enabled when
CALLEDSCREENTYPE is set to 3
(Direct Dial).
CALLINGSCREENTYPE
VALIDITYPERIODTYPE
VALIDITYPERIOD
It is the user
level calling
screen type.
It is the
validity type.
It is the
validity
period.
[Value Range]
0: None
1: Permitted
2: Restricted
[Value Range]
0: fixed validity
1: variable validity and fixed validity
2: validity activated by the card

number
3: variable validity
4: validity period A + validity period

B
[Value Range]
The default value is 365 (days).
The unit of this value is day.
VALIDITYPERIODTYPE is set to
1, 2 or 3.
Issue 01 (2008-01-28)
2-133

Parameter
Description
Value Range
ENABLEFLAG
It is the flag
indicating
whether a card
is blocked.
[Value Range]
0: available
AUTODELFLAG
DISCOUNTRATE
PERIODBONUS
1: not available (set by the SP)
2: not available (set by the

Superadm)
It is the flag
indicating
automatic
deletion.
[Value Range]
0: no automatic deletion
It is the
discount rate
of the charge
rate.
[Value Range]
It is the
validity period
presented to
end users.
[Value Range]
1: automatic deletion

The unit is day.
RECHARGINGFLG
It is the flag
indicating the
recharge card.
[Value Range]
Output Parameters
ACK: MODI PPS BATCH: RETN =, DESC = [, AFFECTED =]
Table 2-141 Description of the output parameters of: MODI PPS BATCH
Parameter
Description
RETN

DESC
AFFECTED
2-134

operation.
It is the total number of success result records.
Issue 01 (2008-01-28)

Example
MODI PPS BATCH: SPID = 123, BATCH = 2005031501
2.6.10 Deleting a Batch of Cards

Command Name
DELE PPS BATCH
Command Function
This command is used to delete all the cards in a batch owned by a specified SP.
Input Parameters
DELE PPS BATCH: [SPID=, ]BATCH=,STATUS=[,CARDTYPE= ,
STARTSN=,ENDSN=][,EXPTYPE=,EXPDATE=][,BALTYPE=,BALANCE=][, DELREA=]
Table 2-142 Description of the input parameters of: DELE PPS BATCH
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
BATCH
It is the unique
[Value Range]
STATUS
It is the status of a
card to be deleted.
[Value Range]
It is a character ,it can have value 1 to
5
Multiple statuses are separated with
an ampersand (&) from each other.
Only cards that are created, unloaded
or overdue can be deleted in batches.
1: Created
2: Loaded
3: Activated
4: Unloaded
5: Overdue
Example: 1&4&5
CARDTYPE
STARTSN
Issue 01 (2008-01-28)
It is the type of
entering a card
number.
[Value Range]
It is the start
sequence number or
[Value Range]
2-135

Parameter
Description
Value Range
a batch.
of a batch when CARDTYPE is set

to 1.It is an integer in [0, 9999999].
batch when CARDTYPE is set to 2.
digits.
ENDSN
It is the end
sequence number or
end card number of
a batch.
[Value Range]
is a numerical string of 2 to 20 digits.
EXPTYPE
EXPDATE
It is the type of
expiry date.

of the card.
[Value Range]

date

data
[Value Range]
It is an numerical string of 8 digits
Format: YYYYMMDD
BALTYPE
BALANCE
DELREA

balance.
[Value Range]
It is the card
balance.
[Value Range]
It is the deletion
reason.
[Value Range]

268435455.

268435455.
Output Parameters
ACK: DELE PPS BATCH: RETN =, DESC = [, TOTAL=, FINISHED=, SN=, NUMOF=,
ATTR=, RESULT=]
2-136
Issue 01 (2008-01-28)

Table 2-143 Description of the output parameters of: DELE PPS BATCH
Parameter
RETN
Description
5601: No card can be deleted in the batch.

5602: Delete batch cards failed.

DESC
ATTR

operation.
ERRORID& ERRORINFO
RESULT
TOTAL
FINISHED
SN
NUMOF
0: No
1: Yes
It is the flag indicating whether the stop command is run.

0: No
1: Yes
It is the number of successful operations.
Example
DELE PPS BATCH: SPID = 123, BATCH = 2005031501
2.6.11 Adding the Caller Binding Category Screen Information

Command Name
ADD PPS BDINGSCRCAT
Command Function
This command is used to add the caller binding category screen information.
Issue 01 (2008-01-28)
2-137

Input Parameters
ADD PPS BDINGSCRCAT: SPID =, PRODUCTID =, BATCH =, CALLINGCATEGORY
=
Table 2-144 Description of the input parameters of: ADD PPS BDINGSCRCAT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
CALLINGCATEGOR
Y
It is the caller
binding category to
be added.
[Value Range]
digits.
Output Parameters
ACK: ADD PPS BDINGSCRCAT: RETN =, DESC =
Table 2-145 Description of the output parameters of: ADD PPS BDINGSCRCAT
Parameter
Description
RETN

3001: The batch does not support the calling binding category screen.
3002: The category has already existed.

DESC

operation.
Example
ADD PPS BDINGSCRCAT: SPID = 123, PRODUCTID = 11, BATCH = 1234,
CALLINGCATEGORY = 123
2-138
Issue 01 (2008-01-28)

2.6.12 Querying the Caller Binding Category Screen Information

Command Name
LIST PPS BDINGSCRCAT
Command Function
This command is used to query the caller binding category screen information.
Input Parameters
LIST PPS BDINGSCRCAT: SPID =, PRODUCTID = [, BATCH =]
Table 2-146 Description of the input parameters of: LIST PPS BDINGSCRCAT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: LIST PPS BDINGSCRCAT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-147 Description of the output parameters of: LIST PPS BDINGSCRCAT
Parameter
RETN
Description
2902: The service provider's product does not have any batch.
1020: The Batch parameter has not been set.

DESC
ATTR
Issue 01 (2008-01-28)

operation.
2-139

Parameter
Description
SPID& PROCUCTID& BATCH& CALLINGCATEGORY&
SCREENTYPE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BDINGSCRCAT: SPID = 123, PRODUCTID = 234, BATCH = 456
2.6.13 Deleting the Caller Binding Category Screen Information

Command Name
DELE PPS BDINGSCRCAT
Command Function
This command is used to delete the caller binding category screen information.
Input Parameters
DELE PPS BDINGSCRCAT: SPID =, PRODUCTID =, BATCH =, CALLINGCATEGORY
=
Table 2-148 Description of the input parameters of: DELE PPS BDINGSCRCAT
2-140
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is -2 or an integer in the range 0 to
999.
BATCH
It is the unique
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
CALLINGCATEGOR
Y
It is the caller
binding category to
be deleted.
[Value Range]
digits.
Multiple calling numbers are separated
with an ampersand (&) from each
other. The single quotation marks and
double quotation marks are needed for
the parameter value.
Output Parameters
ACK: DELE PPS BDINGSCRCAT: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-149 Description of the output parameters of: DELE PPS BDINGSCRCAT
Parameter
RETN
Description
3102: The screen category does not exist.

DESC
ATTR

operation.
RESULT
Example
DELE PPS BDINGSCRCAT: SPID = 123, PRODUCTID = 11, BATCH = 1234,
CALLINGCATEGORY = 123
2.6.14 Adding Batch Abbreviated Numbers

Command Name
ADD PPS BATCHABBR
Issue 01 (2008-01-28)
2-141

Command Function
This command is used to add one or more abbreviated numbers to all card numbers of a batch.
Input Parameters
ADD PPS BATCHABBR: [SPID =,] BATCH =, ABBRNO =, PSTNNUM =
Table 2-150 Description of the input parameters of: ADD PPS BATCHABBR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
BATCH
It is the unique
[Value Range]
ABBRNO
It is the abbreviated
number of a PSTN
number.
[Value Range]
It is an integer in the range 0 to 99,
with multiple abbreviated numbers
being separated with an ampersand
(&) from each other.
If multiple abbreviated numbers are
entered, they must be enclosed by
double quotation marks.
PSTNNUM
It is the actual PSTN

number the
abbreviated number
corresponds to.
[Value Range]
digits, consisting of country code,
area code and local telephone number.
Multiple PSTNNUM are separated
other.
Output Parameters
ACK: ADD PPS BATCHABBR: RETN =, DESC =
Table 2-151 Description of the output parameters of: ADD PPS BATCHABBR
Parameter
Description
RETN

6301: The abbreviated number has already existed.
2-142
Issue 01 (2008-01-28)

Parameter
Description
DESC

operation.
SUCCESS
NUM
It is the number of abbreviated numbers which have been added

successfully.
FAILNUM
It is the number of abbreviated numbers which have not been added

successfully.
FAILINFO
Refers to the information of failure.

The format is ABBRNUM|ERRORNO|ERRORINFO&
ABBRNUM|ERRORNO|ERRORINFO.
Example
ADD PPS BATCHABBR: SPID = 0, BATCH = batch1, ABBRNO = "1", PSTNNUM =
"1211346".
2.6.15 Modifying Batch Abbreviated Numbers

Command Name
MODI PPS BATCHABBR
Command Function
This command is used to modify an abbreviated number of a card for a specified batch.
Input Parameters
MODI PPS BATCHABBR: [SPID =,] BATCH =, ABBRNO =, PSTNNUM =
Table 2-152 Description of the input parameters of: MODI PPS BATCHABBR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
ABBRNO
number of a PSTN
number.
[Value Range]
Issue 01 (2008-01-28)

2-143

Parameter
Description
Value Range
If multiple abbreviated numbers
are entered, they must be enclosed
by double quotation marks.
PSTNNUM

number the
abbreviated number
corresponds to.
[Value Range]
area code and local telephone
number. Multiple PSTNNUM are
separated with an ampersand (&)
from each other.
are entered, they must be enclosed
by double quotation marks.
Output Parameters
ACK: MODI PPS BATCHABBR: RETN =, DESC =
Table 2-153 Description of the output parameters of: MODI PPS BATCHABBR
Parameter
Description
RETN

DESC

operation.
Example
MODI PPS BATCHABBR: SPID = 0, BATCH = batch1, PSTNNUM = 1200433
2.6.16 Querying Batch Abbreviated Numbers

Command Name
LIST PPS BATCHABBR
Command Function
This command is used to query the abbreviated number information of all card numbers of a
specified batch.
2-144
Issue 01 (2008-01-28)

Input Parameters
LIST PPS BATCHABBR: [SPID =,] BATCH = [, PSTNNUM =] [, ABBRNO =]
Table 2-154 Description of the input parameters of: LIST PPS BATCHABBR
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
999.
BATCH
It is the unique
[Value Range]
ABBRNO
number of a PSTN
number.
[Value Range]
PSTNNUM

number the
abbreviated number
corresponds to.
[Value Range]
area code and local telephone
number. Multiple PSTNNUM are
from each other.
Output Parameters
ACK: LIST PPS BATCHABBR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-155 Description of the output parameters of: LIST PPS BATCHABBR
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

2-145

Parameter
Description
ATTR
ABBRNO& PSTNNUM
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BATCHABBR: SPID = 0, BATCH = batch1, ABBRNO = 1
2.6.17 Deleting Batch Abbreviated Numbers

Command Name
DELE PPS BATCHABBR
Command Function
This command is used to delete one or more abbreviated numbers of all card numbers of a
specified batch.
Input Parameters
DELE PPS BATCHABBR: [SPID =,] BATCH = [, ABBRNO =]
Table 2-156 Description of the input parameters of: DELE PPS BATCHABBR
2-146
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
BATCH
It is the unique
[Value Range]
ABBRNO
number of a PSTN
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
number.

Output Parameters
ACK: DELE PPS BATCHABBR: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-157 Description of the output parameters of: DELE PPS BATCHABBR
Parameter
Description
RETN

6401: The abbreviated number does not exist.
DESC
ATTR

operation.
RESULT
Example
DELE PPS BATCHABBR: SPID = 0, BATCH = batch1, ABBRNO = "1&2"
2.6.18 Querying the Batch Level Binding Calling Number Screen

Settings
Command Name
LIST PPS BINDCALLSCR
Command Function
This command is used to query the Binding Calling Number Screen Settings for a batch.
Issue 01 (2008-01-28)
2-147

Input Parameters
LIST PPS BINDCALLSCR: BATCHNAME=
Table 2-158 Description of the input parameters of: LIST PPS BINDCALLSCR
Parameter
Description
Value Range
BATCHNAME
It is the unique
[Value Range]
length 1 to 10 containing az or AZ
or 09.
Output Parameters
ACK: LIST PPS BINDCALLSCR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-159 Description of the output parameters of: LIST PPS BINDCALLSCR
Parameter
Description
RETN

2221: Binding Calling Screen Type flag is not set for this Batch.

DESC
ATTR

operation.
batchName& callingCountryCode& callingScreenNumber&
screentType
2-148
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS BINDCALLSCR: BATCHNAME = 456
2.6.19 Querying the Batch Level Time Based Message Settings

Command Name
QRY PPS TIMEMSG
Command Function
This command is used to query Time Based Message Settings for a Batch.
Input Parameters
QRY PPS TIMEMSG: BATCHNAME=
Table 2-160 Description of the input parameters of: QRY PPS TIMEMSG
Parameter
Description
Value Range
BATCHNAME
It is the unique
[Value Range]
length 1 to 10 containing az or
AZ or 09.
Output Parameters
ACK: QRY PPS TIMEMSG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-161 Description of the output parameters of: QRY PPS TIMEMSG
Parameter
Description
RETN

2231: Time based Message flag is not set for this Batch.

DESC
ATTR
Issue 01 (2008-01-28)

2-149

Parameter
Description
batchName& timeSegmentId& interruptibleFlag& announcementId
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
QRY PPS TIMEMSG: BATCHNAME = 456
2.6.20 Adding Calling Category Screen at Batch Level

Command Name
ADD PPS BATCATSCR
Command Function
This command is used to add the information of the calling category at the batch level.
Input Parameters
ADD PPS BATCATSCR: BATCH =, CALLINGCATEGORY =
Table 2-162 Description of the input parameters of: ADD PPS BATCATSCR
2-150
Parameter
Description
Value Range
BATCH
It is the unique
identifier of a
batch.
[Value Range]
CALLINGCATEGORY
It is the category to
which the calling
number belongs.
[Value Range]
255.
Issue 01 (2008-01-28)

Output Parameters
ACK: ADD PPS BATCATSCR: RETN =, DESC =
Table 2-163 Description of the output parameters of: ADD PPS BATCATSCR
Parameter
RETN
Description
DESC

operation.
Example
ADD PPS BATCATSCR: BATCH = 1234, CALLINGCATEGORY = 123
2.6.21 Querying Calling Category Screen at Batch Level

Command Name
LIST PPS BATCATSCR
Command Function
This command is used to query the information of the calling category screen at the batch
level.
Input Parameters
LIST PPS BATCATSCR: BATCH =
Table 2-164 Description of the input parameters of: LIST PPS BATCATSCR
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: LIST PPS BATCATSCR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Issue 01 (2008-01-28)
2-151

Table 2-165 Description of the output parameters of: LIST PPS BATCATSCR
Parameter
Description
RETN

DESC

operation.
ATTR
USERIDENTIFIER& SPID& PROCUCTID& BATCH&
CALLINGCATEGORY
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BATCATSCR: BATCH = 456
2.6.22 Deleting Calling Category Screen at Batch Level

Command Name
DELE PPS BATCATSCR
Command Function
This command is used to delete the information of the calling category screen at the batch
level.
Input Parameters
DELE PPS BATCATSCR: BATCH = [, CALLINGCATEGORY =]
2-152
Issue 01 (2008-01-28)

Table 2-166 Description of the input parameters of: DELE PPS BATCATSCR
Parameter
Description
Value Range
BATCH
It is the unique
identifier of a
batch.
[Value Range]
CALLINGCATEGORY
It is the category to
which the calling
number belongs.
[Value Range]
Output Parameters
ACK: DELE PPS BATCATSCR: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-167 Description of the output parameters of: DELE PPS BATCATSCR
Parameter
Description
RETN

DESC
ATTR

operation.
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DELE PPS BATCATSCR: BATCH = 1234, CALLINGCATEGORY = 123
Issue 01 (2008-01-28)
2-153

2.6.23 Adding Green Numbers at Batch Level

Command Name
ADD PPS BATGREEN
Command Function
This command is used to add green numbers at the batch level.
Input Parameters
ADD PPS BATGREEN: BATCH=, GREENNUMBER=
Table 2-168 Description of the input parameters of: ADD PPS BATGREEN
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
GREENNUMBER
It is the phone
number specified in
the green list.
[Value Range]
digits.
Output Parameters
ACK: ADD PPS BATGREEN: RETN =, DESC =
Table 2-169 Description of the output parameters of: ADD PPS BATGREEN
Parameter
Description
RETN

DESC

Example
ADD PPS BATGREEN: BATCH =cgl10, GREENNUMBER=2454554
2-154
Issue 01 (2008-01-28)

2.6.24 Deleting Green Numbers at Batch Level

Command Name
DELE PPS BATGREEN
Command Function
This command is used to delete green numbers at the batch level.
Input Parameters
DELE PPS BATGREEN: BATCH = [, GREENNUMBER=]
Table 2-170 Description of the input parameters of: DELE PPS BATGREEN
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
GREENNUMBER
It is the phone
number specified in
the green list.
[Value Range]
digits.
Output Parameters
ACK: DELE PPS BATGREEN: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-171 Description of the output parameters of: DELE PPS BATGREEN
Parameter
Description
RETN

DESC

operation.
ATTR
RESULT
Issue 01 (2008-01-28)
2-155

Example
DELE PPS BATGREEN: BATCH =32564, GREENNUMBER=2454554&2315
2.6.25 Querying Green Numbers at Batch Level

Command Name
LIST PPS BATGREEN
Command Function
This command is used to query green numbers at the batch level.
Input Parameters
LIST PPS BATGREEN: BATCH =
Table 2-172 Description of the input parameters of: LIST PPS BATGREEN
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: LIST PPS BATGREEN: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-173 Description of the output parameters of: LIST PPS BATGREEN
Parameter
Description
RETN

DESC
ATTR

operation.
USERIDENTIFIER& BATCH& GREENNUMBER
2-156
RESULT
TOTAL
Issue 01 (2008-01-28)

Parameter
Description
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BATGREEN: BATCH =123456
2.6.26 Cancelling Batch Operations of Cards

Command Name
STOP PPS BATCHOPR
Command Function
This command is used to cancel the following batch operations of cards that are being
processed:
Activating cards
Loading cards
Deactivating cards
Unloading cards
Deleting cards
Importing cards
Input Parameters
STOP PPS BATCHOPR: BATCH =
Table 2-174 Description of the input parameters of: STOP PPS BATCHOPR
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: STOP PPS BATCARD: RETN =, DESC =
Issue 01 (2008-01-28)
2-157

Table 2-175 Description of the output parameters of: STOP PPS BATCHOPR
Parameter
Description
RETN

DESC

operation.
Example
STOP PPS BATCHOPR: BATCH=cgl000
2.6.27 Querying the Reason for Deleting Cards in Batches

Command Name
LIST PPS DELREA
Command Function
This command is used to query the reason for deleting cards in batches.
Input Parameters
LIST PPS DELREA: [TASKID=]
Table 2-176 Description of the input parameters of: LIST PPS DELREA
Parameter
Description
Value Range
TASKID
It is the ID of the
deletion reason.
[Value Range]
268435455.
Output Parameters
ACK: LIST PPS DELREA: RETN=, DESC= [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-177 Description of the output parameters of: LIST PPS DELREA
Parameter
Description
RETN

2-158
Issue 01 (2008-01-28)

Parameter
Description
DESC

operation.
ATTR
TASKID& DELREASON
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS DELREA:
2.6.28 Loading Cards in Batches

Command Name
LOAD PPS BATCARD
Command Function
This command is used to synchronize the data in the following tables of cards corresponding
to the batch from the SMP up to the SCP:
Calling number screen table
Abbreviated number table
Called number screen table
Familiarity number table
Call history table
Green list table
Issue 01 (2008-01-28)
2-159

Input Parameters
LOAD PPS BATCARD: BATCH=,STATUS=[,CARDTYPE=,
Table 2-178 Description of the input parameters of: LOAD PPS BATCARD
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
STATUS
It is the status type

of a card to be
loaded.
[Value Range]
1: Created
CARDTYPE
STARTSN
It is the type of
entering a card.
It is the start
sequence number or
a batch.
2: Loaded
3: Activated
4: Unloaded
5: Overdue
[Value Range]
[Value Range]
ENDSN
It is the end
sequence number or
end card number of
a batch.
[Value Range]
to 1. It is an integer in [0, 9999999].
EXPTYPE
EXPDATE
2-160
It is the type of
expiry date.

of the card.
[Value Range]

date

data
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
the format YYYYMMDD.
BALTYPE

balance.
BALANCE
It is the card
balance.
[Value Range]
[Value Range]
268435455.
Output Parameters
ACK: LOAD PPS BATCARD: RETN =, DESC =[, TOTAL=, FINISHED=, SN=, NUMOF=,
ATTR=, RESULT=]
Table 2-179 Description of the output parameters of: LOAD PPS BATCARD
Parameter
Description
RETN

DESC

operation.
ATTR
ERRORID& ERRORINFO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-161

Example
LOAD PPS BATCARD: BATCH=batchno123, STATUS=0
2.6.29 Unloading Cards in Batches

Command Name
UNLOAD PPS BATCARD
Command Function
This command is used to delete the data in the following tables of cards corresponding to the
batch from the SCP:
Calling number screen table
Abbreviated number table
Called number screen table
Familiarity number table
Call history table
Green list table
Input Parameters
UNLOAD PPS BATCARD: BATCH=, STATUS=[,CARDTYPE= ,
Table 2-180 Description of the input parameters of: UNLOAD PPS BATCARD
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
STATUS
It is the status type

of a card to be
loaded.
[Value Range]
1: Created
2: Loaded
3: Activated
4: Unloaded
5: Overdue
Note:
For Unloading batch cards Status has
to be Loaded or Activated.
CARDTYPE
STARTSN
2-162
It is the type of
entering a card.
It is the start
sequence number or
[Value Range]
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range

a batch.
It indicates the start sequence

number of a batch when
CARDTYPE is set to 1.It is an
integer in [0, 9999999].
It is a numeric string of 2 to 20
digits.
ENDSN
It is the end
sequence number or
end card number of
a batch.
[Value Range]
to 1. It is an integer in [0, 9999999].
It is a numeric string of 2 to 20
digits.
EXPTYPE
EXPDATE
BALTYPE
BALANCE
It is the type of
expiry date.
[Value Range]
2: earlier than or equal to the

expiry date

data

of the card.
[Value Range]

balance.
[Value Range]
It is the card
balance.

the format YYYYMMDD.
4: more than or equal to the

balance
[Value Range]
268435455.
Output Parameters
ACK: UNLOAD PPS BATCARD: RETN =, DESC =[, TOTAL=, FINISHED=, SN=,
Issue 01 (2008-01-28)
2-163

Table 2-181 Description of the output parameters of: UNLOAD PPS BATCARD
Parameter
Description
RETN

DESC

operation.
ATTR
ERRORID& ERRORINFO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
UNLOAD PPS BATCARD: BATCH=batchno123, STATUS=0
2.6.30 Importing Cards in Batches

Command Name
IMPORT PPS BATCHCARD
Command Function
This command is used to import cards in batches.
Input Parameters
IMPORT PPS BATCHCARD: FORMAT=, FILE=, AREAID=, SDUID=, PRODUCTID=,
CARDTYPE=, STARTDATE=[, ENDDATE= ] [, CURRENCY=] [, BATCH=] [,
BATCHDESC=] [, GSNHEAD=] [, DISCOUNTRATE=] [, PROBATIONFLAG=[,
PROBATIONBAL=]][, MAINCARDNO=][, BONUSFLAG=[, BONUSTEMPLATEID=]] [,
FACEVALUE=] [, VALIDPERIODTYPE=[, VALIDITYPERIOD=]][,
AUTOCLEARFLAG=[, AUTOCLEARTIME=]][, TAXRATE=][, AUTODELFLAG=][,
2-164
Issue 01 (2008-01-28)

SIMCALLFLAG=][, CALLTYPESCR=][, CLNCATSCRFLAG=][, MAXCALLFLAG=[,

MAXCALL=]][, DMLIMITFLAG=][, DAYACCOUNTFLAG=[, DAYACCOUNT=]][,
MONTHACCOUNTFLAG=[, MONTHACCOUNT=]][, MAXRECHGTIMES=][,
CREDITLIMIT=][, INITPLAYBALFLG=][, PLYFIRDURATIONFLG=][,
PLYSECDURATIONFLG=][, PLYCOSTFLG=][, PLYNEWBALFLG=][, BINDFLAG=][,
CALLINSCR=][, CALLEDSCR=[, DIRECTDIALPSTN=]][, BEEPFLAG=][,
ACCUMULATEFLAG=][, ABBRACCTFLAG=][, FAMILYNUMFLAG=[,
FAMILYNUMDISCOUNT=][, MAXFAMILYNUM=]][, DISPLAYCLIFLG=][,
RECHARGINGFLG=][, PERIODBONUS=][, PACKAGEID=][,
UBPFUNCFLG=][,SMFLAG=][, SENDDURATIONFLAG=][, SENDCOSTFLAG=][,
SENDBALFLAG=][, CALLFUNCFLAG=][, MESSFUNCFLAG=]
Table 2-182 Description of the input parameters of: IMPORT PPS BATCHCARD
Parameter
Description
Value Range
FORMAT
It is the file format

entered.
[Value Range]
pps_card
pps_card_without_pin
pps_card_from_gentool
FILE
It is the file name.
[Value Range]
digits.
When FORMAT is set to
pps_card_from_gentool, the file
extension must be .HPF or .hpf;
otherwise, it must be .TXT or .txt.
It cannot contain the following
characters:
!&|#%\,;'"
AREAID
It is the ID of the
area that the card
belongs to.
[Value Range]
SDUID
It is the ID of the
SDU.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is the batch
description.
[Value Range]
BATCH
BATCHDESC

99999999.

999.

digits.
It cannot contain the following
Issue 01 (2008-01-28)
2-165

Parameter
Description
Value Range
characters:
!&|#%\,;'"
GSNHEAD
DISCOUNTRATE
It is the head of the

sequence number.
[Value Range]
It is the discount
rate.
[Value Range]
It is a character string of 0 to 10 digits,

containing az, AZ or 09.
It is enabled when
CURRENCY
It is the currency
type.
[Value Range]
PROBATIONFLAG
It is the flag
indicating whether
the card is a
probation card.
[Value Range]
0: No
1: Yes
PROBATIONBAL
It is the call duration

of the probation
card.
[Value Range]
999999999.
The unit is second.
It is enabled and must be set when
MAINCARDNO
It is the flag
indicating whether
the card is a main
card or an ordinary
card.
[Value Range]
It is 2, 1 or a numerical string of 2
to 20 digits.
2: ordinary card
1: main card
Others: a numeric string of 2 to 20
digits, number of the main card
It must be set to the default value or
not set when PROBATIONFLAG is
set to 1.
BONUSFLAG
It is the flag
indicating whether
the batch of cards is
sold with bonus.
[Value Range]
0: No
1: Yes
not set when
2-166
Issue 01 (2008-01-28)

Parameter
Description
Value Range
MAINCARDNO is not set to 1 or
2.
BONUSTEMPLATEID
It is the ID of the
bonus template.
[Value Range]
268435455.
BONUSFLAG is set to 1.
CARDTYPE
It is the card type.
[Value Range]
It can be set to A, B or an integer in
the range 0 to 9.
03: If Call Type at service level is
Only PSTN
47: If Call Type at service level is
Only IP
89, A, or B: If Call Type at service
level is PSTN and IP
FACEVALUE
It is the face value

of the card.
[Value Range]
268435455.
It is enabled when
It is enabled when MAINCARDNO is
set to 1 or 2.
STARTDATE
It is the service start

date.
[Value Range]
It is in the format of YYYYMMDD or
YYYYMMDDHHMMSS.
The service start date cannot be earlier
than the current day and later than the
service end date.
ENDDATE
It is the service end

date.
[Value Range]
It is in the format of YYYYMMDD or
YYYYMMDDHHMMSS.
VALIDPERIODTYPE
It is the validity
period type of the
card.
[Value Range]
0: Fixed
1: Fixed & Variable
2: Activate
3: Variable
4: Period A + B
Issue 01 (2008-01-28)
2-167

Parameter
Description
Value Range
VALIDITYPERIOD
It is the validity
period of the card.
[Value Range]
The unit is day.
VALIDPERIODTYPE is set to 1, 2
or 3.
AUTOCLEARFLAG
It is the flag
indicating whether
to clear the blacklist
automatically.
[Value Range]
0: No
1: Yes
AUTOCLEARTIME
It is the time for

clearing
automatically.
[Value Range]
999999999.
The unit is hour.
AUTOCLEARFLAG is set to 1.
TAXRATE
It is the government
tax rate.
[Value Range]
100000.
It is enabled when
AUTODELFLAG
SIMCALLFLAG
It is the flag
indicating whether
to support the
automatic clearing
function.
[Value Range]
It is the flag
indicating whether
to support
simultaneous calls.
[Value Range]
0: No
1: Yes
0: No
1: Yes
CALLTYPESCR
It is the call type

screen.
[Value Range]
0: No
1: Yes
CLNCATSCRFLAG
It is the calling type

screen.
[Value Range]
0: None
1: Permitted
2-168
Issue 01 (2008-01-28)

Parameter
Description
Value Range
2: Restricted
MAXCALLFLAG
It is the flag
indicating whether
to support maximum
calls.
[Value Range]
0: No
1: Yes
MAXCALL
It is the maximum
call times.
[Value Range]
MAXCALLFLAG is set to 1.
DMLIMITFLAG
DAYACCOUNTFLAG
It is the monthly
limit or daily limit.
[Value Range]
It is the flag
indicating daily
limit.
[Value Range]
It is 0, indicating card level.
0: no limit
1: limit on call cost
2: limit on call duration
set to 1.
It must be set to 1 when
INITPLAYBALFLG or
PLYNEWBALFLG is set to 3 or 6.
Either DAYACCOUNTFLAG or
MONTHACCOUNTFLAG must be
set to 1 when INITPLAYBALFLG or
DAYACCOUNT
It is the daily limit

(on call cost or
duration).
[Value Range]
268435455.
DAYACCOUNTFLAG is set to 1 or
2.
MONTHACCOUNTFL
AG
It is the flag
indicating the
monthly limit.
[Value Range]
0: no limit
1: limit on call cost
set to 1.
It must be set to 1 when
Issue 01 (2008-01-28)
2-169

Parameter
Description
Value Range
INITPLAYBALFLG or
Either DAYACCOUNTFLAG or
MONTHACCOUNTFLAG must be
set to 1 when INITPLAYBALFLG or
MONTHACCOUNT
It is the monthly
limit (on call cost).
[Value Range]
268435455.
When the daily limit and monthly limit
are on call cost, the daily limit cannot
be greater than the monthly limit.
MONTHACCOUNTFLAG is set to
1.
MAXRECHGTIMES
It is the maximum
recharge times.
[Value Range]
2147483647.
CREDITLIMIT
It is the credit.
[Value Range]
It is enabled when
INITPLAYBALFLG
It is the flag
indicating whether
to prompt the initial
balance.
[Value Range]
0: No
1: Yes (In all cases)
2: Yes (When the balance is less than
the specified value)
3: Yes (When the daily balance is less
than the specified daily value)
4: Yes (When the monthly balance is
less than the specified monthly value)
the specified value or the daily balance
is less than the specified daily value or
the monthly balance is less than the
specified monthly value)
is less than the specified daily value)
the specified value or the monthly
2-170
Issue 01 (2008-01-28)

Parameter
Description
Value Range
balance is less than the specified
monthly value)
than the specified daily value or the
monthly balance is less than the
It must be set to 1 or not set when
2.
PLYFIRDURATIONF
LG
PLYSECDURATIONF
LG
It is the flag
indicating whether
to prompt the
available duration
for initialization.
[Value Range]
It is the flag
indicating whether
to prompt call
duration.
[Value Range]
0: No
1: Yes
0: No
1: Yes
PLYCOSTFLG
It is the flag
indicating whether
to prompt call cost.
[Value Range]
0: No
1: Yes
PLYNEWBALFLG
It is the flag
indicating whether
to prompt new
balance.
[Value Range]
0: No
1: Yes (In all cases)
the specified value)
than the specified daily value)
4: Yes (When the monthly balance is
less than the specified monthly value)
is less than the specified daily value or
the monthly balance is less than the
is less than the specified daily value)
the specified value or the monthly
balance is less than the specified
monthly value)
Issue 01 (2008-01-28)
2-171

Parameter
Description
Value Range
than the specified daily value or the
monthly balance is less than the
not set when MAINCARDNO is not
set to 1 or 2.
When it is not set to 0,
PLYSECDURATIONFLG and
PLYCOSTFLG cannot be set to 1 at
the same time.
BINDFLAG
It is the flag
indicating the
calling binding.
[Value Range]
0: No
1: Yes
CALLINSCR
It is the flag
indicating the
calling number
screen.
[Value Range]
0: None
1: Permitted
2: Restricted
CALLEDSCR
It is the flag
indicating the called
number screen.
[Value Range]
0: None
1: Permitted
2: Restricted
3: Direct Dial
DIRECTDIALPSTN
It is the direct
dialing of PSTN
number.
[Value Range]
digits.
It must be set when CALLEDSCR is
set to 3; otherwise, it is disabled.
BEEPFLAG
It is the flag
indicating the party
to which the beep
prompt is played.
[Value Range]
0: No
1: Calling
2: Called
3: Calling and Called
ACCUMULATEFLAG
2-172
It is the flag
indicating the usage
bonus.
[Value Range]
0: None
1: Accumulate
Issue 01 (2008-01-28)

Parameter
Description
Value Range
2: Period
set to 1.
ABBRACCTFLAG
It is the flag
indicating if
abbreviated dialing
function is enabled.
[Value Range]
0: No
1: Yes
FAMILYNUMFLAG
It is the flag
indicating the
familiarity number.
[Value Range]
0: No
1: Yes
FAMILYNUMDISCO
UNT
It is the familiarity
number discount.
[Value Range]
FAMILYNUMFLAG is set to 1.
MAXFAMILYNUM
It is the maximum
number of
familiarity numbers.
[Value Range]
FAMILYNUMFLAG is set to 1.
DISPLAYCLIFLG
It is the flag
indicating whether
to display the caller
for the called party.
[Value Range]
0: based on the product level setting
1: Yes, display the caller
2: No, not display the caller
RECHARGINGFLG
It is the recharge
card type.
[Value Range]
not set when
2.
PERIODBONUS
Issue 01 (2008-01-28)
It is the validity
period of the bonus.
[Value Range]
2-173

Parameter
Description
Value Range
RECHARGINGFLG is set to 0 or 1.
PACKAGEID
UBPFUNCFLG
It is the flag
indicating whether
to permit selecting
the recharge
package.
[Value Range]
It is the flag
indicating whether
to support the UBP
function.
[Value Range]
0: Yes
1: No
0: No
1: Yes
not set when
2.
SMFLAG
It is the flag
indicating whether
to support the short
message function.
[Value Range]
0: No
1: Yes
It is enabled when
CALLFUNCFLAG is set to 1 and the
product supports the short message
function.
SENDDURATIONFLAG,
SENDCOSTFLAG and
SENDDURATIONFL
AG
It is the flag
indicating whether
to send the call
duration.
[Value Range]
0: No
1: Yes
1.
SENDCOSTFLAG
It is the flag
indicating whether
to send the call cost.
[Value Range]
0: No
1: Yes
1.
2-174
Issue 01 (2008-01-28)

Parameter
Description
Value Range
SENDBALFLAG
It is the flag
indicating whether
to send the card
balance.
[Value Range]
0: No
1: Yes
1.
CALLFUNCFLAG
It is the flag
indicating whether
the card supports the
call function.
[Value Range]
0: No
1: Yes
MESSFUNCFLAG
It is the flag
indicating whether
to support the voice
message function.
[Value Range]
0: No
1: Yes
It is enabled when
CALLFUNCFLAG is set to 1 and the
product supports the voice message
function.
Output Parameters
ACK: IMPORT PPS BATCH: RETN=,
DESC=[,TOTAL=,FINISHED=,SN=,NUMOF=,ATTR=,RESULT=]
Table 2-183 Description of the output parameters of: IMPORT PPS BATCHCARD
Parameter
RETN
Description
DESC

operation.

ATTR
SUCCNUM& FAILNUM& CANCELNUM& BATCH& FILENAME
RESULT
TOTAL
Issue 01 (2008-01-28)
2-175

Parameter
Description
FINISHED

0: No
1: Yes
SN

NUMOF
Example
IMPORT PPS BATCHCARD: FORMAT="pps_card", FILE=a.txt, AREAID=1,
SDUID=101, PRODUCTID=1, BATCH=0001, CARDTYPE=1, CURRENCY=1,
STARTDATE=20061231, ENDDATE=20071231, BATCHDESC="langxh",
GSNHEAD=1111.
2.6.31 Querying Statuses of Batch Level Parameters

Command Name
DISP PPS BATMODISTATE
Command Function
This command is used to query whether the batch level parameters can be modified.
Input Parameters
DISP PPS BATMODISTATE: BATCH=
Table 2-184 Description of the input parameters of: DISP PPS BATMODISTATE
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: DISP PPS BATMODISTATE: RETN =, DESC = [, ATTR =, RESULT =]
Table 2-185 Description of the output parameters of: DISP PPS BATMODISTATE
2-176
Parameter
Description
RETN
Issue 01 (2008-01-28)

Parameter
Description
DESC
ATTR

operation.
BATCH& CPPURBANCALL& CPPINTERURBANCALL&
NESTCALLFLAG& UBPFUNCTIONFLG
RESULT
Example
DISP PPS BATMODISTATE: BATCH=zx1133
2.6.32 Adding Batch Level Parameters

Command Name
ADD PPS BATCHPARA
Command Function
This command is used to add batch level parameters.
Input Parameters
ADD PPS BATCHPARA:
BATCH=,CHGCURRENCYTYPE=,FUNCTREEID=[,MESSAGEID=][,CALLEDSCREEN
TYPE=][,CALLINGSCREENTYPE=][,ENABLEFLAG=][,PERIODA=][,PERIODB=][,INT
ERRUPTIBLEFLAG=][,BINDCALLINGSCRFLG=][,BINDCATSCRFLG=][,CALLTYPES
CREEN=][,INTERNATIONALCALL=][,NATIONALCALL=][,LOCALCALL=][,CPPURB
ANCALL=][,CPPINTERURBANCALL=][,NESTCALLFLAG=][,DESTBLACKLISTFLG=
][,MODPINFLG=][,BASECHGCLS=][,EXTCHGCLS1=][,INUSEDDAYSFLG=][,INUSED
DAYSPERCYL=][,INUSEDDAYSMSGID=][,AUTHPINFLG=][,TIMESCREENFLG=][,TI
MESEGINDEX=][,ABBRDIALONBTHFLG=][,CUSTANNONTIME=][,MAXCALLTIMES
=][,SETDEFLANFLG=][,SETLANGVOICEID=][,SERVICEKEY1=][,SERVICEKEY2=][,S
ERVICEKEY3=][,SERVICEKEY4=][,SERVICEKEY5=][,SERVICEKEY6=][,SERVICEKE
Y7=][,SERVICEKEY8=][,UBPFUNCTIONFLG=][,ONLINECARDSALEFLG=]
Table 2-186 Description of the input parameters of: ADD PPS BATCHPARA
Parameter
Description
Value Range
BATCH
It is the unique
identifier of a
[Value Range]
Issue 01 (2008-01-28)
2-177

Parameter
Description
Value Range
batch.
CHGCURRENCYTYPE
It is the charging
currency type.
[Value Range]
FUNCTREEID
It is the ID of the
function tree.
[Value Range]
It is the ID of the
welcome
message.
[Value Range]
MESSAGEID

2147483647.

2147483647.
CALLEDSCREENTYPE
It is the called
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
CALLINGSCREENTYPE
It is the calling
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
ENABLEFLAG
PERIODA
It is the flag
indicating
whether the
batch is
available.
[Value Range]
0: Yes
It is the period
A.
[Value Range]
1: No (set by the SP)


The unit depends on
PPS_sysconfig_pdt. FunctionFlg[2]
corresponding to the card.
When PPS_sysconfig_pdt.
FunctionFlg[2] = 0, the unit is day.
FunctionFlg[2] = 1, the unit is hour.
PERIODB
It is the period B.
[Value Range]
The unit depends on
2-178
Issue 01 (2008-01-28)

Parameter
Description
Value Range
INTERRUPTIBLEFLAG
BINDCALLINGSCRFLG
BINDCATSCRFLG
CALLTYPESCREEN
INTERNATIONALCALL
It is the flag
indicating
whether the
welcome
message can be
interrupted.
[Value Range]
It is the flag
indicating the
calling number
screen when the
calling number is
bound.
[Value Range]
0: None
It is the flag
indicating the
calling category
screen when the
calling number is
bound.
[Value Range]
It is the flag
indicating
whether to
support the call
type screen.
[Value Range]
It is the
international toll
call restriction.
[Value Range]
0: Permitted
0: No
1: Yes
1: Permitted
2: Restricted
0: None
1: Permitted
2: Restricted
0: No
1: Yes
1: Restricted
It is enabled when
CALLTYPESCREEN is set to 1.
NATIONALCALL
It is the national
toll call
restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
LOCALCALL
It is the local call

restriction.
[Value Range]
0: Permitted
1: Restricted
Issue 01 (2008-01-28)
2-179

Parameter
Description
Value Range
It is enabled when
CPPURBANCALL
It is the mobile
call restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
CPPINTERURBANCALL
It is the national
mobile call
restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
NESTCALLFLAG
DESTBLACKLISTFLG
It is the flag
indicating
whether to
support the
function of
invoking other
services.
[Value Range]
It is the flag
indicating the
destination
blacklist.
[Value Range]
0: No
0: No
1: Yes
1: Yes
MODPINFLG
BASECHGCLS
It is the flag
indicating
whether to
support
modifying the
password.
[Value Range]
It is the basic
charging class.
[Value Range]
0: No
1: Yes

1000.
The default value is 1, indicating not
using the fixed charge rate at batch
level.
EXTCHGCLS1
2-180
It is the
surcharge
charging class 1.
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
INUSEDDAYSFLG
It is the flag
indicating
playing used
days of the
account.
[Value Range]
0: not play
1: play on the Nth day
2: play every N days
INUSEDDAYSPERCYL
It is the number
of days of the
account cycle.
[Value Range]
It is enabled when
INUSEDDAYSFLG is set to 1 or 2.
INUSEDDAYSMSGID
It is the voice ID
that plays the
used days of the
account.
[Value Range]
2147483647.
It is enabled when
INUSEDDAYSFLG is set to 1 or 2.
AUTHPINFLG
TIMESCREENFLG
TIMESEGINDEX
It is the flag
indicating
whether the
batch of cards
support the
configurable
function of
authentication
with password.
[Value Range]
0: No
It is the flag
indicating
whether to
support the time
screen function.
[Value Range]
0: No
It is the index of
time segment
screen.
[Value Range]
1: Yes
1: Yes

TIMESCREENFLG is set to 1.
ABBRDIALONBTHFLG
Issue 01 (2008-01-28)
It is the flag
indicating
whether to
support the
abbreviated
account function
at the batch
level.
[Value Range]
0: No
1: Yes
2-181

Parameter
Description
Value Range
CUSTANNONTIME
It is the flag
indicating
personalized
voice play based
on time at the
batch level.
[Value Range]
It is an integer in 0 or 1.
It is the
maximum call
times of the
batch.
[Value Range]
It is the flag
indicating
whether to
support setting
the prompt
language at the
subscriber level.
[Value Range]
It is the dynamic
voices in the
default language
selected by
subscribers.
[Value Range]
MAXCALLTIMES
SETDEFLANFLG
SETLANGVOICEID

2147483647.
The default value is 0, indicating no
limit.
0: No
1: Yes

2147483647.
It is enabled when SETDEFLANFLG
is set to 1.
SERVICEKEY1
SERVICEKEY2
SERVICEKEY3
SERVICEKEY4
2-182
It is the service
key 1 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 2 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 3 of the
services that the
cards of the
batch can
recharge.
It is the service
key 4 of the

32767.
The default value is 1, indicating the
card can be used to recharge cards of
all services.

32767.
It is disabled when SERVICEKEY1 is
not set or set to 1.
[Value Range]
32767.
[Value Range]
Issue 01 (2008-01-28)

Parameter
SERVICEKEY5
SERVICEKEY6
Value Range
services that the

cards of the
batch can
recharge.

32767.
It is the service
key 5 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 6 of the
services that the
cards of the
batch can
recharge.
SERVICEKEY7
It is the service
key 7 of the
services that the
cards of the
batch can
recharge.
SERVICEKEY8
It is the service
key 8 of the
services that the
cards of the
batch can
recharge.
UBPFUNCTIONFLG
ONLINECARDSALEFLG
Issue 01 (2008-01-28)
Description


32767.
[Value Range]
32767.
[Value Range]
32767.
[Value Range]
32767.
It is the flag
indicating
whether to
support the UBP
function.
[Value Range]
It is the flag
indicating
whether the
batch of cards
are sold online.
[Value Range]
0: No
1: Yes
0: No
1: Yes
2-183

Output Parameters
ACK: ADD PPS BATCHPARA: RETN =, DESC =
Table 2-187 Description of the output parameters of: ADD PPS BATCHPARA
Parameter
RETN
Description
DESC

operation.
Example
ADD PPS BATCHPARA: BATCH=dd12, CHGCURRENCYTYPE=12, FUNCTREEID=12
2.6.33 Modifying Batch Level Parameters

Command Name
MODI PPS BATCHPARA
Command Function
This command is used to modify the specified batch level parameters
Input Parameters
MODI PPS BATCHPARA:
BATCH=[,CHGCURRENCYTYPE=][,FUNCTREEID=][,MESSAGEID=][,CALLEDSCRE
ENTYPE=][,CALLINGSCREENTYPE=][,ENABLEFLAG=][,PERIODA=][,PERIODB=][,I
NTERRUPTIBLEFLAG=][,BINDCALLINGSCRFLG=][,BINDCATSCRFLG=][,CALLTYP
ESCREEN=][,INTERNATIONALCALL=][,NATIONALCALL=][,LOCALCALL=][,CPPUR
BANCALL=][,CPPINTERURBANCALL=][,NESTCALLFLAG=][,DESTBLACKLISTFLG
=][,MODPINFLG=][,BASECHGCLS=][,EXTCHGCLS1=][,INUSEDDAYSFLG=][,INUSE
DDAYSPERCYL=][,INUSEDDAYSMSGID=][,AUTHPINFLG=][,TIMESCREENFLG=][,T
IMESEGINDEX=][,ABBRDIALONBTHFLG=][,CUSTANNONTIME=][,SETDEFLANFL
G=][,SETLANGVOICEID=][,SERVICEKEY1=][,SERVICEKEY2=][,SERVICEKEY3=][,S
ERVICEKEY4=][,SERVICEKEY5=][,SERVICEKEY6=][,SERVICEKEY7=][,SERVICEKE
Y8=][,UBPFUNCTIONFLG=][,ONLINECARDSALEFLG=]
Table 2-188 Description of the input parameters of: MODI PPS BATCHPARA
2-184
Parameter
Description
Value Range
BATCH
It is the unique
identifier of a
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
batch.
az or AZ or 09.
CHGCURRENCYTYPE
It is the charging
currency type.
[Value Range]
FUNCTREEID
It is the ID of the
function tree.
[Value Range]
It is the ID of the
welcome
message.
[Value Range]
MESSAGEID

2147483647.

2147483647.
CALLEDSCREENTYPE
It is the called
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
CALLINGSCREENTYPE
It is the calling
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
ENABLEFLAG
PERIODA
It is the flag
indicating
whether the
batch is
available.
[Value Range]
0: Yes
It is the period
A.
[Value Range]
1: No (set by the SP)


The unit depends on
PERIODB
It is the period B.
[Value Range]
The unit depends on
Issue 01 (2008-01-28)
2-185

Parameter
Description
Value Range
INTERRUPTIBLEFLAG
BINDCALLINGSCRFLG
BINDCATSCRFLG
CALLTYPESCREEN
INTERNATIONALCALL
It is the flag
indicating
whether the
welcome
message can be
interrupted.
[Value Range]
It is the flag
indicating the
calling number
screen when the
calling number is
bound.
[Value Range]
0: None
It is the flag
indicating the
calling category
screen when the
calling number is
bound.
[Value Range]
It is the flag
indicating
whether to
support the call
type screen.
[Value Range]
It is the
international toll
call restriction.
[Value Range]
0: Permitted
0: No
1: Yes
1: Permitted
2: Restricted
0: None
1: Permitted
2: Restricted
0: No
1: Yes
1: Restricted
It is enabled when
NATIONALCALL
It is the national
toll call
restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
LOCALCALL

restriction.
[Value Range]
0: Permitted
1: Restricted
2-186
Issue 01 (2008-01-28)

Parameter
Description
Value Range
It is enabled when
CPPURBANCALL
It is the mobile
call restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
CPPINTERURBANCALL
It is the national
mobile call
restriction.
[Value Range]
0: Permitted
1: Restricted
It is enabled when
NESTCALLFLAG
DESTBLACKLISTFLG
It is the flag
indicating
whether to
support the
function of
invoking other
services.
[Value Range]
It is the flag
indicating the
destination
blacklist.
[Value Range]
0: No
0: No
1: Yes
1: Yes
MODPINFLG
BASECHGCLS
It is the flag
indicating
whether to
support
modifying the
password.
[Value Range]
It is the basic
charging class.
[Value Range]
0: No
1: Yes

1000.
The default value is 1, indicating not
using the fixed charge rate at batch
level.
EXTCHGCLS1
INUSEDDAYSFLG
Issue 01 (2008-01-28)
It is the
surcharge
charging class 1.
[Value Range]
It is the flag
[Value Range]

2-187

Parameter
Description
Value Range
indicating
playing used
days of the
account.
0: not play
1: play on the Nth day
2: play every N days
INUSEDDAYSPERCYL
It is the number
of days of the
account cycle.
[Value Range]
It is enabled when INUSEDDAYSFLG
is set to 1 or 2.
INUSEDDAYSMSGID
It is the voice ID
that plays the
used days of the
account.
[Value Range]
2147483647.
It is enabled when INUSEDDAYSFLG
is set to 1 or 2.
AUTHPINFLG
TIMESCREENFLG
TIMESEGINDEX
ABBRDIALONBTHFLG
CUSTANNONTIME
2-188
It is the flag
indicating
whether the
batch of cards
support the
configurable
function of
authentication
with password.
[Value Range]
It is the flag
indicating
whether to
support the time
screen function.
[Value Range]
It is the index of
time segment
screen.
[Value Range]
It is the flag
indicating
whether to
support the
abbreviated
account function
at the batch
level.
[Value Range]
It is the flag
indicating
personalized
voice play based
[Value Range]
0: No
1: Yes
0: No
1: Yes

TIMESCREENFLG is set to 1.
0: No
1: Yes
It is an integer in 0 or 1.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
on time at the
batch level.
MAXCALLTIMES
SETDEFLANFLG
SETLANGVOICEID
It is the
maximum call
times of the
batch.
[Value Range]
It is the flag
indicating
whether to
support setting
the prompt
language at the
subscriber level.
[Value Range]
It is the dynamic
voices in the
default language
selected by
subscribers.
[Value Range]

2147483647.
The default value is 0, indicating no
limit.
0: No
1: Yes

2147483647.
It is enabled when SETDEFLANFLG
is set to 1.
SERVICEKEY1
SERVICEKEY2
SERVICEKEY3
SERVICEKEY4
SERVICEKEY5
Issue 01 (2008-01-28)
It is the service
key 1 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 2 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 3 of the
services that the
cards of the
batch can
recharge.
It is the service
key 4 of the
services that the
cards of the
batch can
recharge.
It is the service
key 5 of the

The default value is 1, indicating the
card can be used to recharge cards of all
services.

[Value Range]
[Value Range]
[Value Range]
2-189

Parameter
SERVICEKEY6
SERVICEKEY7
Description
Value Range
services that the

cards of the
batch can
recharge.
It is the service
key 6 of the
services that the
cards of the
batch can
recharge.
[Value Range]
It is the service
key 7 of the
services that the
cards of the
batch can
recharge.
SERVICEKEY8
It is the service
key 8 of the
services that the
cards of the
batch can
recharge.
UBPFUNCTIONFLG
ONLINECARDSALEFLG


[Value Range]
[Value Range]
It is the flag
indicating
whether to
support the UBP
function.
[Value Range]
0: No
It is the flag
indicating
whether the
batch of cards
are sold online.
[Value Range]
1: Yes
0: No
1: Yes
Output Parameters
ACK: MODI PPS BATCHPARA: RETN =, DESC =
Table 2-189 Description of the output parameters of: MODI PPS BATCHPARA
Parameter
Description
RETN

DESC
2-190

operation.
Issue 01 (2008-01-28)

Parameter
Description
Example
MODI PPS BATCHPARA: BATCH=dd12, CHGCURRENCYTYPE=12,
FUNCTREEID=12
2.6.34 Deleting Batch Level Parameters

Command Name
DELE PPS BATCHPARA
Command Function
This command is used to delete the specified batch level parameters.
Input Parameters
DELE PPS BATCHPARA: BATCH=
Table 2-190 Description of the input parameters of: DELE PPS BATCHPARA
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
Output Parameters
ACK: DELE PPS BATCHPARA: RETN =, DESC =
Table 2-191 Description of the output parameters of: DELE PPS BATCHPARA
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

operation.
2-191

Example
DELE PPS BATCHPARA: BATCH=zx123123
2.7 Single Card Management Settings

2.7.1 Listing Single Cards in a Batch
Command Name
LIST PPS CARD
Command Function
This command is used to list the single cards.
Input Parameters
LIST PPS CARD: [SPID = ][, BATCH =][, PRODUCTID =] [, GSN =] [, ENABLEFLAG =]
[, CARDBLKCLEARFLAG =][, OPRWAY =] [,STARTSN =] [,ENDSN =][,STARTCARD =]
[,ENDCARD =] [, STATUS =] [,EXPICOND =][,EXPIDATE =] [,BALCOND =]
[,BALANCE =] [,ONLYCARDBLKFLG =] [, SIMCALLFLAG =] [, MAXCALLFLAG =] [,
MAXCALLS =] [, SDATECRE =] [, EDATECRE =] [, SDATEENABLE =] [,
EDATEENABLE =] [, SDATELASTRECH =] [, EDATELASTRECH =] [, SDATECANCEL
=] [, EDATECANCEL =] [,MAINCARDNO =]
Table 2-192 Description of the input parameters of: LIST PPS CARD
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is the unique
identifier of a
batch.
[Value Range]
It is the
generation
sequential
number.
[Value Range]
It indicates if a
card is blocked.
[Value Range]
BATCH
GSN
ENABLEFLAG

999.
digits.
0: available
1: not available (set by the SP)
2: not available (set by the Superadm)
2-192
Issue 01 (2008-01-28)

Parameter
Description
Value Range
CARDBLKCLEARFLAG
It indicates if
blacklist
automatic
clearing
function is
enabled.
[Value Range]
0: No
It is the way of
operation.
[Value Range]
OPRWAY
1: Yes

BATCH is entered.
0: query by BATCH
1: query by SN
2: query by CARDNO
STARTSN
ENDSN
It is the start
serial number to
be queried.
[Value Range]
It is the end
serial number to
be queried.
[Value Range]

It is enabled only when OPRWAY is
set to 1.

set to 1.
It cannot be lesser than STARTSN.
STARTCARD
It is the start
card number to
be queried.
[Value Range]
digits.
set to 2.
It cannot be greater than ENDCARD.
STARTCARD and ENDCARD must
be entered at the same time.
ENDCARD
It is the end card

number to be
queried.
[Value Range]
digits.
set to 2.
It cannot be smaller than
STARTCARD.
STARTCARD and ENDCARD must
be entered at the same time.
STATUS
It is the status of
a card.
[Value Range]
It is a numeric string of 1 to 5 digits
containing 15.
1: created
Issue 01 (2008-01-28)
2-193

Parameter
Description
Value Range
2: loaded
3: activated
4: unloaded
5: overdue
The length of the numeric string stands
for the number of options. For
example, when you enter 135, three
options are chosen, namely, created,
activated and expired.
EXPICOND
It is the
condition of
validity date.
[Value Range]
1: <
2: =
3: >
4: <=
5: >=
EXPIDATE
It is the validity
date.
[Value Range]
It is in the format of YYYYMMDD.
It is enabled and must be entered only
when EXPICOND is entered.
BALCOND
It is the
condition of
balance.
[Value Range]
1: <
2: =
3: >
4: <=
5: >=
BALANCE
It is the balance
of a card.
[Value Range]
268435455.
It is enabled and compulsory only
when the value of BALCOND is
entered.
ONLYCARDBLKFLG
SIMCALLFLAG
MAXCALLFLAG
2-194
It is the
querying cards
present only in
black list.
[Value Range]
1: Yes
It indicates if
simultaneous
calls are
allowed.
[Value Range]
0: Restrict
It is a flag that
indicates the
maximum
[Value Range]

BATCH is entered.
1: Permit
0: No
Issue 01 (2008-01-28)

Parameter
Description
Value Range
follow-on calls
restriction.
1: Yes
It is the
maximum
number of
follow-on calls.
[Value Range]
SDATECRE
It is the card
listing start date.
[Value Range]
EDATECRE
It is the card
listing end date.
[Value Range]
It is the enable
cards start date
[Value Range]
It is the enable
cards end date
[Value Range]
SDATELASTRECH
It is the last
recharge start
date
[Value Range]
EDATELASTRECH
It is the last
recharge end
date
[Value Range]
It is cancel start
date.
[Value Range]
It is cancel end
date.
[Value Range]
It is the flag
indicating the
properties of the
main and child
card numbers.
[Value Range]
MAXCALLS
SDATEENABLEI
EDATEENABLE
SDATECANCEL
EDATECANCEL
MAINCARDNO
digits.
2: list all the cards that do not have
the properties of the main and child
card numbers.
1: list all the cards that have the
properties of the main cards.
Others: list all the child cards of the
main card MAINCARDNO.
Output Parameters
ACK: LIST PPS CARD: RETN =, DESC = [, TOTAL=, FINISHED =, SN =, NUMOF =,
ATTR=, RESULT=]
Issue 01 (2008-01-28)
2-195

Table 2-193 Description of the output parameters of: LIST PPS CARD
Parameter
RETN
Description
3301: The stop date of creating can not be earlier than the start date.

3302: The stop date of enabling can not be earlier than the start date.
3303: The stop date of recharging can not be earlier than the start date.
3304: The stop date of canceling can not be earlier than the start date.

DESC
ATTR

operation.
SPID& PRODUCTID& BATCH& CARDNO& STATUS&SN&
ENDDATE& FACEVALUE& BALANCE& SDUID&
CURRENCYNAME& CARDTYPE& STARTDATE& FIRSTUSE&
AREA& CURRENCYTYPE& DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CARD: SPID = 123, BATCH = 2005031501, PRODUCTID = 234
2.7.2 Counting Single Cards in a Batch

Command Name
COUNT PPS CARD
Command Function
This command is used to count all the single cards in a batch and give the number of
probation cards.
2-196
Issue 01 (2008-01-28)

Input Parameters
COUNT PPS CARD: SPID = [, PROBATIONFLAG =] [, PRODUCTID =] [, BATCH =] [,
CARDBLKCLEARFLAG =] [, STATUS =] [, SIMCALLFLAG =] [, MAXCALLFLAG =] [,
SDATECRE =] [, EDATECRE =] [, SDATEENABLE =] [, EDATEENABLE =] [,
SDATELASTRECH =] [, EDATELASTRECH =] [, SDATECANCEL =] [, EDATECANCEL
=]
Table 2-194 Description of the input parameters of: COUNT PPS CARD
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the probation
cards statistics.
[Value Range]
0: not a probation card
PROBATIONFLAG
1: probation card
PRODUCTID
BATCH
CARDBLKCLEARFL
AG
STATUS
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is a flag that
indicates the card
blacklist automatic
clearing.
[Value Range]
0: No
It is the card status.

999.
1: Yes
[Value Range]
1: created
2: enabled
3: active
4: cancelled
5: blocked
SIMCALLFLAG
MAXCALLFLAG
SDATECRE
EDATECRE
Issue 01 (2008-01-28)
It is the
simultaneous call.
[Value Range]
0: No
1: Yes
It is the flag
indicating the
maximum follow-on
calls restriction.
[Value Range]
0: No
It is the card listing

start date.
[Value Range]
It is the card listing
[Value Range]
1: Yes
2-197

Parameter
Description
Value Range
end date.
SDATEENABLE
It is the enable cards

start date
[Value Range]
EDATEENABLE
It is the enable cards

end date
[Value Range]
It is the last recharge

start date
[Value Range]
It is the last recharge

end date
[Value Range]
SDATECANCEL
It is cancel start
date.
[Value Range]
EDATECANCEL
It is cancel end date.
[Value Range]
SDATELASTRECH
EDATELASTRECH
Output Parameters
ACK: COUNT PPS CARD: RETN =, DESC = [, TOTAL =]
Table 2-195 Description of the output parameters of: COUNT PPS CARD
Parameter
Description
RETN

6001: The Parameter SIMCALLFLAG is disabled when the product is
prepaid.
DESC
TOTAL

operation.
Example
COUNT PPS CARD: SPID = 123, PRODUCTID = 123, BATCH = 2005031501
2-198
Issue 01 (2008-01-28)

2.7.3 Querying the Information About a Card

Command Name
LIST PPS CARDINFO
Command Function
This command is used to query information about a specified card.
Input Parameters
LIST PPS CARDINFO: CARDNO = [, SPID =]
Table 2-196 Description of the input parameters of: LIST PPS CARDINFO
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
If the service level parameter Card
Number Length is set to a fixed
value, the length of value of
CARDNO will be represented by the
value of Card Number Length.
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS CARDINFO: RETN =, DESC = [, ATTR =, RESULT =, TOTAL =, SN =,
NUMOF =, FINISHED =]
Table 2-197 Description of the output parameters of: LIST PPS CARDINFO
Parameter
Description
RETN

3401: The batch which the card belongs to does not exist.
DESC
ATTR
Issue 01 (2008-01-28)

operation.
2-199

Parameter
Description
CARDNO& BATCH& PRODUCTID& SPID& SEQUENCE&
GENSEQUENCE& FACEVALUE& BALANCE& PUBLICUSERID&
SPICCHGPRTTYPE& SUBCHGNO& AREAID& SCU&
CALLDSCRTYPE& DIRECTDAILPSTN& MAXCALLFLAG&
MAXCALLS& CARDBLKCLRFLAG& CARDBLKCLRTIME&
CARDBLKCOUNT& CARDBLKTIME& RCHGFLAG&
MAXRCHGTIME& CURRCHGTIME& DAILYLMTTYPE&
DAILYLMT& TODAYNOW& DAILYBLN& MONLMTFLAG&
MONLMT& MONNOW& MONBLN& VLIDPERIODTYPE&
SERVSTART& SERVSTOP& VALDPERIOD& FSTUSEDDATE&
CURRENCYTYPE& PLYDURAVAILFALG& PLABLNFLAG&
PLYDURFLAG& PLYCOSTFLAG& PLYNEWBLNFLAG&
ADJCHGCLS& DISCOUNTRATE& BEEPFLAG& CALLSCRTYPE&
CREDITLMT& TAXRATE& TAXVALUE& PINFLAG&
CALLTYPE& CARDTYPE& IPADJCHGCLS& BINDCALLPIN&
BINDCALLPINFLAG& BINDFLAG& ACCUMULATEFLAG&
ABBRACCTFLAG& FAMNUMFLAG& FAMNUMDISCOUNT&
MAXFAMNUM& USAGEFEE& CURACCUMLVL&
CARDBLKTYPE& SMAPCARDBLKCLRFLAG&
SMAPCARDBLKCLRHRS& LASTCALLDATETIME&
LASTCALLCLI& USERID& SPNAME& BLOCKFLAG&
BLOCKDATETIME& SIMUCALLFLAG& PERIODA& PERIODB&
ALLOWDISCOUNTFG& LOCALDISCOUNT&
NATIONALDISCOUNT& INTENATIONALDISCOUNT&
LASTRECHGDATE& CANCELDATE& CREATEDDATE&
ENABLEDATE& AUTODLTFLG& ENABLEFLAG& STATE&
MAINCARDNO& BONUSOFCARD& FUNCTIONFLG&
USELOCKDATETIME& LASTLOCKCLI& CURCALLTIMES&
DEFAULTLAN& PERIODBONUS& RECHARGINGTIMES&
PACKAGEID& CHARGEFLAG& PRODUCTNAME&
AREANAME& USERNAME& PROBATIONFLAG&
DURATIONBAL& SUBSTATE& LOADEDDATETIME&
ACTIVEDATETIME& INUSETOPLYDATE& USESTATE&
DISPLAYCLIFLG& CREDITLIMIT& ACCUMSTARTDATE&
INVOKER& MGTTIMES& LASTMGTDATE& DMLIMITFLAG&
UBPFLAG& STATUS& CLNCATSCRFLAG&
CALLTYPESCREEN& LASTCALLEDNUMBER&
CPPURBANCALL& CPPINTERURBANCALL&
CURRENCYNAME& DISPLAYUNIT& RATIO&
INTERNATIONALCALL
& NATIONALCALL& LOCALCALL& TOSECONDFLAG&
MOBILEPHONE
2-200
RESULT
TOTAL
FINISHED

0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
Description
SN

NUMOF
Example
LIST PPS CARDINFO: CARDNO = 123456789, SPID = 123
2.7.4 Modifying the Information of a Single Card

Command Name
MODI PPS CARDINFO
Command Function
This command is used to modify the data of a single card.
Input Parameters
MODI PPS CARDINFO: SPID =, ACCOUNTNUMBER = [, SERVICESTOP =] [,
DAILYLIMITTYPE =] [, DAILYLIMIT =] [, MONTHLYLIMITFLAG =] [,
MONTHLYLIMIT =] [, MAXCALLFLAG =] [, MAXCALLS =] [, BALANCE =] [,
CALLINGSCREENTYPE =] [, CALLEDSCREENTYPE =] [, DIRECTDIALPSTN =] [,
CARDBLKCLEARFLAG =] [, CARDBLKCLEARTIME =] [, PLYDURATIONAVAILFG =]
[, PLYBALANCEFLAG =] [, PLYDURATIONFLAG =] [, PLYCOSTFLAG =] [,
PLYNEWBALFLAG =] [, BEEPFLAG =] [, CREDITLIMIT =] [, TAXRATE2 =] [,
BINDFLAG =] [, SIMUCALLFLAG =] [, DESTAREARESFG =] [, AREARESVALUE =] [,
AUTODLTFLG =] [, ENABLEFLAG =] [, DISCOUNTRATE =] [, PERIODBONUS =] [,
RECHARGINGFLG =] [, UBPFUNCFLG =] [, DEFAULTLAN =] [, CALLDURATIONEXP
=] [, CALLINGCATESCREEN =] [, AUTHPINFLG =] [, DISPLAYCALLINGFLG =] [,
OPTRAUTOCLEAR =] [, OPTRAUTOCLEARTIME =] [,USAGEBONUS =] [,
ABBRACCOUNTFLG =] [, FAMNUMFLG =] [, FAMNUMDISCOUNT =] [,
FAMNUMMAX =], [MAXRECHARGETIMES =][,MOBILEPHONE =] [,SMFLAG=][,
SENDDURATIONFLAG=][, SENDCOSTFLAG=][, SENDBALFLAG=][,
CALLFUNCFLAG=][, MESSFUNCFLAG=]
Table 2-198 Description of the input parameters of: MODI PPS CARDINFO
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service
provider.
[Value Range]
It is the card
number.
[Value Range]
ACCOUNTNUMBER
Issue 01 (2008-01-28)
digits.
2-201

Parameter
Description
Value Range
ACCOUNTNUMBER will be
represented by the value of Card
Number Length.
SERVICESTOP
It is the validity
end date.
[Value Range]
It is the current date + 365 days.
The end date should be later then the
start date, and is in the format of
YYYYMMDD or in the format of
YYYYMMDDHHMMSS.
DAILYLIMITTYPE
It is the daily
limit type.
[Value Range]
0: none
1: sum of money
2: times
DAILYLIMIT
It is the daily
limit.
[Value Range]
268435455.
DAILYLIMITTYPE is set to 1 or 2
and is disabled for recharge cards.
MONTHLYLIMITFLAG
MONTHLYLIMIT
MAXCALLFLAG
MAXCALLS
BALANCE
CALLINGSCREENTYPE
2-202
It is the flag
indicating the
monthly limit.
[Value Range]
It is the
monthly limit.
[Value Range]
It is the flag
indicating the
maximum
follow-on calls
restriction.
[Value Range]
It is the
maximum
follow-on calls.
[Value Range]
It is the card
balance.
[Value Range]
It is the user
level calling
screen type.
[Value Range]
0: none
1: money

268435455.
0: No
1: Yes

-268435455 to 268435455.
0: None
1: Permitted
Issue 01 (2008-01-28)

Parameter
Description
Value Range
2: Restricted
CALLEDSCREENTYPE
It is the called
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
3: Direct Dial
DIRECTDIALPSTN
It is the directly
dialed number.
[Value Range]
digits.
CALLEDSCREENTYPE is set to 3.
CARDBLKCLEARFLAG
CARDBLKCLEARTIME
PLYDURATIONAVAILFG
PLYBALANCEFLAG
Issue 01 (2008-01-28)
It is the flag
indicating the
card blacklist
automatic
clearing.
[Value Range]
0: No
It is card
blacklist
clearing time.
[Value Range]
It is the flag
indicating the
available
duration
prompt.
[Value Range]
0: No
It is the flag
indicating the
balance prompt.
[Value Range]
0: not playing
1: Yes

999999999.
1: Yes
1: playing a balance prompt in any

cases

minimum balance

minimum daily limit

the card monthly limit is less than
the minimum monthly limit

minimum balance, when the card
daily limit, or when the card
2-203

Parameter
Description
PLYDURATIONFLAG
PLYCOSTFLAG
PLYNEWBALFLAG
BEEPFLAG
Value Range

daily limit


minimum daily limit, or when the
card monthly limit is less than the
It is the flag
indicating the
duration
prompt.
[Value Range]
It is the flag
indicating the
call fee prompt.
[Value Range]
It is the flag
indicating the
new balance
prompt.
[Value Range]
0: No
It is the BEEP
tone playing
object.
[Value Range]
0: No
1: Yes
0: No
1: Yes
1: Yes
0: BEEP tone not required

1: playing the tone to the caller
2: playing the tone to the called
3: playing the tone to the caller and
the called
CREDITLIMIT
TAXRATE2
It is the credit
quota.
[Value Range]
It is the tax rate.
[Value Range]

65535.

100000.
BINDFLAG
SIMUCALLFLAG
2-204
It indicates
whether the
card can be
bound.
[Value Range]
It indicates
whether
[Value Range]
0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
DESTAREARESFG
AREARESVALUE
Description
Value Range
simultaneous
calls are
allowed for the
card.
0: Restrict
It is the flag
indicating the
destination area
restriction.
[Value Range]
0: restriction disabled
It is the area
restriction
value.
[Value Range]
1: Permit
1: restriction valid

0: without restriction
31: all areas restricted
5-bit map, 1 bit per area:
bit 0: international
bit 1: national
bit 2: local
bit 3: CPP Urban mobile phones
bit 4: CPP Inter Urban mobile phones
AUTODLTFLG
ENABLEFLAG
It indicates
whether auto
deletion is
allowed.
[Value Range]
0: No
It indicates
whether the
current card is
available.
[Value Range]
0: available
1: Yes
1: unavailable (set by the SP)

2: unavailable (set by the Superadm)
When it is set to 2, the SP cannot
modify the value.
DISCOUNTRATE
It is the
discount rate of
the charge rate.
[Value Range]
PERIODBONUS
It is the validity
period
presented to
end users.
[Value Range]
It is the flag
indicating the
recharge card.
[Value Range]
RECHARGINGFLG

32767.
The unit is day, and the default value
is 60.
0: a one-off recharge card

1: a multi-time recharge card
2: a non-recharge card
Issue 01 (2008-01-28)
2-205

Parameter
Description
Value Range
UBPFUNCFLG
It indicates
whether to
support the
UBP feature.
[Value Range]
0: No
1: Yes
It is disabled when the current product
has the UBP feature.
DEFAULTLAN
It is the default
language types
of prompt
voices at the
user level.
[Value Range]
It is an integer.
It is 1 or a language type defined in
the system language definition table.
When it is set to 1, the user does not
set the default language type.
CALLDURATIONEXP
It is the call
duration
ensured by a
probation card.
[Value Range]
It is an integer greater than or equal to
0 and smaller than SPMaxCallTime of
the SP.
It is enabled only for a probation card.
CALLINGCATESCREEN
It is the call
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
AUTHPINFLG
DISPLAYCALLINGFLG
It indicates
whether to enter
PIN in
authentication.
[Value Range]
0: No
It is the call
screen type.
[Value Range]
1: Yes
0: None
1: Permitted
2: Restricted
OPTRAUTOCLEAR
OPTRAUTOCLEARTIME
2-206
It is the flag
indicating
whether to clear
the blacklist
from the
SMAP/MML
automatically.
[Value Range]
It is the time of
clearing the
blacklist from
the
[Value Range]
It is an integer in [1, 999999999].
0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
USAGEBONUS
Description
Value Range
SMAP/MML
automatically.
OPTRAUTOCLEAR is set to 1.
It is usage
bonus.
[Value Range]
0: None
The default value is 24h.
1: Accumulated
2: Period
ABBRACCOUNTFLG
FAMNUMFLG
FAMNUMDISCOUNT
It is the
function of
abbreviated
account
number.
[Value Range]
It is the
function of
familiarity
number.
[Value Range]
It is the
discount for
familiarity
numbers.
[Value Range]
0: No
1: Yes
0: No
1: Yes

FAMNUMFLG is set to 1.
FAMNUMMAX
It is the
maximum
number of
familiarity
numbers.
[Value Range]
FAMNUMFLG is set to 1.
MAXRECHARGETIMES
It is the
maximum
recharge times.
[Value Range]
2147483647.
The value 0 indicates no restriction.
RECHARGEFLAG is set to 1.
MOBILEPHONE
SMFLAG
Issue 01 (2008-01-28)
It is the mobile
phone number
registered for
receiving short
messages.
[Value Range]
It is the flag
indicating
whether to
support the
[Value Range]
0: No
digits.
1.
1: Yes
2-207

Parameter
Description
Value Range
short message
function.
It is enabled when
the product supports the short
message function.
SENDDURATIONFLAG,
SENDCOSTFLAG and
SENDDURATIONFLAG
SENDCOSTFLAG
It is the flag
indicating
whether to send
the call
duration.
[Value Range]
0: No
It is the flag
indicating
whether to send
the call cost.
[Value Range]
0: No
1: Yes
1.
1: Yes
1.
SENDBALFLAG
CALLFUNCFLAG
MESSFUNCFLAG
It is the flag
indicating
whether to send
the card
balance.
[Value Range]
0: No
It is the flag
indicating
whether the
card supports
the call
function.
[Value Range]
It is the flag
indicating
whether to
support the
voice message
function.
[Value Range]
0: No
1: Yes
1.
0: No
1: Yes
1: Yes
It is enabled when
the product supports the voice
message function.
Output Parameters
ACK: MODI PPS CARDINFO: RETN =, DESC =
2-208
Issue 01 (2008-01-28)

Table 2-199 Description of the output parameters of: MODI PPS CARDINFO
Parameter
RETN
Description
3501: Nothing will be updated. Besides SPID and

ACCOUNTNUMBER are mandatory, need an optional parameter at
least.
3502: The calling binding feature license is disabled.
3503: You can not modify the balance of the card. Otherwise, the total
balance of batch XXX will exceed 999999999999999999.
3504: The card is child card, can not modify the BALANCE.
3505: The card is child card, can not modify the

PLYBALANCEFLAG.

PLYNEWBALFLAG.
3507: The card is child card, can not modify the PERIODBONUS.

RECHARGINGFLG.
3509: The card is child card, can not modify the UBPFUNCFLG.
3510: The card is child card, can not modify the PACKAGEID.
3511: The Default Language has not been defined.
3512: The UBP feature license is disabled.
3513: The product does not allow that the card has UBP feature.
3514: The batch does not allow that the card has UBP feature.
3515: The accumulate bonus feature license is disabled.
3516: The abbreviate account feature license is disabled.

3517: The familiarity number feature license is disabled.

3518: The available call duration of a probation card cannot be longer

than the maximum call duration.
3519: This is a probation card, in which the available call duration is

not allowed to enter.
3520: The batch level parameter does not exist.

DESC

operation.
Example
MODI PPS CARDINFO: SPID = 123, ACCOUNTNUMBER = 123456789,
SERVICESTART = 2005010101120000, SERVICESTOP = 20051231120000
Issue 01 (2008-01-28)
2-209

2.7.5 Changing the Password of a Card

Command Name
CHNG PPS CARDPSWD
Command Function
This command is used to change the password of a card.
Input Parameters
CHNG PPS CARDPSWD: SPID =, CARDNO =, NEWPSWD =, OPERTYPE = [,
OLDPSWD =]
Table 2-200 Description of the input parameters of: CHNG PPS CARDPSWD
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the card
number.
[Value Range]
CARDNO
digits.
NEWPSWD
It is the new
password of the card
[Value Range]
If PIN Number in the service level
parameter configuration table is set to
a fixed value, the length of value of
the parameter NEWPSWD will be
that represented by the value of the
service level parameter Password
Length.
OPERTYPE
It is the type of
operation.
[Value Range]
0: self-service
1: management function
OLDPSWD
It is the original
password of the card
[Value Range]
parameter configuration table is set to
a fixed value, the length of value of
the parameter OLDPSWD will be that
represented by the value of the service
2-210
Issue 01 (2008-01-28)

Parameter
Description
Value Range
level parameter Password Length.
It is disabled when OPERTYPE is set
to 1.
Output Parameters
ACK: CHNG PPS CARDPSWD: RETN =, DESC =
Table 2-201 Description of the output parameters of: CHNG PPS CARDPSWD
Parameter
RETN
Description
3601: The length of the new password is incorrect.
3602: The old password of the card is incorrect.
3603: The password of the card is not allowed to be changed when the
card has no password.
3604: The batch change password feature is disabled.
3605: The new password must be different from the old password.

DESC

operation.
Example
CHNG PPS CARDPSWD: SPID = 123, CARDNO = 345, NEWPSWD = 123456,
OPERTYPE = 0
2.7.6 Binding a Calling Number

Command Name
BIND PPS CARD
Command Function
This command is used to bind a card to a calling number.
Input Parameters
BIND PPS CARD: CALLNO =, BNDCALLPSWDFLAG = [, BNDCALLPSWD =],
CARDNO =
Issue 01 (2008-01-28)
2-211

Table 2-202 Description of the input parameters of: BIND PPS CARD
Parameter
Description
Value Range
CALLNO
It is the calling
number to which a
card is bound. It
consists of country
code, area code and
local telephone
number.
[Value Range]
It indicates whether
a password is
required when
initiating a call with
a bound card.
[Value Range]
It is the password
for initiating calls
with a bound card.
[Value Range]
BNDCALLPSWDFLAG
BNDCALLPSWD
digits.
It is unique in this table.
When the parameter
BINDINGMODE is set to 1, the
value of the field is not unique.
0: No
1: Yes
digits.
It is enabled only when the parameter
BINDCALLPSWFLAG is set to 1.
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: BIND PPS CARD: RETN =, DESC =
Table 2-203 Description of the output parameters of: BIND PPS CARD
Parameter
RETN
Description
3701: The card is not allowed to be bound.
2-212
3703: The calling number does not exist in the calling binding screen list.
3704: The calling number has already been bound.
3705: The card has already been bound.
3706: The balance of the card is less than the minimum balance to bind
card.
Issue 01 (2008-01-28)

Parameter
Description
3707: The length of the binding password must be X-Y.
3708: The card can not be bound through MML command.

DESC

operation.
Example
BIND PPS CARD: CALLNO = 0755123456, BNDCALLPSWDFLAG = 1, CARDNO =
123456789
2.7.7 Unbinding a Calling Number

Command Name
UNBIND PPS CARD
Command Function
This command is used to unbind a calling number.
Input Parameters
UNBIND PPS CARD: [CARDNO =] [, CALLNO =] [, UNBNDPSWD =]
Table 2-204 Description of the input parameters of: UNBIND PPS CARD
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
CARDNO will be represented by
the value of Card Number Length.
CALLNO
Issue 01 (2008-01-28)
It is the calling
number to which a
card is bound. It
consists of country
code, area code and
local telephone
number.
[Value Range]
digits.
2-213

Parameter
Description
Value Range
UNBNDPSWD
It is the password
required to be
entered when
unbinding a card or
a calling number.
[Value Range]
digits.
Output Parameters
ACK: UNBIND PPS CARD: RETN =, DESC =
Table 2-205 Description of the output parameters of: UNBIND PPS CARD
Parameter
Description
RETN

3801: The card is not allowed to be unbound.
3803: The card has not been bound to the calling number yet.
3804: The unbinding password is incorrect.
3805: This calling binding does not exist.
3806: The card is not loaded or activated, thus cannot be unbound.
3809: The service does not have the calling binding feature.
3810: The service provider does not have the binding feature.
3811: The binding flag is disabled, and the card cannot be unbound

DESC

Example
UNBIND PPS CARD: CARDNO = 123456789, CALLNO = 0755123456
2.7.8 Changing the Card-Binding Password

Command Name
MODI PPS BNDPSWD
Command Function
This command is used to change the password when setting the binding function.
2-214
Issue 01 (2008-01-28)

Input Parameters
MODI PPS BNDPSWD: CARDNO =, BNDCALLPSWDFLAG = [, OLDBNDPSWD =] [,
NEWBNDPSWD =]
Table 2-206 Description of the input parameters of: MODI PPS BNDPSWD
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
Number Length is set to a fixed value,
the length of value of CARDNO will
be represented by the value of Card
Number Length.
BNDCALLPSWDFLAG
OLDBNDPSWD
It indicates
whether a
password is
required when
initiating a call
with a bound card.
[Value Range]
It is the original
password of the
card.
[Value Range]
0: No
1: Yes

parameter configuration table is set to a
fixed value, the length of value of the
parameter OLDPSWD will be that
The parameter OLDBNDPSWD is
compulsory when
BNDCALLPSWDFLAG is set to 1.
NEWBNDPSWD
It is the new
password of the
card.
[Value Range]
parameter configuration table is set to a
fixed value, the length of value of the
parameter NEWPSWD will be that
The parameter NEWBNDPSWD is
compulsory when
BNDCALLPSWDFLAG is set to 1.
Output Parameters
ACK: MODI PPS BNDPSWD: RETN =, DESC =
Issue 01 (2008-01-28)
2-215

Table 2-207 Description of the output parameters of: MODI PPS BNDPSWD
Parameter
RETN
Description
4301: The original binding password of the card is incorrect

4302: The binding password is not allowed to be changed, because the

card has not been bound.
4307: The binding password of the card is not allowed to be changed.
4308: The length of the binding password must be X-Y.

DESC

operation.

Example
MODI PPS BNDPSWD: CARDNO = 123456789, BNDCALLPSWDFLAG = 0
2.7.9 Querying the Binding Status of a Calling Number(or a Card

Number)
Command Name
LIST PPS CALLBND
Command Function
This command is used to query the binding status of a calling number or a card number.
Input Parameters
LIST PPS CALLBND: [SPID =] [, CARDNO =] [, CALLNO =][, USRTYPE=]
Table 2-208 Description of the input parameters of: LIST PPS CALLBND
2-216
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
CALLNO
It is the calling
number to which a
card is bound.
[Value Range]
digits.
USRTYPE
It indicates user type
[Value Range]

0:For Operator GUI

1:For Personal Card GUI
Output Parameters
ACK: LIST PPS CALLBND: RETN =, DESC = [, ATTR =, RESULT =, TOTAL =, SN =,
NUMOF =, FINISHED =]
Table 2-209 Description of the output parameters of: LIST PPS CALLBND
Parameter
Description
RETN

3902: The binding information of calling number or card does not exist.
3903: The parameter of CARDNO or CALLNO is expected.
3904: The service provider does not have the card.

DESC
ATTR

operation.
SPID& CALLNO&CARDNO
RESULT
TOTAL
Issue 01 (2008-01-28)
2-217

Parameter
Description
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CALLBND: SPID = 123, CARDNO = 123456789, CALLNO = 0755123456
2.7.10 Adding the Calling Screen Information

Command Name
ADD PPS CARDCALLINGSCREEN
Command Function
This command helps is used to add the calling screen information to different level entity,
with a specified screen type. The different level entity can be the service, the SP, the product,
the batch or the card. No optional parameter is entered indicates the level entity is the service.
Input Parameters
ADD PPS CARDCALLINGSCREEN: [SPID =,] [PRODUCTID =,] [BATCH =,]
[CARDNO =,] COUNTRYCODE =, SCREENNUMBER =, SCREENTYPE =
Table 2-210 Description of the input parameters of: ADD PPS CARDCALLINGSCREEN
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is the card
number.
[Value Range]
PRODUCTID
BATCH
CARDNO
2-218

999.
digits.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
COUNTRYCODE
It is the country
code.
[Value Range]
99999999.
The value 1 indicates all countries.
A value other than 1 indicates a
specified country code.
SCREENNUMBER
SCREENTYPE
It is the screen
number.
[Value Range]
It is the screen type.
[Value Range]
digits.
0: Permitted
1: Restricted
Output Parameters
ACK: ADD PPS CARDCALLINSCREEN: RETN =, DESC =
Table 2-211 Description of the output parameters of: ADD PPS CARDCALLINGSCREEN
Parameter
Description
RETN

DESC

operation.
Example
ADD PPS CARDCALLINGSCREEN: SPID = 123, COUNTRYCODE = 2,
SCREENNUMBER = 10, SCREENTYPE = 0
2.7.11 Querying the Calling Screen Information

Command Name
LIST PPS CARDCALLINGSCREEN
Command Function
This command is used to query the caller screen information of a SP.
Issue 01 (2008-01-28)
2-219

Input Parameters
LIST PPS CARDCALLINGSCREEN: [SPID =,] [PRODUCTID =,] [BATCH =,]
[CARDNO =,] [SCREENTYPE =]
Table 2-212 Description of the input parameters of: LIST PPS CARDCALLINGSCREEN
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is the card
number.
[Value Range]
PRODUCTID
BATCH
CARDNO
SCREENTYPE

999.
digits.
[Value Range]
0: Permitted
1: Restricted
Output Parameters
ACK: LIST PPS CARDCALLINGSCREEN: RETN =, DESC = [, TOTAL =, FINISHED =,
SN =, NUMOF =, ATTR =, RESULT =]
Table 2-213 Description of the output parameters of: LIST PPS CARDCALLINGSCREEN
Parameter
Description
RETN

3305: The beginning serial number cannot be greater than the end serial
number.
3306: The beginning number of a card cannot be greater than the end
number.

DESC
2-220
Issue 01 (2008-01-28)

Parameter
Description
operation.
ATTR
COUNTRYCODE& SCREENNUMBER& SCREENTYPE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CARDCALLINGSCREEN: SPID = 123, CARDNO = 123456
2.7.12 Deleting the Calling Screen Information

Command Name
DELE PPS CARDCALLINGSCREEN
Command Function
This command is used to delete the calling screen information of a SP.
Input Parameters
DELE PPS CARDCALLINGSCREEN: [SPID =,] [PRODUCTID =,] [BATCH =,]
[CARDNO =,] COUNTRYCODE =, SCREENNUMBER =
Table 2-214 Description of the input parameters of: DELE PPS CARDCALLINGSCREEN
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the unique
[Value Range]
PRODUCTID
Issue 01 (2008-01-28)
2-221

Parameter
BATCH
CARDNO
COUNTRYCODE
Description
Value Range
identifier of a
product.

999.
It is the unique
[Value Range]
It is the card
number.
[Value Range]
It is the country
code.
[Value Range]
digits.

99999999.
SCREENNUMBER
It is the screen
number.
[Value Range]
digits.
Output Parameters
ACK: DELE PPS CARDCALLINGSCREEN: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-215 Description of the output parameters of: DELE PPS CARDCALLINGSCREEN
Parameter
Description
RETN

DESC
ATTR

operation.
RESULT
2-222
Issue 01 (2008-01-28)

Example
DELE PPS CARDCALLINGSCREEN: SPID = 123, PRODUCTID = 123, BATCH =
123456, CARDNO = 100, COUNTRYCODE = 2, SCREENNUMBER = 10
2.7.13 Adding the Called Screen Information

Command Name
ADD PPS CARDCALLEDSCREEN
Command Function
This command is used to add the called screen information to different level entity, with
specified screen type. The different level entity can be the service, the SP, the product, the
batch or the card.
Input Parameters
ADD PPS CARDCALLEDSCREEN: [SPID =,] [PRODUCTID =,] [BATCH =,] [CARDNO
=,] COUNTRYCODE =, AREACODE =, SCREENNUMBER =, SCREENTYPE =
Table 2-216 Description of the input parameters of: ADD PPS CARDCALLEDSCREEN
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
PRODUCTID
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is the card
number.
[Value Range]
It is the country
code.
[Value Range]
BATCH
CARDNO
COUNTRYCODE

999.
digits.

99999999.
AREACODE
It is the area code.
[Value Range]
99999999.
The value 1 indicates all area code.
Issue 01 (2008-01-28)
2-223

Parameter
Description
Value Range
specified area code.
SCREENNUMBER
SCREENTYPE
It is the screen
number.
[Value Range]
[Value Range]
digits.
0: Permitted
1: Restricted
Output Parameters
ACK: ADD PPS CARDCALLEDSCREEN: RETN =, DESC =
Table 2-217 Description of the output parameters of: ADD PPS CARDCALLEDSCREEN
Parameter
Description
RETN

DESC

operation.
Example
ADD PPS CARDCALLEDSCREEN: SPID = 123, PRODUCTID = 123, BATCH = 123456,
CARDNO = 10, COUNTRYCODE = 2, AREACODE = 2, SCREENNUMBER = 2,
SCREENTYPE = 0
2.7.14 Querying the Called Screen Information

Command Name
LIST PPS CARDCALLEDSCREEN
Command Function
This command is used to query the called screen information of an SP.
Input Parameters
LIST PPS CARDCALLEDSCREEN: [SPID =,] [PROCUCTID =,] [BATCH =,] [CARDNO
=,] [SCREENTYPE =]
2-224
Issue 01 (2008-01-28)

Table 2-218 Description of the input parameters of: LIST PPS CARDCALLEDSCREEN
Parameter
Description
Value Range
SPID

a service provider.
[Value Range]

a product.
[Value Range]

a batch.
[Value Range]
It is the card number.
[Value Range]
PRODUCTID
BATCH
CARDNO

999.
It is -2 or an integer in the range

0 to 999.
digits.
SCREENTYPE
[Value Range]
0: Permitted
1: Restricted
Output Parameters
ACK: LIST PPS CARDCALLEDSCREEN: RETN =, DESC = [, TOTAL =, FINISHED =,
SN =, NUMOF =, ATTR =, RESULT =]
Table 2-219 Description of the output parameters of: LIST PPS CARDCALLEDSCREEN
Parameter
Description
RETN

DESC

operation.

ATTR
COUNTRYCODE&AREACODE &SCREENNUMBER& SCREENTYPE
RESULT
TOTAL
FINISHED

0: No
Issue 01 (2008-01-28)
2-225

Parameter
Description
1: Yes
SN

NUMOF
Example
LIST PPS CARDCALLEDSCREEN: SPID = 123, CARDNO = 123456
2.7.15 Deleting the Called Screen Information

Command Name
DELE PPS CARDCALLEDSCREEN
Command Function
This command is used to delete the called screen information of a specified SP.
Input Parameters
DELE PPS CARDCALLEDSCREEN: [SPID =,] [PRODUCTID =,] [BATCH =,]
[CARDNO =,] COUNTRYCODE =, AREACODE =, SCREENNUMBER =
Table 2-220 Description of the input parameters of: DELE PPS CARDCALLEDSCREEN
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
It is the card
number.
[Value Range]
It is the country
code.
[Value Range]
PRODUCTID
BATCH
CARDNO
COUNTRYCODE

999.
digits.

99999999.
2-226
Issue 01 (2008-01-28)

Parameter
Description
Value Range
AREACODE
It is the area code.
[Value Range]
99999999.
The value 1 indicates all area code.
specified area code.
SCREENNUMBER
It is the screen
number.
[Value Range]
digits.
Output Parameters
ACK: DELE PPS CARDCALLEDSCREEN: RETN =, DESC = [,ATTR=, RESULT=]
Table 2-221 Description of the output parameters of: DELE PPS CARDCALLEDSCREEN
Parameter
Description
RETN

DESC
ATTR

operation.
TOTAL&SUCCESSNUM&FAILNUM
RESULT
Example
DELE PPS CARDCALLEDSCREEN: SPID = 123, PRODUCTID = 123, BATCH =
123456, CARDNO = 10, COUNTRYCODE = 2, AREACODE = 2, SCREENNUMBER = 0
2.7.16 Adding the Abbreviated Number

Command Name
ADD PPS ABBRDIAL
Issue 01 (2008-01-28)
2-227

Command Function
This command is used to add the abbreviated number of a single card.
Input Parameters
ADD PPS ABBRDIAL: CARDNO =, ABBRNO =, PSTNNUM =
Table 2-222 Description of the input parameters of: ADD PPS ABBRDIAL
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number of a PSTN
number.
[Value Range]
ABBRNO
digits.

PSTNNUM

number the
abbreviated number
corresponds to.
[Value Range]
digits, consisting of country code, area
code and local telephone number.
other.
Output Parameters
ACK: ADD PPS ABBRDIAL: RETN =, DESC = [, TOTAL =] [, SUCCESSNUM=] [,
FAILNUM=] [, FAILINFO =]
Table 2-223 Description of the output parameters of: ADD PPS ABBRDIAL
2-228
Parameter
Description
RETN

1402: The abbreviated codes are already used in the card.
8100: The Abbreviated number has already existed in table

PPS_Abbreviate_Bth.
8105: The Abbreviated number has already existed in table

PPS_Abbreviate.
Issue 01 (2008-01-28)

Parameter
Description
DESC

operation.
TOTAL
SUCCESS
NUM
It is the number of abbreviated numbers which have been added

successfully.
FAILNUM
It is the number of abbreviated numbers which have not been added

successfully.
FAILINFO
It is the information of failure.

The format is ABBRNUM|ERRORNO|ERRORINFO&
ABBRNUM|ERRORNO|ERRORINFO.
Example
ADD PPS ABBRDIAL: CARDNO = 999999, ABBRNO = "1", PSTNNUM = "1211346"
2.7.17 Modifying the Abbreviated Number

Command Name
MODI PPS ABBRDIAL
Command Function
This command is used to modify an abbreviated number of a single card.
Input Parameters
MODI PPS ABBRDIAL: CARDNO =, ABBRNO =, PSTNNUM =
Table 2-224 Description of the input parameters of: MODI PPS ABBRDIAL
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number of a PSTN
number.
[Value Range]
ABBRNO
Issue 01 (2008-01-28)
digits.

2-229

Parameter
Description
Value Range
PSTNNUM

number the
abbreviated number
corresponds to.
[Value Range]
area code and local telephone number.
other.
Output Parameters
ACK: MODI PPS ABBRDIAL: RETN =, DESC =
Table 2-225 Description of the output parameters of: MODI PPS ABBRDIAL
Parameter
Description
RETN

7251: The abbreviated number does not exist.
8215: The abbreviated number already exists.
8300: The abbreviated number to be changed has already existed in the

batch abbreviated number.

DESC

operation.
Example
MODI PPS ABBRDIAL: CARDNO = 1101268, ABBRNO = 1, PSTNNUM = 1200433
2.7.18 Querying the Abbreviated Number

Command Name
LIST PPS ABBRDIAL
2-230
Issue 01 (2008-01-28)

Command Function
This command is used to query the abbreviated number information of a single card.
Input Parameters
LIST PPS ABBRDIAL: CARDNO = [, PSTNNUM =] [, ABBRNO =]
Table 2-226 Description of the input parameters of: LIST PPS ABBRDIAL
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number of a PSTN
number.
[Value Range]
ABBRNO
digits.

PSTNNUM

number the
abbreviated number
corresponds to.
[Value Range]
digits, consisting of country code, area
code and local telephone number.
other.
Output Parameters
ACK: LIST PPS ABBRDIAL: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-227 Description of the output parameters of: LIST PPS ABBRDIAL
Parameter
Description
RETN

DESC
Issue 01 (2008-01-28)

operation.
2-231

Parameter
Description
ATTR
ABBRNO& PSTNNUM
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS ABBRDIAL: CARDNO = 1101268, ABBRNO = 1, PSTNNUM = 7830245
2.7.19 Deleting the Abbreviated Number

Command Name
DELE PPS ABBRDIAL
Command Function
This command is used to delete abbreviated numbers of a single card.
Input Parameters
DELE PPS ABBRDIAL: CARDNO = [, ABBRNO =]
Description of the input parameters of: DELE PPS ABBRDIAL
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number of a PSTN
number.
[Value Range]
ABBRNO
2-232
It is a numerical string of 3 to
20 digits.

99, with multiple abbreviated
numbers being separated with
an ampersand (&) from each
Issue 01 (2008-01-28)

Parameter
Description
Value Range
other.
are entered, they must be
enclosed by double quotation
marks.
Output Parameters
ACK: DELE PPS ABBRDIAL: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-228 Description of the output parameters of: DELE PPS ABBRDIAL
Parameter
Description
RETN

1502: The abbreviated codes are not set in the card.
7310: The abbreviated number to be deleted does not exist in

PPS_Abbreviate table.

DESC
ATTR

operation.
RESULT
Example
DELE PPS ABBRDIAL: CARDNO = 88888, ABBRNO = "1&2"
2.7.20 Querying Familiarity Number and Relating Discount

Command Name
DISP PPS CARDFLYNUMBER
Command Function
This command is used to query the familiarity number and relating discount of a card.
Issue 01 (2008-01-28)
2-233

Input Parameters
DISP PPS CARDFLYNUMBER: CARDNO =, SPID =
Table 2-229 Description of the input parameters of: DISP PPS CARDFLYNUMBER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the unique
[Value Range]
SPID
digits.
Output Parameters
ACK: DISP PPS CARDFLYNUMBER: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
NUMOF =, ATTR =, RESULT =] [, FLYNUMDISCOUNT =]
Table 2-230 Description of the output parameters of: DISP PPS CARDFLYNUMBER
Parameter
Description
RETN

5202: The familiarity number flag is disabled.

DESC
ATTR

operation.
SEQNO& FAMILYNUMBER
2-234
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
DISP PPS CARDFLYNUMBER: CARDNO = 10, SPID = 123
2.7.21 Querying Card Number PIN

Command Name
DISP PPS CARDPIN
Command Function
This command is used to query the password of a batch of cards of a product provided by an
SP.
Input Parameters
DISP PPS CARDPIN: [CARDNO =,] SPID =, PRODUCTID =, BATCH =
Table 2-231 Description of the input parameters of: DISP PPS CARDPIN
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
SPID
It is the unique
identifier of a
service provider.
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
It is the unique
[Value Range]
PRODUCTID
BATCH

999.

az or AZ or 09.
Output Parameters
ACK: DISP PPS CARDPIN: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-232 Description of the output parameters of: DISP PPS CARDPIN
Parameter
Description
RETN

Issue 01 (2008-01-28)
2-235

Parameter
Description
DESC

operation.
ATTR
CARDNUMBER& PIN
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS CARDPIN: SPID = 123, PRODUCTID = 11, BATCH = 123
2.7.22 Deducting Charge

Command Name
DEDU PPS CARD
Command Function
This command is used to deduct charge from a card when the user wants to pay fees through
Web SMAP.
Input Parameters
DEDU PPS CARD: CARDNO =, [PWD =], AMOUNT =
Table 2-233 Description of the input parameters of: DEDU PPS CARD
2-236
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
PWD
It is the password of
the card number.
[Value Range]
AMOUNT
It is the amount of
recharging.
[Value Range]
268435455.
Output Parameters
ACK: DEDU PPS CARD: RETN =, DESC =
Table 2-234 Description of the output parameters of: DEDU PPS CARD
Parameter
Description
RETN

6201: The card is not in the validity period.
6202: The card is a probation card, it is not allowed to be deducted

charge.
6203: The card is blocked.
6204: The balance of the card is less than the amount to deduct.
6205: The product XXX of the card is blocked
6206: The card can not to be deducted when the product is postpaid.
6207: The batch XXX of the card is blocked
6208: The main card does not exist.
6209: The main card is in use.
6210: The main card is not in the validity period.
6211: The main card is a probation card, it is not allowed to be

deducted charge.
6212: The main card is blocked.
6213: The card is in blacklist.
6214: The main card is in blacklist.
6215: The balance of the main card is less than the amount to deduct.
6216: Sorry, you have surpassed the maximum exes for today.
6217: Sorry, you have surpassed the maximum times for attempted
calls for today.
6218: Sorry, you have surpassed the maximum exes for this month.
6219: The main card has been canceled.
6220: The card has been canceled.

DESC
Issue 01 (2008-01-28)

operation.
2-237

Parameter
Description
Example
DEDU PPS CARD: CARDNO = 123, PWD = 8888, AMOUNT = 10
2.7.23 Recharging by a Card

Command Name
CARDRECHG PPS CARD
Command Function
This command is used to recharge by a card.
Input Parameters
CARDRECHG PPS CARD: SRCCARD =, DESCARD =, AMOUNT =, [PWD =]
RECHARGETYPE =
Table 2-235 Description of the input parameters of: CARDRECHG PPS CARD
Parameter
Description
Value Range
SRCCARD
It is the source card

number.
[Value Range]
card number.
[Value Range]
It is the amount of
recharging.
[Value Range]
the source card
number.
[Value Range]
It is the recharge
type.
[Value Range]
It is a one-digit number.
DESCARD
AMOUNT
PWD
RECHARGETYPE
digits.
digits.

268435455.
digits.
0: recharge with PPS card

2: balance transfer
2-238
Issue 01 (2008-01-28)

Output Parameters
ACK: CARDRECHG PPS CARD: RETN =, DESC =
Table 2-236 Description of the output parameters of: CARDRECHG PPS CARD
Parameter Name
Description
RETN

Issue 01 (2008-01-28)
1151: The card to be recharged exceeds the maximum

recharge times, and it cannot be recharged.
1152: The card to be recharged exceeds the daily maximum

available amount. It cannot be recharged.
1153: The card to be recharged exceeds the daily maximum

available times. It cannot be recharged.
1154: The card to be recharged exceeds the monthly

maximum available amount. It cannot be recharged.
1155: The recharge card is not activated. It is not available.
1156: The recharge card is in the blacklist. It is not available.
1157: The recharge card is not available.
1158: The batch to which the recharge card belongs is not

available.
1159: The recharge card is bound. It cannot be used for

recharging.
1160: The recharge card does not exist.
1161: Either the card number or the password is wrong.
1162: The recharge card is in use. It cannot be used for

recharging.
1163: The recharge card is expired. It cannot be used for

recharging.
1164: Currency types are different. Cannot recharge.
1165: The balance of the card to be recharged is greater than

the system limit after recharge. Recharging failed.
1166: The balance of the recharge card is less than or equal to

0 after the tax is deducted. It cannot be used for recharging.
1167: The card to be recharged is a probation card. It cannot

be recharged.
1168: The target card is a postpaid card. It cannot be

recharged.
1169: The target card is a child card. It cannot be recharged.
1170: The recharge card is not rechargeable. It cannot be

recharged.
1171: System interval error, please try later.
1172: The card to be recharged does not exist.
1173: The recharge card is a child card. It cannot be used for

recharging.
2-239

Parameter Name
2-240
Description
1174: The product to which the recharge card belongs is not

available.
1175: The recharge card cannot recharge the card of the

service.
1176: The service provider level to which the recharge card

belongs cannot be used for portion recharge.
1177: The card cannot be used for recharging.
1178: The recharge card is a probation card. It cannot be used

for recharging.
1179: The recharge card and the card to be recharged do not

belong to the same service provider. Cannot recharge.
1180: The recharge card and the card to be recharged do not

belong to the same product. Cannot recharge.
1181: The recharge card is a postpaid card. It cannot be used

for recharging.
1182: The recharge card cannot recharge multiple times. It

cannot be used for portion recharge.
1183: The recharge card is used in other service. It cannot

recharge the cards of the service.
1184: The recharge amount exceeds the balance of the

recharge card.
1185: The recharge amount is less than the management fee.

Cannot recharge.
1186: The recharge amount reaches the upper limit. Cannot

recharge.
1187: The target card is not activated. It cannot be recharged.
1188: The recharge card is not available.
1189: The batch to which the card to be recharged belongs is

not available.
1190: The product to which the card to be recharged belongs

is not available.
1191: The target card does not reach the validity date. It
cannot be recharged.
1192: The card to be recharged is expired. It cannot be

recharged.
1193: The recharge card is in the reservation period. It cannot

be used for recharging.
1194: The source card does not reach the validity data. It
cannot be used for recharging.
1195: The service level parameters are not set.
1196: The parameters of the service provider level are not

set.
1197: The parameters related to the charge of the service

provider are not set.
1198: The product level parameters are not set.
Issue 01 (2008-01-28)

Parameter Name
Description
1199: The card to be recharged is used in other service. It

cannot be recharged.
1200: The recharge card is expired. It cannot be used for

recharging.
1201: The batch level parameters of the recharge card are not
set. It cannot be used for recharging.
1202: The batch level parameters of the card to be recharged

are not set. It cannot be recharged.
1203: System internal error, Please try later.
1204: The recharge prolongation parameters are not set.

Recharge failed.
1205: The recharge amount is less than the minimum

recharge amount. Recharging failed.
1206: The recharge amount is more than the maximum

recharge amount. Recharging failed.
1207: The validity period of the destination card is accurate

to second. Recharging failed.
1300: The access information of the product does not exist.

DESC
ATTR


OPERATE_RESULT& RECHARGEDAMOUNT&
SRCACCAMTBEFORE& DSTACCAMTBEFORE&
SRCACCAMTAFTER& DSTACCAMTAFTER&
VALIDITYEXTENSION& PROMOTIONAMOUNT
Example
CARDRECHG PPS CARD: SRCCARD = 123, DESCARD = 456, AMOUNT = 10, PWD =
8888, UVCORPPS = 0
2.7.24 Verifying the Card Validity

Command Name
LOGGING PPS CARD
Issue 01 (2008-01-28)
2-241

Command Function
This command is used to verify the validity the specified cards and also verifies the passwords
of cards and whether the cards can be used.
Input Parameter
LOGGING PPS CARD: CARDNO = [, PSWD =]
Table 2-237 Description of the input parameters of: LOGGING PPS CARD
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
the card number.
[Value Range]
PSWD
Output Parameters
ACK: LOGGING PPS CARD: RETN =, DESC = [,ATTR=,RESULT=]
Table 2-238 Description of the output parameters of: LOGGING PPS CARD
Parameter
Description
RETN

5545: The card is not in the validity period.
5546: Cannot input password.
5547: Password error.
5548: The card is in blacklist.

5550: The card info isn't loaded correctly.

DESC
ATTR

operation.
SPID& PRODUCTID& ACCOUNTNUMBER& BATCH& BALANCE&
CURRENCYTYPE& CURRENCYNAME& DISPLAYUNIT& RATIO
RESULT
2-242
Issue 01 (2008-01-28)

Example
LOGGING PPS CARD: CARDNO = 1101268
LOGGING PPS CARD: CARDNO = 1101268, PSWD = 28654213
2.7.25 Querying the Information of Online-Sale Cards

Command Name
LIST PPS OLCARD
Command Function
This command is used to query the currency types and face value of the cards that can be sold
on line.
Input Parameters
LIST PPS OLCARD: SPID =, PRODUCTID =
Table 2-239 Description of the input parameters of: LIST PPS OLCARD
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
PRODUCTID

999.
Output Parameters
ACK: LIST PPS OLCARD: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-240 Description of the output parameters of: LIST PPS OLCARD
Parameter
Description
RETN

DESC
ATTR

operation.
CURRENCYTYPE& FACEVALUE
Issue 01 (2008-01-28)
2-243

Parameter
Description
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS OLCARD: SPID = 1, PRODUCTID = 1
2.7.26 Selling Cards Online

Command Name
SALE PPS OLCARD
Command Function
This command is used to randomly choose a PPS card that can be sold on line according to
conditions. This command also returns the information about the card.
Input Parameters
SALE PPS OLCARD: SPID =, PRODUCTID =, CURRENCY =, FACEVALUE =
Table 2-241 Description of the input parameters of: SALE PPS OLCARD
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the unique
identifier of a
product.
[Value Range]
CURRENCY
It is the currency
types defined in the
system currency
definition table.
[Value Range]
FACEVALUE
It is the card face
[Value Range]
PRODUCTID
2-244

999.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
value.

268435455.
Output Parameters
ACK: SALE PPS OLCARD: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-242 Description of the output parameters of: SALE PPS OLCARD
Parameter
RETN
Description
5520: Sale online card failed.
5521: There are not any online cards to be sold.

DESC
ATTR

operation.
SPID& PRODUCTID& CARDNO& PSWD& SERVSTART&
SERVSTOP& GSN& CURRENCYTYPE& FACEVALUE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
SALE PPS OLCARD: SPID = 1, PRODUCTID = 1, CURRENCY = 1, FACEVALUE = 100
Issue 01 (2008-01-28)
2-245

2.7.27 Querying Historical Records

Command Name
LIST PPS RECORDINFO
Command Function
This command is used to query the call history of the latest N times of a PPS card.
Input Parameters
LIST PPS RECORDINFO: CARDNO =
Table 2-243 Description of the input parameters of: LIST PPS RECORDINFO
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: LIST PPS RECORDINFO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-244 Description of the output parameters of: LIST PPS RECORDINFO
Parameter
Description
RETN

8401: Can not query the call records of the card.
DESC
ATTR

CALLINGNUMBER& STARTDATETIME& CALLDURATION&
CALLFEE& CURRENCYTYPE& DESTNUMBER
2-246
RESULT
TOTAL
FINISHED
Issue 01 (2008-01-28)

Parameter
Description
0: No
1: Yes
SN

NUMOF
Example
LIST PPS RECORDINFO: CARDNO = 12345678
2.7.28 Recharging
Command Name
RECHG PPS CARD
Command Function
This command is used to recharge a card.
Input Parameters
RECHG PPS CARD: SPID =, CARDNO =, AMOUNT =
Table 2-245 Description of the input parameters of: RECHG PPS CARD
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the card
number.
[Value Range]
It is the amount of
recharging.
[Value Range]
CARDNO
AMOUNT
digits.

268435455.
Output Parameters
ACK: RECHG PPS CARD: RETN =, DESC = [, SNO =]
Issue 01 (2008-01-28)
2-247

Table 2-246 Description of the output parameters of: RECHG PPS CARD
Parameter
RETN
Description
3551: The balance of the card can not be more than 268435455 after
the recharging operation.
3552: You can not recharge the card, otherwise the total balance of
batch XXX will exceed 999999999999999999.
3553: The card is not allowed to be recharged.
3554: The card is a postpaid card.
3555: The card is child card.

DESC
SNO

operation.
It is the serial number of successful recharging.

It is the unique identifier and it is an integer in the range 1 to
2147483647.
Example
RECHG PPS CARD: SPID = 123, CARDNO = 234, AMOUNT = 1000
2.7.29 Correcting Recharge

Command Name
CORRECT PPS CARDRECHG
Command Function
This command is used to correct recharge.
Input Parameters
CORRECT PPS CARDRECHG: CARDNO =, SNO = [, CORRAMOUNT =]
Table 2-247 Description of the input parameters of: CORRECT PPS CARDRECHG
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the serial
[Value Range]
SNO
2-248
digits.
Issue 01 (2008-01-28)

Parameter
CORRAMOUNT
Description
Value Range
number of
successful
recharging.
It is the unique identifier and it is an

integer.
It is the amount of
correct recharge.
[Value Range]

2147483647.

268435455.
When it is not entered, its default
value is 0.
Output Parameters
ACK: CORRECT PPS CARDRECHG: RETN =, DESC =
Table 2-248 Description of the output parameters of: CORRECT PPS CARDRECHG
Parameter
RETN
Description
5801: The card is not allowed to be recharged and corrected recharge.

5802: The card is a probation card, it is not allowed to be corrected

recharge.
5803: The recharge record does not exist.
5804: The service provider which the card belongs to does not allow the
card to be recharged and corrected recharge.
5805: The card is a postpaid card, so it is not allowed to be corrected

recharge.
5806: Balance after Recharged can not be less than 0.
5807: Balance after Recharged can not be larger than 268435455.
5808: New Recharge Amount is the same as the old one, so it's not
necessary to correct the recharge.

DESC

operation.
Example
CORRECT PPS CARDRECHG: CARDNO = 1234, SNO = 10, CORRAMOUNT = 10000
Issue 01 (2008-01-28)
2-249

2.7.30 Querying Recharge Logs

Command Name
LIST PPS RECHGLOG
Command Function
This command is used to query the logs generated while recharging through the telephone
management flow, or that through SMAP/MML which is called recharging by cash.
Input Parameters
LIST PPS RECHGLOG: DSTCARDNO = [, SRCCARDNO =], STARTDATEANDTIME =,
ENDDATEANDTIME =
Table 2-249 Description of the input parameters of: LIST PPS RECHGLOG
Parameter
Description
Value Range
DSTCARDNO
It is the card number

of the card to be
recharged.
[Value Range]
SRCCARDNO

of the card being
used to recharge
other cards.
[Value Range]
STARTDATEANDTI
ME
It is the start date

and time.
[Value Range]
ENDDATEANDTIME
It is the end date and

time.
[Value Range]

If this parameter is left blank, the
system obtains all the recharge logs
related to the destination recharge card
in the specified time segment.
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.
Output Parameters
ACK: LIST PPS RECHGLOG: RETN =, DESC = [, TOTAL =, FINISHED =, START =,
Table 2-250 Description of the output parameters of: LIST PPS RECHGLOG
2-250
Parameter
Description
RETN

5901: The card number of the destination recharge card cannot be null.
5902: The card numbers of the destination recharge card and the source
Issue 01 (2008-01-28)

Parameter
Description
recharge card must be different.
5904: The start time must be in the format of YYYYMMDDHHMMSS.

DESC
ATTR

operation.
SPID& PRODUCTID& SRCAREAID& DSTAREAID&
SRCACCNUMBER& DSTACCNUMBER& AMOUNTRECHARGED&
SRCACCAMTBEFORE& DSTACCAMTBEFORE&
DSTACCAMTAFTER& SRCCURRENCY& RECORDTIME&
PSTNNUMBER& VALIDITYEXTENSION&
PROMOTIONAMOUNT& DSTCURRENCY& DSTSERVICEKEY&
SUCCESSFLAG& TIMEZONEOFPDT& PDTCHARGERULE&
PREFIXOFBILL& CREATEDDATETIME& ACTIVEDATETIME&
FIRSTUSDDATETIME& RECHARGEDTYPE& SERVICEIDENTIFY
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS RECHGLOG: DSTCARDNO = 1234, SRCCARDNO = 5678,
STARTDATEANDTIME = 20051022000000, ENDDATEANDTIME = 20051101235959
2.7.31 Adding Familiarity Numbers

Command Name
ADD PPS CARDFLYNUMBER
Command Function
This command is used to add familiarity numbers of a specific card number.
Issue 01 (2008-01-28)
2-251

Input Parameters
ADD PPS CARDFLYNUMBER: CARDNO =, FAMILYNUMBER =
Table 2-251 Description of the input parameters of: ADD PPS CARDFLYNUMBER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number.
[Value Range]
FAMILYNUMBER
It is a numerical string of 2 to 20 digits

consisting of country code, area code
and local telephone number.
Output Parameters
ACK: ADD PPS CARDFLYNUMBER: RETN =, DESC =
Table 2-252 Description of the output parameters of: ADD PPS CARDFLYNUMBER
Parameter
Description
RETN

8922: This card does not support the familiarity number function.
8923: The service does not have the familiarity number feature.
8924: The familiarity number feature license is not available.
8925: The service provider corresponding to this card does not support
the familiarity number function.
8926: The familiarity number has already existed.
8927: Familiarity numbers has reached the threshold.
8928: This number cannot be set as a familiarity number.

DESC

operation.
Example
ADD PPS CARDFLYNUMBER: CARDNO = 1231546, FAMILYNUMBER = 4564232
2-252
Issue 01 (2008-01-28)

2.7.32 Querying Familiarity Numbers

Command Name
LIST PPS CARDFLYNUMBER
Command Function
This command is used to query all familiarity numbers of a specific card number.
Input Parameters
LIST PPS CARDFLYNUMBER: CARDNO =
Table 2-253 Description of the input parameters of: LIST PPS CARDFLYNUMBER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: LIST PPS CARDFLYNUMBER: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-254 Description of the output parameters of: LIST PPS CARDFLYNUMBER
Parameter
Description
RETN

8981: This card has no familiarity number.
DESC
ATTR

operation.
CARDNO& SEQNO& FAMILYNUMBER
RESULT
TOTAL
FINISHED

Issue 01 (2008-01-28)
0: No
2-253

Parameter
Description
1: Yes
SN

NUMOF
Example
LIST PPS CARDFLYNUMBER: CARDNO=2315346
2.7.33 Deleting Familiarity Numbers

Command Name
DELE PPS CARDFLYNUMBER
Command Function
This command is used to delete familiarity numbers of a specific card number.
Input Parameters
DELE PPS CARDFLYNUMBER: CARDNO =, FAMILYNUMBER =
Table 2-255 Description of the input parameters of: DELE PPS CARDFLYNUMBER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
number.
[Value Range]
FAMILYNUMBER
digits.
It is a numerical string of 2 to 20 digits

consisting of country code, area code
and local telephone number.
Output Parameters
ACK: DELE PPS CARDFLYNUMBER: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-256 Description of the output parameters of: DELE PPS CARDFLYNUMBER
Parameter
RETN
Description
2-254
8941: No familiarity number exists.
Issue 01 (2008-01-28)

Parameter
Description
DESC
ATTR

operation.
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DELE PPS CARDFLYNUMBER: CARDNO = 12314, FAMILYNUMBER = 123145
2.7.34 Card-related Users Settings

Command Name
ASSOCIATE PPS USER
Command Function
This command is used to set a related user for a specified card. One card can relate only with
one user.
Input Parameters
ASSOCIATE PPS USER: CARDNO =, USERID =
Table 2-257 Description of the input parameters of: ASSOCIATE PPS USER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
Issue 01 (2008-01-28)
2-255

Parameter
Description
Value Range
USERID
It is the ID of a user.
[Value Range]
2147483647.
Output Parameters
ACK: ASSOCIATE PPS USER: RETN =, DESC =
Table 2-258 Description of the output parameters of: ASSOCIATE PPS USER
Parameter
RETN
Description
9061: This card does not have the feature of associated subscribers.

9062: The service subscriber does not exist.
9063: This card is in use, which cannot be associated with subscribers.
9064: This card has set the association with subscribers.
9065: This is a probation card.

DESC

operation.
Example
ASSOCIATE PPS USER: CARDNO = 12465456, USERID = 123
2.7.35 Cancelling Card-related Users Settings

Command Name
CANCEL PPS USER
Command Function
This command is used to cancel a user related to a specified card.
Input Parameters
CANCEL PPS USER: CARDNO =
2-256
Issue 01 (2008-01-28)

Table 2-259 Description of the input parameters of: CANCEL PPS USER
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: CANCEL PPS USER: RETN =, DESC =
Table 2-260 Description of the output parameters of: CANCEL PPS USER
Parameter
Description
RETN

9083: This card is not associated with subscribers.
DESC

operation.
Example
CANCEL PPS USER: CARDNO = 1231346
2.7.36 Adding Abbreviated Accounts Settings

Command Name
ADD PPS ABBRACCO
Command Function
This command is used to add abbreviated numbers for a single card.
Input Parameters
ADD PPS ABBRACCO: CARDNO =, CALLNO =
Table 2-261 Description of the input parameters of: ADD PPS ABBRACCO
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
Issue 01 (2008-01-28)
2-257

Parameter
Description
Value Range
digits.
CALLNO
It is the calling
number.
[Value Range]
digits.
Output Parameters
ACK: ADD PPS ABBRACCO: RETN =, DESC =
Table 2-262 Description of the output parameters of: ADD PPS ABBRACCO
Parameter
RETN
Description
8841: The calling number of this card has already existed.

8842: The calling number cannot set any more abbreviated account.
8843: The card is expired, and no abbreviated account can be set.
8844: The service operator corresponding to the card does not support
the abbreviated account function.
8845: This card does not support the abbreviated account function.
8846: The card is not loaded or activated.
8847: This number cannot be set as an abbreviated account.

DESC

operation.
Example
ADD PPS ABBRACCO: CARDID = 40010, CALLNO = 075512345
2.7.37 Querying Abbreviated Account Numbers or Card Numbers

Command Name
LIST PPS ABBRACCO
Command Function
This command is used to query:
2-258
Card numbers based on calling numbers and abbreviated account numbers
Issue 01 (2008-01-28)

Abbreviated account numbers based on card numbers
Input Parameters
LIST PPS ABBRACCO: [CARDNO =,] [CALLNO =,] [,ABBRACCO =]
Table 2-263 Description of the input parameters of: LIST PPS ABBRACCO
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the calling
number.
[Value Range]
account number.
[Value Range]
CALLNO
ABBRACCO
digits.
digits.
Output Parameters
ACK: LIST PPS ABBRACCO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-264 Description of the output parameters of: LIST PPS ABBRACCO
Parameter
Description
RETN

DESC
ATTR

operation.
ABBRACCOUNT& ACCOUNTNUMBER& CALLINGNUMBER
RESULT
TOTAL
FINISHED
SN
Issue 01 (2008-01-28)
0: No
1: Yes
2-259

Parameter
Description
NUMOF
Example
LIST PPS ABBRACCO: CALLNO = 123
2.7.38 Deleting Abbreviated Accounts Settings

Command Name
DELE PPS ABBRACCO
Command Function
This command is used to delete abbreviated account numbers of single cards.
Input Parameters
DELE PPS ABBRACCO: CARDNO =, CALLNO =
Table 2-265 Description of the input parameters of: DELE PPS ABBRACCO
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the calling
number.
[Value Range]
CALLNO
digits.
digits.
Multiple calling numbers are
from each other. The single
quotation marks or double
quotation marks are needed for the
parameter value.
Output Parameters
ACK: DELE PPS ABBRACCO: RETN =, DESC = [, ATTR=, RESULT=]
2-260
Issue 01 (2008-01-28)

Table 2-266 Description of the output parameters of: DELE PPS ABBRACCO
Parameter
Description
RETN

8861: The calling number corresponding to this card does not exist.
DESC
ATTR

operation.
RESULT
Example
DELE PPS ABBRACCO: CARDID = 40010, CALLNO = 075512345
2.7.39 Adding Green Numbers at Subscriber Level

Command Name
ADD PPS GREENLIST
Command Function
This command is used to add green numbers at the subscriber level.
Input Parameters
ADD PPS GREENLIST: CARDNO=, GREENNUMBER=
Table 2-267 Description of the input parameters of: ADD PPS GREENLIST
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
GREENNUMBER
It is the green
number.
[Value Range]
Issue 01 (2008-01-28)
2-261

Output Parameters
ACK: ADD PPS GREENLIST: RETN =, DESC =
Table 2-268 Description of the output parameters of: ADD PPS GREENLIST
Parameter
RETN
Description
DESC

operation.
Example
ADD PPS GREENLIST: CARDNO =32564, GREENNUMBER=2454554
2.7.40 Querying Green Numbers at Subscriber Level

Command Name
LIST PPS GREENLIST
Command Function
This command is used to query green numbers at the subscriber level.
Input Parameters
LIST PPS GREENLIST: CARDNO =
Table 2-269 Description of the input parameters of: LIST PPS GREENLIST
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: LIST PPS GREENLIST: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
2-262
Issue 01 (2008-01-28)

Table 2-270 Description of the output parameters of: LIST PPS GREENLIST
Parameter
Description
RETN

DESC

operation.
ATTR
CARDNO& GREENNUMBER
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS GREENLIST: CARDNO =123456
2.7.41 Deleting Green Numbers at Subscriber Level

Command Name
DELE PPS GREENLIST
Command Function
This command is used to delete green numbers at the subscriber level.
Input Parameters
DELE PPS GREENLIST: CARDNO =, GREENNUMBER=
Issue 01 (2008-01-28)
2-263

Table 2-271 Description of the input parameters of: DELE PPS GREENLIST
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the green
number.
[Value Range]
GREENNUMBER
digits.
digits.
Output Parameters
ACK: DELE PPS GREENLIST: RETN =, DESC = [, ATTR=, RESULT=]
Table 2-272 Description of the output parameters of: DELE PPS GREENLIST
Parameter
Description
RETN

DESC

operation.
ATTR
RESULT
Example
DELE PPS GREENLIST: CARDNO =32564, GREENNUMBER=2454554&2315
2.7.42 Querying Single User Logs

Command Name
LIST PPS SUBOPRLOG
Command Function
This command is used to query the matched operation logs of a specific card number.
2-264
Issue 01 (2008-01-28)

Input Parameters
LIST PPS SUBOPRLOG: CARDNO =, STARTDATE =, ENDDATE =, PROPERTY =
[ ,OPERATION =]
Table 2-273 Description of the input parameters of: LIST PPS SUBOPRLOG
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the start date.
[Value Range]
STARTDATE
digits.

It is earlier than or equal to the end
date.
ENDDATE
It is the end date.
[Value Range]
It is later than or equal to the start
date.
PROPERTY
It is the property of
operation.
[Value Range]
0: local maintenance
1: off-site maintenance
2: local maintenance and off-site
maintenance
OPERATION
It is the operation
instruction.
[Value Range]
2147483647 to 2147483647.
Output Parameters
ACK: LIST PPS SUBOPRLOG: RETN =, DESC = [, TOTAL=, FINISHED=, SN=,
Table 2-274 Description of the output parameters of: LIST PPS SUBOPRLOG
Parameter
Description
RETN

DESC

operation.
Issue 01 (2008-01-28)
2-265

Parameter
Description
ATTR
SERIAL& OPERNAME& SMAP& OPRTIME& CURRENCY&
CURRENCYNAME& OPERATION& OPERATIONAME&
PROPERTY& FEE& DESCRIPTION& CURRENCYTYPE&
DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SUBOPRLOG: CARDNO = 132154, STARTDATE = 20060810, ENDDATE =
20060818, PROPERTY = 1
2.7.43 Setting Blacklists

Command Name
SET PPS CARDBLKLIST
Command Function
This command is used by operators to set blacklist for a specific card number through the
SMAP/MML.
Input Parameters
SET PPS CARDBLKLIST: CARDNO =, CARDBLKCLRFLAG = [, CARDBLKCLRTIME
=]
Table 2-275 Description of the input parameters of: SET PPS CARDBLKLIST
2-266
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
digits.
CARDBLKCLRFLAG
CARDBLKCLRTIME
It is the flag
indicates whether to
clear blacklists
automatically.
[Value Range]
0: No
It is the time when

blacklists are cleared
automatically.
[Value Range]
1: Yes

999999999.
It is disabled when
CARDBLKCLRFLAG is set to 0.
Output Parameters
ACK: SET PPS CARDBLKLIST: RETN =, DESC =
Table 2-276 Description of the output parameters of: SET PPS CARDBLKLIST
Parameter
Description
RETN

9041: This card is not activated
9042: This card is blacklisted.

DESC

operation.
Example
SET PPS CARDBLKLIST: CARDNO = 125621555, CARDBLKCLRFLAG = 1,
CARDBLKCLRTIME = 120
2.7.44 Resetting Single Cards

Command Name
RESET PPS USESTATE
Command Function
This command is used to reset a single card.
Issue 01 (2008-01-28)
2-267

Input Parameters
RESET PPS USESTATE: CARDNO =
Table 2-277 Description of the input parameters of: RESET PPS USESTATE
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: RESET PPS USESTATE: RETN =, DESC =
Table 2-278 Description of the output parameters of: RESET PPS USESTATE
Parameter
RETN
Description
9621: Sorry, card is in use, you can not reset the card.
DESC

Example
RESET PPS USESTATE: CARDNO = 1234567
2.7.45 Modifying Validity Dates of Single Cards

Command Name
MODI PPS SRVDATE
Command Function
This command is used to modify the validity date of a single card.
Input Parameters
MODI PPS SRVDATE: CARDNO =, SERVICESTOP =
2-268
Issue 01 (2008-01-28)

Table 2-279 Description of the input parameters of: MODI PPS SRVDATE
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the validity date

of a single card after
modification.
[Value Range]
SERVICESTOP
digits.

the format of
YYYYMMDDHHMMSS or a
numerical string of 8 digits in the
format of YYYYMMDD.
Output Parameters
ACK: MODI PPS SRVDATE: RETN =, DESC =
Table 2-280 Description of the output parameters of: MODI PPS SRVDATE
Parameter
Description
RETN

9644: The end date should be later than the start date of this card. The
start date of the card is YYYYMMDD.
9646: The validity period of probation cards cannot be modified.
9648: The card has been cancelled; the service data cannot be modified.
9651: The validity period of postpaid cards cannot be modified.

DESC

operation.
Example
MODI PPS SRVDATE: CARDNO = 1234567, SERVICESTOP = 20080808080808
2.7.46 Clearing Single Card Blacklists

Command Name
CLR PPS CARDBLKLST
Issue 01 (2008-01-28)
2-269

Command Function
This command is used to clear the blacklist of a single card.
Input Parameters
CLR PPS CARDBLKLST: CARDNO =
Table 2-281 Description of the input parameters of: CLR PPS CARDBLKLST
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: CLR PPS CARDBLKLST: RETN =, DESC =
Table 2-282 Description of the output parameters of: CLR PPS CARDBLKLST
Parameter
RETN
Description
9663: The service provider does not have the authority to setting the
function of clearing blacklist.
DESC

Example
CLR PPS CARDBLKLST: CARDNO = 1234567
2.7.47 Resetting Accumulated Call Cost of Single Cards

Command Name
RESET PPS USAGEFEE
Command Function
This command is used to reset the accumulated call cost of a single card.
2-270
Issue 01 (2008-01-28)

Input Parameters
RESET PPS USAGEFEE: CARDNO =
Table 2-283 Description of the input parameters of: RESET PPS USAGEFEE
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: RESET PPS USAGEFEE: RETN =, DESC =
Table 2-284 Description of the output parameters of: RESET PPS USAGEFEE
Parameter
RETN
Description
DESC

operation.
Example
RESET PPS USAGEFEE: CARDNO = 7654321
2.7.48 Resetting Usage Points Level of Single Cards

Command Name
RESET PPS ACCLEVEL
Command Function
This command is used to reset the level usage points of a single card.
Input Parameters
RESET PPS ACCLEVEL: CARDNO =
Issue 01 (2008-01-28)
2-271

Table 2-285 Description of the input parameters of: RESET PPS ACCLEVEL
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: RESET PPS ACCLEVEL: RETN =, DESC =
Table 2-286 Description of the output parameters of: RESET PPS ACCLEVEL
Parameter
Description
RETN

9701: This is a probation card, which does not have the usage bonus
feature.
9702: The card does not have the usage bonus feature.
9703: The usage bonus feature for the service provider is disabled.
9704: This is a postpaid card, which does not have the usage bonus
feature.

DESC

Example
RESET PPS ACCLEVEL: CARDNO = 7654321
2.7.49 Setting Call Type Screen for Single Cards

Command Name
SET PPS CALLSCREEN
Command Function
This command is used to set the function of call type screen for single cards.
2-272
Issue 01 (2008-01-28)

Input Parameters
SET PPS CALLSCREEN: CARDNO = [, INTERNATIONALCALL =] [,
NATIONALCALL =] [, LOCALCALL =] [, CPPURBANCALL =] [,
CPPINTERURBANCALL =]
Table 2-287 Description of the input parameters of: SET PPS CALLSCREEN
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It is the international
call restriction.
[Value Range]
INTERNATIONALCA
LL
digits.
It is enabled only when the system

supports call type screen.
0: Permitted
1: Restricted
NATIONALCALL
It is the national toll

call restriction.
[Value Range]
0: Permitted
1: Restricted
LOCALCALL

restriction.
[Value Range]
0: Permitted
1: Restricted
CPPURBANCALL
It is the local mobile

call restriction.
[Value Range]
0: Permitted
1: Restricted
CPPINTERURBANCA
LL
It is the national
mobile toll call
restriction.
[Value Range]
supports call type screen and special
numbers.
0: Permitted
1: Restricted
Output Parameters
ACK: SET PPS CALLSCREEN: RETN =, DESC =
Issue 01 (2008-01-28)
2-273

Table 2-288 Description of the output parameters of: SET PPS CALLSCREEN
Parameter
RETN
Description
9721: The service does not support the CPPURBANCALL or
CPPINTERURBANCALL.
DESC

operation.
Example
SET PPS CALLSCREEN: CARDNO = 55555, INTERNATIONALCALL = 1
2.7.50 Querying Main-Child Cards

Command Name
LIST PPS CARDRELA
Command Function
This command is used to query the card number of the main card or a child card of a single
card.
Input Parameters
LIST PPS CARDRELA: CARDNO =
Table 2-289 Description of the input parameters of: LIST PPS CARDRELA
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
Output Parameters
ACK: LIST PPS CARDRELA: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
2-274
Issue 01 (2008-01-28)

Table 2-290 Description of the output parameters of: LIST PPS CARDRELA
Parameter
RETN
Description
8901: This card does not have the main-child card feature.

8902: The specified card is a probation card, which does not have the
main-child card feature.

DESC

operation.

ATTR
CARDNO& MAINACCOUNTNUMBER
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CARDRELA: CARDNO = 10
2.7.51 Querying Modifiable State of the Single Card Maintenance

Interface
Command Name
DISP PPS CARDMODISTATE
Command Function
This command is used to query information in the single card maintenance window in the
modifiable state
Issue 01 (2008-01-28)
2-275

Input Parameters
DISP PPS CARDMODISTATE: CARDNO =
Table 2-291 Description of the input parameters of: DISP PPS CARDMODISTATE
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
digits.
Output Parameters
ACK: DISP PPS CARDMODISTATE: RETN =, DESC = [, ATTR=, RESULT =]
Table 2-292 Description of the output parameters of: DISP PPS CARDMODISTATE
Parameter
RETN
Description
DESC
ATTR

operation.
CARDNUMBER& SERVICEPROVIDER& PRODUCT&
MAINCARDNUMBER& ENABLEFLAG& BLOCKEDTIME&
EXPERIENCINGCARDFLAG&
CALLDURATIONOFEXPERIENCINGCARD& STARTDATE&
CARDVALIDITYTYPE& VALIDITYPERIOD& ENDDATE&
MONTHLYDAILYLIMIT FLAG& DAILYLIMITTYPE&
DAILYLIMIT& DAILYBALANCE& MONTHLYLIMITTYPE&
MONTHLYLIMIT& MONTHLYBALANCE& MAX.CALLFLAG&
CONTINUOUSCALLTIMES& FACEVALUE&BALANCE& SDU&
AREA& STARTSN& BATCHNO& INPUTERRORTIMES&
CARDTYPE& CALLTYPE& CARDWITHOUTPINFLAG& GSN&
CREATIONTIME& FIRSTUSETIME& LATESTUSEDATE&
LOADINGTIME& ACTIVATINGTIME& LASTRECHARGETIME&
CANCELINGTIME& SIMULTANEOUSCALLFLAG&
CALLINGCATEGORYSCREENTYPE& AUTHENTICATEPINFLAG&
NEXTPLAYDATE& USERCHOOSECHARGEPACKAGESTATUS&
UBPFUNCTIONFLAG& DEFAULTLANGUAGETYPE&
RECHARGECARDTYPE& PERIODBONUS& USERNAME&
ACTIVATE& INUSE& STATUS& DISPLAYCALLINGFLAG&
AUTODELETEFLAG& CALLINGSCREENTYPE&
CALLEDSCREENTYPE& DIRECTDIALPSTN&
CALLCATEGORYSCREENTYPE& CARDBLACKAUTOCLEAR&
2-276
Issue 01 (2008-01-28)

Parameter
Description
CARDBLACKCLEARTIME& ALLOWRECHARGE&
MAXRECHARGETIMES& CURRRECHARGETIMES&
INITPLAYCALLDURATION& INITPLAYBALANCE&
PLAYCALLDURATION& PLAYCALLCOST&
PLAYNEWBALANCE& BEEPPROMPTPARTY& CREDITCOUNT&
GOVERNMENTTAX& CHARGERATEMODULATOR&
CURRENCYTYPE& OPTRAUTOCLEARBLACKLIST&
OPTRAUTOCLEARTIME& CALLERBINDINGFLAG&
BINDWITHPIN& USAGEBONUSTYPE& BONUSLEVEL&
ACCUMULATEDCALLCOST& BONUSSTARTDATE&
ABBRACCOUNTFLAG& FAMILIARITYNUMBERFLAG&
FAMILIARITYNUMBERDISCOUNT&
FAMILIARITYNUMBERMAXNUM& SERVICEKEYINUSE&
TIMESINUSEMANAGER& LASTTIMEINUSEMANAGER&
WINBONUSFLAG& BONUSAMOUNT& NEWCARDFLAG&
LOCKCARDCALLINGNUMBER& LOCKCARDTIME&
CURRENTCALLTIMES& RECHARGINGTIMES&
SOLDONLINEFLAG& LASTCALLEDNUMBER& RECHARGE&
PROLONG& CHANGEPWD& QUERYBILL& RELATION&
BLACKLIST& RESETCARD& MODULATOR&
CLEARBLACKLIST& QUERYLOG& UVCRECHARGE&
CHANGEBINDINGPWD& MODIFYDATA&
CALLEDSCREEN& ABBRACCOUNT& RESETLEVEL& BINDING&
ASSOCIATE& DISSOCIATE& CALLINGSCREEN&
MODIFYBALANCE& FAMINIARYTYNUMBER&
RESETCALLCOST& UNBINDING& CARDRECHARGE
ABBREVIATEDNUMBER& CONFIGERROR& MOBILEPHONE&
SMFLAG& SENDDURATIONFLAG& SENDCOSTFLAG&
SENDBALFLAG& CALLFUNCFLAG& MESSFUNCFLAG
RESULT
Example
DISP PPS CARDMODISTATE: CARDNO = 123
2.8 CDRs ManagementSettings

2.8.1 Querying Service Bills
Command Name
LIST PPS SRVCDRS
Command Function
This command is used to query the service bill record of a single card of a specified SP.
Issue 01 (2008-01-28)
2-277

Input Parameters
LIST PPS SRVCDRS: SPID =, CARDNO =, STARTDATEANDTIME =,
STOPDATEANDTIME =
Table 2-293 Description of the input parameters of: LIST PPS SRVCDRS
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the card
number.
[Value Range]
STARTDATEANDTI
ME

and time.
[Value Range]
STOPDATEANDTIM
E
It is the stop date

and time.
[Value Range]
CARDNO
digits.
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.
The value STOPDATEANDTIME
must be greater than or equal to the
value of STARTDATEANDTIME.
Output Parameters
ACK: LIST PPS SRVCDRS: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-294 Description of the output parameters of: LIST PPS SRVCDRS
Parameter
Description
RETN

DESC
ATTR

operation.
FORMATTYPE& REASON& ACCESSCODE& CALLINGPARTY&
ORIGINCODE& CALLINGPARTYCATEGORY& SCAPECODE&
CALLEDPARTY& DESTCNTRYCODE& DATEDDMMYYYY&
STARTTIME& DURATION& TIMEZONE& CURRENCY&
NETVALUE& GROSSVALUE& ADITIONALVALUE&
CHARGEALEPART& MODULATIONVALUE&
2-278
Issue 01 (2008-01-28)

Parameter
Description
SERVICEIDENTITY& ACCOUNTNUMBER&
AMOUNTAVAILABLE& DECREASEDEAMOUNT&
SERVICEFACILITIES& SSPID& SCPID& CORRELATIONID&
CHARGECLASS& TIMEBAND& RATINGSCHEME&
CHARGINGINDICATION& CARRIERIDENTIFICATION
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SRVCDRS: SPID = 123, CARDNO = 123456789, STARTDATEANDTIME =
20050604010101, STOPDATEANDTIME = 20050604235959
2.8.2 Querying Operation Bills

Command Name
LIST PPS OPRCDRS
Command Function
This command is used to query the operation bill record of a single card of a specified SP.
Input Parameters
LIST PPS OPRCDRS: SPID =, CARDNO =, STARTDATEANDTIME =,
STOPDATEANDTIME =
Table 2-295 Description of the input parameters of: LIST PPS OPRCDRS
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
CARDNO
It is the card
number.
[Value Range]
Issue 01 (2008-01-28)
2-279

Parameter
Description
Value Range
STARTDATEANDTI
ME

and time.
[Value Range]
STOPDATEANDTIM
E
It is the stop date

and time.
[Value Range]
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.
The value STOPDATEANDTIME
must be greater than or equal to the
value of STARTDATEANDTIME.
Output Parameters
ACK: LIST PPS OPRCDRS: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-296 Description of the output parameters of: LIST PPS OPRCDRS
Parameter
Description
RETN

DESC

operation.
ATTR
FORMATTYPE& DATE& TIME& TIMEZONE&
SERVICEIDENTITY& OPERATION& ACCOUNTNUMBER&
MAXCREDIT& CONSUMECREDIT& CREATINGDATE&
ENABLINGDATE& ACTIVATIONDATE& LASTRECHARGEDATE&
CANCELLATIONDATE& RATINGSCHEME& OPERATIONAMT&
DECREASEDAMOUNT& CORRELATIONID
2-280
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)

Example
LIST PPS OPRCDRS: SPID = 123, CARDNO = 123456789, STARTDATEANDTIME =
20050604010101, STOPDATEANDTIME = 20050604235959
2.8.3 Querying Bills

Command Name
LIST PPS CDRS
Command Function
This command is used to query bill record of a single card.
Input Parameters
LIST PPS CDRS: [CARDNO =,] [SUBSRIBERID =,] STARTDATEANDTIME =,
STOPDATEANDTIME =, PROPERTY = [, CURRENCYTYPE =] [, ACCOUNTTYPE =] [,
ACCOUNTNUMBER =] [, CALLINGPARTYNUM =] [, CALLEDPARTYNUM =] [,
TRANSLATENUM =] [, ORDERFLAG]
Table 2-297 Description of the input parameters of: LIST PPS CDRS
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]
It cannot be null when PROPERTY is
set to 0.
SUBSRIBERID
It is the ID of the
subscriber.
[Value Range]
STARTDATEANDTI
ME

and time.
[Value Range]
STOPDATEANDTIM
E
It is the stop date

and time.
[Value Range]
PROPERTY
It is the type of
operation.
[Value Range]
0: querying a bill of a user
It is a nonnegative integer in the range 1

to 2147483647.
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.
1: querying the bill table of a user

CURRENCYTYPE
It is the currency
type.
[Value Range]
It is compulsory when PROPERTY is
Issue 01 (2008-01-28)
2-281

Parameter
Description
Value Range
set to 1.
It is disabled when PROPERTY is set
to 0.
ACCOUNTTYPE
It is the type of the

account number.
[Value Range]
ACCOUNTNUMBER
It is the number of
the account.
[Value Range]
CALLINGPARTYNU
M
It is the calling
number.
[Value Range]
a numeric string of 2 to 20 digits

a charater string containing a numeric
string plus % at the end
When PROPERTY is set to 0, the
value can only be a numeric string.
CALLEDPARTYNUM
It is the called
number.
[Value Range]
a numeric string of 2 to 20 digits
a charater string containing a numeric
string plus % at the end
When PROPERTY is set to 0, the
value can only be a numeric string.
TRANSLATENUM
ORDERFLAG
It is the called area

code.
[Value Range]
It is the order.
[Value Range]
It is related to the value of

STOPDATEANDTIME.
0: ascending order
1: descending order
Output Parameters
ACK: LIST PPS CDRS: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-298 Description of the output parameters of: LIST PPS CDRS
Parameter
Description
RETN

6101: The financial day is not configured.
6102: The account type does not exist.
2-282
Issue 01 (2008-01-28)

Parameter
Description
DESC

operation.
ATTR
STREAMNUMBER& SERVICEKEY& CHARGEMODE&
CHARGERECORDID& CALLINGPARTYNUMBER&
CALLEDPARTYNUMBER& TRANSLATEDPARTYNUM&
LOCATIONNUMBER& CHARGEDPARTYIDIND&
SPECIFICCHARGEPART& STARTDATEANDTIME&
STOPDATEANDTIME& DURATION& CALLCOST&
BEARERCAPABILITY& CHARGECLASS&
SPECIFICCHGPRTTYPE& USERID& SUBSERVICENUMBER&
CHARGECURRENCY& CURRENCYNAME&
INCOMINGTRUNKID& OUTGOINGTRUNKID&
CALLINGPARTYCAT& BILLEDDURATION& CARDFACEVALUE&
IPADDRESS& CALLTYPE& STOPREASON& RESERVEDFIELD1&
RESERVEDFIELD2& RESERVEDFIELD3& RESERVEDFIELD4&
RESERVEDFIELD5& RESERVEDFIELD6& RESERVEDFIELD7&
RESERVEDFIELD8& RESERVEDFIELD9& TRANSPARENTPARM&
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CDRS: CARDNO = 123456789, STARTDATEANDTIME = 20050709000000,
STOPDATEANDTIME = 20050710235959, PROPERTY = 1
2.8.4 Querying Statistical Bill Information

Command Name
LIST PPS STATISTICBILL
Issue 01 (2008-01-28)
2-283

Command Function
This command is used to query statistic bill information.
Input Parameters
LIST PPS STATISTICBILL: QUERYMODE =, STARTDATE =, STOPDATE =,
CURRENCY = [, CHARGECLASS =] [, LOCATIONNO =]
Table 2-299 Description of the input parameters of: LIST PPS STATISTICBILL
Parameter
Description
Value Range
QUERYMODE
It is the mode of
query.
[Value Range]
0: stat by month
1: stat by day
2: stat by hour
STARTDATE
It is the start date.
[Value Range]
It is a numerical string of 8 digits.
STOPDATE
It is the end date.
[Value Range]
It is a numerical string of 8 digits.
CURRENCY
CHARGECLASS
LOCATIONNO
It is the code of the

charging currency
type.
[Value Range]
It is the charging
class.
[Value Range]
It is the local
number.
[Value Range]

32767.
digits.
Output Parameters
ACK: LIST PPS STATISTICBILL: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-300 Description of the output parameters of: LIST PPS STATISTICBILL
Parameter
Description
RETN

9601: The start date and end date entered must be equal when querying by
hour.
2-284
Issue 01 (2008-01-28)

Parameter
Description
DESC
ATTR

operation.
SERVICEKEY& LOCATIONNUMBER& CURRENCYTYPE&
CURRENCYNAME& DISPLAYUNIT& RATIO& CHARGECLASS&
BILLNUMBER& DURATION& CALLCOST& STATTIME
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS STATISTICBILL: QUERYMODE = 0, STARTDATE = 200507, ENDDATE =
200608, CURRENCY = 0
2.9 User Template Management

2.9.1 Adding User Template
Command Name
ADD PPS USERTEMP
Command Function
This command is used to add a user template
Input Parameters
ADD PPS USERTEMP: SPID =, TEMPLATEID =, CARDTYPE =, CURRENCYTYPE= [,
PROBATIONFLAG =] [, FACEVALUE =] [, CALLINGSCREENTYPE =] [,
Issue 01 (2008-01-28)
2-285

CALLEDSCREENTYPE =] [, MAXCALLFLAG =] [, MAXCALLS =] [,

CARDBLKCLEARFLAG =] [, CARDBLKCLEARTIME =] [, MAXRECHARGETIMES =]
[, DAILYLIMITTYPE =] [, DAILYLIMIT =] [, MONTHLYLIMITFLAG =] [,
MONTHLYLIMIT =] [, SERVICESTOP =] [, VALIDPERIODTYPE =] [,
VALIDITYPERIOD =] [, PLYDURAAVAILFG =] [, PLYBALANCEFLAG =] [,
PLYDURATIONFLAG =] [, PLYCOSTFLAG =] [, PLYNEWBALFLAG =] [,
DISCOUNTRATE =] [, BEEPFLAG =] [, CREDITLIMIT =] [, TAXRATE =] [, BINDFLAG
=] [, ACCUMULATEFLAG =] [, ABBRACCTFLAG =] [, FAMILYNUMFLAG =] [,
FAMILYNUMDISCOUNT =] [, MAXFAMILYNUM =] [, PERIODBONUS =] [,
RECHARGINGFLG =] [, UBPFUNCFLG =] [, PACKAGEID =]
Table 2-301 Description of the input parameters of: ADD PPS USERTEMP
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the unique
identifier of a
template.
[Value Range]
It is the flag
indicating probation
cards.
[Value Range]
It is the card face

value.
[Value Range]
It is the user level

calling screen type.
[Value Range]
0: None
TEMPLATEID
PROBATIONFLAG
FACEVALUE
CALLINGSCREENTY
PE

268435455

1: probation card

268435455
1: Permitted
2: Restricted

CALLEDSCREENTYP
E
It is the called
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
3: Direct Dial
It is disabled for recharge cards. In that

case, the value is 0.
MAXCALLFLAG
It is the flag
indicating the
maximum follow-on
calls restriction.
[Value Range]
0: No
1: Yes

MAXCALLS
2-286
It is the maximum
number of follow-on
[Value Range]
Issue 01 (2008-01-28)

Parameter
Description
Value Range
calls allowed.

CARDBLKCLEARFL
AG
CARDBLKCLEARTI
ME
It is the flag
indicating the card
blacklist automatic
clearing.
[Value Range]
It is the card
blacklist clearing
time.
[Value Range]
0: No
1: Yes

999999999.
CARDBLKCLEARFLAG is set to 1.
MAXRECHARGETIM
ES
It is the maximum
recharge times.
[Value Range]
2147483647.
0: no restriction
DAILYLIMITTYPE
DAILYLIMIT

type.
It is the daily limit.
[Value Range]
0: none
1: sum of money
2: times
[Value Range]
268435455.
MONTHLYLIMITFLA
G
It is the flag
indicating the
monthly limit.
[Value Range]
0: No
1: Yes

MONTHLYLIMIT
It is the monthly
limit.
[Value Range]
268435455.
MONTHLYLIMITFLAG is set to 1
VALIDPERIODTYPE
Issue 01 (2008-01-28)
It is the validity
type.
[Value Range]
2-287

Parameter
Description
SERVICESTOP
It is the validity end

date.
Value Range
0: fixed validity
2: validity activated by the card

number
4: validity A period+ B period
[Value Range]
YYYYMMDD.
VALIDITYPERIOD
It is the validity
period.
[Value Range]
The unit is day.
VALIDPERIODTYPE is not set to
fixed validity.
CURRENCYTYPE
It is the currency
type.
[Value Range]
PLYDURAAVAILFG
It is the flag
indicating the
available duration
prompt.
[Value Range]
0: No
1: Yes

PLYBALANCEFLAG
It is the flag
indicating the
balance prompt.
[Value Range]
0: No
1: Yes

PLYDURATIONFLA
G
It is the flag
indicating the
duration prompt.
[Value Range]
0: No
1: Yes

PLYCOSTFLAG
It is the flag
indicating call fee
prompt.
[Value Range]
0: No
1: Yes

PLYNEWBALFLAG
It is the flag
indicating the new
balance prompt.
[Value Range]
0: No
1: Yes
2-288
Issue 01 (2008-01-28)

Parameter
Description
Value Range
DISCOUNTRATE
It is the discount rate

of the charge rate.
[Value Range]
BEEPFLAG
It is the BEEP tone

playing object.
[Value Range]
2: play the tone to the called
3: play the tone to the caller and the

called

CREDITLIMIT
It is the credit quota.
[Value Range]
TAXRATE
It is the tax rate.
[Value Range]
CARDTYPE

card.
[Value Range]
03: used when Call Type at service
level is Only PSTN
level is Only IP
89, A, B: used when Call Type at
service level is PSTN and IP
CD: used for recharge cards
BINDFLAG
the card can be
bound.
[Value Range]
0: No
1: Yes
In that case, the value is 0.
ACCUMULATEFLAG
the function of
accumulated usage
bonus is enabled.
[Value Range]
0: no
1: provide the bonus by the recharge
amount
2: provide the bonus by the validity
period
ABBRACCTFLAG
Issue 01 (2008-01-28)
the abbreviated
dialing function is
enabled.
[Value Range]
0: No
1: Yes
2-289

Parameter
Description
Value Range
FAMILYNUMFLAG
the function of
familiarity number
is enabled.
[Value Range]
0: No
FAMILYNUMDISCO
UNT
number discount
rate.
[Value Range]
MAXFAMILYNUM
It is the maximal
amount of
[Value Range]
PERIODBONUS
It is the validity
period presented to
end users.
[Value Range]
1: Yes

the unit is day.
RECHARGINGFLG
It is the flag
indicating the
recharge card.
[Value Range]
UBPFUNCFLG
to support the UBP
feature.
[Value Range]
0: No
1: Yes
PACKAGEID
It is the unique
identifier of a
product charge
package.
[Value Range]
1: not to allow end users to choose
charge packages
0: to allow end users to choose charge
packages, but not to adjust the charge
class
199: unique identifier of a product
charge package
It is disabled when the product does not
support the charge package feature.
The default value is 1 in this case;
otherwise, the default value is 0.
2-290
Issue 01 (2008-01-28)

Output Parameters
ACK: ADD PPS USERTEMP: RETN =, DESC =
Table 2-302 Description of the output parameters of: ADD PPS USERTEMP
Parameter
RETN
Issue 01 (2008-01-28)
Description
7201: Can not input FACEVALUE when PROBATIONFLAG is 1.
7202: Can not input TAXRATE when PROBATIONFLAG is 1.
7203: Can not input DAILYLIMITTYPE when PROBATIONFLAG is

1.
7204: Can not input MONTHLYLIMITFLAG when

PROBATIONFLAG is 1.
7205: Can not input DISCOUNTRATE when PROBATIONFLAG is 1.
7206: Can not input CREDITLIMIT when PROBATIONFLAG is 1.
7207: The CARDTYPE must be 0, 2, 4, 6, 8, A when

PROBATIONFLAG is 1.
7208: Can not input ACCUMULATEFLAG when PROBATIONFLAG

is 1.
7209: Can not input MAXRECHARGETIMES when CARDTYPE is 0,

2, 4, 6, 8, A.
7210: Can not input FAMILYNUMDISCOUNT when

FAMILYNUMFLAG is 0.
7211: Can not input MAXFAMILYNUM when FAMILYNUMFLAG

is 0.
7212: Can not input MAXCALLS when MAXCALLFLAG is 0.
7213: Can not input CARDBLKCLEARTIME when

CARDBLKCLEARFLAG is 0.
7214: Can not input MAXRECHARGETIMES when

RECHARGEFLAG is 0.
7215: Can not input DAILYLIMIT when DAILYLIMITTYPE is 0.
7216: Can not input MONTHLYLIMIT when

MONTHLYLIMITFLAG is 0.
7217: Can not input VALIDITYPERIOD when VALIDPERIODTYPE

is 0 or 4.
7218: The template corresponding to the service provider already exists.
7220: The usage bonus feature license is disabled.
7221: The abbreviation account feature license is disabled.


7223: The service provider calling binding flag is not configured.
7224: The service provider usage bonus flag is not configured.
7225: The service provider abbreviation account flag is not configured.
7226: The service provider familiarity number flag is not configured.
2-291

Parameter
Description
7227: The service provider auto clear black list feature is disabled.
7228: The service provider recharge feature is disabled.
7229: The service provider daily limit feature is disabled.
7230: The service provider monthly limit feature is disabled.

7231: The service provider select enabled period feature is disabled.

7232: The service provider Available Call Duration Prompt feature is

disabled.
7233: The service provider play balance feature is disabled.
7234: The service provider play call duration feature is disabled.
7235: The service provider play call cost feature is disabled.
7236: The service provider play new balance feature is disabled.
7237: The service provider play beep feature is disabled.
7238: The service provider create probation card feature is disabled.
7239: Daily limit can not be more than monthly limit.
7243: please input FAMILYNUMFLAG.
7244: please input MAXCALLFLAG.

7245: Please input DAILYLIMITTYPE.

7246: Please input MONTHLYLIMITTYPE.
7800: UBPFUNCFLG License is closed, UBPFUNCFLG can not be 1.
7810: PACKAGE License is closed, PACKAGEID can not be 0.

DESC

operation.
Example
ADD PPS USERTEMP: SPID = 0, TEMPLATEID = 3, CARDTYPE = 1,
CURRENCYTYPE = 1, PROBATIONFLAG = 1.
2.9.2 Modifying User Template

Command Name
MODI PPS USERTEMP
Command Function
This command is used to modify user template information.
2-292
Issue 01 (2008-01-28)

Input Parameters
MODI PPS USERTEMP: SPID =, TEMPLATEID = [, PROBATIONFLAG =] [,
FACEVALUE =] [, CALLINGSCREENTYPE =] [, CALLEDSCREENTYPE =] [,
MAXCALLFLAG =] [, MAXCALLS =] [, CARDBLKCLEARFLAG =] [,
CARDBLKCLEARTIME =] [, MAXRECHARGETIMES =] [, DAILYLIMITTYPE =] [,
DAILYLIMIT =] [, MONTHLYLIMITFLAG =] [, MONTHLYLIMIT =] [,
VALIDPERIODTYPE =] [, SERVICESTOP =] [, VALIDITYPERIOD =] [,
CURRENCYTYPE =] [, PLYDURAAVAILFG =] [, PLYBALANCEFLAG =] [,
PLYDURATIONFLAG =] [, PLYCOSTFLAG =] [, PLYNEWBALFLAG =] [,
DISCOUNTRATE =] [, BEEPFLAG =] [, CREDITLIMIT =] [, TAXRATE =] [, CARDTYPE
=] [, BINDFLAG =] [, ACCUMULATEFLAG =] [, ABBRACCTFLAG =] [,
FAMILYNUMFLAG =] [, FAMILYNUMDISCOUNT =] [, MAXFAMILYNUM =] [,
PERIODBONUS =] [, RECHARGINGFLG =] [, UBPFUNCFLG =] [, PACKAGEID =]
Table 2-303 Description of the input parameters of: MODI PPS USERTEMP
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
TEMPLATEID
It is the unique
identifier of a
template.
[Value Range]
It is the flag
indicating probation
cards.
[Value Range]
It is the card face

value.
[Value Range]
It is the user level

calling screen type.
[Value Range]
PROBATIONFLAG
FACEVALUE
CALLINGSCREENTY
PE

268435455

1: probation card

268435455
0: None
1: Permitted
2: Restricted
CALLEDSCREENTYP
E
It is the called
screen type.
[Value Range]
0: None
1: Permitted
2: Restricted
3: Direct Dial
MAXCALLFLAG
Issue 01 (2008-01-28)
It is the flag
indicating the
maximum follow-on
calls restriction.
[Value Range]
0: No
1: Yes
2-293

Parameter
Description
Value Range
MAXCALLS
It is the maximum
number of follow-on
calls allowed.
[Value Range]
CARDBLKCLEARFL
AG
CARDBLKCLEARTI
ME
It is the flag
indicating the card
blacklist automatic
clearing.
[Value Range]
0: No
It is the card
blacklist clearing
time.
[Value Range]
1: Yes

999999999.
CARDBLKCLEARFLAG is set to 1.
MAXRECHARGETIM
ES
It is the maximum
recharge times.
[Value Range]
2147483647.
0: no restriction
DAILYLIMITTYPE

type.
[Value Range]
0: none
1: sum of money
2: times
DAILYLIMIT
It is the daily limit.
[Value Range]
268435455.
MONTHLYLIMITFLA
G
It is the flag
indicating the
monthly limit.
[Value Range]
0: No
1: Yes
MONTHLYLIMIT
It is the monthly
limit.
[Value Range]
268435455.
2-294
Issue 01 (2008-01-28)

Parameter
Description
Value Range
MONTHLYLIMITFLAG is set to 1
VALIDPERIODTYPE
It is the validity
type.
[Value Range]
0: fixed validity
2: validity activated by the card number
4: validity A period+ B period
SERVICESTOP
It is the validity end

date.
[Value Range]
YYYYMMDD.
VALIDITYPERIOD
It is the validity
period.
[Value Range]
The unit is day.
VALIDPERIODTYPE is not set to
fixed validity.
CURRENCYTYPE
PLYDURAAVAILFG
It is the currency
type.
[Value Range]
It is the flag
indicating the
available duration
prompt.
[Value Range]
0: No
1: Yes
PLYBALANCEFLAG
It is the flag
indicating the
balance prompt.
[Value Range]
0: No
1: Yes
PLYDURATIONFLA
G
It is the flag
indicating the
duration prompt.
[Value Range]
0: No
1: Yes
PLYCOSTFLAG
It is the flag
indicating call fee
prompt.
[Value Range]
0: No
1: Yes
PLYNEWBALFLAG
Issue 01 (2008-01-28)
It is the flag
indicating the new
[Value Range]
2-295

Parameter
Description
Value Range
balance prompt.
0: No
1: Yes
DISCOUNTRATE
It is the discount rate

of the charge rate.
[Value Range]
BEEPFLAG
It is the BEEP tone

playing object.
[Value Range]
2: play the tone to the called
3: play the tone to the caller and the
called
CREDITLIMIT
It is the credit quota.
[Value Range]
TAXRATE
It is the tax rate.
[Value Range]
CARDTYPE

card.
[Value Range]
level is Only PSTN
level is Only IP
89, A, B: used when Call Type at
service level is PSTN and IP
CD: used for recharge cards
BINDFLAG
the card can be
bound.
[Value Range]
0: No
1: Yes
In that case, the value is 0.
ACCUMULATEFLAG
the function of
accumulated usage
bonus is enabled.
[Value Range]
0: no
1: provide the bonus by the recharge
amount
2: provide the bonus by the validity
period
2-296
Issue 01 (2008-01-28)

Parameter
Description
Value Range
ABBRACCTFLAG
the abbreviated
dialing function is
enabled.
[Value Range]
0: No
1: Yes
FAMILYNUMFLAG
the function of
familiarity number
is enabled.
[Value Range]
FAMILYNUMDISCO
UNT
number discount
rate.
[Value Range]
MAXFAMILYNUM
It is the maximal
amount of
[Value Range]
It is the validity
period presented to
end users.
[Value Range]
PERIODBONUS
0: No
1: Yes

the unit is day.
RECHARGINGFLG
It is the flag
indicating the
recharge card.
[Value Range]
UBPFUNCFLG
to support the UBP
feature.
[Value Range]
0: No
1: Yes
PACKAGEID
It is the unique
identifier of a
product charge
package.
[Value Range]
1: not to allow end users to choose
charge packages
0: to allow end users to choose charge
packages, but not to adjust the charge
class
199: unique identifier of a product
charge package
It is disabled when the product does not
support the charge package feature.
The default value is 1 in this case;
otherwise, the default value is 0.
Issue 01 (2008-01-28)
2-297

Output Parameters
ACK: MODI PPS USERTEMP: RETN =, DESC =
Table 2-304 Description of the output parameters of: MODI PPS USERTEMP
Parameter
Description
RETN

DESC

operation.
Example
MODI PPS USERTEMP: SPID = 123, TEMPLATEID = 456, MAXFAMILYNUM = 8
2.9.3 Querying User Template

Command Name
LIST PPS USERTEMP
Command Function
This command is used to query user template information. If no template ID is entered, the
system returns the information of all user templates of specified service provider. If a template
ID is entered, the system returns the information of specified user template. If neither SPID
nor template Id is provided then system returns the information of all the user templates of all
the service providers.
Input Parameters
LIST PPS USERTEMP: [SPID =,] [TEMPLATEID =]
Table 2-305 Description of the input parameters of: LIST PPS USERTEMP
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
It is the unique
identifier of a
template.
[Value Range]
TEMPLATEID
2-298

268435455
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS USERTEMP: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-306 Description of the output parameters of: LIST PPS USERTEMP
Parameter
RETN
Description
7501: The template corresponding to the service provider does not exist.

DESC
ATTR

operation.
SPID&TEMPLATEID&PROBATIONFLAG&FACEVALUE&CALLDS
CRTYPE&MAXCALLFLAG&MAXCALLS&CARDBLKCLRFLAG&
CARDBLKCLRTIME&CARDBLKCOUNT&CARDBLKTIME&RCHG
FLAG&DAILYLMTTYPE&DAILYLMT&MONLMTFLAG&MONLM
T&VLIDPERIODTYPE&SERVSTOP&VALDPERIOD&CURRENCYT
YPE&PLYDURAVAILFALG&PLABLNFLAG&PLYDURFLAG&PLY
COSTFLAG&PLYNEWBLNFLAG&DISCOUNTRATE&BEEPFLAG&
CALLSCRTYPE&CREDITLIMIT&TAXRATE&TAXVALUE&PINFL
AG&CALLTYPE&CARDTYPE&BINDCALLPIN&BINDCALLPINFL
AG&BINDFLAG&ACCUMULATEFLAG&ABBRACCTFLAG&FAM
NUMFLAG&FAMNUMDISCOUNT&MAXFAMNUM&FUNCTIONF
LG&PERIODBONUS&PACKAGEID&BINDLICENSE&FAMILYLICE
NSE&ACCUMULATELICENSE&ABBRLICENSE&UBPLICENSE&C
HARGELICENSE&TEMPLATENAME
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-299

Example
LIST PPS USERTEMP: SPID = 123, TEMPLATEID = 456
2.9.4 Deleting User Template

Command Name
DELE PPS USERTEMP
Command Function
This command is used to delete a user template.
Input Parameters
DELE PPS USERTEMP: SPID =, TEMPLATEID =
Table 2-307 Description of the input parameters of: DELE PPS USERTEMP
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
TEMPLATEID
It is the unique
identifier of a
template.
[Value Range]
268435455
Output Parameters
ACK: DELE PPS USERTEMP: RETN =, DESC =
Table 2-308 Description of the output parameters of: DELE PPS USERTEMP
Parameter
Description
RETN

7301: The template corresponding to the service provider does not exist.
DESC

operation.
Example
DELE PPS USERTEMP: SPID = 123, TEMPLATEID = 456
2-300
Issue 01 (2008-01-28)

2.9.5 Querying Blacklists in Batches

Command Name
LIST PPS BLACKLIST
Command Function
This command is used to query blacklists in batches.
Input Parameters
LIST PPS BLACKLIST: [BATCH =]
Table 2-309 Description of the input parameters of: LIST PPS BLACKLIST
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
It is a alphanumerical string of 1 to 10
digits, containing az or AZ or 09.
Output Parameters
ACK: LIST PPS BLACKLIST: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-310 Description of the output parameters of: LIST PPS BLACKLIST
Parameter
Description
RETN

DESC
ATTR

operation.
CARDNO& FACEVALUE& BALANCE& BATCH& SN& GSN&
SOURCE& TIME& CURRENCYTYPE& CURRENCYNAME&
DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED
Issue 01 (2008-01-28)
2-301

Parameter
Description
0: No
1: Yes
SN

NUMOF
Example
LIST PPS BLACKLIST: BATCH = 321
2.9.6 Querying Balance Modification Logs

Command Name
LIST PPS BALMODLOG
Command Function
This command is used to query balance modification logs.
Input Parameters
LIST PPS BALMODLOG: [CARDNO =] [, STARTDATETIME =] [, ENDDATETIME =]
Table 2-311 Description of the input parameters of: LIST PPS BALMODLOG
Parameter
Description
Value Range
CARDNO
It is the card
number.
[Value Range]

recharge.
[Value Range]

recharge.
[Value Range]
STARTDATETIME
ENDDATETIME


Output Parameters
ACK: LIST PPS BALMODLOG: RETN =, DESC = [, TOTAL=, FINISHED=, SN=,
2-302
Issue 01 (2008-01-28)

Table 2-312 Description of the output parameters of: LIST PPS BALMODLOG
Parameter
Description
RETN

DESC

operation.
ATTR
SERIAL& CARDNO& AREA& SPNAME& CURRENCYNAME&
OPERATOR& OPERTIME& BEFOREBAL& MODIVAL&
NEWBAL& CURRENCYTYPE& DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BALMODLOG: CARDNO = 123, STARTDATETIME = 20040101000000,
ENDDATETIME = 20060801000000
2.9.7 Querying Bonus Logs

Command Name
LIST PPS BONUSLOG
Command Function
This command is used to query bonus logs.
Input Parameters
LIST PPS BONUSLOG: [BATCH =] [, CARDNO =] [, STARTDATETIME =] [,
ENDDATETIME =]
Issue 01 (2008-01-28)
2-303

Table 2-313 Description of the input parameters of: LIST PPS BONUSLOG
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
CARDNO
It is the card
number.
[Value Range]
STARTDATETIME

recharge.
[Value Range]

recharge.
[Value Range]
ENDDATETIME
It is an alphanumerical string of 1 to 10
digits, containing az or AZ or 09.


Output Parameters
ACK: LIST PPS BONUSLOG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-314 Description of the output parameters of: LIST PPS BONUSLOG
Parameter
Description
RETN

9261: This card does not belong to the batch.
DESC
ATTR

operation.
SERIAL& CARDNO& BATCH& CALLNO& BALBEFBON&
BALAFTBON& CURRENCYNAME& REWORDDATE&
CURRENCYTYPE & DISPLAYUNIT& RATIO
2-304
RESULT
TOTAL
FINISHED

0: No
1: Yes
Issue 01 (2008-01-28)

Parameter
Description
SN

NUMOF
Example
LIST PPS BONUSLOG: BATCH = 123, CARDNO = 321, STARTDATETIME =
20050101000000, ENDDATETIME = 20060801000000
2.9.8 Querying Sales Bonus Logs

Command Name
LIST PPS SELLBONLOG
Command Function
This command is used to query sales bonus logs.
Input Parameters
LIST PPS SELLBONLOG: [BATCH =] [, STARTDATETIME =] [, ENDDATETIME =]
Table 2-315 Description of the input parameters of: LIST PPS SELLBONLOG
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]

recharge.
[Value Range]

recharge.
[Value Range]
STARTDATETIME
ENDDATETIME
09.


Output Parameters
ACK: LIST PPS SELLBONLOG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Issue 01 (2008-01-28)
2-305

Table 2-316 Description of the output parameters of: LIST PPS SELLBONLOG
Parameter
Description
RETN

DESC

operation.
ATTR
SERIAL& LEVEL& PERCENT& AMOUNT& CURRENCYNAME&
SPNAME& BATCH& OPERATOR& OPERTIME&
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SELLBONLOG: BATCH = 123, STARTDATETIME = 20050101000000,
ENDDATETIME = 20060801000000
2.9.9 Querying BMML Deduction Logs

Command Name
LIST PPS FEEDEDU
Command Function
This command is used to query BMML deduction logs.
Input Parameters
LIST PPS FEEDEDU: [BATCH =] [, CARDNO =] [, STARTDATETIME =] [,
ENDDATETIME =]
2-306
Issue 01 (2008-01-28)

Table 2-317 Description of the input parameters of: LIST PPS FEEDEDU
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]
It is the card
number.
[Value Range]

recharge.
[Value Range]

recharge.
[Value Range]
CARDNO
STARTDATETIME
ENDDATETIME
09.
digits.


Output Parameters
ACK: LIST PPS FEEDEDU: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-318 Description of the output parameters of: LIST PPS FEEDEDU
Parameter
RETN
Description
DESC
ATTR

operation.
SERIAL CARDNO& BATCH& BALBEFDUD& DUDACCT&
CURRENCYNAME& OPERTIME& CURRENCYTYPE&
DISPLAYUNIT& RATIO
RESULT
TOTAL
FINISHED

Issue 01 (2008-01-28)
0: No
1: Yes
2-307

Parameter
Description
SN

NUMOF
Example
LIST PPS FEEDEDU: BATCH = 123, CARDNO = 321, STARTDATETIME =
20050101000000, ENDDATETIME = 20060801000000
2.9.10 Querying Card Creation Information

Command Name
LIST PPS CREDETAIL
Command Function
This command is used to query card creation information and generate the table of card
creation information.
Input Parameters
LIST PPS CREDETAIL: STARTDATE=, ENDDATE = [, CARDTYPE =]
Table 2-319 Description of the input parameters of: LIST PPS CREDETAIL
Parameter
Description
Value Range
STARTDATE

query.
[Value Range]
It can be neither later than ENDDATE
nor earlier than 19900101.
ENDDATE

query.
[Value Range]
It cannot be earlier than
STARTDATE.
CARDTYPE
It is the type of a
card.
[Value Range]
03: PSTN
47: IP
8, 9, A, B: PSTN and IP
2-308
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS CREDETAIL: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-320 Description of the output parameters of: LIST PPS CREDETAIL
Parameter
RETN
Description
DESC
ATTR

operation.
SERIAL& CREATIME& BATCH& COUNT& SDU& AREA&
CARDTYPE& OPRLOGNO
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CREDETAIL: STARTDATE = 20050101, ENDDATE = 20060801, CARDTYPE
=0
2.9.11 Querying Batch Operation Logs

Command Name
LIST PPS BATCHLOG
Command Function
This command is used to query batch operation logs and generate the batch operation log
table.
Issue 01 (2008-01-28)
2-309

Input Parameters
LIST PPS BATCHLOG: BATCH =, STARTDATE =, ENDDATE = [, OPRLOGNO =] [,
OPERTYPE =] [, PROPERTY =]
Table 2-321 Description of the input parameters of: LIST PPS BATCHLOG
Parameter
Description
Value Range
BATCH
It is the unique
[Value Range]

query.
[Value Range]
STARTDATE
09.
It can be neither later than

ENDDATE nor earlier than
19900101.
ENDDATE

query.
[Value Range]
It cannot be earlier than
STARTDATE.
OPRLOGNO
OPERTYPE
PROPERTY
It is the operation
log number.
[Value Range]
It is the type of an
operation.
[Value Range]
It is the property of
an operation.
[Value Range]

2147483647.

-2147483647 to 2147483647
0: local maintenance
1: off-site maintenance
Output Parameters
ACK: LIST PPS BATCHLOG: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-322 Description of the output parameters of: LIST PPS BATCHLOG
Parameter
Description
RETN

DESC
2-310

Issue 01 (2008-01-28)

Parameter
ATTR
Description
BATCH& SERIAL& OPRBEGINTIME& OPRENDTIME&
OPERATOR& SMAP& OPERTYPE& PROPERTY& RESULT&
DETAIL
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BATCHLOG: BATCH = 123, STARTDATE = 20050101, ENDDATE =
20060801, OPERTYPE = 1
2.9.12 Querying Operation Types of Logs

Command Name
LIST PPS OPERATE
Command Function
This command is used to query operation types of logs.
Input Parameters
LIST PPS OPERATE: TYPE =
Table 2-323 Description of the input parameters of: LIST PPS OPERATE
Parameter
Description
Value Range
TYPE
It is the types of
query.
[Value Range]
0: querying logs of card operation in
batches
1: querying logs of single card
Issue 01 (2008-01-28)
2-311

Parameter
Description
Value Range
operation
Output Parameters
ACK: LIST PPS OPERATE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-324 Description of the output parameters of: LIST PPS OPERATE
Parameter
Description
RETN

DESC
ATTR

operation.
OPRTYPE& OPERATE& COMMENT
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS OPERATE: TYPE = 1
2-312
Issue 01 (2008-01-28)

2.10 Charging Matrix Management

2.10.1 Querying the Charging Mode
Command Name
LIST PPS CHARGEMODE
Command Function
This command is used to query the details of the charging mode.
Input Parameters
LIST PPS CHARGEMODE: SPID=
Table 2-325 Description of the input parameters of: LIST PPS CHARGEMODE
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS CHARGEMODE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-326 Description of the output parameters of: LIST PPS CHARGEMODE
Parameter
Description
RETN

DESC

operation.
ATTR
SPID& SPNAME& CHARGINGTYPE& PARATE& PBRATE&
INITINTERVAL& TAPULSETIMES&
METERINGTIMEINTERVAL& TBPULSETIMES&
MINCHARGINGDURATION& MODULATORINDEX&
ESTIMATEDMODE& COMMENT
RESULT
Issue 01 (2008-01-28)
2-313

Parameter
Description
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CHARGEMODE: SPID=1
2.10.2 Querying the Adjusted Charging Class Index

Command Name
LIST PPS ACTI
Command Function
This command is used to query the details of the adjusted charging type index.
Input Parameters
LIST PPS ACTI: SPID =
Table 2-327 Description of the input parameters of: LIST PPS ACTI
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS ACTI: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-328 Description of the output parameters of: LIST PPS ACTI
2-314
Parameter
Description
RETN
Issue 01 (2008-01-28)

Parameter
Description
DESC
ATTR

operation.
SPNAME& CHARGECLASSINDEX& ADJUSTVALUE&
NEWCLASSINDEX& NOTE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS ACTI: SPID = 212
2.10.3 Querying the Charging Class Index

Command Name
LIST PPS CTI
Command Function
This command is used to query the details of the charging type index.
Input Parameters
LIST PPS CTI: SPID =
Table 2-329 Description of the input parameters of: LIST PPS CTI
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
[Value Range]
Issue 01 (2008-01-28)
2-315

Parameter
Description
Value Range
service provider.
Output Parameters
ACK: LIST PPS CTI: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =, ATTR
=, RESULT =]
Table 2-330 Description of the output parameters of: LIST PPS CTI
Parameter
Description
RETN

DESC
ATTR

operation.
SPNAME& CHARGECLASSINDEX& BASICCHARGECLASS&
EXTRACHARGECLASS1& EXTRACHARGECLASS2& NOTE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CTI: SPID = 212
2.10.4 Querying the Daily Charge Rate Modulator

Command Name
LIST PPS NORMALDISCOUNT
2-316
Issue 01 (2008-01-28)

Command Function
This command is used to query the details of the daily charge rate modulator.
Input Parameters
LIST PPS NORMALDISCOUNT: SPID=
Table 2-331 Description of the input parameters of: LIST PPS NORMALDISCOUNT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS NORMALDISCOUNT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-332 Description of the output parameters of: LIST PPS NORMALDISCOUNT
Parameter
Description
RETN

DESC
ATTR

operation.
SPID& SPNAME& MODULATORINDEX& STARTTIME&
ENDTIME& MODULATORFORM& MODULATORVALUE&
SURMODULATORFORM& SURMODULATORVALUE&
COMMENT
RESULT
TOTAL
FINISHED
SN
Issue 01 (2008-01-28)
0: No
1: Yes

2-317

Parameter
Description
NUMOF
Example
LIST PPS NORMALDISCOUNT: SPID=1
2.10.5 Querying the Weekly Charge Rate Modulator

Command Name
LIST PPS WEEKDISCOUNT
Command Function
This command is used to query the details of the weekly charge rate modulator.
Input Parameters
LIST PPS WEEKDISCOUNT: SPID=
Table 2-333 Description of the input parameters of: LIST PPS WEEKDISCOUNT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS WEEKDISCOUNT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-334 Description of the output parameters of: LIST PPS WEEKDISCOUNT
Parameter
Description
RETN

DESC

operation.
ATTR
2-318
Issue 01 (2008-01-28)

Parameter
Description
SPID& SPNAME& CHARGERATEMODULATORINDEX&
WEEKDAY& STARTTIME& ENDTIME&
CHARGERATEMODULATORFORM& MODULATORVALUE&
SURMODULATORFORM& SURMODULATORVALUE&
COMMENT
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS WEEKDISCOUNT: SPID=1
2.10.6 Querying the Holiday Charge Rate Modulator

Command Name
LIST PPS HOLIDAYDISCOUNT
Command Function
This command is used to query the details of the holiday charge rate modulator.
Input Parameters
LIST PPS HOLIDAYDISCOUNT: SPID=
Table 2-335 Description of the input parameters of: LIST PPS HOLIDAYDISCOUNT
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Issue 01 (2008-01-28)
2-319

Output Parameters
ACK: LIST PPS HOLIDAYDISCOUNT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-336 Description of the output parameters of: LIST PPS HOLIDAYDISCOUNT
Parameter
RETN
Description
DESC
ATTR

operation.
SPID& SPNAME& CHARGERATEMODULATORINDEX&
HOLIDAYYEAR& HOLIDAYMONTH& HOLIDAYDATE&
STARTTIME& ENDTIME& MODULATORFORM&
MODULATORVALUE& SURMODULATORFORM&
SURMODULATORVALUE& COMMENT
RESULT
It is the query result. The values are separated by | and are in the same order
as in ATTR list. The records are separated by &.
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS HOLIDAYDISCOUNT: SPID=1
2.10.7 Querying the International Charging Matrix

Command Name
LIST PPS ICM
Command Function
This command is used to query the details of the international charging matrix.
2-320
Issue 01 (2008-01-28)

Input Parameters
LIST PPS ICM: SPID =
Table 2-337 Description of the input parameters of: LIST PPS ICM
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS ICM: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-338 Description of the output parameters of: LIST PPS ICM
Parameter
Description
RETN

DESC
ATTR

operation.
SPNAME& CHARGERULE& CALLINGCOUNTRYCODE&
CALLINGAREANO& CALLEDCOUNTRYCODE&
CALLEDAREANO& CHARGECLASSINDEX&
BETWEENTALKEREXPLAIN
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-321

Example
LIST PPS ICM: SPID = 212
2.10.8 Querying the National Charging Matrix

Command Name
LIST PPS NCM
Command Function
This command is used to query the details of the national charging matrix.
Input Parameters
LIST PPS NCM: SPID =
Table 2-339 Description of the input parameters of: LIST PPS NCM
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS NCM: RETN =, DESC =[, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-340 Description of the output parameters of: LIST PPS NCM
Parameter
Description
RETN

DESC
ATTR

operation.
SPNAME& CHARGERULE& COUNTRYCODE&
CALLINGNETWORKCODE& CALLINGAREANO&
CALLEDNETWORKCODE& CALLEDAREANO&
CHARGECLASSINDEX& BETWEENTALKEREXPLAIN
RESULT
2-322
Issue 01 (2008-01-28)

Parameter
Description
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS NCM: SPID = 212
2.10.9 Querying the Local Group Charging Matrix

Command Name
LIST PPS LGCM
Command Function
This command is used to query the details of the local group charging matrix.
Input Parameters
LIST PPS LGCM: SPID =
Table 2-341 Description of the input parameters of: LIST PPS LGCM
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS LGCM: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Issue 01 (2008-01-28)
2-323

Table 2-342 Description of the output parameters of: LIST PPS LGCM
Parameter
Description
RETN

DESC

operation.
ATTR
SPNAME& CHARGERULE& COUNTRYCODE& AREANO&
CALLINGCLUSTERNO& CALLEDCLUSTERNO&
CHARGECLASSINDEX
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS LGCM: SPID = 212
2.10.10 Querying Charge Index Table

Command Name
LIST PPS CHGINDEX
Command Function
This command will query all the records of charge index table.
Input Parameters
LIST PPS CHGINDEX: SPID
2-324
Issue 01 (2008-01-28)

Table 2-343 Description of the input parameters of :LIST PPS CHGINDEX

Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
999
Output Parameters
ACK:LIST PPS CHGINDEX: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-344 Description of the output parameters of :LIST PPS CHGINDEX
Parameter
Description
RETN

digits.
For details, refer to Table 2-1and Table 2-2
DESC
If operation is successful, then it contains description of successful

operation.
If operation fails, then it contains error cause description.
It is a character string of 0 to 256.
ATTR

groupNo&chargeIndex&priority&accountIndex&pkgrateFlagInde
x&policyId0&policyId1&inconsumeaccIdx1&inconsumeaccIdx&i
nconsumeaccIdx3&outconsumeIdx1&outconsumeIdx2&outconsu
meIdx3&outconsumeIdx4&outconsumeIdx5&busyTimeIndex&int
Field1&intField2&intField3&intField4&intField5&intField6&int
Field7&intField8&intField9&intField10&stringfield1&stringfield
2&stringfield3&stringfield4&stringfield5&spID&spName&COM
MENT
RESULT
TOTAL

integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-325

Example
LIST PPS CHGINDEX: SPID=3
2.10.11 Querying Charge Measure Table

Command Name
LIST PPS CHGMSR
Command Function
This command will query all the records of charge measure table.
Input Parameters
LIST PPS CHGMSR: SPID
Table 2-345 Description of the input parameters of :LIST PPS CHGMSR
Parameter
Description
Value Range
SPID
It is the unique
[Value Range]
999
Output Parameters
ACK: LIST PPS CHGMSR: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-346 Description of the output parameters of :LIST PPS CHGMSR
Parameter
Description
RETN

digits.
For details, refer to Table 2-1 and Table 2-2
DESC
If operation is successful, then it contains description of successful

operation.
If operation fails, then it contains error cause description.
It is a character string of 0 to 256.
2-326
Issue 01 (2008-01-28)

Parameter
Description
ATTR

policyId&measureId&fixedFee&gradeMode&gradeUnit&measure
Unit&gradeNum&grade1&rate1&chargeUnit1&grade2&rate2&ch
argeUnit2&grade3&rate3&chargeUnit3&grade4&rate4&chargeU
nit4&grade5&rate5&chargeUnit5&grade6&rate6&chargeUnit6&
grade7&rate7&chargeUnit7&grade8&rate8&chargeUnit8&grade9
&rate9&chargeUnit9&grade10&rate10&chargeUnit10&timedisIn
dex&accumudisIndex&disAlgorithm&spID&spName&COMME
NT
RESULT
TOTAL

integer.
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST CHGMSR: SPID=3
2.11 Additional Management

2.11.1 Querying Currency Types
Command Name
LIST PPS CURRENCYTYPE
Command Function
This command is used to query currency types.
Input Parameters
LIST PPS CURRENCYTYPE:
Issue 01 (2008-01-28)
2-327

Output Parameters
ACK: LIST PPS CURRENCYTYPE: RETN=, DESC= [, TOTAL =, FINISHED =, SN=,
Table 2-347 Description of the output parameters of: LIST PPS CURRENCYTYPE
Parameter
RETN
Description
DESC
ATTR

operation.
CURRENCYID& CURRENCYNAME& DISPLAYUNIT& RATIO&
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CURRENCYTYPE:
2.11.2 Querying Voice Information

Command Name
LIST PPS VOICEINFO
Command Function
This command is used to query voice information.
Input Parameters
LIST PPS VOICEINFO:
2-328
Issue 01 (2008-01-28)

Output Parameters
ACK: LIST PPS VOICEINFO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
Table 2-348 Description of the output parameters of: LIST PPS VOICEINFO
Parameter
RETN
Description
DESC
ATTR

operation.
VOICECODE& VOICECONTENT
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS VOICEINFO:
2.11.3 Querying Language Types

Command Name
LIST PPS LANGUAGETYPE
Command Function
This command is used to query language types.
Input Parameters
LIST PPS LANGUAGETYPE:
Issue 01 (2008-01-28)
2-329

Output Parameters
ACK: LIST PPS LANGUAGETYPE: RETN=, DESC= [, TOTAL =, FINISHED =, SN =,
Table 2-349 Description of the output parameters of: LIST PPS LANGUAGETYPE
Parameter
RETN
Description
DESC
ATTR

operation.
USERCHOOSE& LANGUAGEINDEX
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS LANGUAGETYPE:
2.11.4 Querying Charge Rules

Command Name
LIST PPS CHARGERULE
Command Function
This command is used to query charge rules, including PSTN, IP and products.
Input Parameters
LIST PPS CHARGERULE: [SPID =]
2-330
Issue 01 (2008-01-28)

Table 2-350 Description of the input parameters of: LIST PPS CHARGERULE
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
Output Parameters
ACK: LIST PPS CHARGERULE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-351 Description of the output parameters of: LIST PPS CHARGERULE
Parameter
Description
RETN

DESC
ATTR

operation.
CHARGERULENO& CHARGERULENAME
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CHARGERULE: SPID = 0
Issue 01 (2008-01-28)
2-331

2.11.5 Querying All Access Codes

Command Name
LIST PPS ACSCODE
Command Function
This command is used to query all access codes.
Input Parameters
LIST PPS ACSCODE:
Output Parameters
ACK: LIST PPS ACSCODE: RETN=, DESC= [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-352 Description of the output parameters of: LIST PPS ACSCODE
Parameter
Description
RETN

DESC

operation.
ATTR
ACCESSCODE& OVSACFLAG& VIRTUALCALLINGNUM&
ACCESSCODECLASS& SCLINGPOS& SCLINGLEN&
ACCESSCODETYPE& CHARGERULE& ADJUSTCHGCLASS&
IPCHARGERULE& IPADJUSTCHGCLASS& MAXAUTHRETRY&
MAXPCFAILRETRIES&DEFAULTRETRY&FIRSTDIGITTIMEOUT&I
NTERDIGITTIMEOUT&NOPASSAUTHFLAG&CALLINGSCREENTY
PE&AUTHRETRYEXPIREACT&AUTHFAILPSTNNUM&LANGUAG
ECHOICEFLAG&MAXLANGUAGENUM&DEFAULTLANGUGETYP
E&CHOICEFORSNDLANG&SNDLANGTYPE&ANGSELMSG&WEL
COMEMSGFLAG&WELCOMEMSG&WELCOMEMSGFORMGT&INC
OMINGCHGFLAG&CHARGEDURATIONFLAG&AUTHMODE&FIXE
DLENFLAG&CARDNUMLEN&PINLEN&MINLOFCARDHAVEPIN&
MAXLOFCARDHAVEPIN&AFTERPCTIMEOUTFLG&NUMFORPCTI
MEOUT&AUTHTOMSGID&ACCFUNCFLG&CALLBACKDELAY&R
AUTHMODE&RFIXEDLENFLAG&RMINLOFCARDHAVEPN&RMA
XLOFCARDHAVEPN&RCARDNUMLEN&RPINLEN&DEFAREACO
DE
RESULT
2-332
Issue 01 (2008-01-28)

Parameter
Description
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS ACSCODE:
2.11.6 Querying the Voice Menu Tree

Command Name
LIST PPS VOICETREE
Command Function
This command is used to query the voice menu tree of an SP.
Input Parameters
LIST PPS VOICETREE: SPID = [, LOADFLAG =]
Table 2-353 Description of the input parameters of: LIST PPS VOICETREE
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
to load the voice.
[Value Range]
0: No
LOADFLAG

999.Default value is -1.
1: Yes
Output Parameters
ACK: LIST PPS VOICETREE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Issue 01 (2008-01-28)
2-333

Table 2-354 Description of the output parameters of: LIST PPS VOICETREE
Parameter
Description
RETN

DESC

operation.
ATTR
SPID& FUNCTREEID& FUNCTREENAME& LOADFLAG
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS VOICETREE: SPID = 0
2.11.7 Querying Card Types

Command Name
LIST PPS CARDTYPE
Command Function
This command is used to query the type of a card.
Input Parameters
LIST PPS CARDTYPE:
Output Parameters
ACK: LIST PPS CARDTYPE: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF
2-334
Issue 01 (2008-01-28)

Table 2-355 Description of the output parameters of: LIST PPS CARDTYPE
Parameter
Description
RETN

DESC

operation.
ATTR
CARDTYPE& CALLTYPE& CARDWITHOUTPINFLAG&
ALLOWRECHARGE
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CARDTYPE:
2.11.8 Querying the SDP in Service Area

Command Name
LIST PPS SDPNO
Command Function
This command is used to query all SDP in the service area.
Input Parameters
LIST PPS SDPNO: [AREAID=]
Issue 01 (2008-01-28)
2-335

Table 2-356 Description of the input parameters of: LIST PPS SDPNO
Parameter
Description
Value Range
AREAID
It is the ID of the
area that the card
belongs to.
[Value Range]
99999999.
Output Parameters
ACK: LIST PPS SDPNO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-357 Description of the output parameters of: LIST PPS SDPNO
Parameter
Description
RETN

DESC
ATTR

operation.
AREAID& SERVICEKEY& SDP
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS SDPNO: AREAID=1
2-336
Issue 01 (2008-01-28)

2.11.9 Querying the Batch File Format

Command Name
LIST PPS FILEFORMAT
Command Function
This command is used to query the formats of batch files.
Input Parameters
LIST PPS FILEFORMAT:
Output Parameters
ACK: LIST PPS FILEFORMAT: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-358 Description of the output parameters of: LIST PPS FILEFORMAT
Parameter
Description
RETN

DESC

operation.
ATTR
FORMATNAME& INTERCHAR& INTERCHARCOUNT
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-337

Example
LIST PPS FILEFORMAT:
2.11.10 Querying the Bonus Template

Command Name
LIST PPS BONUSTMP
Command Function
The command is used to query details of bonus template.
Input Parameters
LIST PPS BONUSTMP: [SPID= [, CURRENCY=]]
Table 2-359 Description of the input parameters of: LIST PPS BONUSTMP
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
CURRENCY
It is the currency
type.
[Value Range]
It is disabled when SPID is not set.
Output Parameters
ACK: LIST PPS BONUSTMP: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Table 2-360 Description of the output parameters of: LIST PPS BONUSTMP
Parameter
RETN
Description
DESC
ATTR

operation.
SPID& TEMPLATEID& CURRENCYTYPE& LEVEL& PERCENT&
AMOUNT
2-338
Issue 01 (2008-01-28)

Parameter
Description
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS BONUSTMP: SPID=1, CURRENCY=1
2.11.11 Querying the Function Status During Batch Import

Command Name
LIST PPS CARDFLGINFO
Command Function
This command is used to query function statuses corresponding to the service provider and
product.
Input Parameters
LIST PPS CARDFLGINFO: [AREAID=]
Table 2-361 Description of the input parameters of: LIST PPS CARDFLGINFO
Parameter
Description
Value Range
AREAID
It is the ID of the
area that the card
belongs to.
[Value Range]
99999999.
Output Parameters
ACK: LIST PPS CARDFLGINFO: RETN =, DESC = [, TOTAL =, FINISHED =, SN =,
Issue 01 (2008-01-28)
2-339

Table 2-362 Description of the output parameters of: LIST PPS CARDFLGINFO
Parameter
Description
RETN

DESC

operation.
ATTR
AREAID& SPNAME& SPID& ABBRACCTFLAG& PACKAGEID&
UBPFUNCFLG& FAMILYNUMFLAG& BONUSFLAG&
ACCUMULATEFLAG& BINDFLAG& SMSFLAG& MESSFLAG
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
LIST PPS CARDFLGINFO: AREAID =1
2.11.12 Querying the Service Version

Command Name
DISP PPS VERSION
Command Function
This command is used to query details of the service version.
Input Parameters
DISP PPS VERSION: SERVICEKEY=
2-340
Issue 01 (2008-01-28)

Table 2-363 Description of the input parameters of: DISP PPS VERSION
Parameter
Description
Value Range
SERVICEKEY
It is the unique
identifier of a
certain intelligent
service.
[Value Range]
2147483647.
Output Parameters
ACK: DISP PPS VERSION: RETN=, DESC=[, ATTR=,RESULT=]
Table 2-364 Description of the output parameters of: DISP PPS VERSION
Parameter
Description
RETN

DESC
ATTR

operation.
SERVICEID& SERVICEKEY& SERVICENAME&
SERVICEVERSION
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
DISP PPS VERSION: SERVICEKEY=200
Issue 01 (2008-01-28)
2-341

2.11.13 Querying the Service Configuration Information

Command Name
DISP PPS CONFIG
Command Function
This command is used to query service configuration information.
Input Parameters
DISP PPS CONFIG:
Output Parameters
ACK: DISP PPS CONFIG: RETN=, DESC=[, ATTR=,RESULT=]
Table 2-365 Description of the output parameters of: DISP PPS CONFIG
Parameter
RETN
Description
DESC
ATTR

operation.
SERVICEKEY& STARTSEQUENCE& MINCARDNOLEN&
MAXCARDNOLEN
RESULT
Example
DISP PPS CONFIG:
2.11.14 Querying Time Segments

Command Name
LIST PPS TIMESEG
2-342
Issue 01 (2008-01-28)

Command Function
This command is used to query the time segment of an SP.
Input Parameters
LIST PPS TIMESEG: [SPID =,][TIMEINDEX=]
Table 2-366 Description of the input parameters of: LIST PPS TIMESEG
Parameter
Description
Value Range
SPID
It is the unique
identifier of a
service provider.
[Value Range]
TIMEINDEX
It is the index of
time segment
setting.
[Value Range]
99999.
Output Parameters
ACK: LIST PPS TIMESEG: RETN=, DESC= [, TOTAL =, FINISHED =, SN =, NUMOF =,
ATTR =, RESULT =]
Table 2-367 Description of the output parameters of: LIST PPS TIMESEG
Parameter
RETN
Description
9510: Time Index Does Not Exist.

DESC
ATTR

operation.
timeSegmentIndex& timeSegmentName& timeType& startTime&
endTime
RESULT
TOTAL
FINISHED

0: No
Issue 01 (2008-01-28)
2-343

Parameter
Description
1: Yes
SN

NUMOF
Example
LIST PPS TIMESEG: SPID = 23
Or
LIST PPS TIMESEG: TIMEINDEX = 1
2.11.15 Query Government Tax Logs

Command Name
QRY PPS GOVTAXLOG
Command Function
This command is used to query the information on the tax paid to the government.
Input Parameters
QRY PPS GOVTAXLOG: [CARDNUMBER=] [,PSTNNUMBER=] [,STARTTIME=]
[,ENDTIME=], SDUID=
Table 2-368 Description of the input parameters of: QRY PPS GOVTAXLOG
Parameter
Description
Value Range
CARDNUMBER

for which query
needs to be done.
[Value Range]
It is the complete
calling number for
query.
[Value Range]
It is the Start date

and time from which
log has to be
queried.
[Value Range]
It is the End date

and time from which
log has to be
queried.
[Value Range]
PSTNNUMBER
STARTTIME
ENDTIME
2-344
It is a numerical string of length 2 to20

digits.
It is a numerical string of length 1 to 20

digits
It is in the form of
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.
Issue 01 (2008-01-28)

Parameter
Description
Value Range
SDUID
It is the id of the
SDU in which data
needs to be queried.
[Value Range]
An integer in the range 1 to 65535.
Output Parameters
ACK: QRY PPS GOVTAXLOG: RETN=, DESC=[, TOTAL=, SN=, NUMOF=, FINISHED=,
ATTR=, RESULT=]
Table 2-369 Description of the output parameters of: QRY PPS GOVTAXLOG
Parameter
RETN
Description
2362: Either card number or PSTN Number should be supplied.
2363: Start date time should not be null if end date time is entered.
2364: End date time should not be null if start date time is entered.
1019: The end time can not be earlier than the start time.
2361: Start date time is invalid.
2365: End date time is invalid.

DESC
ATTR

operation.
sn& pstnNumber& cardNumber& areaId& recordTime& tax&
currencyType
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Issue 01 (2008-01-28)
2-345

Example
QRY PPS GOVTAXLOG: CARDNUMBER=12345678,SDUID=101
2.11.16 Query Password Modification Log

Command Name
QRY PPS PASSWDMODLOG
Command Function
This command is used to query the details of password modification.
Input Parameters
QRY PPS PASSWDMODLOG: [ACCOUNTNUMBER=] [,PSTNNUMBER=]
[,STARTTIME=] [,ENDTIME=] SDUID=
Table 2-370 Description of the input parameters of: QRY PPS PASSWDMODLOG
Parameter
Description
Value Range
ACCOUNTNUMBER
It is the card number for

which query needs to be
done.
[Value Range]

number for query.
[Value Range]
It is the Start date and time

from which log has to be
queried.
[Value Range]
It is the End date and time

from which log has to be
queried.
[Value Range]
It is the id of the SDU in

which data needs to be
queried.
[Value Range]
PSTNNUMBER
STARTTIME
ENDTIME
SDUID
It is a numerical string of
length 2 to20 digits.
It is a numerical string of
length 1 to 20 digits
YYYYMMDDHHMMSS.
YYYYMMDDHHMMSS.

65535
Output Parameters
ACK: QRY PPS PASSWDMODLOG: RETN=, DESC=[, TOTAL=, SN=, NUMOF=,
2-346
Issue 01 (2008-01-28)

Table 2-371 Description of the output parameters of: QRY PPS PASSWDMODLOG
Parameter
RETN
Description
2362:Either card number or PSTN Number should be supplied.

2363:Start date time should not be null if end date time is entered.
2364:End date time should not be null if start date time is entered.
2361 :Start date time is invalid.
2365:End date time is invalid.
1019: The end time can not be earlier than the start time.

DESC
ATTR

operation.
Sn& pstnNumber& accountNumber& areaId& recordTime& operation&
successFlag
RESULT
TOTAL
FINISHED

0: No
1: Yes
SN

NUMOF
Example
QRY PPS PASSWDMODLOG: ACCOUNTNUMBER =12345678, SDUID=101
Issue 01 (2008-01-28)
2-347
MML Command Reference

Guide
HUAWEI TECHNOLOGIES CO., LTD.
PPS Prepaid & Postpaid Card Service MML Command

Reference Guide
PPS Prepaid & Postpaid Card Service MML Command Reference
Guide
PPS Prepaid & Postpaid Card Service MML Command Reference Guide

Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China
www.huawei.com
1. First Archived:
[User Manual Name]: PPS Service MML Command Reference
Guide(V500R002C01B020_01)
[Archiving Time]: 2008.01.28
[Words]: 76730
[Print Pages]: 373
[Inserted Blank Pages]:2
[New Added/Modifed Pages]:373
[Information Specialist]:Archana
[Author]:Anju
[Reviewer]:Alex, Raksha, Archana
[Archiving Inspector]:Xuelinaying
[Readability]: 60.6
[Note for Modification]: The MML Command Reference Guide is new.
Printing Note: English

Be sure to use the Huawei IDD document template. Any change without permission from
Huawei is not allowed.
English
1 General notes:
Print the document by odd/even-numbered pages. Do not add any blank pages. All level1 headings (Table of Contents, Chapter Headings) must be started from odd-numbered
pages. If the previous even-numbered pages are blank, do not add any headers or footers.
All modular documents must have some light blue separators between modules.
Non-modular documents:
Cover & Spine, Title Page, Contents, About This Document, Body, Appendix
Modular documents:
Cover & Spine, Title Page, Contents, About This Document, First Part page First text (edocument name) Second Part page Second text (e-document name) ......
2 Format of archived document (Please select): word/PDF required for non-English
international documents/ PageMaker is required for colored printing
/CorelDraw/illustrator/Notes for others
3 Special requirements (Please select): Chinese & English combined/English & Arabian
combined/Colored printing/Gatefold/Plastic bag /Notes for others C For combined
volumes, keep consistent with the sequence of binding
4 Binding specification (Please select): 16K (210mm*285mm)/large 32K (143mm X
208mm)/Middle32K(120mm X 171mm)/ Notes for others
5 Binding mode (Please select): Adhesive/Staple
6 Cover and back cover (Please select): Huawei universal cover / Huawei-3Com
cover/Hi-Silicon cover/Self-designed cover/Notes for covers with carriers logos
7 Operating system (Please select): windows98/windows2000/windowsXP, Chinese or
English
8 Authoring environment (Please select): OfficeXP Chinese/OfficeXP
English/Office2003 Chinese/Office2003 English
9 Contact: XXXXXX Tel:

PPS Service MML Command Reference Guide (V500R002C01B020 - 01)

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

PPS Service MML Command Reference Guide (V500R002C01B020 - 01)

Uploaded by

Copyright:

Available Formats

PPS Prepaid & Postpaid Card Service

MML Command Reference Guide

Huawei Proprietary and

Huawei Technologies Co., Ltd.

Huawei Industrial Base

Copyright 2008 Huawei Technologies Co., Ltd. All rights reserved.

Trademarks and Permissions

Huawei Proprietary and

PPS Prepaid & Postpaid Card Service

About This Document ................................................................................................................ 1

2 Description of PPS-BMML Commands .............................................................................2-1

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

2.3.13 Adding Calling Numbers without IVA ..................................................................................... 2-27

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

2.5.3 Querying Relevant Information of Products ............................................................................... 2-92

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

2.6.32 Adding Batch Level Parameters..............................................................................................2-177

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

2.7.39 Adding Green Numbers at Subscriber Level............................................................................2-261

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

2.10.11 Querying Charge Measure Table ...........................................................................................2-326

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

Huawei Technologies Proprietary

PPS Prepaid & Postpaid Card Service

About This Document

About This Document

PPS Prepaid & Postpaid

This chapter describes the PPS-BMML system overview,

Huawei Technologies Proprietary