NEC Attendant Monitor Operations Manual

							NDA-30135   Revision 1Page 7
Attendant Monitor Operations Manual INSTALLATION & CONFIGURATION
Status messages show the installation 
and configuration of the first Attendant 
Monitor main component.
At the prompt, press Enter to continue 
the installation.
Status messages show the progress of 
the Attendant Monitor installation. 
When all files have been set-up by the 
installer, the Attendant Monitor 
installation is complete.
Press Enter to exit this screen and 
return to the APM Main Menu.
Proceed to the next page to configure the APM and various components...NEC America                 Attendant Monitor            Wed - Oct 31,1996
Configuring StatLogger
autocfg running...
autocfg: AttenantMonitor            application configured.
autocfg terminated normally.
Press Return to continue installation
NEC America                 Attendant Monitor            Wed - Oct 31,1996
Setting up info files...
Old files saved in /tmp/attMonitor0, the system deletes these after 7 days.
Attendant Monitor APM Database files should be modified. Apm should now be Terminated and then Re-Initialized and the appropriate
Installation Complete.
Press Return 
						

							Page 8NDA-30135   Revision 1
INSTALLATION & CONFIGURATION Attendant Monitor Operations Manual
Application Configuration
Since Attendant Monitor is internally supported by the APM, its component must 
be configured in the APM environment. This section provides the information that 
must be entered into the APM configuration file.
Attendant Monitor is set-up in the APM system using the Add function of the 
Application Configuration option on the APM System Administration menu.
A Note on Selecting Commands
In the following procedures, a step may call for pressing the Tab key to select 
a command. It may be necessary to press the Tab key multiple times in order 
to select the specific command. When reading a step, understand to press the 
Tab key (as needed) to select the specified command.
APM System 
ConfigurationFollow the steps to configure the APM system for Attendant Monitor.
-  Enter the APM option from the APM Platform Management menu.
-  Enter the System Administrator password at the APM password screen.
- Select the Application Configuration option from the System 
Administration menu.
AttendantMonitor 
ComponentAttendant Monitor has one component that must be configured through the APM.
AttendantMonitor–Detects events generated by attendants and the PBX, then 
sends messages to the Attendant Console Statistics Logger 
component.
Define the AttendantMonitor component Characteristics in the APM 
environment exactly as shown in the table:
Characteristic Value Description
OAI Application YWhether (Yes or No) the component 
communicates with the NEAX2400 using OAI 
processes.
CRT Application NWhether (Yes or No) the component runs on 
the same screen as the APM, rendering the 
APM temporarily inaccessible.
Communication Queue NCommunication Queue whether (Yes or No) 
the component needs an IPC queue to 
communicate with other processes. 
						

							NDA-30135   Revision 1Page 9
Attendant Monitor Operations Manual INSTALLATION & CONFIGURATION
Primary 
Configuration 
ParametersFrom the APM Configuration Entry screen, configure the AttendantMonitor 
component as follows. All parameters marked with asterisks (*) should be entered 
exactly as shown. The rest of the entries in the table below are just examples.
OAI FacilitiesFollowing the instructions in the APM Operations Manual, name the following 
NEAX2400 facilities for the AttendantMonitor component using the Facilities 
command on the APM Configuration Entry screen:
- SCF Switch Control
- SMFR  Status Request (R)
-  SMFN Status Notification (N)
Continue to the next page for OAI-Conf settings...
Parameter Entry Value Description
Application Name AttendantMonitorThe name to be displayed in the APM menus. 
This name is displayed as it is entered
here — i.e., capital letters, lowercase, etc.
Executable Filename* /oai/app/attMonitor/
bin/attMonitorThe path name of the executable file.
Group*The group that the component belongs to. 
Make no entry.
Response Mode* I(gnore)The action that the APM is to take with the 
component should a member of the group 
terminate.
Initialization Batch   N(o)Whether (Yes or No) the component is to be 
initialized automatically when the OAI system 
is initialized.
Termination Mode* M(essage)How the APM is to notify the component to 
terminate.
Standard Output /dev/nullWhere any output is sent.
Number of Restarts 0How many times the APM may restart the 
component after it terminates in error. 
						

							Page 10NDA-30135   Revision 1
