Digital Application Generator V3.0 VB Development for Windows[TM] ____________________________________________________ TP Server Installation Guide Order Number: AA-QZVUA-TE August 1996 This manual describes the Digital Application Generator V3.0 TP Server installation procedures. Revision/Update Information: This is a new document. Operating System and Version: OpenVMS VAX Version 5.5-2 or higher OpenVMS Alpha Version 1.5 or higher Microsoft Windows NT Version 3.51 Software Version: Digital Application Generator Version 3.0 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ August 1996 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. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. Licensed to Digital Equipment Corporation, Maynard, Massachusetts, Copyright © Mirus Data AB, Sweden, 1994-1996. All Rights Reserved. Printed in U.S.A. The following are trademarks of Digital Equipment Corporation: ACMS, ACMS Desktop, DEC, DECADMIRE, Digital, OpenVMS, VAX, VAX COBOL, VAX DOCUMENT, VAX RMS, VMS, VT, and the DIGITAL logo. Microsoft, Microsoft Access, MS, MS-DOS, Visual Basic, and Windows 95 are registered trademarks of Microsoft Corporation. Windows and Windows NT are trademarks of Microsoft Corporation. ORACLE and Oracle Rdb are registered trademarks of Oracle Corporation. ORACLE7 and Oracle CDD/Repository are trademarks of Oracle Corporation. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... vii Part I OpenVMS Installation of Application Generator TP Server 1 Preparing to Install Application Generator TP Server on OpenVMS 1.1 Required Operating System Components.......... 1-1 1.2 Software Requirements......................... 1-1 1.2.1 Operating System Software Requirements.... 1-2 1.3 OpenVMS License Management Facility........... 1-3 1.4 Installation Procedure Requirements........... 1-3 1.4.1 Time...................................... 1-3 1.4.2 Privileges................................ 1-4 1.4.3 Disk Space................................ 1-4 1.4.4 System Parameters......................... 1-5 1.4.4.1 Checking System Parameter Values........ 1-5 1.4.4.2 Calculating the Values for GBLPAGES and GBLSECTIONS............................. 1-6 1.4.4.3 Changing System Parameter Values ....... 1-7 1.4.5 Account Process Quotas.................... 1-7 1.4.6 VMSINSTAL Requirements.................... 1-9 1.4.7 Backing Up Your System Disk............... 1-9 iii 2 Installing Application Generator TP Server on OpenVMS 2.1 Notice About Upgrading........................ 2-1 2.2 Aborting the Installation..................... 2-1 2.3 Installation Procedure........................ 2-1 2.3.1 Invoking VMSINSTAL........................ 2-2 2.3.2 Installation Questions.................... 2-2 2.3.3 Informational Messages.................... 2-5 2.3.4 Completing the Installation Procedure..... 2-5 2.4 Recovering from System and Installation Failures...................................... 2-6 2.4.1 System Failures........................... 2-6 2.4.2 Application Generator Installation Failures.................................. 2-7 2.5 Accessing Online Release Notes................ 2-7 2.6 Files Installed on Your System................ 2-8 3 After Installing Application Generator TP Server on OpenVMS 3.1 Moving the Executable to the Client........... 3-1 3.2 Setting Up to Run and Starting Application Generator..................................... 3-2 Part II Windows NT Installation of Application Generator TP Server 4 Installing Application Generator TP Server on Windows NT 4.1 Preparing to Install Application Generator TP Server........................................ 4-1 4.2 Installing Application Generator TP Server.... 4-1 4.3 After Installing Application Generator TP Server........................................ 4-2 4.3.1 Moving the Executable to the Client....... 4-2 4.3.2 Setting Up to Run and Starting Application Generator................................. 4-3 iv A Sample Installations A.1 Application Generator TP Server Sample Installation.................................. A-1 B Application Generator TP Server Directories and Files B.1 Application Generator TP Server Directory Structure on OpenVMS.......................... B-1 B.2 Application Generator TP Server Directory Structure on Windows NT....................... B-2 Index Examples A-1 Application Generator OpenVMS Alpha Sample Installation Log.......................... A-1 Tables 1-1 Minimum OpenVMS Software Requirements..... 1-2 1-2 Disk Space Requirements................... 1-4 1-3 Required System Parameter Values.......... 1-5 1-4 Required Minimum Process Quotas........... 1-8 B-1 COMMON Subdirectory on OpenVMS............ B-2 B-2 CLIENT Subdirectory on OpenVMS............ B-2 B-3 COMMON Subdirectory on Windows NT......... B-3 B-4 CLIENT Subdirectory on Windows NT......... B-3 v _________________________________________________________________ Preface This installation guide describes how to install the following Digital Application Generator (Application Generator) software kits: o Digital Application Generator V3.0 TP Server for ACMS OpenVMS (VAX and Alpha) Kit o Digital Application Generator V3.0 TP Server for ACMSxp OpenVMS Alpha Kit o Digital Application Generator V3.0 TP Server for ACMSxp Microsoft Windows NT Kit Intended Audience Read this manual if you are responsible for installing and maintaining Application Generator software. To perform the installation procedures described in this manual, you must: o Have access to a privileged OpenVMS system manager's account and be familiar with the OpenVMS installation procedure, VMSINSTAL, if you intend to install the Application Generator ACMS OpenVMS VAX or the ACMSxp OpenVMS Alpha kit. o Have access to a PC running Microsoft Windows NT if you intend to install the Application Generator ACMSxp Windows NT kit. vii Operating System Information For Application Generator Version 3.0 TP Server you must be running: o OpenVMS VAX Version 5.5-2 or higher if you intend to install the ACMS OpenVMS kit on a VAX system. o OpenVMS Alpha Version 1.5 or higher if you intend to install the ACMS OpenVMS kit on an Alpha system. o OpenVMS Alpha Version 6.2 if you intend to install the ACMSxp OpenVMS Alpha kit. o Windows NT Version 3.51 if you intend to install the ACMSxp Windows NT kit. For information on the relationship of other software products with this version of Application Generator, refer to the Software Product Description (SPD). Use the SPD to verify which versions of your operating system are compatible with this version of Application Generator. Structure of This Manual This manual has the following structure: ___________________________________________________________ OpenVMS Installation of Application Generator Part I TP Server ___________________________________________________________ Chapter 1 Explains how to prepare your OpenVMS system for installing Application Generator TP Server OpenVMS kits. Chapter 2 Describes how to install the Application Generator TP Server OpenVMS software. It also tells you how to recover from system and installation failures. Chapter 3 Provides postinstallation information to prepare for running Application Generator. viii ___________________________________________________________ Windows NT Installation of Application Part II Generator TP Server ___________________________________________________________ Chapter 4 Explains how to prepare your Microsoft Windows NT system for installing the Application Generator TP Server Windows NT kit and describes how to install the kit. It also provides postinstallation information to prepare for running Application Generator. ___________________________________________________________ Appendixes ___________________________________________________________ Appendix A Contains a log of a sample installation for Application Generator TP Server OpenVMS kits. Appendix B Contains a listing of the directory structure and files installed with Application Generator TP Server. ___________________________________________________________ ix Conventions This document uses the following conventions: _________________________________________________________________ Convention Description _________________________________________________________________ boldface type Boldface type in examples indicates user input or highlights important information. Boldface type in text highlights new terms defined in the text. color In examples in hardcopy documents, text in color indicates user input. Ctrl/x Ctrl/x indicates that you hold down the Ctrl key while you press another key or mouse button (indicated here by x). italic type Italic type in text emphasizes important information, indicates variables, and indicates complete titles of manuals. lowercase text In format descriptions, words in lowercase text indicate parameters or arguments to be specified by the user. UPPERCASE TEXT Words in uppercase text indicate a command, a parameter, a routine, the name of a file, the name of a file protection code, or an abbreviation for a system privilege. . Vertical ellipsis points indicate the . omission of information from an example or . command format. The information is omitted because it is not important to the topic being_discussed. _________________________________________________________________ x Part I _________________________________________________________________ OpenVMS Installation of Application Generator TP Server Part I explains how to prepare your OpenVMS system for installing the Application Generator TP Server for ACMS OpenVMS (VAX and Alpha) and ACMSxp OpenVMS Alpha kits and describes how to install them. Part I also provides postinstallation information to prepare for running Application Generator. 1 _________________________________________________________________ Preparing to Install Application Generator TP Server on OpenVMS This chapter discusses the preparations and requirements for installing Digital Application Generator Version 3.0 TP Server software on OpenVMS systems. The Application Generator TP Server OpenVMS software contains two kits, the ACMS OpenVMS VAX and OpenVMS Alpha kit and the ACMSxp OpenVMS Alpha kit. To install the kits, be sure you have the appropriate licence PAK. Application Generator TP Server provides online release notes and gives you the option of printing or displaying the release notes during the installation procedure. Digital strongly recommends that you read the release notes before proceeding with the installation, as they can contain information that is important for the installation procedure. 1.1 Required Operating System Components To install Application Generator, you must have one of the following operating systems installed: o OpenVMS Version 5.5-2 or higher if you are using ACMS on a VAX system o OpenVMS Alpha Version 1.5 or higher if you are using ACMS on an Alpha system o OpenVMS Alpha Version 6.2 if you are using ACMSxp 1.2 Software Requirements Before installing Application Generator, make sure that the correct layered products are installed for your operating system and development environment. Preparing to Install Application Generator TP Server on OpenVMS 1-1 1.2.1 Operating System Software Requirements Table 1-1 lists the software products and minimum versions that are compatible with Application Generator Version 3.0 TP Server on both OpenVMS VAX and OpenVMS Alpha. Table 1-1 Minimum OpenVMS Software Requirements ___________________________________________________________ OpenVMS OpenVMS VAX Alpha Product Version Version Description ___________________________________________________________ Oracle Rdb 6.0 6.0 Basic server software Oracle 5.3 5.3 If you intend to CDD/Repository store definitions in CDD/Repository and use ACMS ACMS 4.0 4.1 If you intend to use ACMS ACMSxp 2.0 If you intend to use ACMSxp VAX COBOL 4.3 If you intend to use COBOL DEC COBOL 1.1 If you intend to use COBOL DEC C 5.0 Prerequisite for ACMSxp DCE 1.3 Prerequisite for ACMSxp DEC TCP/IP 3.2 Prerequisite for ACMSxp Services for OpenVMS DEC Module 2.7 Prerequisite for Management ACMSxp; needed for System IVP and AVERTZ sample application RMS Prerequisite for ACMSxp Journaling License ___________________________________________________________ For a complete list of the products that are compatible with this version of Application Generator, see the Software Product Description. 1-2 Preparing to Install Application Generator TP Server on OpenVMS 1.3 OpenVMS License Management Facility The OpenVMS License Management Facility (LMF) is available with the OpenVMS operating system. In order to install Application Generator on an OpenVMS system, you must register and load your software license. The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with Application Generator. The PAK is a paper certificate that contains information about the license required to run a particular piece of software. You must register and load your Application Generator license before you perform the installation. During the installation, you are asked if you have registered the Application Generator license and loaded the appropriate authorization key. You cannot install the Application Generator software unless you do this first. To register a license, perform the following steps: 1. Log in to the system manager's account, SYSTEM. 2. Choose one of the following ways to perform the registration: o Run the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your PAK. o Issue the LICENSE REGISTER and LICENSE LOAD commands with the appropriate qualifiers that correspond to information on the PAK. For complete information on using LMF, see OpenVMS License Management Utility Manual in the OpenVMS documentation set. 1.4 Installation Procedure Requirements The following sections discuss requirements for installing Application Generator. 1.4.1 Time Installing Application Generator requires between one and two minutes after you answer the questions asked during VMSINSTAL, depending on the type of CPU and the distribution medium you are using. Preparing to Install Application Generator TP Server on OpenVMS 1-3 1.4.2 Privileges To install Application Generator, you must be logged in to the SYSTEM account, or an account that has SETPRV or the following privileges: o CMKRNL o WORLD o SYSPRV Be aware that VMSINSTAL turns off BYPASS privilege at the start of the installation. 1.4.3 Disk Space Installing Application Generator requires a certain amount of free storage space during the installation. Table 1-2 summarizes the storage requirements for Application Generator during and after installation. Table 1-2 Disk Space Requirements _________________________________________________________________ OpenVMS VAX OpenVMS Alpha _________________________ _________________________ Application Generator Blocks Blocks Blocks Blocks Installation During After During After Kit Installation Installation Installation Installation _________________________________________________________________ TP Server 20,000 20,000 10,000 10,000 _________________________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE . . . $ Under the column titled Free Blocks find the number of available disk blocks. 1-4 Preparing to Install Application Generator TP Server on OpenVMS 1.4.4 System Parameters Table 1-3 lists the required system parameter values for Application Generator installation. Table 1-3 Required System Parameter Values ___________________________________________________________ System Value on Value on Parameter OpenVMS VAX OpenVMS Alpha ___________________________________________________________ GBLPAGES[1] n + 750 n + 750 GBLSECTIONS[1] n + 10 n + 10 VIRTUALPAGECNT 40,000 40,000 ___________________________________________________________ [1]The n shown in Table 1-3 represents the system parameter values that are currently in use. To install Application Generator, the allocated system parameter value must be less than the sum of n plus the number indicated. The numbers indicated represent the unused portion of these parameters. ___________________________________________________________ The following sections show how to check system parameter values, calculate values for the GBLPAGES and GBLSECTIONS system parameters, and change parameter values with the OpenVMS AUTOGEN command procedure. 1.4.4.1 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke SYSGEN: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of each system parameter. Make sure that the values displayed equal or exceed the value of each parameter listed in Table 1-3. The following command displays the value for the VIRTUALPAGECNT system parameter: SYSGEN> SHOW VIRTUALPAGECNT After you finish checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. Preparing to Install Application Generator TP Server on OpenVMS 1-5 1.4.4.2 Calculating the Values for GBLPAGES and GBLSECTIONS To install and run Application Generator, you must set the correct values for the GBLPAGES and GBLSECTIONS system parameters. The values for GBLPAGES and GBLSECTIONS in Table 1-3 (excluding the value of n) indicate the number of unused pages or sections you must have available on your system for the installation to process successfully. To calculate whether your system has a sufficient number of unused global pages and global sections, perform the following steps: 1. Send output to the terminal from the F$GETSYI lexical function using the following DCL commands: $ WRITE SYS$OUTPUT F$GETSYI ("FREE_GBLPAGES") 520 $ WRITE SYS$OUTPUT F$GETSYI ("FREE_GBLSECTS") 50 2. Determine if the number of unused pages (520 in the example) is equal to or greater than the number specified in Table 1-3. If the number of unused pages is less than the number listed in the table, you need to increase the allocation value for GBLPAGES. (In this example, it is necessary to increase the number of GBLPAGES allocated, because the 750 indicated in Table 1-3 exceeds the number available.) 3. Determine if the number of unused global sections (50 in the example) is equal to or greater than the number specified in Table 1-3. If the value is less than the number required in Table 1-3, you need to increase the allocation value of the GBLSECTIONS parameter. (In this example, it is not necessary to increase the number of GBLSECTIONS allocated, because the number of unused global sections, 50, exceeds the 10 indicated in Table 1-3.) Section 1.4.4.3 describes the procedures for increasing these values as well as those of other system parameters. Refer to the OpenVMS documentation on system management and operations for more information. 1-6 Preparing to Install Application Generator TP Server on OpenVMS 1.4.4.3 Changing System Parameter Values Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the ones you reset manually. To change system parameters with AUTOGEN, perform the following steps: 1. Edit the following file: SYS$SYSTEM:MODPARAMS.DAT 2. Add a line to the file with the parameter and the new value. For example, to change the setting for the VIRTUALPAGECNT system parameter, add this line to the file: VIRTUALPAGECNT = 40000 3. Run the AUTOGEN procedure to recalculate your system parameters. Enter the following command at the DCL prompt: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT . . . $ AUTOGEN performs an automatic system shutdown and reboots when it has finished. Rebooting your system makes the new parameter values active. For more information about using AUTOGEN, see the instructions on modifying system parameters in the OpenVMS documentation on system management and operations. 1.4.5 Account Process Quotas The account you use to install DECADMIRE must have sufficient quotas to enable you to perform the installation. Table 1-4 summarizes the process quotas required to perform the installation. Preparing to Install Application Generator TP Server on OpenVMS 1-7 Table 1-4 Required Minimum Process Quotas ___________________________________________________________ Value on Value on Qualifier OpenVMS VAX OpenVMS Alpha ___________________________________________________________ BYTLM 16,384 64,000 ENQLM 1,000 2,000 FILLM 100 100 PGFLQUO 30,000 30,000 ___________________________________________________________ User account quotas are stored in the file SYSUAF.DAT. Use the OpenVMS Authorize Utility (AUTHORIZE) to verify and change the account quotas: 1. Set your directory to SYS$SYSTEM and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 2. At the AUTHORIZE prompt (UAF>), enter the SHOW command with an account name to check a particular account. For example: UAF> SHOW SYSTEM . . . UAF> 3. To change a quota, enter a command with the following format at the UAF> prompt: MODIFY account-name/quota-name=nnnn For example, to change the FILLM quota for the SYSTEM account and exit from the Authorize Utility, do this: UAF> MODIFY SYSTEM/FILLM=100 UAF> EXIT $ After you exit from the utility, the OpenVMS system displays messages indicating whether or not changes were made. If the changes are made, you must log out and log in again for the new quotas to take effect. 1-8 Preparing to Install Application Generator TP Server on OpenVMS 1.4.6 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks that the following requirements have been met: o You are logged in to a privileged account. o You have adequate quotas for installation. o DECnet is up and running. o No users are logged in to the system. If VMSINSTAL detects any problems during the installation, it notifies you of the problem and asks if you want to continue the installation. In some instances, you can answer YES to continue. To stop the installation process and correct the situation, answer NO or press Return. 1.4.7 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that have been established at your site to do this backup. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS documentation set. Preparing to Install Application Generator TP Server on OpenVMS 1-9 2 _________________________________________________________________ Installing Application Generator TP Server on OpenVMS This chapter describes how to install Application Generator software. Section 2.3 contains a step-by-step description of the installation procedure. 2.1 Notice About Upgrading Digital Application Generator, Version 3.0 features new application development and deployment environments. You cannot upgrade a version of DECADMIRE to Digital Application Generator, Version 3.0. 2.2 Aborting the Installation To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation deletes all files it has created and exits. You can start the installation again. 2.3 Installation Procedure The Application Generator installation procedure consists of a series of questions and informational messages. The following sections explain how to invoke the VMSINSTAL procedure and answer the installation questions. These sections also explain the informational messages displayed by the procedure. ________________________ Note ________________________ This chapter shows output from an installation on an OpenVMS Alpha system. For an OpenVMS VAX installation, the messages displayed vary slightly (for example, the number of blocks required), but installations on the two operating systems are otherwise equivalent. ______________________________________________________ Installing Application Generator TP Server on OpenVMS 2-1 2.3.1 Invoking VMSINSTAL To start the installation, log in to the SYSTEM account or a privileged account, and set the default directory to SYS$UPDATE: $ SET DEFAULT SYS$UPDATE Next, invoke VMSINSTAL using the following syntax: @VMSINSTAL product-name device-name OPTIONS N where product-name is the installation name for the component. For Application Generator Version 3.0, the product name is DAGN030. device-name is the name of the device on which you plan to mount the media. For example, MKA500: is the device name for a tape drive. OPTIONS N is an optional parameter indicating that you want to be prompted to display or print the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not prompt you to display or print the release notes. The following command invokes VMSINSTAL to install Application Generator from the tape drive MKA500:. This example uses the OPTIONS N parameter for printing or displaying release notes: $ @VMSINSTAL DAGN030 MKA500: OPTIONS N OpenVMS AXP Software Product Installation Procedure V6.2 It is 12-JUL-1996 at 19:38. Enter a question mark (?) at any time for help. If you do not supply the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. 2.3.2 Installation Questions This section discusses the questions that appear during the installation. See Appendix A for a log of a sample installation. 2-2 Installing Application Generator TP Server on OpenVMS Each question in the installation is marked with an asterisk (*) at the beginning of the line. Some questions show the default response in brackets, for example [YES]. To choose the default response, press Return. 1. System backup VMSINSTAL asks whether or not you are satisfied with your system backup. * Are you satisfied with the backup of your system disk [YES]? Always back up your system disk before installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, answer NO to discontinue the installation. After you back up your system disk, you can restart the installation. 2. Mounting the media Mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL asks you if you are ready to continue with the installation. Respond YES to indicate that you are ready. VMSINSTAL displays a message that the media containing Application Generator has been mounted on the specified device and that the installation has begun. For example: Please mount the first volume of the set on MKA500: * Are you ready? YES %MOUNT-I-MOUNTED, DAGN mounted on _$MTA0: The following products will be processed: DAGN V3.0 Beginning installation of DAGN V3.0 at 09:38 %VMSINSTAL-I-RESTORE, Restoring product save set A... Installing Application Generator TP Server on OpenVMS 2-3 If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, answer NO in response to the question, "Are you ready?" To abort the installation for other reasons, press Ctrl/Y. 3. License registration If you have not registered and loaded the Application Generator Product Authorization Keys (PAKs), answer NO. Application Generator PAKs must be registered and loaded before installation. Have you registered and loaded the DAGN TP-SERVER PAK [YES]? 4. Choosing to purge files You can purge files from previous versions of Application Generator that this installation supersedes. Purging is recommended; however, if you need to keep files from the previous version, answer NO in response to the following question: * Do you want to purge files replaced by this installation [YES]? 5. Installing the TP Server kits The procedure asks whether you want to install the transaction processing (TP) monitor server kits: o ACMSXP-server kit o ACMS-server kit The ACMSXP-server kit contains the Application Generator software that includes ACMSxp as the TP monitor. The ACMS-server kit contains the Application Generator software that includes ACMS as the TP monitor. Answer YES for a kit that you want to install. * Do you wish to install the ACMSXP-server kit (10000 blocks) [YES]? * Do you wish to install the ACMS-server kit (10000 blocks) [YES]? 6. Choosing to run the IVP The installation procedure asks whether you want to run the Installation Verification Procedure (IVP). The IVP checks that the Application Generator software is installed correctly. It is recommended that you run the IVP. 2-4 Installing Application Generator TP Server on OpenVMS * Do you want to run the IVP after the installation [YES]? Answer YES if you want to run the IVP after installing Application Generator. Answer NO if you do not want to run the IVP. If you choose not to run the IVP during the installation, you can run it independently after installing Application Generator. 2.3.3 Informational Messages The installation procedure displays a number of informational messages that report on the progress of the installation (see Appendix A). There are no further questions. If a test or operation fails, you receive a message describing the failure. In most cases, you must reinstall Application Generator after correcting the problem described. If the installation is successful, VMSINSTAL moves the new or modified files to their target directories, updates help files, and purges appropriate files. 2.3.4 Completing the Installation Procedure The following messages indicate that the installation is complete: Installation of DAGN V3.0 completed at 09:39 VMSINSTAL procedure done at 09:39 Log out of the privileged account as follows: $ LOGOUT SYSTEM logged out at 12-JUL-1996 09:39:36.89 Note that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, continue to use the system manager's account. To restore these symbols, log out and log in again. Installing Application Generator TP Server on OpenVMS 2-5 2.4 Recovering from System and Installation Failures An unsuccessful installation can result from a system failure or from errors encountered during the installation procedure. In some cases, you must correct the problem and reinstall Application Generator. In other cases, you may be required merely to continue where you left off. The following sections describe various failure scenarios and the recommended procedure to follow to recover from them. 2.4.1 System Failures If you experience a system failure, such as a power loss during installation, VMSINSTAL automatically attempts to continue the installation when you reboot the system. Depending on the point in the installation at which the system failed, one of three conditions exists: o The system disk did not undergo any changes before the system failure. VMSINSTAL instructs you to restart the installation. o The system disk used by the installation was corrupted. VMSINSTAL instructs you to restore the system disk from the backup copy and restart the installation. o VMSINSTAL continues the installation. VMSINSTAL then might tell you to manually purge replaced files, even if you requested that they be purged automatically. You can purge files, but remember that purging deletes all but the latest version of all files on your system disk. If you have multiple versions of system files that you want to save, you can delete just the Application Generator files you want to remove from system directories. If you want to purge files, reboot the system, log in to the system account, and purge all system files using the following command: $ PURGE/LOG SYS$SYSROOT:[*...]*.* When you have performed this task, the installation is complete. 2-6 Installing Application Generator TP Server on OpenVMS 2.4.2 Application Generator Installation Failures If the installation of the Application Generator software fails for some reason other than a system failure, the installation procedure displays a message telling you the cause of the failure. To continue with the installation, you must correct the condition causing the error and restart the installation procedure from the beginning. Errors can occur during the installation if any of the following conditions exist: o Operating system version is incorrect. o Prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installations. If you are notified that any of these conditions exist, take the appropriate action as described in the message. (For example, you might need to change a system parameter or increase a quota value.) For information on installation requirements, see Section 1.4. In most cases, the suggested course of action is to reinstall Application Generator. The failure could be due to low settings for the SYSGEN parameters GBLPAGES, GBLSECTIONS, GBLPAGFIL, or to an insufficient number of process slots. Check the Software Event Log for a message that indicates the source of the problem. 2.5 Accessing Online Release Notes Application Generator provides online release notes. Review the release notes for any information about changes in the installation procedure. After you install Application Generator, the release notes are located in the following file: SYS$HELP:DAGN030.RELEASE_NOTES Installing Application Generator TP Server on OpenVMS 2-7 2.6 Files Installed on Your System The Application Generator installation procedure adds a number of files to your system. See Appendix B for specific information about these files. 2-8 Installing Application Generator TP Server on OpenVMS 3 _________________________________________________________________ After Installing Application Generator TP Server on OpenVMS This chapter describes required and optional tasks to perform after successfully installing your Application Generator software. 3.1 Moving the Executable to the Client The DADM_CLI.EXE file is a self-extracting executable image that you must move to the client systems where the Digital Application Generator V3.0 VB Development for Windows software is installed. Perform the following steps to move the executable: 1. Create a directory on the client's hard drive. For example, you can create the C:\TP directory. 2. Copy the DADM_CLI.EXE file to the directory you created (for example, C:\TP). 3. Execute the DADM_CLI.EXE file. The self-extracting executable will produce the GEN32.EXE file, which is the TP generator. 4. Digital suggests that you make a backup copy of the existing client GEN32.EXE that is the ODBC only generator installed by the client kit. You will need a backup copy if you want to generate application code for ODBC later after performing the next step. 5. Copy the GEN32.EXE to the VBEXE directory where the Application Generator Version 3.0 development kit is installed. For example, if the kit was installed to the C:\DADMIRE directory, copy C:\TP\GEN32.EXE to C:\DADMIRE\V30\VBEXE. Copying the executable will replace the GEN32.EXE file that is the ODBC only generator installed by the client kit. After Installing Application Generator TP Server on OpenVMS 3-1 3.2 Setting Up to Run and Starting Application Generator For information about setting up to run and starting the Application Generator application, see the following information components: o Digital Application Generator Release Notes o Digital Application Generator V3.0 VB Development for Windows Online Information System o Digital Application Generator V3.0 VB Development for Windows User's Guide o Digital Application Generator V3.0 VB Development for Windows Getting Started Step-by-Step 3-2 After Installing Application Generator TP Server on OpenVMS Part II _________________________________________________________________ Windows NT Installation of Application Generator TP Server Part II explains how to prepare your Microsoft Windows NT system for installing the Application Generator TP Server for ACMSxp Windows NT kit and describes how to install the kit. Part II also provides postinstallation information to prepare for running Application Generator. 4 _________________________________________________________________ Installing Application Generator TP Server on Windows NT This chapter discusses the following topics about installing Digital Application Generator V3.0 TP Server software on Microsoft Windows NT systems: o Preparing to install o Installing o After installing 4.1 Preparing to Install Application Generator TP Server Installation of Application Generator TP Server has the following requirements: o Operating system: Microsoft Windows NT 3.51 o TP Monitor: ACMSxp for Windows NT o ODBC Administrator o Available disk space: 2.02 megabytes 4.2 Installing Application Generator TP Server To install Application Generator TP Server, perform the following steps: 1. Start Microsoft Windows NT. 2. Insert disk 1 of the product media into an appropriate drive. For example, drive A. 3. From the Windows NT Program Manager, choose Run from the File menu. 4. Type A:\SETUP (using drive A, for example) and press the ENTER key. Installing Application Generator TP Server on Windows NT 4-1 5. Follow the instructions in the dialog boxes that appear. The instructions ask you to specify the following: o User name, company name, and product key (to define the license) o Directory for the installed files 4.3 After Installing Application Generator TP Server This section describes required and optional tasks to perform after successfully installing your Application Generator software. 4.3.1 Moving the Executable to the Client The DADM_CLI.EXE file is a self-extracting executable image that you must move to the client systems where the Digital Application Generator V3.0 VB Development for Windows software is installed. Perform the following steps to move the executable: 1. Create a directory on the client's hard drive. For example, you can create the C:\TP directory. 2. Copy the DADM_CLI.EXE file to the directory you created (for example, C:\TP). 3. Execute the DADM_CLI.EXE file. The self-extracting executable will produce the GEN32.EXE file, which is the TP generator. 4. Digital suggests that you make a backup copy of the existing client GEN32.EXE that is the ODBC only generator installed by the client kit. You will need a backup copy if you want to generate application code for ODBC later after performing the next step. 5. Copy the GEN32.EXE to the VBEXE directory where the Application Generator Version 3.0 development kit is installed. For example, if the kit was installed to the C:\DADMIRE directory, copy C:\TP\GEN32.EXE to C:\DADMIRE\V30\VBEXE. Copying the executable will replace the GEN32.EXE file that is the ODBC only generator installed by the client kit. 4-2 Installing Application Generator TP Server on Windows NT 4.3.2 Setting Up to Run and Starting Application Generator For information about setting up to run and starting the Application Generator application, see the following information components: o Digital Application Generator Release Notes o Digital Application Generator V3.0 VB Development for Windows Online Information System o Digital Application Generator V3.0 VB Development for Windows User's Guide o Digital Application Generator V3.0 VB Development for Windows Getting Started Step-by-Step Installing Application Generator TP Server on Windows NT 4-3 A ____________________________________________________________________ Sample Installations This appendix shows the log of a sample Application Generator TP Server installation on an OpenVMS Alpha system. A.1 Application Generator TP Server Sample Installation Example A-1 shows the log of a sample installation for the Application Generator TP Server software on an OpenVMS Alpha system. Installation on an OpenVMS VAX system is equivalent, except for the different block sizes required. Example A-1 Application Generator OpenVMS Alpha Sample Installation Log Welcome to OpenVMS AXP (TM) Operating System, Version V6.2 Username: SYSTEM Password: Welcome to OpenVMS AXP (TM) Operating System, Version V6.2 on node KAIN Last interactive login on Friday, 12-JUL-1996 09:32:11.72 Last non-interactive login on Wednesday, 9-JUL-1996 15:05:51.21 Current PROCESS DEC Rdb environment is version V6.0-0 (MULTIVERSION) Current SYSTEM DEC Rdb environment is version V6.1-0 (MULTIVERSION) Current PROCESS SQL environment is version V6.0-0 (MULTIVERSION) Current PROCESS Rdb/Dispatch environment is version V6.0-1 (MULTIVERSION) Current SYSTEM SQL environment is version V6.0-1 (MULTIVERSION) Current SYSTEM Rdb/Dispatch environment is version V6.1-0 (MULTIVERSION) (continued on next page) Sample Installations A-1 Example A-1 (Cont.) Application Generator OpenVMS Alpha Sample Installation Log $ @sys$update:vmsinstal dagn030 MKA500 options n OpenVMS AXP Software Product Installation Procedure V6.2 It is 12-JUL-1996 at 09:38. Enter a question mark (?) at any time for help. %VMSINSTAL-W-ACTIVE, The following processes are still active: _RTA3: _FTA26: DCE$RPCD DCE$SECD DCE$SEC_CLIENTD DCE$CDSADV DCE$CDSCLERK DCE$CDSD DCE$DTSD DCE$NSID DECW$SERVER_0 _RTA2: DECW$MWM VUE$PBG_3 DECW$TE_015B _FTA4: _FTA5: DECW$TE_2269 _FTA31: _FTA34: SQLSRV$SERVER _FTA27: UCX$BOOTP_BG3 _FTA21: _FTA28: * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? (continued on next page) A-2 Sample Installations Example A-1 (Cont.) Application Generator OpenVMS Alpha Sample Installation Log The following products will be processed: DAGN V3.0 Beginning installation of DAGN V3.0 at 09:38 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 4 * Do you want to continue the installation [NO]? Y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. ********************************************************************** * * * Digital Application Generator V 3.0 TP-Server * * ============================================== * * * * Copyright (C) 1996 BY * * Mirus Data AB, Gothenburg, Sweden * * All Rights Reserved. * * * ********************************************************************** Checking system requirements ... * Have you registered and loaded the DADMIRE TP-SERVER PAK [YES]? * Do you want to purge files replaced by this installation [YES]? * Do you wish to install the ACMSXP-server kit (10000 blocks) [YES]? * Do you wish to install the ACMS-server kit (10000 blocks) [YES]? * Do you want to run the IVP after the installation [YES]? (continued on next page) Sample Installations A-3 Example A-1 (Cont.) Application Generator OpenVMS Alpha Sample Installation Log The remainder of the installation is expected to take between 1 and 2 minutes. No further questions will be asked during this installation. %DAGN_TP_CS_-I-MAINKITBEGIN, restoring kit. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %DAGN_TP_CS_-I-MAINKITEND, kit restored. %DAGN_TP_CS_-I-INSMAINSTART, beginning installation of kit. %VMSINSTAL-I-SYSDIR, This product creates system directory [DADMIRE_TPS]. %CREATE-I-EXISTS, VMI$COMMON:[DADMIRE_TPS] already exists %DAGN_TP_CS_-I-INSMAINEND, installation of kit complete. The following directories have been created/updated by this installation: SYS$COMMON:[DADMIRE_TPS.CLIENT] - added CLIENT FILES SEE RELEASE NOTES SYS$COMMON:[DADMIRE_TPS.COMMON] - added ACMSXP FILES SEE RELEASE NOTES SYS$COMMON:[DADMIRE_TPS.COMMON] - added ACMS FILES SEE RELEASE NOTES The final part of the installation process will now occur. Please read the release notes before using Digital Application Generator. These contain important information for this release. These are in SYS$HELP:DAGN030.RELEASE_NOTES. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Application Generator Installation Verification Procedure invoked This IVP can also be run manually from SYS$TEST by invoking @SYS$TEST:dagn030_ivp.com Starting the Application Generator IVP... The IVP will check that the installed library is correct Application Generator IVP completed Application Generator IVP completed successfully (continued on next page) A-4 Sample Installations Example A-1 (Cont.) Application Generator OpenVMS Alpha Sample Installation Log Installation of DAGN V3.0 completed at 09:39 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]DAGN030.VMI_DATA VMSINSTAL procedure done at 09:39 $ LOG SYSTEM logged out at 12-JUL-1996 19:39:36.89 Sample Installations A-5 B _________________________________________________________________ Application Generator TP Server Directories and Files This appendix lists the directories and files that are created on your system during an Application Generator TP Server installation. B.1 Application Generator TP Server Directory Structure on OpenVMS The root directory in the Application Generator directory structure for the OpenVMS server environment is SYS$COMMON:[DADMIRE_TPS]. The root directory contains the following subdirectories: o Library directory: SYS$COMMON:[DADMIRE_TPS.COMMON] o Client directory: SYS$COMMON:[DADMIRE_TPS.CLIENT] Table B-1 shows the contents of the [DADMIRE_TPS.COMMON] library directory. Application Generator TP Server Directories and Files B-1 Table B-1 COMMON Subdirectory on OpenVMS _____________________________________________________________ File Description _____________________________________________________________ DADMIRE_ALPHAVMSLIB.OLB Library procedures for Alpha systems - installed only on Alpha systems DADMIRE_VAXVMSLIB.OLB Library procedures for VAX systems - installed only on VAX systems DADMIRE_ACMSXP_ALPHA.OPT ACMSxp link options for Alpha systems - installed only for ACMSxp DADMIRE_ACMS_ALPHA.OPT ACMS link options for Alpha systems - installed only for ACMS on Alpha systems DADMIRE_ACMS_VAX.OPT ACMS link options for VAX systems - installed only for ACMS on VAX systems _____________________________________________________________ Table B-2 shows the contents of the [DADMIRE_TPS.CLIENT] client directory. Table B-2 CLIENT Subdirectory on OpenVMS _____________________________________________________________ File Description _____________________________________________________________ DADM_CLI.EXE Compressed self-extracting executable image that must be moved to the client _____________________________________________________________ B.2 Application Generator TP Server Directory Structure on Windows NT The root directory in the Application Generator directory structure for the Windows NT server environment is DADMIRE_TPS, installed in the directory that you specify during installation. The root directory contains the following subdirectories: o Library directory: DADMIRE_TPS\COMMON o Client directory: DADMIRE_TPS\CLIENT B-2 Application Generator TP Server Directories and Files The DADMIRE_TPS directory also contains an installation log (.LOG) file that can be used if you want to remove the installed structure. Table B-3 shows the contents of the DADMIRE_TPS\COMMON library directory. Table B-3 COMMON Subdirectory on Windows NT ___________________________________________________________ File Description ___________________________________________________________ DADMLIBR.C C file DADMLIBR.H Header file DADMLIBR.LIB Library file ___________________________________________________________ Table B-4 shows the contents of the DADMIRE_TPS.CLIENT client directory. Table B-4 CLIENT Subdirectory on Windows NT ___________________________________________________________ File Description ___________________________________________________________ DADM_CLI.EXE Compressed self-extracting executable image that must be moved to the client README.TXT Text file of concise product information to read before installing and using the software ___________________________________________________________ Application Generator TP Server Directories and Files B-3 _________________________________________________________________ Index D Installation _______________________________ on OpenVMS (cont'd) Directories installed privileges, 1-4 CLIENT subdirectory, B-2, recovery after system B-3 failure, 2-6 COMMON subdirectory, B-1, requirements, 1-3 B-3 disk space, 1-4 DADMIRE_TPS root directory, system parameters, 1-5 B-1, B-2 VMSINSTAL, 1-9 time, 1-3 E______________________________ on Windows NT Executable disk space, 4-1 moving to client, 3-1, 4-2 preparation, 4-1 requirements, 4-1 F______________________________ L Failure recovery _______________________________ on OpenVMS, 2-6, 2-7 License Management Facility, 1-3 G License registration _______________________________ on OpenVMS, 1-3 GBLPAGES system parameter on steps, 1-3 OpenVMS, 1-6 LMF GBLSECTIONS system parameter See License Management on OpenVMS, 1-6 Facility Getting Started, 3-2, 4-3 I O______________________________ _______________________________ OpenVMS Installation preparing to install on, 1-1 on OpenVMS, 2-1 system disk backup, 1-9 aborting, 2-1 OpenVMS parameters failures, 2-7 calculating system values, invoking VMSINSTAL, 2-2 1-6 preparation, 1-1 Index-1 OpenVMS parameters (cont'd) Root directory, B-1, B-2 checking system values, 1-5 prerequisite values, 1-5 S______________________________ Software P______________________________ operating system, 1-1, 4-1 Preparing to install prerequisite, 1-1 on OpenVMS, 1-1 operating system, viii on Windows NT, 4-1 SYSGEN parameters See OpenVMS parameters Q______________________________ Quotas V______________________________ on OpenVMS Version requirements, 1-2 disk, 1-4 process account, 1-7 W______________________________ R Windows NT _______________________________ preparing to install on, 4-1 Release notes requirements, 4-1 on OpenVMS, 2-7 Index-2