100 lines
7.7 KiB
HTML
100 lines
7.7 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="IBM i5/OS PASE native methods for Java" />
|
|
<meta name="abstract" content="The iSeries Java virtual machine (JVM) supports the use of native methods running in the i5/OS PASE environment. Prior to V5R2, the native iSeries JVM used only ILE native methods." />
|
|
<meta name="description" content="The iSeries Java virtual machine (JVM) supports the use of native methods running in the i5/OS PASE environment. Prior to V5R2, the native iSeries JVM used only ILE native methods." />
|
|
<meta name="DC.Relation" scheme="URI" content="../rzalf/rzalfintro.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="othlang.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="jni.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahateraspacemain.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="ilejava.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="javalang.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="interpro.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahapasejavaenvvariables.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahapaseerrors.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahapaseexmplslibrary.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzahapaseexmpls.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="rzahapaseexmplsmain" />
|
|
<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>IBM i5/OS PASE native methods for Java</title>
|
|
</head>
|
|
<body id="rzahapaseexmplsmain"><a name="rzahapaseexmplsmain"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">IBM<sup>®</sup> <span class="keyword">i5/OS</span> PASE native methods for Java</h1>
|
|
<div><p>The iSeries™ Java™ virtual
|
|
machine (JVM) supports the use of native methods running in the <span class="keyword">i5/OS™</span> PASE
|
|
environment. Prior to V5R2, the native iSeries JVM used only ILE native methods.</p>
|
|
<p>Support for <span class="keyword">i5/OS</span> PASE
|
|
native methods includes:</p>
|
|
<ul><li>Full use of the native iSeries Java Native Interface (JNI) from <span class="keyword">i5/OS</span> PASE native methods</li>
|
|
<li>The ability to call <span class="keyword">i5/OS</span> PASE
|
|
native methods from the native iSeries JVM</li>
|
|
</ul>
|
|
<p>This new support enables you to easily port your Java applications
|
|
that run in AIX<sup>®</sup> to
|
|
your iSeries server.
|
|
You can copy the class files and AIX native method libraries to the integrated
|
|
file system on the iSeries and run them from any of the control language
|
|
(CL), Qshell or <span class="keyword">i5/OS</span> PASE
|
|
terminal session command prompts.</p>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzahapasejavaenvvariables.htm">Java i5/OS PASE environment variables</a></strong><br />
|
|
The Java virtual machine (JVM) uses the following variables
|
|
to start <span class="keyword">i5/OS</span> PASE environments.
|
|
You need to set the QIBM_JAVA_PASE_STARTUP variable in order to run the IBM<sup>®</sup> <span class="keyword">i5/OS</span> PASE native method for Java example.</li>
|
|
<li class="ulchildlink"><strong><a href="rzahapaseerrors.htm">Java i5/OS PASE error codes</a></strong><br />
|
|
To help you troubleshoot <span class="keyword">i5/OS</span> PASE
|
|
native methods, this topic describes error conditions that are indicated by <span class="keyword">i5/OS</span> job log messages and Java runtime
|
|
exceptions. The following lists describe errors that you may encounter at
|
|
start up or at run time when using <span class="keyword">i5/OS</span> PASE
|
|
native methods for Java.</li>
|
|
<li class="ulchildlink"><strong><a href="rzahapaseexmplslibrary.htm">Managing native method libraries</a></strong><br />
|
|
To use native method libraries, especially when you want to manage
|
|
multiple versions of a native method library on your iSeries server, you need to understand
|
|
both the Java library naming conventions and the library search
|
|
algorithm.</li>
|
|
<li class="ulchildlink"><strong><a href="rzahapaseexmpls.htm">Example: IBM i5/OS PASE native method for Java</a></strong><br />
|
|
The IBM<sup>®</sup> <span class="keyword">i5/OS</span> PASE native method for Java example
|
|
calls an instance of a native C method that then uses Java Native
|
|
Interface (JNI) to call back into Java code. Rather than accessing the string
|
|
directly from Java code, the example calls a native method that then
|
|
calls back into Java through JNI to get the string value. </li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="othlang.htm" title="With Java, you have multiple ways to call code that was written in languages other than Java.">Java with other programming languages</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzahateraspacemain.htm" title="The iSeries Java virtual machine (JVM) now supports the use of teraspace storage model native methods. The teraspace storage model provides a large process-local address environment for ILE programs. Using teraspace allows you to port native method code from other operating systems to i5/OS with little or no source code changes.">Teraspace storage model native methods for Java</a></div>
|
|
<div><a href="ilejava.htm" title="The Java environment on an iSeries server is separate from the integrated language environment (ILE). Java is not an ILE language, and it cannot bind to ILE object modules to create programs or service programs on an iSeries server.">Comparison of Integrated Language Environment and Java</a></div>
|
|
<div><a href="javalang.htm" title="Use the java.lang.Runtime.exec method to call programs or commands from within your Java program. Using java.lang.Runtime.exec() method creates one or more additional thread-enabled jobs. The additional jobs process the command string that you pass on the method.">Use java.lang.Runtime.exec()</a></div>
|
|
<div><a href="interpro.htm" title="When communicating with programs that are running in another process, there are a number of options.">Interprocess communications</a></div>
|
|
</div>
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
|
<div><a href="jni.htm" title="You should only use native methods in cases where pure Java cannot meet your programming needs.">Use the Java Native Interface for native methods</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../rzalf/rzalfintro.htm" target="_blank" title="This information assumes you are already familiar with i5/OS PASE. If you are not yet familiar with PASE, see this topic to learn more using IBM i5/OS PASE native methods with Java."><span class="keyword">i5/OS</span> PASE</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |