Portions of the Java code that are used in a SAS IT Resource Management 2.7 PDB migration by the %RMPDB2DM or %RM_API_INIT macros, require the ability to connect to an X Server display, even though nothing is actually displayed. This is because certain portions of the Java code that are involved in this process are a subclass of visual components. Attempting to run without the proper configuration will lead to a java.awt.HeadlessException if you do not explicitly set a DISPLAY environment variable.

Follow these steps to avoid the Java exception:

1. Ensure that your JREOPTIONS include the following Java settings:
   -Djava.awt.headless=false -XX:MaxPermSize=128m -Xmx768m
2. For systems in UNIX operating environments, verify that the DISPLAY environment variable has been set to an appropriate X windows location.

   For more information, see SAS Note 18448 "The JAVAIMG device driver and ODS Graphics may fail when running on a UNIX or Linux operating system ."

3. For systems in z/OS operating environments, ensure that the TKJNI_OPT_DISPLAY environment variable has been set correctly in the TKMVSENV data set. This might require using a dummy graphics adapter (XVFB), if your site does not have X Windows Server software.

Operating System and Release Information

A fix for this issue for SAS IT Resource Management 3.2 is available at: