General and system commands

Revised for CPX 4.7.0.
System accessing commands
General configuration of the system
System information
Commands relating to date and time
CPU Load Measurements
Logging functionalities
Configuration validating and saving
System updating and restarting
Test and trace functionalities

Other commands


System accessing commands top


LOGIN Login (User)
LOGIN
LOGIN access-level

It shows the current privilege level, through which the User accessed the Control Port.

[11:38:01] ABILIS_CPX: LOGIN

Currently logged as SUPERUSER

On the contrary, if an access level is specified, the command will login the User to the Control Port using the requested privilege.

Login Access Level Description
ADMINISTRATOR (or ADMIN) Login as Administrator
SUPERUSER (or SUPER) Login as Super User
USER Login as User

LOGOUT Logout (User)
LOGOUT

It closes the current configuration session and prompts the login request.

If in the current configuration session the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the configuration session is not closed and the Control Port prompt is shown.

[11:38:04] ABILIS_CPX: LOGOUT

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? Y

VALIDATION IN PROGRESS...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

[11:56:43] ABILIS_CPX:

warning! In this case, the command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.

In case of negative answer, the configuration session is closed but the configuration is not saved.

[12:00:31] ABILIS_CPX: LOGOUT

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)?N
Login:

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.

[11:38:04] ABILIS_CPX: LOGOUT

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? A

[11:54:02] ABILIS_CPX:

CLOSE Close the configuration session (User)
CLOSE

It closes the current connection to the Control Port.

If the User was connected to the Control Port through a PAD port (TELNET port), then the command interpreter of the PAD port (TELNET port) will be prompted.

If the User was connected to the Control Port through a TELNET port, then the command interpreter of the TELNET port will be prompted.

If the User executed this command through the off-line configurator, it will terminate the configurator and go back to the MS-DOS prompt.

If in the current configuration session the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the connection is not closed and the Control Port prompt is shown.

[11:38:04] ABILIS_CPX: CLOSE

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? Y

VALIDATION IN PROGRESS...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

[11:56:43] ABILIS_CPX:

warning! In this case, the command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.

In case of negative answer, the connection to the Control Port is closed but the configuration is not saved.

[11:38:04] ABILIS_CPX: CLOSE

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? N

CLR 00 00

[62.110.59.130] TELNETS>

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.


EXIT Exit program (Available only in off-line Configurator)
EXIT

It terminates the execution of the off-line configurator program and goes back to the MS-DOS prompt.

If during off-line configurator program execution the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the off-line configurator program is not terminated and the Control Port prompt is shown.

In case of negative answer, the program is terminated but the configuration is not saved.

 - CONFIG - v. 1022    - 12/03/2004 - For CPX release 1513 - build 1513 -
 - (c) 1994/2004 - Abilis -

Logged as SUPERUSER

[12:33:21] ABILIS_CPX: S P PO:0 PS:128

COMMAND EXECUTED

[12:33:32] ABILIS_CPX: EXIT

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? N 

Program exits.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.


QUIT Quit program (Available only in off-line Configurator)
QUIT

It terminates the execution of the off-line configurator program and goes back to the MS-DOS prompt.

If during off-line configurator program execution the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the off-line configurator program is not terminated and the Control Port prompt is shown.

In case of negative answer, the program is terminated but the configuration is not saved.

 - CONFIG - v. 1022    - 12/03/2004 - For CPX release 1513 - build 1513 -
 - (c) 1994/2004 - Abilis -

Logged as SUPERUSER

[12:33:21] ABILIS_CPX: S P PO:0 PS:128

COMMAND EXECUTED

[12:33:32] ABILIS_CPX: QUIT

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? N 

Program exits.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.

General configuration of the system top


D G Display General (User)
D G

It shows the parameters of the general configuration of the system. Currently used values and the new configuration values are shown.

Not all the shown parameters can be changed. The note "<Read Only>" refers the not modifiable ones.

Here is an example of the command execution:

ABILIS_CPX: D G

- Not Saved (SAVE CONF) -------------------------------------------------------

         Conf.Value Act.Value                Description
------------------------------------------------------------------------------
vconn:        32        32    Max number of VOICE connections [32..255]
VDIGITS:       3         -    Number of digits used to dial a number [1..4]
VTOUT:         3         3    VOICE connections protection timeout [1..5 sec.]
VCALLT:        5         -    VOICE calling timeout [1..60 sec.]
VALTT:        20         -    VOICE alerting timeout [1..60 sec.]
DTMF:    OUTBAND         -    DTMF processing mode [NO, INBAND, OUTBAND]
DTMFHI:        8         -    Change gains for High tone frequency [1..15]
DTMFLO:        8         -    Change gains for Low tone frequency [1..15]
FDRELAY:     YES         -    Fax/Data relay [NO, YES]
FDLEVEL:       9         -    Generated Fax/Data level in 1 dB step [0..15]
tact:         NO        NO    TRACE activation state [NO, YES]
sound:        ON        ON    Alarm sound enable/disable [OFF, ON]
ndict:         -         0    Number of available dictionaries     <Read Only>
lccomp:        -         0    Max number of compressed LC          <Read Only>
fdict:         -         0    Number of free dictionaries          <Read Only>
hwint:         -     MFIDE    Front Panel/WatchDog interface type  <Read Only>
isapnp:      YES       YES    Enable/disable PNP for ISA cards [NO, YES]
------------------------------------------------------------------------------
DBGF:      ALL
CONTACT:
SYSNAME:
LOCATION:
SYSUPTIME: 0 days 01:20:27 (Tuesday 06/04/2004 13:13:59)           <Read Only>
SYSRBTIME: # (System Reboot time not set)
DATE&TIME: Tuesday 06/04/2004 14:34:26 (GMT+2.00)                  <Read Only>
TIMEZONE:  CET - Central Europe (Rome, Paris, Berlin, Prague, Brussels)

The Not Saved (SAVE CONF) message is shown every time some general parameter is changed, but the modification is not saved with the SAVE CONF command.


S G Set General (Administrator)
S G par:val [par:val]

It sets one or more parameter of the general configuration of the system.

The parameter list, defined in the command, is left to right evaluated: parameters are set one after the other, starting from the leftmost.

Command evaluating will terminate if one of the following events will occur:

All the parameters evaluated, before the error occurrence, will get the new value; the other ones will not be changed.

To activate the new values set, configuration must be saved and the system restarted.

Not all of the shown parameters can be changed. The note "<Read Only>" refers the not modifiable ones.

If the command is executed specifying a read only parameter, the message "COMMAND EXECUTED" will be shown, but the parameter value has not been changed.


SOUND DISABLE Disable alarm sound generation (User)
SOUND DISABLE

It disables the signal acoustic generation on alarm situation occurrence.

The command acts immediately and doesn't need the system restart. it is possible to check its activation through executing the command D G.

If the system has been restarted, the status of the sound alarm generation will be the one previously set by the command S G.


SOUND ENABLE Enable alarm sound generation (User)
SOUND ENABLE

It enables the signal acoustic generation on alarm situation occurrence.

The command acts immediately and doesn't need the system restart. it is possible to check its activation through executing the command D G.

As it was already described (SECTION XX CHAPTER YY), alarms are detected every 30 seconds by a proper procedure, so also the acoustic signal generation comes every 30 seconds.

If the system has been restarted, the status of the sound alarm generation will be the one previously set by the command S G.

System Information top


D I Display Information (User)
D I
D I [<version>]

It displays the software version currently in use on the Abilis CPX, information about system memory and files on the disk.

NoFloppyBasedSystem On HD/CF based system only, the option "<version>" allows to displays information about the specified version directory.
The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

Here is an example of the command execution:

[12:25:58] ABILIS_CPX: D I
 
        Abilis CPX - Ver. 1513 - 02/04/2004 - Build 1513 - 02/04/2004
                            (c) 1994/2004 - Abilis

CPX Serial Number: 00000.00000.00000.00007

Free/Total Memory: 40.713.916/67.108.864  Largest Block: 40.359.704
Free/Used/Total HD/CF space (in KB): 5.096/10.228/15.324

File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
CPX.RTB        .......   06/04/2004   15:11:02      1721170
DRIVERS.CFG    v.4.7     06/04/2004   15:14:08         8192   Ok
DRIVERS.BCK    v.4.7     06/04/2004   15:10:44         8192   Ok
CPX.LOG        .......   06/04/2004   15:14:08        10240
CPX.DBG        .......   06/04/2004   15:13:54        10240
CPX.XCP        .......   06/04/2004   15:13:54        10240
TIMEINFO.DAT   .......   06/04/2004   15:13:54           22
ESB2.BIN       v.0013    17/12/2003   13:27:44        17408
FDSP.BIN       v.1.40c   17/12/2003   13:27:44        52224
BUSYTONE.BIN   .......   09/12/2003   12:40:04         3072
READTONE.BIN   .......   17/12/2003   13:27:44         2048
RINGTONE.BIN   .......   17/12/2003   13:27:44         2048
CPX.CSS        .......   17/07/2003   19:27:18         2267
CPX.HTM        .......   15/03/2004   22:21:34          737
SYS.HTM        .......   15/03/2004   22:21:34          750
ABILIS.GIF     .......   28/05/2001   16:52:48         1502
MATT.GIF       .......   16/03/2004   15:40:00         1142
SRVSSL.CER     .......   17/02/2004   10:53:42          806
CLISSL.CER     .......   17/02/2004   10:53:42          806
SRVSSL.KEY     .......   17/02/2004   10:53:42          963
CLISSL.KEY     .......   17/02/2004   10:53:42          951

Other system relevant files:

File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
C:\APP\DHCP\DHCP.BND
               v.1.0     06/04/2004   15:14:04        25600

Other files in 'C:\1513':

File                     Date         Time             Size   Note
-------------------------------------------------------------------------------

The first part of the output, is dedicated to the information about version and release date of the software.
The second one shows information about Abilis CPX serial number, system memory and disk.
The third part of the output displays information related to system relevant files, i.e. files used by Abilis during its working (e.g. configuration and configuration backup files, System Log file, ...).

The "Other system relevant files" section displays information about any other system relevant additional files (e.g. DHCP bindings file, ...).

The "Other files:" section shows information about any other additional file that is found on the disk, in the current working version directory.

Eventual detected errors are highlighted with the string "ERR[xx]", where "xx" is the error code detected; it should be eventually told to the Abilis CPX assistance.

warning!On floppy based systems, the command works on the floppy disk. If it is not inserted or any read error occurs, Abilis CPX will show a signalling message.


D VER Display Versions (User)
D VER

It shows the version of the software and its modules currently in used by the Abilis CPX.

Here is an example of the command execution:

[18:38:04] ABILIS_CPX: D VER
 
        Abilis CPX - Ver. 1513 - 02/04/2004 - Build 1513 - 02/04/2004
                            (c) 1994/2004 - Abilis

