<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation"> <title>List PPP Connection Profiles (QtocLstPPPCnnPrf) API</title> <!-- Begin Header Records ========================================= --> <!-- 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. --> <!-- COMM4 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2DCIJB at --> <!-- RCHVMW2 on 1 Jun 1999 at 17:32:50 --> <!-- Change history: --> <!-- 030512 CGLOE: Added Start with TCP/IP attribute DCR 99516 --> <!-- 050824 CGLOE: Added Thread ID for DCR 99895 --> <!--File Edited December, 2001 ===================================== --> <!--End Header Records ============================================= --> <link rel="stylesheet" type="text/css" href="../rzahg/ic.css"> </head> <body> <a name="Top_Of_Page"></a> <!-- Java sync-link ================================================ --> <script type="text/javascript" language="Javascript" src="../rzahg/synch.js"> </script> <h2>List PPP Connection Profiles (QtocLstPPPCnnPrf) API</h2> <div class="box" style="width: 60%;"> Required Parameter Group:<br> <!-- iddvc RMBR --> <br> <table width="100%"> <tr> <td align="center" valign="top" width="10%">1</td> <td align="left" valign="top" width="50%">Qualified user space name</td> <td align="left" valign="top" width="20%">Input</td> <td align="left" valign="top" width="20%">Char(20)</td> </tr> <tr> <td align="center" valign="top">2</td> <td align="left" valign="top">Format name</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Char(8)</td> </tr> <tr> <td align="center" valign="top">3</td> <td align="left" valign="top">Error Code</td> <td align="left" valign="top">I/O</td> <td align="left" valign="top">Char(*)</td> </tr> </table> <br> Service Program: QTOCPPPAPI<br> <!-- iddvc RMBR --> <br> Threadsafe: Yes<br> <!-- iddvc RMBR --> <br> </div> <p>The List PPP Connection Profiles API (QtocLstPPPCnnPrf) returns a list of PPP connection profiles with some basic information about each profile.</p> <br> <h3>Authorities and Locks</h3> <dl> <dt><em>User Space Library Authority</em></dt> <dd>*EXECUTE</dd> <dt><em>User Space Authority</em></dt> <dd>*CHANGE</dd> <dt><em>User Space Lock</em></dt> <dd>*SHRNUP</dd> </dl> <br> <h3>Required Parameter Group</h3> <dl> <dt><strong>Qualified user space name</strong></dt> <dd>INPUT; CHAR(20) <p>The user space for which you want to retrieve information, and the library in which it is located. The first 10 characters contain the user space name, and the second 10 characters contain the library name. You can use these special values for the library name:</p> <table cellpadding="3"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>*CURLIB</em></td> <td valign="top">The job's current library</td> </tr> <tr> <td align="left" valign="top"><em>*LIBL</em></td> <td valign="top">The library list</td> </tr> </table> <br> </dd> <dt><strong>Format name</strong></dt> <dd>INPUT; CHAR(8) <p>The format of the space information to be returned. The format names supported are:</p> <table cellpadding="3"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>PRFD0100</em></td> <td valign="top">Connection profile lists. Refer to <a href="#HDRSPCA0"> PRFD0100 Format</a> for details on the format.</td> </tr> </table> <br> </dd> <dt><strong>Error code</strong></dt> <dd>I/O; CHAR(*) <p>The structure in which to return error information. For the format of the structure, see <a href="../apiref/error.htm#hdrerrcod">Error code parameter</a>.</p> </dd> </dl> <br> <h3>Format of Connection Profile Lists</h3> <p>To request a list of PPP Connection Profiles, use format PRFD0100.</p> <p>The PPP Connection Profile list consists of:</p> <ul> <li>A user area </li> <li>A generic header </li> <li>An input parameter section </li> <li>A header section </li> <li>A list data section: <ul> <li>PRFD0100 format</li> </ul> </li> </ul> <p>For details about the user area and generic header, see <a href="../apiref/usf.htm"> User Space Format for List APIs</a>. For details about the remaining items, see the following sections.</p> <p>When you retrieve list entry information from a user space, you must use the entry size returned in the generic header. The size of each entry may be padded at the end. If you do not use the entry size, the result may not be valid. For examples of how to process lists, see API <a href="../apiref/apiexmp.htm"> Examples</a>.</p> <br> <h3>Input Parameter Section</h3> <table border width="80%"> <tr> <th align="center" valign="bottom" colspan="2">Offset</th> <th align="left" valign="bottom" rowspan="2">Type</th> <th align="left" valign="bottom" rowspan="2">Field</th> </tr> <tr> <th align="center" valign="bottom">Dec</th> <th align="center" valign="bottom">Hex</th> </tr> <tr> <td align="center" valign="top" width="10%">0</td> <td align="center" valign="top" width="10%">0</td> <td align="left" valign="top" width="20%">CHAR(10)</td> <td align="left" valign="top" width="60%">User space name specified</td> </tr> <tr> <td align="center" valign="top">10</td> <td align="center" valign="top">A</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">User space library name specified</td> </tr> <tr> <td align="center" valign="top">20</td> <td align="center" valign="top">14</td> <td align="left" valign="top">CHAR(8)</td> <td align="left" valign="top">Format name specified</td> </tr> </table> <br> <br> <h3>Header Section</h3> <table border width="80%"> <tr> <th align="center" valign="bottom" colspan="2">Offset</th> <th align="left" valign="bottom" rowspan="2">Type</th> <th align="left" valign="bottom" rowspan="2">Field</th> </tr> <tr> <th align="center" valign="bottom">Dec</th> <th align="center" valign="bottom">Hex</th> </tr> <tr> <td align="center" valign="top" width="10%">0</td> <td align="center" valign="top" width="10%">0</td> <td align="left" valign="top" width="20%">CHAR(10)</td> <td align="left" valign="top" width="60%">User space name</td> </tr> <tr> <td align="center" valign="top">10</td> <td align="center" valign="top">A</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">User space library name used</td> </tr> </table> <br> <br> <h3><a name="HDRSPCA0">PRFD0100 Format</a></h3> <p>The following data about a PPP Connection Profile is returned for the PRFD0100 format. For detailed descriptions of the fields in the table, see <a href="#HDRSPCA2">Field Descriptions</a>.</p> <table border width="80%"> <tr> <th align="center" valign="bottom" colspan="2">Offset</th> <th align="left" valign="bottom" rowspan="2">Type</th> <th align="left" valign="bottom" rowspan="2">Field</th> </tr> <tr> <th align="center" valign="bottom">Dec</th> <th align="center" valign="bottom">Hex</th> </tr> <tr> <td align="center" valign="top" width="10%">0</td> <td align="center" valign="top" width="10%">0</td> <td align="left" valign="top" width="20%">BINARY(4)</td> <td align="left" valign="top" width="60%">Profile mode</td> </tr> <tr> <td align="center" valign="top">4</td> <td align="center" valign="top">4</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Connection protocol</td> </tr> <tr> <td align="center" valign="top">8</td> <td align="center" valign="top">8</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Connection status</td> </tr> <tr> <td align="center" valign="top">12</td> <td align="center" valign="top">C</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Connection type</td> </tr> <tr> <td align="center" valign="top">16</td> <td align="center" valign="top">10</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Profile job type</td> </tr> <tr> <td align="center" valign="top">20</td> <td align="center" valign="top">14</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Multilink connection enabled</td> </tr> <tr> <td align="center" valign="top">24</td> <td align="center" valign="top">18</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Profile name</td> </tr> <tr> <td align="center" valign="top">34</td> <td align="center" valign="top">22</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Line name</td> </tr> <tr> <td align="center" valign="top">44</td> <td align="center" valign="top">2C</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Line type</td> </tr> <tr> <td align="center" valign="top">54</td> <td align="center" valign="top">36</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Job name</td> </tr> <tr> <td align="center" valign="top">64</td> <td align="center" valign="top">40</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Job user profile</td> </tr> <tr> <td align="center" valign="top">74</td> <td align="center" valign="top">4A</td> <td align="left" valign="top">CHAR(6)</td> <td align="left" valign="top">Job number</td> </tr> <tr> <td align="center" valign="top">80</td> <td align="center" valign="top">50</td> <td align="left" valign="top">CHAR(50)</td> <td align="left" valign="top">profile description</td> </tr> <tr> <td align="center" valign="top">130</td> <td align="center" valign="top">82</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Dial-on-demand peer answer profile</td> </tr> <tr> <td align="center" valign="top">140</td> <td align="center" valign="top">8C</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Automatic start</td> </tr> <tr> <td align="center" valign="top">144</td> <td align="center" valign="top">90</td> <td align="left" valign="top"><img src="delta.gif" alt="Start of change">CHAR(8)</td> <td align="left" valign="top">Thread ID<img src="deltaend.gif" alt="End of change"></td> </tr> <tr> <td align="center" valign="top"><img src="delta.gif" alt="Start of change">152</td> <td align="center" valign="top">98</td> <td align="left" valign="top">CHAR(8)</td> <td align="left" valign="top">Reserved<img src="deltaend.gif" alt="End of change"></td> </tr> </table> <br> <br> <h3><a name="HDRSPCA2">Field Descriptions</a></h3> <p><strong>Automatic start.</strong> Whether the profile is started automatically when the TCP/IP stack is activated. Possible values are:</p> <table cellpadding="5"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>0</em></td> <td align="left" valign="top">NO. This profile is not started automatically.</td> </tr> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">YES. This profile is started automatically.</td> </tr> </table> <p><strong>Connection protocol.</strong> The type of point-to-point connection provided by the profile job.</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">SLIP.</td> </tr> <tr> <td align="left" valign="top"><em>2</em></td> <td align="left" valign="top">PPP.</td> </tr> </table> <p><strong>Connection status.</strong> The current connection of job status of the profile job.Values are as follows:</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">Inactive</td> </tr> <tr> <td align="left" valign="top"><em>2</em></td> <td align="left" valign="top">Session error</td> </tr> <tr> <td align="left" valign="top"><em>3</em></td> <td align="left" valign="top">Ended - information available</td> </tr> <tr> <td align="left" valign="top"><em>4</em></td> <td align="left" valign="top">Session start submitted</td> </tr> <tr> <td align="left" valign="top"><em>11</em></td> <td align="left" valign="top">Session job starting</td> </tr> <tr> <td align="left" valign="top"><em>12</em></td> <td align="left" valign="top">Session job ending</td> </tr> <tr> <td align="left" valign="top"><em>13</em></td> <td align="left" valign="top">Session ended - job log pending</td> </tr> <tr> <td align="left" valign="top"><em>14</em></td> <td align="left" valign="top">Adding TCP/IP configuration</td> </tr> <tr> <td align="left" valign="top"><em>15</em></td> <td align="left" valign="top">Removing TCP/IP configuration</td> </tr> <tr> <td align="left" valign="top"><em>16</em></td> <td align="left" valign="top">Message pending</td> </tr> <tr> <td align="left" valign="top"><em>17</em></td> <td align="left" valign="top">Session error</td> </tr> <tr> <td align="left" valign="top"><em>18</em></td> <td align="left" valign="top">Starting TCP/IP</td> </tr> <tr> <td align="left" valign="top"><em>19</em></td> <td align="left" valign="top">Ending TCP/IP</td> </tr> <tr> <td align="left" valign="top"><em>21</em></td> <td align="left" valign="top">Calling remote system</td> </tr> <tr> <td align="left" valign="top"><em>22</em></td> <td align="left" valign="top">Waiting for incoming call</td> </tr> <tr> <td align="left" valign="top"><em>23</em></td> <td align="left" valign="top">Connecting</td> </tr> <tr> <td align="left" valign="top"><em>24</em></td> <td align="left" valign="top">Active</td> </tr> <tr> <td align="left" valign="top"><em>26</em></td> <td align="left" valign="top">Switched line-dial on demand</td> </tr> <tr> <td align="left" valign="top"><em>27</em></td> <td align="left" valign="top">Waiting for incoming call - switched line-answer enabled dial on demand</td> </tr> <tr> <td align="left" valign="top"><em>28</em></td> <td align="left" valign="top">Waiting for shared line resource</td> </tr> <tr> <td align="left" valign="top"><em>29</em></td> <td align="left" valign="top">Requesting shared line resource</td> </tr> <tr> <td align="left" valign="top"><em>31</em></td> <td align="left" valign="top">LCP initializing</td> </tr> <tr> <td align="left" valign="top"><em>32</em></td> <td align="left" valign="top">LCP starting</td> </tr> <tr> <td align="left" valign="top"><em>33</em></td> <td align="left" valign="top">LCP closing</td> </tr> <tr> <td align="left" valign="top"><em>34</em></td> <td align="left" valign="top">LCP closed</td> </tr> <tr> <td align="left" valign="top"><em>35</em></td> <td align="left" valign="top">LCP waiting for configuration request</td> </tr> <tr> <td align="left" valign="top"><em>36</em></td> <td align="left" valign="top">LCP configuring</td> </tr> <tr> <td align="left" valign="top"><em>37</em></td> <td align="left" valign="top">LCP authenticating</td> </tr> <tr> <td align="left" valign="top"><em>41</em></td> <td align="left" valign="top">IPCP initializing</td> </tr> <tr> <td align="left" valign="top"><em>42</em></td> <td align="left" valign="top">IPCP starting</td> </tr> <tr> <td align="left" valign="top"><em>43</em></td> <td align="left" valign="top">IPCP ending</td> </tr> <tr> <td align="left" valign="top"><em>44</em></td> <td align="left" valign="top">IPCP stopped</td> </tr> <tr> <td align="left" valign="top"><em>45</em></td> <td align="left" valign="top">IPCP waiting for configuration request</td> </tr> <tr> <td align="left" valign="top"><em>46</em></td> <td align="left" valign="top">IPCP configuring</td> </tr> <tr> <td align="left" valign="top"><em>47</em></td> <td align="left" valign="top">IPCP opening</td> </tr> <tr> <td align="left" valign="top"><em>51</em></td> <td align="left" valign="top">Multi-connection - waiting for incoming call(s)</td> </tr> <tr> <td align="left" valign="top"><em>52</em></td> <td align="left" valign="top">Multi-connection L2TP initiator waiting for tunnel</td> </tr> <tr> <td align="left" valign="top"><em>53</em></td> <td align="left" valign="top">Multi-connection - at least one connection active</td> </tr> <tr> <td align="left" valign="top"><em>54</em></td> <td align="left" valign="top">Multi-hop terminator starting multi-hop initiator</td> </tr> <tr> <td align="left" valign="top"><em>55</em></td> <td align="left" valign="top">Multi-hop initiator establishing second hop tunnel</td> </tr> <tr> <td align="left" valign="top"><em>56</em></td> <td align="left" valign="top">Multi-hop initiator tunnel pre-started</td> </tr> <tr> <td align="left" valign="top"><em>57</em></td> <td align="left" valign="top">Multi-hop connection active</td> </tr> <tr> <td align="left" valign="top"><em>58</em></td> <td align="left" valign="top">Starting VPN connection</td> </tr> <tr> <td align="left" valign="top"><em>59</em></td> <td align="left" valign="top">Negotiating IPSEC SA</td> </tr> <tr> <td align="left" valign="top"><em>60</em></td> <td align="left" valign="top">PPPoE discovery stage</td> </tr> <tr> <td align="left" valign="top"><em>61</em></td> <td align="left" valign="top">PPPoE session stage</td> </tr> </table> <p><strong>Connection type.</strong> The type of connection provided by the profile job. Values are:</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">Switched or dialed connection</td> </tr> <tr> <td align="left" valign="top"><em>2</em></td> <td align="left" valign="top">Leased or non-switched connection</td> </tr> <tr> <td align="left" valign="top"><em>3</em></td> <td align="left" valign="top">Virtual circuit connection</td> </tr> <tr> <td align="left" valign="top"><em>4</em></td> <td align="left" valign="top">PPPoE</td> </tr> </table> <p><strong>Dial-on-demand peer answer profile.</strong> Specifies the name of the answer only profile that answers incoming calls from the remote peer.</p> <p><strong>Job name.</strong> The job name of the job that currently or most recently executed this profile job description. This field is blank if this connection profile job has not been run.</p> <p><img src="delta.gif" alt="Start of change"> Note that the connection job may not be unique. That is, multiple connections can share a single job by running in separate threads.<img src="deltaend.gif" alt="End of change"></p> <p><strong>Job number.</strong> The job number of the job that currently or most recently executed this profile job description. This field is blank if this connection profile job has not been run.</p> <p><strong>Job user profile.</strong> The user profile of the job that currently or most recently executed this profile job description. This field is blank if this connection profile job has not been run.</p> <p><strong>Line name.</strong> Each TCP/IP interface is associated with a physical network. This field displays the name of the communications line description that identifies the physical network associated with an interface. May be blank when Line type selection is *LINEPOOL and no member line has been selected.</p> <p><strong>Line type.</strong> The type of line connection defined in this connection profile. Possible values are:</p> <table cellpadding="3"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>*PPP</em></td> <td align="left" valign="top">PPP line description</td> </tr> <tr> <td align="left" valign="top"><em>*LINEPOOL</em></td> <td align="left" valign="top">Line name is a member of a line pool</td> </tr> <tr> <td align="left" valign="top"><em>*L2TP</em></td> <td align="left" valign="top">L2TP line description</td> </tr> <tr> <td align="left" valign="top"><em>*PPPOE</em></td> <td align="left" valign="top">PPPoE line description</td> </tr> <tr> <td align="left" valign="top"><em>*ERROR</em></td> <td align="left" valign="top">The selected line type is undefined or is improperly defined</td> </tr> </table> <p><strong>Multilink connection enabled.</strong> Whether multilink connections are enabled for the profile. Values are:</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>0</em></td> <td align="left" valign="top">No</td> </tr> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">Yes</td> </tr> </table> <p><strong>Profile description.</strong> The text description of the function performed by this profile connection job.</p> <p><strong>Profile job type.</strong> The type of job support required for the profile.</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">Single connection profile</td> </tr> <tr> <td align="left" valign="top"><em>2</em></td> <td align="left" valign="top">Multi-connection or multilink connection profile</td> </tr> </table> <p><strong>Profile mode.</strong> The function provided by the profile job. Values are:</p> <table cellpadding="3"> <!-- cols="5 95" --> <tr> <td align="left" valign="top"><em>1</em></td> <td align="left" valign="top">Dial only.</td> </tr> <tr> <td align="left" valign="top"><em>2</em></td> <td align="left" valign="top">Answer only.</td> </tr> <tr> <td align="left" valign="top"><em>3</em></td> <td align="left" valign="top">Dial-on-demand.</td> </tr> <tr> <td align="left" valign="top"><em>4</em></td> <td align="left" valign="top">Answer enabled dial-on-demand.</td> </tr> <tr> <td align="left" valign="top"><em>5</em></td> <td align="left" valign="top">L2TP virtual Initiator.</td> </tr> <tr> <td align="left" valign="top"><em>6</em></td> <td align="left" valign="top">Remote peer enabled dial-on-demand.</td> </tr> <tr> <td align="left" valign="top"><em>7</em></td> <td align="left" valign="top">L2TP initiator-on-demand.</td> </tr> <tr> <td align="left" valign="top"><em>8</em></td> <td align="left" valign="top">L2TP multihop initiator.</td> </tr> <tr> <td align="left" valign="top"><em>9</em></td> <td align="left" valign="top">PPPoE initiator.</td> </tr> </table> <p><strong>Profile name.</strong> The name of this connection profile description.</p> <p><strong>Reserved.</strong> An ignored field.</p> <p><img src="delta.gif" alt="Start of change"><strong>Thread ID.</strong>The thread id under which the connection is running in the point-to-point job.<img src="deltaend.gif" alt="End of change"></p> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="5"> <!-- cols="15 85" --> <tr> <th align="left" valign="top" nowrap>Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td align="left" valign="top">CPF24B4 E</td> <td align="left" valign="top">Severe error while addressing parameter list.</td> </tr> <tr> <td align="left" valign="top">CPF3C21 E</td> <td align="left" valign="top">Format name &1 is not valid.</td> </tr> <tr> <td align="left" valign="top">CPF3CAA E</td> <td align="left" valign="top">List is too large for user space &1.</td> </tr> <tr> <td align="left" valign="top">CPF3CF1 E</td> <td align="left" valign="top">Error code parameter not valid.</td> </tr> <tr> <td align="left" valign="top">CPF811A E</td> <td align="left" valign="top">User space &4 in &9 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF9872 E</td> <td align="left" valign="top">Program or service program &1 in library &2 ended. Reason code &3.</td> </tr> </table> <br> <hr> API introduced: V5R1 <hr> <center> <table cellpadding="2" cellspacing="2"> <tr align="center"> <td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href= "comm.htm">Communications APIs</a> | <a href="aplist.htm">APIs by category</a></td> </tr> </table> </center> </body> </html>