The Telnet port (TELNET)

Revised for CPX 4.7.0.
Configuration of the TELNET port
Statistics of the TELNET port
Commands of the TELNET port


The TELNET port is used within the Abilis CPX to implement the homonymous applicative program.

Generally the telnet is a program of family TCP/IP based on the protocol of transport Connection-Oriented TCP/IP and it allows the User to request a (login) to an other computer. The opening of a session is obtainable specifying IP address of the computer wished to be approached as "virtual terminal", or digiting a mnemonic previously associated to IP destination address of the remote system.

It is possible to distinguish between TELNET processes of type "Client", that accept the login request and provide the connection establishment with the remote unit, and TELNET processes of type "Server" that host on the remote system and provide the login service to the request processes of the TELNET Clients.

The TELNET port of Abilis CPX uses the transport service of Connection-Oriented type offered by the TCP port and the services of IP Router port. It allows, by default, the connection with the Control port and therefore it can access the configuration and supervision functions provided by it.

Configuration of the TELNET port top

The TELNET port is labelled within the Abilis CPX by the acronym "TELNET" and it is provided with the parameters described in the present section.

The following example shows how to display parameters of TELNET ports. Shown value are the default ones.

[14:58:28] ABILIS_CPX: D P PO:TELNET

PO:905 - Not Saved (SAVE CONF), Not Refreshed (INIT) --------------------------
TELNET ------------------------------------------------------------------------
       lowpo:901   TYPE:USER  MCAU:NO  ps:128  locport:23     KEEPALIVE:NO        
       --Server----------------------------------------------------------------
       PSER:TelnetS>          AC:YES               DT:15    
       PWD:                   CDO:00               UDO:CP            ser:3   
       IPSRC:*                IPSRCLIST:#         
       --Client----------------------------------------------------------------
       PCLI:TelnetC>          CDI:*                UDI:*             cli:3        

To activate changes made on the parameters displayed by low case characters, it is needed to restart the system; on the contrary for activating changes made on upper case parameters it is enough to execute the initialization command INIT PO:.
Changes made on TYPE: and MCAU: parameters are immediately active.

The "Not Saved (SAVE CONF)" message is displayed every time the port configuration is modified but not saved with the SAVE CONF command.

The "Not Refreshed (INIT)" message is displayed every time the port configuration is modified but not refreshed with the INIT PO: command.

Detail of the TELNET port parameters


LOWPO: Identifier of the Abilis CPX lower level port
NONE 1 - 999, NONE

It sets the Abilis CPX lower level port. It can only be an TCP port.

Value "NONE" isolates the TELNET port.


TYPE: Port type
USER USER

This parameter is used for setting how the port has to behave if data compression is active.

The port connected to the X.25 network is defined NETWORK port; the one connected to the user equipment USER port.

The NETWORK port sends compressed data and expands the received ones; the USER port compresses the received data and sends the expanded ones.

The TELNET port can be only USER.

warning! The changes made on this parameter are immediately activated, without the need of initialisation commands.


MCAU: Cause code modification in CLEAR packets sent
NO YES, NO

If MCAU is set to NO, Abilis CPX transports, without any changes, the cause and diagnostic code of the CLEAR packets; it also uses the F0 cause code and the suitable diagnostic one for all the CLEAR packets internally generated.

If MCAU is set to YES, Abilis CPX forces the cause code of the CLEAR packet sent to the value 00 (DTE originated), either for the external CLEAR and the internal ones

warning! The changes made on this parameter are immediately activated, without the need of initialisation commands.


PS: Maximum packet size
128 16, 32, 64, 128, 256, 512, 1024, 2048 (bytes)

It sets the maximum packet size (in bytes).


LOCPORT: Identifier of the IP local port used
23 23

It sets the local IP port used by the TELNET port. The IP number assigned by default to the TELNET process (according to recommendations) is 23.

This parameter has got only informative value and cannot be modified.


KEEPALIVE: Activation and setting of the "Keep-Alive" time-out
NO NO, 15 - 65535 (seconds)

It activates and set the value of the "Keep-Alive" time-out.

The "Keep-Alive" procedure, by sending the homonymous packets, keeps on the TCP connection even if data are not exchanged. The parameter set the idle time interval (in seconds) which precedes the activation of such procedure.