CX        : v. 1168    - 10/03/2004       CP        : v. 1745    - 02/04/2004
COR       : v. 1013    - 18/12/2003       CNFG      : v. 1446    - 01/04/2004
COMMON    : v. 1316    - 01/04/2004       CPR/DCP   : v. 1004    - 04/09/2003
PCISRV    : v. 1023    - 12/02/2004       PNPMAN    : v. 1013    - 12/02/2004
HWINT     : v. 1026    - 01/08/2003       FP        : v. 1008    - 11/07/2003
MFIDE     : v. 1014    - 03/10/2003       SYNC-HSCB : v. 1014    - 07/05/2003
CRYPT     : v. 1005    - 09/09/2003       SYNC-ESB  : v. 1072    - 30/09/2003
SDLC      : v. 1005    - 16/01/2003       SYNC-ESB2 : v. 1105    - 01/04/2004
LAPB      : v. 1001    - 02/06/2003       HDLCT     : v. 1005    - 03/09/2003
X25       : v. 1003    - 21/10/2003       FR        : v. 1015    - 12/02/2004
MLM       : v. 1025    - 05/12/2003       ML        : v. 1040    - 11/11/2003
ASYNC     : v. 1002    - 10/09/2003       VOICE     : v. 1028    - 12/06/2003
PAD       : v. 1005    - 23/09/2003       VOICERTR  : v. 1006    - 12/06/2003
SIM       : v. 1006    - 29/09/2003       EBIB      : v. 1023    - 12/06/2003
ETH       : v. 1008    - 10/04/2002       EPIB      : v. 1029    - 12/06/2003
ETH100    : v. 1068    - 05/03/2004       EIR       : v. 1009    - 13/11/2003
TR        : v. 1009    - 31/03/2004       ACNT      : v. 1008    - 05/09/2003
IPLAN     : v. 1031    - 31/03/2004       ISDN      : v. 1008    - 15/07/2002
IPRTR     : v. 1154    - 31/03/2004       EBISDN    : v. 1029    - 12/06/2003
ICMP      : v. 1027    - 17/10/2003       EPISDN    : v. 1029    - 12/06/2003
TCP       : v. 1046    - 17/10/2003       BRIO      : v. 1019    - 16/01/2003
UDP       : v. 1027    - 05/03/2004       LAPD      : v. 1003    - 16/01/2003
TELNET    : v. 1015    - 29/09/2003       EBLAPD    : v. 1003    - 16/01/2003
HTTP      : v. 1106    - 02/04/2004       EPLAPD    : v. 1003    - 16/01/2003
SNMP      : v. 1531    - 12/03/2004       Q931      : v. 1004    - 21/10/2003
RIP       : v. 1037    - 18/02/2004       EBQ931    : v. 1004    - 21/10/2003
SNTP      : v. 1012    - 01/08/2003       EPQ931    : v. 1004    - 21/10/2003
DNS       : v. 1028    - 29/09/2003       sQ931     : v. 1004    - 21/10/2003
XTP       : v. 1018    - 17/10/2003       PLINKE    : v. 1060    - 03/03/2004
NAT       : v. 1081    - 14/11/2003       PPP       : v. 1094    - 18/02/2004
SSH       : v. 1046    - 18/02/2004       POECLI    : v. 1020    - 12/02/2004
DHCP      : v. 1055    - 18/02/2004       POEAC     : v. 1036    - 04/02/2004
OSPF      : v. 1096    - 20/03/2004       DUMMY     : - Module not present -
FTPSRV    : v. 1112    - 06/11/2003       BRIDGE    : v. 1024    - 29/10/2003
ARCHIVE   : v. 1086    - 25/02/2004       WL        : v. 1084    - 20/01/2004
GC        : - Module not present -        WGB       : - Module not present -
SSL       : v. 1043    - 27/01/2004       TRFA      : v. 1097    - 02/04/2004

The first part is dedicated to the information about version and release date of the software.

In the second one, there is a list of all the Abilis CPX software modules. The string "Module not present" refers to the modules that do not belong to the Abilis CPX software currently in use.

Commands relating to date and time top


D T Display Time (User)
D T

It shows date and system local time, time zone and modality of "Standard" or "Daylight Savings" time currently in use.

Here is an example of the command execution.

[18:22:24] ABILIS_CPX: D T
 
Current Local Time    : Tuesday 06/04/2004 14:49:38 (GMT+2.00)
Local Time Zone       : Central Europe (Rome, Paris, Berlin, Prague, Brussels)
Currently Observing   : Daylight Savings Time (DST)

D TE Display Time in extended format (User)
D TE

It shows date and system local time, current time referred to the GMT time zone, the local time zone, modality of "Standard" or "Daylight Savings" time currently in use and information about the date it will change.

Here is an example of the command execution:

[18:22:24] ABILIS_CPX: D TE

