User Manual Remote Admin
Version # 1.1 Document Rev. 2.1 – Jan 2001
eComServer, Inc. 116-200 Village Blvd. Princeton, NJ 08540 (800) 348-9664
Visit our web site at: http://www.ecomserver.com
Table of Contents
Introduction and User Interface……………………………………………………page 3 Users Log In, Log Out and Priorities………………………………………….…...page 8 Administrator Functions and Client Environment Configuration…….……..….page 9 Voice System Database Administration…………………………………………...page 13 Voice Equipment Administration………………………………………………….page 19 Hosts………………………………………………………………………..…….…page 36 Systems Control….……………..……………………………….………….…..…..page 51 Voice Services………………………………………………………..….……..…...page 56 Feature Packages……………………………………………….. ………………...page 57 Reports……………………….………………………………………………….….page 62 System Monitors…………………………………………………………………...page 71 Backup and Restore Operations…………………………………………………..page 75 Installation and Support Information…………………………………………… page 77
Introduction and User Interface
Remote Admin is a powerful user-friendly GUI tool for the day-to-day operations of the INTUITY CONVERSANT Systems. This package uses windows style point and click user interface, which is easy to use and requires minimal training. This document serves as a reference guide.
Intended Audiences
The primary audience for this document is system administrators and others responsible for CONVERSANT systems. This includes, on-site technicians who perform system administration at the customer site, and customers who choose to administer their own systems.
Trademarks eComServer, Inc. has made every effort to supply trademark information about company names, products, and services mentioned in this document.
• 5ESS, AUDIX, CONVERSANT, DEFINITY, and Voice Power are registered trademarks of Lucent Technologies. • INTUITY and FlexWord are trademarks of Lucent Technologies. • Microsoft, MS, MS-DOS, Internet Explorer, and Excel are registered trademarks and Windows is a trademark of Microsoft Corporation. • UnixWare is a registered trademark of The Santa Cruz Operation, Inc. • UNIX is a registered trademark of UNIX System Laboratories, Inc. • ORACLE, ORACLE * Terminal, OBJECT * SQL, SQL * FORMS, SQL * Menu, SQL * Net, SQL * Plus, PRO * C and SQL * ReportWriter are trademarks of the Oracle Corporation.
User Interface
The Remote Admin screen is divided into three panes or widows.
• Map Window: The main window, called the map window, shows the current map. The current map is displayed as a tree. The first level children represent various sites, the next level children are machines at each site and below that are components, which are managed by Remote Admin. • Information Window: Information Pane is on the right side of the map window. This part on the screen shows information about the current selected object in the map pane (left). For example if Database is the currently selected object then it will show all the information for Database.: The information window is on the right side of the map window. This window shows information about the current selected object in the map window (left). For example if Database is selected in the map window, the information window will display all the information about the Database. • Message Window: The Message window, at the bottom of the map window, displays all the messages generated by Remote Admin and received from remote host. The Message window, below the map and information window displays all the messages generated by Remote Admin and received from the remote host.
A single left click on any valid object in the map window, will update the information window with the information from remote host. A second single left click on the same node will not update the information window for optimization reasons if you want an immediate refresh of information then you must double click on that object. System Monitors are updated at certain intervals automatically. Title Bar Menus The following drop down menus is available.
File: New Map Open Map Close Save Map Export Data Save Output Run Command Exit
Edit: Edit map Clear Messages
File - New Map: Ability to create new map file. A dialog box appears where the user cans add/delete sites and CONVERSANT machine names. Make sure the machine name is valid and is known to your TCP/IP system.
File - Open Map: Use this menu option if you want to open a previously saved map. The current map will be closed and a new one will be loaded in the Current Map pane. Title heading of the application indicates the currently open map. File - Close: Closes currently selected map. File - Save Map: To save current map *NJ*? File - Save Map as: Use this option to save current map in a new file. You will be prompted with the save file dialog box.
File - Export Data: Lets you save information in Information pane in a file. This information is tab separated and can be imported into popular spreadsheets for further use.
File - Save Output: Lets you save the contents of Message pane for logging purpose or any other future use. File - Run Command: Gives you the option to run any command on remote host. *NJ* You can select the command from the dropdown list (supply parameters) or type in any other valid command. File - Exit: Exits the application. Edit - Edit map: Ability to change the current map. You get a dialog box to add / delete sites and CONVERSANT machine names. Make sure machine name is a valid name known to your TCP / IP system. Edit - Clear Messages: Lets you clear the message window.
Context Sensitive menus Most of the objects in Current Map pane will show Context Sensitive menus when clicked using right button on the mouse. What menu items are shown for each object and what they do is discussed in chapter 2 to 5. You must first select the object using the left button on the mouse before you can access the Context Sensitive menus.
Status Line - In most of the dialogs you will see a message in status bar.
Voice System Administration This part describes the procedures needed to perform voice system administration through the Remote Admin user interface. The Voice System Administration provides access to many administrative options. This part describes tasks related to the Voice System Administration. Access the Voice System Administration Start Remote Admin application on your desktop. Open a map, select a site, and then select the machine. Click on the 'Voice System' object in the map window to access the Voice System Administration functionality.
From the Voice System Administration, you have access to all the major administrative features of the voice system. This section provides a brief overview of each administrative option.
Configuration Management The Configuration Management allows you to perform the following administrative tasks: Add or remove database access IDs Manage all voice system circuit card resources Diagnose equipment Administer channels numbers and functionality Configure host sessions and manage host protocols (Future Release) Modify system messages Report system status Stop and start the voice system
Feature Packages The Feature Packages provides administrative access to the optional feature packages currently installed. Administer the Adjunct/Switch Application Interface (ASAI) package, if installed, through the Feature Packages.
Reports The Reports allows you to generate and customize reports for: • Call classification and data • System messages • System traffic • Custom Reports System Monitor This option monitors the system's voice channels and provides input on channel states (on-hook, dialing, etc); call states, and caller input.
Users Log In, Log Out, And Priorities
There are two user priorities in Remote Admin system: Administrator and Regular User. First time after installation, the system asks to enter the Administrator's name and password:
There can be only one Administrator in the system.
Next time, after system starts, you will see the prompt to login as Administrator or as Regular User:
You can choose user name from the list. Only Administrator has the privilege to add new users. (See also: Administrator Functions and Configuration).
Logging Out:
To log out immediately, choose the command "Log Out" of File Menu. You can also set the idle time for automatic logging out, by choosing "Timeouts" item of Configuration menu:
The default idle time before logging out is 20 minutes.
Administrator Functions and Client Environment Configuration
Administrator Functions Menu:
The Administrator can add Regular Users, delete Regular Users, change Regular User's password, see User's commands history and run manual commands. To run manual command, choose the item "Run Command."
To use other Administrator functions, choose the item "Users Management":
System Configuration Menu:
For user's convenience, there is the ability to change the maximal time before response received from remote machine ("Command timeout"), and the idle time before automatic logging out.
You can also record all your actions into the log file, or record only the manual commands, depending on your setting:
To prevent endless output of some commands, there is the ability to change maximal strings quantity in Message Window output per one command cycle:
The default strings quantity is 80.
Voice System Database Administration
ORACLE database is used to store voice system call data. This part describes how to administer voice system database access IDs. Clicking on the Database item displays currently recognized Database Access ID tables in the information pane. The information shown for databases is the Database Access ID, Remote Machine and Database SID as shown in the table below.
Table below describes each field in the Database Access ID Table window.
Database Access IDs List of Database Access IDs, each representing an established ORACLE database connection to the system. See ‘‘Database Access IDs’’ below for more information. Remote Machine Remote machine name. DB SID Database instance, ORACLE_SID or database name (dbname) on ORACLE systems. There could be multiple instances on a remote machine.
Note: If Remote Machine or DB SID fields are blank, the connection is to a local ORACLE database. If these fields are populated, connection is to an ORACLE database on the system machine or to an ORACLE database on the machine specified in the Remote Machine field.
Database Access ID: Each ID listed in the Database Access ID Table window represents an established local or remote connection to an ORACLE database. This connection is used by the voice system’s applications to access a customer’s database tables. The database ID represents local or remote database to the voice system.
An application can access multiple database tables in a local database (that is, residing on the voice system’s hard disk). However, you can improve the access performance by adding multiple database access IDs to that local database to split the access evenly between the multiple database access IDs.
You can perform the following operations on a Database Object.
Add a Local Database Access ID
Use the procedure below to add a local database access ID:
Select Database
Right click on Database
The system displays Database Pop-up menu:
Select 'Add Local Access ID’ menu option.
The system displays Add Local Database Access ID dialog box.
Select Access Id from the drop down list.
Click OK button to save the database access ID.
Double click Database object to refresh information pane.
Stop and start the voice system.
The system establishes the local database connection(s).
Add a Remote Database Access ID Using SQL * NET V1
Before you can add a remote database access ID, the voice system and remote machines must be connected to a TCP / IP local area network and have the SQL * NET Version 1 or 2 software installed.
NOTE: SQL * NET Version 1 and 2 can coexist in the same machine.
CAUTION: The combination of machine name + database ID cannot be longer than 13 characters. If the combined text string is longer than 13 characters, UNIX will perform a core dump, that is, UNIX will abort the current command involving the text string that is too long and write troubleshooting information to a file in the current directory called 'core'.
Use the procedure below to add a remote database access ID:
Select Database
Right click on Database
The system displays Database Pop-up menu
Select 'Add Remote Access ID - V1' menu option.
The system displays Add Remote Database Access ID dialog box.
Select Access Id from the drop down list.
Enter the name of the remote machine in the Remote Machine name field.
Enter the DB SID in the Database Instance ID (SID) field to identify the database instance of the remote ORACLE machine (the ORACLE_SID variable on ORACLE Version 5 machines or the dbname variable on ORACLE Version 6.0 machines).
The DB_SID field is not required if the ORACLE database on the remote machine is a single instance that is not identified by ORACLE_SID (ORACLE Version 5) or dbname (ORACLE Version 6.0).
The DB SID field is required if the remote machine ORACLE database is identified by ORACLE_SID or dbname.
Click OK button to save the database access ID.
Double click Database item to refresh information pane.
Stop and start the voice system.
Add a Remote Database Access ID Using SQL*NET V2
You must have the INTUITY CONVERSANT System Version 6.0 SQL * NET TCP / IP installed on your system to use SQL * NET V2 for remote database access. See Installing the Oracle SQL * NET TCP / IP
Package in Chapter 11, Installing Optional Feature Software, in the maintenance book for your platform for information on installing the SQL * NET V2 software.
Host, Port and SID information is the same for both SQL * NET V1 and V2. See Configuring the TNS Listener: LISTENER.ORA and Identifying the Servers: TNSNAMES.ORA in Chapter 4, Contents of the Configuration Files, in the ORACLE Administration Guide, 585-350-909, for more information on setting these parameters.
Use the procedure below to add a remote database access ID using SQL * NET V2:
Select Database
Right click on Database
The system display Database Pop-up menu
Select 'Add Remote Access ID - V2' menu option.
The system displays Add Remote Database Access ID dialog box:
Select Access Id from the drop down list.
Enter the connect descriptor for the remote host in the Remote Host Connect Descriptor field to identify the connection between the remote database SID and the name of the remote machine.
Click OK button to save the database access ID.
Double click Database item to refresh information pane.
Stop and start the voice system.
The system establishes the remote database connection(s).
Remove a Database Access ID
Database Access ID allows you to remove one or more existing database access IDs, thereby dropping the connection to the associated ORACLE database.
CAUTION: When you remove a remote database access ID, make sure that no applications use that Database Access ID. If an application uses an ID that has been removed, the application will fail when it tries to access data stored in that database.
Use the procedure below to remove a database access ID:
Select Database
Right click on Database
The system display Database Pop-up menu
Select 'Remove Access ID' menu option.
The system displays Remove Database Access ID dialog box.
Select Access Id from the drop down list.
Click OK button to save the database access ID.
Double click Database item to refresh information pane.
Stop and start the voice system.
The system removes the database connection.
NOTE: DB1_local represents the standard connection to the local ORACLE database and cannot be removed, because there must always be at least one connection to the local database.
Database Monitoring
To monitor database space utilization, a user can execute 'Free', 'Used', and 'Fragmentation' commands:
'Free' command shows the free space amount for every table in the database, both in ORACLE blocks and in Mbytes (each block is equal to 2048 bytes):
'Used' command shows the used space amount in the database for every table. The space amount is shown both in ORACLE blocks and in Mbytes.
)UDJPHQWDWLRQ FRPPDQG VKRZV WKH DOORFDWLRQ XVDJH DQG IUDJPHQWDWLRQ RI WKH GDWDEDVH ERWK LQ 25$&/(EORFNV DQG 0E\WHV
Voice Equipment Administration
Voice equipment includes those circuit cards and they’re associated channels in the system that provide voice system functionality such as the digital and analog circuit cards (T1 / E1 and Tip / Ring, respectively) and the speech processing circuit cards (SP / CMP and SSP).
Use the Voice Equipment to:
Assign, display, and unassigned voice system equipment options and states
Change channel maintenance states
Assign, display, and unassigned channel and telephone number services
Assign, display, and unassigned circuit card and channel functions Voice Cards Administration
All cards i.e. TipRing, SP and LST1 can be controlled. The following information is displayed for each cards: Card Number, Type, Attributes, Functions, Osidx, State, Pending, Errq, OwnerQ, Group, Flash, Wink, IVol, and OVol.
Right clicking on any card allows you execute actions:
Display Voice Cards Information
Use the procedure below to display voice equipment information:
Click on the voice equipment (‘Analog’ or 'Digital' or 'Speech Processing’)
Voice equipment information will display on the right window.
Voice Equipment of Analog Cards
Analog cards can be assigned two different Voice Equipment options, 'talk' or 'tdm'. This option allows the user to indicate to the voice system the function of the analog card.
Follow the procedure below to change the voice equipment option for analog cards.
Select the 'Analog item and right click on it.
The system displays the following pop-up menu
Select 'Change Voice Eqp Options'.
A 'Change Voice Eqp Options' box appears.
Select an option from the drop down menu (talk or tdm).
Enter the card number or select from the drop down menu.
Then click 'OK'.
Assign Functions to Speech Processing cards
The Assign Functions menu allow you to assign one of several installed pack file functions to SP/SSP circuit cards, or to change the currently assigned functions of SP/SSP circuit cards
Use the procedure below to assign functions to SP/SSP circuit cards:
Click on the 'Speech Processing' item.
Speech processing cards information will be displayed on the right window.
Right Click on 'Speech Processing' item.
Te system displays the following Pop-up menu: Select 'Assign functions' menu option.
! CAUTION: The Speech Processing circuit card must be in the 'manoos' state before functions may be assigned to it. Be careful when making assignments and reassignments. Assignments made to Speech Processing cards window will overwrite any other assignments currently in effect on the specified circuit cards. See ‘Change State of Cards’ for more information on changing states.
System displays 'Assign functions to SP cards' dialog box.
Enter the desired Cards No(s) in the text box or select from the drop down list, and check the box next to each function to be assigned.
Click 'OK' button.
Double click on the 'Speech Processing' object to refresh the information pane.
Change State of Cards
The equipment's state indicates to the voice system whether or not a voice circuit card/channel is ready and able to receive calls, process speech, etc. in other words, whether it can perform the job required of it. The Change Equipment State menu option allows you to change the state, or maintenance state, of a card/channel.
Refer to INTUITY CONVERSANT Administration manual for details of these states.
Use the procedure below to change the state of the card's voice channels:
Select a card (Analog, Speech Processing, or Digital) and right click on that object.
The system displays the following pop-up menu
Select the 'Change State' menu option.
System displays the 'Change State of Cards' dialog box.
Enter the 'New State' or select from the drop down list.
Enter the card number, range of numbers or select from the drop down list.
Select 'Yes' or 'No' from the drop down list for the 'Change Immediately' field.
Click 'OK' button.
Diagnose Equipment
! CAUTION: Run diagnostics on a TDM bus master circuit card during off–hours. The diagnostic procedure has a negative impact on call processing. See ‘‘modify the Display Voice Equipment Window Parameters’’ below for more information about identifying the circuit card that serves as the TDM bus master.
You can run diagnostics on Analog, Speech Processing or Digital circuit cards or the TDM bus. Diagnosing an Speech Processing circuit card also diagnoses its associated companion circuit cards (CMPs) if FlexWord™ or WholeWord speech recognition is assigned to the SP. Run diagnostics whenever the system displays a message indicating circuit card failure.
Use the procedure below to diagnose equipment:
Click on the type of card to be diagnosed.
Right Click on that object.
The system displays the following pop-up menu:
Select the 'Diagnose' menu option.
System displays 'Diagnose cards' dialog box.
Enter the Cards No(s) or select from the drop down list.
Enter 'Yes' or 'No' for immediate diagnosis?
Specifies whether or not there should be immediate diagnosis on the selected circuit card or bus. If you choose yes, all calls on active channels for the specified equipment are terminated. If there
are active calls and you choose no, the circuit card is returned to the original state and diagnostics are not performed.
Click 'OK' button. Channels Administration
Display of Channel's Information
Use the procedure below to display channels information:
Click on the 'Channels' object.
Channel information will display on the right window.
Following information fields are shown for Channels.
Channel Number, Card Number, Port Number, State, Pending, Stat Time, Service, Startup, Phone, Group, OwnerQ, Options, and Type. By right clicking you can execute following actions.
Assign Services
The Assign Services to Channels allows you to specify the service or application to use for incoming calls on one or more channels.
Use the procedure below to assign services to channels:
Click on the 'Channels' item.
Channel information will display on the right window.
Right Click on 'Channels' item.
Select 'Assign Services' menu option.
System displays 'Assign services to channels' dialog box.
Enter the service name or select from the drop down list.
Enter the startup name (optional) or select from the drop down list.
Enter the channels number or range or change the option 'All'.
Click 'OK' button.
NOTE: A special service name of "*DNIS_SVC" is available. It allows you to select a number service based on the called and calling numbers. It is also used when a single trunk supports multiple services or special services are required for specific callers. DNIS (called party) is available with T1 (E&M), E1 (CAS), and PRI. DNIS is also available when ASAI is used with a Tip/Ring, LST1, or LSE1 connection to a DEFINITY® switch.
Another special service name "ANI" (calling party) is available with PRI, or when ASAI is used with a Tip / Ring, LST1, or LSE1 connection to a DEFINITY switch.
Unassigned Services
The unassigned Services to Channels allow you to unassigned service from one or more channels.
Use the procedure below to unassigned services to channels:
Click on the 'Channels' item.
Channel information will display on the right window.
Right Click on 'Channels' item.
Select 'Unassign Services' menu option.
System displays 'Unassign services to channels' dialog box.
Enter the service name or select from the drop down list.
Enter the startup name (optional) or select from the drop down list.
Enter the channels number or range or choose the option 'All'.
Click 'OK' button.
Assign Extension
Use the procedure below to assign a PBX extension telephone number to a channel:
Select and right click on 'Channels' item.
The system displays Pop-up menu:
Select 'Assign Extension' menu option.
System displays 'Assign extension to channels' dialog box.
Enter the 'Extension'.
Enter the channel number, or channels range, or select the option 'All'.
Click 'OK' button.
Unassign Extension
Use the procedure below to unassign a PBX extension telephone number from a channel:
Select and right click on 'Channels' item.
Select 'Unassign Extension' menu option.
System displays 'Assign extension to channels' dialog box.
Enter the 'Extension'.
Enter the channel number, or channels range, or select the option 'All'.
Click 'OK' button.
Change State
The equipment states indicate to the voice system whether or not a voice circuit card / channel is ready and able to receive calls, process speech, etc. - in other words, whether it can perform the job required of it. The Change Equipment State menu option allows you to change the state, or maintenance state, of a card/channel.
Refer to Intuity Conversant Administration manual for details of these states.
Use the procedure below to change state of voice channels:
Select and right click on 'Channels' item.
Select 'Change State' menu option.
System displays 'Change State of channels' dialog box.
Enter the 'New State' or select from the drop down list.
Enter the channel number, or channels range, or select from the drop down list.
Enter 'Yes' or 'No' for 'Change Immediately' or select from the drop down list.
Click 'OK' button.
Change Voice Equipment Option
The equipment options, talk or tdm, indicate to the voice system the functionality of the analog and / or digital circuit cards (also known as voice circuit cards).
Use the procedure below to change voice equipment options for analog and digital circuit cards:
Select and right click on 'Channels' item.
Select 'Change voice eqp options' menu option.
System displays 'Change voice equipment options for channels' dialog box.
Enter the option or select from the drop down list.
Enter the channels number or select from the drop down list.
Click 'OK' button.
Renumber Voice Channels
The Renumber Voice Channels option removes all nonexistent (NONEX) circuit cards from the voice equipment table, then reorders all existing equipment with E1 / T1 circuit cards first, followed by Tip / Ring circuit cards, then SP / SSP circuit cards. This reordering changes the channel numbers of some circuit cards. However, user–defined characteristics such as options, attributes, and script assignments do not change. If a circuit card is found in the system that was not in the voice equipment table, it is added under the appropriate heading (E1 / T1, Tip / Ring, or SP / SSP) with default settings.
! CAUTION: Renumbering voice channels brings down the system immediately and restarts it. When you select this option, a warning is displayed and you are given the option of continuing with the procedure or returning to the System Control menu.
Use the procedure below to renumber voice channels:
Click on the 'Channels' item.
Channel information will display on the right window.
Right Click on 'Channels' item.
The system displays Pop-up menu.
Select 'Renumber voice channels' menu option.
The system renumbers voice channels.
Groups
The Group menu option allows to assign and unassign channels to equipment group(s). For example, an equipment group can be dedicated to outbound call bridging so that bridging does not interfere with incoming calls.
Assign Group to Channels
Use the procedure below to assign an equipment group to channels:
Select and right click on 'Groups' item.
The system displays Pop-up menu:
Select 'Assign' menu option.
System displays 'Assign groups to channels' dialog box.
Enter the channels number or range or select from the drop down list.
Enter the group or select from the drop down list.
Click 'OK' button.
Unassign Group to Channels
Use the procedure below to assign an equipment group to channels:
Select and right click on 'Groups' item.
Select 'Unassign' menu option.
System displays 'Unassign groups from channels' dialog box.
Enter the channels number or range or select from the drop down list.
Enter the group or select from the drop down list.
Click 'OK' button.
Host
Host Configuration
Use the Host Configuration menu to access, configure, and display host sessions, and to define SDLC and Token Ring protocol information:
Under Host you have control of SDLC Protocol and Token Ring Protocol
SDLC Protocol
Following information fields are shown for SDLC Protocol.
Name, Card, Line Type, Node ID to Send, Encoding, Constant Carrier, Poll Address and LU.
By right clicking you can execute following actions.
Add
Add SDLC protocol:
Select Connection Name, Card Number, Encoding *What*, whether or not constant carrier. Select or enter Line Type. Enter values for Node ID to send, Pol Address and LU Number.
Change
Change SDLC protocol:
Select Connection Name, Card Number, Encoding *What*, whether or not constant carrier. Select or enter Line Type. Enter values for Node ID to send, Pol Address and LU Number.
Delete
Delete SDLC protocol:
Select Connection Name, Card Number, Encoding *What*, whether or not constant carrier. Select or enter Line Type. Enter values for Node ID to send, Pol Address and LU Number.
Diagnose
Diagnose SDLC connection: Select or Enter the Connection Name.
Rename
Rename SDLC Connection name. Select or Enter Current and New Connection name in the list boxes.
Token Ring Protocol
Following information fields are shown for Token Ring Protocol.
Name, Adapter Device Name, Local SAP Address, Remote SAP Address, Node ID to Send, Remote Network Address and LU. By right clicking you can execute following actions.
Add
Add Token Ring Protocol:
Select or Enter Connection Name.
Enter Adapter Device name, Local SAP Address, remote SAP Address, Node ID to send, remote Network Address and LU Number.
Change
Change Token Ring Protocol:
Select or Enter Connection Name. Enter Adapter Device name, Local SAP Address, remote SAP Address, Node ID to send, remote Network Address and LU Number
Delete
Delete Token Ring Protocol:
Select or Enter Connection Name. Enter Adapter Device name, Local SAP Address, remote SAP Address, Node ID to send, remote Network Address and LU Number.
Rename
Rename Token Ring Protocol: Select or Enter Current and New Connection name in the list boxes.
Messages Administration
Messages are used to provide information about events and errors during system operations. System messages vary in content, priority, destination, and threshold parameters. Use the Message Administration to:
List all the parameters associated with system message.
Add or remove a new destination to/from the current list of destinations for the system message.
Modify a message priority.
Modify the system message threshold period.
Add or remove a new threshold or threshold message ID pair to or from the current list of thresholds for the system message.
Note: Some messages are generated with destinations and priorities that are not administrate through system message administration windows (that is, gen001, gen002, and thr001-4). Almost all other messages can be administered through the message administration.
Access Message Administration
Information about all messages is displayed in the information window.
Field Description for Message Display Window:
MessageID Specifies a unique name for each message in the system
Mnemonic Short description of the message Priority Message Priority: Specifies the urgency level of the message. The Message Priority may be NONE or - (for none), * (for minor), ** (for major), or *C (for critical)
Destination Specifies a list of destinations where the message should be sent. By default, messages are sent to the message master log and either the alarm (if the message is an alarm) or event (if the message is an event).
Thres. Specifies the length of time the message is included in the threshold count, provided that one or Period more thresholds are defined for this message. Message Thresholds: Shows the message threshold for the corresponding Message ID in the Threshold Message ID column. Most messages will not be associated with a threshold.
Thres Specifies the number of messages to be generated within the threshold period necessary to trigger the threshold action.
Thres. Specifies the ID of the message to be generated when a threshold is reached. The priority and MsgId the destinations for the threshold message should be meaningful as a threshold action. For example, message ID VROP003 may have a priority of minor (*), while its corresponding threshold message ID could be THR003, which has a major (**) priority. Generating the THR003 message after enough VROP003 messages have been generated within the Threshold Period is the threshold action. THR001, THR002, THR003, and THR004 have priorities of none (-), minor (*), Major (**), and critical (*C), respectively.
The following commands can be run on Message Object.
Add Message Destinations
The system’s message log provides a complete account of all messages generated by the voice system. All system messages are assigned to the appropriate destination during installation.
NOTE: If a message is changed from the event destination to the alarm destination, a similar change should be made on the message priority from none (-) to minor (*) and vice versa.
Use the procedure below to add a destination to a message:
Select Messages
Right click on Messages
The system displays Messages Pop-up menu:
Select 'Add Destination' menu option.
The system displays 'Add Message Destination' dialog box.
Select Message Id from the drop down list.
Select Destination from the drop down list.
Click OK button to add the destination.
Double click Messages object to refresh information pane.
The system installs the changes on the voice system.
Valid message destinations are:
Stderr The standard error of the process generating the message. Since most system processes redirect standard error to the system console, specifying this destination may result in the message being sent to the system console. Console The system console or /dev/console. AlertPipe A specially named pipe for messages that must be sent directly to the alerter. The alerter pipe is used for some special system processes. Specification of the alerter pipe for other system messages has little or no effect on the system message facility or the alerter itself. The system is distributed with some messages specified with the alerter pipe as a destination. This destination should not be removed from the message.
NOTE: Separating alarm destinations from event destinations ensure that alarm messages do not overrun event messages, and vice versa. Alarm Specifies that the delivery system send all alarm level messages (priority "*", "**" and "*C") to the alarm log. The alarm log may be accessed via the display messages command or the Message Log Report window. Event Specifies that the delivery system send all event level messages (priority "-") to the event log. The event log may be accessed via the display messages command or the Message Log Report window. mxmtr Used only when the Netview Alarms package is installed. Messages sent to mxmtr are sent to the appropriate Netview Alarm device. If this package is not installed, messages with this destination have no effect on the system.
Remove Message Destinations
This procedure allows you to remove a destination from the current list of destinations for the system message. Use the procedure below to remove a message destination:
Select Messages:
Right click on Messages
The system displays Messages Pop-up menu:
Select 'Remove Destination' menu option.
The system displays 'Remove Message Destination' dialog box.
Select Message Id from the drop down list.
Select Destination from the drop down list.
Click OK button to remove the destination.
Double click Messages item to refresh information pane.
The system installs the changes on the voice system.
Add Thresholds
Message thresholds are triggering devices that alert operations personnel to take action when a certain number of messages are generated over a certain period of time. Message threshold allows for escalation of message priority or criticality. A system message may be of little concern when it occurs in small numbers over long time intervals. However, if message occurrences increase over shorter time intervals, this may indicate more serious problems with the system. Message threshold sends a new message to be sent when a threshold is reached. The new message may be higher in priority and have a different destination set than the original message. This procedure adds a new threshold and threshold message ID pair to the current list of thresholds for the current system message.
Use the procedure below to add a message threshold:
Select Messages
Right click on Messages
Select 'Add Threshold' menu option.
The system displays 'Add Threshold' dialog box.
Select 'Message Id' from the drop down list.
Enter a non-negative integer threshold value or none in the 'Threshold' field.
Select 'Threshold Message Id' from the drop down list.
Click OK button to add the threshold.
Double click Messages item to refresh information pane.
The system installs the changes on the voice system.
Remove Thresholds
This procedure allows you to remove a threshold or a threshold message ID pair from the list of thresholds for the system message.
Use the procedure below to remove a message threshold:
Select Messages
Right click on Messages
Select 'Remove Threshold' menu option.
The system displays 'Add Threshold' dialog box.
Select 'Message Id' from the drop down list.
Enter a non-negative integer threshold value in the 'Threshold' field.
Click OK button to remove the threshold.
Double click Messages item to refresh information pane.
The system installs the changes on the voice system.
Modify Message Priorities
This procedure allows you to modify message priority. When the system is installed, each message is assigned a particular priority. In most cases, these priorities are appropriate and do not need to be modified. Depending on the type of application, however, you may want to modify a message priority. Events are messages of priority none (denoted by "-" in the System Message Administration window). Alarms are messages of priority minor, major, and critical (denoted by "*", "**", and "*C", respectively, in the System Message Administration window).
Use the procedure below to modify a message priority:
Select Messages Right click on Messages
Select 'Modify Priorities' menu option.
The system displays 'Modify Message Priority' dialog box.
Select 'Message Id' from the drop down list.
Select 'Message Priority' from the drop down list.
Click OK button to modify the priority.
Double click Messages item to refresh information pane.
The system installs the changes on the voice system.
Modify Threshold Periods
This procedure allows you to modify the system message threshold period, or the interval of time over which messages are counted for a given threshold.
Use the procedure below to modify a threshold period:
Select Messages
Right click on Messages
Select 'Modify Threshold Period' menu option.
The system displays 'Modify Message Threshold Period' dialog box.
Select 'Message Id' from the drop down list.
Enter a time interval in the 'Threshold Period' field.
You must enter the threshold period as a time interval with the following syntax: {number}{dimension} [{number}{dimension}] where {number} is a positive integer and {dimension} is one of the following single characters: w for weeks, d for days, h for hours, m for minutes, or s for seconds. Table 3-5 provides examples of threshold periods and the required syntax.
Click OK button to modify the threshold period.
Double click Messages item to refresh information pane.
The system installs the changes on the voice system.
Threshold Period Examples:
Specification Value or Description 1s 1h A 3601 second threshold period 2w A 14 day threshold period 5m 30s A 330 second threshold period 5m 3m BAD INTERVAL Two minute specifications.
System Control
Use the System Control menu to:
Display the status of the INTUITY CONVERSANT system
Start and stop the voice system
Diagnose buses
Report Voice System Status
Use the procedure below to see whether the voice system is running or stopped, and to view the current voice system run level.
Click on the 'System Control'
Voice system status will display on the right window.
Stop the Voice System
This procedure stops the voice system by taking all system channels out of service with the option to wait for in - progress calls to end. Stopping the system is usually done when you are performing some type of routine service such as backup and restore. When the system is stopped, the CPU does the following:
Places the entire system in the idle state when all lines are free
Saves internal system tables
Turns off voice system processes
Stopping the voice system takes approximately 2 to 3 minutes to complete.
Use the procedure below to stop the voice system:
Click on the 'System Control'
Voice system status will display on the right window.
Right Click on 'System Control'
Select 'Stop Voice System' menu option.
The system displays messages in the output window.
Double click 'System Control' object to refresh information pane.
Start the Voice System
This procedure allows you to start or restart the voice system. When this process is invoked, all channels that were deactivated when you stopped the voice system are returned to service in the maintenance state they had when the voice system was last running.
Use the procedure below to start the voice system:
Click on the 'System Control'
Voice system status will display on the right window.
Right Click on 'System Control'
Select 'Start Voice System' menu option.
The system displays messages in the output window.
Double click 'System Control' object to refresh information pane.
NOTE: Immediately after starting the voice system, you will be unable to perform some administrative commands and you may receive a system message indicating that MTC is busy. After the system is initialized, MTC will be free to handle administrative commands.
Shut Down the System
! CAUTION: Always stop the voice system before executing a shutdown. Shutting down the system without stopping the voice system may negatively affect the software.
Use the procedure below to shut down the system:
Click on the 'System Control'
Voice system status will display on the right window.
Right Click on 'System organizes'
The system displays Pop-up menu:
Select 'Shutdown System' menu option.
The system displays 'Shutdown System' dialog box.
Select 'Shutdown the computer' or 'Restart the computer'.
Enter wait time in seconds.
Click OK button to shutdown the system.
Bus
By right clicking you can execute following functions.
Diagnose
Diagnose Bus: Enter or Select Bus Numbers from list.
Select whether Diagnose is required immediately or not.
Voice System
Assign, display, and unassign voice system equipment options and states
Change channel maintenance states
Assign, display, and unassign channel and telephone number services
Assign, display, and unassign circuit card and channel functions
Print a report of voice system circuit card and channel options
What is info shown *NJ*
By right clicking you can execute following actions:
Start Voice System to start Voice System.
Stop Voice System to stop Voice System.
Shutdown System
A user can choose one of 4 options for remote machine shutdown: Shutdown, Shutdown with reboot, Shutdown and reboot with ID build, Shutdown the Voice System first. In cases of Shutdown and Shutdown with reboot a user can also specify the waiting time before shutdown.
Voice Services
Under Voice services you have Services, Channel Services and Number Services.
Services
The Services object displays all services.
Channel Services
The Channel Services object displays all currently assigned channel services.
Number Services
The Number Services object displays all currently assigned number services.
Called From, Called To, Calling From, Called To, Service.
Feature Packages Administration
This chapter describes the procedures to administer optional feature packages in the voice system. This release supports the following feature packages:
Adjunct/Switch Application Interface (ASAI) Feature Packages
The Feature Packages administration provides administrative access to the optional feature packages currently installed. ASAI Administration
ASAI is a software standard that allows applications, such as those written in Script Builder, to effectively communicate with DEFINITY® switches. This release of Remote Admin supports the following ASAI Administration options: