NEC Attendant Management System Operations Manual

							NDA-30046 Revision 4.0Page 17
Attendant Management System Operations Manual Installation And Setup
Step 3: Automatically 
Configuring the APM 
ComponentsIf this is the first time the installation is run, the following messages appear for the 
AMS_Deamon, AMS_ParkMgr, MSG_CLEAN and AMS_Server. These 
messages require no response.
Figure 2-5   Configuring the APM Components (1 of 2)
If this is an upgrade, the installation asks if each component should be reconfigured 
to use the default values. We recommend that you type n to avoid overwriting any 
previous configuration changes.
Figure 2-5  Configuring the APM Components (2 of 2)
Step 4: Installing 
Informix Database
If this is a new installation, type y and press Enter at the following prompt:
Figure 2-6   AMS/Informix Prompt
Autocfg running...
Autocfg: AMS_Daemon application configure
Autocfg terminated normally
Autocfg running...
autocfg: AMS_Daemon is already configured.
Autocfg: Reconfigure (y/n)?
Continue with installation of AMS/Informix Database? (y/n) 
						

							Page 18NDA-30046 Revision 4.0
Installation And Setup Attendant Management System Operations Manual
Step 4: Installing 
Informix DatabaseThe screen shown below appears. If your system requires a database password, 
type the Informix password and press Enter at the prompt. If your system does not 
require a password, the screen illustrated in Figure 2-8 displays automatically.
Figure 2-7   The Informix Password
If this is not an upgrade, type n and press Enter at the following prompt:
Figure 2-8   AMS Database Prompt (1 of 2)
If this is not an upgrade, type n and press Enter at the following prompt:
Figure 2-8  AMS Database Indices Prompt (2 of 2)
The following prompt signals that installation is complete.
Figure 2-9   Installation Complete Status Message
Creation of AMS Database requires Informix privileges.
If you have an error logging in as informix in the
next step and you have not yet created the AMS database,
built the database indices, and/or clustered the tables,
you may log in as amsadm and
*Install Database
*Build Database Indices
*Cluster Database Tables
after this installation but prior to configuring the
attendant terminals or logging in as ams.
Please Enter Informix Password: 
Does the AMS Database already exist? (y/n) n 
Do the AMS Database Indices already exist? (y/n) n 
AMS Installation complete. 
						

							NDA-30046 Revision 4.0Page 19
Attendant Management System Operations Manual Installation And Setup
Step 5: SCO UNIX 
Subsystem DatabaseThe SCO UNIX Subsystem Databases must be updated to accept the new AMS 
information. Following this update, the passwords for the ams and amsadm login 
names should be deleted.
Log into the SCO UNIX system as the superuser (root) and execute the SCO UNIX 
Subsystem Database authorization checking program (/tcb/bin/authck-s) and 
password deletion program (passwd -d) as shown in Figure 2-10 below.
Answer yes when asked to fix the subsystem databases. This ensures that the SCO 
UNIX Subsystem Databases are left in a proper state. If passwords are deleted for 
the ams and amsadm login names, the system will ask for new passwords when a 
user is first logs on using these names.
Figure 2-10   SCO UNIX Subsystem Database
This completes the loading of AMS software in the APM. Proceed to Application 
Configuration on page 20 to configure AMS components in the APM.
Sysname
Welcome to SCO System V/386
sysname!login: root
Password: 
# /tcb/bin/authck -s
The following users have Protected Password Database entries
that do not match their Subsystem Database entries:
Fix them (y/n)? y 
# passwd -d ams
Deleting password for user: ams
.
.
.
Last Unsuccessful password change for ams: NEVER
# passwd -d amsadm
Last successful password change for ansadm: xxxxxxxxxx
Last Unsuccessful password change for amsadm: NEVER
# 
						

							Page 20NDA-30046 Revision 4.0
Installation And Setup Attendant Management System Operations Manual
Application Configuration
Since the APM internally supports AMS, the three components of AMS must be 
configured in the APM environment. (If you choose the autocfg option in Step 3: 
Automatically Configuring the APM Components on page 17, the application and 
its components will already be configured for you. However, you may wish to 
review the parameters. These parameters can be changed based on the needs of 
your site.) This section provides the information that must be entered into this APM 
configuration file.
Note:
AMS is configured into the APM system using the Add function of the Application 
Configuration option on the APM System Administration menu.
1. Enter the APM option from the APM Platform Administration Main Menu.
2. Enter the System Administrator password at the APM password screen.
3. Enter the Application Configuration option from the System Administration 
menu.
This section contains the information that should be entered to the configuration 
file for AMS. These components must be configured:
Daemon–Manages the incoming call queues, call counts, and abandons. 
Once this component is initialized, it starts up the Server(s) 
and ParkMgr components.
Server–Processes attendant commands from the menu (such as 
cancel, answer, and transfer) using the OAI. More than one 
Server can be configured
ParkMgr–Manages call parking, orbit numbers, and joins and recalls 
used in Meet-me Paging.
MsgCleaner–Removes all delivered employee messages from the Informix 
database after a preconfigured amount of time. (See “Basic 
Configuration” on page 104 for more information.)
For specific instructions on what these parameters mean and how to make these 
entries, refer to the 
APM Operations Manual. 
						

							NDA-30046 Revision 4.0Page 21
