Configuring the Java virtual machine using scripting

Use the wsadmin tool to configure settings for a Java™ virtual machine (JVM). As part of configuring an application server, you might define settings that enhance the way your operating system uses of the Java virtual machine.

About this task

There are three ways to perform this task. Use the steps in this topic to use the setJVMDebugMode command for the AdminTask object or the AdminConfig object to modify your JVM configuration. Alternatively, you can use the configureJavaVirtualMachine Jython script in the AdminServerManagement script library to enable, disable, or configure the debug mode for the JVM. The wsadmin tool automatically loads the script when the tool starts. Use the following syntax to configure JVM settings using the configureJavaVirtualMachine script:
AdminServerManagement.configureJavaVirtualMachine(nodeName, serverName, debugMode, debugArgs, otherAttributeList)
For additional information and argument definitions, see the documentation for the AdminServerMananagment script library.

The Java virtual machine (JVM) is an interpretive computing engine responsible for running the byte codes in a compiled Java program. The JVM translates the Java byte codes into the native instructions of the host machine. The application server, being a Java process, requires a JVM in order to run, and to support the Java applications running on it. JVM settings are part of an application server configuration.

Procedure

  1. Start the wsadmin scripting tool.
  2. There are two ways to complete this step. You can use the setJVMDebugMode command for the AdminTask object or the AdminConfig object to modify your JVM configuration. Choose one of the following configuration methods:
    • Using the AdminTask object:
      • Using Jacl:
        $AdminTask setJVMDebugMode {-serverName server1 -nodeName node1 -debugMode true}
      • Using Jython:
        AdminTask.setJVMDebugMode (['-serverName', 'server1', '-nodeName', 'node1', '-debugMode', 'true'])
    • Using the AdminConfig object:
      1. Identify the server and assign it to the server1 variable, as the following example demonstrates:
        • Using Jacl:
          set server1 [$AdminConfig getid /Cell:mycell/Node:mynode/Server:server1/]
        • Using Jython:
          server1 = AdminConfig.getid('/Cell:mycell/Node:mynode/Server:server1/')
          print server1
        Example output:
        server1(cells/mycell/nodes/mynode/servers/server1|server.xml#Server_1)
      2. Identify the JVM that belongs to the server of interest and assign it to the jvm variable, as the following example demonstrates:
        • Using Jacl:
          set jvm [$AdminConfig list JavaVirtualMachine $server1]
        • Using Jython:
          jvm = AdminConfig.list('JavaVirtualMachine', server1)
          print jvm

        Example output:

        (cells/mycell/nodes/mynode/servers/server1:server.xml#JavaVirtualMachine_1)
      3. Modify the JVM to enable debugging, as the following example demonstrates:
        • Using Jacl:
          $AdminConfig modify $jvm {{debugMode true} {debugArgs "-Djava.compiler=NONE -Xdebug -Xnoagent 
          -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7777"}}
        • Using Jython:
          AdminConfig.modify(jvm, [['debugMode', 'true'], ['debugArgs',  "-Djava.compiler=NONE -Xdebug 
          -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7777"]])
  3. Save the configuration changes.
    Use the following command example to save your configuration changes:
    AdminConfig.save()



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 1:44:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-dist&topic=txml_jvm
File name: txml_jvm.html