IBM Support

Enabling Performance Monitoring Infrastructure (PMI) through JACL Scripting in WebSphere Application Server Version 9.0, 8.x, and 7.0 including a List of Module IDs.

Troubleshooting


Problem

WebSphere Application Server uses the settings of none, basic, extended, custom, and all for PMI settings. These settings can be set in the WebSphere Application Server administrative console, but in some cases clients would prefer to set them through scripting.

Resolving The Problem

While the following product documentation article does provide guidance for enabling PMI through scripting, this technote will provide a more detailed example:
Configuring the Performance Manager Infrastructure using scripting

The following is an example JACL script to set PMI to custom:

# Set the PMI service level to custom


set pmiServiceRoot [$AdminConfig list PMIService]
$AdminConfig modify $pmiServiceRoot {{statisticSet "custom"}}

# display the list of available modules
puts ""
puts "List of Available Modules: "
set pmiRoot [$AdminConfig list PMIModule]
set packedModules [$AdminConfig showAttribute $pmiRoot pmimodules]
set moduleList [split [lindex $packedModules 0] " "]
foreach module $moduleList {
set moduleName [$AdminConfig showAttribute $module moduleName]
puts $moduleName
}

# prompt user for module to modify
puts ""
puts "Select a Module from list above: "
gets stdin selectedModule
if {${selectedModule} == ""} {
puts "No module selected..exiting"
exit
}
puts ""
puts "Select the new level setting (counter IDs separated by commas - '1,2'): "
gets stdin inputLevel
set setCommand "{enable "
append setCommand $inputLevel "}"

# iterate through module list, find the one selected,
# and set its enabled counters list
foreach module $moduleList {
set moduleName [$AdminConfig showAttribute $module moduleName]
if {$moduleName == $selectedModule} {
$AdminConfig modify $module $setCommand
}
}


# save off the changes and exit
$AdminConfig save
exit

Also, here is a list of some module IDs examples. These lists are not exhausted:


BEAN MODULE

<CountStatistic name="beanModule.creates" ID="1">
<CountStatistic name="beanModule.removes" ID="2">
<CountStatistic name="beanModule.activates" ID="3">
<CountStatistic name="beanModule.passivates" ID="4">
<CountStatistic name="beanModule.instantiates" ID="5">
<CountStatistic name="beanModule.destroys" ID="6">
<CountStatistic name="beanModule.loads" ID="7">
<CountStatistic name="beanModule.stores" ID="8">
<RangeStatistic name="beanModule.readyCount" ID="9">
<RangeStatistic name="beanModule.concurrentLives" ID="10">
<CountStatistic name="beanModule.totalMethodCalls" ID="11">
<TimeStatistic name="beanModule.avgMethodRt" ID="12">
<TimeStatistic name="beanModule.avgCreateTime" ID="14">
<TimeStatistic name="beanModule.avgRemoveTime" ID="15">
<RangeStatistic name="beanModule.activeMethods" ID="18">
<CountStatistic name="beanModule.getsFromPool" ID="19">
<CountStatistic name="beanModule.getsFound" ID="20">
<CountStatistic name="beanModule.returnsToPool" ID="21">
<CountStatistic name="beanModule.returnsDiscarded" ID="22">
<CountStatistic name="beanModule.drainsFromPool" ID="23">
<AverageStatistic name="beanModule.avgDrainSize" ID="24">
<RangeStatistic name="beanModule.poolSize" ID="25">
<CountStatistic name="beanModule.messageCount" ID="26">
<CountStatistic name="beanModule.messageBackoutCount" ID="27">
<TimeStatistic name="beanModule.avgSrvSessionWaitTime" ID="28">
<RangeStatistic name="beanModule.serverSessionUsage" ID="29">
<TimeStatistic name="beanModule.activationTime" ID="30">
<TimeStatistic name="beanModule.passivationTime" ID="31">
<TimeStatistic name="beanModule.loadTime" ID="32">
<TimeStatistic name="beanModule.storeTime" ID="33">
<RangeStatistic name="beanModule.passivationCount" ID="34">
<RangeStatistic name="beanModule.methodReadyCount" ID="35">
<PerfSubModule name="beanModule.methods" ID="50">
<CountStatistic name="beanModule.methods.methodCalls" ID="51">
<TimeStatistic name="beanModule.methods.methodRt" ID="52">
<RangeStatistic name="beanModule.methods.methodLoad" ID="53">

CACHE MODULE ROOT

