SAMPLE: SmartGC Uses an ATL Server to Trigger Java Garbage Collection (231294)


The information in this article applies to:

  • Microsoft Visual J++ 6.0
  • Microsoft Visual C++, 32-bit Enterprise Edition 6.0
  • Microsoft Visual C++, 32-bit Professional Edition 6.0
  • Microsoft Visual C++, 32-bit Learning Edition 6.0
  • Microsoft virtual machine
  • the operating system: Microsoft Windows NT 4.0
  • the operating system: Microsoft Windows NT 4.0 SP4
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.
SmartGC FilesSize in Bytes
CCheckMem.h 1866
CheckMem.cpp 3779
CheckMem.h 2193
CheckMem.rgs 637
dlldata.c 839
JVMmemMod.aps 3736
JVMmemMod.cpp 1970
JVMmemMod.def 226
JVMmemMod.dsp 13088
JVMmemMod.dsw 541
JVMmemMod.h 19900
JVMmemMod.idl 2430
JVMmemMod.rc 2861
JVMmemMod.tlb 3376
JVMmemModCP.h 917
JVMmemModps.def 251
JVMmemModps.mk 478
JVMmemMod_i.c 1272
JVMmemMod_p.c 21624
memory.pmc 758
PSAPI.H 4172
PSAPI.LIB 19790
resource.h 502
rm.cpp 0
StdAfx.cpp 315
StdAfx.h 908

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.

REFERENCES

For more information, see the following article in the Microsoft Knowledge Base:

231183 SAMPLE: Clean Up Java Resources Automatically with Gc.exe

For support information about Visual J++ and the SDK for Java, visit the following Microsoft Web site:

http://www.microsoft.com/java


Modification Type:MajorLast Reviewed:6/14/2006
Keywords:kbdownload kbhowto kbJava kbJNative KB231294 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.