ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qtocrtvpppcnnprf.htm

2921 lines
75 KiB
HTML

<!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>Retrieve PPP Connection Profiles (QtocRtvPPPCnnPrf) 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 -->
<!-- 030825 CGLOE: Corrected Line type for *POOL -->
<!-- 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>Retrieve PPP Connection Profiles (QtocRtvPPPCnnPrf) API</h2>
<div class="box" style="width: 60%;">
&nbsp;&nbsp;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%">Receiver variable</td>
<td align="left" valign="top" width="20%">Output</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of receiver variable</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Profile name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">4</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">5</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>
&nbsp;&nbsp;Service Program: QTOCPPPAPI<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Retrieve PPP Connection Profiles (QtocRtvPPPCnnPrf) API retrieves the
details of a specific PPP connection job profile. If the connection profile
describes multiple connections, then details of each connection are also
retrieved.</p>
<br>
<h3>Authorities and Locks</h3>
<p>None.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The variable that is to receive the information requested. You can specify
the size of this area to be smaller than the format requested as long as you
specify the length parameter correctly. As a result, the API returns only the
data that the area can hold.</p>
</dd>
<dt><strong>Length of receiver variable</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the receiver variable. If the length is larger than the size
of the receiver variable, the results may not be predictable. The minimum
length is 8 bytes.</p>
</dd>
<dt><strong>Profile name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The name of the PPP connection profile to be returned.</p>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the retrieved profile to be returned. The format names
supported are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>PRFR0100</em></td>
<td align="left" valign="top">Connection profile attributes. Refer to <a href="#PRFR0100">
PRFR0100 Format</a> for details on the format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>PRFR0200</em></td>
<td align="left" valign="top">Connection profile static parameters. Refer to <a href=
"#PRFR0100">PRFR0100 Format</a> and <a href="#PRFR0200">PRFR0200 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 Attributes Information</h3>
<p>To retrieve the basic connection profile information and current profile job
status, use format PRFR0100. For more detailed profile and connection
attributes, use format PRFR0200.</p>
<br>
<h3><a name="PRFR0100">PRFR0100 Format</a></h3>
<p>The following data about a connection profile is returned for the PRFR0100
format. For detailed descriptions of the fields in the table, see <a href=
"#FIELD1">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%">Bytes returned</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">Bytes available</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">Profile mode</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 protocol</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">Connection status</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">Connection type</td>
</tr>
<tr>
<td align="center" valign="top">24</td>
<td align="center" valign="top">18</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">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Automatic start</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Profile name</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Profile description</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to additional information</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of additional information</td>
</tr>
</table>
<br>
<br>
<h3><a name="FIELD1">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>Bytes available.</strong> The number of bytes of data available to
be returned. All available data is returned if enough space is provided.</p>
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
<p><strong>Connection protocol.</strong> The type of point-to-point connection
provided by the profile job.</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><strong>1</strong></td>
<td align="left" valign="top">SLIP.</td>
</tr>
<tr>
<td align="left" valign="top"><strong>2</strong></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="15 85" -->
<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="15 85" -->
<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>
</table>
<p><strong>Length of additional information.</strong> The length in bytes of
additional information returned that is not part of format PRFR0100.</p>
<p><strong>Offset to additional information.</strong> The offset in bytes to
the rest of the information if a format other than PRFR0100 is requested.</p>
<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="15 85" -->
<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="15 85" -->
<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>
<br>
<h3><a name="PRFR0200">PRFR0200 Format</a></h3>
<p>The following data about a connection profile is returned for the PRFR0200
format. For detailed descriptions of the fields in the table, see <a href=
"#FIELD2">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%">&nbsp;</td>
<td align="left" valign="top" width="60%">Returns everything from format
PRFR0100</td>
</tr>
<tr>
<td valign="top" colspan="2">Decimal and hexadecimal offsets are
reached by using the offset to additional information field in format PRFR0100. This applies to all entries below.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Move current remote phone number if dial
operation is successful</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Redial when disconnected</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of dial attempts</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Delay between dial attempts</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum number of connections</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Multilink connection enabled</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum number of multilink connections</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Inactivity timeout</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Line definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Line name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Line type</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">L2TP tunnel end-point IP address</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(5)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Local user ID defined</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Local user ID encryption type</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Local user ID validation list name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Remote user ID required for logon</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Remote user ID authentication protocols
allowed</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Remote user ID validation method</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Use Radius for connection auditing and
accounting</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Remote user ID validation list name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">ASCII CCSID of line data</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Connection script file defined</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Connection script library</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Connection script file</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Connection script member</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">DNS definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">DNS IP address</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(5)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Local IP address definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Local IP address</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(5)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Remote IP address definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Remote IP address (or start of range)</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(5)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow additional remote IP addresses by user
ID</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow remote system to assign the remote IP
addres</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow IP datagram forwarding</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Request VJ header compression</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Routing definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Hide address (full masquerading)</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of remote IP addresses</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(64)</td>
<td align="left" valign="top">Line pool list name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Subsystem description</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Requires IP security protection</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(40)</td>
<td align="left" valign="top">IP security connection group</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Answer profile this dial-on-demand profile
depends on</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow remote system to initate call</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow BACP</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Add link percentage</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time to wait (in seconds) for adding a link</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Drop link percentage</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time to wait (in seconds) for dropping a
link</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bandwidth test direction</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Use filter rule</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(32)</td>
<td align="left" valign="top">Filter rule name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow L2TP Multihop connections</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Allow L2TP outgoing call connections</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">L2TP outgoing call line definition</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">L2TP outgoing call line name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to profile detailed connection parameter
entries</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of profile detailed connection parameter
entries</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Entry length of profile detailed connection
parameters</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to remote phone number entries</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of remote phone number entries</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Entry length of remote phone numbers</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">PPPoE server addressing</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Persistent PPPoE connection</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(256)</td>
<td align="left" valign="top">Requested PPPoE server name</td>
</tr>
<tr>
<td colspan="2"></td>
<td align="left" valign="top">CHAR(256)</td>
<td align="left" valign="top">Requested PPPoE service </td>
</tr>
</table>
<br>
<br>
<h3><a name="FIELD2"></a>Field Descriptions</h3>
<p><strong>Add link percentage.</strong> The percentage utilization of the
connection before adding another link to a connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>25</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>50</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>75</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>90</em> (default)</td>
</tr>
<tr>
<td align="left" valign="top"><em>95</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>100</em></td>
</tr>
</table>
<p><strong>Allow additional remote IP addresses by user ID.</strong> Whether
additional remote IP addresses may be specified for specific user ID entries.
Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow BACP (Bandwidth Allocation Control Protocol).</strong> Whether
BACP is allowed/required for this connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow IP datagram forwarding.</strong> Whether IP datagrams not
destined for this system should be forwarded. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow L2TP Multihop connections.</strong> Whether L2TP multihop
connections are allowed by this profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow L2TP outgoing call connections.</strong> Whether L2TP outgoing
call connections are allowed by this profile connection job. Valid values
are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow remote system to assign the remote IP address.</strong>
Whether the remote system is allowed to specify the remote IP address for the
connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Allow remote system to initate call.</strong> The remote system is
allowed to initate a call for an additional link for the connection. Valid
values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Answer profile this dial-on-demand profile depends on.</strong> The
name of the answer profile (connection job) that must be running to answer
incoming connections before this profile connection job may be started.</p>
<p><strong>ASCII CCSID of line data.</strong> The ASCII Coded Character Set ID
of the line data for the connection that will be used to translate connection
dialog to and from the EBCDIC character set of the Connection Script used by
this profile connection job.</p>
<p><strong>Bandwidth test direction.</strong> The data direction on the
connection to test the bandwidth for adding and removing links. Valid values
are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Inbound and outbound</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Outbound only</td>
</tr>
</table>
<p><strong>Connection script file.</strong> The name of the connection script
file that is used by this profile connection job.</p>
<p><strong>Connection script file defined.</strong> The connection script file
that describes dialog for establishing a connection with the remote system.
Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Connection script library.</strong> The library containing a
Connection Script file that is used by this profile connection job.</p>
<p><strong>Connection script member.</strong> The member name of the Connection
Script file that is used by this profile connection job.</p>
<p><strong>Delay between dial attempts.</strong> The time (in seconds) to wait
before next attempting to make a successful dialed connection. Valid values
are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1 - 60</em></td>
<td align="left" valign="top">(default = 15)</td>
</tr>
</table>
<p><strong>DNS definition.</strong> Whether a Domain Name Server IP address is
to be added to the DNS address list when a connection is established for this
profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">DNS not used - no address will be added</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">By IP address - the IP address is statically specified</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Dynamic - the IP address will be supplied by the remote
system</td>
</tr>
</table>
<p><strong>DNS IP address.</strong> The IP address of the Domain Name Server
used by this profile connection job.</p>
<p><strong>Drop link percentage.</strong> The percentage utilization of the
connection before dropping a link of a connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>25</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>40</em> (default)</td>
</tr>
<tr>
<td align="left" valign="top"><em>75</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>90</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>95</em></td>
</tr>
<tr>
<td align="left" valign="top"><em>100</em></td>
</tr>
</table>
<p><strong>Entry length of profile detailed connection parameters.</strong> The
length in bytes of each profile detailed connection parameter entry returned
for this profile. A value of zero is returned if the list is empty.</p>
<p><strong>Entry length of remote phone numbers.</strong> The length in bytes
of each remote phone number entry returned for this profile. A value of zerois
returned if the list is empty.</p>
<p><strong>Filter rule name.</strong>The name of the filter rule to be used by
this connection profile.</p>
<p><strong>Hide address (full masquerading).</strong> Whether all other IP
addresses should be hidden by the IP address of the PPP connections established
by this profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Inactivity timeout.</strong> The value used for the inactivity
timeout in the line description. Valid values are 15 - 65535 seconds.</p>
<p><strong>IP security connection group.</strong> The name of the connection
group that describes the IP Security details for connections established by
this profile connection job.</p>
<p><strong>L2TP outgoing call line definition.</strong> The line type to be
used by this profile connection job for L2TP outgoing calls. Valid values
are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Single line</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">LinePool (single line)</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">ISDN line</td>
</tr>
</table>
<p><strong>L2TP outgoing call line name.</strong> The name of the line to be
used by this profile connection job for L2TP outgoing calls.</p>
<p><strong>L2TP tunnel end-point address.</strong> The IP address of the remote
end of the tunnel for an L2TP initiator profile or the IP address of the local
end of the tunnel for an L2TP terminator profile.</p>
<p><strong>Line definition.</strong> The line selection method used by this
profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Specified line name</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">LinePool (single line)</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">LinePool (all)</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">ISDN line</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">L2TP line</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">PPPOE virtual line</td>
</tr>
</table>
<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 pool list name.</strong> The name of the Line Pool list that
contains the names of line descriptions available for use by this profile
connection job.</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>*POOL</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>*ISDN</em></td>
<td align="left" valign="top">ISDN line description</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>Local IP address.</strong> The local IP address defined for
connections established by this profile connection job.</p>
<p><strong>Local IP address definition.</strong> How a local IP address is
defined for connections established by this profile connection job. Valid
values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">By IP address - the IP address is statically specified</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Dynamic - the IP address will be negotiated with the remote
system</td>
</tr>
</table>
<p><strong>Local user ID defined.</strong> The User ID that is defined if
authentication is required by the remote system. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Local user ID encryption type.</strong> The encryption method for
the local system user name and password when authenticating with the remote
system. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Undefined</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">PAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">CHAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">EAP only</td>
</tr>
</table>
<p><strong>Local user ID validation list name.</strong> The name of the
validation list containing the local User ID and password when authenticating
with the remote system.</p>
<p><strong>Maximum number of connections.</strong> The maximum number of
connections supported by this PPP job profile.</p>
<p><strong>Maximum number of multilink connections.</strong> The maximum number
of physical connections connections that can be bundled into a single
multi-linked connection.</p>
<p><strong>Move current remote phone number if dial operation is
successful.</strong> Whether the current remote phone number should be moved if
the call attempt is successful. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Do NOT move number (default for non-multilink
connections)</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Move number to the top of the list (default for multilink
connections)</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Move number to the bottom of the list</td>
</tr>
</table>
<p><strong>Multilink connection enabled.</strong> Whether multilink connections
are enabled for the profile. Values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Number of profile detailed connection parameter entries.</strong>
The number of profile detailed connection parameter entries returned for this
profile. A value of zero is returned if the list is empty.</p>
<p><strong>Number of remote phone number entries.</strong> The number of remote
phone number entries returned for this profile. A value of zero is returned if
the list is empty.</p>
<p><strong>Number of remote IP addresses.</strong> The number of IP addresses
derived from the Remote IP start address defined for this profile connection
job.</p>
<p><strong>Number of dial attempts.</strong> The total number of dial attempts
to achieve a successful connection.</p>
<p><strong>Offset to profile detailed connection parameter entries.</strong>
The offset from the beginning of the receiver variable, in bytes, to the first
element in the profile detailed connection parameter entries returned for this
profile. A value of zero is returned if the list is empty.</p>
<p><strong>Offset to remote phone number entries.</strong> The offset from the
beginning of the receiver variable, in bytes, to the first element in the
remote phone number entries returned for this profile. A value of zero is
returned if the list is empty.</p>
<p><strong>Persistent PPPoE connection.</strong> Whether PPPoE connections for
this profile are re-established when lost unexpectedly. Values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>PPPoE server addressing.</strong> Describes the method used to
select a PPPoE server connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Undefined</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Connect to the default service of the first server that
replies (default)</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Connect to the default service of the requested server</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Connect to the first server offering the requested
service</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Connect to the requested server offering the requested
service</td>
</tr>
</table>
<p><strong>Re-dial when disconnected.</strong> Whether a dialed connection
established by this profile connection job will be redialed if the connection
is lost unexpectedly. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Remote IP address definition.</strong> How a remote IP address is
defined for connections established by this profile connection job. Valid
values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">By IP address - the IP address is statically specified</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Dynamic - the IP address will be negotiated with the remote
system</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Route specified - the IP address is specified by remote
user</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Address pool - the IP address will be selected from the
address pool</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">DHCP - the IP address will be supplied by the DHCP server</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Radius - the IP address will be supplied by the Radius
server</td>
</tr>
</table>
<p><strong>Remote IP address (or start of IP address pool).</strong> The remote
IP address (or starting IP address for multi-connection profiles) defined for
connections established by this profile connection job.</p>
<p><strong>Remote user ID authentication protocols allowed.</strong> The
allowable protocols for remote user ID authentication. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">CHAP and PA</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">CHAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">PAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">EAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">EAP and PAP</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">EAP and CHAP</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">EAP, CHAP, and PAP</td>
</tr>
</table>
<p><strong>Remote user ID required for logon.</strong> Remote User ID
authentication is required for logon to the local system. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Remote user ID validation method.</strong> The method for validation
of the remote user ID. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Validation list</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Radius</td>
</tr>
</table>
<p><strong>Remote user ID validation list name.</strong> The name of the
Validation list containing the remote User ID and password for authenticating
the connection with the remote system.</p>
<p><strong>Requested PPPoE server name.</strong> The PPPoE server name
requested for this PPPoE initiator profile to negotiate the remote end of the
connection.</p>
<p><strong>Requested PPPoE service.</strong> The PPPoE service requested for
this PPPoE initiator profile to negotiate with the remote end of the
connection.</p>
<p><strong>Request VJ header compression.</strong> Whether VJ header
compression should be performed on IP datagrams. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Requires IP security protection .</strong> Whether IP security is
required for connections established by this profile connection job. Valid
values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Routing definition.</strong> The additional routing requested when
activating this profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Not Used</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Add default route</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Additional static routes defined</td>
</tr>
</table>
<p><strong>Subsystem description.</strong> The name of the subsystem
description in which the connection jobs for this profile connection job will
be run.</p>
<p><strong>Time to wait (in seconds) for adding a link.</strong> The time (in
seconds) to wait before adding an additional link after the connection
utilization has exceeded the specified percentage. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>5 - 3600</em></td>
<td align="left" valign="top">(in increments of 5, default = 15)</td>
</tr>
</table>
<p><strong>Time to wait (in seconds) for dropping a link.</strong> The time (in
seconds) to wait before dropping a link after the connection utilization has
receeded below the specified percentage. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>5 - 3600</em></td>
<td align="left" valign="top">(in increments of 5, default = 15)</td>
</tr>
</table>
<p><strong>Use filter rule.</strong> Whether a filter rule should be used by
the profile connection job. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Use Radius for connection auditing and accounting.</strong> Whether
Radius should be used for connection auditing and accounting. Valid values
are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>
<br>
<br>
<h3><a name="CPDP">Connection Profile Detailed Parameters</a></h3>
<p>The following data is returned for each profile detailed connection
parameter entry, describing one connection for a profile. Multiple connection
profiles may have one entry for each connection. For detailed descriptions of
the fields in the table, see <a href="#FIELD3">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%">Connection status</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">Maximum transmission unit (MTU)</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">Maximum links per multilink
connection bundle</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">Number of active links</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">Line inactivity timeout</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">24</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Job number</td>
</tr>
<tr>
<td align="center" valign="top">30</td>
<td align="center" valign="top">1E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job user</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="center" valign="top">50</td>
<td align="center" valign="top">32</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Line name</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Active local IP address (set when
profile is active)</td>
</tr>
<tr>
<td align="center" valign="top">75</td>
<td align="center" valign="top">4B</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Active remote IP address (set when
profile is active)</td>
</tr>
<tr>
<td align="center" valign="top">90</td>
<td align="center" valign="top">5A</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">CHAR(48)</td>
<td align="left" valign="top">Remote user name</td>
</tr>
<tr>
<td align="center" valign="top">144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">CHAR(64)</td>
<td align="left" valign="top">Group access policy</td>
</tr>
<tr>
<td align="center" valign="top">208</td>
<td align="center" valign="top">D0</td>
<td align="left" valign="top">CHAR(32)</td>
<td align="left" valign="top">Filter rule name</td>
</tr>
<tr>
<td align="center" valign="top">240</td>
<td align="center" valign="top">F0</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">IP forwardin</td>
</tr>
<tr>
<td align="center" valign="top">241</td>
<td align="center" valign="top">F1</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Proxy ARP routing</td>
</tr>
<tr>
<td align="center" valign="top">242</td>
<td align="center" valign="top">F2</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">TCP/IP header compression</td>
</tr>
<tr>
<td align="center" valign="top">243</td>
<td align="center" valign="top">F3</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Full masquerading</td>
</tr>
<tr>
<td align="center" valign="top">244</td>
<td align="center" valign="top">F4</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Authentication protocol</td>
</tr>
<tr>
<td align="center" valign="top">245</td>
<td align="center" valign="top">F5</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Multilink protocol enabled</td>
</tr>
<tr>
<td align="center" valign="top">246</td>
<td align="center" valign="top">F6</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Multilink bandwidth utilization
monitoring enabled</td>
</tr>
<tr>
<td align="center" valign="top">247</td>
<td align="center" valign="top">F7</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">248</td>
<td align="center" valign="top">F8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Detailed connection status</td>
</tr>
<tr>
<td align="center" valign="top">252</td>
<td align="center" valign="top">FC</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>
</table>
<br>
<br>
<h3><a name="FIELD3">Field Descriptions</a></h3>
<p><strong>Active (binary) local IP address.</strong> The binary local IP
address of the connection established by this profile connection job.</p>
<p><strong>Active (binary) remote IP address.</strong> The binary remote IP
address of the connection established by this profile connection job.</p>
<p><strong>Authentication protocol.</strong> The authentication protocol that
was negotiated for this profile connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">CHAP and PAP</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">CHAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">PAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">EAP only</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">EAP and PAP</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">EAP and CHAP</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">EAP, CHAP, and PAP</td>
</tr>
</table>
<p><strong>Connection status.</strong> The current status of this profile
connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Inactive or ended</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Ending</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Starting</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Waiting for connection</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Connecting</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Active</td>
</tr>
</table>
<p><strong>Detailed connection status.</strong> Additional detail of the
current status of this profile connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No status set</td>
</tr>
<tr>
<td align="left" valign="top"><em>256</em></td>
<td align="left" valign="top">Undefined</td>
</tr>
<tr>
<td align="left" valign="top"><em>257</em></td>
<td align="left" valign="top">Connection operational</td>
</tr>
<tr>
<td align="left" valign="top"><em>258</em></td>
<td align="left" valign="top">Initializing connection to modem</td>
</tr>
<tr>
<td align="left" valign="top"><em>259</em></td>
<td align="left" valign="top">Initializing connection data structures</td>
</tr>
<tr>
<td align="left" valign="top"><em>260</em></td>
<td align="left" valign="top">Selecting a line from a line pool</td>
</tr>
<tr>
<td align="left" valign="top"><em>261</em></td>
<td align="left" valign="top">Requesting a shared line from current owner</td>
</tr>
<tr>
<td align="left" valign="top"><em>262</em></td>
<td align="left" valign="top">Waiting for shared line to be available</td>
</tr>
<tr>
<td align="left" valign="top"><em>263</em></td>
<td align="left" valign="top">Initializing modem</td>
</tr>
<tr>
<td align="left" valign="top"><em>264</em></td>
<td align="left" valign="top">Incoming call detected</td>
</tr>
<tr>
<td align="left" valign="top"><em>265</em></td>
<td align="left" valign="top">Dial on-demand connection requested</td>
</tr>
<tr>
<td align="left" valign="top"><em>266</em></td>
<td align="left" valign="top">Waiting for modem to connect</td>
</tr>
<tr>
<td align="left" valign="top"><em>267</em></td>
<td align="left" valign="top">Redialing remote system</td>
</tr>
<tr>
<td align="left" valign="top"><em>268</em></td>
<td align="left" valign="top">Modem connected</td>
</tr>
<tr>
<td align="left" valign="top"><em>269</em></td>
<td align="left" valign="top">Modem disconnected</td>
</tr>
<tr>
<td align="left" valign="top"><em>270</em></td>
<td align="left" valign="top">Authenticating remote user</td>
</tr>
<tr>
<td align="left" valign="top"><em>271</em></td>
<td align="left" valign="top">Negotiating IP address</td>
</tr>
<tr>
<td align="left" valign="top"><em>272</em></td>
<td align="left" valign="top">Activating IP address</td>
</tr>
<tr>
<td align="left" valign="top"><em>273</em></td>
<td align="left" valign="top">Modem or resource failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>274</em></td>
<td align="left" valign="top">Connection profile setings failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>275</em></td>
<td align="left" valign="top">Authentication failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>276</em></td>
<td align="left" valign="top">Modem failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>277</em></td>
<td align="left" valign="top">Retry threshold failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>278</em></td>
<td align="left" valign="top">Remote phone number busy</td>
</tr>
<tr>
<td align="left" valign="top"><em>279</em></td>
<td align="left" valign="top">No local dial tone detected</td>
</tr>
<tr>
<td align="left" valign="top"><em>280</em></td>
<td align="left" valign="top">Remote modem did not answer</td>
</tr>
<tr>
<td align="left" valign="top"><em>281</em></td>
<td align="left" valign="top">IP address activation failure</td>
</tr>
<tr>
<td align="left" valign="top"><em>282</em></td>
<td align="left" valign="top">PPP protocol rejected</td>
</tr>
<tr>
<td align="left" valign="top"><em>283</em></td>
<td align="left" valign="top">PPP connection inactivity timeout</td>
</tr>
<tr>
<td align="left" valign="top"><em>300</em></td>
<td align="left" valign="top">Sent PPPoE initiation packet</td>
</tr>
<tr>
<td align="left" valign="top"><em>301</em></td>
<td align="left" valign="top">Received PPPoE offer from peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>302</em></td>
<td align="left" valign="top">Sent PPPoE request packet to peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>303</em></td>
<td align="left" valign="top">Received PPPoE session-confirmation from peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>304</em></td>
<td align="left" valign="top">Sent PPPoE termination packet to peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>350</em></td>
<td align="left" valign="top">Received PPPoE termination from peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>351</em></td>
<td align="left" valign="top">No response from PPPoE peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>352</em></td>
<td align="left" valign="top">PPPoE peer response did not match request sent</td>
</tr>
<tr>
<td align="left" valign="top"><em>353</em></td>
<td align="left" valign="top">Received error from PPPoE peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>354</em></td>
<td align="left" valign="top">Unable to open communication stream</td>
</tr>
<tr>
<td align="left" valign="top"><em>355</em></td>
<td align="left" valign="top">Unable to send packet to PPPoE peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>356</em></td>
<td align="left" valign="top">Unable to convert packet data</td>
</tr>
<tr>
<td align="left" valign="top"><em>357</em></td>
<td align="left" valign="top">PPPoE link error</td>
</tr>
<tr>
<td align="left" valign="top"><em>400</em></td>
<td align="left" valign="top">Starting L2TP tunnel negotiation</td>
</tr>
<tr>
<td align="left" valign="top"><em>401</em></td>
<td align="left" valign="top">L2TP tunnel negotiation in progress</td>
</tr>
<tr>
<td align="left" valign="top"><em>402</em></td>
<td align="left" valign="top">L2TP tunnel established</td>
</tr>
<tr>
<td align="left" valign="top"><em>403</em></td>
<td align="left" valign="top">Starting L2TP call negotiation</td>
</tr>
<tr>
<td align="left" valign="top"><em>404</em></td>
<td align="left" valign="top">Starting L2TP remote call negotiation</td>
</tr>
<tr>
<td align="left" valign="top"><em>405</em></td>
<td align="left" valign="top">L2TP call established</td>
</tr>
<tr>
<td align="left" valign="top"><em>450</em></td>
<td align="left" valign="top">L2TP tunnel authentication failed</td>
</tr>
<tr>
<td align="left" valign="top"><em>451</em></td>
<td align="left" valign="top">L2TP tunnel maximum connections exceeded</td>
</tr>
<tr>
<td align="left" valign="top"><em>452</em></td>
<td align="left" valign="top">Sent stop L2TP tunnel message to peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>453</em></td>
<td align="left" valign="top">Received stop L2TP tunnel message from peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>454</em></td>
<td align="left" valign="top">L2TP call maximum connections exceeded</td>
</tr>
<tr>
<td align="left" valign="top"><em>455</em></td>
<td align="left" valign="top">Sent stop L2TP call message to peer</td>
</tr>
<tr>
<td align="left" valign="top"><em>456</em></td>
<td align="left" valign="top">Received stop L2TP call message from peer</td>
</tr>
</table>
<p><strong>Filter rule name.</strong> The name of the filter rule that is in
effect for this profile connection. A value *NONE means that no filter rule is
in use.</p>
<p><strong>Full masquerading.</strong> Whether full masquerading is in effect
for this profile connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Group access policy.</strong> The name of the group access policy
that is in effect for this profile connection. A value *NONE means that no
group policy is in use.</p>
<p><strong>IP forwarding.</strong> Whether IP forwarding is active for this
profile connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Job name.</strong> The job name of this profile connection job.</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 this profile connection
job.</p>
<p><strong>Job user.</strong> The job user name of this profile connection
job.</p>
<p><strong>Line name.</strong> The name of the line description used for this
profile connection.</p>
<p><strong>Line inactivity timeout.</strong> The value used for the inactivity
timeout in the line description. Valid values are 15 - 65535 seconds.</p>
<p><strong>Maximum links per multilink connection bundle.</strong> The maximum
number of links allowed per bundle for multilink connections for this
profile.</p>
<p><strong>Maximum transmission unit.</strong> The maximum size of IP datagrams
that can be sent over connections started by this profile connection job. This
value is valid only when the profile is active.</p>
<p><strong>Multilink protocol enabled.</strong> Whether multilink connections
are allowed for this connection profile. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Multilink bandwidth utilization monitoring enabled.</strong> Whether
bandwidth utilization monitoring is enabled for this profile connection. Valid
values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Number of active links.</strong> The number of active links that
constitute this profile connection.</p>
<p><strong>Proxy ARP routing.</strong> Whether proxy ARP routing is in effect
for this profile connection. Valid values are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>Remote user name.</strong> The name of the connected remote user
that was authenticated for this profile connection. This value is valid only
when authentication is enabled for this connection profile.</p>
<p><strong>TCP/IP header compression.</strong> Whether TCP/IP header
compression will be performed for this profile connection. Valid values
are:</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>
<table cellpadding="3">
<!-- cols="15 85" -->
<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>
<br>
<br>
<h3><a name="RPN">Remote Phone Numbers</a></h3>
<p>The following data is returned for each connection profile remote phone
number entry. Multilink connection profiles may have one entry for each
connection in the link. Single connection profiles may have more than one entry
to provide backup phone numbers when the primary (first) number is unavailable.
For detailed descriptions of the fields in the table, see <a href="#FIELD4">
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%">CHAR(48)</td>
<td align="left" valign="top" width="60%">Remote phone number</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="FIELD4">Field Descriptions</a></h3>
<p><strong>Remote phone number.</strong> A phone number that will be used to
attempt a switched connection with a remote system. Valid for Dial profiles
only.</p>
<p><strong>Reserved.</strong> An ignored field.</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">TCP8211 E</td>
<td align="left" valign="top">Point-to-point profile &amp;1 not found</td>
</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 &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C24 E</td>
<td align="left" valign="top">Length of the receiver variable is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td align="left" valign="top">Literal value cannot be changed.</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">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library &amp;2 ended,
reason code &amp;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>