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.
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.
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.
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
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
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").
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.
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.
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 |
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.