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

117 lines
8.9 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="Using QIBM_JAVA_PASE_ALLOW_PREV" />
<meta name="abstract" content="Sometimes it is difficult to determine whether an i5/OS PASE environment already exists. Using the optional environment variable QIBM_JAVA_PASE_ALLOW_PREV in combination with QIBM_JAVA_PASE_STARTUP enables the JVM to determine whether to use the current i5/OS PASE environment (if one exists) or start a new i5/OS PASE environment." />
<meta name="description" content="Sometimes it is difficult to determine whether an i5/OS PASE environment already exists. Using the optional environment variable QIBM_JAVA_PASE_ALLOW_PREV in combination with QIBM_JAVA_PASE_STARTUP enables the JVM to determine whether to use the current i5/OS PASE environment (if one exists) or start a new i5/OS PASE environment." />
<meta name="DC.Relation" scheme="URI" content="rzahapasejavaenvvariables.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="rzahapaseexmplsallowprev" />
<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>Using QIBM_JAVA_PASE_ALLOW_PREV</title>
</head>
<body id="rzahapaseexmplsallowprev"><a name="rzahapaseexmplsallowprev"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Using QIBM_JAVA_PASE_ALLOW_PREV</h1>
<div><p>Sometimes it is difficult to determine whether an <span class="keyword">i5/OS™</span> PASE environment
already exists. Using the optional environment variable QIBM_JAVA_PASE_ALLOW_PREV
in combination with QIBM_JAVA_PASE_STARTUP enables the JVM to determine whether
to use the current <span class="keyword">i5/OS</span> PASE environment (if one exists) or start a new
<span class="keyword">i5/OS</span> PASE environment.</p>
<p>To use these two environment variables in combination, set them to the
following values:</p>
<ul><li>Set QIBM_JAVA_PASE_STARTUP to the default startup program</li>
<li>Set QIBM_JAVA_PASE_ALLOW_PREV to 1</li>
</ul>
<p>For example, an application that optionally starts an <span class="keyword">i5/OS</span> PASE environment
calls the program that starts the JVM. In this case, by using the previous
settings, the program is able to use the current <span class="keyword">i5/OS</span> PASE environment,
if one exists, or start a new <span class="keyword">i5/OS</span> PASE environment.</p>
<p>The following table identifies any <span class="keyword">i5/OS</span> PASE environments that result
from the various combinations of <span class="keyword">i5/OS</span> PASE environment and definitions of
QIBM_JAVA_PASE_STARTUP and QIBM_JAVA_PASE_ALLOW_PREV:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><caption>Table 1. <span class="keyword">i5/OS</span> PASE environments resulting from combinations
of <span class="keyword">i5/OS</span> PASE environment and definitions of QIBM_JAVA_PASE_STARTUP and QIBM_JAVA_PASE_ALLOW_PREV</caption><thead align="left"><tr valign="bottom"><th colspan="3" align="center" valign="bottom" id="d0e72">Starting environment</th>
<th align="center" valign="bottom" width="26.13065326633166%" id="d0e74">Resulting behavior</th>
</tr>
<tr valign="bottom"><th align="center" valign="bottom" width="24.623115577889447%" id="d0e77"><span class="keyword">i5/OS</span> PASE environment</th>
<th align="center" valign="bottom" width="24.623115577889447%" id="d0e82">QIBM_JAVA _PASE_STARTUP</th>
<th align="center" valign="bottom" width="24.623115577889447%" id="d0e84">QIBM_JAVA_PASE _ALLOW_PREV </th>
<th align="center" valign="bottom" width="26.13065326633166%" id="d0e86">JVM <span class="keyword">i5/OS</span> PASE Startup</th>
</tr>
</thead>
<tbody><tr valign="middle"><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">None</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Not defined</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Not defined*</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">No <span class="keyword">i5/OS</span> PASE environment</td>
</tr>
<tr valign="middle"><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">None</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Not defined</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Defined '1'</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">No <span class="keyword">i5/OS</span> PASE environment</td>
</tr>
<tr valign="middle"><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">None</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Defined startX</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Not defined*</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Use startX</td>
</tr>
<tr valign="middle"><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">None</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Defined startX</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Defined '1'</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Use startX</td>
</tr>
<tr valign="middle"><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">Started</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Not defined</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Not defined*</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Use existing <span class="keyword">i5/OS</span> PASE environment</td>
</tr>
<tr><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">Started</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Not defined</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Defined '1'</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Use existing <span class="keyword">i5/OS</span> PASE environment </td>
</tr>
<tr><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">Started</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Defined startX</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Not defined*</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Not allowed: JVM error during startup</td>
</tr>
<tr><td valign="middle" width="24.623115577889447%" headers="d0e72 d0e77 ">Started</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e82 ">Defined startX</td>
<td valign="middle" width="24.623115577889447%" headers="d0e72 d0e84 ">Defined '1'</td>
<td valign="middle" width="26.13065326633166%" headers="d0e74 d0e86 ">Use existing <span class="keyword">i5/OS</span> PASE environment </td>
</tr>
</tbody>
</table>
</div>
<p>* "Not defined" means that QIBM_JAVA_PASE_ALLOW_PREV is either not included
or has a value other than 1.</p>
<p>The last two rows in the previous table indicate situations where it is
useful to set QIBM_JAVA_PASE_ALLOW_PREV. The JVM checks QIBM_JAVA_PASE_ALLOW_PREV
when an <span class="keyword">i5/OS</span> PASE environment already exists and you have defined QIBM_JAVA_PASE_STARTUP.
Otherwise, the JVM ignores QIBM_JAVA_PASE_ALLOW_PREV.</p>
<p>The QIBM_JAVA_PASE_ALLOW_PREV and QIBM_JAVA_PASE_CHILD_STARTUP environment
variables are independent of each other.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahapasejavaenvvariables.htm" title="The Java virtual machine (JVM) uses the following variables to start i5/OS PASE environments. You need to set the QIBM_JAVA_PASE_STARTUP variable in order to run the IBM i5/OS PASE native method for Java example.">Java i5/OS PASE environment variables</a></div>
</div>
</div>
</body>
</html>