ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalf_5.4.0.1/rzalfheaders.htm

130 lines
8.1 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="reference" />
<meta name="DC.Title" content="Copy header files" />
<meta name="abstract" content="You can follow the instructions in this topic to copy header files from your iSeries server to an AIX machine." />
<meta name="description" content="You can follow the instructions in this topic to copy header files from your iSeries server to an AIX machine." />
<meta name="DC.Relation" scheme="URI" content="rzalfservices.htm" />
<meta name="DC.Relation" scheme="URI" content="rzalfcallile.htm" />
<meta name="DC.Relation" scheme="URI" content="rzalfdatabase.htm" />
<meta name="DC.Relation" scheme="URI" content="rzalfcopying.htm" />
<meta name="DC.Relation" scheme="URI" content="rzalfamongpgms.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="rzalfheaders" />
<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>Copy header files</title>
</head>
<body id="rzalfheaders"><a name="rzalfheaders"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Copy header files</h1>
<div><p>You can follow the instructions in this topic to copy header files
from your iSeries™ server
to an AIX<sup>®</sup> machine.</p>
<div class="section"><p><span class="keyword">i5/OS™</span> PASE
augments standard AIX run time with header files for i5/OS system-unique
support. These are provided by <span class="keyword">i5/OS</span> PASE
and the <span class="keyword">i5/OS</span> operating
system.</p>
</div>
<div class="section"><h4 class="sectiontitle">Copy the header files from your iSeries server
to an AIX machine
in the header file search path</h4><p>You can copy the
header file into the /usr/include AIX directory, or to any other directory
on the header file search path for your compiler. </p>
<p>If you use a directory
other than /usr/include, you can add it to the header file search path with
the <tt>-I</tt> option on the AIX compiler command.</p>
</div>
<div class="section" id="rzalfheaders__paseheads"><a name="rzalfheaders__paseheads"><!-- --></a><h4 class="sectiontitle">Copy <span class="keyword">i5/OS</span> PASE
header files</h4><p>The <span class="keyword">i5/OS</span> PASE
header files are located in the following <span class="keyword">i5/OS</span> directory:</p>
<p>/QOpenSys/QIBM/ProdData/OS400/PASE/include</p>
<p><span class="keyword">i5/OS</span> PASE provides
the following header files:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr valign="bottom"><th valign="bottom" width="21%" id="d0e99">Header file</th>
<th valign="bottom" width="79%" id="d0e101">Explanation</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="21%" headers="d0e99 ">as400_protos.h</td>
<td valign="top" width="79%" headers="d0e101 ">This header file provides miscellaneous <span class="keyword">i5/OS</span> PASE
system-unique functions to ILE.</td>
</tr>
<tr><td valign="top" width="21%" headers="d0e99 ">as400_types.h</td>
<td valign="top" width="79%" headers="d0e101 ">This header file declares unique <span class="keyword">i5/OS</span> parameter
types for calls to ILE. <p>This header file declares type <tt>ILEpointer</tt> for
16-byte machine interface (MI) pointers, which relies on type long double
to be a 128-bit field.</p>
<p>Other types declared in as400_types.h rely on
type long long to be a 64-bit integer. AIX compilers must be run with options <tt>-qlngdbl128</tt>, <tt>-qalign=natural</tt>,
and <tt>-qlonglong</tt> to ensure proper size and alignment of types declared
in as400_types.h.</p>
</td>
</tr>
<tr><td valign="top" width="21%" headers="d0e99 ">os400msg.h</td>
<td valign="top" width="79%" headers="d0e101 ">This header file declares the functions to send and receive <span class="keyword">i5/OS</span> messages.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="rzalfheaders__sysheads"><a name="rzalfheaders__sysheads"><!-- --></a><h4 class="sectiontitle">Copy <span class="keyword">i5/OS</span> header
files</h4><p>If you plan to access other <span class="keyword">i5/OS</span> functions
in your <span class="keyword">i5/OS</span> PASE application,
you might find it helpful to copy to your development machine the header files
for the <span class="keyword">i5/OS</span> functions
that you are using. Note that generally you cannot run an <span class="keyword">i5/OS</span> program
or procedure directly from an <span class="keyword">i5/OS</span> PASE
application. See Call <span class="keyword">i5/OS</span> programs
and procedures from your <span class="keyword">i5/OS</span> PASE
programs for more information.</p>
<p>i5/OS system-provided header files are
located in the /QIBM/include directory:</p>
<p>If your application needs any
of the <span class="keyword">i5/OS</span> API header
files, you must first convert them from EBCDIC to ASCII before you copy the
converted files to an AIX directory.</p>
<p>One way to convert an EBCDIC text
file to ASCII is to use the <span class="keyword">i5/OS</span> PASE <tt>Rfile</tt> utility.</p>
<p>The
following example uses the <span class="keyword">i5/OS</span> PASE <tt>Rfile</tt> utility
to read <span class="keyword">i5/OS</span> header file
/QIBM/include/qusec.h, convert the data to the <span class="keyword">i5/OS</span> PASE
coded character set identifier (CCSID), strip trailing blanks from each line,
and then write the result into byte stream file <tt>ascii_qusec.h</tt>:</p>
<p>Rfile
-r /QIBM/include/qusec.h &gt; ascii_qusec.h</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <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 class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzalfdatabase.htm" title="i5/OS PASE supports the DB2 UDB for iSeries Call Level Interface (CLI). DB2 CLI on AIX and i5/OS are not proper subsets of each other, so there are minor differences in a few interfaces, and some APIs in one implementation might not exist in another.">Database</a></div>
<div><a href="rzalfamongpgms.htm" title="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.">Call i5/OS programs and procedures from your i5/OS PASE programs</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="rzalfcallile.htm" title="You can follow the instructions in this topic to prepare and call ILE procedures from your i5/OS PASE programs.">Call ILE procedures</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rzalfcopying.htm" title="Copy AIX binaries that you want to run in i5/OS PASE into the integrated file system.">Copy the i5/OS PASE program to your iSeries server</a></div>
</div>
</div>
</body>
</html>