A-3
Appendix A Event Log Scripts
Redline Communications Inc.. Confidential and Proprietary
Input Requirements
This script scans every file within the working directory with the extension of .log.
This script requires that the file inventory.txt be present in the working directory. This file
is used to provide a translation between IP address and sector name.
Optionally, a file named exceptions.txt can be placed in the working directory. This file
should contain, one per line, the name or IP address of any sector controllers you wish to
exclude from the generated report.
Usage
To use the script, enter the following at the command line:
perl scan.pl
Once processing is complete, the results are saved directly to the.csv file, that is named
based on the date/time that the script was executed.
You can limit the execution to a single subscriber unit based on the following command line
argument:
perl scan.pl -s <
MAC Address
> or <
subscriber name
>
Output
The output for this script will be output to a.csv file. This file is divided into four sections.
First, the script will print an overall summary that includes the following:
•
the total number of de-registrations found
•
the number of unique subscriber units that de-registered
•
the number of de-registrations due to re-ranging
•
the number of de-registrations due to retries.
In the second section, a list of the top 100 subscribers is provided. This list is ordered by
the number of de-registrations from greatest to least. For each subscriber, its sector and
frequency are also be included, as well a breakdown of the number of de-registrations due
to re-ranging and retries.
In the third section, the script prints the total number of de-registrations for each sector.
and in the last section the total number of de-registrations encountered at each frequency.
See “Subscriber Unit De-Registration” on page 5-28 for information on possible causes of
de-registration.