Attendant Management System Operations Manual Installation And Setup
Step 1: Application 
Characteristics (all 
components)In adding AMS to the APM Application Configuration file, characterize each of its 
components EXACTLY as follows: 
Parameter Definitions:
OAI Application–Shows whether or not this component 
communicates with the NEAX2400 using OAI 
processes.
CRT Application–Indicates if this component runs on the same screen 
as the APM, rendering the APM temporarily 
inaccessible.
Communication Queue–Indicates if this non-OAI application needs an IPC 
queue to communicate with other processes.
Step 2: Primary 
Configuration 
ParametersOn the APM Configuration Entry screen, make the entries for the parameters 
shown for each component. For parameters designated with a (†), make the entries 
EXACTLY as shown. The other entries shown here are the recommended values. 
Parameter Daemon Server1 ParkMgr MsgCleaner
OAI ApplicationYYYN
CRT ApplicationNNNN
Communication 
QueueNNNN
Parameter Daemon Server ParkMgr MsgCleaner
Application Name†Ams_Daemon Ams_Server1 Ams_Parkmgr Msg_Clean
Executable Filename
†/oai/app/ams/
bin/amsdmn/oai/app/ams/
bin/amssrv/oai/app/ams/
bin/amspmg/oai/app/ams/
etc/msgcln
Group
†AMS AMS AMS (blank)
Response Mode
†N(otify) N(otify) N(otify) I(gnore)
Initialization Batch Y(es) N(o) N(o) N(o)
Termination Mode
†M(essage) M(essage) M(essage) K(ill)
Standard Output/oai/log/dbg/
amsdmn.out/oai/log/dbg/
amsrv.out/oai/log/dbg/
amspmg.out/oai/log/dbg/
msgcln.out
Number of Restarts * 0 0 0 
						

							Page 22NDA-30046 Revision 4.0
Installation And Setup Attendant Management System Operations Manual
Step 2: Primary 
Configuration 
Parameters 
(continued)Parameter Definitions
Application Name†–Shows the name displayed in the APM menus. This 
name will appear as it is entered here. You can enter 
lowercase letters and punctuation, but not spaces.
Executable Filename
†–Designates the path name of the executable file.
Group
†–Shows the group to which the component is tied.
Response Mode
†–Indicates the action that the APM takes with the 
component should a member of the group terminate.
Initialization Batch–Designates the component that will be initialized 
automatically when the OAI system is initialized.
Termination Mode
†–Indicates how the APM is to notify the component to 
terminate.
Standard Output–Shows the file into which component output is 
redirected.
Number of Restarts–Designates the number of times the APM may restart 
the component after it terminates in error. 
(*) designates that APM will attempt to 
automatically restart the component each time it 
terminates abnormally. Since the Daemon will 
attempt to initialize the Server and ParkMgr after it is 
initialized, the number of restarts for these 
components should always be 0.
Step 3: FacilitiesAccording to instructions in the APM Operations Manual, choose the following 
NEAX2400 facilities for each of the components (Daemon, Server, Parkmgr). Use 
the Facilities command on the APM Configuration Entry screen:
Facility Name Ams_Daemon Ams_Server1 AMS_Parkmgr
SCF – Switch Control  X X X
SMFN – Status Notification (N) X X X
SMFR – Status Request (R) X X X
SSFR – Service Request (R) X
SSFM – Status Service Facility Monitor X
RCF – Restriction Control Facility X 
						

							NDA-30046 Revision 4.0Page 23
