Example Programs | HP Transcend Traffix Manager specification

Writing your own program 147

an attribute New Device to the value TRUE. NL Type is a built-in attribute which is always set to the network type of a device. This means that every IP device is assigned the attribute New Device with a value of TRUE.

■Because of the while loop in the program, the program keeps assigning attributes for devices until Traffix Manager is finished with it.

By replacing this simple loop with your own code, you can write a program which assigns your own attributes to devices using your own algorithm.

GetAttribute returns the value of any attribute which has already been assigned, for example, NL Address and NL Type. See “Predefined Attributes” on page 40 for a list of attributes which are automatically assigned by Traffix Manager. If you have other attribute lookup programs running, you may also use GetAttribute to get an attribute value assigned by another program.

Writing and Building To build your own attribute lookup program, you should copy one of the Your Own Attribute example programs and modify it. You can also look at these programs for

Lookup Program more examples of how to write attribute lookup programs. There are 6

example programs supplied, as shown in Table 20.

Table 20 Example Programs

Name	Language	Description

fileattrs	C	Complex program which parses a text file and uses
		it to assign attributes (see “Using the fileattrs
		Program” on page 140).
nbtlookup	C	Example program which uses NetBios Status
		messages to find out the names of users who are
		currently logged on to the Windows system.
country	C	Simple example program which assigns an
		attribute country based on DNS name.
template	C	Empty attribute program which does nothing, but
		which contains all the necessary project files,
		source files and include files to build an attribute
		lookup program.
dblookup	Visual Basic	Complex program which assigns attributes based
		on the contents of a spreadsheet or database (see
		“Using the dblookup Program” on page 142).

(continued)

Image 147

HP Transcend Traffix Manager manual Example Programs, Name Language Description

Contents