If the parameter is set to NO, the procedure is not active.

If its value belongs to the interval [15-65535], the procedure will be activated only when the correspondent time-out will run-over.


PSER: Identifier of the TELNET Server
TELNETS> from 0 up to 16 ASCII characters [33..126]

This parameter set the prompt of the commands interpreter of the Server TELNET port.

The local IP address, expressed in Dotted Decimal Notation and in square brackets (e.g. [xxx.xxx.xxx.xxx] ), always precedes the prompt defined by the user.

It is possible to use string from 0 up to 16 ASCII characters characters in the range [33..126], spaces are not allowed.

For deleting the TELNET Server identifier this parameter has to be left without value: "S P PO:xxx PSER:", where "xxx" stands for the TELNET port identifier.


AC: Activation of the Autoconnection mode for the TELNET server
YES NO, YES

It selects the autoconnection mode for the TELNET Server.

The default value is "YES". In this way the TELNET Server automatically generates a connection request, using information configured in parameters CDO: and UDO:, whenever it receives a login request from a Client TELNET process.


DT: Idleness disconnection time-out
15 0 - 255 (minutes)

Idle time interval after which the connection is closed (in minutes).


PWD: TELNET Server authentication password
YES from 0 up to 16 ASCII characters [33..126]

It sets the TELNET Server password, which is asked at the connection.

It is possible to use from 0 up to 16 ASCII characters in the range [33..126], spaces are not allowed. No differences between low and high case characters are made.

Once it is set the new password will be, encryptly, saved on disk through the command "SAVE CONF".

Every time the user wants to access the TELNET Server, he will need to insert the password.

For deleting the password this parameter has to be left without value: "S P PO:xxx PWD:", where "xxx" is the TELNET port identifier.


