se.entra.phantom.server

Class TelnetThread

java.lang.Object

se.entra.phantom.server.TelnetThread

All Implemented Interfaces:

Runnable, TelnetHost

public class TelnetThread
extends Object
implements Runnable, TelnetHost

The Telnet communication. It establishes the connection to the host and initiates the 3270 or 5250 data stream.

Available 3270 terminal types:

   - IBM-3278-2
   - IBM-3278-3
   - IBM-3278-4
   - IBM-3278-5
   - IBM-3287-1
   - IBM-3279-2
   - IBM-3278-2
   - IBM-3279-3
   - IBM-3278-3
   - IBM-3279-4
   - IBM-3278-4
   - IBM-3279-5
   - IBM-3278-5
   - IBM-3287-1
 

Available 5250 terminal types:

   - LATER....
 

A common situation when the session is inactive is the transactions TIMING_MARK like:

  - Receive  IAC DO TIMING_MARK
  - Send     IAC WILL TIMING_MARK
 

Constructor Summary

Constructors

Constructor and Description
TelnetThread(boolean doTN3270E, SSLParams sslData) Creates the Telnet session for a 3270/5250 terminal.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the current connection.
void	enableNewEnviron(int codepage, String kbdType) Enables the Telnet NEW-ENVIRON TN5250E negotiation.
void	enableTN3270E() Enables the Telnet TN3270E extensions.
String	getDeviceName() Gets the device name of the session.
void	initialize(TelnetInterface i, String terminalList) Creates the Telnet session for a 3270/5250 terminal type list.
boolean	isSecured() Checks if the communication is secured with e.g.
void	open(String host, int port) Opens the connection to the host at a specified port number.
protected void	process(byte[] netBuf, int netBufLen) Processes incomming data.
void	run() The thread is running here.
boolean	sendSpecialKey(int param) Sends TN3270E special key (param=0 is Attention and param=1 is SysReq).
void	sendSSCPLUData(short[] buf, int n) Sends SSCP LU data for a TN3270E session.
void	setAssociatePrinterWithTerminal(String terminalName) Sets associate printer for a printer session.
void	setKeepAlive(int milliSeconds, boolean nop) Sets the timeout for keep-alive in milliseconds.
void	write(byte[] buf) Writes a raw buffer to the output followed by a flush.
void	write(byte[] buf, int count) Writes a raw buffer to the output followed by a flush.
void	write(short[] buf, int n) Writes an amount of bytes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TelnetThread

public TelnetThread(boolean doTN3270E,
                    SSLParams sslData)

Creates the Telnet session for a 3270/5250 terminal.

Method Detail

setKeepAlive

public void setKeepAlive(int milliSeconds,
                         boolean nop)

Sets the timeout for keep-alive in milliseconds.

enableNewEnviron

public void enableNewEnviron(int codepage,
                             String kbdType)

Enables the Telnet NEW-ENVIRON TN5250E negotiation. "kbdType" may be null in order to the the default *SYSVAL keyboard.

Specified by:

enableNewEnviron in interface TelnetHost

enableTN3270E

public void enableTN3270E()

Enables the Telnet TN3270E extensions.

setAssociatePrinterWithTerminal

public void setAssociatePrinterWithTerminal(String terminalName)

Sets associate printer for a printer session. The printer session will associate to the LU name returned from the TN3270E terminal session.

Specified by:

setAssociatePrinterWithTerminal in interface TelnetHost

initialize

public void initialize(TelnetInterface i,
                       String terminalList)
                throws IOException

Creates the Telnet session for a 3270/5250 terminal type list.

Specified by:

initialize in interface TelnetHost

Throws:

IOException - if an I/O error occurs.

close

public void close()

Closes the current connection.

Specified by:

close in interface TelnetHost

open

public void open(String host,
                 int port)
          throws IOException

Opens the connection to the host at a specified port number.

Specified by:

open in interface TelnetHost

Throws:

IOException - if an I/O error occurs.

isSecured

public boolean isSecured()

Checks if the communication is secured with e.g. SSL.

Specified by:

isSecured in interface TelnetHost

process

protected void process(byte[] netBuf,
                       int netBufLen)
                throws IOException

Processes incomming data.

Throws:

IOException - if an I/O error occurs.

getDeviceName

public String getDeviceName()

Gets the device name of the session.

Specified by:

getDeviceName in interface TelnetHost

Returns:

null if no device name exists.

write

public void write(short[] buf,
                  int n)
           throws IOException

Writes an amount of bytes. The data is appended with and end-of-record (IAC EOR). Each 0xFF character in the buffer is escaped with 0xFF (i.e. IAC IAC).

Specified by:

write in interface TelnetHost

Throws:

IOException - if an I/O error occurs.

write

public void write(byte[] buf)
           throws IOException

Writes a raw buffer to the output followed by a flush.

Throws:

IOException

write

public void write(byte[] buf,
                  int count)
           throws IOException

Writes a raw buffer to the output followed by a flush.

Throws:

IOException

sendSSCPLUData

public void sendSSCPLUData(short[] buf,
                           int n)
                    throws IOException

Sends SSCP LU data for a TN3270E session.

Specified by:

sendSSCPLUData in interface TelnetHost

Throws:

IOException - if an I/O error occurs.

sendSpecialKey

public boolean sendSpecialKey(int param)
                       throws IOException

Sends TN3270E special key (param=0 is Attention and param=1 is SysReq).

Specified by:

sendSpecialKey in interface TelnetHost

Returns:

false if this special key is not supported.

Throws:

IOException - if an I/O error occurs.

run

public void run()

The thread is running here.

Specified by:

run in interface Runnable