- Introduction to Cisco BAMS
- Setup and Installation
- Provisioning BAMS
- Using MML Commands
- Using BAMS Tag IDs
- Configuring BAMS for BAF Output
- Configuring BAMS for ASCII Output and Measurements
- Configuring BAMS for P01 Output
- Configuring BAMS for NICS Output
- Configuring BAMS for 1110 Binary Output
- Configuring BAMS for QoS Output
- Obtaining Measurements
- Troubleshooting Cisco BAMS
- Upgrading to BAMS Release 3.30
- Backing up and Restoring BAMS
- Installing Solaris 10 Version 0708-V02 on Sun Netra T5220
Cisco Billing and Measurements Server User's Guide, Release 3.30
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
- Updated:
- October 19, 2013
Chapter: Configuring BAMS for P01 Output
Configuring BAMS for P01 Output
Overview
This chapter describes how to configure the Cisco Billing and Measurements Server (BAMS) for P01 billing records. You enable P01 output with the NODEPARMS tag ID. For more information, see the "NODEPARMS Tag ID" section.
P01 Output
P01 output files are created by the P01 task. These files are stored in the p001 subdirectory of the data directory. The file layout of the P01 output format includes a header record, call detail record(s), and a trailer record. This data format is binary and is not viewable by a standard text viewer. The P01 file-naming conventions are explained in "File-Naming Conventions" section.
Customized MML Parameters
By default, BAMS generates ASCII output records when processing MGC input data. To turn on the generation of P01 data files, set the p01 output parameter in the Node Parameters table to 1.
The P01 filename format is based on the filename of the raw data files from the MGC:
<p01prefix><raw MGC data filename>
The default P01 prefix is p01_. You can change this prefix by modifying the p01prefix parameter in the Node Parameters table. For example, suppose that an input MGC file is named cdr_200012252359_012345.bin. The output P01 file is named p01_cdr_200012252359_012345.bin. Setting this parameter to NULL creates an output filename that is the same as the input filename.
Examples:
Change the filename prefix of P01 files to "info_":
$ mml
Copyright (C) 1998-2004, Cisco Systems, Inc.
mml:1>prov-sta::srcver=active,dstver=example,confirm
Billing and Measurements Server - BAMS-00 2004-07-27 13:59:06
B COMPLD
;
mml:1>prov-ed:nodeparms:p01prefix="info_"
Billing and Measurements Server - BAMS-00 2004-07-27 13:59:37
B COMPLD
"NODEPARMS"
;
mml:1>prov-rtrv:nodeparms:
Billing and Measurements Server - BAMS-00 2004-07-27 14:00:03
B RTRV NODEPARMS:statoutput=1,bafoutput=0,asciioutput=0,lookupinfo=1,bafinfo=0,p01output=1, qosoutput=0,
p01prefix="info_""
;
mml:1>prov-dply::
Billing and Measurements Server - BAMS-00 2004-07-27 14:00:23
B COMPLD
;
mml:1>quit
Turn off the generation of P01 files:
$ mml
Copyright (C) 1998-2004, Cisco Systems, Inc.
mml:1>prov-sta::srcver=active,dstver=example,confirm
Billing and Measurements Server - BAMS-00 2004-07-27 13:59:06
B COMPLD
;
mml:1>prov-ed:nodeparms:p01output=0
Billing and Measurements Server - BAMS-00 2004-07-27 13:59:57
B COMPLD
"NODEPARMS"
;
mml:1>prov-rtrv:nodeparms:
Billing and Measurements Server - BAMS-00 2004-07-27 14:00:03
B RTRV NODEPARMS:statoutput=1,bafoutput=0,asciioutput=0,lookupinfo=1,bafinfo=0,p01output=0, qosoutput=0,
p01prefix="info_""
;
mml:1>prov-dply::
Billing and Measurements Server - BAMS-00 2004-07-27 14:00:23
B COMPLD
;
mml:1>quit
Filtering Calls Based on Cause Codes
You can configure the P01 program to filter out certain types of calls based on the cause code of the original MGC data record. The P01FILTER tag ID has four parameters that define the call type: ANSWERED, NOANSWER, BUSY, and OTHER. You can set these parameters to 1 to output CDR records of the specified call type, or to 0 to filter the specified records from the output. The call types are defined by the cause code values (see Table 8-1).
|
|
|
|---|---|
16, 31 |
ANSWERED |
19 |
NOANSWER |
17 |
BUSY |
ALL OTHER CODES |
OTHER |
You can use the prov-ed command in conjunction with the P01FILTER tag ID to edit the default filtering values. For more information about configuring P01 filtering, see the "Updating the P01 Filter Table" section.
The following example shows how to turn off all output except for answered calls:
$ mml
mml:1> prov-sta::srcver=active,dstver=example,confirm
Billing and Measurements Server - BAMS-00 2004-07-27 14:02:02
B COMPLD
;
mml:1>prov-rtrv:p01filter:
Billing and Measurements Server - BAMS-00 2004-07-27 14:02:12
B RTRV
"P01FILTER:answered=1,noanswer=1,busy=1,other=1"
;
mml:1>prov-ed:p01filter:noanswer=0,busy=0,other=0
Billing and Measurements Server - BAMS-00 2004-07-27 14:02:42
B COMPLD
"P01FILTER"
;
mml:1>prov-rtrv:p01filter:
Billing and Measurements Server - BAMS-00 2004-07-27 14:02:51
B RTRV
"P01FILTER:answered=1,noanswer=0,busy=0,other=0"
;
mml:1>prov-dply::
Billing and Measurements Server - BAMS-00 2004-07-27 14:02:56
B COMPLD
;
P01 Data Format
Table 8-2, Table 8-3, and Table 8-4 define the header, call detail, and trailer data records of the P01 output format. The field name, length, description, format/contents, and MGC mapping for the P01 header record are described in Table 8-2.
The field name, length, description, format/contents, and MGC mapping for the P01 call detail record are described in Table 8-3.
NoA = international:
The field name, length, description, format/contents, and MGC mapping for the P01 tail record are described in Table 8-4.
Feedback