VA FileMan Programmer Manual: Audit Condition

Contents:

Main

Advanced File Definition

Audit Condition

You can make a data audit conditional when you define a field as being audited. An audit condition is a line of M code with the characteristics that follow:

Condition must contain an IF statement or in some way set $T.
Audit takes place only if $T=1.
Variables available to a developer are listed in Table 118.

Table 118: Audit Condition—Variables

Variable	Description
DA	Internal number of the entry being audited. The DA-array exists if the audit is in a subfile.
DIE	The global root of the file or subfile being audited.
DIIX	A two-piece variable as described below: piece 1: 3—If this audit is taking place during a SET. 2—If this audit is taking place during a KILL. piece 2—Field number being edited.
X	The internal representation of a field's value (i.e., the actual stored value). X is always present, but its value varies based on the first piece of DIIX: If $P(DIIX,U,1)=3, then X equals the new value in the field. If $P(DIIX,U,1)=2, then X equals the old value in the field.

If the DATA TYPE field value of the field being audited is a POINTER, VARIABLE POINTER, or SET OF CODES, then the internal value of the field and its data type is stored. The old value is stored on node 2.1 of the entry in the AUDIT (#1.1) file and the new value is stored on node 3.1.

Reviewed/Updated: May 2026