mfaudit.emitter.emitter-name#property

Syntax:

mfaudit.emitter.emitter-name#property=property-value

Parameters:

`emitter-name`	The name of the audit emitter for which the property is to be set.
`property-name`	The name of the emitter property to set.
`property-value`	The value of the emitter property to be set. Emitter names and property names are case-insensitive.

Default:

The properties and associated values depend on the emitter.

Comments:

mfaudit.emitter.emitter-name#property is used to set the property with the given name and value for the given emitter. Any property name and value can be set, irrespective as to whether the emitter will actually make use of it. The CBL_AUDIT_EMITTER_PROPERTY_GET API can be used by an emitter to retrieve property values as strings or numeric values.

Multiple mfaudit.emitter.emitter-name#property entries may occur in the configuration file, but an entry which specifies a property for an emitter that has previously been set will cause the previous property value to be replaced.

Property names are case insensitive.

If any of the following well-known property case-insensitive values are used, they will be held in two forms: the string as given, and a corresponding numeric value. An emitter can then use the CBL_AUDIT_EMITTER_PROPERTY_GET API to retrieve the numeric value of the property directly without needing to perform its own string conversion.

String Value	Numeric Value
ON	1
OFF	0
YES	1
Y	1
NO	0
N	0
TRUE	1
FALSE	0
ENABLED	1
DISABLED	0
numeric-string	n

Examples:

Set the audit file name, the number of files in the audit file collection, and the maximum size of each audit file in the backup set for the AUDITFILE emitter.

...
mfaudit.emitter.auditfile#collectionsize=3
mfaudit.emitter.auditfile#location=e:\audit
mfaudit.emitter.auditfile#file= myaudit.aud_$(GEN)
mfaudit.emitter.auditfile#maxfilesize=200
...

This would potentially cause myaudit.aud_1, myaudit.aud_2, and myaudit.aud_3 to be created in the directory e:\audit. Each of these files would have a maximum size of 200kb.