<CountStatistic ID="1" name="cacheModule.maxInMemoryCacheEntryCount">
<CountStatistic ID="2" name="cacheModule.inMemoryCacheEntryCount">
<CountStatistic ID="21" name="cacheModule.hitsInMemoryCount">
<CountStatistic ID="22" name="cacheModule.hitsOnDiskCount">
<CountStatistic ID="23" name="cacheModule.explicitInvalidationCount">
<CountStatistic ID="24" name="cacheModule.lruInvalidationCount">
<CountStatistic ID="25" name="cacheModule.timeoutInvalidationCount">
<CountStatistic ID="26" name="cacheModule.inMemoryAndDiskCacheEntryCount">
<CountStatistic ID="27" name="cacheModule.remoteHitCount">
<CountStatistic ID="28" name="cacheModule.missCount">
<CountStatistic ID="29" name="cacheModule.clientRequestCount">
<CountStatistic ID="30" name="cacheModule.distributedRequestCount">
<CountStatistic ID="31"
name="cacheModule.explicitMemoryInvalidationCount">
<CountStatistic ID="32"
name="cacheModule.explicitDiskInvalidationCount">
<CountStatistic ID="34"
name="cacheModule.localExplicitInvalidationCount">
<CountStatistic ID="35"
name="cacheModule.remoteExplicitInvalidationCount">
<CountStatistic ID="36" name="cacheModule.remoteCreationCount">

CACHE MODULE SERVLET

<CountStatistic ID="1" name="cacheModule.maxInMemoryCacheEntryCount">
<CountStatistic ID="2" name="cacheModule.inMemoryCacheEntryCount">

CACHE MODULE TEMPLATE

<CountStatistic ID="21" name="cacheModule.hitsInMemoryCount">
<CountStatistic ID="22" name="cacheModule.hitsOnDiskCount">
<CountStatistic ID="23" name="cacheModule.explicitInvalidationCount">
<CountStatistic ID="24" name="cacheModule.lruInvalidationCount">
<CountStatistic ID="25" name="cacheModule.timeoutInvalidationCount">
<CountStatistic ID="26" name="cacheModule.inMemoryAndDiskCacheEntryCount"> <CountStatistic ID="27" name="cacheModule.remoteHitCount">
<CountStatistic ID="28" name="cacheModule.missCount">
<CountStatistic ID="29" name="cacheModule.clientRequestCount">
<CountStatistic ID="30" name="cacheModule.distributedRequestCount">
<CountStatistic ID="31" name="cacheModule.explicitMemoryInvalidationCount">
<CountStatistic ID="32" name="cacheModule.explicitDiskInvalidationCount">
<CountStatistic ID="34" name="cacheModule.localExplicitInvalidationCount">
<CountStatistic ID="35" name="cacheModule.remoteExplicitInvalidationCount">
<CountStatistic ID="36" name="cacheModule.remoteCreationCount">

CONNECTION POOL MODULE

<CountStatistic name="connectionPoolModule.numCreates" ID="1">
<CountStatistic name="connectionPoolModule.numDestroys" ID="2">
<CountStatistic name="connectionPoolModule.numAllocates" ID="3">
<CountStatistic name="connectionPoolModule.numReturns" ID="4">
<BoundedRangeStatistic name="connectionPoolModule.poolSize" ID="5">
<BoundedRangeStatistic name="connectionPoolModule.freePoolSize" ID="6">
<RangeStatistic name="connectionPoolModule.concurrentWaiters" ID="7">
<CountStatistic name="connectionPoolModule.faults" ID="8">
<RangeStatistic name="connectionPoolModule.percentUsed" ID="9">
<RangeStatistic name="connectionPoolModule.percentMaxed" ID="10">
<TimeStatistic name="connectionPoolModule.avgUseTime" ID="12">
<TimeStatistic name="connectionPoolModule.avgWaitTime" ID="13">
<CountStatistic name="connectionPoolModule.numManagedConnections" ID="14"> <CountStatistic name="connectionPoolModule.numConnectionHandles" ID="15"> <CountStatistic name="connectionPoolModule.prepStmtCacheDiscards" ID="21"> <TimeStatistic name="connectionPoolModule.jdbcOperationTimer" ID="22">

J2C MODULE

<CountStatistic name="j2cModule.numManagedConnectionsCreated" ID="1">
<CountStatistic name="j2cModule.numManagedConnectionsDestroyed" ID="2">
<CountStatistic name="j2cModule.numManagedConnectionsAllocated" ID="3">
<CountStatistic name="j2cModule.numManagedConnectionsReleased" ID="4">
<BoundedRangeStatistic name="j2cModule.poolSize" ID="5">
<BoundedRangeStatistic name="j2cModule.freePoolSize" ID="6">
<RangeStatistic name="j2cModule.concurrentWaiters" ID="7">
<CountStatistic name="j2cModule.faults" ID="8">
<RangeStatistic name="j2cModule.percentUsed" ID="9">
<RangeStatistic name="j2cModule.percentMaxed" ID="10">
<TimeStatistic name="j2cModule.useTime" ID="12">
<TimeStatistic name="j2cModule.avgWait" ID="13">
<CountStatistic name="j2cModule.numManagedConnections" ID="14">
<CountStatistic name="j2cModule.numConnectionHandles" ID="15">

