140 lines
10 KiB
HTML
140 lines
10 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="API concepts" />
|
|
<meta name="abstract" content="Describes the underlying concepts that you need to understand to work effectively with APIs. Among the concepts covered are basic concepts, programming considerations, and terminology." />
|
|
<meta name="description" content="Describes the underlying concepts that you need to understand to work effectively with APIs. Among the concepts covered are basic concepts, programming considerations, and terminology." />
|
|
<meta name="DC.Relation" scheme="URI" content="api.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="aboutapis.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="apiterminology.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="genericlibname.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conVerbs.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="lang.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conEnvironment.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="cmnCommon.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conParameter.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conQSYSINC.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conObject.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="data.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conInternalID.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conUSRV.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conContinuation.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="listOverview.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conDomain.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conExitProg.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conIndexCons.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conPerformance.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="conInternalObj.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="oli.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="pns.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="concept" />
|
|
<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>API concepts</title>
|
|
</head>
|
|
<body id="concept"><a name="concept"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">API concepts</h1>
|
|
<div><p>Describes the underlying concepts that you need to understand to
|
|
work effectively with APIs. Among the concepts covered are basic concepts,
|
|
programming considerations, and terminology.</p>
|
|
<p>An application programming interface (API) is defined as a functional interface
|
|
supplied by the operating system or a separately orderable licensed program
|
|
that allows an application program written in a high-level language to use
|
|
specific data or functions of the operating system or the licensed program.
|
|
Some APIs provide the same functions as control language (CL) commands and
|
|
output file support. Some APIs provide functions that CL commands do not.
|
|
Most APIs work more quickly and use less system overhead than the CL commands.</p>
|
|
<p>APIs allow you to:</p>
|
|
<ul><li>Provide better performance when getting system information or when using
|
|
system functions provided by control language (CL) commands or file support.</li>
|
|
<li>Use system information and functions that are not available through CL
|
|
commands.</li>
|
|
<li>Use calls from high-level languages to these interfaces.</li>
|
|
<li>Access to system functions at a lower level than what was initially provided
|
|
on the system.</li>
|
|
</ul>
|
|
<p>Finally, data is often easier to work with when returned to you by an API.</p>
|
|
<p>For information about using APIs, see the following:</p>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="aboutapis.htm">About application programming interfaces (APIs)</a></strong><br />
|
|
Describes most of the iSeries™ application programming interfaces
|
|
(APIs), as well as some APIs for related products that can be used on iSeries™ servers.</li>
|
|
<li class="ulchildlink"><strong><a href="apiterminology.htm">API terminology</a></strong><br />
|
|
Before using the iSeries™ APIs, you should be familiar with several
|
|
terms. These terms refer to <span class="keyword">i5/OS™</span> objects.</li>
|
|
<li class="ulchildlink"><strong><a href="genericlibname.htm">Generic library names</a></strong><br />
|
|
These special values refer to i5/OS™ libraries, and you can often use
|
|
them in API calls in place of specific library names.</li>
|
|
<li class="ulchildlink"><strong><a href="conVerbs.htm">OPM and ILE API verbs and abbreviations</a></strong><br />
|
|
The two to three letters following the APIs make up an internal component identifier. The last part of the API name identifies the action or function of the API. The information after the component ID is an abbreviation of the verb that describes the function of the API.</li>
|
|
<li class="ulchildlink"><strong><a href="lang.htm">Language selection considerations</a></strong><br />
|
|
You can use APIs with all the languages available on iSeries™ business
|
|
computing systems, except for the ILE APIs.</li>
|
|
<li class="ulchildlink"><strong><a href="conEnvironment.htm">API environments</a></strong><br />
|
|
This topic introduces the operating environments that <span class="keyword">i5/OS™</span> APIs exist on a system.</li>
|
|
<li class="ulchildlink"><strong><a href="cmnCommon.htm">API information format</a></strong><br />
|
|
API names contain verbs that are similar to the <span class="keyword">i5/OS™</span> licensed
|
|
program: change, create, remove, and retrieve.</li>
|
|
<li class="ulchildlink"><strong><a href="conParameter.htm">API parameters</a></strong><br />
|
|
After you have found the API that you want to use, you need to code a call to an API and pass to the API the required set of parameters appropriate for that API.</li>
|
|
<li class="ulchildlink"><strong><a href="conQSYSINC.htm">Include files and the QSYSINC library</a></strong><br />
|
|
The QSYSINC (system include) library provides all source includes
|
|
for APIs shipped with i5/OS™.</li>
|
|
<li class="ulchildlink"><strong><a href="conObject.htm">Internal object types</a></strong><br />
|
|
This topic provides the i5/OS™ internal object types and their corresponding
|
|
predefined values.</li>
|
|
<li class="ulchildlink"><strong><a href="data.htm">Data types</a></strong><br />
|
|
APIs support character data and binary data.</li>
|
|
<li class="ulchildlink"><strong><a href="conInternalID.htm">Internal identifiers</a></strong><br />
|
|
You know of jobs, spooled files, and so forth, by their names. The system uses an ID that is associated with the name. The ID is assigned based on usage.</li>
|
|
<li class="ulchildlink"><strong><a href="conUSRV.htm">User spaces and receiver variables</a></strong><br />
|
|
APIs that return information to a caller generally return the information
|
|
in a <em>user space</em> (used by list APIs) or a <em>receiver variable</em> (used
|
|
by retrieve APIs).</li>
|
|
<li class="ulchildlink"><strong><a href="conContinuation.htm">Continuation handle</a></strong><br />
|
|
Some APIs that return information offer a continuation handle.</li>
|
|
<li class="ulchildlink"><strong><a href="listOverview.htm">List APIs overview</a></strong><br />
|
|
List APIs return a list unique to a given API. The section discusses the characteristics of a list API and provides information that you should be aware of when you use list APIs.</li>
|
|
<li class="ulchildlink"><strong><a href="conDomain.htm">Domain concepts</a></strong><br />
|
|
All objects are assigned a domain attribute when they are created.</li>
|
|
<li class="ulchildlink"><strong><a href="conExitProg.htm">Exit programs</a></strong><br />
|
|
Exit programs are called and given control by an application program
|
|
or system program. They can be used to customize particular functions to your
|
|
needs. An <em>exit program</em> is a program to which control is passed from
|
|
a calling program.</li>
|
|
<li class="ulchildlink"><strong><a href="conIndexCons.htm">User index considerations</a></strong><br />
|
|
The performance of a user index is much better than that of a database file. However, before using a user index, you must know the functional differences between a user index and a database file.</li>
|
|
<li class="ulchildlink"><strong><a href="conPerformance.htm">Performance considerations</a></strong><br />
|
|
The retrieve APIs allow you to control the performance cost for information you retrieve.</li>
|
|
<li class="ulchildlink"><strong><a href="conInternalObj.htm">APIs and internal system objects</a></strong><br />
|
|
APIs retrieve information from internal system objects.</li>
|
|
<li class="ulchildlink"><strong><a href="oli.htm">Open list information format</a></strong><br />
|
|
The format of the open list information is common across many of the open list APIs.</li>
|
|
<li class="ulchildlink"><strong><a href="pns.htm">Path name format</a></strong><br />
|
|
The path name format is common across application programming interfaces that work with objects that are supported across file systems. These APIs require a path name to identify the object with which the API will work.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="api.htm">Application programming interfaces</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |