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

150 lines
9.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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_CHILD_STARTUP" />
<meta name="abstract" content="The QIBM_JAVA_PASE_CHILD_STARTUP environment variable indicates the i5/OS PASE startup program for any secondary JVMs." />
<meta name="description" content="The QIBM_JAVA_PASE_CHILD_STARTUP environment variable indicates the i5/OS PASE startup program for any secondary JVMs." />
<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="rzahapaseexmplschildstartup" />
<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_CHILD_STARTUP</title>
</head>
<body id="rzahapaseexmplschildstartup"><a name="rzahapaseexmplschildstartup"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Using QIBM_JAVA_PASE_CHILD_STARTUP</h1>
<div><p>The QIBM_JAVA_PASE_CHILD_STARTUP environment variable indicates
the <span class="keyword">i5/OS™</span> PASE startup
program for any secondary JVMs.</p>
<p>Use QIBM_JAVA_PASE_CHILD_STARTUP when all of the following conditions are
true: </p>
<ul><li>The Java™ application that you want to run creates Java virtual
machines (JVMs) through Java calls to Runtime.exec()</li>
<li>Both the primary and secondary JVMs use <span class="keyword">i5/OS</span> PASE
native methods</li>
<li>The <span class="keyword">i5/OS</span> PASE environment
of the secondary JVMs must be different than the <span class="keyword">i5/OS</span> PASE
environment of the primary JVM</li>
</ul>
<p> When all of the previously listed conditions are true, perform the following
actions:</p>
<ul><li>Set the QIBM_JAVA_PASE_CHILD_STARTUP environment variable to the <span class="keyword">i5/OS</span> PASE startup program of the
secondary JVMs.</li>
<li>When starting the primary JVM from an iSeries™ command prompt or Qshell command
prompt, set the QIBM_JAVA_PASE_STARTUP environment variable to the <span class="keyword">i5/OS</span> PASE startup program of the
primary JVM. <div class="note"><span class="notetitle">Note:</span> When starting the primary JVM from an <span class="keyword">i5/OS</span> PASE
terminal session, do not set QIBM_JAVA_PASE_STARTUP.</div>
</li>
</ul>
<p> The process of the secondary JVM inherits the QIBM_JAVA_PASE_CHILD_STARTUP
environment variable. In addition, <span class="keyword">i5/OS</span> sets
the QIBM_JAVA_PASE_STARTUP environment variable of the secondary JVM process
to the value of the QIBM_JAVA_PASE_CHILD_STARTUP environment variable from
the parent process.</p>
<p>The following table identifies the resulting <span class="keyword">i5/OS</span> PASE
environments (if any) for the various combinations of command environments
and definitions of QIBM_JAVA_PASE_STARTUP and QIBM_JAVA_PASE_CHILD_STARTUP:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><caption>Table 1. Resulting PASE environments for QIBM_JAVA_PASE_STARTUP
and QIBM_JAVA_PASE_CHILD_STARTUP</caption><thead align="left"><tr valign="bottom"><th colspan="3" align="center" valign="bottom" id="d0e94">Starting environment</th>
<th colspan="2" align="center" valign="bottom" id="d0e96">Resulting behavior</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="19.71252566735113%" headers="d0e94 "><strong>Command environment</strong></td>
<td valign="top" width="21.149897330595483%" headers="d0e94 "><strong>QIBM_JAVA _PASE_STARTUP </strong></td>
<td valign="top" width="19.301848049281315%" headers="d0e94 "><strong>Primary JVM <span class="keyword">i5/OS</span> PASE
Startup</strong></td>
<td valign="top" width="19.917864476386036%" headers="d0e96 "><strong>Primary JVM <span class="keyword">i5/OS</span> PASE
Startup </strong></td>
<td valign="top" width="19.917864476386036%" headers="d0e96 "><strong>Secondary JVM <span class="keyword">i5/OS</span> PASE
Startup </strong></td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 ">CL or QSH</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Defined startX</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Defined startY</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startX</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startY</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 ">CL or QSH</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Defined startX</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startX</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startX</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 ">CL or QSH</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Defined startY</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">No <span class="keyword">i5/OS</span> PASE
environment</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startY</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 ">CL or QSH</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">No <span class="keyword">i5/OS</span> PASE
environment</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">No <span class="keyword">i5/OS</span> PASE
environment</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 "><span class="keyword">i5/OS</span> PASE
terminal session</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Defined startX</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Defined startY</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Not allowed*</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Not allowed*</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 "><span class="keyword">i5/OS</span> PASE
terminal session</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Defined startX</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Not allowed*</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Not allowed*</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 "><span class="keyword">i5/OS</span> PASE
terminal session</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Defined startY</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use <span class="keyword">i5/OS</span> PASE
terminal session environment</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use startY</td>
</tr>
<tr valign="middle"><td valign="middle" width="19.71252566735113%" headers="d0e94 "><span class="keyword">i5/OS</span> PASE
terminal session</td>
<td valign="middle" width="21.149897330595483%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.301848049281315%" headers="d0e94 ">Not defined</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">Use <span class="keyword">i5/OS</span> PASE
terminal session environment</td>
<td valign="middle" width="19.917864476386036%" headers="d0e96 ">No <span class="keyword">i5/OS</span> PASE
environment</td>
</tr>
</tbody>
</table>
</div>
<p>* The rows marked "Not allowed" indicate situations where the QIBM_JAVA_PASE_STARTUP
environment variable could conflict with the <span class="keyword">i5/OS</span> PASE
terminal session. Because of the potential conflict, using QIBM_JAVA_PASE_STARTUP
is not allowed from an <span class="keyword">i5/OS</span> PASE
terminal session.</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>