VA FileMan V. 22.2 Programmer Manual Banner

 

Contents: Main Chapter See Also: Getting Started Manual Advanced User Manual

Auditing API

TURNON^DIAUTL(): Enable/Disable Auditing

Reference Type Category ICR #
Supported Auditing 4397

The TURNON^DIAUTL API turns on (or off) auditing for specified fields in a file (except for COMPUTED and WORD-PROCESSING fields). These changes are recorded in the Data Dictionary audit if the file has Data-Dictionary auditing turned on. Also, INPUT templates containing the changed fields are recompiled.

Format
TURNON^DIAUTL(file,field[,mode])
Input Parameters
file (Required) File number of a file that is being audited. 
field (Required) Specifies which fields from the file are forced on ("ALWAYS") for auditing.  Can be one of the following: 
  • A single field number.

  • A list of field numbers separated by semicolons.

  • A range of field numbers in the form M:N; where M and N are the end points of the inclusive range. All field numbers within this range are audited.

  • An asterisk (*) meaning "audit all fields."
mode (Optional) This is an optional parameter. It defaults to "y," which means to turn on auditing.
  • y (Default)—Yes, always audit. Turn auditing on.

  • e—Audit only when edited or deleted.

  • n—No, do not audit. Turn auditing off.
 
Examples

To turn on auditing for the STOP CODE NUMBER (#8) field in the HOSPITAL LOCATION (#44) file:

    >D TURNON^DIAUTL(44,8)

Or:

    >D TURNON^DIAUTL(44,8,"y")

To turn off auditing for that field:

    >D TURNON^DIAUTL(44,8,"n")

 

Reviewed/Updated: March 10, 2007