NEC Name Display An Open Application Interface Installation Guide

							NAME DISPLAY
  AN
OPEN APPLICATION INTERFACE (OAI)
INSTALLATION GUIDE
NEC America, Inc.
NDA-30011-003
Revision 3.0
December, 1996
Stock # 241718 
						

							LIABILITY DISCLAIMER
NEC America reserves the right to change the specifications,  functions, 
or features in this document at any time without notice.  NEC America 
has prepared this document for use by its employees and customers.  The 
information contained herein is the property of NEC  America and shall 
not be reproduced without prior written approval from NEC America.
Copyright 1996
NEC America, Inc. 
						

							NDA-30011  Revision 3.0Page i
Name Display Installation Guide CONTENTS
TABLE OF CONTENTS
Page
Chapter 1 - Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
Chapter 2 - Application Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
Step 1 – Application Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
Step 2 – Primary Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
Step 3 – Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
Step 4 – Secondary OAI Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
Step 5 – User-defined Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Chapter 3 - Database Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
Field  Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
Chapter 4 - MAT Assignment  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9 
						

							Page iiNDA-30011  Revision 3.0
CONTENTS Name Display Installation Guide
This Page Left Blank. 
						

							NDA-30011   Revision 3.0Page 1
Name Display Installation Guide Introduction
Chapter 1 Introduction
This guide provides specific field entries that need to be made in the process of 
installing and configuring Name Display. In addition to this guide, use the 
following manuals for this installation:
Applications Manager (APM) Installation Manual – Contains step-by-step 
instructions for installing the software from the release media.
Applications Manager (APM) Operations Manual – Explains how 
applications like Name Display are configured in the APM environment, using 
the entries and values provided in this guide.
NEAX2400 System Manuals – Give very detailed explanations about the 
assignments that need to be made through the Maintenance Administration 
Terminal (MAT) commands on the NEAX2400.
Briefly, the installation and set up of Name Display involves the following 
sequence of steps:
Software Installation 
Name Display software must first be loaded from the release media. Log in to the 
APM Platform Management Menu, select the Installation of Applications/
Packages option, and follow the instructions provided in the APM Installation 
Manual to complete this part of the installation.
Application Configuration
Name Display is internally supported by the APM and must be configured in the 
APM environment. Chapter 2 of this guide provides the information that must be 
entered into this APM configuration file. Use the instructions provided in the APM 
Operations Manual to make the entries provided in this section.
Database Requirements
Name Display requires one application database that is constructed and maintained 
through the APM Database Administration option. The process begins with the 
creation of a master definition file and its related master database. Then an 
application definition file is constructed which enables the processing of the master 
database file into a Name Display application database. Chapter 3 of this guide 
defines the information which must be included in these definition and database 
files. Use the instructions provided in the APM Operations Manual to make the 
entries contained in this section.
MAT Assignments
Specific data settings must be assigned at the NEAX2400 Maintenance 
Administration Terminal (MAT) before Name Display will function. Chapter 4 of 
this guide specifies the necessary commands and the values at which they are to be 
set. Use the instructions provided in the NEAX2400 IMS System Manuals to 
make the entries contained in this section. 
						

							Page 2NDA-30011   Revision 3.0
Introduction Name Display Installation Guide
The installation process, including its presentation in this manual and reference to 
other manuals that are necessary, is illustrated below.
Figure 1-1   Name Display Installation Requirements
Discussed in:Instructions In
Chapter 1Software InstallationAPM Installation
Introduction
Software Release MediaManual 
Chapter 2Application CharacteristicsAPM Operations
Application Configuration
Primary Parameter ConfigurationManual
OAI Facilities (Optional)
OAI Configuration Parameters (Optional)
User-Defined Parameters
Chapter 3Master Definition FileAPM Operations
Database Requirements
Master Database FileManual
Application Definition File
Application Database
Chapter 4ASYD: (Assignment of System Data)NEAX2400 IMS
Maintenance Administration System Manuals
Terminal (MAT) Assignment 
						

							NDA-30011   Revision 3.0Page 3
