ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaha_5.4.0.1/nawtenvironmentvariables.htm

99 lines
6.8 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Configuring NAWT environment variables" />
<meta name="abstract" content="Any time that you run Java with NAWT, you must set environment variables that tell Java the system name, the display number, and where to find each X server and the associated .Xauthority file." />
<meta name="description" content="Any time that you run Java with NAWT, you must set environment variables that tell Java the system name, the display number, and where to find each X server and the associated .Xauthority file." />
<meta name="DC.Relation" scheme="URI" content="nawtinstallpre14.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtinstallfixes.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtprpqinstall.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtstartvncserver.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtsystemprops.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtverifyinstall.htm" />
<meta name="DC.Relation" scheme="URI" content="nawticewmwindowmgr.htm" />
<meta name="DC.Relation" scheme="URI" content="nawtvncviewer.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="nawtenvironmentvariables" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Configuring NAWT environment variables</title>
</head>
<body id="nawtenvironmentvariables"><a name="nawtenvironmentvariables"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Configuring NAWT environment variables</h1>
<div><p>Any time that you run Java™ with NAWT, you must set environment
variables that tell Java the system name, the display number,
and where to find each X server and the associated .Xauthority file.</p>
<p><strong>Note:</strong> Starting the Virtual Network Computing (VNC) server determines
the location of the .Xauthority file and the values for the system name
and display number. You need to use these values to successfully configure
the NAWT environment variables. For more information, see <a href="nawtstartvncserver.htm">Starting
the Virtual Network Computing server</a>.</p>
<div class="section"><h4 class="sectiontitle">Configuring DISPLAY</h4><p>In the session where you want
to run Java programs, set the DISPLAY environment variable
to your system name and display number. To configure the DISPLAY environment
variable, at an <span class="keyword">i5/OS™</span> command
line, type the following control language (CL) command and press <strong>ENTER</strong>:</p>
<pre> ADDENVVAR ENVVAR(DISPLAY) VALUE('<em>systemname:n</em>')</pre>
<p>where <em>systemname</em> is the host name or IP address of
your iSeries™ system
and <em>n</em> is the display number of the VNC server.</p>
</div>
<div class="section"><h4 class="sectiontitle">Configuring XAUTHORITY</h4><p>Also, set the XAUTHORITY
environment variable to <kbd class="userinput">/home/VNCprofile/.Xauthority</kbd>,
where <em>VNCprofile</em> is the profile that started the VNC server.</p>
<p>For
example, at the iSeries command
prompt, type the following commands:</p>
<pre> ADDENVVAR ENVVAR(DISPLAY) VALUE('<em>systemname:n</em>')
ADDENVVAR ENVVAR(XAUTHORITY) VALUE('/home/<em>VNCprofile</em>/.Xauthority')</pre>
<p> Where:</p>
<ul><li><em>systemname</em> is the host name or IP address of your iSeries system.</li>
<li><em>n</em> is the display number of the VNC server.</li>
</ul>
<p> <strong>Notes:</strong></p>
<ul><li>You need to set these environment variables only in the environment where
you will run the Java virtual machine (JVM).</li>
<li>When you cannot run the VNC server and the Java virtual machine under the same
user profile, you can configure XAUTHORITY to point to the appropriate
.Xauthority file. You must ensure that the other profiles under which the
JVM runs can access the .Xauthority file. For more information, see <a href="nawtstartvncserver.htm">The .Xauthority file</a>.</li>
<li>The XAUTHORITY security mechanism is different from the VNCPASSWD security
mechanism. Both protection schemes are necessary for secure graphics
rendering. For more information about VNCPASSWD, see <a href="nawtcreatevncpassword.htm">Creating
a VNC password file</a>. </li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="nawtinstallpre14.htm" title="To install Native Abstract Windowing Toolkit (NAWT) for Java 2 Software Development Kit (J2SDK), version 1.3, complete the following tasks.">Installing and using NAWT with J2SDK, version 1.3</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="nawtprpqinstall.htm" title="To run Native Abstract Windowing Toolkit (NAWT), you need to install the iSeries Tools for Developers PRPQ (5799PTL). If you do not have the PRPQ, you must order it.">Installing iSeries Tools for Developers PRPQ</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="nawtinstallfixes.htm" title="To install NAWT, you need to ensure that you install the software fix that includes the appropriate NAWT support for the version of Java 2 Software Development Kit (J2SDK), Standard Edition that you want to use.">Install NAWT software fixes</a></div>
<div><a href="nawtstartvncserver.htm">Starting the Virtual Network Computing server</a></div>
<div><a href="nawtsystemprops.htm">Configuring Java system properties</a></div>
<div><a href="nawtverifyinstall.htm">Verifying your NAWT installation</a></div>
<div><a href="nawticewmwindowmgr.htm">Configuring the iceWM window manager</a></div>
<div><a href="nawtvncviewer.htm">Using a VNCviewer or Web browser</a></div>
</div>
</div>
</body>
</html>