Each activity is configured via a separate .ini file located in the Activities sub folder.
When CatTools starts, it searches for all the *.ini files in the Activities sub folder and reads their contents. All the activities found are then available for selection when defining activities.
Sections
The main sections inside the INI file are as follows:
The info section. This is required and identifies the ini file as a CatTools V2 file.
[info]
cookie=Kiwi CatTools
version=2
author=Kiwi Enterprises
The Activity section. This is required and defines the name used within the CatTools interface and within scripting, and the unique key of the activity type in the database.
Even though the filename of the ini file may be similar to the activity name, it is not used to define the activity name.
CatTools reserves id's from 0 to 4999 for supplied activity types. You can use the number range from 5000 to 5999 for custom activities that you define. You must ensure the number is unique.
[Activity]
name=Report.ARP table
script_main=Main.Report.ARP table.txt
script_client=Client.Report.ARP table.txt
description=Collects ARP table forwarding information from devices. Updates a master ARP table
report_file=%AppPath%Reports\Master ARP table.txt
report_overwrite=0
client_threads=0
id=5000
The item sections.
Each item section defines the input fields used for the Device setup GUI.
[item_value1]
name=Use alternate command
type=string
checkbox_show=1
checkbox_default=0
edit_button=0
value_default=
required=0
info="Alternative ARP table gathering command."
[item_value2]
name=Days until entries expire
type=range
checkbox_show=1
checkbox_default=0
value_default=30
range_min=1
range_max=2000
required=1
info="Remove entries older than X days from the Master report"
[item_value3]
name=Resolve IP addresses to hostnames
type=checkbox
checkbox_show=1
checkbox_default=1
info="Resolve all IP addresses found to hostnames via reverse DNS lookup"
The size of each field is determined by the design of the database. Any data entered via the GUI that is too long for the field will be truncated accordingly.