You can read this topic for information about the client connection
that the exit program can use.
The following table shows the format of the connection description
information, which describes client and connection information for this session.
Table 1. Format of connection description information| Offset dec |
Offset hex |
Type |
Field |
|---|
| 0 |
0 |
INT(4) |
Length of connection description information |
| 4 |
4 |
CHAR(20) |
Client internet address |
| 24 |
18 |
CHAR(1) |
Client password validated |
| 25 |
19 |
CHAR(12) |
Workstation type |
| 39 |
27 |
CHAR(1) |
Secure socket layer connection |
| 40 |
28 |
CHAR(20) |
Server (local) internet address |
| 60 |
3C |
CHAR(1) |
Client authentication level |
| 61 |
3D |
CHAR(3) |
Reserved |
| 64 |
40 |
INT(4) |
Client certificate valid rc |
| 68 |
44 |
INT(4) |
Offset to client certificate |
| 72 |
48 |
INT(4) |
Client certificate length |
Connection description information field descriptions
- Length of connection description information
- Length of the connection description structure
- Client internet address
- 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:
Table 2. Client IP address layout| Name |
Size |
Description |
|---|
| sin_len |
CHAR(1) |
Size of the sockaddr_in structure. |
| sin_family |
CHAR(1) |
Family or protocol. IP (Version 4) is hex 02. |
| sin_port |
CHAR(2) |
16-bit unsigned port number. |
| sin_addr |
CHAR(16) |
4-byte unsigned |
- Client password validated
- 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.
- Value = 0, Client password/passphrase (or Kerberos ticket) was not validated
or none was received.
- Value = 1, Client clear-text password/passphrase was validated
- Value = 2, Client encrypted password/passphrase (or Kerberos ticket) was
validated
- Workstation type
- The workstation type requested by the client, and will be one of the Internet
Specifications listed in the Workstation and printer mappings table.
- Secure Sockets Layer
- This indicates if the connection is a Secure Sockets Layer (SSL) connection.
- 0 - Connection is not using SSL.
- 1 - Connection is using SSL.
- Server internet address
- 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:
Table 3. Client IP address layout| Name |
Size |
Description |
|---|
| sin_len |
CHAR(1) |
Size of the sockaddr_in structure |
| sin_family |
CHAR(1) |
Protocol family IP is hex 02, IPX is hex 06 |
| sin_port |
CHAR(2) |
16-bit unsigned port number |
| sin_addr |
CHAR(16) |
4-byte unsigned network address |
- Client authentication level
- Indicates if client SSL certificates are required in order to connect
to the server.
- 0 - No client certificate is required.
- 1 - A valid client certificate is required.
- Client certificate valid return code
- Indicates the return code received during the SSL handshake operation
when validating the client certificate.
- Offset to client certificate
- Indicates the offset from the start of the Connection structure to the
first byte of the client certificate.
- Client certificate length
- Indicates the length of the client certificate that was received. If no
certificate was received, then the length is 0.