Progress Database Overview Section 4 Introduction Release Contents The interface to the Progress relational database is an application tool available as an option only on the 40AP6400 hardware platform. It is not available on the Conductor UX (PIWCUX) hardware platform. This interface is developed and licensed by ABB. Progress relational database products may be purchased from Progress Software Corporation. Progress V7 product components include: Progress application development environment (ADE): User interface builder. Data dictionary. Procedure editor. Progress 4GL. Application debugger. On-line help. Translation manager. Performance profilers. Database administration. Application integration: Dynamic data exchange (DDE). Dynamic link library (DLL). Host language call (HLC). UNIX pipes. Progress relational database management system. This release is compatible with 40AP6400 and these Progress V7 products: ProVISION client with the database server (full). Query/report client with the database server (query). Database server (run-time). WFPEEUI220005C0 4-1
Software Loading and Installation Procedures There is one license that is sold with the 40AP6400: pscdev. This license is for the 40AP6400 interface only. Software Loading and Installation Procedures Prerequisites Install Shared Library Install C Compiler In the procedures in all of the following sections, the prompts and user entries from these prompts are shown. A return is implied following each entry. All procedures must be followed in the order in which they are presented. Any information listed below that appears on the console is meant to be typical and may vary slightly from one installation to another. The following two items must be installed prior to the Progress software installation: The shared library libnsl.so. C compiler. 1. To install the shared library libnsl.so, insert the IRIX 5.3 CD-ROM into the CD-ROM drive and then type inst. The installation main menu will be displayed 2. Type inst eoe1.sw.svr4net at the installation main menu to select the subsystem for installation 3. Type go at the Inst prompt to install the selected subsystem. 4. Type quit at the Inst prompt to exit the installation menus. 1. To install the C compiler, insert the IRIX 5.3 CD-ROM into the CD-ROM drive and then type inst. The installation main menu will be displayed. 2. Type go at the Inst prompt to install the C compiler subsystems. 3. Type quit at the Inst prompt to exit from the installation menus. 4-2 WFPEEUI220005C0
Software Loading and Installation Procedures Load the Progress Distribution Check the Installation 1. Insert the Progress distribution tape into the data management center tape drive and execute the installation script by typing: cpio -iudvcbm </dev/mt/tps0d3 RETURN./proinstall RETURN 2. After entering serial numbers and control digits for all licensed products, change these installation device names by typing the following and then continue with the installation. Refer to Progress Installation Notes for installation details. Rewind Device: /dev/mt/tps0d3 No Rewind Device: /dev/mt/tps0d3nr By default, Progress is installed under the /usr subdirectory. For more information, refer to Progress Installation Notes. To verify that Progress was installed correctly: 1. Type: setenv DLC /usr/dlc cd /usr/dlc bin/prodb 2. Enter mywork as the name of the new database. 3. Enter demo to access the system demonstration database. 4. Enter /bin/pro mywork as the name of the new Progress database created for the demo. If the previous steps were successfully executed, Progress was installed correctly. The Progress README file, which contains additional release notes, is located in /usr/dlc/readme.pro. SUGGESTION: Change the mode of the Progress scripts in /usr/bin so that all users have execute permission. WFPEEUI220005C0 4-3
License Key Administration License Key Administration Menu System Activation License Administration Edit License File A menu-driven system administration facility is available at the operator station via the system console or by logging in via telnet from another system or X-terminal. The menu subsystem provides a user-friendly interface to system utilities, maintenance operations, and administrative functions. All of the menus have built-in help. Entering? will display help information about the current menu as a whole. Entering?n, where n is one of the numbers from the current menu, will display help about that particular menu item. Menu items are selected by entering their number or a unique prefix of one of the names in the second column. To administer the progress license key the user has to edit the license file. The data management center menu provides a function that will display the current features. If you are not sure if a feature exists, use the show license file function to check the existing set of features. To activate the menu subsystem, login as user dci, password System6. System6 is not echoed and the administration menu is displayed. Select 5 License from the administration menu to display or change software license information. Selecting this item produces the license administration menu. Selecting 4 EditLicenseFile from the license administration menu allows you to modify the license file for this host. If there is no license file, one will be created. Build the Progress/System Six Interface A number of functions have been developed by ABB which provide access to DCI System Six global data using the Progress 4-4 WFPEEUI220005C0
Build the Progress/System Six Interface 4GL CALL statement. This section describes the procedure for adding these functions to Progress. The Progress/System Six interface is documented in the 40AP6400 Programmer s Manual. Procedure files (Progress.p files) and data definition files (.df files) are located in the /FandP/calc/src/progress directory. Online manual pages may be accessed by typing: man command-name man 4GL-function-name General Notes These instructions assume that Progress has been installed in /usr/dlc, the default location. Refer to Prerequisites. For a complete description of the probuild and wprbuild (Motif version of probuild) procedure, refer to the Progress System Administration Guide. UNIX environment variables and how to start Progress are discussed in Progress System Administration Guide. Procedure - Building Progress Interface - Motif The Motif version allows the DCI System Six functions to be called within the Trigger Code of a Progress User Interface Widget. A sample build is contained in the next section. The DCI System Six interface requires running prointf.r as the first step in a Progress procedure. prointf.r may also be run as a stand-alone procedure under the procedure editor. wprointf.r, supplied with the release in the /FandP/calc/src/ progress directory, must be copied to prointf.r in the directory from which Progress is being run. For example: cp wprointf.r /usr/dlc/bin/prointf.r The correct version, as required by the character-mode or Motif interface which is being used, should be copied to prointf.r in the directory from which Progress is being run. WFPEEUI220005C0 4-5
Build the Progress/System Six Interface Sample Build - Motif (Initially, the character-mode version is also supplied with the release as prointf.r.) This section contains a sample build for creating the Progress/ System Six interface (Motif). 1. Use an X-terminal to enter the following commands: cd /usr/dlc /bin/sh PROLOAD= /usr/dlc/probuild export PROLOAD PROTERMCAP= /usr/dlc/protermcap export PROTERMCAP XPMLIB= $PROLOAD/4gl/libXpm.a export XPMLIB X11LIB= /usr/lib/libxt.so /usr/lib/libxext.so /usr/lib/ libx11.so export X11LIB CC= cc export CC. /usr/dlc/probuild/eucapp/buildenv /usr/dlc/probuild/eucapp/wprbuild 2. Copy /FandP/calc/src/progress/prointf.p to your current directory. 3. Execute the following Progress 4GL statement to compile the prointf.p procedure (needed for Progress Versions later than 7.2): COMPILE prointf.p SAVE 4-6 WFPEEUI220005C0
Build the Progress/System Six Interface Alternatively, the Progress ADE could be used to run the procedure editor and select Tools/Application Compiler. Then, set Files to prointf.p and click Start Compile. 4. Enter /usr/dlc in the Install Link Script Into field. 5. Select Continue. 6. Select Progress CLIENT from the product list. 7. Select Continue. 8. Enter /usr/dlc/ldpro in the Link Script Name field. 9. Enter _progres in the Executable Name field. 10. Select Continue. 11. Select the /OSF MOTIF and /HLC application configurable elements. 12. Select Continue. 13. Enter /FandP/lib/prointf.o, /FandP/lib/libnwk.so, and /usr/lib/ libc.so as object files for the HLC application. 14. Select Return and Exit when the main product list screen appears. 15. Enter ldpro at the # prompt. 16. Enter CTRL-D at the # prompt. 17. Enter mv _progres bin/_promtf at the # prompt. At this point you have created a Motif version of Progress which includes the DCI System Six interface. The first three commands listed below are required to be executed each time the user runs Progress. setenv DLC /usr/dlc set path=($path /usr/dlc/bin) proade -yy 1970 cd /FandP/calc/src/progress WFPEEUI220005C0 4-7
WFPEEUI220005C0