Sets an emitter property.
Syntax:
mftrace.emitter.emitter-name#property-name=property-value
Parameters:
-
emitter-name
- The name of the 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.
- If any of the following property case-insensitive values are used, they are held in two forms: the string as given, and a corresponding numeric value. A component can then use CBL_CTF_EMITTER_PROPERTY_GET to retrieve the numeric value of the property directly without needing to perform its own string conversion.
| String Value |
Maps to |
| ON |
1 |
| OFF |
0 |
| YES |
1 |
| Y |
1 |
| NO |
0 |
| N |
0 |
| TRUE |
1 |
| FALSE |
0 |
| ENABLED |
1 |
| DISABLED |
0 |
|
numeric-string
|
n
|
Emitter names and property names are case insensitive.
Default:
The properties and their associated values depend on the emitter.
Examples:
To set the trace file name, the number of backup files, and the maximum size of each file in the backup set for the TEXTFILE emitter:
...
mftrace.emitter.textfile#location=e:\logs
mftrace.emitter.textfile#file=mytrace.dat_$(GEN)
mftrace.emitter.textfile#maxgeneration=3
mftrace.emitter.textfile#maxfilesize=200
...
This specifies that mytrace.dat, mytrace.dat_1, mytrace.dat_2, and mytrace.dat_3 would be created in the directory e:\mylogs and each of these files would have a maximum size of 200 Kb.
Comments:
Use mftrace.emitter.emitter-name#property to set the property with the given name and value for the given emitter. You can set any property name and value, regardless of whether the emitter actually makes use of it.
You can specify multiple mftrace.emitter.emitter-name#property entries in the configuration file, but an entry that specifies a property for an emitter that has previously been set overrides the previous property value.