Knowledge Base

Fileinfo: Monitoring file parameters with IPCheck using a custom EXE Sensor

The program FileInfo is a custom EXE sensor for the monitoring program IPCheck Server Monitor. It monitors one or more files respective to their size or their date stamp (age). Underlying directories can be considered recursively. As such, it is possible to monitor, e.g. log files in order to control whether certain processes (that are continuously writing data in a log file) are still running.

Filename Pattern/Location Parameter

The only available parameter (excepting for the available options) allows to enter the name of the file(s) you want to monitor. This filename can also contain a wild card symbol. The request will then consider all files that match this description. UNC paths are allowed. 

Default value: C:\*

Options

/? Help

/? Displays the available request options.

/U Units

This option allows to define the units used for the return value. The result is then displayed in the respective unit. Note: Case sensitive!

Available options are:

/U:s Seconds (Default) Only for time-based values (MAXAGE/MINAGE)
/U:m Minutes Only for time-based values (MAXAGE/MINAGE)
/U:h Hours Only for time-based values (MAXAGE/MINAGE)
/U:d Days Only for time-based values (MAXAGE/MINAGE)
/U:B Bytes (Default) Only for size-based values (FILESIZE)
/U:K KBytes (2^10) Only for size-based values (FILESIZE)
/U:M MBytes (2^20) Only for size-based values (FILESIZE)
/U:G GBytes (2^30) Only for size-based values (FILESIZE)
/U:T TBytes (2^40) Only for size-based values (FILESIZE)

/M Modes

Using this option one can define the type of the return value.

/M:FILENUMBER Returns the number of files (Default)
/M:DIRNUMBER Returns the number of all underlying folders (without filter)
/M:MAXAGE Returns the age of the oldest file matching the filename pattern
/M:MINAGE Returns the age of the youngest file matching the filename pattern.
/M:FILESIZE Returns the sum al all file sizes of all files matching the filename pattern

/N Error Behavior

If the option /N is used, a return code value 2 (=Error) is returned if no file can be found that matches the filename pattern.

/R Recursion

Using the option /R files contained in the underlying directories are also taken into account when matching files to the filename pattern.

/D Data Date Type

Defines what file date is used for analysis purposes.

/D:c Creation date (Default)
/D:w Last write access date
/D:a Last access date

Comments

  • Since IPCheck expects an INT32 value as a return value the result when running file size checks may not be larger than 2147483648. This can be avoided using the option /U
  • Since IPCheck expects an INT32 value as a return value the result is always an integral value.
  • When using the option /R in conjunction with large directory structures larger than normal operational times can be expected.

Download

You can download the EXE file here (8 kb, zip).

Note: This file is provided without warranty and support

By Category

Related Articles