Current Local Time     : Tuesday 06/04/2004 14:49:08 (GMT+2.00)
Current GMT Time       : Tuesday 06/04/2004 12:49:08
Local Time Zone        : CET - Central Europe (Rome, Paris, Berlin, Prague...
Currently Observing    : Daylight Savings Time (DST)
DST time will start on : Sunday 27/03/2005 at 02:00
DST time will end on   : Sunday 31/10/2004 at 03:00

S T Set Time (Administrator)
S T dd/mm/yyyy:hh:mm:ss

It sets the date and system time using the format dd/mm/yyyy:hh:mm:ss.

Date and time inserted format must match the default one, using the same separators.

CPU Load Measurements top


D CPU Display CPU load percentages (User)
D CPU

It gives an estimated percentage of the CPU load for the last 1 second, 15 seconds and 5 minutes.

[09:56:19] ABILIS_CPX: D CPU

+---------+--------------+--------------+--------------+
|         | Last 1 sec.  | Last 15 sec. | Last 5 min.  |
+---------+--------------+--------------+--------------+
|CPU Load |       3%     |      11%     |       1%     |
+---------+--------------+--------------+--------------+

Logging functionalities top


C L Clear System Log (Administrator)
C L

It clears the System Log.

warning! It deletes data on the disk. If the disk is not inserted or any read/write error occurs, Abilis CPX will show a signalling message.


D L Display System Log (User)
D L [dd/mm/yyyy] [hh:mm:ss] [PO:xxx,yyy,...]

It displays the content of the System Log starting from the oldest event.

By specifying the date, the command will display the events occurred since the 00:00:00 of the specified date.

If only the time is specified, the command will show the events occurred since the current date and the specified time.

By specifying time and date, the command will show all the events occurred since the time and date specified.

Doesn't matter the defining sequence of time and date.

Date and time formats must match the indicated ones, by using the same separators. The year field is an exception, because it can accept two or four digits. Moreover, if the seconds are not specified, the Abilis CPX will set them automatically to zero, while if the year is not specified the current one will be used.

It is also possible to define a port list (maximum 50 elements) that allows displaying the events relating to the ports specified in it.

Ports value must be in the interval [0 - 999] and separated by the character "," (comma), without spaces.

warning! The command reads data from the disk. If the disk is not inserted or any read error occurs, Abilis CPX will show a signalling message.


START L Start System Log real-time displaying (User)
START L [PO:xxx,yyy,...]

It makes possible that System Log events are simultaneously sent to the current Control Port session.

[14:09:03] ABILIS_CPX: START L

Current Local Time: Tuesday 06/04/2004 14:50:37 (GMT+2.00)

Start System Log content real-time logging (Type CTRL+C + ENTER to stop):

06/04/2004 15:16:00 I:p1   SYN:UP.00
06/04/2004 15:16:02 I:p1   SYN:UP.01
06/04/2004 15:22:30 System Alive
06/04/2004 15:23:12 I:p2   SYN:UP.11
06/04/2004 15:23:15 I:p201 LAPB:CONN
06/04/2004 15:23:15 I:p205 LAPB:CONN
06/04/2004 15:23:15 I:p301 X25:RDY
06/04/2004 15:23:15 I:p305 X25:RDY    

The command is aborted sending Ctrl+C<enter>.

It is also possible to define a port list (maximum 50 elements) that allows displaying the events relating to the ports specified in it.

Ports value must be in the interval [0 - 999] and separated by the character "," (comma), without spaces.

In the case that no System Log event is generated within an interval of 5 minutes, a "System Alive" message is displayed to signal that the connection with the Control Port is still open and that the command is still in progress.


C LDM Clear Log Debug Memory (Administrator)
C LDM

It clears the Events Log stored in the memory.


D LDM Display Log Debug Memory (User)
D LDM [dd/mm/yyyy] [hh:mm:ss] [PO:xxx,yyy,...] [E:val]

It displays the content of the Events Log, stored in the memory, starting from the oldest event.

By specifying the date, the command will display the events occurred since the 00:00:00 of the specified date.

If only the time is specified, then the command will show the events occurred since the current date and the specified time.

By specifying time and date, the command will show all the events occurred since the time and date specified.

Doesn't matter the defining sequence of time and date.

Date and time formats must match the indicated ones, by using the same separators. The year field is an exception, because it can accept two or four digits. Moreover, if the seconds are not specified, the Abilis CPX will set them automatically to zero, while if the year is not specified the current one will be used.

It is also possible to define a port list (maximum 50 elements) that allows displaying the events relating to the ports specified in it.

Ports value must be in the interval [0 - 999] and separated by the character "," (comma), without spaces.

The parameter "E:" specifies the mnemonic of the correspondent events class to be displayed.

Events classes are the following:

Mnemonic Events classes
DIAG Events related to port diagnostic and status.
COR Events related to the Connection Oriented Router.
MLM Events related to the Multi Link Manager driver.
EIR Events related to the Enhanced ISDN Router.
EIRE Extension of the events class related to the Enhanced ISDN Router.
PPP Events related to the Point-to-Point Protocol driver.
ML Events related to the Multi Links driver.

it is possible to specify more than one events class at the same time, by separating the mnemonics with the character "," (comma), without space.

For example the command "D LDM E:COR,MLM" will display the events classes COR and MLM.

By omitting the parameter "E:", or specifying "E:ALL", the command will show all the events present in the log.


START LDM Start Events Log real-time displaying (User)
START LDM [PO:xxx,yyy,...] [E:val]

It makes possible that Events Log events are simultaneously sent to the current Control Port session.

[14:31:37] ABILIS_CPX: START LDM

Current Local Time: Tuesday 06/04/2004 14:52:23 (GMT+2.00)

Start Debug Log content real-time logging (Type CTRL+C + ENTER to stop):

060404 145228 905     5 CallRx CG:                CD:00
              PID:01000000 UD:CP           FF:
060404 145228 905     5 Routing Match PR:0
060404 145228   0     2 CallTx CG:                CD:00
              PID:01000000 UD:CP           FF:
060404 145228   0     2 CallConnRx LSN:02 CG:                CD:00
              PID:01000000 UD:CP           FF:
060404 145228 905     5 CallConnTx LSN:02 CG:                CD:
              PID:         UD:             FF:
060404 145257 905     5 ClrRx F0:A3 LSN:02
060404 145257 905     5 ClrConfTx 00:00 LSN:02
060404 145257   0     2 ClrTx 00:00 LSN:02
060404 145257   0     2 ClrConfRx 00:00 LSN:02
¤

PREVIOUS COMMANDS ABORTED

[14:53:08] ABILIS_CPX:

The command is aborted sending Ctrl+C<enter>.

It is also possible to define a port list (maximum 50 elements) that allows displaying the events relating to the ports specified in it.

Ports value must be in the interval [0 - 999] and separated by the character "," (comma), without spaces.

The parameter "E:" specifies the mnemonic of the correspondent events class to be displayed. See D LDM command for the available events classes.

it is possible to specify more than one events class at the same time, by separating the mnemonics with the character "," (comma), without space.

By omitting the parameter "E:", or specifying "E:ALL", the command will send to the Control Port session all the events that are generated.

In the case that no event is generated within an interval of 5 minutes, a "System Alive" message is displayed to signal that the connection with the Control Port is still open and that the command is still in progress.


D LDD Display Log Debug Disk (User)
D LDD [dd/mm/yyyy] [hh:mm:ss] [PO:xxx,yyy,...] [E:val]

It displays the content of the Events Log, saved on disk, starting from the oldest event.

By specifying the date, the command will display the events occurred since the 00:00:00 of the specified date.

If only the time is specified, then the command will show the events occurred since the current date and the specified time.

By specifying time and date, the command will show all the events occurred since the time and date specified.

Doesn't matter the defining sequence of time and date.

Date and time formats must match the indicated ones, by using the same separators. The year field is an exception, because it can accept two or four digits. Moreover, if the seconds are not specified, the Abilis CPX will set them automatically to zero, while if the year is not specified the current one will be used.

It is also possible to define a port list (maximum 50 elements) that allows displaying the events relating to the ports specified in it.

Ports value must be in the interval [0 - 999] and separated by the character "," (comma), without spaces.

The parameter "E:" specifies the mnemonic of the correspondent events class to be displayed.

See D LDM command for the available events classes.

it is possible to specify more than one events class at the same time, by separating the mnemonics with the character "," (comma), without space.

For example the command "D LDD E:COR,PPP" will display the events classes COR and PPP.

By omitting the parameter "E:", or specifying "E:ALL", the command will show all the events present in the log.

warning! The command reads data from the disk. If the disk is not inserted or any read error occurs, Abilis CPX will show a signalling message.


SAVE DEBUG Save Debug Log on disk (Administrator)
SAVE DEBUG

It saves on disk the current Events Log.

warning! The command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.


C LE Clear Log Exception (Administrator)
C LE

It clears the Exception Log saved on the disk.

warning! The command works on the disk. If the disk is not inserted or any read error occurs, Abilis CPX will show a signalling message.


D LE Display Log Exception (User)
D LE

It displays the content of the Exception Log saved on the disk.

Information present in this Log is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.

warning! The command reads data from the disk. If the disk is not inserted or any read error occurs, Abilis CPX will show a signalling message.

Configuration validating and saving top


VALIDATE Validate Configuration (User)
VALIDATE

This command executed the validation of the configuration currently in use. Configuration validating has been introduced to ensure correct Abilis CPX configurations. By validation it is meant the explicit execution of a series of congruence controls made by Abilis CPX on some important configuration parameters. Base controls on the type and the interval of values, allowed by the configuration parameters, are implicitly carried out by configuration commands, however exists a series of verifications that cannot be executed during the normal routine of configuration. Particularly, configuration parameters of cards and boards are subject to validation.

The output of the validating procedure can be positive without demanding modifications to the configuration, or negative if the validation detects some incongruencies or imprecision in it.

If the command is successful the message "VALIDATION SUCCESSFULLY EXECUTED" will be also shown.

If the validation detects imprecision and it can automatically correct them, the command is however successfully executed. But in such case, the procedure expects the displaying of informative messages which signal to the User the changes, made on the configuration during the validation.

If the validation detects serious incongruencies, in the configuration, that cannot be automatically corrected, the outcome of the command is negative. In such case the procedure expects the displaying of the message "VALIDATION FAILED" and error messages for signalling the detected errors to the User.

The following example shows a successful validation; the procedure required some changes in the configuration (caused by the values of parameters of the same port or different ports connected to it; or caused by incongruencies with the port type).

[18:22:26] ABILIS_CPX: VALIDATE

VALIDATION IN PROGRESS...
PO:201 changed "N1" from 144 to 528 because PO:301 "PS" = 512
PO:1 changed "FRAME" from 144 to 528 because PO:201 "N1" = 528
PO:1 changed "CODING" from NRZI to NRZ because PO:201 is LAPB
VALIDATION FAILED

The following example shows an explicit validation failed because of some, particularly serious, errors detected in the configuration (inconsistent setting of two parameters of the same port, incongruencies between the parameter and the port type, sharing resources among two or more ports):

[18:22:26] ABILIS_CPX: VALIDATE

VALIDATION IN PROGRESS...
ERROR: PO:1 conflicting setting between "CODING" = NRZ and "CLK" = PCLK
ERROR: PO:302 invalid "LOWPO" = 321 type
ERROR: PO:321 "LOWPO" = 1 crossed setting
VALIDATION FAILED

SAVE CONF Save current configuration (Administrator)
SAVE CONF
SAVE CONF [<version>]

This command executes the validation of the configuration currently in use. If it is successful, it is saved on the file DRIVERS.CFG on the disk.

NoFloppyBasedSystem On HD/CF based system only, the option "<version>" allows to validate and save the current configuration on to file DRIVERS.CFG in the selected version directory.
The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

The configuration is saved and marked with a configuration state of "configuration saved but not yet loaded".
On the next restart of the Abilis CPX, if the settings of the saved configuration were correct, then the configuration state will become "valid configuration".

it is possible to check the current configuration state through the command D I. In correspondence of the just saved DRIVERS.CFG file, in the notes dedicated section, the string "Saved" will appear.
After the system restart, in correspondence of the just loaded DRIVERS.CFG file, in the notes dedicated section, the string "Ok" will appear.

If the validation and saving are both successful the message "SAVE EXECUTED" will be shown.

If the validation fails, the saving is NOT executed and the message "SAVE NOT EXECUTED" will be shown.

[16:15:50] ABILIS_CPX: SAVE CONF

VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

warning! The command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.


SAVE CONF BACKUP Backup current configuration (Administrator)
SAVE CONF BACKUP
SAVE CONF BACKUP [<version>]

It creates a backup copy (file DRIVERS.BCK) of the configuration currently saved on disk in the file DRIVERS.CFG.

The backup configuration is loaded at the Abilis CPX start, every time the one, saved in DRIVERS.CFG, is not valid or the same file is missing or corrupted.

Indeed, it is very important that the User makes backup only of those configuration correctly working.

The command will query the User for proceeding or not. The procedure is executed only in case of affirmative answer.

NoFloppyBasedSystem On HD/CF based system only, the option "<version>" allows to create a backup copy of the configuration file DRIVERS.CFG of the specified version directory. The backup file is always named DRIVERS.BCK and will be located in the specified version directory.
The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

Here are two examples of the command execution.

[18:29:04] ABILIS_CPX: SAVE CONF BACKUP
 
THE CURRENT SAVED CONFIGURATION WILL BECOME THE BACKUP CONFIGURATION.
PROCEED (N/Y)? N
 
SAVE BACKUP NOT EXECUTED
 
[18:29:18] ABILIS_CPX: SAVE CONF BACKUP 4-6-1

THE CONFIGURATION SAVED IN 'C:\4-6-1' WILL BECOME THE BACKUP CONFIGURATION
FOR VERSION 4-6-1. PROCEED (N/Y)?y

PROCEEDING WITH SAVE BACKUP...
SAVE BACKUP EXECUTED

warning! On floppy based systems, the command writes data on the floppy disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.


SAVE CONF TEST Save current configuration for test (Administrator)
SAVE CONF TEST

This command executes the validation of the configuration currently in use. If it is successful, it is saved on the file DRIVERS.CFG as test configuration: "Saved for Test".

it is possible to check the current configuration state through the command D I. In correspondence of the file DRIVERS.CFG, in the notes dedicated section, the string "Saved for Test" will appear.

On the next system restart, this configuration will be loaded and labelled as configuration under test. it is possible to check the current configuration state through the command D I. In correspondence of the file DRIVERS.CFG, in the notes dedicated section, the string "Under Test" will appear.

If the test configuration is satisfactory, the User can change its state by using the command SAVE CONF, otherwise on the next system restart, the backup configuration (DRIVERS.BCK) will be loaded.

If the validation and saving are both successful the message "SAVE DEFAULTS EXECUTED" will be shown.

If the validation fails, the saving is NOT executed and the message "SAVE DEFAULTS NOT EXECUTED" will be shown.

warning! The command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.

System updating and restarting top


CONFLOG BACKUP Configuration and Log files backup (Administrator)
CONFLOG BACKUP [<version>]

It copies configuration and Log files (DRIVERS.CFG, DRIVERS.BCK, DHCP bindings file, CPX.LOG, CPX.DBG and CPX.XCP) of the current version or of the specified version to the floppy disk.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

[14:53:08] ABILIS_CPX: CONFLOG BACKUP

YOU ARE GOING TO BACKUP CONFIGURATION AND LOG FILES OF CURRENT VERSION
TO FLOPPY DISK.
PROCEED (N/Y)? Y

PROCEEDING WITH CONFIGURATION AND LOG FILES BACKUP...
FILE 'DRIVERS.CFG' ... SUCCESSFULLY COPIED.
FILE 'DRIVERS.BCK' ... SUCCESSFULLY COPIED.
FILE 'CPX.LOG' ... SUCCESSFULLY COPIED.
FILE 'CPX.DBG' ... SUCCESSFULLY COPIED.
FILE 'CPX.XCP' ... SUCCESSFULLY COPIED.
FILE 'C:\APP\DHCP\DHCP.BND' ... SUCCESSFULLY COPIED.

COMMAND COMPLETED

warning! The command works on the floppy disk. If the floppy disk is not inserted or any write error occurs, Abilis CPX will show a signalling message.


CONFLOG RESTORE Configuration files restore (Administrator)
CONFLOG RESTORE [<version>]

It copies configuration files (DRIVERS.CFG and DRIVERS.BCK) from the floppy disk to the current version or to the specified version directory.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

[19:16:49] ABILIS_CPX: CONFLOG RESTORE

YOU ARE GOING TO RESTORE CONFIGURATION FILES OF CURRENT VERSION
FROM FLOPPY DISK.
PROCEED (N/Y)? Y

PROCEEDING WITH CONFIGURATION FILES RESTORE...
FILE 'A:\DRIVERS.CFG' ... SUCCESSFULLY COPIED.
FILE 'A:\DRIVERS.BCK' ... SUCCESSFULLY COPIED.

COMMAND COMPLETED

warning! The command works on the floppy disk. If the floppy disk is not inserted or any read error occurs, Abilis CPX will show a signalling message.


FILE COPY Make a copy of a file (Administrator)
FILE COPY srcname dstname

It makes a copy of the "srcname" file into the specified "dtsname" path/file.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "srcname" must be a file name. If the path is omitted the source file is assumed to be located in the current running version directory.

If the "srcname" file is not found, the message "FILE 'namefile' NOT FOUND" will be shown.

The "dstname" can ether a path or a file name (E.g.: A: or C:\4-6-1\ or Fdsp.bin or C:\4-6-2\drivers.cfg). If the path is omitted the destination directory is assumed to be the current running version directory.

Wildcards characters are not accepted either in the source file name nor in the destination name.

File copies to root directory are not allowed.

Log files (Cpx.log, Cpx.dbg and Cpx.xcp) and Cpx.rtb file cannot be overwritten.

If the "dstname" file already exists, the command will request a confirmation before overwrite it.

[12:02:24] ABILIS_CPX: FILE COPY Dhcp.bnd A:\Dhcp.bnd

TARGET FILE 'A:\Dhcp.bnd' ALREADY EXIST.
PROCEED ANYWAY (N/Y)? Y

PROCEEDING WITH FILE COPY...
FILE COPY EXECUTED

FILE DELETE Delete a file (Administrator)
FILE COPY filename

It delete the specified file.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "filename" must be a file name. If the path is omitted the source file is assumed to be located into the current running version directory.

Wildcards characters are not accepted in the file name.

If the "filename" file is not found, the message "FILE 'namefile' NOT FOUND" will be shown.

Files that are located into root directory cannot be deleted.

Configuration files, log files (Cpx.log, Cpx.dbg and Cpx.xcp) and any other system file cannot be deleted from the current running version directory.

The command will always request a confirmation before deleting the specified file.

[12:23:29] ABILIS_CPX: FILE DELETE aaa.txt

FILE 'aaa.txt' IS GOING TO BE DELETED.
PROCEED (N/Y)? Y

FILE 'aaa.txt' DELETED

FILE GET Get a file (Administrator)
FILE GET filename [1K]
FILE GET filename [<version>] [1K]

It activates the File Transfer function of the specified file from Abilis CPX to a remote destination, by using the X-Modem protocol.

The option "1K" activates file transferring through the X-Modem 1K protocol.

NoFloppyBasedSystem On HD/CF based system only, the option "<version>" allows to transfer a file of the specified version directory.
The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

If the file is not present, the message "FILE 'namefile' NOT FOUND" will be shown.

The transfer procedure signals its availability to send the file by the message "READY TO SEND FILE..."

When the transfer is completed the following message is shown: "FILE TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...", after pressing the <ENTER> button, an informative message, "FILE TRANSFER SUCCESSFULLY COMPLETED", will be shown if it was successful.

warning! On floppy based systems, the command works on the floppy disk. If it is not inserted or any read error occurs, Abilis CPX will show a signalling message.


FILE PUT Put a file (Administrator)
FILE PUT filename
FILE PUT filename [<version>]

It activates the File Transfer function of the specified file from a remote destination to Abilis CPX, by using the X-Modem or X-Modem 1K protocol.

The interested files are the ones already present in the Abilis CPX disk and visualized by executing the command D I.
Only the following files can be uploaded:

The specified file name must be the name relative to the running version directory, i.e. without the file path.

If the file name indicated in the command row does not match any of the above listed file, the following message will be shown: "COMMAND NOT ALLOWED FOR THAT FILE".

NoFloppyBasedSystem On HD/CF based system only, the option "<version>" allows to transfer the file to the specified version directory.
The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

The specified file name must be the name relative to the specified version directory, i.e. without the file path.

The transfer procedure signals its availability to receive the file by the message "READY TO RECEIVE FILE...".

When the transfer is completed the following message is shown: "FILE TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...", after pressing the <ENTER> button, an informative message, "FILE TRANSFER SUCCESSFULLY COMPLETED", will be shown if it was successful.

Once the file is received, it is submitted to a congruence control for checking its content validity. The User is informed through the message "RECEIVED FILE 'nomefile' CHECK IN PROGRESS...". If the file content is not correct, the message "CHECK FAILED: FILE 'namefile' DELETED" is shown and the file deleted.

If file content and version are correct, the message "CHECK PASSED" will be shown and the file overwrites its homonym on the disk.

warning! On floppy based systems, the command works on the floppy disk. If it is not inserted or any read/write error occurs, Abilis CPX will show a signalling message.


SYS COMPACT Compact directory (Administrator)
SYS COMPACT <dir>

This command compacts the specified directory, reducing the allocated size of the directory.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <dir> string must be the physical full name of the directory in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. Spaces are allowed and strings holding spaces must be written between quotation marks (e.g. "C:\USR\PUB\MY DIR\").

The command will end reporting the number of recovered entries.

[18:07:01] ABILIS_CPX: SYS COMPACT C:\USR\

COMPACTING DIRECTORY 'C:\USR\' ...
COMMAND EXECUTED, RECOVERED 0 SHORT DIRECTORY ENTRIES

warning! It is recommended to use this command when a lot of files have been deleted or renamed in a directory to reduce its size.


SYS COMPACTR Compact directory and sub-directories (Administrator)
SYS COMPACTR <dir>

This command compacts the specified directory as well as all of its sub-directories. If applied on a root directory, all directories of a logical drive will be compacted.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <dir> string must be the physical full name of the directory in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. Spaces are allowed and strings holding spaces must be written between quotation marks (e.g. "C:\USR\PUB\MY DIR\").

The command will lock access to the logical drive where the directory is located. It always requests a confirmation before starting its execution and it will end reporting the number of recovered entries.

[18:26:34] ABILIS_CPX: SYS COMPACT C:\

THIS OPERATION MAY TAKE FEW MINUTES AND LOCKS ACCESS TO DISK C:
PROCEED ANYWAY (N/Y)?y

COMPACTING DIRECTORY 'C:\' AND ALL OF ITS SUBDIRECTORIES...
COMMAND EXECUTED, RECOVERED 2 SHORT DIRECTORY ENTRIES

warning! It is recommended to use this command when a lot of files have been deleted or renamed in a directory to reduce its size.


SYS DELETE PACKAGE Delete package file (Administrator)
SYS DELETE PACKAGE <package>

This command deletes the specified package file.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <package> string must be the name of a package file located in 'C:\PKG' or an absolute package file name (i.e. the full path is required).

The command will always request a confirmation before deleting the specified package file.


SYS DELETE VERSION Delete version directory (Administrator)
SYS DELETE VERSION <version>

This command deletes the specified version directory.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

The currently running version directory cannot be deleted.

The command will always request a confirmation before deleting the specified version directory.

[10:31:57] ABILIS_CPX: SYS DISPLAY VERSIONS
                                                                               
List of available versions:                                                    
                                                                               
Version directory                                        Date         Time     
------------------------------------------------------------------------------ 
4-7-1                                                    24/05/2004   16:07:08 
4-7-0                                                    19/05/2004   19:30:32 
5-0-13                                                   31/03/2004   19:52:00 
2423                                                     31/03/2004   21:35:44 
2506                                                     25/05/2004   10:09:50 
1535                                                     21/05/2004   10:20:52 
                                                                               
[10:32:01] ABILIS_CPX: SYS DELETE VERSION 4-7-0
                                                                               
YOU ARE GOING TO DELETE THE 'C:\4-7-0' VERSION DIRECTORY.                      
PROCEED (N/Y)? Y                                                                
                                                                               
VERSION 'C:\4-7-0' DELETED                                                     

SYS DIR List directory (Administrator)
SYS DIR [path]

This command shows the directory listing of the specified path. If the path is omitted it lists the content of the currently running version directory.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <path> string must be the physical full name of the directory in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. Spaces are allowed and strings holding spaces must be written between quotation marks (e.g. "C:\USR\PUB\MY DIR\").

Here is an example of the command execution:

[16:38:28] ABILIS_CPX: SYS DIR C:\APP\TRFA\

Directory listing of c:\app\trfa\

.                                                <DIR>   31/03/2004   19:08:00
..                                               <DIR>   31/03/2004   19:08:00
HISTORY                                          <DIR>   31/03/2004   19:08:00
01DA05MI.DAT                                      3326   01/04/2004   14:50:00
01DA05MI.BAK                                      3326   01/04/2004   14:50:00
00DA05MI.BAK                                     12132   08/04/2004   08:35:00
00DA05MI.DAT                                     12132   08/04/2004   08:35:00
00WE30MI.BAK                                      5172   08/04/2004   08:30:00
00WE30MI.DAT                                      5172   08/04/2004   08:30:00
01WE30MI.BAK                                      2860   01/04/2004   14:30:00
01WE30MI.DAT                                      2860   01/04/2004   14:30:00
01MO02HO.DAT                                      3046   01/04/2004   14:00:00
01MO02HO.BAK                                      3046   01/04/2004   14:00:00
00MO02HO.BAK                                      3556   07/04/2004   16:00:04
00MO02HO.DAT                                      3556   07/04/2004   16:00:04

Found 3 directories, 12 files.
Total 14 MB, Used 9 MB, Free 5 MB.

SYS DISK FORMAT Format a disk drive
SYS DISK FORMAT drive: [-SF][par:val]

This command formats a disk drive.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "drive:" must be a drive letter in the range [D,..,Z]. The system drive "C:" cannot be formatted; while for floppy disk formatting the SYS FLPFORMAT command must be used.

The "-SF" option formats the selected drive creating only a single File Allocation Table (FAT). This option should be used to improve performance and efficiency.
By default, two FATs are created. The second copy is maintained as a backup copy for disk repair utilities. If the primary FAT gets corrupted, the disk repair commands can copy the secondary FAT onto the primary FAT. However, drives formatted with a single FAT have a larger capacity and better write performance. The file system software itself will never actually use the second FAT. Thus, the second FAT can improve security, but it always incurs a performance penalty because each FAT update requires twice as many disk write operations as it would for a single FAT volume.

Below it is the list of the additional parameters accepted by the command:

Parameter Description
CLUSSIZE: This parameter allows to select the size of the cluster to be created on the formatted drive.
Values in the range [4, 8, 16, 32, 64, 128, 256 KB] are accepted.
It can be used only when formatting disk drive with size greater then 512 MB.
FAT: This parameter allows to select the type of the File Allocation Table (FAT) to be created on the formatted drive.
Values in the range [16, 32] are accepted, corresponding respectively to FAT-16 and to a FAT-32 file system.
If this parameter is not specified, the command will select a FAT type automatically. Drives with less than 16 MB size will be formatted as FAT-12 and drives with less than 512 MB will be formatted as FAT-16. Larger drives are formatted as FAT-32.

warning! Please note that some combinations of CLUSSIZE: and FAT: can prevent the command from setting up a valid file system. For example, a FAT-16 drive must have at least 4085 clusters. However, if a drive has only 10000 sectors, CLUSSIZE: is set to 4, and FAT:16 is specified, the command will return and error message.


SYS DISPLAY BOOT Display Boot Manager configuration
SYS DISPLAY BOOT

This command shows the current Boot Manager configuration. Boot Manager configuration consists of the following information:

NoFloppyBasedSystem The command is available on HD/CF based system only.

[12:28:06] ABILIS_CPX: SYS DISPLAY BOOT

Abilis CPX Boot Manager configuration:

Previous version      Current version       Next Version to load
------------------------------------------------------------------------------
4-6-1                 4-6-1                 4-7-0

SYS DISPLAY BOOT LOG Display Boot Manager log file (Administrator)
SYS DISPLAY BOOT LOG

This command shows the current content of the Boot Manager log file.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[10:36:33] ABILIS_CPX: SYS DISPLAY BOOT LOG

Boot Manager log file:

***** New run at 2004-03-18 20:53:24 *****
Setting current directory
Loading configuration
Loading CPX response file
Accepting 'new' version
Saving configuration
Removing CPX response file
Writing working directory to shared region
Loading file: 4-7-0\CPX.RTB
Starting loaded RTB file

***** New run at 2004-03-20 11:28:55 *****
Setting current directory
Loading configuration
Loading CPX response file
Accepting 'new' version
Saving configuration
Removing CPX response file
Writing working directory to shared region
Loading file: 4-6-1\CPX.RTB
Starting loaded RTB file

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.


SYS DISPLAY PACKAGES Display available package files (Administrator)
SYS DISPLAY PACKAGES

This command shows the package files that are present in the 'C:\PKG' directory.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[16:44:32] ABILIS_CPX: SYS DISPLAY PACKAGES

List of available packages in 'C:\PKG':

Package (version)                           Date         Time             Size
------------------------------------------------------------------------------
4-6-1.PKG (4-6-1)                           25/02/2004   16:03:20      1266688
CPX.PKG (4-7-0)                             13/03/2004   11:53:11      1266775

SYS DISPLAY VERSIONS Display available versions (Administrator)
SYS DISPLAY VERSIONS

This command shows the list of versions that are currently available on the system.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[16:44:34] ABILIS_CPX: SYS DISPLAY VERSIONS

List of available versions:

Version directory                                        Date         Time
------------------------------------------------------------------------------
4-6-1                                                    05/03/2004   17:00:00
4-7-0                                                    04/04/2004   13:00:24

SYS DISK CHK Check HD/CF integrity (Administrator)
SYS DISK CHK [drive:][opt]

This command executes an integrity check of a disk drive and eventually fixes detected errors.

NoFloppyBasedSystem The command is available on HD/CF based system only.

By specifying a drive letter in the range [A..Z], the command will execute the integrity check on the selected drive only. Otherwise the verification will be executed on the system disk C:.

Here it is the list of the accepted options:

OptionDescription
-FEnable error fixing, except file size errors.
-FEEnable error fixing, file size errors included.
-SEnable silent mode (check disk statistics are displayed only).
-VEnable verbose mode (this option extends default verbose mode).
-LDisplays the list of the detectable errors.

Here it is a sample of the command execution, when no option is specified.

[16:26:05] ABILIS_CPX: SYS DISK CHK D:

THIS OPERATION MAY TAKE FEW MINUTES AND LOCKS ACCESS TO ALL DISKS.
PROCEED ANYWAY (N/Y)? y

DISK 'D:' INTEGRITY CHECK IN PROGRESS...
DISK 'D:' INTEGRITY CHECK SUCCESSFULLY COMPLETED

NO ERRORs WERE FOUND

Here it is a sample of the command execution, when the "verbose mode" is requested:

[16:34:53] ABILIS_CPX: SYS DISK CHK C: -V

THIS OPERATION MAY TAKE FEW MINUTES AND LOCKS ACCESS TO ALL DISKS.
PROCEED ANYWAY (N/Y)?y

DISK 'C:' INTEGRITY CHECK IN PROGRESS...
checking FAT...
C:\
C:\PKG\
C:\2485\
C:\USR\
C:\USR\PUB\
C:\LOG\
C:\LOG\ARC\
C:\APP\
C:\APP\SSH\
C:\APP\HTTP\
C:\APP\TRFA\
C:\APP\TRFA\HISTORY\
C:\APP\DHCP\
C:\5-0-13\
C:\2423\
C:\2481\
C:\1513\
searching lost clusters...
DISK 'C:' INTEGRITY CHECK SUCCESSFULLY COMPLETED

NO ERRORs WERE FOUND

Here it is the list of disk check detectable errors:


SYS DISK INFO Display logical drive information (Administrator)
SYS DISK INFO [drive:]

This command shows relevant information related to logical drive(s).

NoFloppyBasedSystem The command is available on HD/CF based system only.

By specifying a drive letter in the range [A..Z], the command shows information related to the selected drive only. Otherwise information related to all logical drive(s) are displayed.

[16:46:24] ABILIS_CPX: SYS DISK INFO

Logical drive(s) information:

Drv Disk   Label       FAT     Free space      Used space      Total space
    UDMA   I/O-bit     Sectors per block       Cluster size
------------------------------------------------------------------------------
A:  Floppy             12      1.364.992 Bytes 92.160 Bytes    1.457.152 Bytes
------------------------------------------------------------------------------
C:  HD-0   CPX_SYSTEM  12      4 MB            9 MB            14 MB
    No     16          1                       4.096 Bytes
------------------------------------------------------------------------------
D:  HD-1   USER_DISK   32      2.436 MB        0 MB            2.436 MB
    No     16          8                       4.096 Bytes
------------------------------------------------------------------------------

SYS DISK LABEL Set drive label (Administrator)
SYS DISK LABEL drive:

This command allows to set the label of the selected drive or remove any existing label.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "drive:" must be a drive letter in the range [D,..,Z]. The system drive "C:" label cannot be changed; while for setting floppy disk label the SYS FLPFORMAT command should be used.

The new label must be a string of up to 11 characters length. The case of the entered label is not preserved, lower case characters will be always converted to upper case.

[19:27:57] ABILIS_CPX: SYS DISK LABEL D:

ENTER VOLUME LABEL (MAX. 11 CHARACTERs, PRESS <ENTER> FOR NO LABEL): UserDisk

COMMAND EXECUTED

[19:28:09] ABILIS_CPX: SYS DISK INFO D:

Logical drive(s) information:

Drv Disk   Label       FAT     Free space      Used space      Total space
    UDMA   I/O-bit     Sectors per block       Cluster size
------------------------------------------------------------------------------
D:  HD-1   USERDISK    32      2.388 MB        47 MB           2.436 MB
    No     16          8                       4.096 Bytes
------------------------------------------------------------------------------

SYS DISK PARTITION ADD Add new partition to a disk (Administrator)
SYS DISK PARTITION ADD HD:val

This command add a new partition to the specified hard disk.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "HD:" parameter must be an hard disk index in the range [0..31].

Here it is a sample of the command execution:

[15:49:49] ABILIS_CPX: SYS DISK PARTITION ADD HD:1

Hard Disk '1' information:

HD  Size          Partition Drive Label       FAT     Size
------------------------------------------------------------------------------
1   2.441 MB      1         D:    USERDISK    32      2.436 MB

HARD DISK '1' ALREADY HOLDS 1 PARTITIONs.
DO YOU WANT TO ADD A NEW PARTITION (N/Y)? Y

THIS OPERATION WILL SPLIT PARTITION 1 ('D:') INTO TWO PARTITIONs.
ALL DATA ON 1 ('D:') PARTITION WILL BE LOST.
PROCEED (N/Y)? Y

PLEASE ENTER THE SIZE YOU WANT TO RESERVE FOR PARTITION 1 ('D:'),
THE REMAINING SPACE WILL BE ASSIGNED TO THE NEW PARTITION,
IN MBytes (0 TO EXIT): 500

THE SIZE OF PARTITION 1 ('D:') WILL BE ABOUT 500 MB
THE SIZE OF THE NEW PARTITION WILL BE ABOUT 1.936 MB
PROCEED (N/Y)? Y

HARD DISK PARTITIONING OPERATIONS REQUIRE THAT NO FILES ARE OPENED.
IF SOME FILES ARE CURRENTLY OPENED IN THE SYSTEM,
THE COMMAND WILL WAIT UNTIL ALL FILES WILL BE CLOSED.
PROCEED (N/Y)? Y

WAITING THAT ALL FILES GET CLOSED (TYPE CTRL+C + ENTER TO STOP)... DONE.

NEW PARTITION CREATION IN PROGRESS... DONE.

PARTITION 1 ('D:') SUCCESSFULLY SPLITTED ON HARD DISK '1'
PARTITION 2 ('E:') SUCCESSFULLY CREATED ON HARD DISK '1'

DRIVE 'D:' FORMAT IN PROGRESS... DONE.

ENTER VOLUME LABEL (MAX. 11 CHARACTERs, PRESS <ENTER> FOR NO LABEL): MY_DISK

DRIVE 'D: FORMATTED:

 FILE SYSTEM IS FAT-16, Size: 495 MB
 Bytes per sector: 512, Sectors per cluster: 16, Clusters: 63467
 Serial N. 3086-7E76, Label: MY_DISK

DRIVE 'E:' FORMAT IN PROGRESS... DONE.

ENTER VOLUME LABEL (MAX. 11 CHARACTERs, PRESS <ENTER> FOR NO LABEL): Y_DISK

DRIVE 'E: FORMATTED:

 FILE SYSTEM IS FAT-32, Size: 1.941 MB
 Bytes per sector: 512, Sectors per cluster: 8, Clusters: 496977
 Serial N. 3086-7E85, Label: Y_DISK

COMMAND COMPLETED

SYS DISK PARTITION INFO Display partition(s) information (Administrator)
SYS DISK PARTITION INFO

This command displays information related to partition(s) defined on all hard disks of the system.

NoFloppyBasedSystem The command is available on HD/CF based system only.

Here it is a sample of the command execution:

[15:52:37] ABILIS_CPX: SYS DISK PARTITION INFO

Available Hard Disk(s) information:

HD  Size          Partition Drive Label       FAT     Size
------------------------------------------------------------------------------
0   15 MB         1         C:    CPX_SYSTEM  12      14 MB
1   2.441 MB      1         D:    MY_DISK     16      495 MB
                  2         E:    Y_DISK      32      1.941 MB

SYS DISK PARTITION RESET Partition(s) reset (Administrator)
SYS DISK PARTITION RESET HD:val
SYS DISK PARTITION RESET HD:val P:val

This command allows to reset all existing partition(s) defined on a hard disk and/or to reset partition(s) starting from the specified one.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The "HD:" parameter identifies the hard disk and must be an index in the range [0..31].

The "P:" parameter identifies the disk partition and must be an index in the range [1..4].

Here it is a sample of the command execution:

[16:17:26] ABILIS_CPX: SYS DISK PARTITION RESET HD:1

Hard Disk '1' information:

HD  Size          Partition Drive Label       FAT     Size
------------------------------------------------------------------------------
1   2.441 MB      1         D:    MY_DISK     16      495 MB
                  2         E:    Y_DISK      32      1.941 MB

DO YOU REALLY WANT TO DELETE ALL EXISTING PARTITIONs ON HARD DISK '1' (N/Y)? Y

THIS OPERATION WILL DELETE ALL EXISTING PARTITIONs AND CREATE
A SINGLE NEW PARTITION ON HARD DISK '1'.
PROCEED (N/Y)? Y

HARD DISK PARTITIONING OPERATIONS REQUIRE THAT NO FILES ARE OPENED.
IF SOME FILES ARE CURRENTLY OPENED IN THE SYSTEM,
THE COMMAND WILL WAIT UNTIL ALL FILES WILL BE CLOSED.
PROCEED (N/Y)? Y

WAITING THAT ALL FILES GET CLOSED (TYPE CTRL+C + ENTER TO STOP)... DONE.

CREATING A SINGLE NEW PARTITION ON HARD DISK '1'... DONE.
PARTITION 1 ('D:') SUCCESSFULLY CREATED ON HARD DISK '1'

DRIVE 'D:' FORMAT IN PROGRESS... DONE.

ENTER VOLUME LABEL (MAX. 11 CHARACTERs, PRESS <ENTER> FOR NO LABEL): user_disk

DRIVE 'D: FORMATTED:

 FILE SYSTEM IS FAT-32, Size: 2.436 MB
 Bytes per sector: 512, Sectors per cluster: 8, Clusters: 623729
 Serial N. 3086-82B1, Label: USER_DISK

COMMAND COMPLETED

SYS FLPFORMAT Format floppy disk (Administrator)
SYS FLPFORMAT

This command allows to format a floppy disk inserted in the drive 'A:'.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[14:30:45] ABILIS_CPX: SYS FLPFORMAT

YOU ARE GOING TO FORMAT A FLOPPY DISK, ALL DATA OF THE DISK WILL BE LOST.
PROCEED (N/Y)? Y
INSERT A FLOPPY DISK AND PRESS <ENTER> WHEN READY...<ENTER>
PROCEEDING WITH FLOPPY DISK FORMAT...
ENTER VOLUME LABEL (MAX. 11 CHARACTERs, PRESS <ENTER> FOR NO LABEL): MYDISK
FLOPPY DISK FORMATTED:

 FAT-12, Size: 1.464.320 bytes
 Bytes per sector: 512, Sectors per cluster: 2, Clusters: 1430
 Serial N. 2D3A-73FD, Label: MYDISK

COMMAND COMPLETED

warning! The command works on the floppy disk. If the disk is not inserted or any read/write error occurs, Abilis CPX will show a signalling message.


SYS SET BOOT VERSION Set the next version to be loaded (Administrator)
SYS SET BOOT VERSION [<version>]

This command allows to change Boot Manager configuration setting the version that must be loaded at next system startup.

NoFloppyBasedSystem The command is available on HD/CF based system only.

The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g.: 4-6-0 or 1219).

[14:33:23] ABILIS_CPX: SYS DISPLAY BOOT

Abilis CPX Boot Manager configuration:

Previous version      Current version       Next Version to load
------------------------------------------------------------------------------
4-6-0                 4-6-0                 4-6-0

[14:37:59] ABILIS_CPX: SYS SET BOOT VERSION 4-7-0

COMMAND EXECUTED

[14:38:23] ABILIS_CPX: SYS DISPLAY BOOT

Abilis CPX Boot Manager configuration:

Previous version      Current version       Next Version to load
------------------------------------------------------------------------------
4-6-0                 4-6-0                 4-7-0

The list of available versions can be displayed by the command SYS DISPLAY VERSIONS; while the current/new Boot Manager configuration is displayed by the command SYS DISPLAY BOOT.


SYS UPDATE Update System (Administrator)
SYS UPDATE
SYS UPDATE <package>

This command makes possible the system software update. It operates in different ways on floppy based system then on HD/CF based systems.

Floppy based systems:

This command makes possible the system software update, by receiving from a remote source the updated system disk image.

The transfer procedure signals its availability to receive the new software file by the following message:

YOU ASKED TO UPDATE A FLOPPY BASED SYSTEM.
PLEASE UPLOAD THE FLOPPY IMAGE FILE.

READY TO RECEIVE DISK IMAGE...

When the transfer is completed the following message is shown:

DISK IMAGE TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...

Once the <ENTER> is pressed by the User, if the transfer was successful, the informative messages, "DISK IMAGE TRANSFER SUCCESSFULLY COMPLETED" and "SYSTEM UPDATE EXECUTED, THE DISK IS BOOTABLE", will be shown, meaning that the software has been updated.

warning! On floppy based systems, the command works on the floppy disk. If the disk is not inserted or any read/write error occurs, Abilis CPX will show a signalling message.

HD/CF based systems:

This command makes possible the system software update in two ways:

In both cases, if the update package holds software of the same version of the currently running one, before starting the system update, the command will ask an additional confirmation with the following message:

YOU ARE GOING TO UPDATE THE CURRENT VERSION (4-6-0),
DO YOU REALLY WANT TO PROCEED (N/Y)? Y
RECEIVED PACKAGE CHECK and EXTRACTION IN PROGRESS...
CHECK PASSED, EXTRACTION DONE.

VERSION '4-6-0' SUCCESSFULLY INSTALLED.

In both cases, if the package verifications and extraction is successful, the package file is always deleted. On the contrary, if the procedure fails for any reason, the package deletion takes place only after the User confirmation.

The list of currently available package files can be displayed by the command SYS DISPLAY PACKAGES; while a package file can be deleted by the command SYS DELETE PACKAGE.

Once a new software version is installed on the system, it can be set to be loaded at next system startup by the command SYS SET BOOT VERSION.

The list of currently available versions can be displayed by the command SYS DISPLAY VERSIONS.

Old versions, not longer useful, can be deleted by the command SYS DELETE VERSION.


WARM START System warm start (Administrator)
WARM START

This command writes in the System Log the event "WARM START" and executes immediately the reset of the Abilis CPX.

For executing the Abilis CPX restart, is strongly recommended to use this command; use the RESTART SYSTEM command only if it is needed to restart the Abilis after saving the Events Log.

warning! The command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX don't save the event in the Events Log, but executes the reset.

If in the current configuration session the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the reset of the Abilis CPX is not executed and the Control Port prompt is shown.

[11:38:04] ABILIS_CPX: WARM START

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? Y

VALIDATION IN PROGRESS...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

[11:56:43] ABILIS_CPX:

In case of negative answer, the configuration is not saved and the reset of the Abilis CPX is executed.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.

NoFloppyBasedSystem On HD/CF based system only, if in the current configuration session the Boot Manager configuration was modified, i.e. a version different from the currently running one was set to be loaded at next system start up (SYS SET BOOT VERSION), the command displays a warning message and queries the User for proceeding with system restart.

[11:38:04] ABILIS_CPX: WARM START

BOOT MANAGER CONFIGURATION WAS MODIFIED:
THE NEXT VERSION THAT WILL BE LOADED IS '4-3-1',
WHILE THE CURRENTLY RUNNING VERSION IS '4-6-0'.

PROCEED WITH WARM START (N/Y)? Y

In case of affirmative answer, the system is restarted. In case of negative answer, the command doesn't proceed with the system restart.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.


RESTART SYSTEM Restart system (Administrator)
RESTART SYSTEM

It closes the current connections, saves the Events Log on disk, writes in the System Log the event "RESTART SYSTEM" and executes the reset of Abilis CPX software.

For executing the Abilis CPX restart, is strongly recommended to use the command WARM START; use this command only if it is needed to restart the Abilis after saving the Events Log.

warning! The command writes data on the disk. If the disk is not inserted or any write error occurs, Abilis CPX don't save the event in the System Log, but executes the reset.

If in the current configuration session the configuration was modified but not saved, the command displays a warning message and queries the User for proceeding with configuration saving or not.

In case of affirmative answer, the SAVE CONF command is executed, the reset of the Abilis CPX is not executed and the Control Port prompt is shown.

[11:38:04] ABILIS_CPX: RESTART SYSTEM

THE CURRENT CONFIGURATION WAS MODIFIED BUT NOT SAVED.
PROCEED WITH 'SAVE CONF' COMMAND (N/Y/A)? Y

VALIDATION IN PROGRESS...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

[11:56:43] ABILIS_CPX:

In case of negative answer, the configuration is not saved and the reset of the Abilis CPX is executed.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.

NoFloppyBasedSystem On HD/CF based system only, if in the current configuration session the Boot Manager configuration was modified, i.e. a version different from the currently running one was set to be loaded at next system start up (SYS SET BOOT VERSION), the command displays a warning message and queries the User for proceeding with system restart.

[11:38:04] ABILIS_CPX: RESTART SYSTEM

BOOT MANAGER CONFIGURATION WAS MODIFIED:
THE NEXT VERSION THAT WILL BE LOADED IS '4-3-1',
WHILE THE CURRENTLY RUNNING VERSION IS '4-6-0'.

PROCEED WITH SYSTEM RESTART (N/Y)? Y

In case of affirmative answer, the system is restarted. In case of negative answer, the command doesn't proceed with the system restart.

Any other answer makes the command to be aborted and the Control Port prompt to be shown again.

Test and trace functionalities top


PING Ping (User)
PING xxx.xxx.xxx.xxx [-opz1 val][-opz2 val]...[-opzN val]

This command executes a Ping to the specified IP address using the options indicated in the command row.

If the IP Router is not present the message "IP SERVICE NOT PRESENT" is shown.

If the IP address is not in the indicated format, it is possible, by typing "PING ?", to have a complete list of the allowed options of the command. For example:

[11:56:41] ABILIS_CPX: PING ?

Usage: ping <address> [-a] [-n count] [-l size] [-i TTL] [-r count] [-w timeout]
                      [-v TOS] [-m] [-s src_address]
Options:
    -a             Resolve addresses to hostnames.
    -n count       Number of echo requests to send.
    -l size        Send buffer size.
    -i TTL         Time To Live.
    -v TOS         Type of service. (use number or D, T, R, C)
    -r count       Record route for count hops.
    -s src_address Source address.
    -w timeout     Timeout in milliseconds to wait for each reply.
    -m             Show MAC address of the response (host or gateway).

TRACERT Trace Route (User)
TRACERT xxx.xxx.xxx.xxx [-opz1 val][-opz2 val]...[-opzN val]

This command traces the route of the IP packet sent to the IP address specified in the command row.

If the IP Router is not present the message "IP SERVICE NOT PRESENT" is shown.

If the IP address is not in the indicated format, it is possible, by typing "TRACERT ?", to have a complete list of the allowed options of the command. For example:

[11:56:44] ABILIS_CPX: TRACERT ?

Usage: tracert <address> [-a] [-h maximum_hops] [-w timeout]
                         [-m] [-s src_address]
Options:
    -a                 Resolve addresses to hostnames.
    -h maximum_hops    Maximum number of hops to search for target.
    -s src_address     Source address.
    -w timeout         Wait timeout milliseconds for each reply.
    -m                 Show MAC address of the response (host or gateway).

IPTRACE ACT Activate TCP/IP Trace (Administrator)
IPTRACE ACT

This command initializes the TCP/IP events trace function, by allocating the data structures needed by it. The message "COMMAND EXECUTED" will be shown after the command execution.

The trace function monitors the events exchanged between the IP Router and the eventual TCP port.

The parameter tracerec:, defined in the IP Router configuration, sets the number of records the TCP/IP trace can store: if this value is set to zero, the TCP/IP trace is not activated.

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.


IPTRACE CLEAR Clear TCP/IP Trace (Administrator)
IPTRACE CLEAR

It clears the content of the TCP/IP event trace and shows the message "COMMAND EXECUTED".

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.

If the TCP/IP trace has not been yet activated through the command IPTRACE ACT, the following message will be displayed "IPTRACE IS INACTIVE".


IPTRACE DISPLAY Display TCP/IP Trace (Administrator)
IPTRACE DISPLAY

This command shows the content of the TCP/IP event trace. If the command is executed before the trace is stopped, by the IPTRACE STOP one, the error message will be shown: "TRACE STILL RUNNING".

The displaying format requires the information about each TCP/IP event to be shown in two rows.

Here is an example:

[12:07:07] ABILIS_CPX: IPTRACE DISPLAY

2302      O ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 10149908
TCP         ACK 895798600  DATA 2      PSH  WIN 2048
2309      O ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 10149910
TCP         ACK 895798600  DATA 24     PSH  WIN 2048
2313      I ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 895798600
TCP         ACK 10149934    WIN 16270
2332      I ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 895798600
TCP         ACK 10149934   DATA 2      PSH  WIN 16270
2333      O ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 10149934
TCP         ACK 895798602  DATA 2      PSH  WIN 2048
2340      O ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 10149936
TCP         ACK 895798602  DATA 24     PSH  WIN 2048
2343      O ESTABLISH 192.168.000.002:1856  192.168.000.060:23    SEQ 10149960
TCP         ACK 895798602  PSH  WIN 2048

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.

If the TCP/IP trace has not been yet activated through the command IPTRACE ACT, the following message will be displayed "IPTRACE IS INACTIVE".


IPTRACE INACT Deactivate TCP/IP Trace (Administrator)
IPTRACE INACT

It deactivates the TCP/IP event trace, releasing the data structure eventually allocated by the command IPTRACE ACT and displaying the message "COMMAND EXECUTED".

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.


IPTRACE START Start TCP/IP Trace (Administrator)
IPTRACE START

It starts, once it has been activated by using the command IPTRACE ACT, the TCP/IP events trace and display the message "COMMAND EXECUTED".

Trace is handled in a circular way: once the maximum number of allowed events is reached, the oldest are replaced by the newest.

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.

If the TCP/IP trace has not been yet activated through the command IPTRACE ACT, the following message will be displayed "IPTRACE IS INACTIVE".


IPTRACE STOP Stop TCP/IP Trace (Administrator)
IPTRACE STOP

It stops the TCP/IP events trace and shows the message "COMMAND EXECUTED".

If the IP Router is not present or inactive the message "IP SERVICE NOT PRESENT" is shown.

If the TCP/IP trace has not been yet activated through the command IPTRACE ACT, the following message will be displayed "IPTRACE IS INACTIVE".


TRACE ACT Activate Trace (Administrator)
TRACE ACT
TRACE ACT PO:xxx[,yyy, ...] [SIZE:val] [DATA:val] [CMD:val] [LSN:val] [TYPE:val]

It activates the internal events trace function.

If no parameter is specified, the following message is displayed: "NO PARAMETER SPECIFIED: USING SAVED VALUES..." and the trace function is activated using the setting already saved through the commands TRACE PARAM SET and TRACE PARAM SAVE.

As alternative, the command will activate the trace function on the specified ports with the options eventually indicated in the command row. Optional parameters not indicated will be set to their values already saved through the commands TRACE PARAM SET and TRACE PARAM SAVE.

The mandatory parameter "PO:" sets the list of ports (minimum 1, maximum 50) that can be traced; their values must be in the interval [0 - 999]. Ports to be traced, must be "RUNNING", if not, the following message will be displayed "PO:xxx NOT PRESENT OR NOT RUNNING" and the trace function won't be activated; "xxx" stands for the identifier of the not present or not running port.

The optional parameter "SIZE:" sets the maximum allocable memory size for the trace function. If the parameter is not specified, all the available memory will be used by the system for trace activating, except the needed quantity for system management. If the system memory is not enough for activating the trace function, it won't be activated and the following message will be displayed "NOT ENOUGH MEMORY TO RUN TRACE".

While the optional parameter "DATA:" sets the maximum allocable memory size for saving the single event, remaining optional parameters "CMD:", "LSN:" and "TYPE:" make possible the activation of filters on the events traced.

Optional parameter Meaning
DATA: Maximum allocable memory size for saving a single event (byte) [10 - 2100 byte]
CMD: Command type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]
LSN: Local session number to be traced [ALL, 0000..FFFE (Hex.)]
TYPE: Data type to be traced [DATA, CHK, VOICE]

If the trace function has been already activated, it has to be deactivated through the command TRACE INACT. If the trace is not deactivated, the following message will be displayed "TRACE ALREADY ACTIVE", while if it is already running "TRACE ALREADY RUNNING".

By typing the string "TRACE ACT ?", an informative message about trace activation command syntax will be shown.

For example:

[16:28:48] ABILIS_CPX: TRACE ACT ?

TRACE ACT                          Activate Tracer using saved values
TRACE ACT PO:xx,yy,...             Activate Tracer on specified ports
          [SIZE:val][-M]
          [DATA:val][CMD:val]
          [LSN:val][TYPE:val]

PO:             Ports to be traced (max. 50)                       <Mandatory>
SIZE:           Tracer buffer size [3Kb..8Mb]                       <Optional>
-M              Force Tracer activation                             <Reserved>
DATA:           Max event buffer size [10..2100 bytes]              <Optional>
CMD:            Commands type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]  <Optional>
LSN:            SD/RV lsn to be traced [ALL, 0000..FFFE (Hex.)]     <Optional>
TYPE:           SD/RV type to be traced [DATA, CHK, VOICE]          <Optional>

By typing only the string "TRACE ??", an informative message about every trace command syntax will be shown.

For example:

[12:35:27] ABILIS_CPX: TRACE ??

[19:14:17] ABILIS_CPX:trace  ??

TRACE ACT                          Activate Tracer using saved values
TRACE ACT PO:xx,yy,...             Activate Tracer on specified ports
          [SIZE:val][-M]
          [DATA:val][CMD:val]
          [LSN:hex-val][TYPE:val]
TRACE CLEAR                        Clear the current trace
TRACE DELETE <file>                Delete trace saved in disk in <file> file
TRACE DISPLAY [ST:val or LE:val]   Display trace of sent and received data
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]
TRACE DISPLAY EXTENDED             Display trace of all commands
              [ST:val or LE:val]
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]
TRACE GET [1K]                     Transfer trace using X-Modem or X-Modem 1K
          [ST: and/or LEN:] or [LAST:]
