This task describes the steps used to activate the heap monitor.
Heap monitor is used with WebSphere® Application Server profiles to monitor
heap size of a profile in comparison to pool size.
Before you begin
For existing WebSphere Application Server profiles,
there is a script available to add the feature. See the heapMonitor script
information.
About this task
You can use the heap monitor feature to monitor the Java™ Virtual
Machine (JVM) heap size of a WebSphere Application Server profile in comparison
to pool size. The feature is available for new WebSphere Application Server profiles
or profiles that are created.
To check if a WebSphere Application Server profile
has the heap monitor enabled and to activate it if necessary, perform the
following steps.
Procedure
- Start the server for the WebSphere Application Server profile.
- Run the heapMonitor script with the -status flag. For
example, for a WebSphere Application
Server Version 7 profile named default, enter the following command in the
Qshell environment:
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/heapMonitor -profileName default -status
The output should look similar to the following:WASX7209I: Connected to process "server1" on node MYSERVER using SOAP connector;
The type of process is: UnManagedProcess
WASX7303I: The following options are passed to the scripting
environment and are available as argument that is stored in the argv
variable: "[status, server1]"
HEAP0002I: The heap monitor is disabled.
$
- To enable the heap monitor for this example, enter the following
command in the Qshell environment:
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/heapMonitor -profileName default -enable
The output should look similar to the following: WASX7209I: Connected to process "server1" on node MYSERVER using SOAP connector;
The type of process is: UnManagedProcess
WASX7303I: The following options are passed to the scripting environment and are
available as argument that is stored in the argv
variable: "[enable, server1]"
HEAP0005I: Enabling the heap monitor...
HEAP0003I: The heap monitor has been enabled.
$
- Stop and start the server.
Results
The following message typically appears in the Display Message command
(DSPMSG QSYSOPR):
HEAP MONITOR STARTED FOR 012500/QEJBSVR/SERVER1 IN SUBSYSTEM QWAS7 IN POOL
*BASE POOL ID=2 POOLSIZE(B)=1687994368 RESERVED(B)=778240 HEAP
TOTAL(B)=202276864 FREE(B)=67037600 USEDHEAP=135239264
OS400.GC.HEAP.SIZE.MAX(KB) =240000000
The heap monitor is activated.