Library functions available | HP Transcend Traffix Manager specs

148APPENDIX E: AUTOMATIC ATTRIBUTE ASSIGNMENT

Table 20 Example Programs		(continued)

Name	Language	Description

country	Visual Basic	Simple example program which assigns an
		attribute country based on DNS name.
template	Visual Basic	Empty attribute program which does nothing, but
		which contains all the necessary project files and
		declarations to build an attribute lookup program.

The C examples are located in C:\Transcend Traffix

Manager\TraffixServer\examples\c and the Visual Basic examples are in C:\Transcend Traffix

Manager\TraffixServer\examples\vb. You should copy one of these samples to your own directory before modifying it.

Attribute lookup programs must be able to find the attripc.dll file when they are running. This file is located in the Traffix Manager install directory. In order that your program can find this file, you should copy your program to the Traffix Manager install directory and run it from there, or you should add the Traffix Manager install directory to the PATH environment variable (it must be added as a system environment variable, not a user variable). Be careful not to overwrite any of the executables already in the Traffix Manager install directory.

Once you have built your attribute lookup program and copied it if necessary, you should add it to the user-defined attribute program configuration file (see “Contents of the User-defined Attributes Configuration File” on page 138).

Library functions available

Table 21 shows a full list of the functions available to attribute lookup programs in the attripc DLL library:

Table 21 Functions available to lookup programs in the attripc DLL library

FunctionDescription

GetNextLookup Takes no arguments. Returns an integer. This function waits until Traffix Manager want to determine new attributes for a device, or until Traffix Manager is closing down. If Traffix Manager wants to determine attributes for a device, this returns 1. If Traffix Manager wants your program to exit, this function returns 0.

(continued)

Image 148

HP Transcend Traffix Manager manual Library functions available, FunctionDescription

Contents