Attendant Management System Operations Manual Installation And Setup
Step 4: OAI 
ConfigurationUsing the OAI-Conf command on the APM Configuration Entry screen, make the 
following entries required for the Ams_Daemon, Ams_Server1, and 
Ams_Parkmgr components. For parameters designated with a (†), make the entries 
EXACTLY as shown. The other entries shown here are only examples. Use the 
instructions provided for this option in the APM Operations Manual. Be prepared 
to enter the parameters listed below for the Ams_Daemon, Ams_Server1, and 
Ams_Parkmgr components.
Ams_Daemon Component Parameters
The following table lists the parameters for the Ams_Daemon component. 
Remember that parameters designated with a (†) must be entered EXACTLY as 
shown. 
Parameter Entry Description
Database Name #1†/oai/db/cur/Amscfg The path name of the database containing 
configuration information.
Database Name #2
†/oai/db/cur/Amsfile All the directory and files names needed by the 
AMS.
Timeout Value #1 10 The number of seconds to wait before 
determining if the ParkMgr and Server are both 
online with the PBX.
Timeout Value #2 1 Number or retries after a rejection or timeout of 
an OAI message sent to the PBX.
Tenant  Number 1 The number of the PBX tenant that AMS serves. 
This is used for ANT and monitored numbers.
Source Link Name OAI1TCP The port on the source side of the 
communication link; entry should correspond to 
a link name in the APM system configuration 
file.
Destination Link 
NamePBX1TCP The port on the destination side of the 
communication link; entry should correspond to 
a link name in the APM system configuration 
file.
Association Recovery 10 The number of seconds Ams_Daemon waits 
before trying to re-establish a tie with the NEAX 
that has been released.
User  Defined  #1  The name of any OAI application running on the 
system. It will start automatically after AMS 
comes up.
User Defined #2  Stat_Logger The application name of the AMS 
statistics package. Include this name only if the 
separate application AMS Statistics Package is 
also installed on the System.
User Defined #3 - 14 The name of any additional OAI applications 
running on the system. They will be started 
automatically after AMS comes up. 
						

							Page 24NDA-30046 Revision 4.0
Installation And Setup Attendant Management System Operations Manual
Ams_Server1 Component Parameters 
The following table lists the parameters for the Ams_Server1 component. 
Remember that parameters designated with a (†) must be entered EXACTLY as 
shown. 
Parameter Entry Description
Database Name #1†/oai/db/cur/Amscfg The path name of the 
database containing 
configuration information.
Database Name #2
†/oai/db/cur/Amsfile All the directory and files 
names needed by the AMS.
Timeout Value #1 (no entry) Not used.
Timeout Value #2 1 Number or retries after a 
rejection or timeout of an 
OAI message sent to the 
PBX.
Tenant Number 1 The number of the PBX 
tenant that AMS serves.
Source Link Name OAI1TCP The port on the source side 
of the communication link. 
Entry should correspond to 
a link name in the APM 
system configuration file.
Destination Link Name PBX1TCP The port on the destination 
side of the communication 
link. Entry should 
correspond to a link name 
in the APM system 
configuration file.
Association Recovery 10 The number of seconds 
Ams_Server1 waits before 
trying to re-establish an 
association with the NEAX 
that has been released. 
						

							NDA-30046 Revision 4.0Page 25
Attendant Management System Operations Manual Installation And Setup
Ams_Parkmgr Component Parameters
The following table lists the parameters for the Ams_Server1 component. 
Remember that parameters designated with a (†) must be entered EXACTLY as 
shown. 
Parameter Entry Description
Database Name #1†/oai/db/cur/Amscfg The path name of the database containing 
configuration information.
Database Name #2
†/oai/db/cur/Amsfile All the directory and files names needed 
by the AMS.
Timeout Value #1 20 The number of seconds to wait before 
trying to place a call on an ANT again.
Timeout Value #2 1 Number of retries after a rejection or 
timeout of an OAI message sent to the 
PBX.
Tenant Number 1 The number of the PBX tenant for the 
AMS attendants.
Source Link Name OAI1TCP The port on the source side of the 
communication link; entry should 
correspond to a link name in the APM 
system configuration file.
Destination Link 
NamePBX1TCP The port on the destination side of the 
communication link; entry should 
correspond to a link name in the APM 
system configuration file.
Association Recovery 10 The number of seconds Ams_Parkmgr 
waits before trying to re-establish an 
association with the NEAX that has been 
released.
User Defined #1 Meet-me Paging station, if any. This is a 
D
term reserved for joining parked parties 
with paged parties who have just dialed an 
orbit number. It must be set in offhook 
suppress with the handset offhook when it 
is used for this purpose. Not needed for J 
4.9 HDS or Version E ICS (or higher). 
User  Defined  #2 3 The maximum number of times to play the 
delayed announcement configured. (See 
“Announcement Configuration” on page 
108 for more information.) If the 
announcement is configured and this field 
is equal to 0, the message will play one 
time. If there is not an announcement 
configured, this parameter has no effect.  
						

							Page 26NDA-30046 Revision 4.0
Installation And Setup Attendant Management System Operations Manual
Step 5: Control 
OptionsSet up the Msg_Clean application for automatic startup:
1. Choose the Control Options option from the APM System Administration 
menu.
2. Choose the Application command from the Control Options menu.
3. Choose Msg_Clean.
4. Use the Initialize command to define the time at which the application will 
start automatically.
To start Msg_Cleaner at 3:05 every morning, enter:
Minute: 5
Hour of Day: 3
Day of Month: *
Month of Year: *
Day of Week: *
This completes the configuration of AMS in the APM. Proceed to Database 
Requirements on page 27 to learn how to prepare its database support.