Avaya PeriReporter User Manual

Publication#:Document Release:Release Date:PeriReporter User’s Guide (Software Release 1.0)P0988093Rev. 1.5April 10, 2002

PeriReporter User’s GuidePage x Nortel Networks Confidential # P0988093Conventions Used in This ManualThis manual uses different fonts and symbols to

PeriReporter User’s GuidePage 100 Nortel Networks Confidential # P0988093Other FunctionsSome functions which are used in PeriDefiner are not configura

PeriReporter# P0988093 Nortel Networks Confidential Page 101Help MenuPeriReporter has an extensive on-line Help menu. You can choose to use the Table

PeriReporter User’s GuidePage 102 Nortel Networks Confidential # P0988093This page has been intentionally left blank.

This chapter covers:6Step-by-StepSample Report1. Instructions for Constructing a Sample Report

PeriReporter User’s GuidePage 104 Nortel Networks Confidential # P0988093Step-by-Step Sample ReportWhat follows are instructions for constructing a sa

Step-by-Step Sample Report# P0988093 Nortel Networks Confidential Page 105• Update the Report SettingsOpen the Report Settings window using the Setup

PeriReporter User’s GuidePage 106 Nortel Networks Confidential # P0988093Select a Folder and Datacard Name for each of the remaining columns that are

Step-by-Step Sample Report# P0988093 Nortel Networks Confidential Page 107• Column G: Highlight the column and enter the formula =F/B. This will take

PeriReporter User’s GuidePage 108 Nortel Networks Confidential # P0988093• Update Display FiltersOpen the Display Filters window from the Column Menu.

Step-by-Step Sample Report# P0988093 Nortel Networks Confidential Page 109• Check to see if the Display Filters are correct. To see how each individua

Preface# P0988093 Nortel Networks Confidential Page xiSolaris and Windows NT ConventionsThis manual depicts examples (command line syntax, configurati

PeriReporter User’s GuidePage 110 Nortel Networks Confidential # P0988093• Column AppearanceOpen the Column Appearance window from the Column menu. Fo

Step-by-Step Sample Report# P0988093 Nortel Networks Confidential Page 111• Fill the ReportTo verify all the column and cell Mappings and Formulas are

PeriReporter User’s GuidePage 112 Nortel Networks Confidential # P09880933. Generate the Report• Open the Report DefinitionClick on the Open icon on t

Step-by-Step Sample Report# P0988093 Nortel Networks Confidential Page 113• Generate ReportClick the Generate Report button on the tool bar.The Report

PeriReporter User’s GuidePage 114 Nortel Networks Confidential # P0988093This page has been intentionally left blank.

Index

PeriReporter User’s GuidePage 116 Nortel Networks Confidential # P0988093Symbols$ASEHOME/copy 36, 60$ASEHOME/stats 24, 25, 26, 28, 46$VPSHOME/common/e

Index# P0988093 Nortel Networks Confidential Page 117datacard name 59decimals 64default detail level 56default end time 56default start time 56detail

PeriReporter User’s GuidePage 118 Nortel Networks Confidential # P0988093MmaintainStats 45manualhypertext links in viiiusing on line viiimathematical

Index# P0988093 Nortel Networks Confidential Page 119command line options 100data mapping 100display filters 100export 96generate 82global settings 93

PeriReporter User’s GuidePage xii Nortel Networks Confidential # P0988093Trademark ConventionsThe following trademark information is presented here an

PeriReporter User’s GuidePage 120 Nortel Networks Confidential # P0988093rows for total 56rows per page 56SsavePeriDefiner 54save symbol 54scatter gra

Index# P0988093 Nortel Networks Confidential Page 121System.TotalCalls 34system statistics 28–34, 44reports 30–34predefined 31system variables 60Ttask

PeriReporter User’s GuidePage 122 Nortel Networks Confidential # P0988093This page has been intentionally left blank.

This chapter covers:1Introduction1. What is PeriReporter?2. Three Components of PeriReporter3. Launch PeriReporter4. Schedule a Report5. Sharing

PeriReporter User’s GuidePage 14 Nortel Networks Confidential # P0988093What is PeriReporter?PeriReporter is a PeriView tool, consisting of three subt

Introduction# P0988093 Nortel Networks Confidential Page 15Three Components of PeriReporterPeriReporter consists of three parts, each dependent on pre

