Version 5 Release 3. Tuning Guide SC

(1)

Tivoli

^®

_IBM _Tivoli _NetView _for _z/OS

Tuning Guide

Version5 Release3

(2)

(3)

Tivoli

^®

_IBM _Tivoli _NetView _for _z/OS

Tuning Guide

Version5 Release3

(4)

Note

Beforeusingthisinformationandtheproductitsupports,readtheinformationin“Notices”onpage163.

Thiseditionappliestoversion5,release3ofIBMTivoliNetViewforz/OS(productnumber5697-ENV)andtoall subsequentversions,releases,andmodificationsuntilotherwiseindicatedinneweditions.Makesureyouareusing thecorrecteditionfortheleveloftheproduct.

WhenyousendinformationtoIBM,yougrantIBManonexclusiverighttouseordistributetheinformationinany wayitbelievesappropriatewithoutincurringanyobligationtoyou.

©CopyrightInternationalBusinessMachinesCorporation1997,2007.Allrightsreserved.

USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContract

(5)

Figures

1. RequiredSyntaxElements . . . xiv

2. OptionalSyntaxElements. . . xv

3. DefaultKeywordsandValues . . . xv

4. SyntaxFragments . . . xvi

5. Example:UsingaREXXCLISTtoCollect PerformanceStatistics . . . 4

6. MessageDetailReport. . . 13

7. MessageSummaryReport . . . 15

8. CNMSJM11beforeModificationtoSwitch FunctionPackageSearchOrder. . . 33

9. CNMSJM11AfterModificationwithNoUser FunctionPackageDefined. . . 34

10. CNMSJM11AfterModificationwithaUser FunctionPackageDefined. . . 35

11. SampleOutputoftheHLLENV, TYPE=IBMADPLI,LIST,STATS,RESET Command . . . 40

12. SampleOutputoftheHLLENVLISTSTATUS TYPE=IBMADC . . . 40

13. HardwareMonitorDatabaseandFilters 45 14. ExampleofOutputfromHMSTATSCommand 49 15. ExampleofKCLASSandMAPSESSStatements 66 16. ExampleofKCLASSandMAPSESSStatements usingtheKEEPSESSandDGROUPoptions. . 71

17. SessionMonitorSessionandStorage InformationPanel . . . 74

18. RODMLogRecordType8forAPIStatistics 88 19. RODMLogRecordType8forSegmentand WindowStatistics . . . 90

20. HistogramData . . . 91

21. SampleBLDVRPMacrosDefiningVSAM BufferPoolsforCNMSJM01 . . . 97

22. SampleLISTCATCommandOutputUsing 3390DASD . . . 100

23. SampleOutputfromtheVSAMPOOL CommandUsing3390DASD . . . 102

24. SampleOutputfromtheDSRBSCommand 108 25. SampleDISPPICommandOutput . . . . 115

26. SampleOutputfromtheRESOURCE Command . . . 118

27. SampleTASKMONOutput. . . 124

28. TASKUTILCommandOutput . . . 127

29. OutputfromTASKUTILCommand,2Hours Later . . . 129

(8)

(9)

About this publication

TheIBM^®Tivoli^®NetView^®forz/OS^® productprovidesadvanced capabilitiesthat youcanusetomaintainthehighest degreeofavailability ofyourcomplex,

multi-platform,multi-vendornetworksand systemsfroma singlepointofcontrol.

Thispublication,theIBMTivoliNetViewforz/OS TuningGuide,provides tuning informationand techniquesfortheNetViewproduct. Forthepurposeofthis publication,tuningisactivitythathelpstheNetView programand itsnetwork environment achieveacertainperformance goalinareassuchasresponsetime, resourceutilization,andthroughput.Althoughthispublicationdoesnotprovidea precise methodoftuningtheNetViewproduct, ithighlightstheareasthathavethe mosteffectonNetView performanceand explainswhatactionsyoucantakein those areastoimproveperformance.

Intended audience

Thispublicationisforsystemprogrammers andotherswhosejobsinvolve improving theperformance oftheNetViewprogram. Readersshouldhavea thoroughunderstandingoftheNetViewprogram. Theymust alsohavesome problemdiagnosisexperienceand anideaofwhatcancausea performancegoalto be missed.

Publications

Thissectionlists publicationsintheIBMTivoliNetView forz/OSlibraryand relateddocuments.Italso describeshowtoaccessTivolipublicationsonlineand how toorderTivolipublications.

IBM Tivoli NetView for z/OS library

Thefollowingdocuments areavailableintheTivoliNetView forz/OSlibrary:

v AdministrationReference,SC31-8854,describestheNetViewprogramdefinition statementsrequiredforsystem administration.

v ApplicationProgrammer’sGuide,SC31-8855,describestheNetView

program-to-programinterface(PPI)and howtousetheNetView application programminginterfaces(APIs).

v AutomatedOperationsNetwork CustomizationGuide,SC31-8871,describeshow to tailorandextendtheautomatedoperationscapabilitiesoftheNetView

AutomatedOperationsNetwork(AON)component, whichprovides event-drivennetworkautomation.

v AutomatedOperationsNetwork User’sGuide,GC31-8851,describeshowtousethe AutomatedOperationsNetworkcomponenttoimprovesystemand network efficiency.

v

AutomationGuide,SC31-8853,describes howtouseautomated operationsto improvesystemandnetworkefficiencyandoperatorproductivity.

v CommandReferenceVolume 1,SC31-8857,andCommand ReferenceVolume2,

SC31-8858,describetheNetView commands,whichcanbe usedfornetworkand systemoperationandincommandlistsandcommandprocedures.

v CustomizationGuide,SC31-8859,describeshow tocustomizetheNetViewproduct andpointstosources ofrelatedinformation.

(10)

v DataModelReference,SC31-8864,providesinformationabouttheGraphic MonitorFacilityhostsubsystem(GMFHS),SNAtopologymanager,and MultiSystemManagerdatamodels.

v Installation:ConfiguringAdditionalComponents,SC31-8874,describes howto configureNetViewfunctionsbeyondthebase functions.

v Installation:ConfiguringGraphicalComponents,SC31-8875,describeshow toinstall andconfiguretheNetViewgraphicscomponents.

v Installation:GettingStarted,SC31-8872,describeshowtoinstall andconfigurethe NetViewbasefunctions.

v Installation:Migration Guide,SC31-8873,describesthenewfunctionsprovidedby thecurrentrelease oftheNetViewproductandthemigrationofthebase functionsfroma previousrelease.

v Installation:ConfiguringtheTivoliNetViewforz/OSEnterpriseAgents,SC31-6969, describeshowtoinstall andconfiguretheTivoliNetViewforz/OS enterprise agents.

v MessagesandCodesVolume1 (AAU-DSI),SC31-6965,andMessages andCodes Volume2(DUI-IHS),SC31-6966,describethemessages fortheNetView product, theNetView abendcodes,thesensecodes thatareshowninNetView messages, andgenericalertcodepoints.

v

MultiSystemManagerUser’sGuide,GC31-8850,describes howtheNetView MultiSystemManagercomponentcanbeusedinmanagingnetworks.

