ROAMER AN OPEN APPLICATION INTERFACE (OAI) INSTALLATION GUIDE NEC America, Inc. NDA-30016-003 Revision 1.
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.
Roamer Installation Guide CONTENTS TABLE OF CONTENTS Page Chapter 1 - Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 2 - Application Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Step 1: Application Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 2: Primary Configuration Parameters . . . . . . . . . . . . . . . .
CONTENTS Roamer Installation Guide This Page Left Blank. Page ii NDA-30016 Revision 3.
Roamer Installation Guide FIGURES LIST OF FIGURES Figure Title 1-1 4-1 4-2 Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 OAI Function Key Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 OAI Function Key Assignment Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 NDA-30016 Revision 3.
FIGURES Roamer Installation Guide This Page Left Blank. Page iv NDA-30016 Revision 3.
Roamer Installation Guide Chapter 1 Introduction Introduction This guide provides specific field entries that need to be made in the process of installing and configuring Roamer. 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.
Introduction Roamer Installation Guide A Note About the Logical and Physical Numbers Used By Roamer: Roamer uses logical and physical numbers to move users from one phone to another. A physical number (e.g., 4502) is the actual extension associated to a Dterm or station through the NEAX2400 MAT. A logical number (e.g., 202) is an arbitrary number that is associated to a telephone user and that is controlled by the Open Application Interface (OAI). Physical numbers are not moved.
Roamer Installation Guide Introduction ROAMER INSTALLATION REQUIREMENTS Instructions in: Discussed in chapter: Chapter 1 Software Installation Software Release Media APM Installation Manual APM Operations Manual Chapter 2 Application Configuration Application Characteristics Primary Parameter Configuration OAI Facilities (Optional) OAI Configuration Parameters (Optional) User-Defined Parameters Chapter 3 Database Requirements Master Definition File Master Database File Application Definition File A
Introduction Roamer Installation Guide This Page Left Blank. Page 4 NDA-30016 Revision 3.
Roamer Installation Guide Chapter 2 Application Configuration Application Configuration Roamer 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 Management Menu. 2. Enter the System Administrator password at the APM password screen. 3. Enter the Application Configuration option from the System Administration menu.
Application Configuration Roamer Installation Guide Step 2: Primary Configuration Parameters On the APM Configuration Entry screen, make the entries shown below to the parameters indicated. Note: Entries for parameters that are marked with an asterisk (*) should be made exactly as they are shown. All other entries in this guide serve only as examples. Parameter Application Name Executable Filename* Group* Description Roamer The name to be displayed in the APM menus.
Roamer Installation Guide Application Configuration Step 3: OAI Facilities According to instructions in the APM Operations Manual, designate the following NEAX2400 facilities for Roamer using the Facilities command on the Configuration Entry screen: FLF MRFI NTF TCFI Note: NDA-30016 Revision 3.0 Free Location Mode Release (I) Number Transfer Terminal Control (I) MRFR MSF TCFD Mode Release (R) OAI Mode Set Terminal Control (D) The same MSF identification number (i.e.
Application Configuration Roamer Installation Guide 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 Roamer. Use the instructions provided for this option in the APM Operations Manual: Parameter Entry Description /oai/db/cur/ roamerdb The path name of the database containing user information.
Roamer Installation Guide Application Configuration Step 5: User-Defined Parameters Make the following additional parameter entries through the UserDefined command on the APM Configuration Entry screen: Parameter Entry Description User Defined #1 3 The number of the Roamer Dterm function key LED. This number must correspond to the function key assigned to Roamer at the NEAX MAT. For more information, see Chapter 4, “MAT Assignments” on page 15.
Application Configuration Roamer Installation Guide Parameter Entry Description User Defined #7 0 The number of 30-minute intervals that the backup file will remain valid after a power failure. The largest allowable value is 48 (24 hours). A longer delay must be indicated with the value 0 (always valid). User Defined #8* /oai/app/data/ roamerbu The name of the backup file that reflects the current status of assignments.
Roamer Installation Guide Chapter 3 Database Requirements Database Requirements Roamer uses the following two databases, only the first of which is created through the APM: • The Roamer Database This database contains default assignment information. Each user ID is associated to telephone numbers and privileges, a tenant, and a reset option. This database is created through the APM and is configured as /oai/db/cur/ roamerdb.
Database Requirements Roamer Installation Guide Instructions The information required in all four steps is provided in table below. Using this information with the procedural instructions provided in the APM Operations Manual, enter the Database Administration option on the APM System Administration Menu, and build the Roamer database. Any messages displayed during these steps are discussed in the Process and Error Messages chapter of the APM Operations Manual.
Roamer Installation Guide Field Definitions Database Requirements User ID A unique 10-digit number that describes each user (e.g. social security number). The database is sorted by this field. User Name The 16-character user name that is displayed on the Dterm. Logical Number The station number associated with the user name under Roamer control. Exempt from Reset? Whether or not (Yes or No) this user is to be reset to a home phone when all system phones are reset.
Database Requirements Roamer Installation Guide This Page Left Blank. Page 14 NDA-30016 Revision 3.
Roamer Installation Guide Chapter 4 MAT Assignments MAT Assignments This guide assumes that data settings that affect the operation of all OAI software on a system-wide basis have already been assigned on the NEAX Maintenance Administration Terminal (MAT). Such settings include system index values and assignment of Interface I/O Port Data in the Interface Processor (IP).
MAT Assignments Roamer Installation Guide AOKC Command: (Assignment of OAI Key Codes) This command is used to associate the MSF facility and its operation code that was configured in the APM for Roamer to one of the 14 OAI Key Codes in the MAT. 1. Select an unused OAI Key Code from 1 to 14. To determine what Key Codes are available for assignment, use the LOKC command to list the AOKC Key Codes that are already assigned. 2.
Roamer Installation Guide MAT Assignments PBX Correspondence of AOKC AKY1 OAI Function Key Codes APM Application Configuration Roamer configured for MSF #129 MAT AOKC Command OAI Key code #10 given MSF facility type and Op-Code #129 Key Indices 1 2 < . . . .> < . . . .> 34 35 3 < . . . .> 36 4 < . . . .> 37 5 < . . . .> 38 6 < . . . .> 39 7 < . . . .> 40 8 < . . . .> 41 9 < . . . .> 42 10 < . . . .> 43 11 < . . . .> 44 12 < . . . .> 45 13 < . . . .> 46 14 < . . . .
MAT Assignments Roamer Installation Guide Assignment of Numbering Plan to Support Free Location Feature ANPD Command: (Assignment of Numbering Plan Data) This command is used to assign the actual first digit and the total number of digits for the set of physical numbers and again for the logical numbers. For instance, if the physical numbers are to be four digits long and lie in the range between 3000 to 3999, the first digit is 3 and the total number of digits is 4.