PeriReporter User’s GuidePage 16 Nortel Networks Confidential # P0988093Launch PeriReporterLaunch PeriReporter by typing PeriReporter at the command l

Introduction# P0988093 Nortel Networks Confidential Page 17Schedule A ReportThe Schedule A Report feature is available on Solaris only, and does not w

PeriReporter User’s GuidePage 18 Nortel Networks Confidential # P0988093To Schedule a report, define the following parameters:• MPS/VPS selectionSelec

Introduction# P0988093 Nortel Networks Confidential Page 19• DestinationEnter the device on which the report will be displayed. Select from Printer, P

PeriReporter User’s GuideImportant NoticeNortel Networks reserves the right to make changes in the contents of this publication including functions an

PeriReporter User’s GuidePage 20 Nortel Networks Confidential # P0988093Sharing Data Between Solaris and NTIf PeriReporter is going to be used to coll

Introduction# P0988093 Nortel Networks Confidential Page 21Time ZonesIn certain areas of the world, Java will not recognize the time zones set on the

PeriReporter User’s GuidePage 22 Nortel Networks Confidential # P0988093Hawaiian Standard Time GMT - 10 hours HST Pacific/HonoluluAlaskan Standard Tim

This chapter covers:2Statistical Maintenance1. Collection and Maintenance of Statistical Data2. PeriReporter and the Media Processing Server Network3.

PeriReporter User’s GuidePage 24 Nortel Networks Confidential # P0988093Collection and Maintenance of Statistical DataStatistics are collected and sto

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 25Defining Stat Events in a Single Node EnvironmentThis process applies to a confi

PeriReporter User’s GuidePage 26 Nortel Networks Confidential # P0988093Application Stat Events in a Multi-Node EnvironmentThis process applies to a c

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 27In a multi-node environment, the stat event definition process may involve defin

PeriReporter User’s GuidePage 28 Nortel Networks Confidential # P0988093PeriReporter and the MPS NetworkTypically, a single node in a Nortel Networks

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 29Application statistics are generated during an application’s execution cycle and

Table of Contents# P0988093 Nortel Networks Confidential Page iiiTable of ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

PeriReporter User’s GuidePage 30 Nortel Networks Confidential # P0988093System and Application StatisticsStatistical data originates from user defined

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 31System Statistics Reports SummaryThere are seven predefined System Statistics Re

PeriReporter User’s GuidePage 32 Nortel Networks Confidential # P0988093System Statistical Reports Sheet 1 of 3SPAN REPORTSSpan statistics indicate sp

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 33PHONE LINE REPORTSPhone line statistics indicate phone line usage in both a summ

PeriReporter User’s GuidePage 34 Nortel Networks Confidential # P0988093ARSSystem.ARS: Average Referral Seconds: Detected activity is determined by th

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 35Application StatisticsApplication-specific stat events are generated during an a

PeriReporter User’s GuidePage 36 Nortel Networks Confidential # P0988093The Process of Defining Application Stat EventsAlthough the process of system

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 37PeriProducer and VRAM ApplicationsApplication statistics are collected and store

PeriReporter User’s GuidePage 38 Nortel Networks Confidential # P0988093Gathering Application Statistics (Block Execution Statistics)You can customize

Statistical Maintenance# P0988093 Nortel Networks Confidential Page 39Defining Application (Block Execution) Statistics1. Create a Statistics folder (

PeriReporter User’s GuidePage iv Nortel Networks Confidential # P0988093pchistory.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Com

PeriReporter User’s GuidePage 40 Nortel Networks Confidential # P0988093Determining Blocks Associated With a CounterUse the global Manage Data Folders

This chapter covers:3PeriConsolidator1. Purpose2. Configuration3. Command Line Options

PeriReporter User’s GuidePage 42 Nortel Networks Confidential # P0988093PurposePeriConsolidator reads in the binary application statistics files creat

PeriConsolidator# P0988093 Nortel Networks Confidential Page 43ConfigurationWhen collecting data from a local system, “X” need not be used. When data

PeriReporter User’s GuidePage 44 Nortel Networks Confidential # P0988093Data MaintenanceData maintenance can be performed automatically and is governe