v NetViewManagementConsole User’sGuide,GC31-8852,providesinformation abouttheNetView managementconsoleinterfaceoftheNetViewproduct.

v Programming:Assembler,SC31-8860,describes howtowriteexitroutines, commandprocessors, andsubtasksfortheNetViewproductusingassembler language.

v Programming:Pipes,SC31-8863,describes howtousetheNetView pipelinesto customizeaNetView installation.

v Programming:PL/IandC,SC31-8861,describeshow towritecommandprocessors andinstallationexitroutinesfor theNetView productusingPL/IorC.

v

Programming:REXXandtheNetViewCommand ListLanguage,SC31-8862,describes howtowritecommandlists fortheNetView productusingtheRestructured ExtendedExecutorlanguage(REXX^™)ortheNetViewcommandlistlanguage.

v ResourceObjectDataManagerand GMFHSProgrammer’sGuide,SC31-8865, describestheNetViewResourceObject DataManager(RODM),includinghow todefineyour non-SNAnetworktoRODMand useRODMfornetwork automationandforapplication programming.

v SecurityReference,SC31-8870,describeshow toimplementauthorizationchecking fortheNetView environment.

v SNATopologyManagerImplementationGuide,SC31-8868,describesplanningfor andimplementingtheNetView SNAtopologymanager,whichcanbeusedto managesubarea,AdvancedPeer-to-PeerNetworking^®,andTN3270resources.

v TroubleshootingGuide,LY43-0093, providesinformationaboutdocumenting, diagnosing,and solvingproblemsthatmight occurinusingtheNetView product.

v TuningGuide,SC31-8869,providestuninginformationtohelp achievecertain performancegoalsfortheNetView productand thenetworkenvironment.

v User’sGuide,GC31-8849,describeshowtousetheNetViewproducttomanage complex,multivendornetworksandsystemsfromasingle point.

(11)

v WebApplicationUser’sGuide,SC32-9381,describeshowtousetheNetViewWeb applicationtomanagecomplex,multivendor networksandsystemsfroma singlepoint.

v LicensedProgramSpecifications,GC31-8848,providesthelicenseinformationfor theNetView product.

Prerequisite publications

Toread aboutthenew functionsofferedinthisrelease,seetheIBM TivoliNetView forz/OS Installation:MigrationGuide.

For informationabouthowtheNetViewforz/OSproductinteractswith theIBM TivoliMonitoringproduct,seethefollowingIBMTivoliMonitoringpublications:

v IntroducingIBMTivoliMonitoring,GI11-4071,introducesthecomponents, concepts,andfunction ofIBMTivoliMonitoring.

v IBMTivoliMonitoring:UpgradingfromTivoliDistributedMonitoring,GC32-9462, providesinformationonhowtoupgradefromIBMTivoliDistributed

Monitoring.

v IBMTivoliMonitoring:InstallationandSetupGuide,GC32-9407,provides informationaboutinstallingand settingupIBM TivoliMonitoring.

v

IBMTivoliMonitoringUser’sGuide,SC32-9409,whichcomplementstheIBM TivoliEnterprise^™Portalonlinehelp,provideshands-on lessonsanddetailed instructionsforallTivoliEnterprisePortalfunctions.

v IBMTivoliMonitoringAdministrator’sGuide,SC32-9408,describesthesupport tasksandfunctionsrequiredfortheIBM TivoliEnterprisePortalServer and clients.

v ConfiguringIBM TivoliEnterpriseMonitoringServer onz/OS,SC32-9463,describes howtoconfigureandcustomize theIBM TivoliEnterpriseMonitoringServer runningona z/OSsystem.

v IBMTivoliMonitoringProblemDeterminationGuide,GC32-9458,provides

informationandmessagestouseintroubleshootingproblemswith thesoftware.

v ExploringIBM TivoliMonitoring,SC32-1803,providesa seriesofexercisesfor exploringIBM TivoliMonitoring.

v IBMTivoliUniversalAgentUser’sGuide,SC32-9459,introducestheIBMTivoli UniversalAgent.

v IBMTivoliUniversalAgentAPIandCommand ProgrammingReference Guide, SC32-9461,explainshowtoimplementtheIBMTivoliUniversalAgentAPIsand describestheAPIcallsandcommand-line interfacecommands.

Related publications

For informationabouttheNetView Bridgefunction,seeTivoliNetViewforOS/390 BridgeImplementation,SC31-8238-03(availableonlyintheV1R4library).

YoucanfindadditionalproductinformationontheNetView forz/OSWebsite:

http://www.ibm.com/software/tivoli/products/netview-zos/

Accessing terminology online

TheTivoliSoftwareGlossary includesdefinitionsformanyofthetechnicalterms relatedtoTivolisoftware.TheTivoliSoftwareGlossaryisavailableat thefollowing Tivolisoftware libraryWebsite:

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

(12)

The IBMTerminologyWebsiteconsolidatestheterminologyfromIBMproduct libraries inoneconvenientlocation.YoucanaccesstheTerminologyWebsiteatthe followingWebaddress:

http://www.ibm.com/software/globalization/terminology/

For alistofNetView forz/OStermsanddefinitions,refertotheIBM Terminology Website. Thefollowingtermsare usedinthis library:

NetView

For thefollowingproducts:

v TivoliNetViewforz/OSversion5 release3 v TivoliNetViewforz/OSversion5 release2 v TivoliNetViewforz/OSversion5 release1 v TivoliNetViewforOS/390^®version 1release4 MVS^™ For z/OSoperatingsystems

MVSelement

For theBCPelementofthez/OSoperatingsystem CNMCMD

For CNMCMDand itsincludedmembers CNMSTYLE

For CNMSTYLEand itsincludedmembers PARMLIB

For SYS1.PARMLIBand otherdatasetsintheconcatenationsequence The followingIBM namesreplacethespecifiedCandle^® names:

IBMTivoliMonitoringServices For OMEGAMON^®platform IBMTivoliEnterpriseMonitoringAgent

For IntelligentRemoteAgent IBMTivoliEnterpriseMonitoringServer

For CandleManagementServer IBMTivoliEnterprisePortal

For CandleNetPortal IBMTivoliEnterprisePortalServer

For CandleNetPortalServer

Unlessotherwiseindicated,referencestoprograms indicatethelatestversionand release oftheprograms.Ifonlya versionisindicated,thereferenceistoall releaseswithin thatversion.

Whenareference ismadeaboutusingapersonal computerorworkstation,any programmable workstationcanbe used.

Using LookAt to look up message explanations

LookAt isan onlinefacilitythatyoucanusetolookupexplanations formostof theIBM messagesyouencounter,aswell asforsomesystem abends(anabnormal endof atask)andcodes. UsingLookAttofind informationisfasterthana

conventionalsearchbecauseinmostcasesLookAtgoesdirectlytothemessage explanation.

(13)

YoucanuseLookAtfromthefollowinglocationstofindIBMmessage

explanations forz/OSelementsandfeatures, z/VM^®,VSE/ESA^™,andClustersfor AIX^®and Linux^®:

v TheInternet.YoucanaccessIBMmessageexplanations directlyfromtheLookAt Websiteat http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/.

