RuleWorks (tm)_______________________________________ Installation Guide for Version 2.0 October 20, 1995 This document describes how to install RuleWorks (tm) V2.0. ________________________________________________________________ Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Aspects of the software described in this document are covered under U.S. Patents 5,263,127, 5,267,349 and 5,303,332; other patents pending. © Digital Equipment Corporation 1993, 1994. 1995 All Rights Reserved. The following are trademarks of Digital Equipment Corporation: Alpha AXP, AXP, CDD, DEC, DECnet, DEC OPS5, DEC OSF/1, Digital UNIX , DECwindows, OpenVMS, RA, Rdb/VMS, RuleWorks, ULTRIX, VAX, VMS, and the Digital logo. Motif and OSF/1 are registered trademarks of Open Software Foundation, Inc. Microsoft, MS, and MS-DOS are registered trademarks, and Windows and Windows NT are trademarks of Microsoft Corporation. WATCOM is a trademark of WATCOM Systems, Inc. Borland is a trademark of Borland International, Inc. PostScript is a registered trademark of Adobe Systems, Inc. UNIX is a registered trademark of UNIX System Laboratories, Inc. Printed in U.S.A. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents 1 Installation and Prerequisites 1.1 Intel 386/486/Pentium with MS-DOS, Windows, or Windows NT.................................... 1-1 1.2 OpenVMS AXP or OpenVMS VAX.................... 1-3 1.3 Digital UNIX (AXP) or ULTRIX (RISC)........... 1-5 1.4 Windows-NT (AXP).............................. 1-6 1.5 Cross Platform development.................... 1-7 2 How To Reach Us IF You Encounter Installation Problems.......2-1 iii Installation and Prerequisites Choose the appropriate installation instructions below based upon your hardware and operating system. ________________________ Note ________________________ For your convenience, installation instructions are reproduced in our Release Notes which are part of your Developer Kit. ______________________________________________________ 1.1 Intel 386/486/Pentium with MS-DOS, Windows, or Windows NT Prerequisites: o Microsoft Windows 3.1 or higher or Microsoft Windows NT 3.1 or higher o WATCOM C32 for DOS 9.5 or higher or WATCOM C/C++32 9.5 or higher or Microsoft Win32 SDK for Windows-NT or Microsoft Visual C++ 32-Bit Edition or Microsoft Visual C++ 2.0 or Borland C++ 4.0 or higher ________________________ Note ________________________ The Microsoft and Borland products are all commonly available through software distributors. The WATCOM products are available through many of the distributors, but if you can't find it anywhere else: WATCOM 415 Phillip Street Waterloo, Ontario, Canada N2L 3X2 (519) 886-3700 ______________________________________________________ Kit Format: CDROM Installation and Prerequisites 1-1 Files Included:____________________________________________ Filename Description__________________________ rulework.exe RuleWorks (tm) compiler for MS-DOS rul_nt.exe RuleWorks (tm) compiler for Windows NT rul_rtlw.lib RuleWorks (tm) run-time library (Watcom 32-Bit for DOS or Win32) rul_rtlm.lib RuleWorks (tm) run-time library (Microsoft 32-Bit for Win32) rul_rtlb.lib RuleWorks (tm) run-time library (Borland 32-Bit for Win32) rul_gend.h C header file used by generated code rul_rtl.h C header file of API functions relnotes.txt this document, text relnotes.ps this document, PostScript dos4gw.exe Rational's 32-bit DOS Extender, needed to run the compiler on MS-DOS. rulework.hlp Windows help file containing reference information for language constructs. + example files____________________________________________ Installation Instructions:_________________________________ StepAction_________________________________________________ 1. Verify that the disk onto which you're installing RuleWorks (tm) has at least 3MB free. 2. Type the contents of the file, README.TXT, and follow the directions described there. 3. Add the RuleWorks (tm) directory to your PATH environment variable in your AUTOEXEC.BAT. 4. If you use MS-DOS, you may want to set the environment variable DOS4G=quiet in your AUTOEXEC.BAT file to eliminate the DOS extender's copyright notice. 5. If you are using only Windows NT, you may want to delete RULEWORK.EXE and DOS4GW.EXE, and rename RUL_NT.EXE to RULEWORK.EXE. 1-2 Installation and Prerequisites 1.2 OpenVMS AXP or OpenVMS VAX Prerequisites: o OpenVMS AXP V6.1 or greater or OpenVMS VAX V5.5-2 or greater o DEC C V4.0 or greater or VAX C V3.2 o Note: If you are running a version of OpenVMS VAX earlier than 6.1, you need the DEC C/C++ Run Time Components kit. This kit is available as AACRT060. Please contact us (see Section 2.5) if you require assistance. Kit Format: VMSINSTAL kit Files Included:____________________________________________ Filename Description__________________________ rulework.exe RuleWorks (tm) compiler rula_rtl.olb RuleWorks (tm) run-time library for AXP rulv_rtl.olb RuleWorks (tm) run-time library for VAX (see Section 2.5) rul_gend.h C header file used by generated code rul_rtl.h C header file of API functions rul_rtl.for API header file for FORTRAN rul_rtl.pas API header file for Pascal relnotes.txt this document, text rulnotes.ps this document, PostScript + example files____________________________________________ Installation Instructions:_________________________________ StepAction_________________________________________________ 1. Log in as SYSTEM or into an account with privileges. Installation and Prerequisites 1-3 ___________________________________________________________ StepAction_________________________________________________ 2. Use VMSINSTAL. It asks what disk and directory you want the compiler and libraries installed, and whether you want the examples. VMSINSTAL will then ask a few questions and control the installation process. For OpenVMS AXP, the name of the product to install is RULAXP020. For OpenVMS VAX, the name of the product to install is RUL020. If you have RDB installed it asks whether you want the built-in SQL interface. 3. Add to your SYSTARTUP_V5.COM or SYSTARTUP_VMS.COM: _______$ @SYS$STARTUP:RUL$STARTUP.COM______________________ Use this command to start the RuleWorks (tm) installation on OpenVMS: $ @SYS$UPDATE:VMSINSTAL 1-4 Installation and Prerequisites 1.3 Digital UNIX or ULTRIX RISC Prerequisites: o Digital UNIX (AXP) V1.2 or higher or ULTRIX (RISC) V4.4 or higher o DEC C V1.2 or greater Kit Format: setld format. Files Included:____________________________________________ Filename Description__________________________ rulework RuleWorks (tm) compiler librulrtl.a RuleWorks (tm) run-time library ULTRIX/RISC librulrtl.a RuleWorks (tm) run-time library UNIX/AXP (see Section 2.5) rul_gend.h C header file used by generated code rul_rtl.h C header file of API functions relnotes.txt this document, text relnotes.ps this document, PostScript rulework.1 man(1) page for RuleWorks (tm) + example files____________________________________________ Installation Instructions:_________________________________ StepAction_________________________________________________ 1. Log in as root (or superuser). 2. Load the RuleWorks (tm) distribution tape. 3. Run: _______# setld -l__________________________________________ Installation and Prerequisites 1-5 1.4 Windows-NT (AXP) Prerequisites: o Windows-NT 3.1 or higher o CLAXP compiler 8.0 or higher. Kit Format: Windows installation disk. Files Included:____________________________________________ Filename Description__________________________ rulework.exe RuleWorks (tm) compiler rul_rtl.lib RuleWorks (tm) run-time library (See Section 2.5) rul_gend.h C header file used by generated code rul_rtl.h C header file of API functions relnotes.txt this document, text relnotes.ps this document, PostScript rulework.hlp Windows help file containing reference information for language constructs. + example files____________________________________________ Installation Instructions:_________________________________ StepAction_________________________________________________ 1. Start Windows NT and log in. 2. Open the Program Manager window, if necessary, and then choose Run from the File menu. 3. In the command line box, type: A:\SETUP where A: is the drive that contains the RuleWorks (tm) diskette. 4. Answer questions as directed by SETUP. 5. Add the RuleWorks (tm) directory to your PATH environment ____variable using the System icon in the Control Panel.___ Installation and Prerequisites 1-6 1-5 Installation - cross platform Your RuleWorks (tm) V2.0 kits include a set of run-time libraries; one for each of the previously mentioned, supported libraries. Hence the capability of developing on one platform to the point of having produced C source followed by transport of that source to the target user platform(s) with subsequent compilation and link with the appropriate run-time library is provided. Follow the directions of your chosen, supported C compiler to assure proper linkage with our library. The libraries supplied and the supported compilers are listed below. Library Filename Supported Compiler ============================================================= rulv_rtl.olb OpenVMS/VAX DEC C rula_rtl.olb OpenVMS/AXP DEC C rul_rtlb.lib Windows/Borland C rul_rltw.lib Windows/Watcom C rul_rtlm.lib Windows/Microsoft 32bit C rulanrtl.lib Windows NT/AXP C rwosfrtl.a Digital UNIX/AXP DEC C rwutxrtl.a ULTRIX/RISC DEC C Please note that there are some differences in library filenames between this collected group of library files and those that automatically install with the compiler kit. We have provided this duplication to ease distinction between the cross-platform approach to application development and the single platform system. The libraries(not the filenames) are identical, to those in the developer kit, on a given platform. Installation and Prerequisites 1-7 2 How to Reach Us If you encounter problems installing this software, please contact us. Internet mail: ruleworks@digital.com WWW page: http://www.digital.com/info/si/ruleworks FAX: 508-952-4197 Mail: RuleWorks (tm) Support Digital Equipment Corp. 151 Taylor Street TAY1-1 Littleton, MA 01460 ATTN: Product Manager L. Pelavin Installation and Prerequisites 2-1