PI15714: Adjusting the Java maximum heap size for Jetty on Unix has changed from Rational Change 5.3.1

Rational Change Interim Fix 1 for 5.3.1.1
Rational Change Interim Fix 2 for 5.3.1.1
Rational Change Interim Fix 3 for 5.3.1.1
Rational Change Interim Fix 4 for 5.3.1.1

APAR status

• Closed as documentation error.

Error description

• The documented process on how to change the the Java maximum
  heap size for Jetty in IBM Rational Change for Unix/Linux
  installations has changed with release 5.3.1
  
  The process is documented in
  http://pic.dhe.ibm.com/infocenter/chghelp/v5m3/topic/com.ibm.rat
  ional.change.install.doc/topics/ch_t_ig_change_java_max_heap_jty
  .html
  
  Since Rational Change release 5.3.1 you need to do the
  following:
  1. Stop Rational Change.
  2. Change the configuration file
      a. Open $CHANGE_HOME/jetty/start.ini for editing.
      b. Remove the hash tags, #, in front of --exec and in front
  of the Java maximum heap size flag, -Xmx.
      c. Set the -Xmx value to a number more suitable to your
  needs.
      d. Save and close the start.ini file.
  4. Start Rational Change.
  Prior to release 5.3.1 you should follow the documented
  procedure.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ALL                                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Adjusting the Java maximum heap size for Jetty on Unix has   *
  * changed from Rational Change 5.3.1                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * There is another way to change the JVM heap sizes apart from *
  * what mentioned in the description.                           *
  * 1. Open the jetty.sh in a text editor.                       *
  * 2. Find the section "Add jetty properties to Java VM         *
  * options.", in this section JAVA_OPTIONS is assigned some     *
  * values related to Jetty.                                     *
  * 3. Replace the line                                          *
  * JAVA_OPTIONS="$JAVA_OPTIONS -Djetty.home=$JETTY_HOME         *
  * -Djava.io.tmpdir=$TMPDIR"                                    *
  * with                                                         *
  * JAVA_OPTIONS="$JAVA_OPTIONS -Xmx<your_value>m                *
  * -Xms<your_value>m -Djetty.home=$JETTY_HOME                   *
  * -Djava.io.tmpdir=$TMPDIR"                                    *
  * Here replace <your_value> to actual desired value.           *
  * 4. Save the file.                                            *
  * 5. Re-start the Rational Change server.                      *
  ****************************************************************
  

Problem conclusion

• Documentation is updated now.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  TLOGIC CHANGE

• Fixed component ID

  5724V87CG

Applicable component levels