June 12, 2012 9:17:50 AM PDT
Goal: How to Resolve the Issue When Interstage XWand Tool Appears to Hang
Fact: Interstage XWand Toolkit Version 11.0.4
Fact: Interstage XWand Toolkit Version 11.0.0
Fact: Interstage XWand Toolkit Version 12.0.0
Fact: Interstage XWand Toolkit Version 12.0.1
Fact: Windows platform
Fact: Java(TM) SE Runtime Environment 5
Fact: Java(TM) SE Runtime Environment 6
Symptom:
XWand Toolkit tool appears to hang during loading of various XBRL documents such as taxonomy file or instance document.
Symptom:
If the tool's java launching command is edited properly, error may be shown at the command-line window with the out of memory error : "java.lang.OutOfMemoryError: Java heap space"
Symptom:
The console message shows no apparent error messages, but the tool just hangs.
Fix:
Locate the run.bat that is used to launch the tool. Just right click on the tool's link in Windows program group "Interstage XWand Toolkit" and follow the "target" or "start in" value to locate this run.bat.
For example, Sheet Mapping Designer's launching script is typically found in C:Program FilesISXWandXWand-tktoolsexcelsheetmappingrun.bat
Open the run.bat with a text editor and locate the java maximum heap allocation option -Xmx500m, default value 500 Mega Bytes specified for Interstage XWand ToolKit. Revise the value from 500 MB to 1024 MB, -Xmx1024m, and save the changes.
Restart the tool again and repeat the operation where the tool appears to hang. See if there is any difference after allocating more heap to JVM (Java Virtual Machine).
Note: If JVM 64-bit is used, our observation shows that more heap is needed to avoid the out of memory error.
Author: C.Y. Chen
Attachment: