Rational Developer for System z

$GLOBAL

The $GLOBAL specifies the default properties for the SCLM project for Java/J2EE build processing in a tagged language format. It must be named $GLOBAL and reside in the SCLM type J2EEBLD.

As part of the JAVA/J2EE build process some additional information is required in order to successfully perform the builds. As the builds are performed in z/OS® UNIX System Services, information such as the Java™ product location, ANT product location and the location of the SCLM Developer Toolkit configuration files and workarea are required. Additionally it may be required to use different versions of ANT or Java for different SCLM development groups, so to this end the $GLOBAL member can be group specific. The environment variables set in $GLOBAL may be overwritten by specific build script variable settings. A sample member BWBGLOB is provided in the SBWBSAMP library.

If the $GLOBAL variables are to be set for the all group levels in the SCLM project then it is good practice to create a single $GLOBAL member at the highest level in the hierarchy. When the Java/J2EE build translator runs it will look up the hierarchy from the group level performing the build and use the first $GLOBAL it finds in the J2EEBLD type.

Note: The $GLOBAL member must be stored as a valid saved SCLM member so this hierarchy lookup can be performed. It is recommended that you add this member as language type J2EEPART or TEXT.

If different settings are required, at different development groups for example, then a $GLOBAL member can be created in each of the development groups. The Java runtime environment referenced by JAVA_BIN in $GLOBAL is used by the SCLM Developer Toolkit for various function requests. For individual Java program compilations, the SCLM Developer Toolkit uses this specific Java SDK. For Java/J2EE project builds, SCLM Developer Toolkit will not use the $GLOBAL JAVA_BIN. It uses the Java compiler/runtime defined in ANT instead. Refer to the ANT install and customization section in the SCLM Developer Toolkit Install and Customization Guide for further information on defining levels of Java within ANT.

$GLOBAL variables

Variable Description
ANT_BIN Directory location of ANT bin in the z/OS HFS.
JAVA_BIN Directory location of the Java SDK bin in the z/OS HFS.
CGI_DTCONF The location of the SCLM Developer Toolkit CONFIG directory
CGI_DTWORK The location of the SCLM Developer Toolkit WORKAREA directory
CLASSPATH_JARS z/OS HFS classpath directory used for individual Java source compilations. All jars located in this directory will be used in the classpath.

$GLOBAL sample

<property name="ANT_BIN" value="/usr/lpp/ANT/apache-ant-1.6.0/bin/ant"/>
<property name="JAVA_BIN" value="/usr/lpp/java/IBM/J1.5/bin"/>
<property name="CGI_DTCONF" value="/etc/SCLMDT/CONFIG"/>
<property name="CGI_DTWORK" value="/var/SCLMDT/WORKAREA"/>
<property name="CLASSPATH_JARS" value="/var/SCLMDT/CLASSPATH"/>

Feedback