User Guide 3Com Corporation 5400 Bayfront Plaza Santa Clara, California Contents Part II HOW Traffix Manager Works Collecting Data Overview Predefined Event Rules Displaying Connections To and From Objects Viewing Events Report Types 3Com Agents Supported Interface Types Using the SubnetsDB File How Subnet Grouping Works Monitoring Network Segments Using RMON-1 Agents Online Technical Services 163 World Wide Web SiteSnmp Tables used by Traffix Manager Page If you are looking for Turn to Where to find specific informationAbout this Guide Documentation Appendix a Icon Description ConventionsList conventions that are used throughout this guide Text Conventions Documents Terminology UsedThis Guide Related Comments MiscellaneousPddtechpubscomments@3com.com Year Compliance3Com Year 2000 Web Getting Started with Traffix Manager Page Traffix Manager Overview Traffix Manager Overview How Does Traffix Manager Work? Traffix Manager Gathers Data from the Network Users Strategy for New Traffix Manager Overview Agents on Your Installing RmonTranscend NCS Network Administration Guide for Launching Traffix Manager For the First Time Client LaunchingTraffix Manager Server Launching the Traffix Manager Client Traffix Manager Main Window Managerwindow Minus sign next to the group Main WindowReference Grouping devices Display Menu Option Function Help CollectionEvents Reports Traffix Manager Main Window Menu Options HOW Traffix Manager Works Page Collected Data Collecting DataHow Traffix Manager Processes Collected Data is added to a Relational Database Rmon Overview How Traffix Geographical location MAPOverview This chapter contains the following sections Unknown, or unassigned AttributesBe familiar with the concepts of attributes and groupings Predefined attributes you can change these or add your own Installdir Device a with the MAC address of the router GroupingsAssigning MAC Addresses Records an entry for both devices and both devices appear Groupings Select this grouping Deselect Collapse Redundant Grouping Groupings Groupings dialog box Running Traffix Manager IIIPage After the first time. It contains the following sections Launching Traffix Manager After the First TimeLaunching a Traffix Manager Client There are two access levels for running the client Interfaces Configuring Agents for Data Collection Configuring Agents for Data Collection Community Access Levels Adding and Editing AgentsLevel Description Suspending and Resuming Data Collection Manually Viewing Agent StatisticsPolling for Data Collection Polling Agents Over a WAN Link Finding Agents for Data Collection Configuring Agents for Data Collection You make these selections in the Load Traffic dialog box Displaying Network Traffic Main WindowLoading Network Traffic Data Working with Objects in the MainWindow Them Displaying NetworkGroup Statistics Selecting Objects From ObjectsDescription of Display Buttons Protocols Applications Favorites Displaying Network Traffic in the Main Window RMON-2 Limitations Displaying Network Traffic in the Main Window Information about selected items Displaying Traffic in Graphs Panel Using the Graph Using the Launch Graph Dialog BoxItems in the Map Launch Graph dialog box Using the Launch Graph Dialog Box Displaying Traffic in Graphs Using Event Rules Using Event Rules Rules Examples of Event Monitor Critical Devices Monitor Network Resource Usage Monitor Network Trends Monitor Critical Connections Selecting Protocols Specifying Devices Specifying the Time Filter Specifying SensitivitySpotting General Long Term Trends Monitoring Protocol Usage Monitoring Which Devices Are Using a ServerMaintaining Network Security Enforcing Corporate Policy About Network Usage Detecting Network Misuse Monitoring WAN Links and BackboneDetecting Unauthorized Servers Monitoring Congestion on WAN Links Using Event Rules Viewing Events You use the Event List to display information about events Viewing Events Filter dialog box By severity By event rule Do not summarizePrint Viewing Managing SelectedEvents Configuring Traffix Manager to Forward Events as Snmp Traps Configuring an Open Management Platform OMPClick Add Forwarding Events as Snmp Traps Viewing Events During a specified period Overview of Reporting Time Line for Daily Report Generation Reports Daily Reports Monthly Reports Weekly Reports Report Manager Report Manager has three main areas Managing Reports Managing Raw Data Scheduling ReportsRunning Ad Hoc Reports Managing Reports Change the lifetime of that raw report data or output Use Graphs to Identify Key Components Quickly Strategy forReporting Traffix Manager On Reports Effects of Grouping Report Types Connection Activity Report Charts Report Section Chart TitleReport Device Activity Internal Traffic flowing within the group only Group ActivityThere are three ways you can report on groups External Traffic flowing into or out of the group only Segment Activity Report Charts Unusual error totals. These baselines are calculated Received over the report period Top N Connections Top N Connections Report Charts Top N Devices Report Charts Top N Connections Report Charts Top Devices Remainder are grouped as other Device History Top N Groups Top N Groups Report Charts Segments report Percentage of errorsTop N Segments Report Charts Top N Segments Top N Segments Report Charts Utilization Appendices and Index Page Contains descriptions of problems you might encounter when Troubleshooting Traffix ManagerTroubleshooting Running Traffix Manager, and their solutions Reporting features of Traffix Manager Diagnosing Traffix Manager ProblemsReports If Browser is not in your path message is displayed Internal traffic Error could not Appendix a Troubleshooting Traffix Manager This appendix contains Traffix Control Panel Provides the following applications for managing databases DatabaseThese applications help you to manage and organize a number Network over time Database Maintenance Repair databases Clean databases Optimize databases Upgrading Traffix Manager Install\traffix\config Manager Deinstalling Traffix To deinstall Traffix Manager 2.0 for NT Appendix B Database Management Using Traffix Control Panel Default Aggregating DevicesAggregation Local Domain Specification Selecting the Default Aggregation Action Com Setting a Maximum Device Limit File can be edited and reapplied at any time Using the Subnetsdb FileUsing SubnetsDB File Class Description How Subnet Grouping Works Appendix D Using the Subnetsdb File Overview Automatic Attribute Assignment Contents User-defined Attributes Configuration File Mylookup fileattrs.exe c\my data\data.txt True Assignment Using the fileattrs ProgramPerforming Attribute True Appendix E Automatic Attribute Assignment Lookup2 Lookup2 Companies dblookup.exe c\data\companies.mdb All example programs are included Installdir\TraffixServer\examples Simple attribute lookup process in C There is one version in Visual Basic and one in C Name Language Description Example Programs FunctionDescription Library functions available GetAttribute Function Description Appendix E Automatic Attribute Assignment Types Supported RMON-2 Devices Appendix F Supported RMON-2 Devices Standalone Agents Configuring 3COMDownloading Firmware to 3Com RMON-1 Table Sizes RMON-2 Table Sizes RMON-2 AgentsPage Appendix G Configuring 3COM Standalone RMON-2 Agents Dhcp Devices Have Manager MonitorsDhcp Devices What Effect Do Chapter H Dhcp Network Segments Using RMON-1 AgentsUsing RMON-1 Monitoring Appendix I Using RMON-1 Agents Retrieval Snmp Tables used by Traffix ManagerMandatory Comments ProtoDist For protocol distribution reports only Online Technical ServicesServices Technical Support Country Data Rate Telephone Number Access by Analog ModemUsername anonymous Hours a day, 7 days a week Access by Digital Modem 847 262408 727 Country Telephone Number Asia, Pacific Rim Europe, South Africa, and Middle East Country Telephone Number Fax Number Page Glossary Glossary Glossary Glossary Glossary Tree See Object List Numbers Index Community names definition 53 overview Dhcp 153 Html Detecting unauthorized machine access RMON-2 Snmp User Authorization dialog box 50 User Guide Structure Index 3Com Corporation Limited Warranty Limitation of Liability