Maintaining Audit Snapshot Data
Audit snapshot data is the supplemental data for the auditing and effective dating feature. Auditing and effective dating information is stored on each business object whose business class implements the auditing and/or effective dating patterns.
To maximize runtime efficiency, audit snapshot data is stored in a different form than business class data. This utility allows a Lawson administrator to verify whether the audit snapshot data is in sync with the auditing and effective dating logs, and correct any inconsistencies that might occur. The datamaint utility is often used as part of an upgrade or update in order to verify the integrity of any changes to the data that occurred as part of the update or upgrade.
You can also use the datamaint utility at other times to verify
the aspects of the data covered by this utility. A typical sequence
would be to run datamaint with the --auditsnapshot
option in the verify mode, examine the log files that are created,
and then run the appropriate updates. For example, you can run datamaint -–auditsnapshot
for a single business class
if that is all that needs fixing. You can also run datamaint
-–auditsnapshot
without the -c
option
if the log file indicates no Current Row/AuditLog mismatches that
need fixing.
You can find log files at
%LALOGDIR%\datamaint\auditsnapshot.log.dataArea.Stamp
datamaint --auditsnapshot -V|-U|-F|-H [-cdtrACS] [-n NN] [-f filter] [-w
workFileName] dataArea [businessClass]
Consider the following
Program Option | Description |
---|---|
-A |
Perform a data type validation against all persistent audited fields. For
example, an audited date value of "02190202" would be reported as an invalid
date as it is outside the common date range of "18000101" and "21991231". This
option is only valid if the -V option is also
specified. |
-V
|
Validate snapshot data is in sync with auditing and effective dating logs. |
-U
|
Update snapshot data from auditing and effective dating logs if out of sync. |
-F
|
Force delete and recreate of all snapshot data. This option acquires an exclusive lock on the data area. |
-H
|
Access help for this command. |
-r
|
Prompt for repeat when done. |
-d
|
Show more detailed output. |
-t
|
Show terse output (default). |
-c
|
Correct or verify current row/audit view inconsistencies. |
-C |
Do NOT correct or validate current row/audit view inconsistencies (this is the default for an update mode). |
-S |
Do NOT correct or validate snapshot data. |
-n NN
|
Use multiple concurrent threads when running datamaint . This is useful if you have multiple CPUs available.
|
-f filter
|
Filter criteria. (Valid only when business class is specified.) |
-w workFileName
|
Process the business classes listed in the specified work file. |
dataArea
|
Select a data area to work with. |
businessClass
|
Select a specific business class to work with. |