TRACE INACT                        Deactivate Tracer
TRACE PARAM                        Display Tracer configured parameters, active
                                   parameters and the current Tracer state
TRACE PARAM SAVE                   Save current Tracer parameters values
TRACE PARAM SET [PO:xx,yy,...]     Set Tracer parameters
                [SIZE:val][DATA:val]
                [CMD:val]
                [LSN:hex-val][TYPE:val]
TRACE SAVE <file>                  Save trace on disk in <file> file
TRACE START [DATA:val][CMD:val]    Run Tracer
            [LSN:hex-val][TYPE:val]
TRACE STOP                         Stop Tracer

TRACE CLEAR Clear Trace (Administrator)
TRACE CLEAR

It clears the content of the internal events trace previously executed.

Before executing this command, the trace function has to be stopped, by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

If the trace is not active, the message "TRACE INACTIVE" will be shown.


TRACE DELETE Delete Trace file (Administrator)
TRACE DELETE <filename>

This commands allow to delete trace saved on disk in <filename> file.

NoFloppyBasedSystem The command is available on HD/CF based system only.

If the "filename" file is not found, the message "FILE 'namefile' NOT FOUND" will be shown.

Before being deleted, the <filename> file is checked to verify that it corresponds to an Abilis CPX trace file.

[10:33:34] ABILIS_CPX: TRACE DELETE dhcp.bnd