Name Display Installation Guide Application Configuration
Chapter 2 Application Configuration
Name Display is configured into the APM system using the Add function of the 
Application Configuration option on the APM System Administration menu. To 
access the Application Configuration option:
1. Enter the APM option from the APM Platform Management 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 in the configuration 
file for Name Display. For specific instructions on what these parameters mean and 
how to make these entries, use the APM Operations Manual.
Step 1 – Application Characteristics
ParameterEntryDescription
OAI Application Y Indicates whether or not (Yes or No) 
this component is an OAI application 
because it communicates with the 
NEAX2400 using OAI processes.
CRT Application N Indicates whether or not (Yes or No) 
this component requires a terminal 
screen that is of the same type as the 
one used by the APM.
Communication Queue N Indicates whether or not (Yes or No) 
this non-OAI component needs an IPC 
queue to communicate with other 
processes. 
						

							Page 4NDA-30011   Revision 3.0
Application Configuration Name Display Installation Guide
Step 2 – Primary Configuration Parameters 
On the APM Configuration Entry screen, make the entries shown below to the 
parameters indicated: 
Parameter
EntryDescription
Application Name Name_Display  Indicates the name to be displayed 
in the APM menus. This name is 
displayed however it is entered 
here; i.e., capital letters, lowercase, 
etc.
Executable Filename /oai/app/namedisp Indicates the path name of the 
executable file.
Group (make no entry) (Name
_Display is not a member of 
a group of applications.)
Response Mode I(gnore) Indicates the action that APM is to 
take with the component when a 
member of its group terminates; 
the I (Ignore) serves as a default 
value since neither component 
belongs to a group.
Initialization Batch Y Indicates whether or not 
Name
_Display is to be initialized 
automatically when the OAI 
system is initialized.
Termination  Mode M(essage) Indicates how the APM is to notify 
Name
_Display to terminate.
Standard Output /dev/null Indicates where Name
_Display 
output is sent.
Number of Restarts 0 Indicates the number of times the 
APM may restart Name
_Display in 
the event that it terminates 
erroneously; 0 indicates that it is 
not to be restarted at all.
Step 3 – Facilities 
According to instructions in the APM Operations Manual, designate the 
following NEAX2400 facility for the Name
_Display component using the 
Facilities command on the APM Configuration Entry screen:
FLF – Free Location Facility 
						

							NDA-30011   Revision 3.0Page 5
Name Display Installation Guide Application Configuration
Step 4 – Secondary OAI Configuration Parameters 
Using the OAI-Conf command on the APM Configuration Entry screen, make the 
entry shown for each of the following parameters required by Name
_Display. Use 
the instructions provided for this option in the APM Operations Manual:
Parameter
EntryDefinition
Database Name #1 /oai/db/cur/namefile Indicates the path name of the 
database containing the extension 
numbers, display names, and their 
corresponding employee names. 
The database filename namefile, 
listed here with its path, should be 
used as the name of the 
corresponding Application 
Definition File. (See Create an 
Application Definition File on 
page 7 for more information.)
Tenant Number 1 Specifies the number of the tenant 
to which the extensions apply.
Source Link Name OAI1X25 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 PBX1X25 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 
Name
_Display will wait before 
trying to re-establish an association 
with the NEAX that has been 
released. 
						

							Page 6NDA-30011   Revision 3.0
Application Configuration Name Display Installation Guide
Step 5 – User-defined Parameters
Make the following additional parameter entry through the UserDefined command 
on the APM Configuration Entry screen.
Parameter
EntryDefinition
        #1 16 The length of the Display Name 
field in the Name Display database 
(8 or 16 characters); this entry must 
agree with the size of the Display 
Name field in the database. (See 
Display Name in Field Definitions 
on page 8 for more information.)
This completes the configuration of Name
 Display in the APM. Now go to 
Database Requirements to create its database support.