v Yourz/OSTSO/Ehost system.Youcaninstallcode onyour z/OSorz/OS.e systemstoaccessIBMmessageexplanations,usingLookAtfroma TSO/E commandline(forexample,TSO/Eprompt,ISPF,orz/OSUNIX^®System ServicesrunningOMVS).

v YourMicrosoft^®Windows^® workstation.Youcaninstall codetoaccessIBM messageexplanationsonthez/OSCollection(SK3T-4269),usingLookAtfroma MicrosoftWindowsDOScommandline.

v Yourwirelesshandheld device.YoucanusetheLookAtMobile Editionwith a handhelddevicethathaswirelessaccessandanInternet browser(forexample, InternetExplorerforPocketPCs,Blazer,orEudoraforPalmOS, orOperafor Linuxhandhelddevices).Linkto theLookAt MobileEditionfromtheLookAt Website.

Youcanobtaincodetoinstall LookAtonyourhostsystemor MicrosoftWindows workstationfroma diskonyourz/OSCollection(SK3T-4269),orfromtheLookAt Website(clickDownload,andselecttheplatform,release,collection,andlocation thatsuityourneeds). Moreinformationisavailable intheLOOKAT.MEfiles available duringthedownloadprocess.

Accessing publications online

ThedocumentationCDcontainsthepublicationsthatareintheproductlibrary.

Thepublicationsareavailable inPortableDocumentFormat(PDF),HTML,and BookManager^® formats.Refer tothereadmefileontheCDforinstructionsonhow toaccessthedocumentation.

An indexisprovidedonthedocumentationCDforsearchingtheTivoliNetView forz/OS library.IfyouhaveAdobeAcrobatonyoursystem,youcanusethe Searchcommandto locatespecific textinthelibrary.Formoreinformationabout usingtheindextosearchthelibrary,seetheonlinehelp forAcrobat.

IBM postspublicationsforthisand allotherTivoliproducts,astheybecome available andwhenevertheyareupdated,totheTivoliInformationCenter Web siteat http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp.

IntheTivoliInformationCenterwindow,clickTivoliproductmanuals.Clickthe letter thatmatchesthefirstletter ofyourproductnametoaccessyourproduct library.Forexample,click NtoaccesstheTivoli NetViewforz/OSlibrary.

Note: IfyouprintPDFdocumentsonotherthanletter-sizedpaper,settheoption intheFile→ PrintwindowthatenablesAdobe Readertoprintletter-sized pagesonyourlocalpaper.

Ordering publications

YoucanordermanyTivolipublicationsonline atthefollowingWebaddress:

http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss Youcanalsoorderbytelephonebycallingoneofthese numbers:

v IntheUnitedStates:800-879-2755

(14)

v InCanada:800-426-4968

Inothercountries,contactyour softwareaccountrepresentative toorderTivoli publications. Tolocatethetelephonenumber ofyourlocalrepresentative,perform thefollowingsteps:

1. GotothefollowingWebaddress:

http://www.elink.ibmlink.ibm.com/public/applications/publications/

cgibin/pbi.cgi

2. Selectyour countryfromthelistandclick Go.TheWelcometotheIBM PublicationsCenterwindow isdisplayed.

3. On theleft sideofthewindow,click Aboutthissitetoseean informationpage thatincludesthetelephonenumberofyour localrepresentative.

Accessibility

Accessibilityfeatureshelpuserswitha physicaldisability,suchasrestricted mobilityorlimited vision,tousesoftwareproductssuccessfully.Standard shortcut and acceleratorkeysareusedbytheproductandaredocumentedbytheoperating system.Refer tothedocumentationprovidedbyyouroperatingsystemformore information.

For additionalinformation,seetheAccessibilityappendixintheUser’s Guide.

Tivoli technical training

For Tivolitechnicaltraininginformation,refertothefollowingIBMTivoli EducationWebsiteathttp://www.ibm.com/software/tivoli/education.

Support information

Ifyouhaveaproblemwithyour IBMsoftware,youwanttoresolveit quickly.IBM provides thefollowingwaysforyoutoobtainthesupportyouneed:

Online

GototheIBMSoftwareSupportsiteat http://www.ibm.com/software/

support/probsub.htmland followtheinstructions.

IBMSupportAssistant

TheIBM SupportAssistant(ISA)isa freelocalsoftwareserviceability workbench thathelpsresolve questionsandproblemswith IBMsoftware products.TheISAprovidesquickaccesstosupport-relatedinformation and serviceabilitytoolsforproblemdetermination.Toinstall theISA software,go tohttp://www.ibm.com/software/support/isa.

Problem determinationguide

For moreinformationaboutresolvingproblems,seetheIBMTivoliNetView forz/OS Troubleshooting Guide.

Downloads

Clients andagents,demonstrationsoftheNetView product,andseveralfree NetView applicationsthatyoucandownloadareavailableat theNetView for z/OS Website:

http://www.ibm.com/software/tivoli/products/netview-zos/

(15)

Theseapplicationscanhelpwiththefollowingtasks:

v Migratingcustomizationparametersfromearlier releasestothecurrentstyle sheet

v Gettingstatisticsforyourautomation tableandmergingthestatisticswith a listingoftheautomationtable

v Displayingthestatusofa jobentrysubsystem(JES)joborcanceling aspecified JESjob

v

SendingalertstotheNetViewprogramusingtheprogram-to-programinterface (PPI)

v SendingandreceivingMVScommandsusingthePPI

v SendingTimeSharingOption(TSO)commandsandreceivingresponses

Conventions used in this publication

Thispublicationusesseveralconventionsforspecial termsand actions,operating system-dependent commandsandpaths,andcommandsyntax.

Typeface conventions

Thispublicationusesthefollowingtypefaceconventions:

Bold

v Lowercase commandsandmixedcasecommandsthatareotherwise difficult todistinguishfromsurroundingtext

v Interfacecontrols(check boxes,pushbuttons,radiobuttons,spin buttons, fields,folders,icons,listboxes, itemsinsidelistboxes,

multicolumnlists,containers, menuchoices,menu names,tabs,property sheets), labels(suchasTip:,andOperatingsystem considerations:) v Keywords andparametersintext

Italic