TRACE FILE 'DHCP.BND' BAD FORMAT

Trace can be saved on disk in a file using the command TRACE SAVE.


TRACE DISPLAY Display Trace (Administrator)
TRACE DISPLAY [ST:val o LE:val] [PO:xxx,...] [LSN:val] [TYPE:val]

It shows, in a short format, the content of the internal events trace, previously saved. Only the events of data sending and receiving are displayed.

The optional parameters "ST:", "LE:", "PO:", "LSN:", "TYPE:" make possible the activation of filters on the events traced:

Option Meaning
ST: Only the events occurred after the specified time (in milliseconds) will be displayed.
LE: Only the "LE:" number of events (starting from the end of the trace) will be displayed.
PO: Only events related to the specified list of ports (max. 50 values in the range [0 - 999]) will be displayed.
LSN: Only events of the specified type will be displayed.
TYPE: Only events related to data and/or voice traffic and/or link check will be displayed.

If the trace buffer is empty or got empty by the command TRACE CLEAR, the message "TRACE EMPTY" will be shown.

Before executing this command, the trace function has to be stopped, by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

If the trace is not active, the message "TRACE INACTIVE" will be shown.

By typing the string "TRACE DISPLAY ?", an informative message about command syntax will be shown.

For example:

[16:28:48] ABILIS_CPX: TRACE DISPLAY ?