PeriConsolidator# P0988093 Nortel Networks Confidential Page 45ParametersPeriConsolidator allows you to set configurable parameters to automatically h

PeriReporter User’s GuidePage 46 Nortel Networks Confidential # P0988093LoggingWhen PeriConsolidator runs it creates a log file named pericons.log whi

PeriConsolidator# P0988093 Nortel Networks Confidential Page 47Command Line OptionsIf you re-run PeriConsolidator for any day using the -d option, the

PeriReporter User’s GuidePage 48 Nortel Networks Confidential # P0988093This page has been intentionally left blank.

This chapter covers:4PeriDefiner1. Purpose2. PeriDefiner Tool Bar3. Defining a Report

Table of Contents# P0988093 Nortel Networks Confidential Page vGenerating a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

PeriReporter User’s GuidePage 50 Nortel Networks Confidential # P0988093PurposePeriDefiner is a graphical utility which is used to set up the contents

PeriDefiner# P0988093 Nortel Networks Confidential Page 51Launch PeriDefiner through PeriReporterLaunch PeriDefiner by first launching PeriReporter th

PeriReporter User’s GuidePage 52 Nortel Networks Confidential # P0988093PeriDefiner Tool BarPeriDefiner contains a tool bar at the top of its graphica

PeriDefiner# P0988093 Nortel Networks Confidential Page 53Open a Report DefinitionYou can choose to begin a new report definition or modify an existin

PeriReporter User’s GuidePage 54 Nortel Networks Confidential # P0988093Defining a ReportDefining a report is a 6 step process.1. Save the Report Defi

PeriDefiner# P0988093 Nortel Networks Confidential Page 55Update the Report SettingsUse the Report Settings window to determine what your generated re

PeriReporter User’s GuidePage 56 Nortel Networks Confidential # P0988093Column Heading RowsEnter the number of rows to be made available to enter a co

PeriDefiner# P0988093 Nortel Networks Confidential Page 57Define Column Formulas and MappingsDefining Column Formulas and Mappings are the most import

PeriReporter User’s GuidePage 58 Nortel Networks Confidential # P0988093To Enter a Column FormulaTo designate a Value, Label, Expression, or Function

PeriDefiner# P0988093 Nortel Networks Confidential Page 59Column TypeColumn Type will determine what type of information will be displayed in a specif

PeriReporter User’s GuidePage vi Nortel Networks Confidential # P0988093This page has been intentionally left blank.

PeriReporter User’s GuidePage 60 Nortel Networks Confidential # P0988093Application Variables and System VariablesThe Application Variables and System

PeriDefiner# P0988093 Nortel Networks Confidential Page 61Update Individual Columns and CellsUpdate Individual ColumnsAside from assigning a value, la

PeriReporter User’s GuidePage 62 Nortel Networks Confidential # P0988093Key PriorityKey Priority allows you to choose which columns take precedence ov

PeriDefiner# P0988093 Nortel Networks Confidential Page 63Allowable RangeAllowable Range accepts a simple expression, signaling whether certain data s

PeriReporter User’s GuidePage 64 Nortel Networks Confidential # P0988093Column WidthColumn Width determines how wide the cells of the column will be.

PeriDefiner# P0988093 Nortel Networks Confidential Page 65Define SubtotalsTo define Subtotals, scroll down the report until you come to the rows in gr

PeriReporter User’s GuidePage 66 Nortel Networks Confidential # P0988093OptionsColumn MappingsThe Column Mappings window allows you to view the parame

PeriDefiner# P0988093 Nortel Networks Confidential Page 67The report definition shown in the above example has columns B, D and G set to an Allowable

PeriReporter User’s GuidePage 68 Nortel Networks Confidential # P0988093Global SettingsThe Global Settings window allows you to set the maximum number

PeriDefiner# P0988093 Nortel Networks Confidential Page 69Preview IntervalsEnter the number of rows of statistical data that will be shown when Previe

Preface

PeriReporter User’s GuidePage 70 Nortel Networks Confidential # P0988093Change ColorClick on the button next to the area of which you would like to ch

PeriDefiner# P0988093 Nortel Networks Confidential Page 71Print the Report DefinitionYou can chose to print the filled report definition to see what a

PeriReporter User’s GuidePage 72 Nortel Networks Confidential # P0988093Leading SizeLeading Size controls the vertical size of the cells in the printe