INSTALLATION & CONFIGURATION Attendant Monitor Operations Manual
OAI-Conf SettingsUse the OAI-Conf command on the APM Configuration Entry screen to make the 
necessary parameter entries. For parameters shown with an asterisk (*) in the table 
below, make entries exactly as shown. The other parameters are shown with 
sample entries that may be changed to meet site requirements. Use the instructions 
provided for this option in the APM Operations Manual:
User-Defined 
ParametersNo user defined parameters are used in Attendant Monitor. Therefore, all user 
defined parameters are blank.
Continue to the next page for Database Support...
Parameter Entry Value Description
Database Name #1* /oai/db/cur/tenants The path name of the tenant number 
database.
Database Name #2* /oai/db/cur/Attmon The path name of the Attendant Monitor 
database.
Timeout Value #1 0 Unused
Timeout Value #2 0 Unused
Tenant Number 1 Default Tenant Number
Source Link Name OAI1TCP Port on the source side of the 
communication link. Entry should match a 
link name in the APM system 
configuration file. 
Destination Link Name PBX1TCP Port on the destination side of the 
communication link. Entry should match a 
link name in the APM system 
configuration file. 
Association Recovery 30 Number of seconds Attendant Monitor 
waits before trying to reestablish an 
association with the NEAX that has been 
released. 
						

							NDA-30135   Revision 1Page 11
Attendant Monitor Operations Manual INSTALLATION & CONFIGURATION
Database Support
Attendant Monitor requires two APM databases: the Attendant Monitor database 
and the Tenant Number Database. These databases are created with default values 
during initial software installation, but specific records must be added before 
Attendant Monitor is enabled. 
Attendant Monitor 
DatabaseThe Attendant Monitor database (attmon) consists of a Master Database file 
component and an Application Database file component.
Master Database File - filename ’attmon’.
The attmon master database structure and example entries are shown in the table 
below.
Field Definitions
- The Monitor Number field specifies the monitor number the attendant will 
dial to log on and log off the system.
- The Attendant Name field specifies the attendant name that will be used in 
attendant reports.
- The TTY field specifies the unique TTY device used by the attendant. Since 
stand alone attendants do not use an actual TTY device, the monitored 
number value may be entered again in this field to ensure that the TTY value 
is unique.
- The Supervisor Flag fields specifies if the attendant is a supervisor. It may 
be set to ‘Y’ or ‘y’ to indicate the attendant is a supervisor, or to ‘N’ or ‘n’ 
to indicate the attendant is not a supervisor. 
Application Database File - filename ’Attmon’.
The Attmon application database structure is shown in the table below:
Field NameType Size Min. 
Va l u eMax. 
ValueExample
Entry
Monitored Number A 6 5000
Attendant Name A 8 Smith
TTY A 25 5000
Supervisor Flag A 1 n n
Field Description Data Type
Monitored NumberASCII
Attendant NameASCII
TTYASCII
Supervisor FlagASCII 
						

							Page 12NDA-30135   Revision 1
INSTALLATION & CONFIGURATION Attendant Monitor Operations Manual
Attendant Monitor 
Database (cont)Configuring the Attendant Monitor Database
The database is initially blank. It must be configured before the Attendant Monitor 
application can operate. The database values are set using the APM Applications 
Manager Main Menu-- Selecting the Application Configuration option. The 
general sequence is the following:
1. Build a Master Database File
Enter data into the master database fields to add the necessary Monitored 
Number, Attendant Name, TTY, and Supervisor Flag values for Attendant 
Monitor.
2. Process the Application Database 
Use the Process Application Databases option on the APM Database 
Administration menu to create the application database file.
(When the Process option is activated, data is drawn from the master database 
and converted to the formats specified in the application definition file.)
3. Install the Application Database
Use the Install Application Databases option on the APM Database 
Administration menu to enable Attendant Monitor to copy its database.
Note:Refer to the APM Operations Manual for more detailed instructions on adding a 
database.
AMNO: PBX assignment of Monitored Number
Each monitored number that is specified in the Attendant Monitor database must 
be created on the PBX using the AMNO command.
Note:Refer to the NEAX2400 IMS system manuals for detailed procedures for making 
the data assignments at the NEAX MAT.
Continue to the Tenant Number database on the next page... 
						

							NDA-30135   Revision 1Page 13