User Guide 3Com Corporation 5400 Bayfront Plaza Santa Clara, California Contents Part II HOW Traffix Manager Works Collecting Data Displaying Connections To and From Objects Overview Predefined Event Rules Viewing Events Report Types Using the SubnetsDB File How Subnet Grouping Works 3Com Agents Supported Interface Types Online Technical Services 163 World Wide Web Site Monitoring Network Segments Using RMON-1 AgentsSnmp Tables used by Traffix Manager Page Where to find specific information About this GuideDocumentation If you are looking for Turn to Appendix a Conventions List conventions that are used throughout this guideText Conventions Icon Description Terminology Used This GuideRelated Documents Miscellaneous CommentsPddtechpubscomments@3com.com Compliance Year3Com 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 Strategy for New Users Traffix Manager Overview Installing Rmon Transcend NCS Network Administration Guide forLaunching Traffix Manager For the First Time Agents on Your Launching Traffix ManagerServer Client Launching the Traffix Manager Client Managerwindow Traffix Manager Main Window Main Window ReferenceGrouping devices Minus sign next to the group Menu Option Function Display Collection EventsReports Help Traffix Manager Main Window Menu Options HOW Traffix Manager Works Page Collecting Data How TraffixManager Processes Collected Data Collected Data is added to a Relational Database Rmon Overview How Traffix MAP OverviewThis chapter contains the following sections Geographical location Attributes Be familiar with the concepts of attributes and groupingsPredefined attributes you can change these or add your own Unknown, or unassigned Installdir Groupings Assigning MAC AddressesRecords an entry for both devices and both devices appear Device a with the MAC address of the router Groupings Deselect Collapse Redundant Grouping Select this grouping Groupings Groupings dialog box III Running Traffix ManagerPage Launching Traffix Manager After the First Time Launching a TraffixManager Client After the first time. It contains the following sections There are two access levels for running the client Configuring Agents for Data Collection Interfaces Configuring Agents for Data Collection Adding and Editing Agents Community Access LevelsLevel Description Viewing Agent Statistics Polling for Data CollectionPolling Agents Over a WAN Link Suspending and Resuming Data Collection Manually Finding Agents for Data Collection Configuring Agents for Data Collection Displaying Network Traffic Main Window Loading NetworkTraffic Data You make these selections in the Load Traffic dialog box Objects in the Main Working withWindow Displaying Network Group StatisticsSelecting Them From Objects ObjectsDescription of Display Buttons Protocols Applications Favorites Displaying Network Traffic in the Main Window RMON-2 Limitations Displaying Network Traffic in the Main Window Displaying Traffic in Graphs Information about selected items Using the Graph Panel Graph Dialog Box Using the LaunchItems in the Map Launch Graph dialog box Using the Launch Graph Dialog Box Displaying Traffic in Graphs Using Event Rules Using Event Rules Examples of Event Rules Monitor Network Resource Usage Monitor Critical Devices Monitor Critical Connections Monitor Network Trends Specifying Devices Selecting Protocols Specifying Sensitivity Specifying the Time FilterSpotting General Long Term Trends Monitoring Which Devices Are Using a Server Maintaining Network SecurityEnforcing Corporate Policy About Network Usage Monitoring Protocol Usage Monitoring WAN Links and Backbone Detecting Unauthorized ServersMonitoring Congestion on WAN Links Detecting Network Misuse Using Event Rules Viewing Events Viewing Events You use the Event List to display information about events By severity Filter dialog box Do not summarize By event rulePrint Managing Selected ViewingEvents Configuring an Open Management Platform OMP Configuring Traffix Manager to Forward Events as Snmp TrapsClick Add Forwarding Events as Snmp Traps Viewing Events Overview of Reporting During a specified period Reports Daily Reports Time Line for Daily Report Generation Weekly Reports Monthly Reports Report Manager has three main areas Report Manager Managing Reports Scheduling Reports Running Ad HocReports Managing Raw Data Managing Reports Change the lifetime of that raw report data or output Strategy for ReportingTraffix Manager Use Graphs to Identify Key Components Quickly Effects of Grouping On Reports Report Types Report Section Chart Title Connection Activity Report ChartsReport Device Activity Group Activity There are three ways you can report on groupsExternal Traffic flowing into or out of the group only Internal Traffic flowing within the group only Segment Activity Report Charts Unusual error totals. These baselines are calculated Top N Connections Received over the report period Top N Connections Report Charts Top N Connections Report Charts Top N Devices Report Charts Top Devices Remainder are grouped as other Device History Top N Groups Report Charts Top N Groups Percentage of errors Top N Segments Report ChartsTop N Segments Segments report Top N Segments Report Charts Utilization Appendices and Index Page Troubleshooting Traffix Manager TroubleshootingRunning Traffix Manager, and their solutions Contains descriptions of problems you might encounter when Diagnosing Traffix Manager Problems Reporting features of Traffix ManagerReports If Browser is not in your path message is displayed Internal traffic Error could not Appendix a Troubleshooting Traffix Manager Traffix Control Panel This appendix contains Database These applications help you to manage and organize a numberNetwork over time Provides the following applications for managing databases Database Maintenance Clean databases Repair databases Optimize databases Install\traffix\config Upgrading Traffix Manager Deinstalling Traffix To deinstall Traffix Manager 2.0 for NT Manager Appendix B Database Management Using Traffix Control Panel Aggregating Devices DefaultAggregation Local Domain Specification Selecting the Default Aggregation Action Setting a Maximum Device Limit Com Using the Subnetsdb File UsingSubnetsDB File File can be edited and reapplied at any time Class Description How Subnet Grouping Works Appendix D Using the Subnetsdb File Automatic Attribute Assignment Overview Contents User-defined Attributes Configuration File Mylookup fileattrs.exe c\my data\data.txt True Using the fileattrs Program PerformingAttribute Assignment True Appendix E Automatic Attribute Assignment Lookup2 Lookup2 Companies dblookup.exe c\data\companies.mdb Installdir\TraffixServer\examples All example programs are included There is one version in Visual Basic and one in C Simple attribute lookup process in C Example Programs Name Language Description Library functions available FunctionDescription Function Description GetAttribute Appendix E Automatic Attribute Assignment Supported RMON-2 Devices Types Appendix F Supported RMON-2 Devices Configuring 3COM DownloadingFirmware to 3Com Standalone Agents RMON-2 Agents RMON-1 Table Sizes RMON-2 Table SizesPage Appendix G Configuring 3COM Standalone RMON-2 Agents Manager Monitors Dhcp DevicesWhat Effect Do Dhcp Devices Have Chapter H Dhcp Using RMON-1 Agents Using RMON-1Monitoring Network Segments Appendix I Using RMON-1 Agents Snmp Tables used by Traffix Manager RetrievalMandatory Comments ProtoDist For protocol distribution reports only Services ServicesTechnical Support Online Technical Access by Analog Modem Username anonymousHours a day, 7 days a week Country Data Rate Telephone Number 847 262 Access by Digital Modem408 727 Europe, South Africa, and Middle East Country Telephone Number Asia, Pacific Rim Country Telephone Number Fax Number Page Glossary Glossary Glossary Glossary Glossary Tree See Object List Index Numbers 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