PeriDefiner# P0988093 Nortel Networks Confidential Page 73Paper SizePage Size allows you to choose the paper the report definition will be printed on.

PeriReporter User’s GuidePage 74 Nortel Networks Confidential # P0988093Print and PostscriptClicking on the Print button will print the report definit

This chapter covers:5PeriReporter1. Purpose2. PeriReporter Tool Bar3. Generating a Report

PeriReporter User’s GuidePage 76 Nortel Networks Confidential # P0988093PurposeThe PeriReporter component is a graphical utility which is used to gene

PeriReporter# P0988093 Nortel Networks Confidential Page 77PeriReporter Tool BarPeriReporter contains a tool bar at the top of its graphical display.

PeriReporter User’s GuidePage 78 Nortel Networks Confidential # P0988093Generating a ReportGenerating a report is a 3 step process.1. Open a Report De

PeriReporter# P0988093 Nortel Networks Confidential Page 79Open a Report Definition from the tool barClick:• Open buttonChoose the specified Report De

PeriReporter User’s GuidePage viii Nortel Networks Confidential # P0988093ScopeThe PeriReporter User’s Guide provides information for the use of the P

PeriReporter User’s GuidePage 80 Nortel Networks Confidential # P0988093Select a Report ScopeThe Report Scope window allows you to select a start and

PeriReporter# P0988093 Nortel Networks Confidential Page 81Start Time and End TimeIn the Start Time field, enter the time you would like the generated

PeriReporter User’s GuidePage 82 Nortel Networks Confidential # P0988093MPS/VPS RangeThe MPS/VPS Range box allows you to choose which MPSs/VPSs the re

PeriReporter# P0988093 Nortel Networks Confidential Page 83GraphsOnce a report has been generated, a graph may be made of the collected data. This is

PeriReporter User’s GuidePage 84 Nortel Networks Confidential # P0988093Graph TypeChoose the type of graph you would like to have your data displayed

PeriReporter# P0988093 Nortel Networks Confidential Page 85Bar GraphBar graphs display the data in a series of high and low points represented by soli

PeriReporter User’s GuidePage 86 Nortel Networks Confidential # P0988093Area GraphArea graphs display the data in very much the same manner as Plot Gr

PeriReporter# P0988093 Nortel Networks Confidential Page 87Candle GraphCandle graphs display the data in a series of opening, closing, high and low po

PeriReporter User’s GuidePage 88 Nortel Networks Confidential # P0988093Hilo GraphHilo graphs display the data in a similar way to Candle graphs, with

PeriReporter# P0988093 Nortel Networks Confidential Page 89Pie GraphPie graphs display the data as individual sections of a circle, or slices of a pie

Preface# P0988093 Nortel Networks Confidential Page ixOrganization of this ManualThis manual contains separate sections that describe the features and

PeriReporter User’s GuidePage 90 Nortel Networks Confidential # P0988093Scatter GraphScatter graphs display the data in a similar way to Plot graphs,

PeriReporter# P0988093 Nortel Networks Confidential Page 91Stacking GraphStacking graphs display the data in a similar way to Bar Graphs, with the exc

PeriReporter User’s GuidePage 92 Nortel Networks Confidential # P0988093Grid LinesGrid Lines allows you to choose how to show the grid lines on the sp

PeriReporter# P0988093 Nortel Networks Confidential Page 93OptionsGlobal SettingsThe Global Settings window allows you to set the maximum number of ro

PeriReporter User’s GuidePage 94 Nortel Networks Confidential # P0988093Preview IntervalsEnter the number of rows of statistical data that will be sho

PeriReporter# P0988093 Nortel Networks Confidential Page 95Change ColorClick on the button next to the area of which you would like to change the colo

PeriReporter User’s GuidePage 96 Nortel Networks Confidential # P0988093Export/ImportUsing Export will reformat the report and create a tab separated

PeriReporter# P0988093 Nortel Networks Confidential Page 97Print a Generated ReportYou can chose to print the entire generated report, only the portio

PeriReporter User’s GuidePage 98 Nortel Networks Confidential # P0988093Leading SizeLeading Size controls the vertical size of the cells in the printe

PeriReporter# P0988093 Nortel Networks Confidential Page 99Page OrientationPage Orientation allows you to choose how the generated report will be disp