v Citations(examples:titlesof publications,diskettes,and CDs v

Wordsdefinedintext(example:anonswitchedlineiscalleda point-to-pointline)

v Emphasisofwordsandletters(wordsaswordsexample:"Usetheword that tointroducea restrictiveclause.";lettersaslettersexample:"The LUN addressmuststart withtheletterL.")

v New termsintext(exceptina definitionlist):a viewisaframeina workspacethatcontainsdata.

v Variablesand valuesyoumustprovide:...wheremynamerepresents...

Monospace

v Examples andcodeexamples v

File names,programming keywords,andotherelementsthataredifficult to distinguishfromsurroundingtext

v Messagetextandprompts addressedtotheuser v Textthattheusermust type

v Valuesforargumentsorcommandoptions

Operating system-dependent variables and paths

For workstationcomponents,this publicationusestheUNIXconventionfor specifying environmentvariablesandfordirectorynotation.

(16)

WhenusingtheWindows commandline, replace$variablewith %variable%for environment variablesand replaceeachforwardslash(/)witha backslash(\)in directory paths.Thenamesofenvironmentvariablesarenotalwaysthesamein theWindows andUNIXenvironments.For example,%TEMP%inWindows environmentsisequivalentto$TMPDIRinUNIXenvironments.

Note: Ifyouare usingthebashshellonaWindows system,youcanusetheUNIX conventions.

Syntax Diagrams

Syntaxdiagrams startwith doublearrowheadsontheleft()andcontinuealong themainsyntaxlineuntiltheyendwith twoarrowheadsfacingeachother().

Whenmorethanonelineisneededforasyntax diagram,thecontinuedlinesend with asingle arrowhead().

Position and Appearance of Syntax Elements

Syntaxdiagrams donotrelyonhighlighting,brackets,orbraces.Insyntax

diagrams,thepositionoftheelementsrelativetothemainsyntax lineindicatesthe required, optional,anddefaultvaluesforkeywords,variables,andoperandsas shown inthefollowingtable.

Table1.PositionofSyntaxElements

ElementPosition Meaning

Onthemainsyntaxline Required

Abovethemainsyntaxline Default Belowthemainsyntaxline Optional

Keywords andoperandsareshown inuppercaseletters.Variablesare shownin lowercase lettersandareeitheritalicized or,forNetView helpandBookManager online publications,shown inadifferentiatingcolor.Theappearanceofsyntax elementsindicates thetype ofelementasshown inthefollowingtable.

Table2.AppearanceofSyntaxElements

Element Appearance

Keyword CCPLOADF

Variable resname

Operand MEMBER=membername

Default todayorINCL

Required Syntax Elements

The commandnameandtherequiredkeywords, variables,andoperandsare shown onthemainsyntax line.Figure1showsthattheresnamevariable mustbe usedfortheCCPLOADFcommand.

CCPLOADF

CCPLOADF resname

Figure1.RequiredSyntaxElements

(17)

Optional Syntax Elements

Optionalkeywords,variables,andoperandsare shownbelowthemainsyntaxline.

Figure2shows thattheIDoperandcanbe usedfortheDISPREGcommandbutis notrequired.

Default Keywords and Values

Default keywordsand valuesareshownabovethemainsyntax line.

Ifthedefaultisakeyword,it isshown onlyabovethemainline.Youcanspecify this keywordorallowittodefault.Figure3 showsthedefaultkeywordSTEP abovethemainlineandtherestoftheoptionalkeywordsbelowthemainline.

Ifan operandhasadefaultvalue,theoperandisshown bothaboveand belowthe mainline.Avaluebelow themainlineindicatesthatifyouspecifytheoperand, youmustalso specifyeitherthedefaultvalue oranothervalue shown.Ifyoudo notspecifytheoperand,thedefaultvalueabovethemainlineisused.Figure3 showsthedefaultvaluesforoperandsMODNAME=*and OPTION=*aboveandbelow themainline.

Syntax Fragments

Commandsthatcontainlengthy sectionsofsyntax orasection thatisusedmore thanonceinacommandareshown asseparate fragmentsfollowingthemain diagram.Thefragmentnameisshowninmixedcase.Figure4onpagexvishows a syntaxdiagramwith thefragmentsPu,PurgeAll,andPurgeBefore.

DISPREG

DISPREG

ID=resname

Figure2.OptionalSyntaxElements

RID

RID TASK=opid

,STEP

,CONTINUE ,END ,RUN

,MODNAME=*

,MODNAME= * name

,OPTION=*

,OPTION= * HAPIENTR HAPIEXIT

Figure3.DefaultKeywordsandValues

(18)

Commas and Parentheses

Requiredcommasand parenthesesare showninthesyntaxdiagram.

Whenanoperandcanhavemore thanonevalue, thevaluesaretypicallyenclosed in parenthesesandseparatedbycommas.For example,inFigure4,theOP

operandcontainscommastoindicatethatyoucanspecifymultiple valuesforthe testopvariable.

Ifa commandrequirespositionalcommastoseparate keywordsandvariables,the commas areshownbefore thekeyword orvariable,asinFigure3 onpagexv.

Commasare alsousedtoindicatetheabsenceofa positionaloperand. Inthe followingexampleof theBOSESScommand,thesecondcommaindicatesthatan optional operandisnotbeingused:

NCCF BOSESS applid,,sessid

Youdo notneedto specifythetrailingpositionalcommas.Trailingpositionaland non-positional commaseitherareignoredorcauseacommandtoberejected.

Restrictionsforeachcommandstatewhethertrailingcommascausethecommand tobe rejected.

Abbreviations

Commandandkeyword abbreviationsarelisted insynonymtablesaftereach commanddescription.

CSCF

CSCF Pu

PurgeAll PurgeBefore

Pu

PU=resname

,

,OP=( testop )

PurgeAll

PURGE ALL

PurgeBefore

PURGE BEFORE date

time

Figure4.SyntaxFragments

(19)

Chapter 1. Improving NetView Performance

Thischapteraddressesmanytuning-relatedquestionsasked byusersofthe NetView program.Thischapteralsoprovidesbasictuningconsiderations to improvegeneral NetViewperformance.Reviewthesetopicsand considerationsfor relevancytoyour environment.

Achieving Performance Goals

TuningisanyactivitythathelpstheNetView programand itsnetwork

environment achieveacertainperformance goalinareassuchasresponsetime, resourceutilization,andthroughput.Thisgoalorexpectation canbe asformalasa servicelevelagreementorasinformalasaperson’sperception.Regardlessofthe formalityoftheperformancegoal,tuningisanyactivityperformedtomeetthat goal.

Thetaskof tuningisdifficult todefine.Peoplehavemanydifferentperceptions and approachestotuning.Unliketheinstallation task,noset sequenceofsteps leads toatunedsystem.Thisbookdescribestheareasthataffecttheperformance of theNetView programandshowsmethodsfor controllingandoptimizingthat performance. Itexplains howthefollowingfactorsaffectNetViewprogramtuning:

v Filteruse

v Automationactivity v Networksize

v VSAMdatasetdesign,placement, andmanagement v Commandlistuse,design,anddataset placement v Viewsize

v WorkstationCPU andRAM v Linkspeed

An importantpart oftuningissettingtheperformancegoal.However, thatgoal variesfrominstallationtoinstallation.Someinstallations havemoremessagetraffic ornetworkactivitythanothers.Manyfactorsuniquely definetheperformance goal foreachinstallation;therefore,thesefactors arenotdiscussedinthisbook.

Thisbookexplainshowtodeterminecertaintuningvaluesandsuggestsvalues youshoulduse.Eachenvironmentneedstobetunedaccordingtothefollowing factors:

v Automationlevels v Logonandlogoffrates v Monitoringactivities v

Networkcomponentfailurerates v

Networktransactionrates v

Problemdetermination activities v

Systemtransactionrates

v Resourcestatuschangeactivities

All recommendationsarebasedonexperiences andmeasurementsdone inanIBM controlled environment.Theuseofthese recommendationsisa customer

responsibility anddependsonthecustomers’abilitytoevaluateand integrate themintotheiroperationalenvironments.

(20)

Using General Techniques

IfyouarejustgettingstartedintuningtheNetView program,usethefollowing general tuningtechniquestoimproveoverallNetViewperformance.Youcan handlethemostfrequentlyencounteredperformance andtuningconsiderationsby usingthesetechniques.

1. UsetheRATEstatementtostoprapidlyrecurringhardwaremonitoralerts from beingrecordedtothehardwaremonitor database.See“NPDA.RATEStatement InitializationSpecifications”onpage54formoreinformation.

2. Decidewhichdataiscriticaltokeepforthesessionmonitor,and setthe followingsessionmonitor optionsandparametersaccordingly:

v Sense codevaluesinDSICTMODforDASDfiltering v KCLASSDASDoption

v KCLASSAVAILoption v KCLASSSAW option v KCLASSKEEPPIUoption v KCLASSKEEPSESSoption

SeeChapter6,“Tuningfor theSessionMonitor,”onpage57formore information.

3. UsetheDBAUTOcommandtoreorganizeor resettheVSAM databases regularly.See“VSAMDatabaseMaintenance”onpage103 formore information.

4. Usethefollowingutilitiestomonitorperformance:

AUTOCNT

Generatesautomation tableusagereports.See“TheAUTOCNT Command”onpage12.

DSRBS

Displaysstatisticsondataservices requestblock(DSRB)usefor NetView anduser-writtendataservices tasks(DSTs).See “Usingthe NPDA.DSRBOStatement”onpage52.

DISPPI

DisplaysinformationaboutNetViewprogram-to-programinterface bufferqueues,includingbufferqueuelengths, totalbuffers sent,and bufferstorageusage.See “NetViewProgram-to-ProgramInterface” on page114.

HLLENV

Displaysinformationaboutusageoftheregularandcritical

preinitializedenvironment poolsbyPL/I commandprocessors. See

“RunningHigh-level LanguageProgramsina Preinitialized Environment”onpage38.

HMSTATS

Displayshardwaremonitoreventand alertworkloadcounters,and statisticsaboutthealertcacheandalertsdynamic(ALD)screenupdate processing.See “HMSTATSCommand”onpage48.

LISTCAT

DisplaysVSAMdatabase definitionand performancedataforNetView DSTsthathaveopenVSAM databases.See“LISTCATCommand”on page99.

LOGTSTAT

Logsrecordtype 38subtype2toSMF atlogoff/logon/termination.

(21)

MAPCL

ProvidesinformationaboutpreloadedCLISTs.See“Preloading CommandLists”onpage28.

NACTLLISTINFO

DisplaystheaverageandmaximumtimeittakesfortheNetViewfor z/OSEnterpriseManagementAgentdatacollectorstocollectdata duringa givendatacollectioninterval.Thedisplayincludesstatistics forthefollowingagentsubtowers:

v

HEALTH v

CONNACT v CONINACT v SESSACT v DVDEF v DVTAD v DVCONN QRYGLOBL

DisplaysinformationaboutNetViewglobalvariables,includingthe expectednumberofcommonor taskglobalvariablesand theactual numberofvariablesfound.See“GlobalVariables”onpage40.

RESOURCE

ProvidesCPU andstoragestatisticsfortheNetView addressspace. See

“RESOURCECommand”onpage118.

SESSMDIS

Displayssessionmonitor sessioncounts,storageuse,andworkload trafficinformation.See“SESSMDISCommand”onpage73.

STATAPI

GeneratesRODMAPIstatisticstoanalyzethecontentand activityof RODM.See“RODMAPIStatistics”onpage87.

STATCELL

Collectsinformationconcerning thedistributionofstoragecellsin windowsandsegments.See“RODMCell PoolStatistics”onpage89.

TASKMON

ShowsCPU,storage,I/O,and messagequeuerate statisticsforalltasks intheNetViewprogram.

TASKURPT

ANetViewsamplethatdemonstrateshow reportscanbe generated fromthetaskresourcesdataintheSMFlogusingREXX.

TASKUTIL

Displaystaskperformanceinformation,includingCPU utilization, queuelengths,storageuse, andactivecommandlists.See “TASKUTIL Command”onpage125.

TOPOSNALISTPOOL

DisplaysSNATopologymanagerstorage poolstatistics.

TOPOSNALISTRODM

DisplaysRODMactivity andobjectcounts.See“SNATopology Manager”onpage121.

TOPOSNALISTSTOR

DisplaysstorageusagecountsforSNAtopology manager.See“SNA TopologyManager”onpage121.

|

(22)

VSAMPOOL

DisplaysVSAMlocalshared resource(LSR)poolusestatistics.See

“VSAMPOOLCommand”onpage101.

Youcanaddtheseutilitiestoacommandlistthatcanberunperiodically tocollect performance statistics.SeetheexampleinFigure5.

Recording performancestatisticsto theNetView loginthismannercanprovide usefulhistorical informationfor trendanalysisand canbeinvaluablein

performance problemanalysis.

/* REXX clist to collect performance statistics. Can be invoked by an*/

/* EVERY timer to run under an autotask - for example, */

/* EXCMD AUTO2,EVERY 00:15,V5R3PERF */

/* Substitute your RODMNAME for X below! If you’re not using RODM, */

/* delete the lines referring to X below. */

/* */

’MVS F X,STATAPI,CLEAR’

’AUTOCNT REPORT=BOTH,STATS=SUMMARY’

’DISPPI’

’DSRBS AAUTSKLP’

’DSRBS BNJDSERV’

’DSRBS DSIGDS’

’HMSTATS’

’LISTCAT AAUTSKLP’

’LISTCAT BNJDSERV’

’LISTCAT DSILOG’

’MAPCL’

’MVS F X,STATCELL’

’NACTL LISTINFO’

’RESOURCE’

’SESSMDIS’

’TASKMON * *’

/* ’TASKURPT (NOWINDOW’ */

’TASKUTIL’

’TOPOSNA LISTPOOL’

’TOPOSNA LISTRODM’

’TOPOSNA LISTSTOR’

’VSAMPOOL’

say ’End of V5R3PERF CLIST’

exit

Figure5.Example:UsingaREXXCLISTtoCollectPerformanceStatistics

|

(23)

Chapter 2. Tuning for Automated Operations

TheNetView programprovidesfunctionsthatyoucanusetoautomateoperations.

Manymessagesare senttotheNetViewprogramforautomationafter being processedbytheMVSmessageprocessingfacility(MPF).

For adetaileddescriptionofNetViewautomation,refertotheIBMTivoliNetView forz/OS AutomationGuide.

Tuning Techniques

Following arethemajortuningtechniquesforautomated operations,arrangedin orderof expectedeffectonperformance,withthemostimportanttuning

considerations listedfirst.Thesearedescribedindetail inthischapter.

1. Limitthenumberof systemmessagesprocessedbytheNetView program.On MVSsystems, includea.NO_ENTRY statementspecifyingAUTO(NO)inthe MPFLSTxxmemberofSYS1.PARMLIB. See“LimitingSystemMessages”on page6.

2. Segment theautomationtableusingBEGIN/ENDsectionstominimizethe averagenumber ofautomationtablestatementsevaluated foreachmessageor MSU. See“UsingBEGIN/ENDtoImproveEfficiency”onpage10.

3. OrderBEGIN/ENDsectionsandstatementswithin sectionsinorderof frequencyto minimizetheaveragenumberof statementsevaluatedforeach messageor MSU.See“UsingBEGIN/ENDtoImproveEfficiency”onpage10.

4. Use theAUTOCNTcommandtogenerateusage reportsfortheNetView automation table.See“TheAUTOCNTCommand”onpage12.

5. Eliminatesimple commandprocedureswhentheconditionprocessingcanbe performeddirectlyintheautomation table.See“UsingOtherTechniquesto ImproveEfficiency”onpage11.

6. BlockthehardwaremonitorESREC,AREC,andOPERfilterswherepossible foralerts thataretobeautomated.See “FilteringHardwareMonitorRecords”

onpage16.

7. MinimizetheuseoftheCONTINUE automationtableactionif itcausesthe entiretable tobescanned.See“UsingOtherTechniques toImprove

Efficiency”onpage11.

8. Use theMSUSEGautomation tableconditionifyouplantoautomate alerts.

ThisautomatestheMSUdirectly,ratherthangeneratingtheBNJ146Iand BNJ030Imessages usingthehardwaremonitor OPERfilter. See“Automating HardwareMonitorRecords”onpage16.

9. Use multipleautotasksforMVSenvironmentstodistribute theautomation workloadacrossmultipleprocessors. See“AutomationTasks(Autotasks)”on page17.

10. Use theRMTCMDcommand,wherepossible,toforwardcommandsand messages betweenadistributed systemanda focalpoint.Thealternative method usesOST-NNTsessions.See“Commandand MessageForwarding”

onpage19.

(24)

Limiting System Messages

TouseNetViewautomation supportwiththeNetView program,thefirstand most importantstepistolimitthenumberofsystem messagestheNetViewprogram processes.TheNetView automationtableissearchedformostmessagesthatpass through theNetViewprogram. Therefore,itisimportanttolimitthesystem message trafficsent totheNetView programtoonlythosemessages thatshouldbe consideredforautomationorthose thatareneededfordisplaypurposes.

Whenyouautomatetheoperationof distributedhostswith afocalpointhost, handleasmuchof thetrafficaspossibleatthedistributed hosttominimizethe overheadof forwardingmessagestothefocalpointhostforautomation.

YoucanusetheNetView RevisionTablefunction tomakefinely-tuneddecisions aboutthefollowing:

v Whichmessagesare passedtoNetView forautomation

v Whichmessagesare eligibleforfurtherz/OSprocessing,includingtheoverhead ofroutingtootherpartsofthesysplex.

OftheactionsavailableintheRevisionTable,thefollowingthreeare ofparticular interest forlimitingperformance costofsystemmessages:

AUTOMATE

Setthis toOFFformessagesnotneededbyyour automationtablesin NetView.

DELETE

Setthis toONformessagesthatarenotneededanywhere.

NETVONLY

Setthis toONformessagesthatshouldonlybe automatedand notseen, logged, orrouted,oruntil automationspecifiesotherwise.

Other Revisionactionscanalsohaveperformancebenefits.Forexample,youmight wanttolimittheroutingcodesset insomemessages.SeetheIBMTivoliNetView forz/OS AutomationGuideand alsosampleCNMSMRT1.

IfyouarenotusingtheRevisionTable,usetheMPFLSTxxmemberof SYS1.PARMLIBtoidentifywhethera messageiseligible forautomation processing. Eligiblemessages arepassedtotheNetView programoverthe subsysteminterface orthroughextendedmultiple consolesupport(EMCS) consoles(see“NetViewSubsystemAddressSpace”onpage8).

WhenpassingmessagestotheNetViewprogram, notethefollowingabout MPFLSTxx:

v SpecifyAUTO(YES)orAUTO(NO)toidentifywhetheramessageiseligiblefor automationprocessing.

v

Specifythedefaultvaluesforgroupsofmessages listedintheMPFLSTxx memberwiththe.DEFAULTstatement.The.DEFAULTstatementusesAUTO(NO) unlessyouspecifyAUTO(YES).

v Specifythedefaultprocessingyouwantfor messagesthatarenotidentifiedin theMPFLSTxxmemberwiththe.NO_ENTRYstatement.

Note: Ensurethatyour MPFLSTxxmemberhasa.NO_ENTRYstatementwith AUTO(NO)specified.Thishelpslimitthenumberof messagessenttothe NetView programtoonlythoseneededforautomationordisplay

purposes.

(25)

The.NO_ENTRYstatementusesAUTO(YES)unlessyouspecifyAUTO(NO).Ifyou donothavea .NO_ENTRYstatementinMPFLSTxx,thesystemusesa defaultof AUTO(YES).

For moreinformationaboutMPF,referto theappropriateMVSpublication.

Using MVS Consoles

TheNetView programusesMVSconsolesforreceivingsystemmessages and commandresponsesfromMVS.TheNetView programcanuseoneofthe followingtypesofMVSconsoles:

v Subsystemallocatableconsoles v EMCSconsoles

Definethetypeof MVSconsoleusedbytheNetViewprogrambyspecifyingthe system messagedeliverymechanismontheMVSPARMstatementinCNMSTYLE

%INCLUDE memberCNMSTUSRorCxxSTGEN.RefertotheIBMTivoliNetView forz/OS AdministrationReferenceformoreinformation.

Using Subsystem Allocatable Consoles

Subsystem allocatableconsolesare virtualconsolesreservedforusebysubsystems suchasJES2,JES3,and theNetView program.Theseconsolesaredefinedinthe CONSOLxxmemberofSYS1.PARMLIB.They donotexistphysicallybutare able tointeractwith subsystemsasiftheywere actualconsoles.

For informationaboutdefiningsubsystemallocatableconsoles,seethez/OS library.Tousethesubsysteminterface methodofmessagerouting,specify MVSPARM.MSGIFAC=USESSI, MVSPARM.MSGIFAC=QUESSI,or

MVSPARM.MSGIFAC=QSSIAT inCNMSTYLE%INCLUDEmemberCNMSTUSR orCxxSTGEN.

Note: Beginningwithz/OSV1R8,theQUESSI,QSSIAT,and USESSIvaluesarenot supported.

Using EMCS Console Support

TheNetView programprovidesanoptiontouseEMCSconsoles.EMCSconsoles usetheCNMCSSIRtasktoreceiveallmessagesmarkedAUTO(YES)or

AUTO(token) intheMPFtable,orwhicharesubjecttoNETVONLYorREVISE(″1″

AUTOMATE)revision tableactionsorsimilar.

Youcanassignattributestotheconsolesand changetheattributesofyourEMCS consolestoensurethatmessages withcertainroutecodes aredeliveredto the consolesyouspecify.SeetheIBMTivoliNetViewforz/OS SecurityReferencefora descriptionoftheEMCSconsoleattributes.

TouseEMCSconsoles,specifyMVSPARM.MSGIFAC=SYSTEM,

MVSPARM.MSGIFAC=SSIEXT,orMVSPARM.MSGIFAC=CMDONLYin

CNMSTYLE%INCLUDEmemberCNMSTUSRorCxxSTGEN,andthesubsystem interface procedureparameters.

Notes:

1. TheCNMCSSIRtaskmustbe theonlytaskthatobtainsanAUTO(YES)console sothatallDOMtrafficcanbeprocessedproperly.

2. Beginningwithz/OSV1R8,EMCSconsolesupport mustbeused.

|

(26)

NetView Subsystem Address Space

The NetViewsubsystemaddressspacejobmustbe runningtoenableyouto:

v ReceiveNetViewcommandsfromsourcesoutsideof theNetView program v Starttheprogram-to-programinterface

v Receivemessagesthataretobe deliveredtotheNetView programthrough the subsystem

v EnabletheNetViewMessageRevisionfunction.

The sizesofthemessageandcommandbuffersare specifiedontheEXEC

statementoftheNetView subsystemaddress spacejob.SeetheIBMTivoliNetView forz/OS Installation:GettingStartedforadescriptionofthesubsystemstartupjob (CNMPSSI).

Table3 liststheminimum,maximum,andrecommendedvaluesforuseinthe NetView subsystemaddressspacejob.

Table3.NetViewSubsystemAddressSpaceJobValues

REG MBUF CBUF

: Whenreceivingmessagesthroughthesubsysteminterface:

Minimum Maximum Recommendation

250 15825 1250

100 8000000 4000

100 8000000 200 : WhenreceivingmessagesusingEMCSconsoles:

Minimum Maximum Recommendation

250 15825 275

100 8000000 100

100 8000000 200

REG Specifiestheregionsize.Tocalculateregion size,multiplythesumofthe number ofmessageandcommandbuffersby256,dividethatproductby 1024,andadda programsize of200K.Theregionsize (REG)iscalculated usingthefollowingequation:

((MBUF + CBUF) x 256)

REG = --- + 200K

1024

Note: Ifyouare usingtheNetView program-to-programinterface(PPI), see“Estimating StorageUsage” onpage133forestimatingthe virtualstorage requirementsoftheNetView subsystemaddress space.

MBUF Specifiesthenumberofmessagebuffers tobeallocatedintheNetView subsystemaddress space.ThemessagebufferqueueholdstheWTO, WTOR, andDOMmessagesforprocessingbytheNetViewprogram. The size ofeachmessagebufferis256bytes.

Note: WhenyouuseEMCSconsolesformessagedelivery,setthemessage buffersizetotheminimumvalue,becausenomessages appearon thesubsysteminterface.

CBUF Specifiesthenumberofcommandbufferstobe allocatedintheNetView subsystemaddress space.Thecommandbuffer queueholdstheNetView commandsenteredfromtheMVSconsoleforprocessingbytheNetView program.

(27)

MSGIFAC

Specifieswhenmessagebuffering begins.WhenUSESSI isspecified, messages arebufferedassoonastheSubsystemInterfaceRoutertask becomesactiveintheNetView applicationaddressspace. IfQUESSI, QSSIAT,orSSIEXTisspecified,bufferingoccursassoonastheSSI

initializes.TheSubsystemInterfaceRoutertaskdoesnotneedtobe active.

Notes:

1. UsingMSGIFAC=QUESSI,QSSIAT,orSSIEXTmight requirethatthe REGandMBUFkeywordvaluesbe changedintheNetViewSSI startupprocedure.Bufferedmessagesbegintoaccumulateassoonas theNetViewSSIcompletesitsinitialization.UntiltheNetView SubsystemInterfaceRouter (taskwithMOD=CNMCSSIRinthe NetViewApplicationaddress space)becomesactive,thebuffered messageswillcontinuetoaccumulate.Therate atwhichthesubsystem addressspacefillsdependsontheamountofmessagetrafficthatis generated.Therefore,thetimeittakestofillthesubsystemaddress spacedependsonmessagetrafficandthenumber ofmessagebuffers defined(MBUF)whenthesubsystemwasstarted.IfMBUF isincreased, thesubsystemregionsize(REG)mightalso needtobeincreased.

Becausethesubsystemaddressspacehastheabilitytoqueuemessages whiletherouterisinactive,therewillbe abacklogofmessagestobe processed.Depending onthenumberof messagesthatwerequeued, theroutertaskmightshowincreasedactivity untilthebacklogis relieved.Therefore,itismoreimportanttohavetheMPFtable analyzedthoroughlysothatmessagesare notpassed unnecessarilyto thesubsystemaddressspace.

2. RegardlessofwhichMSGIFACvalueyouuse,consider usingthe MAXMQOUTsettingtolimittheratethattheCNMCSSIRtaskcan senddata.UsetheTASKMONcommand,orreviewSMF recordtype 38,subtype2,todeterminethehistorical ratesthatCNMCSSIR produced.Thenset theMAXMQOUTsettingusingtheOVERRIDE TASK=CNMCSSIR,MAXMQOUT=nnnncommand. Thisisimportant whenyouuseMSGIFAC=QUESSI,QSSIAT,orSSIEXTwhichcancreate abacklogofmessages whileCNMCSSIRisinactive.TheMAXMQOUT settingmustbe highenoughtopreventtheSSIaddress spacebuffers fromrunningoutofspace,butlowenoughsothattheNetView automationisabletoprocess thetrafficrate. SettingMAXMQOUTfor CNMCSSIRcanalso reducemessagefloodingduringsystemerror recoveryor otherperiodsof highsystemmessagerates.Consider using automationof messagesBNH161I,BNH162I,and BNH163Itoanticipate storagedepletion,andusingtheOVERRIDEcommandforCNMCSSIR MAXMQOUTvalue toslowdowntherate atwhichMVSmessagesare beingreceived.

3. Beginningwithz/OSV1R8,theQUESSI,QSSIAT,andUSESSIvalues arenotsupported.

NetView Automation Table

Automationofsystemand networkmessages andMSUsisaccomplishedwith automation statements(IF-THEN,END,ALWAYS,SYN,and %INCLUDE)inthe NetView automationtable,whichisactivatedbytheAUTOTBLcommand.

Messages andMSUsarepassed throughtheactiveNetViewautomation tableto sequentiallysearchoneormoreofthefollowingautomationtable statementsthat indicateactionstobeautomaticallyperformedfor thatmessage orMSU.

|

(28)

v IF-THENcontainsconditions tobetestedandactionstobetakenifthe

conditionsaresatisfied.Actionsthatcanbe takeninclude adirectresponsetoa systemmessage,acommandorcommandproceduretoberun, orpresentation modification.Multipleactionscanbespecifiedonasingle IF-THENstatement.

v ENDindicatestheendofaBEGIN/END sectionthatcanbeusedtologically segmentautomation statements.

v

ALWAYSindicatesthatcertainactionsare alwaystobe doneifthesequential searchthroughtheactiveautomationtablereachestheALWAYSstatement.

v SYNdefinestablesynonymsthatrepresentvaluesthatcansubsequentlybe substitutedwithinotherautomation tablestatements.

v %INCLUDEphysicallysegmentsthetableintomultiplemembersor files.

Ifan automationtableisactivatedasa resultofa NetViewAUTOTBLcommand, a compact,preprocessed versionoftheautomationtableisloadedintoNetView storage.Thisallowsa quickersearchof theactiveNetView automationtablethan if theactualautomation membersarescanned whenamessageorMSUis

processed. SYNand%INCLUDE statementsdonotaffecttheprocessingtimeof messages andMSUs.Thesestatements areprocessedwhentheAUTOTBL commandisprocessed,notwheneachmessageorMSUisprocessed.

Youcandecreasetheprocessingtimeformessagesand MSUsbyfollowingspecific automation tabledesignguidelines.Theguidelinesintherestof thissection decreasetheaveragesearchtimefortheNetView programtolocatematching statements andtoperformactions.

Asyoumakechangesto improvetheefficiencyoftheautomation table,you shouldmonitor theperformance ofthetableusingtheAUTOCNTcommand.See

“TheAUTOCNT Command”onpage12formore information.

Using BEGIN/END to Improve Efficiency

v BecausetheNetView automationtableissearchedsequentially(toptobottom), logicallysegmentingtheautomationtableusingBEGIN/END sectionsprovides alargeperformanceadvantage.Using BEGIN/ENDreducesthenumberof automationstatementsthatmustbe scanned.Youshoulddesignyour automationtablesothateachmessageprefix(suchasDSI),eachMSUmajor vector(suchasmajor vectorX'0000'),andspecific subvectorshaveBEGIN/END sections.

IfyoudedicateBEGIN/END sectionstothemessageandMSUclasses,the numberofstatementsthatmust bescannedissmallerthanif alloftheIF-THEN andALWAYS statementsarelisted.Ifeachmessageclasshasitsownunique BEGIN/ENDsection,placingALWAYSasthelaststatementinasection

preventstheautomationtablefrombeingscannedfurtherifnoautomationtable matchisfound.

v

OrderBEGIN/END sectionsbyfrequencyofuse.Ifa largenumberofVTAM^® messagesarereceived, aBEGIN/END sectiontohandleISTmessagesshouldbe atornearthetopoftheautomationtableto decreasethenumberofstatements thatmustbeevaluated beforethecorrectBEGIN/ENDsectionisfound.

v Orderthestatementswithin BEGIN/ENDsectionsbyfrequencyofuse.

Minimizingthenumber ofstatementsthatmustbe searchedtofindthecorrect matchingstatementreducesprocessing.

(29)

Using Other Techniques to Improve Efficiency

Thefollowingguidelinesare othertechniques youcanusetodecreasetheaverage searchtimefortheNetViewprogramtolocatematchingstatementsandtoperform actions.

v Placestatementsforentireclassesofmessages orMSUsthatarefrequently received,butnotprocessednearthetopofthetableorBEGIN/ENDsections.

IF-THENstatementsandALWAYSstatementscanspecifythatnoactionbe performed,eliminatingunnecessaryprocessingtime. Forexample,ifyoudonot automatecommandsissuedat aNetViewterminal,youcanaddthestatementin thefollowingexampleat thetopof yourtable:

IF HDRMTYPE = ’*’ THEN ;

v Somecomparisonitemstakelongertoevaluatethanothers.Comparisonitems withthepotentialtoberelativelyslow includeMSUSEGcomparisonitemsthat specifycomplex locations,theIBM-suppliedautomationtablefunction (ATF) programDSICGLOB, andanylengthyATFprogramsyouhavewritten.Isolate theseitemsbyplacingtheminBEGIN/END sectionsstartedwith anIF-THEN statementsothattheNetViewprogramevaluatestheitemsonlywhenthe comparisonintheIF-THENstatementistrue.Youcanalso isolateitemsby placingthemafter alogical-AND operator(&). Inthis case,theNetView programevaluates theitemsonlyiftheconditionsbefore the&are met.

v

AvoidunnecessaryNetViewautomation processingbyusingtheoperating systemmessagefacility(MPFforMVS)tosuppressunneeded messages.Only thosesystemmessages thatrequire NetViewautomation oranoperator’saction shouldbe forwardedtotheNetViewprogram. See“LimitingSystemMessages”

onpage6 formoreinformation.

v Eliminatesimple commandprocedureswhosefunction canbe processedinthe automationtabledirectly.Considerthefollowingexamples:

– Insteadofcallinga commandlistfromtheautomation tabletocheckthe value ofaNetView globalvariable,youcanbypasstheprocessingneededto runthecommandlistbycheckingtheglobalvariable valuedirectlyinthe automation tableusingtheDSITGLOBor DSICGLOBATFs.

– TheTHRESHOLDcomparisonitemisusefulforspecifyingparticularactions totakeplacewhenaconditionhashappenedat leastaspecified numberof timeswithin aspecifiedtimeperiod.Using THRESHOLDintheautomation tableismoreefficientthancallinga commandproceduretomakea similar determination.TheTHRESHOLDcountersareresetwhena newautomation tableisloaded.

– Ifyoucallacommandproceduretoevaluatea complexconditionthatthe existingautomation tablecomparisonitemscannotaddress,consider writing your ownATFtoperformthisprocessing.

v MinimizeuseoftheCONTINUEautomationtable actionthatscanstheentire table.TheCONTINUEactionisusefulforthingssuchassettingdefaultsfor the tableorasection ofthetable andthencontinuingthesearchforanadditional match,asspecifiedbythestatementinthefollowingexample:

ALWAYS SYSLOG(Y) NETLOG(N) DISPLAY(Y) CONTINUE(Y) ;

Ifspecifiedoneverystatement,CONTINUE(Y)increasesprocessingtime.The entireautomationtablemustbe searchedtodetermineallautomation actions thatshouldtakeplace. IfyouuseCONTINUE(Y)todeterminemultiple

IF-THENstatementsthatallresult inactionstobe performed,designyour table sothatscanningdoesnotneedtocontinuethroughtheentiretablebydoingone ofthefollowing:

– Specify CONTINUE(N)onthelaststatementwhereyouexpecttofinda matchfora particularmessageorMSU.

Version 5 Release 3. Tuning Guide SC

Tivoli

IBM Tivoli NetView for z/OS

Tuning Guide

Tivoli

IBM Tivoli NetView for z/OS

Tuning Guide

Contents

Figures

About this publication

Intended audience

Publications

IBM Tivoli NetView for z/OS library

Prerequisite publications

Related publications

Accessing terminology online

Using LookAt to look up message explanations

Accessing publications online

Ordering publications

Accessibility

Tivoli technical training

Support information

Downloads

Conventions used in this publication

Typeface conventions

Operating system-dependent variables and paths

Syntax Diagrams

Position and Appearance of Syntax Elements

Required Syntax Elements

Optional Syntax Elements

Default Keywords and Values

Syntax Fragments

Commas and Parentheses

Abbreviations

Chapter 1. Improving NetView Performance

Achieving Performance Goals

Using General Techniques

Chapter 2. Tuning for Automated Operations

Tuning Techniques

Limiting System Messages

Using MVS Consoles

Using Subsystem Allocatable Consoles

Using EMCS Console Support

NetView Subsystem Address Space

NetView Automation Table

Using BEGIN/END to Improve Efficiency

Using Other Techniques to Improve Efficiency

_IBM _Tivoli _NetView _for _z/OS

_IBM _Tivoli _NetView _for _z/OS