Orb Data – The Chapel Grenville Court, Britwell Road, Burnham, Bucks SL1 8DF, UK.
Tel: 01628 550450 email: info@orb-data.com
The Orb Data File Details Agent collects file or directory data from Windows servers using regular expressions to identify the files and directories.
Many applications that form the backbone of customer solutions rely on the creation and timely processing of files and/or directories. Those file/directory names are commonly dynamic, often including transaction IDs or date and time stamps. Although the Windows OS Agent File Trend Attribute Group can collect data on files and directories the selected Watch name is a literal string, making it redundant for many applications. This agent is designed to resolve this problem, enabling data to be collected from files/directories matching one or more predefined regular expression.
The search can be limited to a single directory or a specified number of sub-directories. Data collected can then form the basis for a standard Situation formula, for example generating a situation event when the file creation time is greater than one hour old, a condition that may indicate that the application has stopped processing in-bound data.
The Orb Data File Details Agent is built on IBM Tivoli Monitoring 6.2.3 Agent Builder technology. It includes support for the Self-defining agent feature and is shipped with the TCR Cognos data model for reports generation.
The File Details Agent gathers file and directory data based on a local configuration file. The file can define one or more regular expression based search to identify the files or directories from which to collect data.
For example, an application may receive files for processing in the directory C:\Application\input , with the file names in the format IN-##########.csv. It may be expected that the application processes the information in each file within 5 minutes. In this scenario the File Details Agent may be configured to search the directory C:\Application\input for files using the regular expression match IN-[\d]{10}.csv. The size and time stamp data would be collected and a situation defined to alert if the create time stamp is greater than 5 minutes old.

In addition, to the file or directory details the agent also provides:

The following situations are supplied with the agent:
| Situation | Severity | Description |
| FD_Summary_Count_W | Warning | One or more files/directories exists in the specified search directory has exceeded 1 |
| FD_Runtime_Message_C | Critical | A FATAL message has been nlogged by the file details agent |
| FD_Runtime_Message_M | Minor | An ERROR message has been nlogged by the file details agent |
| FD_Runtime_Message_W | Warning | A WARNING message has been nlogged by the file details agent |
| FD_PerformanceObj_SlowResponse_W | Warning | The data collection for the agent took longer than 10 seconds |
The agent can be configured to search one or more directory using regular expressions to identify the files/directories of interest.
This file can be maintained locally, or centrally using a tool such as the Orb Data Self Service Portal or the ITM Centralized Configuration feature.
Version 1.0 of the agent supports the Windows 32/64 bit operating systems.
The Orb Data File Details Agent is built on IBM Tivoli Monitoring 6.2.3 Agent Builder technology. It includes support for the Self-defining agent feature and is shipped with the TCR Cognos data model for reports generation.