JVM™ RUNTIME MODULE

<BoundedRangeStatistic name="jvmRuntimeModule.totalMemory" ID="1">
<CountStatistic name="jvmRuntimeModule.freeMemory" ID="2">
<CountStatistic name="jvmRuntimeModule.usedMemory" ID="3">
<CountStatistic name="jvmRuntimeModule.upTime" ID="4">
<CountStatistic name="jvmRuntimeModule.numGcCalls" ID="11">
<TimeStatistic name="jvmRuntimeModule.avgTimeBetweenGcCalls" ID="12">
<TimeStatistic name="jvmRuntimeModule.avgGcDuration" ID="13">
<CountStatistic name="jvmRuntimeModule.numObjectsAllocated" ID="14">
<CountStatistic name="jvmRuntimeModule.numObjectsFreed" ID="15">
<CountStatistic name="jvmRuntimeModule.numObjectsMoved" ID="16">
<CountStatistic name="jvmRuntimeModule.numThreadsStarted" ID="17">
<CountStatistic name="jvmRuntimeModule.numThreadsDead" ID="18">
<CountStatistic name="jvmRuntimeModule.numWaitsForLock" ID="19">
<TimeStatistic name="jvmRuntimeModule.avgTimeWaitForLock" ID="20">

ORB MODULE

<TimeStatistic name="orbPerfModule.referenceLookupTime" ID="1">
<CountStatistic name="orbPerfModule.totalRequests" ID="2">
<RangeStatistic name="orbPerfModule.concurrentRequests" ID="3">
<PerfSubModule name="orbPerfModule.interceptors" ID="10">

SERVLET SESSIONS MODULE

<CountStatistic name="servletSessionsModule.createdSessions" ID="1">
<CountStatistic name="servletSessionsModule.invalidatedSessions" ID="2">
<CountStatistic name="servletSessionsModule.finalizedSessions" ID="3">
<TimeStatistic name="servletSessionsModule.sessionLifeTime" ID="4">
<TimeStatistic name="servletSessionsModule.sessionInvalidateTime" ID="5">
<RangeStatistic name="servletSessionsModule.activeSessions" ID="6">
<RangeStatistic name="servletSessionsModule.liveSessions" ID="7">
<CountStatistic name="servletSessionsModule.noRoomForNewSession" ID="8">
<CountStatistic name="servletSessionsModule.cacheDiscards" ID="9">
<TimeStatistic name="servletSessionsModule.externalReadTime" ID="10">
<AverageStatistic name="servletSessionsModule.externalReadSize" ID="11">
<PerfStat name="servletSessionsModule.externalWriteTime" ID="12">
<AverageStatistic name="servletSessionsModule.externalWriteSize"
ID="13">
<CountStatistic name="servletSessionsModule.affinityBreaks" ID="14">
<TimeStatistic name="servletSessionsModule.timeSinceLastActivated"
ID="15">
<CountStatistic name="servletSessionsModule.invalidatedViaTimeout"
ID="16">
<CountStatistic name="servletSessionsModule.activateNonExistSessions"
ID="17">
<AverageStatistic name="servletSessionsModule.serializableSessObjSize"
ID="18">

SYSTEM MODULE

<CountStatistic name="systemModule.cpuUtilization" ID="1">
<AverageStatistic name="systemModule.avgCpuUtilization" ID="2">
<CountStatistic name="systemModule.freeMemory" ID="3">

THREAD POOL MODULE

<CountStatistic name="threadPoolModule.threadCreates" ID="1">
<CountStatistic name="threadPoolModule.threadDestroys" ID="2">
<BoundedRangeStatistic name="threadPoolModule.activeThreads" ID="3">
<BoundedRangeStatistic name="threadPoolModule.poolSize" ID="4">
<BoundedRangeStatistic name="threadPoolModule.percentMaxed" ID="5">
<CountStatistic name="threadPoolModule.declaredThreadHung" ID="6">
<CountStatistic name="threadPoolModule.declaredThreadHangCleared" ID="7">
<RangeStatistic name="threadPoolModule.concurrentlyHungThreads" ID="8">
<TimeStatistic name="threadPoolModule.activeTime" ID="9">

