209 lines
10 KiB
HTML
209 lines
10 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="INIT0100: Format of connection description information" />
|
||
|
|
<meta name="abstract" content="You can read this topic for information about the client connection that the exit program can use." />
|
||
|
|
<meta name="description" content="You can read this topic for information about the client connection that the exit program can use." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwdevinit.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwemultypetrouble.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzaiwconndesc" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>INIT0100: Format of connection description information</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzaiwconndesc"><a name="rzaiwconndesc"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">INIT0100: Format of connection description information</h1>
|
||
|
|
<div><p>You can read this topic for information about the client connection
|
||
|
|
that the exit program can use.</p>
|
||
|
|
<div class="section"><p>The following table shows the format of the connection description
|
||
|
|
information, which describes client and connection information for this session.</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 1. Format of connection description information</caption><thead align="left"><tr><th valign="top" id="d0e28">Offset dec</th>
|
||
|
|
<th valign="top" id="d0e30">Offset hex</th>
|
||
|
|
<th valign="top" id="d0e32">Type</th>
|
||
|
|
<th valign="top" id="d0e34">Field</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e28 ">0</td>
|
||
|
|
<td valign="top" headers="d0e30 ">0</td>
|
||
|
|
<td valign="top" headers="d0e32 ">INT(4)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Length of connection description information</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">4</td>
|
||
|
|
<td valign="top" headers="d0e30 ">4</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(20)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Client internet address</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">24</td>
|
||
|
|
<td valign="top" headers="d0e30 ">18</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Client password validated</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">25</td>
|
||
|
|
<td valign="top" headers="d0e30 ">19</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(12)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Workstation type</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">39</td>
|
||
|
|
<td valign="top" headers="d0e30 ">27</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Secure socket layer connection</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">40</td>
|
||
|
|
<td valign="top" headers="d0e30 ">28</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(20)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Server (local) internet address</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">60</td>
|
||
|
|
<td valign="top" headers="d0e30 ">3C</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Client authentication level</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">61</td>
|
||
|
|
<td valign="top" headers="d0e30 ">3D</td>
|
||
|
|
<td valign="top" headers="d0e32 ">CHAR(3)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">64</td>
|
||
|
|
<td valign="top" headers="d0e30 ">40</td>
|
||
|
|
<td valign="top" headers="d0e32 ">INT(4)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Client certificate valid rc</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">68</td>
|
||
|
|
<td valign="top" headers="d0e30 ">44</td>
|
||
|
|
<td valign="top" headers="d0e32 ">INT(4)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Offset to client certificate</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e28 ">72</td>
|
||
|
|
<td valign="top" headers="d0e30 ">48</td>
|
||
|
|
<td valign="top" headers="d0e32 ">INT(4)</td>
|
||
|
|
<td valign="top" headers="d0e34 ">Client certificate length</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Connection description information field descriptions</h4><dl><dt class="dlterm">Length of connection description information</dt>
|
||
|
|
<dd>Length of the connection description structure</dd>
|
||
|
|
<dt class="dlterm">Client internet address</dt>
|
||
|
|
<dd>This is the IP address (or type structure) of the requesting client, and
|
||
|
|
is always provided to the exit program. The layout of the new fields are:
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 2. Client IP address layout</caption><thead align="left"><tr><th valign="top" id="d0e159">Name</th>
|
||
|
|
<th valign="top" id="d0e161">Size</th>
|
||
|
|
<th valign="top" id="d0e163">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e159 ">sin_len</td>
|
||
|
|
<td valign="top" headers="d0e161 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e163 ">Size of the sockaddr_in structure.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e159 ">sin_family</td>
|
||
|
|
<td valign="top" headers="d0e161 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e163 ">Family or protocol. IP (Version 4) is hex 02.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e159 ">sin_port</td>
|
||
|
|
<td valign="top" headers="d0e161 ">CHAR(2)</td>
|
||
|
|
<td valign="top" headers="d0e163 ">16-bit unsigned port number.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e159 ">sin_addr</td>
|
||
|
|
<td valign="top" headers="d0e161 ">CHAR(16)</td>
|
||
|
|
<td valign="top" headers="d0e163 ">4-byte unsigned</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Client password validated</dt>
|
||
|
|
<dd>Specifies if Telnet validated the clients' encrypted password (if one
|
||
|
|
was received). The system will set this value if TN5250E Clients send the
|
||
|
|
encrypted password for validation. The password will be checked using service
|
||
|
|
functions calls. This allows the exit program to guarantee secure client sign-on
|
||
|
|
process.<ul><li>Value = 0, Client password/passphrase (or Kerberos ticket) was not validated
|
||
|
|
or none was received.</li>
|
||
|
|
<li>Value = 1, Client clear-text password/passphrase was validated</li>
|
||
|
|
<li>Value = 2, Client encrypted password/passphrase (or Kerberos ticket) was
|
||
|
|
validated</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Workstation type</dt>
|
||
|
|
<dd>The workstation type requested by the client, and will be one of the Internet
|
||
|
|
Specifications listed in the Workstation and printer mappings table.</dd>
|
||
|
|
<dt class="dlterm">Secure Sockets Layer</dt>
|
||
|
|
<dd>This indicates if the connection is a Secure Sockets Layer (SSL) connection.<ul class="simple"><li><span class="uicontrol">0</span> - Connection is not using SSL.</li>
|
||
|
|
<li><span class="uicontrol">1</span> - Connection is using SSL.</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Server internet address</dt>
|
||
|
|
<dd>This is the IP address (or type structure) of the host (local) network
|
||
|
|
interface, and is always provided to the Exit Point program. The layout of
|
||
|
|
the new fields are:
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 3. Client IP address layout</caption><thead align="left"><tr><th valign="top" id="d0e240">Name</th>
|
||
|
|
<th valign="top" id="d0e242">Size</th>
|
||
|
|
<th valign="top" id="d0e244">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e240 ">sin_len</td>
|
||
|
|
<td valign="top" headers="d0e242 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e244 ">Size of the sockaddr_in structure</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e240 ">sin_family</td>
|
||
|
|
<td valign="top" headers="d0e242 ">CHAR(1)</td>
|
||
|
|
<td valign="top" headers="d0e244 ">Protocol family IP is hex 02, IPX is hex 06</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e240 ">sin_port</td>
|
||
|
|
<td valign="top" headers="d0e242 ">CHAR(2)</td>
|
||
|
|
<td valign="top" headers="d0e244 ">16-bit unsigned port number</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e240 ">sin_addr</td>
|
||
|
|
<td valign="top" headers="d0e242 ">CHAR(16)</td>
|
||
|
|
<td valign="top" headers="d0e244 ">4-byte unsigned network address</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Client authentication level</dt>
|
||
|
|
<dd>Indicates if client SSL certificates are required in order to connect
|
||
|
|
to the server.<ul class="simple"><li><span class="uicontrol">0</span> - No client certificate is required.</li>
|
||
|
|
<li><span class="uicontrol">1</span> - A valid client certificate is required.</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt class="dlterm">Client certificate valid return code</dt>
|
||
|
|
<dd>Indicates the return code received during the SSL handshake operation
|
||
|
|
when validating the client certificate.</dd>
|
||
|
|
<dt class="dlterm">Offset to client certificate</dt>
|
||
|
|
<dd>Indicates the offset from the start of the Connection structure to the
|
||
|
|
first byte of the client certificate.</dd>
|
||
|
|
<dt class="dlterm">Client certificate length</dt>
|
||
|
|
<dd>Indicates the length of the client certificate that was received. If no
|
||
|
|
certificate was received, then the length is 0.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiwdevinit.htm" title="This program allows you to associate your custom exit program with exit points on the iSeries Telnet server.">Device initialization exit program</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzaiwemultypetrouble.htm" title="This topic gives you more specific information on determining problems within the individual emulation type.">Troubleshoot emulation types</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|