INIT0100: Format of connection description information

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

The length of the connection description structure.

Client internet address

The IP address (or type structure) of the requesting client, which is always provided to the exit program. The layout of the new fields 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)	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

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.

Server internet address

The IP address (or type structure) of the host (local) network interface, which is always provided to the exit point program. The layout of the new fields is as follows.

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

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.

 

Parent topic:

Device initialization exit program

Related concepts
Troubleshooting emulation types