Billing File Control

The Billing File Control object is a child of the MetaSwitch object. It specifies how the files holding billing information are managed.


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 VP3000 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 VP3000 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).
Maximum primary file size (Kb) Change Maximum total size of all primary billing data files (including the current file). Minimum value is 300 Kb. The default is 2,500,000 Kb.
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:
  • 10%
  • 20%
  • 30%
  • 40%
  • 50%
  • 60%
  • 70% (default)
  • 80%
  • 90%
  • 100%
This must not be greater than the Major alarm threshold. The two thresholds can be equal; in this case, the VP3000 will generate a major alarm at this threshold but will not generate minor alarms.
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:
  • 10%
  • 20%
  • 30%
  • 40%
  • 50%
  • 60%
  • 70%
  • 80% (default)
  • 90%
  • 100%
This must not be less than the Minor alarm threshold or greater than the Critical alarm threshold. The thresholds can be equal; in this case, the VP3000 will generate only the higher alarm when the threshold is reached, and will not generate the lower alarm.
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:
  • 10%
  • 20%
  • 30%
  • 40%
  • 50%
  • 60%
  • 70%
  • 80%
  • 90% (default)
  • 100%
This must not be less than the Major alarm threshold. The thresholds can be equal; in this case, the VP3000 will generate only a critical alarm when the threshold is reached, and will not generate major alarms. A value of 100% indicates that a critical alarm will never be raised.
Current alarm level Read only The alarm level currently in effect for the total primary file size, if any. Values:
  • None
  • Minor
  • Major
  • Critical
Alarm state Read only Specifies whether any alarms are currently raised for this object. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - the object is not operating normally, and needs operator intervention. (This indicates that the total primary file size has crossed one of the thresholds (but is still above the minor alarm threshold).
  • Attend To Dependent
    Attention Required elsewhere - another object on which this object depends is not operating normally.
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 VP3000 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:
  • True
  • False (default)
MetaSwitch FTP address Change IP address from which to FTP billing records from the MetaSwitch system.