Microsoft KB Archive/231294

= SAMPLE: SmartGC Uses an ATL Server to Trigger Java Garbage Collection =

Article ID: 231294

Article Last Modified on 6/14/2006

-

APPLIES TO


 * Microsoft Visual J++ 6.0 Standard Edition
 * Microsoft Visual C++ 6.0 Enterprise Edition
 * Microsoft Visual C++ 6.0 Professional Edition
 * Microsoft Visual C++ 6.0 Standard Edition
 * Microsoft Java Virtual Machine
 * Microsoft Windows NT 4.0
 * Microsoft Windows NT 4.0 Service Pack 4

-



This article was previously published under Q231294



SUMMARY
Java applications can register a sink with the JVMmem ActiveX Template Library (ATL) server, which periodically monitors memory load. When a memory threshold is exceeded, the server fires a notification event to the Java application indicating that the Java garbage collector should be invoked.

SmartGC.exe provides a foundation for Java applications to more optimally control garbage collection. Since Java garbage collection is triggered by Virtual Memory (VM) usage, some applications may run more efficiently if garbage collection is triggered on available RAM or the process Working Set size.



MORE INFORMATION
The following files are available for download from the Microsoft Download Center:

Gc.exe

SmartGc.exe

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

The following steps describe how to use SmartGC.exe.
 * 1) Build the ATL project. This creates and registers the JVMmem ATL DLL server.
 * 2) Open the Java project, select Add COM Wrapper from the Project menu.
 * 3) Select JVMmemMod 1.0 Type Library from the list of installed COM Components.
 * 4) Build the sample.

You will get better results if you run the sample outside the Visual J++ IDE; that is, from Explorer:
 * 1) Click the Create button a few times until the Current Available Physical Memory is at least 5 MB lower than the initial Available Physical Memory.
 * 2) Click Delete All. This will initialize the JVMmem server to monitor Available Physical Memory.

After about a minute the 'Object Cnt:' should match the 'Vector Cnt:' and the Current Working Set and Available Physical Memory should return near initial Levels. NOTE: All of the memory statements in this article assume other applications are not consuming more memory while you run the sample test. Obviously, if you start several large applications, the current available memory will be lowered regardless of GC activity on the test sample.

The current Available memory and current working set may take some time to return to initial levels, as Windows NT does not immediately trim the working set if there is no need for RAM.

Notice the program calls SetProcessWorkingSetSize in the constructor to encourage Windows NT to limit the maximum Working Set.

Use the following steps to test that the GC sink routine is actually forcing the freeing of memory and objects:
 * 1) Click the Stop Timer button. Notice it now changes to "Start Timer."
 * 2) Create and delete several objects so the Object count is 30 but the Vector Count is zero. The memory and objects will not be garbage collected.
 * 3) After waiting until your convinced that no garbage collection will take place, click Start Timer button. Within about a minute you should see the Object Count return to zero and corresponding memory freed.