TRACE DISPLAY [ST:val or LE:val]   Display trace of sent and received data
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]
TRACE DISPLAY EXTENDED             Display trace of all commands
              [ST:val or LE:val]
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]

ST:             Event time from which to start the display    <Optional>
LE:             Number of the last events to be displayed     <Optional>
PO:             Ports value for the events to be displayed    <Optional>
LSN:            Lsn for the events to be displayed (Hex.)     <Optional>
TYPE:           Data type for the events to be displayed      <Optional>

This command is also available in the off-line configurator. In this case, the command syntax is:

TRACE DISPLAY filename [ST:val o LE:val] [PO:xxx,...] [LSN:val] [TYPE:val]

And it will show, in a short format, only the events of data sending and receiving saved on the file "filename".

The optional parameters "ST:", "LE:", "PO:", "LSN:", "TYPE:" work in the same way, as already described.


TRACE DISPLAY EXTENDED Display Trace in Extended format (Administrator)
TRACE DISPLAY EXTENDED [ST:val o LE:val] [PO:xxx,...][LSN:val] [TYPE:val]

It shows, in an extended format, the content of the internal events trace, previously saved.

The optional parameters "ST:", "LE:", "PO:", "LSN:", "TYPE:" make possible the activation of filters on the events traced:

Option Meaning
ST: Only the events occurred after the specified time (in milliseconds) will be displayed.
LE: Only the "LE:" number of events (starting from the end of the trace) will be displayed.
PO: Only events related to the specified list of ports (max. 50 values in the range [0 - 999]) will be displayed.
LSN: Only events of the specified type will be displayed.
TYPE: Only events related to data and/or voice traffic and/or link check will be displayed.

