| LIST CREATE | Create list (Administrator) |
| LIST CREATE Name Type [Description] |
This command creates a new list, identified by "Name" and "Type". It can eventually set a list description to the specified "Description" value.
The parameter "Name" is the name the User wants to assign to the List. Names of the lists can be string with maximum length of 20 characters (alphabetical, numerical, "_" underscore). String cannot start with a numerical character and the terms "A", "And", "Or", "Not" are not allowed.
Name completely identifies the list within the system. Two or more lists with the same "Name" cannot be defined. There is no difference between low case and uppercase characters.
For example the following strings "FirstList", "FIRSTLIST", "firstlist" are equivalent. If a list with the selected name already exists in the system, the message "LIST ALREADY EXISTS" will be displayed.
"Type" parameter is the type the User wants to assign the list; it can be chosen among the following mnemonics:
| Mnemonic | List type |
|---|---|
| IN | List of ISDN numbers |
| IS | List of ISDN sub-addresses |
| EC | List of EIR Cluster identifiers |
| XN | List of X25 NUA |
| XU | List of X25 User Data Field |
| IP | List of IP addresses |
| IR | List of IP group addresses |
| DN | List of Dialling numbers |
| CP | List of CPX ports |
| TUP | List of TCP and UDP ports ranges |
| IPT | List of Internet protocols |
| MAC | List of MAC addresses |
| SAP | List of SAP values |
| RU | List of Rules |
| MR | List of Master Rules |
For more detailed description of lists types, refer to the Elements Lists section.
The optional parameter "Description" let User to give description to the list. it is a string of ASCII characters, without spaces, whose maximum length is 71 characters. Description can be omitted while creating a list, it can eventually be set later on through the command LIST DESCRIPTION.
Lists table can store up to 64 definitions. When a list is created, it gets a new numeric identifier (1 - 64) that can be used instead of "Name", in some commands.
The command inserts list definition into the first free place available in lists table. Because of free places in the table, numeric identifiers can be not sequential.
If the list table is full, the error message "LIST TABLE IS FULL" is shown.
The "Not Saved (SAVE CONF)" message is displayed every time Lists table is modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| LIST DELETE | Delete list (Administrator) |
| LIST DELETE Name |
This command deletes the list, identified by "Name" in the Elements List.
The parameter "Name" is the list name the User wants to delete. List is checked to be present by searching its identifier. There is no difference between low case and uppercase characters, so strings like "FirstList", "FIRSTLIST", "firstlist" are equivalent.
If the requested list is not present, the message "LIST NOT PRESENT" is displayed. If the table is empty, the error message "LIST TABLE IS EMPTY" will be shown.
List definitions in the table are not contiguous. The deleted definition frees one place that can be used for creating a new list.
User must be careful in list deleting, because all the elements defined in it will be also deleted. Moreover only those list, not referenced by any routing, can be deleted.
If the list to be deleted is still referenced by any routing, the following error message will be displayed: "LIST ALREADY IN USE; CANNOT BE DELETED". It won't be deleted.
The "Not Saved (SAVE CONF)" message is displayed every time Lists table is modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| LIST DESCRIPTION | Set list description (Administrator) |
| LIST DESCRIPTION Name Description |
This command makes possible to set and/ or modify the description of the list identified by "Name", already present in the lists of elements.
The parameter "Name" is the list name the User wants to work on. List is checked to be present by searching its identifier. There is no difference between low case and uppercase characters, so strings like "FirstList", "FIRSTLIST", "firstlist" are equivalent.
If the requested list is not present, the message "LIST NOT PRESENT" is displayed.
The parameter "Description" is the description the User wants to give to the list. It is a string of ASCII characters, without spaces, whose maximum length is 71 characters.
The "Not Saved (SAVE CONF)" message is displayed every time Lists definitions are modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| LIST RENAME | Set list name (Administrator) |
| LIST RENAME OldName NewName |
This command changes the Name of a CPX list, already present in the table, from "OldName" to "NewName".
The parameter "OldName" is the list name the User wants to work on. List is checked to be present by searching its identifier. There is no difference between low case and uppercase characters, so strings like "FirstList", "FIRSTLIST", "firstlist" are equivalent.
If the requested list is not present, the message "LIST NOT PRESENT" is displayed.
The parameter "NewName" is the name the User wants to assign to the List. Names of the lists can be string with maximum length of 20 characters (alphabetical, numerical, "_" underscore). String cannot start with a numerical character and the terms "A", "And", "Or", "Not" are not allowed.
Name completely identifies the list within the system. Two or more lists with the same "Name" cannot be defined. There is no difference between low case and uppercase characters.
If a list with the selected name already exists in the system, the message "LIST ALREADY EXISTS" will be displayed.
The "Not Saved (SAVE CONF)" message is displayed every time Lists definitions are modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| A LIST | Add item to list (Administrator) |
| A LIST:Name Item1 [Item2 …] |
It adds one or more elements to the list.
The parameter "Name" can be either the name of the list the User wants to work on, or the numeric identifier, assigned by the system, when the list was created.
If the requested list is not present, the message "LIST NOT PRESENT" is displayed.
"Item1" is the element to be added. For more detailed description of types and values of elements, refer to the Elements Lists section.
If an element, equal to the specified one, is already present in the list, the following message will be shown: "ITEM 'item' ALREADY EXISTS", where 'item' is the value that was going to be added.
Usually it is possible to add more than one element at the same time, by separating them with a space character in the command row.
For "RU" and "MR" list types, this is not possible because the can hold only one element. If "RU" or "MR" list is not empty, the message "LIST IS FULL: THIS LIST CAN HOLD ONLY ONE ITEM".
For other list types, the maximum number of elements that can be added at the same time, is given by their maximum size: 2000 definitions.
Elements table is contiguous and sorted by increasing values of identifier of the list which the elements belong to.
If the elements table is full, the error message "ITEM TABLE IS FULL" is shown.
The "Not Saved (SAVE CONF)" message is displayed every time a list is modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| C LIST | Clear item from list (Administrator) |
| C LIST:Name Item1 [Item2 …] |
It clears one or more elements from list.
The parameter "Name" can be either the name of the list the User wants to work on, or the numeric identifier, assigned by the system, when the list was created. "Item1" is the element to be deleted. If the requested list is not present, the message "LIST NOT PRESENT" is displayed.
Usually it is obligatory to specify the element ("Itemxx") to delete. The "RU" and "MR" list types are an exception:, they can only hold one element, so in this case it is allowed to omit the value of the element to delete.
Searching the specified value, by considering lower case and upper case characters, make verifying the element presence.
If the requested element is not found then the error message is generated: "ITEM NOT PRESENT".
If the specified list is empty, the error message "LIST IS EMPTY" will be shown.
Elements table is kept contiguous and sorted using optimization searching criteria. Therefore the command will delete the requested definition and will sort the table again.
The "Not Saved (SAVE CONF)" message is displayed every time a list is modified but not saved with the SAVE CONF command.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
| D LIST | Display lists (User) |
| D LIST D LIST:Name D LIST:A |
It shows lists table.
By specifying the parameter "Name", the command will show the correspondent list and its elements; "Name" is either the list name, assigned by the User, or the numeric identifier, assigned by the system, list creation.
Here is an example of the command execution:
[18:14:08] ABILIS_CPX: D LIST List-Number:8 Items-Number:20 Used-Resources:468 Free-Resources:20012 Id Name Type Description Ref First Numb ------------------------------------------------------------------------------- 2 Disabled IN Temporary_disabled_callers 0 4 1 3 Far IN Allowed_callers_from_different_... 0 5 3 6 Local IN Allowed_callers_from_local_area 0 15 5 7 Special IS Special_servicee_validation 0 0 0 8 Callers RU Full_allowed_callers 0 20 1 1 D_Numbers DN Dialling_numbers 0 1 3 5 IpServices TUP 0 11 4 4 IpProtocol IPT 0 8 3 ------------------------------------------------------------------------------- IN:ISDN Numbers, IS:ISDN Sub Addresses, EC:EIR Clusters, XN:X25 NUAs, XU:X25 UDFs, IP:IP Addresses, IR:IP Addresses Ranges, RU:Rules, MR:Master Rules, DN:Dialling Numbers, CP:CPX Ports, TUP:TCP and UDP ports ranges, IPT:Internet Protocols, MAC:MAC addresses. SAP:SAP values, -------------------------------------------------------------------------------
The previous example points out that the lists are sorted by type (according to the order shown in the legend at the bottom of the table) and, at a parity of type, by alphabetical order. The numeric index, that precedes the name, is the identifier automatically assigned by the system to the list during its creation.
Lists table can store up to 64 definitions. Identifiers of the elements lists can be not sequential, so the not shown values correspond to free places in the table.
If the lists table is empty, the message "NO LIST DEFINED" is generated.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
Here is an example of single list visualization:
[18:14:08] ABILIS_CPX: D LIST:Local
LIST:Local - IN, Allowed_callers_from_local_area
0038* 0038123123123 0376396967
064556 123456
By specifying the "A" value, the command will show all the configured lists and their elements.
The following example shows an example of visualization of all the lists:
[18:14:08] ABILIS_CPX: D LIST:A
LIST:Disabled - IN, Temporary_disabled_callers
0376399495
LIST:Far - IN, Allowed_callers_from_different_areas
0376* 03383223124 0338959456
LIST:Local - IN, Allowed_callers_from_local_area
0038* 0038123123123 0376396967
0644556 123456
LIST:Special - IS, Special_servicee_validation
LIST:Callers - RU, Full_allowed_callers
Local.OR.Far.AND.NOT.Disabled
LIST:D_Numbers - DN, Dialling_numbers
Order DialingNumber MaxConn Nrty
1 0376366128 2 NOMAX
2 5557893 2 NOMAX
3 3383223444 2 5
LIST:IpServices - TUP,
ssh(22) telnet(23) snmp(161) rip(520)
LIST:IpProtocol - IPT,
tcp udp ospf
The "Not Saved (SAVE CONF)" message is displayed every time lists are modified but modifications are not saved with the SAVE CONF command.
For a more detailed description of the shown information, refer to the Elements Lists section.
| D ITEM | Display Items (User) |
| D ITEM |
It shows the elements table.
Lists table can store up to 2000 definitions (indexed from 1 to 2000).
Elements identifiers are sequential and they run only into the system, so they can't be used by the user in no one of the list manipulation commands.
If the elements table is empty, the message "NO ITEMS DEFINED" is generated.
If the Abilis CPX version, currently in use, does not support List services, the following message will be shown "LIST SERVICE NOT PRESENT".
Here is an example of the command execution:
[18:14:08] ABILIS_CPX: D ITEM Item List Type Value ------------------------------------------------------------------------------- 1 1 DN 1 0376366128 2 NOMAX 2 1 DN 2 5557893 2 NOMAX 3 1 DN 3 3383223444 2 5 4 2 IN 0376399495 5 3 IN 0376* 6 3 IN 03383223124 7 3 IN 0338959456 8 4 IPT tcp 9 4 IPT udp 10 4 IPT ospf 11 5 TUP ssh(22) 12 5 TUP telnet(23) 13 5 TUP snmp(161) 14 5 TUP rip(520) 15 6 IN 0038* 16 6 IN 0038123123123 17 6 IN 0376396967 18 6 IN 0644556 19 6 IN 123456 20 8 RU Local.OR.Far.AND.NOT.Disabled ------------------------------------------------------------------------------- IN:ISDN Numbers, IS:ISDN Sub Addresses, EC:EIR Clusters, XN:X25 NUAs, XU:X25 UDFs, IP:IP Addresses, IR:IP Addresses Ranges, RU:Rules, MR:Master Rules, DN:Dialling Numbers, CP:CPX Ports, TUP:TCP and UDP ports ranges, IPT:Internet Protocols. -------------------------------------------------------------------------------
The "Not Saved (SAVE CONF)" message is displayed every time lists are modified but modifications are not saved with the SAVE CONF command.
For a more detailed description of the shown information, refer to the Elements Lists section.
| F LIST | Find item in a list (User) |
| F LIST:Name Item [Type] |
It is used to find the requested element of the specified type in a given list.
The parameter "Name" is the name list where the search has to be made.
The parameter "Item" is the element to search.
The parameter "Type" specifies the element type and it is obligatory only for "RU" lists type.
Here are some examples of the command execution:
[18:57:52] ABILIS_CPX: D LIST:CellFam
LIST:CellFam - IN, Numeri_da_chiamare_via_Omnitel
12* 110* 144*
166* 176* 0328*
0330* 0333* 0338*
0339* 0360* 0368*
1412*
[18:57:37] ABILIS_CPX: F LIST:1 5678
ITEM '5678' NOT FOUND OR BAD ITEM TYPE 'IN'
[18:59:23] ABILIS_CPX: F LIST:1 12345
THE ITEM IS PRESENT
The examples show that the elements, containing wildcards ('*', '?'), are also considered in searching operations. In fact the number "12345", is considered to belong to the list, because it is possible to find in it the element "12*".
Print this page