Attendant Monitor Operations Manual INSTALLATION & CONFIGURATION
Tenant Number 
DatabaseThe Tenant Database is an APM database used by the Attendant Monitor 
application and other OAI applications. It provides a mechanism for retrieving the 
tenant number of an extension.
The Tenant Number database consists of a Master Database file component and an 
Application Database file component:
Master Database File - filename ’tenant_m’.
The tenant_m master database structure and example entries are shown in the table 
below:
Field Definitions
- The Tenant Number field contains the Tenant Number that is used by one 
or more extensions. Tenant Numbers are associated with extensions using 
the following methods:
-  A Tenant Number may be associated with a set of extensions defined by the 
First and Last Extension fields. The First Extension field contains the 
smallest extension number in the set, and the Last Extension field contains 
the largest extension number in the set.
-  A Tenant Number may be associated with a single extension by setting the 
First and Last Extension fields to the same extension value.
-  A Tenant Number may be associated with a single extension that contains a 
non-numeric character such as ’*’ or ’#’. The First Extension field contains 
the extension value, and the Last Extension field is left blank.
Application Database File - filename ’tenants’.
The tenants application database structure is shown in the table below:
Field NameType Size Min. 
Va l u eMax. 
ValueExample
Entry
First Extension ASCII 100
Last Extension ASCII 1099999
Tenant Number Numeric 3 1 2551
Field Description Data Type
First Extension ASCII
Last Extension ASCII
Tenant Number Short Integer 
						

							Page 14NDA-30135   Revision 1
INSTALLATION & CONFIGURATION Attendant Monitor Operations Manual
Tenant Number 
Database (cont)Configuring the Tenant Number Database
This database must be configured before the Attendant Monitor application can 
operate. The database values are set using the APM Applications Manager Main 
Menu-- Selecting the Application Configuration option. The general sequence is 
the following:
1. Build a Master Database File
Enter data into the master database fields to add the necessary phone line 
numbers.
2. Process the Application Database 
Use the Process Application Databases option on the APM Database 
Administration menu to create the application database file.
(When the Process option is activated, data is drawn from the master database 
and converted to the formats specified in the application definition file.)
3. Install the Application Database
Use the Install Application Databases option on the APM Database 
Administration menu to enable Attendant Monitor to copy its database.
Note:Refer to the APM Operations Manual for more detailed instructions on adding a 
database.
Initialize 
ComponentThe Attendant Monitor component must be initialized from the APM. Follow the 
steps below to initialize the AttendantMonitor component:
-  On the APM System Operations Menu, select the Non-CRT Application 
Control option.
- Use the Initialize command to start up the “AttendantMonitor” component.
This completes the Atendant Monitor application installation and 
configuration... 
						

							NDA-30135   Revision 1Page 15
Attendant Monitor Operations Manual ADMINISTRATOR TASKS
Chapter 3 ADMINISTRATOR TASKS
A change of attendant personnel or changes to monitored numbers will require the 
databases used by Attendant Monitor to be modified. Specific database records 
must be modified to reflect these changes. The following must be changed:
Attendant Monitor Database to reflect changes to attendant names, num-
bers, or other values.
AMNO command to make changes on the PBX.
Tenant Number Database for any changes to numbers.
Perform the following procedures to make changes to the Attendant Monitor 
databases:
Note:Refer to the procedural instructions in the APM Operations Manual. If you en-
counter messages during this process, refer to the “Process” and “Error Messag-
es” chapters of the APM Operations Manual.
Attendant Monitor Database Records
Perform the following steps to add, modify, or delete records:
1. Build a Master Database File
Enter data into the master database fields to change the Monitored Number, 
Attendant Name, TTY, or Supervisor Flag values.
2. Process the Application Database 
Use the Process Application Databases option on the APM Database 
Administration menu to create the application database file.
(When the Process option is activated, data is drawn from the master database 
and converted to the formats specified in the application definition file.)
3. Install the Application Database
Use the Install Application Databases option on the APM Database 
Administration menu to enable Attendant Monitor to copy its database.
AMNO: PBX assignment of Monitored Number
Any monitored number that is added, changed, or deleted in the Attendant Monitor 
database must be so modified on the PBX using the AMNO command.
Note:Refer to the NEAX2400 IMS system manuals for detailed procedures for making 
the data assignments at the NEAX MAT. 
						

							Page 16NDA-30135   Revision 1
ADMINISTRATOR TASKS Attendant Monitor Operations Manual
Tenant Number Database Records
Any changes to monitored numbers will also require a change to the Tenants 
database. Perform the following steps to add, modify, or delete records:
1. Build a Master Database File
Enter data into the master database fields to change the necessary extension 
numbers.
2. Process and Tenant the Application Database 
Use the Process Application Databases option on the APM Database 
Administration menu to create the application database file.
(When the Process option is activated, data is drawn from the master database 
and converted to the formats specified in the application definition file.)
3. Install the Application Database
Use the Install Application Databases option on the APM Database 
Administration menu to enable Attendant Monitor to copy its database.