<?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="Network selection APIs" /> <meta name="abstract" content="These APIs provide the means to choose the transport on which an application should run." /> <meta name="description" content="These APIs provide the means to choose the transport on which an application should run." /> <meta name="DC.Relation" scheme="URI" content="rzaaxtirpc.htm" /> <meta name="DC.Relation" scheme="URI" content="../apifinder/finder.htm" /> <meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" /> <meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" /> <meta name="DC.Format" content="XHTML" /> <meta name="DC.Identifier" content="rzaaxnetselect" /> <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>Network selection APIs</title> </head> <body id="rzaaxnetselect"><a name="rzaaxnetselect"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">Network selection APIs</h1> <div><p>These APIs provide the means to choose the transport on which an application should run.</p> <div class="section"><p>These APIs require that *STMF /etc/netconfig file exist on the system. If the netconfig file does not exist in the /etc directory, the user must copy it from /QIBM/ProdData/OS400/RPC directory. The netconfig file is always in the /QIBM/ProdData/OS400/RPC directory.</p> </div> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e24">API</th> <th align="left" valign="bottom" width="66.66666666666666%" id="d0e26">Description</th> </tr> </thead> <tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e24 "><span class="apiname">endnetconfig()</span></td> <td align="left" valign="top" width="66.66666666666666%" headers="d0e26 ">Releases the pointer to the records stored in the netconfig file</td> </tr> <tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e24 "><span class="apiname">freenetconfigent()</span> </td> <td align="left" valign="top" width="66.66666666666666%" headers="d0e26 ">Frees the netconfig structure that is returned from the call to the getnetconfigent() function</td> </tr> <tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e24 "><span class="apiname">getnetconfig()</span></td> <td align="left" valign="top" width="66.66666666666666%" headers="d0e26 ">Returns the pointer to the current record in the netconfig file and increments its pointer to the next record</td> </tr> <tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e24 "><span class="apiname">getnetconfigent()</span></td> <td align="left" valign="top" width="66.66666666666666%" headers="d0e26 ">Returns the pointer to the netconfig structure that corresponds to the input netid</td> </tr> <tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e24 "><span class="apiname">setnetconfig()</span></td> <td align="left" valign="top" width="66.66666666666666%" headers="d0e26 ">Initializes the record pointer to the first entry in the netconfig file. The <span class="apiname">setnetconfig()</span> function must be used before the first use of <span class="apiname">getnetconfig()</span> function. The <span class="apiname">setnetconfig()</span> function returns a unique handle (a pointer to the records stored in the netconfig file) to be used by the <span class="apiname">getnetconfig()</span> function.</td> </tr> </tbody> </table> </div> </div> <div> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="rzaaxtirpc.htm" title="Developed by Sun Microsystems, remote procedure call (RPC) easily separates and distributes client applications from a server mechanism.">Transport-independent remote procedure call</a></div> </div> <div class="relinfo"><strong>Related information</strong><br /> <div><a href="../apifinder/finder.htm">API finder</a></div> </div> </div> </body> </html>