Safeguard Audit Service Manual (G06.24+, H06.03+)

Producing SAFEART Reports
Safeguard Audit Service Manual—520480-014
6-15
Placing Comments in Command Files
•
Consider specifying the destination file in the command file. If the destination file
already exists, it is overwritten the first time SAFEART writes to it in a session. If
SAFEART writes to the same destination file more than once during the same
session, each report output is appended to the destination file.
Suppose that this sequence of commands is stored in an EDIT file that is intended to
be executed during a SAFEART session:
AUDIT FILE
RESET START TIME
RESET END TIME
RESET PAGE SIZE
RESET WHERE
SET DESTINATION FILE "\euro.$ops.march.faillogs"
SET TITLE ("Failed Logons")
SET WHERE Operation=VerifyUser AND Outcome<>UserValid
The purpose of this file is to select failed logon attempts for your report. The AUDIT
FILE command and several RESET commands clear any possible values that might
have been defined earlier in the session. Also, no audit file or time interval is specified.
Specify these parameters after running the command file and then issue the START
command to begin production of the report.
Placing Comments in Command Files
To place a comment in a command file, use a double hyphen (--) to delimit the
comment. These two comment lines begin a command file:
-- This file establishes criteria to produce
-- a report of failed logon attempts
You can also place comments at the end of a command line:
AUDIT FILE -- clears any previous audit file selections
Error Handling in Command Files
When SAFEART encounters an error while processing a command file, it redisplays
the erroneous command, displays an error or warning message describing the nature
of the error, and continues processing. For a description of SAFEART error and
warning messages, see Section 8, SAFEART Error Messages.
Command File Examples
Most likely, you will execute command files during a SAFEART session because some
parameters are not known until you are ready to run the report. The command file
examples on the following pages are designed to be executed during a SAFEART
Note. You cannot use the NOWAIT option during a SAFEART session, so you might
experience a delay in getting control back at your terminal. After executing the commands in an
command file, SAFEART returns control to your terminal without leaving the current session.