If the trace buffer is empty or got empty by the command TRACE CLEAR, the message "TRACE EMPTY" will be shown.

Before executing this command, the trace function has to be stopped, by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

If the trace is not active, the message "TRACE INACTIVE" will be shown.

By typing the string "TRACE DISPLAY EXTENDED ?", an informative message about command syntax will be shown.

For example:

[16:28:48] ABILIS_CPX: TRACE DISPLAY EXTENDED ?

TRACE DISPLAY [ST:val or LE:val]   Display trace of sent and received data
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]
TRACE DISPLAY EXTENDED             Display trace of all commands
              [ST:val or LE:val]
              [PO:xx,...][LSN:hex-val]
              [TYPE:val]

ST:             Event time from which to start the display    <Optional>
LE:             Number of the last events to be displayed     <Optional>
PO:             Ports value for the events to be displayed    <Optional>
LSN:            Lsn for the events to be displayed (Hex.)     <Optional>
TYPE:           Data type for the events to be displayed      <Optional>

This command is also available in the off-line configurator. In this case, the command syntax is:

TRACE DISPLAY filename [ST:val o LE:val] [PO:xxx,...] [LSN:val] [TYPE:val]

And it will show, in a short format, only the events of data sending and receiving saved on the file "filename".

The optional parameters "ST:", "LE:", "PO:", "LSN:", "TYPE:" work in the same way, as already described.


TRACE GET Get Trace (Administrator)
TRACE GET [1K] [ST:val][LEN:val] o [LAST:val]

It transfer the content of the internal events trace, previously saved by Abilis CPX to a remote destination, by using the X-Modem protocol. Option "1K" activates file transferring through the X-Modem 1K protocol.

By default, the whole content of the trace, starting from the beginning of the saving, it is transferred. it is also possible, by using the proper optional parameter, to transfer only a part of the content:

Option Meaning
ST: Offset value (in bytes) where to start sending the trace content from. This parameter can be used alone or together with the parameter "LEN:", for selecting the exact part of the content the User wants to transfer. In such way the whole trace transferring is avoided. The parameter generates a conflict if used with "LAST:".
LEN: Buffer size (in KB) of the trace to be transferred. The value has to be considered from the beginning of the trace or from the offset set by the parameter "ST:". This parameter can be used alone or together with the parameter "ST:", for selecting the exact part of the content the User wants to transfer. In such way the whole trace transferring is avoided. The parameter generates a conflict if used with "LAST:".
LAST: This parameter set the buffer size (in KB, starting from the end of the trace) that is going to be transferred. This parameter generates conflicts if used with the parameters "ST:" and "LEN:".

If the trace buffer is empty or got empty by the command TRACE CLEAR, the message "TRACE EMPTY" will be shown.

Before executing this command, the trace function has to be stopped, by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

If the trace is not active, the message "TRACE INACTIVE" will be shown.

The transfer procedure signals its availability to transfer the trace file by the message "READY TO SEND TRACE BUFFER..."

When the transfer is completed the following message is shown: "TRACE BUFFER TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...", after pressing the <ENTER> button, an informative message, "TRACE BUFFER TRANSFER SUCCESSFULLY COMPLETED", will be shown if it was successful.

By typing the string "TRACE GET ?", an informative message about command syntax will be shown.

For example:

[16:53:08] ABILIS_CPX: TRACE GET ?

TRACE GET [1K]                     Transfer trace using X-Modem or X-Modem 1K
          [ST: and/or LEN:] or [LAST:]

1K              Use the X-Modem 1K transfer protocol           <Optional>
ST:             Trace buffer start value [in Kbytes]          <Optional>
LEN:            Number of Kbytes to be transmitted, starting
                from the beginning of the Tracer buffer or
                from the "ST:" value                          <Optional>
LAST:           Number of Kbytes to be transmitted, starting
                from the end of the Tracer buffer             <Optional>

TRACE INACT Deactivate Trace (Administrator)
TRACE INACT

This command deactivates the internal events trace, previously activated.

If the trace has not been activated, the message "TRACE INACTIVE" will be shown, while if it was already inactive the following will be displayed "TRACE ALREADY INACTIVE".

If the trace is running, the message "TRACE RUNNING" will be shown.


TRACE PARAM Display Trace parameters (Administrator)
TRACE PARAM

It shows the parameters settings of the internal events trace and its working mode.

The information shown will depend on the trace state. For example, if the trace is not active, information about its content and length will not be shown.

In the following example, the command is executed, and the trace is active (STATE ACTIVE/READY):

[12:09:18] ABILIS_CPX: TRACE PARAM

        Configured Value       Active Value           Description
------------------------------------------------------------------------------
PO:     NONE                   NONE                   Ports to be traced
SIZE:   100  (Kbytes)          100  (Kbytes)          Tracer buffer size
DATA:   60   (bytes)           60   (bytes)           Max. event buffer size
CMD:    STD                    STD                    Command(s) to be traced
LSN:    ALL                    ALL                    SD/RV lsn to be traced
TYPE:   ALL                    ALL                    SD/RV type to be traced
STATE:  -                      INACTIVE               Current Tracer state

By typing the string "TRACE PARAM ?", an informative message about "TRACE PARAM" command syntax and options will be shown.

For example:

[16:55:06] ABILIS_CPX: TRACE PARAM ?

TRACE PARAM                        Display Tracer configured parameters, active
                                   parameters and the current Tracer state
TRACE PARAM SAVE                   Save current Tracer parameters values
TRACE PARAM SET [PO:xx,yy,...]     Set Tracer parameters
                [SIZE:val][DATA:val]
                [CMD:val]
                [LSN:hex-val][TYPE:val]

TRACE PARAM SAVE Save Trace parameters (Administrator)
TRACE PARAM SAVE

It saves the parameters settings of the internal events trace function, previously activated. Those settings can be used for further activations of the traces. The saved values can be shown by using the command TRACE PARAM.

If the trace has not been activated, the following message will be shown: "TRACE INACTIVE".


TRACE PARAM SET Set Trace saved parameters (Administrator)
TRACE PARAM SET [PO:val] [SIZE:val] [DATA:val] [CMD:val] [LSN:val] [TYPE:val]

This command modifies the trace saved parameters that will be used for further activations of the trace.

