85 lines
5.7 KiB
HTML
85 lines
5.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="Call i5/OS programs and procedures from your i5/OS PASE programs" />
|
||
|
|
<meta name="abstract" content="i5/OS PASE provides methods for calling ILE procedures, Java programs, OPM programs, i5/OS APIs, and CL commands that give you integrated access to i5/OS functions." />
|
||
|
|
<meta name="description" content="i5/OS PASE provides methods for calling ILE procedures, Java programs, OPM programs, i5/OS APIs, and CL commands that give you integrated access to i5/OS functions." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzalfusing.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzalfcallile.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzalfcallprog.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzalfcallcl.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzalfservices.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2000, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzalfamongpgms" />
|
||
|
|
<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>Call i5/OS programs
|
||
|
|
and procedures from your i5/OS PASE
|
||
|
|
programs</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzalfamongpgms"><a name="rzalfamongpgms"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Call <span class="keyword">i5/OS</span> programs
|
||
|
|
and procedures from your <span class="keyword">i5/OS</span> PASE
|
||
|
|
programs</h1>
|
||
|
|
<div><p><span class="keyword">i5/OS™</span> PASE provides
|
||
|
|
methods for calling ILE procedures, Java™ programs, OPM programs, <span class="keyword">i5/OS</span> APIs,
|
||
|
|
and CL commands that give you integrated access to <span class="keyword">i5/OS</span> functions.</p>
|
||
|
|
<div class="section"><h4 class="sectiontitle">General configuration requirements for <span class="keyword">i5/OS</span> programs
|
||
|
|
and procedures</h4><p>When you make calls from the <span class="keyword">i5/OS</span> PASE
|
||
|
|
program environment to the <span class="keyword">i5/OS</span> environment,
|
||
|
|
you should generally ensure that the <span class="keyword">i5/OS</span> program
|
||
|
|
is compiled with *CALLER for the activation group, for the following reasons:</p>
|
||
|
|
<ul><li>Only code that runs in the activation group that started <span class="keyword">i5/OS</span> PASE
|
||
|
|
(called by the Qp2RunPase API) can use ILE APIs, such as Qp2CallPase, to interact
|
||
|
|
with the <span class="keyword">i5/OS</span> PASE program.</li>
|
||
|
|
<li>The ILE runtime might end the entire job (also ending <span class="keyword">i5/OS</span> PASE)
|
||
|
|
if it needs to destroy an activation group in a multithreaded job (and all
|
||
|
|
jobs created by <span class="keyword">i5/OS</span> PASE <tt>fork</tt> are
|
||
|
|
multithread-capable). By using ACTGRP(*CALLER), you can prevent your job from
|
||
|
|
ending before you want it to end.</li>
|
||
|
|
</ul>
|
||
|
|
<p>You can avoid problems with running in a multithread-capable job by
|
||
|
|
using the <span class="apiname">systemCL()</span> runtime function to run a CL command
|
||
|
|
(including the CALL command) in a separate job that is not multithread-capable.</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="rzalfcallile.htm">Call ILE procedures</a></strong><br />
|
||
|
|
You can follow the instructions in this topic to prepare and call
|
||
|
|
ILE procedures from your <span class="keyword">i5/OS</span> PASE
|
||
|
|
programs.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzalfcallprog.htm">Call i5/OS programs from i5/OS PASE</a></strong><br />
|
||
|
|
You can take advantage of existing <span class="keyword">i5/OS</span> programs
|
||
|
|
(*PGM objects) when you create your <span class="keyword">i5/OS</span> PASE
|
||
|
|
applications. In addition, you can use the systemCL() function to run the
|
||
|
|
CL CALL command.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzalfcallcl.htm">Run i5/OS commands from i5/OS PASE</a></strong><br />
|
||
|
|
You can extend the capabilities of your <span class="keyword">i5/OS</span> PASE
|
||
|
|
program by running control language (CL) commands that use <span class="keyword">i5/OS</span> functions.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzalfusing.htm" title="Your i5/OS PASE program can call other i5/OS programs running in your job, and other i5/OS programs can call procedures in your i5/OS PASE program.">Use i5/OS PASE programs in the i5/OS environment</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="rzalfservices.htm" title="If you want your AIX application to take advantage of i5/OS functions that are not directly supported by system-supplied i5/OS PASE shared libraries, you need to perform some additional steps to prepare your application.">Customize i5/OS PASE programs to use i5/OS functions</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|