Using CLI commands
The CLI contains menus and submenus. To select a menu option, enter the appropriate short command or full command at the prompt. When a menu is selected, use the commands inTable 43 "Navigating the menus and displaying help" (page 184)to navigate to other menus or to display help.
Table 43
Navigating the menus and displaying help
Command Result
* Returns to the previous menu.
/ Returns to the top menu level.
? Displays help for the commands in the current menu.
When entering a menu option that has parameters defined, the "Modify, Save, or Cancel:" command line displays so that the parameters can be modified, if required.
To modify system parameters and objects, use one or more of the commands inTable 44 "Modifying parameters" (page 184)and Table 45
"Modifying objects" (page 184).
Table 44
Modifying parameters
Command Result
M Modifies one or more parameters.
S Saves modified parameters.
C Cancels the modification and allows the parameter to keep its previous value.
Table 45
Modifying objects
Command Result
<cr> Accepts the current value when the Enter key is pressed.
CLI command summary 185
Command Result
value <cr> Changes the attribute with a new value when the value is entered and the Enter key is pressed.
. Cancels the modification and allows the object to keep its previous value.
To modify a value or attribute of an object, the program responds with a sequence of prompts: one prompt for each attribute of the object. The prompt defines the name and the current value of the attribute. You can change the value, accept the current value, or cancel the modification as follows:
attribute_a (current_value_a): new_value_a <cr>
attribute_b (current_value_b): <cr>
attribute_c (current_value_c): .
The system can display the current value and a list of available values to select. In the following example, the value of attribute_d changes to bbbb:
attribute_d (current_d, (1-aaaa, 2-bbbb, 3-cccc)): 2
When executing the command(s), the program provides the option to modify, save, or cancel the changes. WhenSaveis entered, the system accepts the changes. After the session ends, use the commands inTable 43 "Navigating the menus and displaying help" (page 184)to navigate through the menus.
ICB CLI commands
Table 46 "ICB CLI command summary" (page 185)shows ICB-specific CLI commands.
Table 46
ICB CLI command summary
Menu and command Items and commands System administration:
SA
System Attributes Editor: SY
Use the System Attributes Editor for initial card configuration (see Procedure 13 "Configure initial card parameters using the CLI" (page 73)) and to define the following:
• card name - up to 10 characters; appears in top of the initial window if specified.
• refresh period - time between updates to CLI window when not in use, from 0 to 60 minutes (default is 5 minutes). 0 disables system status display.
Menu and command Items and commands
• short occupancy - detects short connection time of an ICB port.
Connection times less than the threshold can indicate a bad connection of incorrect DN dialed. When this occurs, the system increments a counter. When the system checks counters, it displays those with peg counts as potential problems.
• subnet mask - the subnet mask of the ICB
• gateway IP address - the gateway IP address of the ICB
• IP address - the IP address of the ICB
• disconnect lone participant - time before system disconnects a single participant in a conference (default is 30 minutes).
Note: If changes to IP addresses are to be completed to previously installed ICB4 cards that are currently configured for Dual Card Conferences, the card must be changed to Single Card Mode via the BUI prior to making changes to the IP addresses of the cards.Refer to Figure 28 "Installation Wizard: Step 1 - Basic Card Settings window"
(page 76) System Maintenance:
SM
System Test: ST
To perform system component tests enter:
• i - perform in-service tests that do not disrupt service
• o - perform out-of-service tests
Maintenance Report Browser: MR
Browse maintenance reports by date. For more information, see"CLI Maintenance (Error) Report" (page 218).
Ping Test:
Enter a computer’s IP address to test IP connectivity with this computer.
Short Connection Report: SC
Browse short connection reports by date (see"CLI Short Connection Report" (page 205)).
Database Archive: AR
Backup the customer database (see"Backup" (page 139)).
Database Restore: RE
Restore the customer database (see"Restore" (page 200)).
CLI command summary 187
Menu and command Items and commands
Restarts ICB card and begins software reload.
Message Analysis Tool: SHO
Prints information about an error message that is entered (see"Error message procedures" (page 191)).
Message Filtering: ERR
Enables the filtering of error messages (seeProcedure 39 "Configure error message filtering" (page 193)).
Data Conversion: CONVERT
Copies the data from the upper PCMCIA, converts to ICB Release 4 format, and stores it in the lower PCMCIA.
Protected administration:
PA
Password Editor: PS
Edit passwords (seeAppendix "Password security" (page 235)).
Functionality Upgrade: FU Performs a functionality upgrade.
The system prompts for the number of ports and for the keycode that must be entered in three rows of eight characters each. The system will then prompt for which feature (can be either advanced or basic).
Software Upgrade: SW Performs a software upgrade.
The system first prompts for the source: upper socket or FTP. If FTP is entered, the system then prompts for IP address, path to file, login, and password.
Administrator BUI Reset: AB
Reset passwords to the default (that is, 000000) of all administrators that use the BUI.
Port maintenance:
PM
Port Status Display: PS
Displays status of all ICB ports as follows: Idle, Dialing_out, Ringing, Talking, or Disabled.
Port Disconnect: PD
Disconnect a specific port from the conference.
Report Generation:
RG
Meetings Log Browser: ML
Browse the meeting log (see"CLI Meetings Log Report" (page 207)).
Log ordering: ORDer_mlog
Menu and command Items and commands
Prompts for the same parameters (year, month, day) and displays the log contents sorted by access DN. The advantage is that all records of each specific conference appear together.