INIT0100: Format of connection description information
This topic contains 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.
| Offset dec | Offset hex | Type | Field |
|---|---|---|---|
| 0 | 0 | INT(4) | Length of connection description information |
| 4 | 4 | CHAR(20) | IPv4 Client internet address |
| 24 | 18 | CHAR(1) | Client password validated |
| 25 | 19 | CHAR(14) | Workstation type |
| 39 | 27 | CHAR(1) | Secure socket layer connection |
| 40 | 28 | CHAR(20) | IPv4 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 |
| 76 | 4C | CHAR(28) | IPv6 Client internet address |
| 104 | 68 | CHAR(28) | IPv6 Server (local) internet address |
Connection description information field descriptions
- Length of connection description information
- The length of the connection description structure.
- IPv4 Client internet address
- The IP address (or type structure) of the requesting
client. An IP address is always provided to the exit point program.
The IP address is specified in this field if the address is an IPv4
address. If the address is a pure IPv6 address, it is specified in
the IPv6 Client internet address field, in
which case this structure is set to all binary zeros. The layout of
the field is as follows:
Table 2. Client IP address layout Name Size Description sin_len CHAR(1) Size of the sockaddr_in structure sin_family CHAR(1) Protocol family 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
- Whether Telnet validated the clients' encrypted password (if one
was received). The system sets this value if TN5250E Clients send
the encrypted password for validation. The password is 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, which is one of the Internet Specifications listed in the Workstation and printer mappings table.
- Secure Sockets Layer
- Whether the connection is a Secure Sockets Layer (SSL) connection:
- 0
- Connection is not using SSL.
- 1
- Connection is using SSL.
- IPv4 Server internet address
- The IP address (or type structure) of the host (local) network
interface. An IP address is always provided to the exit point program.
The IP address is specified in this field if the address is an IPv4
address. If the address is a pure IPv6 address, it is specified in
the IPv6 Server internet address field, in
which case this structure is set to all binary zeros. The layout of
the field is as follows:
Table 3. Server IP address layout Name Size Description sin_len CHAR(1) Size of the sockaddr_in structure sin_family CHAR(1) Protocol family IP (Version 4) is hex 02 sin_port CHAR(2) 16-bit unsigned port number sin_addr CHAR(16) 4-byte unsigned network address - Client authentication level
- Whether client SSL certificates are required in order to connect
to the system.
- 0
- No client certificate is required.
- 1
- A valid client certificate is required.
- Client certificate valid return code
- The return code received during the SSL handshake operation when validating the client certificate.
- Offset to client certificate
- The offset from the start of the Connection structure to the first byte of the client certificate.
- Client certificate length
- The length of the client certificate that is received. If no certificate is received, then the length is 0.
- IPv6 Client internet address
- The IP address (or type structure) of the requesting
client. An IP address is always provided to the exit point program.
The IP address is provided in this field if the address is a pure
IPv6 address. If the IP address is an IPv4 address, then it is specified
in the IPv4 Client internet address field and
the IPv6 mapped version of the IPv4 address is provided here. The
layout of the field is as follows:
Table 4. IPv6 Client IP address layout Name Size Description sin6_len CHAR(1) Size of the sockaddr_in6 structure sin6_family CHAR(1) Protocol family IP (Version 6) is hex 18 sin6_port CHAR(2) 16-bit unsigned port number sin6_flowinfo CHAR(4) 4-byte unsigned sin6_addr CHAR(16) 16 char network address sin6_scope_id CHAR(4) 4-byte unsigned address scope - IPv6 Server internet address
- The IP address (or type structure) of the host (local) network
interface. An IP address is always provided to the exit point program.
The IP address is provided in this field if the address is a pure
IPv6 address. If the IP address is an IPv4 address, then it is specified
in the IPv4 Server internet address field and
the IPv6 mapped version of the IPv4 address is provided here. The
layout of the field is as follows:
Table 5. IPv6 Server IP address layout Name Size Description sin6_len CHAR(1) Size of the sockaddr_in6 structure sin6_family CHAR(1) Protocol family IP (Version 6) is hex 18 sin6_port CHAR(2) 16-bit unsigned port number sin6_flowinfo CHAR(4) 4-byte unsigned sin6_addr CHAR(16) 16 char network address sin6_scope_id CHAR(4) 4-byte unsigned address scope