The saved values can be shown by using the command TRACE PARAM.

If the trace has not been activated, the following message will be shown: "TRACE INACTIVE".

Parameter Meaning
PO: List of ports to be traced (min.1, max. 50).
SIZE: Trace buffer size (Kbyte) [3 Kb - 8 Mb].
DATA: Maximum allocable memory size for saving a single event (byte) [10 - 2100 byte].
CMD: Command type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]
LSN: Local session number to be traced [ALL, 0000..FFFE (Hex.)]
TYPE: Data type to be traced [DATA, CHK, VOICE]

By typing the string "TRACE PARAM SET ?", an informative message about the command syntax and options will be shown.

For example:

[16:56:56] ABILIS_CPX: TRACE PARAM SET ?

[19:09:50] ABILIS_CPX:trace param set ?

TRACE PARAM SET [PO:xx,yy,...]     Set Tracer parameters
                [SIZE:val][DATA:val]
                [CMD:val]
                [LSN:hex-val][TYPE:val]

PO:             Ports to be traced (max. 50)                        <Optional>
SIZE:           Tracer buffer size [3Kb..8Mb]                       <Optional>
DATA:           Max event buffer size [10..2100 bytes]              <Optional>
CMD:            Commands type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]  <Optional>
LSN:            SD/RV lsn to be traced [ALL, 0000..FFFE (Hex.)]     <Optional>
TYPE:           SD/RV type to be traced [ALL, DATA, CHK, VOICE]     <Optional>

TRACE SAVE Save Trace in a file on disk (Administrator)
TRACE SAVE <filename>

This command allows to save the content of the internal events trace in the <filename> file on the disk.

NoFloppyBasedSystem The command is available on HD/CF based system only.

Before executing this command, the trace function has to be stopped, by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

If the trace is not active, the message "TRACE INACTIVE" will be shown.

Trace files saved on the disk and no longer useful can be deleted by the command TRACE DELETE.


TRACE START Start Trace (Administrator)
TRACE START [DATA:val] [CMD:val] [LSN:val] [TYPE:val]

This command starts saving the events exchanged among the ports specified in the list, which has been defined during the trace activation (through the command TRACE ACT). If in the command row is not indicated any additional parameter, the trace will start using the settings defined during its activation. The following optional parameters can be specified "LSN:", "DATA:", "TYPE:", "CMD:". In this way trace parameters setting may be edited again.

Parameter Meaning
DATA: Maximum allocable memory for saving each single event [10 - 2100 byte].
CMD: Command type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]
LSN: Local session number to be traced [ALL, 0000..FFFE (Hex.)]
TYPE: Data type to be traced [DATA, CHK, VOICE]

If the trace function has not been already activated, use the command TRACE ACT for doing it. If the trace is not active the following message will be displayed "TRACE INACTIVE".

If the trace function is running, it has to be stopped by using the command TRACE STOP, otherwise the message "TRACE RUNNING" will be displayed.

By typing the string "TRACE START ?", an informative message about the command syntax and options will be shown.

For example:

[17:02:28] ABILIS_CPX: TRACE START ?

TRACE START [DATA:val][CMD:val]    Run Tracer
            [LSN:hex-val][TYPE:val]

DATA:           Max event buffer size [10..2100 bytes]              <Optional>
CMD:            Commands type [RSP, RSA, STD, EIRSIG, FR-LMI, ALL]  <Optional>
LSN:            SD/RV lsn to be traced [ALL, 0000..FFFE (Hex.)]     <Optional>
TYPE:           SD/RV type to be traced [ALL, DATA, CHK, VOICE]     <Optional>

TRACE STOP Stop Trace (Administrator)
TRACE STOP

This command stop tracing the events and stores the trace content until the next trace start, through the command TRACE START or the deactivation of the function (command TRACE INACT.

If the trace is not active the following message will be displayed "TRACE INACTIVE".

If the trace function is not running, the message "TRACE NOT RUNNING" will be displayed.


DEBUG BM Display Boot Manager file (Administrator)
DEBUG BM

It shows the current content of the Boot Manager configuration file: BM.CFG.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[19:16:58] ABILIS_CPX: DEBUG BM

Boot Manager configuration file:

<BmCfg>
<CpxLastVer>4-3-1</CpxLastVer>
<CpxNewVer>4-6-0</CpxNewVer>
<CpxNewRuns>1</CpxNewRuns>
</BmCfg>

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.


DEBUG CPXRUN Display CPX run configuration file (Administrator)
DEBUG BM

It shows the current content of the CPX run configuration file: CPXRUN.CFG.

NoFloppyBasedSystem The command is available on HD/CF based system only.

[19:16:58] ABILIS_CPX: DEBUG CPXRUN

CPX Run configuration file:

<CpxRun>
<CpxNewVer>4-6-0</CpxNewVer>
<CpxRunning>true</CpxRunning>
</CpxRun>

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.


DEBUG FILE Debug file system (Administrator)
DEBUG FILE INFO
DEBUG FILE STAT

It shows statistics about the file system.

[17:04:08] ABILIS_CPX: DEBUG FILE ?

INFO           Display RTF currently opened Files Table
STAT           Display RTF Buffer Statistics

If the option "INFO:" is used, information about statistics, related to the files currently in use, will be shown.

If the option "STAT:" is used, information about statistics, related to the buffers currently in use, will be shown.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.


DEBUG IRQ Debug interrupts (Administrator)
DEBUG IRQ

It shows statistics about the interrupts.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.

Here is an example of the command execution.

[17:14:59] ABILIS_CPX: DEBUG IRQ

Irq information:

 IRQ    Calls  FreeStack  Doubles  Time
-------------------------------------------
   0   253542        432        0  -
   4        2        440        0  -
   6       20        448        0  -
   7    16724        352        0  -
   9    42257       1340        0  -
  10    30369        368        0  -
  12    11125       1344        0  -
  14      511        448        0  -
  15   228635      24828        0  -

DEBUG MEM Debug memory (Administrator)
DEBUG MEM [-H][-D][START:val LEN:val]

It shows information about statistics related to the memory.

[17:05:40] ABILIS_CPX: DEBUG MEM ?

DEBUG MEM                     Display Memory information and statistics

DEBUG MEM -H                  Display Heap content
DEBUG MEM -D                  Display Heap allocated at drivers start-up
DEBUG MEM START:val LEN:val   Display Memory content

START:     Start address [0x00100000..0x7FFFFFFF]        <Mandatory>
LEN:       Length [1..4294967295]                        <Mandatory>

By using the "-H" option it is possible to show the content of the entire system heap.

By using the "-D" option it is possible to show the list of drivers and allocated heap at system start-up.

By using the parameters "START:" and "LEN:" it is possible to specify offset and buffer size of the memory to be displayed.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.

Here is an example of the command execution.

[11:58:40] ABILIS_CPX: DEBUG MEM
 
Physical Memory:     67.108.864


Memory Status:

Free Memory:                  0
Used Memory:         60.604.416
-------------------------------
Total Memory:        60.604.416


Heap information:

Heap status:                 Ok

Free Heap:           40.709.924
Used Heap:           19.144.396
-------------------------------
Total Heap:          59.854.320
Largest Free block:  40.450.676
Largest Used block:      79.804

DEBUG PO: Debug Port (Administrator)
DEBUG PO:xxx [SIZE:] [LSN:] [CMD:]

It shows debugging information about the specified ports.

[17:16:55] ABILIS_CPX: DEBUG PO: ?

DEBUG PO:val [par:val]        Display debug information of the specified port

Additional parameters:

SIZE:      Select debug buffer size [7..63 Kbytes]                 <Optional>
LSN:       Lsn value [0..65534(dec) or 0000..0FFFE(hex), A]        <Optional>
CMD:       Command string (es.: CMD:str or CMD:'str1 str2 ...']    <Optional>

Data are stored in a 6 KB size buffer. Depending on the port type, where the command is executed on, this buffer could not be enough and at the end of the visualization the following message will be displayed "INCOMPLETE INFORMATION: BUFFER SIZE TOO SHORT".

By using the option "SIZE:", User can eventually increase the maximum buffer size used by the command. The indicated value (in KB) must be in the interval [6 - 63].

By using the options "LSN:" and "CMD:" it is possible to select the type of debugging information to be displayed.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.


DEBUG SIMULATE Simulate an event for debugging purposes (Administrator)
DEBUG SIMULATE EVENT:val

This command simulates an event for debugging purposes.

The purpose of the command is strictly technical, Abilis CPX technicians could need it for detecting and solving eventual problems.

Currently supported event simulations are: "XCP", i.e. a sw exception, and "WDL", i.e. WDLIVE1 events.

warning! Both these events will cause the system to be restarted, then be careful in executing the present command.


DEBUG TASK Debug Task (Administrator)
DEBUG TASK [SIZE:] [F:] [ALL]

It shows debugging information about tasks.

[17:16:59] ABILIS_CPX: DEBUG TASK ?

DEBUG TASK [par:val]          Display Tasks information and statistics

Additional parameters:

SIZE:      Debug buffer size [64..1024 Kbytes]                      <Optional>
F:         Filtering string for task name (max. 20 chars)           <Optional>
           Strings holding spaces must be written between quotation
           marks (Ex.: F:"str1 str2 str3")
ALL        Request all available debug information                  <Optional>

Statistics are stored in a 64 Kbyte size buffer. Depending on the configuration and system equipment, this buffer could not be enough so that at the end of the visualization the following message will be displayed: "Out of string space", meaning that it wasn't possible to collect all the needed information.

By using the option "SIZE:", User can eventually increase the maximum buffer size used by the command. The indicated value (in Kbyte) must be in the interval [64 - 1024].

For each process present in the system, the command will display a row.

Moreover, by using the option "F:", User can request to display only those rows, which have the specified test string. Strings holding spaces must be written between quotation marks.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems.

Here is an example of the command execution.

[17:20:33] ABILIS_CPX: DEBUG TASK F:"IPR:LNK Init"

Total Number of Tasks:766
Tasks information:

Name            Prio State      R.Del  MStck Scheds  CT% WaitingAt
------------------------------------------------------------------------
IPR:LNK InitIpp    2 BlckdWait          4108      1  -   IPR IPP Init
IPR:LNK InitIpp    2 BlckdWait          4048      3  -   IPR LNK Filt State

DEBUG WDGMEM Debug Watchdog memory (Administrator)
DEBUG WDGMEM [OFFSET:val] [SIZE:val]

Display statistics information saved in case of system critical situation detected by the Watchdog.

Shown information is strictly technical so meaningless for the User, Abilis CPX technicians could need it for detecting and solving eventual problems. Here there a sample:

[17:04:13] ABILIS_CPX: DEBUG WDGMEM

Watchdog memory content (Offset:0, Size:128):

 Address |             Hexadecimal values                  |  Ascii values
---------+-------------------------------------------------+-----------------
00000000 | 31 34 2F 30 34 2F 32 30 30 34 20 32 33 3A 33 37 | 14/04/2004 23:37
00000010 | 3A 30 33 20 2D 20 4C 61 73 74 20 54 68 72 65 61 | :03 - Last Threa
00000020 | 64 20 49 6E 66 6F 20 2D 20 48 61 6E 64 6C 65 3A | d Info - Handle:
00000030 | 30 31 36 33 39 30 43 34 2C 20 4E 61 6D 65 3A 43 | 016390C4, Name:C
00000040 | 50 2D 53 65 6E 64 65 72 2D 53 65 73 3A 31 2C 20 | P-Sender-Ses:1,
00000050 | 53 74 61 74 65 3A 55 4E 4B 4E 4F 57 4E 2C 20 52 | State:UNKNOWN, R
00000060 | 6F 75 74 69 6E 65 3A 30 30 33 43 43 31 31 46 20 | outine:003CC11F
00000070 | 5B 51 4F 55 45 3A 30 30 31 31 38 35 31 43 5D 2E | [QOUE:0011851C].
printPrint this page