INTRODUCTION
This section explains how to install the Strategic Enterprise Management Application Programming Interface (semAPI) soft-ware and how to use the ICICONF.EXE program to configure an INFI 90 OPEN interface for use with the semAPI software. Refer to OVERVIEW for a list of the procedures required to install the semAPI software.
OVERVIEW
The procedures required to install Windows NT/95 API soft-ware are:
1. Install the software key. Refer to Appendix N for details. 2. Invoke the installation program to create the directory structure and extract the semAPI files from the distribution media. The semAPI installation program, SETUP.EXE:
a. Creates the semAPI directory structure on the target disk device.
b. Copies semAPI library and setup files to the appropriate directories.
3. Use the ICICONF.EXE program to define the logical link between the INFI 90 OPEN communication modules as they are referred to in an application program and the actual physi-cal port name for the interface module. It is recommended that the INFI 90 OPEN communication modules be set up and con-nected to the Windows NT/Windows 95 system prior to instal-lation.
SOFTWARE KEY
The semAPI software package comes with a software key that plugs into the termination device. The software key is required in order to use the semAPI software. Refer to Appendix N for installation details.
INSTALLATION
The following procedure installs the semAPI software into the following directory hierarchy:
INSTALLATION
\ICI\LIB Library subdirectory containing the object libraries.
\ICI\EXE Executable subdirectory containing the generic linked execut-able modules: TALK90
\ICI\EXE\WIN95 Executable subdirectory containing the linked executable modules specific to Windows 95 systems: DEVICE.EXE, ICI-CONF.EXE.
\ICI\EXE\WINNT Executable subdirectory containing the linked executable modules specific to Windows NT systems: DEVICE.EXE, ICI-CONF.EXE.
\ICI\INCLUDE Header subdirectory containing the header files for the semAPI software package.
\ICI\SOURCE Source subdirectory where user application source code can reside. A sample application program is included in this direc-tory called SAMPLE.C.
To install:
1. Insert Disk 1 into the 3.5-inch floppy disk drive.
2. Run SETUP.EXE, to load the software from the floppy disk drive. The setup program automatically updates older versions of the semAPI software.
3. The setup program loads into memory and prepares to install the semAPI software. The API Setup screen appears and displays the copyright notice (Fig. 3-1). Click the Next but-ton to move on to the next installation step. Use Cancel to exit the installation procedure at anytime.
4. The setup type dialog box is displayed in Fig. 3-2. There are three types of setup procedures: typical, compact, and custom. Typical setup installs all programs, libraries, and other pro-gram development files. Compact setup installs only the test program TALK90.EXE, the device driver program DEVICE.EXE, and the logical ICI configuration program ICI-CONF.EXE. Custom setup allows the user to select which options to install.
Figure 3-3 shows the Select Component dialog box that opens if custom setup is selected. Select one or more of the listed items. Select Talk90 Application to install the test program, TALK90.EXE. Select ICICONF Configuration Utility Application to install the logical ICI configuration program, ICICONF.EXE. Select Device Driver Application to install the ICI device driver, DEVICE.EXE. Select Development System Files to install the library and include files. These files are required to develop semAPI applications. Select Sample Files to install code for a sample semAPI application.
To continue with the installation procedure, select a setup type, and press N or click Next.
5.The setup program searches the system registry for any pre-viously installed version of API software. If it finds existing API software, a prompt displays the existing API release number and asks for a response to upgrade, update, or overwrite the existing API release. Click Yes or press Y to begin the installa-tion process. Click No or press N to exit the setup program. If yes is selected, Elsag Bailey applications may not be available for use unless they are re-installed.
INSTALLATION
If the setup program detects that the existing API software has greater functionality than the API software being installed, a prompt appears. Figure 3-4 shows the prompt that appears when installing a data acquisition (DA) version of API software onto a machine where a supervisory control (SC) version of the API software already exists. Click Yes or press Y to begin the installation process. If the API upgrade release to be installed is incorrect, press N, or click No to exit the setup program.
6. Elsag Bailey applications require a special version of the device driver. If the setup program detects that Elsag Bailey applications are installed which use the existing API software, Figure 3-5 appears to warn that the loaded Elsag Bailey appli-cations may be disabled when the software is installed. Click
Yes or press Y to begin the installation process and overwrite
the existing semAPI software used by the Elsag Bailey applica-tions. If yes is selected and the existing semAPI software is overwritten, any previously loaded Elsag Bailey applications may need to be re-installed.
To avoid disabling any Elsag Bailey applications during the installation process, press N, or click No. From the prompt
Figure 3-3. Select Components Dialog Box
shown in Figure 3-6, click OK to install the semAPI software from the select components dialog box (Fig. 3-3). From the select components dialog box, disable the Device Driver
Appli-cation option and continue with the installation process.
7. If there is no previous semAPI software registered in the system registry, Figure 3-7 appears and displays a default directory for the semAPI installation. Press N or click Next to use the default directory and move to the next prompt.
Select Back or press B to return to the prompt shown in Figure 3-2 and Step 4 of the installation procedure.
Figure 3-5. Installation Prompt (Overwrite Elsag Bailey Applications)
Figure 3-6. Installation Prompt (Select Custom Installation)
INSTALLATION
Click Browse or press r to change the root directory at the prompt shown in Figure 3-8. Enter a directory path under
Path: or select a destination directory under Directories: The
destination directory entered becomes the root directory for all semAPI development and configuration files.
Select Network from the Choose Directory dialog box to display the dialog box shown in Figure 3-9. From this dialog box, the user can connect the computer to a network drive. This will enable the computer to install the semAPI software on a net-work drive.
NOTE: The INICI03 interface requires a software key. This software
key is shipped with the semAPI software. Each licensed software key is configured to support a limited number of simultaneous users. Additional copies of the semAPI software and possibly additional INICI03 interfaces may be required to use this feature.
Figure 3-8. Choose Directory Dialog Box
The prompt in Figure 3-10 is displayed if the setup program detects that semAPI software is installed in the directory selected for executables.
To install the semAPI software on a system that has semAPI software loaded and configured, press N, or click No.
Since Elsag Bailey applications require a special version of semAPI software, another prompt is displayed (Fig. 3-6). Select
Custom from Setup Type prompt and disable Device Driver Application from the Select Components dialog box when
installing the semAPI software.
Click Yes or press Y to begin the installation process and over-write the existing Elsag Bailey applications. The Elsag Bailey applications may be disabled and require reloading.
8. Select a program folder into which the program icons should be installed. Figure 3-11 shows the Select Program
Folder dialog box. The suggested default program folder is
Elsag Bailey. Press N or click Next to use the default program folder directory and begin installing the software. To change the name of the program folder, enter the desired name in the
Program Folder list box or select an existing folder from the Existing Folders list box and press N or click Next to begin installing the software.
The setup program begins installing the software and displays its progress. After all the files are installed, the setup program updates the program registry. Click OK when prompted to exit the setup the program. The installation is complete.
Refer to ICI INTERFACE CONFIGURATION for an explanation of how to use the ICICONF program to create a configuration file for the INFI 90 OPEN communication modules. The appli-cation program references INFI 90 OPEN modules using a logi-cal ICI number. The configuration file cross references logilogi-cal interface devices with physical device names.
ICI INTERFACE CONFIGURATION ICI INTERFACE CONFIGURATION
This procedure shows how to use the ICICONF program. The ICICONF program must be executed prior to the first time an application attempts to connect to the INICI03 interface. If the default directories were used during software installation, the setup program installed software into the directories listed under INSTALLATION.
ICICONF.EXE is in the executable subdirectory, and the install program built an icon for this program. Double click on the icon, or click on the application via the File Manger or Windows Explorer to execute the program.
The first time ICICONF is executed, it creates a default configu-ration. The default configuration sets:
• The node name (Name/Address of Node) to the local com-puter node name.
• The physical device (Physical ICI Device) to COM2:.
• The communication protocol (Network Communication
Pro-tocol) to LOCAL.
• The device driver TCP/IP to 3001.
Figure 3-12 shows the semAPI Application Logical Definition dialog box. When any part of a configuration is changed, save it by clicking SAVE. Click RESET to return to the previously saved configuration and click QUIT to exit the ICICONF pro-gram.
The following steps explain each of the entries within the
semAPI Application Logical ICI Definition dialog box.
1. The Application Logical ICI is an assigned logical ICI num-ber that is required by a client application. There are 20 selec-tions available (20 possible ICI configuraselec-tions) from the pop-down list box shown in Figure 3-13.
When a new logical ICI is selected, the ICICONF program dis-plays the settings for that logical ICI. To keep track of multiple ICI configurations, a text string describing each connection can be entered in the Connection Description list box.
2. Figure 3-14 shows the pop-down list box for Physical ICI
Device. The system verifies which types of devices can be
con-nected and displays the applicable devices. Select the appro-priate ICI device to configure a particular ICI interface.
COM1: and COM2: are always displayed. ENET: is displayed
when the computer has TCP/IP software installed (for use with an INOSM01 interface).
In the case of a SCSI INICI03 interface connection, the list box displays which INICI03 interfaces are currently connected to the computer and functioning properly. S003: is shown in the example (Fig. 3-14), meaning a SCSI INICI03 interface is con-nected to the computer on the first SCSI card on its first SCSI bus at address 3.
3. Set the Network Communication Protocol from the appropri-ate pop-down list box. This box lists the network communica-tion protocol being used by client applicacommunica-tions using this
ICI INTERFACE CONFIGURATION
logical ICI and the device driver for the device listed in Physical
ICI Device. Other unique logical ICIs using different network
communication protocols can be defined to talk to the same physical ICI device.
NOTE: When assigning a network communication protocol for one
logical ICI, all other logical ICIs using the same physical ICI device will adopt the same network communication protocol.
Enter the name or IP address of the computer node executing the device driver in the Name/Address of Node list box.
Figure 3-13. List Box (Application Logical ICI)
If TCP/IP network protocol is the communication protocol between the client application and server tasks, then a service port number must be assigned for all physical ICI devices being used, whether serial or SCSI. The selection and assignment of a port number to each physical ICI device is arbitrary, but each port number must be unique and not already in use by other TCP/IP services. Port numbers must be greater than or equal to 1024 and less than or equal to 65535. Additionally, each logical ICI must have a unique port number. Enter the port number in the Device Driver TCPIP Communication Port list box. 4. The RS232 Serial Communication Parameters list box is enabled whenever physical ICI device COM1: or COM2: is selected. Figure 3-15 shows the Baud Rate pop-down list box. Enter the appropriate parameters for Baud Rate, Parity, Data
Bits, and Stop Bits based on the dipswitch selections set on the
INICIT03A module.
5. When ENET: is the selected physical ICI device, all parame-ter list boxes are disabled except the Name/Address node list box. Enter the name or IP address for the INOSM01 interface handling the logical ICI.
6. When a SCSI INICI03 interface is the selected physical ICI device, the RS232 Serial Communication Parameters list boxes are disabled. Enter the appropriate parameters in the Name/
Address of Node, Network Communications Protocol, and TCP/ IP Port list boxes.
When working with a previously configured SCSI INICI03 inter-face that was red-lighted or not connected to the computer on reboot, a warning prompt is displayed (Fig. 3-16). If the user
COMPUTER INTERFACE SETUP
changes and configures the same SCSI physical ICI device, the pop-down list box does not display the physical ICI device nor can it be selected until the computer is rebooted with a func-tioning SCSI INICI03 interface.
COMPUTER INTERFACE SETUP
Refer to Appendix N for computer interface module installation and setup information, and software key installation.