CDO: Called address of the TELNET Server outgoing call
00 from 1 up to 15 characters [0 - 9, #]

It sets the called address field of the TELNET Server outgoing call. The default value, jointly with the parameter AC: set to "YES", allows to connect to the Control port.


UDO: User data filed of the TELNET Server outgoing call
CP from 1 up to 12 characters [0 - 9, a - z, A - Z, #]

It sets the User data field [1] of the TELNET Server outgoing call. The default value, jointly with the parameter AC: set to "YES", allows to connect to the Control port.


SER: Number of TELNET Server processes
3 0 - 10

Number of Server processes predisposed on the TELNET port.


IPSRC: Accepted source IP address for incoming requests
* see table, *

The parameter configures the IP address of enabled source TELNET Client system.

The allowed values are shown in the following table:

HEX: 00000000 01000000 - 7EFFFFFF 80000000 - DFFFFFFF
DDN: 0.0.0.0 1.0.0.0 - 126.255.255.255 128.0.0.0 - 223.255.255.255

IP addresses of class D and E are not currently supported.

The character '*' means "any IP source address" and allows any User to query the Server.


IPSRCLIST: List of accepted source IP addresses for incoming requests
# ListName, #

The parameter configures a list of IP addresses of enabled TELNET Client systems.

It must be set to the name of an IP or IR or RU or MR list. The referenced list must already be defined in the Elements Lists service.

The value '#' stands for "no list".


PCLI: Identifier of the TELNET Client
TELNETC> from 0 up to 16 ASCII characters [33..126]

This parameter set the prompt of the commands interpreter of the Client TELNET port.

The local IP address, expressed in Dotted Decimal Notation and in square brackets (e.g. [xxx.xxx.xxx.xxx] ), always precedes the prompt defined by the user.

It is possible to use string from 0 up to 16 ASCII characters characters in the range [33..126], spaces are not allowed.

For deleting the TELNET Client identifier this parameter has to be left without value: "S P PO:xxx PCLI:", where "xxx" is the TELNET port identifier.


CDI: Called address of the TELNET Client incoming call
* from 1 up to 15 characters [0 - 9, *]

It sets the called address field of the TELNET Client incoming call.


UDI: User data filed of the TELNET Client incoming call
* from 1 up to 12 characters [0 - 9, a - z, A - Z, *]

It sets the User data field of the TELNET Client incoming call.


CLI: Number of TELNET Client processes
3 0 - 10

Number of Client processes predisposed on the TELNET port


Statistics of the TELNET port top

Example on how to show state and statistics of the TELNET port through the command D S:

[18:22:40] ABILIS_CPX: D S PO:TELNET

PO:905 ------------------------------------------------------------------------
TELNET STATE:READY    
       CH TYPE X25-State TCP-State LocAdd-LocPort        RemAdd-RemPort
       ------------------------------------------------------------------------
       1  CLNT READY     READY
       2  CLNT READY     READY
       3  CLNT READY     READY
       4  SERV READY     LISTEN    000.000.000.000-23
       5  SERV CONNECTED CONNECTED 192.168.000.060-23    192.168.000.002-1517
       6  SERV READY     LISTEN    000.000.000.000-23
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |         57|          8|CHAR       |       3168|        177|
       PCK        |         34|          8|CALL       |          0|          2|
       RESET      |          0|          0|
       ------------------------------------------------------------------------

Example on how to show extended statistics of the TELNET port through the command D SE:

[18:22:40] ABILIS_CPX: D SE PO:TELNET

PO:905 ------------------------------------------------------------------------
TELNET --- Cleared 000:00:53:11 ago, on 24/03/2004 at 14:42:56 ----------------
       CH TYPE X25-State TCP-State LocAdd-LocPort        RemAdd-RemPort
       ------------------------------------------------------------------------
       1  CLNT READY     READY
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |          0|          0|CHAR       |          0|          0|
       PCK        |          0|          0|CALL       |          0|          0|
       RESET      |          0|          0|
       ------------------------------------------------------------------------
       2  CLNT READY     READY
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |          0|          0|CHAR       |          0|          0|
       PCK        |          0|          0|CALL       |          0|          0|
       RESET      |          0|          0|
       ------------------------------------------------------------------------
       3  CLNT READY     READY
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |          0|          0|CHAR       |          0|          0|
       PCK        |          0|          0|CALL       |          0|          0|
       RESET      |          0|          0|
       ------------------------------------------------------------------------
       4  SERV READY     LISTEN    000.000.000.000-23
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |          0|          0|CHAR       |          0|          0|
       PCK        |          0|          0|CALL       |          0|          0|
       RESET      |          0|          0|
       ------------------------------------------------------------------------
       5  SERV CONNECTED CONNECTED 192.168.000.060-23    192.168.000.002-1517
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |         57|          8|CHAR       |       3168|        177|
       PCK        |         34|          8|CALL       |          0|          1|
       RESET      |          0|          0|
       ------------------------------------------------------------------------
       6  SERV READY     LISTEN    000.000.000.000-23
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SEG        |         53|          7|CHAR       |       3015|        163|
       PCK        |         31|          7|CALL       |          0|          1|
       RESET      |          0|          0|
       ------------------------------------------------------------------------

The information "Cleared DDD:HH:MM:SS ago, at DD/MM/YYYY HH:MM:SS", referred by the extended statistics, shows the elapsed time from the last reset of the statistics (by the format "days:hours:minutes:seconds") and date/time of its execution (by the format "day/month/year" and "hours:minutes:seconds").

Detail of the state fields and statistics of the TELNET port


STATE: Current state of the TELNET port
READY, DOWN, ERR

It shows the current state of the the TELNET port.

Driver States Meaning Values shown in:
System Log Events Log Display LCD
TELNET READY ...     RD
DOWN ...     DN
ERR Software error, contact the Abilis assistance     NA


CH Channel identifier
0 - (SER: + CLI:)

It shows the number of channel on the TELNET port. The maximum number of the available channels is given by the number of Server processes (configuration parameter SER:) summed to the number of Client ones (configuration parameter CLI:).


TYPE Process type
SERV, CLNT

It shows the type of the process active on the channel: the abbreviation "SERV" identifies the Server process, the one "CLNT" the Client process.


X25-State Connection state
READY, LISTEN, CALLING, CONNECTED, CLEARING, CLEARED, ERR

It shows the current state of the connection, towards the Connection Oriented Router.

States Meaning
READY Session is ready to send the connection request
LISTEN Session is ready to receive the connection request
CALLED Session is establishing the connection
CALLING
CONNECTED Session is connected
CLEARED Session is disconnecting
CLEARING
ERR Software error, contact the Abilis assistance


TCP-State Connection state towards the TCP port
DOWN, READY, LISTEN, CALLING, CONNECTED, CLEARING, CLEARED, ERR

It shows the current state of the connection, towards the TCP port.

States Meaning
DOWN The parameter LOWPO: is set to NONE or the driver is not able to connect to the TCP lower level port
READY Connection is closed
LISTEN Connection is active and it is waiting to receive/send connection requests
CALLED Connection is going to be established
CALLING
CONNECTED Connection is active
CLEARING Connection is going to be closed
CLEARED
ERR Software error, contact the Abilis assistance


LocAdd IP local address used by the connection
0 - 255.255.255.255

It shows the IP local address used by the connection, whose state has not to be READY.


LocPort IP local port used by the connection
0 - 65.535

It shows the IP local port used by the connection, whose state has not to be READY.


RemAdd IP remote address used by the connection
0 - 255.255.255.255

It shows the IP remote address used by the connection, whose state has not to be READY.


RemPort IP remote port used by the connection
0 - 65.535

It shows the IP remote port used by the connection, whose state has not to be READY.


SEG Overall number of segments received/sent in all the sessions
0 - 4.294.967.295

The counter SEG (INPUT) is incremented every time a packet is received, while the counter SEG (OUTPUT) every time a packet is sent.


CHAR Overall number of characters received/sent in all the sessions
0 - 4.294.967.295

The counter CHAR (INPUT) is incremented every time a packet is received, while the counter CHAR (OUTPUT) every time a packet is sent.


PCK Overall number of packets received/sent in all the sessions
0 - 4.294.967.295

The counter PCK (INPUT) is incremented every time a packet is received, while the counter PCK (OUTPUT) every time a packet is sent.


CALL Overall number of calls sent/received in all the sessions
0 - 4.294.967.295

The counter CALL (INPUT) is incremented every time a connection request is received, while the counter CALL (OUTPUT) every time a connection request is sent.


RESET Overall number of resets sent/received in all the sessions
0 - 4.294.967.295

The counter RESET (INPUT) is incremented every time a Reset is received, while the counter RESET (OUTPUT) every time a Reset is sent.


Detail of the extended statistics of the TELNET port


SEG Number of segments received/sent by the session
0 - 4.294.967.295

The counter SEG (INPUT) is incremented every time a packet is received, while the counter SEG (OUTPUT) every time a packet is sent by the session.


CHAR Number of characters received/sent by the session
0 - 4.294.967.295

The counter CHAR (INPUT) is incremented every time a packet is received, while the counter CHAR (OUTPUT) every time a packet is sent by the session.


PCK Number of packets received/sent by the session
0 - 4.294.967.295

The counter PCK (INPUT) is incremented every time a packet is received, while the counter PCK (OUTPUT) every time a packet is sent by the session.


CALL Number of calls sent/received by the session
0 - 4.294.967.295

The counter CALL (INPUT) is incremented every time a connection request is received, while the counter CALL (OUTPUT) every time a connection request is sent by the session.


RESET Number of resets sent/received by the session
0 - 4.294.967.295

The counter RESET (INPUT) is incremented every time a Reset is received, while the counter RESET (OUTPUT) every time a Reset is sent by the session.


Commands of the TELNET port top

While the TELNET Server process is running, the User can access the TELNET port commands pressing the button combination <Ctrl+P>.

As a consequence of this action, the prompt of the TELNET Server, configured in the parameter PSER:, will be displayed.

The user can leave the command exchange procedure and start the data exchange one through pressing again the button combination <Ctrl+P>.

The following table shows the list of the available commands for the command interpreter of the TELNET port:

Command Description Notes
OPEN It requests to open a connection with a TELNET Server process hosting on the remote equipment identified by the specified IP Only TELNET Client
CLOSE It requests the session to be closed  
CLR It requests the session to be closed  

Detail of the TELNET port commands


OPEN Open connection
OPEN xxx.xxx.xxx.xxx

This command, available only on TELNET Client processes, allows the User to open a connection with the TELNET Server process, hosting on the remote equipment identified by the specified IP.


CLOSE Close connection

It requests the session to be closed.


CLR Close connection
CLR

It requests the session to be closed.


[1] The parameter "UDO:" always refers to the user data, starting from the 5th byte. If the settings of the parameter "UDO:" need the user data, they will be set starting from the 5th byte and in the missing position (from 1st to 4th) the sequence "01000000" will be added.

printPrint this page