TRANSACTION MODULE

<CountStatistic name="transactionModule.globalTransBegun" ID="1">
<CountStatistic name="transactionModule.globalTransInvolved" ID="2">
<CountStatistic name="transactionModule.localTransBegun" ID="3">
<CountStatistic name="transactionModule.activeGlobalTrans" ID="4">
<CountStatistic name="transactionModule.activeLocalTrans" ID="5">
<TimeStatistic name="transactionModule.globalTranDuration" ID="6">
<TimeStatistic name="transactionModule.localTranDuration" ID="7">
<TimeStatistic name="transactionModule.globalBeforeCompletionDuration" ID="8">
<TimeStatistic name="transactionModule.globalPrepareDuration" ID="9">
<TimeStatistic name="transactionModule.globalCommitDuration" ID="10">
<TimeStatistic name="transactionModule.localBeforeCompletionDuration" ID="11">
<TimeStatistic name="transactionModule.localCommitDuration" ID="12">
<CountStatistic name="transactionModule.numOptimization" ID="13">
<CountStatistic name="transactionModule.globalTransCommitted" ID="14">
<CountStatistic name="transactionModule.localTransCommitted" ID="15">
<CountStatistic name="transactionModule.globalTransRolledBack" ID="16">
<CountStatistic name="transactionModule.localTransRolledBack" ID="17">
<CountStatistic name="transactionModule.globalTransTimeout" ID="18">
<CountStatistic name="transactionModule.localTransTimeout" ID="19">


WEB APP MODULE

<CountStatistic name="webAppModule.numLoadedServlets" ID="1">
<CountStatistic name="webAppModule.numReloads" ID="2">
<PerfSubModule name="webAppModule.servlets" ID="10">
<CountStatistic name="webAppModule.servlets.totalRequests" ID="11">
<RangeStatistic name="webAppModule.servlets.concurrentRequests" ID="12">
<TimeStatistic name="webAppModule.servlets.responseTime" ID="13">
<CountStatistic name="webAppModule.servlets.numErrors" ID="14">


WEB SERVICES MODULE

<CountStatistic name="webServicesModule.numLoadedServices" ID="1">
<PerfSubModule name="webServicesModule.services" ID="10">
<CountStatistic name="webServicesModule.services.numberReceived" ID="11">
<CountStatistic name="webServicesModule.services.numberDispatched" IID="12">
<CountStatistic name="webServicesModule.services.numberSuccessfull" ID="13">
<TimeStatistic name="webServicesModule.services.responseTime" ID="14">
<TimeStatistic name="webServicesModule.services.requestResponseTime" ID="15">
<TimeStatistic name="webServicesModule.services.dispatchResponseTime" ID="16">
<TimeStatistic name="webServicesModule.services.replyResponseTime" ID="17">
<AverageStatistic name="webServicesModule.services.size" ID="18">
<AverageStatistic name="webServicesModule.services.requestSize" ID="19">
<AverageStatistic name="webServicesModule.services.replySize" ID="20">


WLM MODULE

<CountStatistic name="wlmModule.server.numIncomingRequests" ID="11">
<CountStatistic name="wlmModule.server.numIncomingStrongAffinityRequests" ID="12">
<CountStatistic name="wlmModule.server.numIncomingWeakAffinityRequests" ID="13">
<CountStatistic name="wlmModule.server.numIncomingNonAffinityRequests" ID="14">
<CountStatistic name="wlmModule.server.numIncomingNonWLMObjectRequests" ID="15">
<CountStatistic name="wlmModule.server.numServerClusterUpdates" ID="16">
<CountStatistic name="wlmModule.server.numOfWLMClientsServiced" ID="17">
<RangeStatistic name="wlmModule.server.numOfConcurrentRequests" ID="18">
<TimeStatistic name="wlmModule.server.serverResponseTime" ID="19">
<CountStatistic name="wlmModule.client.numOfOutgoingRequests" ID="51">
<CountStatistic name="wlmModule.client.numClientClusterUpdates" ID="52">
<TimeStatistic name="wlmModule.client.clientResponseTime" ID="53">

WSGW MODULE

<CountStatistic name="wsgwModule.synchronousRequests" ID="1">
<CountStatistic name="wsgwModule.synchronousResponses" ID="2">
<CountStatistic name="wsgwModule.asynchronousRequests" ID="3">
<CountStatistic name="wsgwModule.asynchronousResponses" ID="4">

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"PMI\/Performance Tools","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5;8.0;7.0","Edition":"Base;Express;Network Deployment","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Java SDK","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21221308