OVNPM 1.5.2 - Performance Agent for NonStop Server Monitoring Guide

60
6 Configuring File Scanning
6-1 Introduction
The File Scanning module enables a large number of files to be monitored for size, and file presence in real time,
without impacting the OVNPM domain size limit.
The File Scanning module scans all the files defined in the [FileScan] section of the configuration file XCFGFIL,
examines the full.% and the free-extent.nb metrics of each file, and sends an alert if the full.% or the free-extent.nb
metrics reach the defined threshold. It checks if the files defined in the [FileAvailability] section are present or not
and sends an alert for each missing file. It also counts the files defined in the [FileCount] section and checks if the
number of files has reached the defined threshold or interval. If the threshold has been reached, it sends an alert.
The alert message is sent to the Display Server that forwards it to designated output devices.
After the scan of all configured files, the FileScan process waits for a defined period of time (minimum 15
minutes) before scanning the same files again.
The Collect Manager launches the FileScan process when the collection is started. The Collect Manager uses the
associated environmental variable (OVNPM^xsfile^...) defined in the VISENV file to launch the FileScan process
with the properties (CPU, Priority, Process name) defined by the user.
6-2 Displaying File Scanning Messages
FileScan messages are sent to the following output devices:
• Four output devices configured in the file VISENV (^alert^out0 to ^alert^out3 environmental variables)
The default value for ^alert^out0 is $0, so FileScan messages are sent to $0.
• SystemAlert window
• Display Agent Information window
To prevent messages from appearing in the Display Agent information window, add the parameter SendDisplay
Agent=0 to the file DCPRM.
6-3 File Scanning Configuration File
The file XCFGFIL, which is in the configuration subvolume, describes the File Scanning configuration. This file
contains the following four sections
• General
• FileScan
• FileAvailability
• FileCount
6-3-1 General section
The [General] section, which is the first section, specifies the default thresholds of related parameters and the
delay between two scans.
The following table explains the parameters of the File Scanning process.
Parameter
Description
Full.%
Default Full.% threshold
Free-Extent.nb
Default Free-Extent.nb threshold
ScanDelay
Delay between two scans expressed in minutes
The minimum value is 15 minutes.