The HTTP port is sued by the Abilis CPX to implement the homonymous protocol.
Generally the HyperText Transfer Protocol (HTTP) is an applicative layer protocol and belongs to the TCP/IP family. It transfers hyper textual information and it uses the transport service of Connection Oriented type, provided by the protocol TCP/IP.
...
The HTTP port implements the HyperText Transfer Protocol and it is labelled within the Abilis CPX with the acronym "HTTP". it is provided with the parameters described in this section.
Here is an example on how to display the HTTP port parameters. Shown values are the default ones.
[18:45:45] ABILIS_CPX: D P PO:HTTP PO:915 ------------------------------------------------------------------------ HTTP lowpo:901 ACT:NO locport:80 sesnum:12 COOKIE-TOUT:1440 IPSRC:* IPSRCLIST:# WDIR:C:\APP\HTTP\ START-PAGE:SYS (/sys/cpx.htm)
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 high case parameters it is enough to execute the initialization command INIT PO:.
LOWPO: | Identifier of the lower TCP port |
901 | 1 - 999, NONE |
It sets the Abilis CPX lower layer port. It can be a TCP port only.
The value "NONE" isolates the HTTP port.
ACT: | Run time activation/deactivation flag |
NO | NO, YES |
This parameter allows to run-time activate/deativate the HTTP protocol functionalities above mentioned. If the parameter is set to "NO", even if the HTTP port is configured and active, it won't provided any service.
locport: | Identifier of the IP local port used |
80 | 80 |
It sets the IP local port used by the HTTP one. Recommendations reserve the number 80 for the HTTP service.
This is an informative parameter and its value cannot be changed.
sesnum: | Maximum number of HTTP sessions |
12 | 0..255 |
It sets the maximum number of sessions on the HTTP port.
COOKIE-TOUT: | Cookie time-out |
1440 | 5..65535 min. |
It sets the cookie time-out in minutes.
IPSRC: | IP address of the enabled source |
* | see table, * |
This parameter configures the IP address of the enabled source of incoming requests.
The allowed values are showed by 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 address of class D and E are not actually supported.
The character '*' means "any IP source address".
IPSRCLIST: | List of the IP addresses of the enabled sources |
# | ListName, # |
This parameter configures a list of the enabled sources of incoming requests.
A string of maximum 20 characters in the range [0..9, a..z, A..Z, _] is accepted. The configured name must correspond to the name of a list of IP addresses or the name of a list of IP addresses ranges or the name of a Rule list or the name of a Master Rule list. The referenced list must already be defined in the Elements Lists service.
The character '#' means "no list".
WDIR: | Directory where temporary files are saved |
C:\APP\HTTP\ | see below |
This parameter selects the directory where temporary files are saved. It cannot be empty. It must be a physical full path in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. The maximum accepted working directory string length is 128 characters. Case is preserved and spaces are allowed, but strings holding spaces must be written between quotation marks (E.g.: "C:\My dir\").
START-PAGE: | Start page |
SYS (/sys/cpx.htm) | ListName, # |
This parameter selects the HTTP start page. The user can select between the "SYS" value, i.e. the default system start page corresponding to the "/sys/cpx.htm", and a specific file, whose name must be specified with the related URL (Uniform Resource Identifier)(E.g.: "/default.htm" or "/root/home.htm" ). The maximum accepted start page string length is 128 characters. Case is preserved and spaces are allowed, but strings holding spaces must be written between quotation marks (E.g.: "/My url/index.htm").
Example on how to show state and statistics of the HTTP port through the command D S:
[18:45:45] ABILIS_CPX: D S PO:HTTP PO:915 ------------------------------------------------------------------------ HTTP STATE:READY MAX-CONN:12 ------------------------------------------------------------------------ CH State LocAdd-LocPort RemAdd-RemPort ------------------------------------------------------------------------ 0 LISTENING 000.000.000.000-80 1 LISTENING 000.000.000.000-80 2 LISTENING 000.000.000.000-80 3 LISTENING 000.000.000.000-80 4 LISTENING 000.000.000.000-80 5 LISTENING 000.000.000.000-80 6 LISTENING 000.000.000.000-80 7 LISTENING 000.000.000.000-80 8 LISTENING 000.000.000.000-80 9 LISTENING 000.000.000.000-80 10 LISTENING 000.000.000.000-80 11 LISTENING 000.000.000.000-80 -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---| CHR | 0| 0|REQ | 0| | REQ-GET | 0| |REQ-POST | 0| | REQ-PUT | 0| | ------------------------------------------------------------------------
Example on how to show extended statistics of the HTTP port through the command D SE:
[11:32:37] ABILIS_CPX: D SE PO:HTTP PO:915 ------------------------------------------------------------------------ HTTP --- Cleared 000:00:00:00 ago, on 15/03/2004 at 17:46:44 ---------------- -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---| CHR | 0| 0|REQ | 0| | REQ-GET | 0| |REQ-POST | 0| | REQ-PUT | 0| | ------------------------------------------------------------------------ CH:0 -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---| CHR | 0| 0|REQ | 0| | REQ-GET | 0| |REQ-POST | 0| | REQ-PUT | 0| | ------------------------------------------------------------------------ CH:1 -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---| CHR | 0| 0|REQ | 0| | REQ-GET | 0| |REQ-POST | 0| | REQ-PUT | 0| | ------------------------------------------------------------------------ CH:2 -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---| CHR | 0| 0|REQ | 0| | REQ-GET | 0| |REQ-POST | 0| | REQ-PUT | 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 HTTP port |
INACTIVE, DOWN, READY, ERR |
It shows the current state of the HTTP port driver.
Driver | States | Description | Values shown in: | ||
---|---|---|---|---|---|
System Log | Events Log | Display LCD | |||
HTTP | INACTIVE | The run time activation flag ACT: is set to "NO". | IN | ||
DOWN | The run time activation flag ACT: is set to "YES", but Listen(s) to lower TCP port fail. | DN | |||
READY | The run time activation flag ACT: is set to "YES", and HTTP is connected to lower TCP port. | RD | |||
ERR | Software error. Contact Abilis CPX assistance. | NA |
MAX-CONN: | Current maximum number of connections |
0..255 |
It shows the current maximum number of HTTP connections.
CHR | Number of characters sent/received by the port |
0 - 4.294.967.295 |
The counter CHR (INPUT) is incremented every time data are received by the port. The counter CHR (OUTPUT) is incremented every time data are sent by the port.
REQ | Number of requests received by the port |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a requests is received by the port.
REQ-GET | Number of GET requests received by the port |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a GET requests is received by the port.
REQ-POST | Number of GET requests received by the port |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a POST requests is received by the port.
REQ-PUT | Number of GET requests received by the port |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a PUT requests is received by the port.
CH | Connection identifier |
0..255 |
It is the connection identifier.
State | Connection state |
CLOSED, LISTENING, CALLED, CALLING, CONNECTED, READY, CLEARING, CLEARED, DESTRUCTING, DOWN, READY, ERR |
It shows tha current state of the HTTP connection.
LocAdd-LocPort | Local IP address and Local port |
000.000.000.000..255.255.255.255 - 1..65535 |
It show the local IP address, in Dotted Decimal Notation, and the local TCP/IP port.
RemAdd-RemPort | Remote IP address and Remote port |
000.000.000.000..255.255.255.255 - 1..65535 |
It show the remote IP address, in Dotted Decimal Notation, and the remote TCP/IP port.
CHR | Number of characters sent/received by the single connection |
0 - 4.294.967.295 |
The counter CHR (INPUT) is incremented every time data are received by the single connection. The counter CHR (OUTPUT) is incremented every time data are sent by the single connection.
REQ | Number of requests received by the single connection |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a requests is received by the single connection.
REQ-GET | Number of GET requests received by the single connection |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a GET requests is received by the single connection.
REQ-POST | Number of GET requests received by the single connection |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a POST requests is received by the single connection.
REQ-PUT | Number of GET requests received by the single connection |
0 - 4.294.967.295 |
The counter REQ (INPUT) is incremented every time a PUT requests is received by the single connection.