AUDITFILE Emitter Properties

The following configuration properties control the behaviour of the AUDITFILE emitter.

Property	Description
AuditfileExit	The name of a DLL that is to be invoked by the AUDITFILE emitter to report on emitter status changes (see AUDITFILE User Exit). The name of the exit specified should reside in a directory on PATH.
CollectionSize	The number of audit files that will be created in a collection. Used in conjunction with MaxFileSize. Default: 5. Maximum 10.
File	The name of the audit file to be written. The following pseudo-variables may be used for the construction of the audit file name: $(AUDITID) - the name of the audit event consolidator that invoked this emitter. $(GEN) - the generation of the file starting from 1. Default: mfaudit.$(AUDITID).aud_$(GEN) For example, the second file in the audit file collection created by this emitter when invoked by the audit event consolidator named nwb-cpjdell would be: mfaudit.nwb-cpjdell.aud_2 N.B. if the $(GEN) pseudo-variable is not included in the file specification, this emitter will implicitly append it.
Location	The directory where the audit files are to be written. Default: the location specified by the MFAUDIT_LOGS environment variable or the current directory if MFAUDIT_LOGS is not set. The emitter will write an error event to the Windows event log if it is unable to create audit files in the specified directory. N.B. The Audit Facility will attempt to create the output audit file location if it does not already exist. If the creation of the directory specified by the Location property fails, it will use the default location. If the creation of the directory specified by the MFAUDIT_LOGS environment variable fails, the current directory will be used. The Net Express command prompt implicitly sets MFAUDIT_LOGS to `NX-install-dir`\base\MFAUDIT\logs. If the MFAUDIT_LOGS environment variable is not set when running as a Windows Service, the Audit Facility will output the audit files to the directory specified by the HKLM\Software\Micro Focus\NetExpress\`ver`\MFAUDIT\5.0\Install\DAT registry key (normally C:\Documents and Settings\All Users\Application Data\Micro Focus\NetExpress\`ver`\MFAUDIT).
MaxFileSize	The directory where the audit files are to be written. The maximum size of an audit file in KB that will be written before the file is closed, and the next audit file in the collection is opened. A file in the collection is identified by the $(GEN) pseudo-variable (see File property above). The first audit file in a collection will result in the $(GEN) pseudo-variable being set to 1, the second in the sequence will result in it being set to 2, and so on until CollectionSize is exceeded. Once the CollectionSize number of files has been reached, the sequence number will revert back to 1. Default: 0x00005000, indicating 20 MB max file size