The Billing File Control object is a child of the Billing object. It specifies how the files holding billing information are managed.
Object-Specific Actions | |
Close billing file | To close the current billing data file, move it to the FTP directory, and open a new one, click on this pushbutton. This action can be used to ensure that all billing data up to this point has been retrieved, and is typically used before performing major maintenance work such as software upgrades. |
Parameter |
Access |
Description |
Current BAF file flipping interval (sec) | Change | The time interval in seconds between starting new billing data files. All billing data created during this period of time is written to one file. At the end of this period, the file is closed and moved to the FTP directory, and a new file is started. Range: 1 - 2,000,000. The default is 172,800 (2 days). |
Open active BAF file retry interval (sec) | Change | The time interval in seconds between successive retries if the attempt to open an active billing data file results in a file-open error. Range: 1 - 2,000,000. The default is 60. |
Recounting primary file size interval (sec) | Change | The time interval in seconds between successive counts of the primary file size. If the NE is temporarily unable to write further billing data to file because the total size of primary files has reached its limit, it waits for this interval (during which the administrator can delete or rename primary files to reduce the total file size) before recounting the file size to determine whether it can resume. Range: 1 - 2,000,000. The default is 10. |
Secondary BAF file expiry time (sec) | Change | The time interval in seconds after which secondary billing data files (files that have been processed by the billing application and renamed) can be deleted. This measures the age of the file from the time it was copied to the FTP directory. The NE may delete secondary files before this expiry time if disk space is short, but in this case it writes a problem log. Range: 0 - 2,000,000 (approximately 23 days). A value of zero indicates that secondary files can be deleted as soon as they have been renamed. The default is 432000 (5 days). |
Use sequence number in filenames | Change | Specifies whether the filename for each billing file includes a 3-digit sequence number (000 - 999) as well as a timestamp. Values:
|
Minor alarm threshold | Change | Threshold (expressed as a percentage of the maximum primary file size) at which the total file size results in a minor alarm. Values:
|
Major alarm threshold | Change | Threshold (expressed as a percentage of the maximum primary file size) at which the total file size results in a major alarm. Values:
|
Critical alarm threshold | Change | Threshold (expressed as a percentage of the maximum primary file size) at which the total file size results in a critical alarm. Values:
|
Current alarm level | Read only | The alarm level currently in effect for the total primary file size, if any. Values:
|
Alarm state | Read only | Specifies whether any alarms are currently raised for this object. Values:
|
Alarm log correlator | Read only | Identifier of the log message for the event that caused the last Attention Required alarm state for this object. This field is reset when the Attention Required alarm events field is reset to zero. |
Attention Required alarm events | Read only / Reset | Number of times (since the alarm count was reset) that this object's alarm state has gone to Attention Required. |
Alarm state changed timestamp | Read only | The time at which the Alarm state last changed. |
Alarm events reset timestamp | Read only | The time at which the Attention Required alarm events was last reset to zero. |
Current primary file size (Kb) | Read only | Current total size of all primary billing data files (including the current file). |
Number of BAF record write failures | Read only | Number of times (since system startup) that the NE has failed to write a billing data record to file because of a file I/O error. |
Output start and end records | Change | Specifies whether start and end records, which indicate the time of output and the number of records in the file, are output in BAF files. Note that changes to this field will take effect at the end of the current flip interval, and will not affect the current billing file. Values:
|
MetaSwitch FTP address | Change | IP address from which to access billing records from the MetaSwitch system (using sftp). Specify a standard dotted-decimal IP address. |