VAX Xway Installation Guide Order Number: AA-HT95C-TE Software Version: VAX Xway Version 1.2 Operating System: VAX/VMS Version 5.0 and higher Digital Equipment Corporation ________________________ July 1990 __________ The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. __________ Copyright ©1990 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. __________ The postpaid READER'S COMMENTS form on the last page of this document requests the user's critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DEC DECUS RSX DEC/CMS DECwriter UNIBUS DEC/MMS DIBOL VAX DECalc EduSystem VAX Xway DECalc-Plus FMS-11 VAXcluster DECgraph IAS VMS DECnet MASSBUS VT DECslide PDP DECsystem-10 PDT DECsystem-20 RSTS DIGITAL Lotus 1-2-3, Symphony, VisiCalc, and DIF are trademarks of Lotus Development Corporation. Multiplan and SYLK are trademarks of Microsoft Corporation. Supercomp-Twenty and 20/20 are trademarks of Access Technologies, Inc. dBase II is a trademark of Ashton-Tate Corporation. This document was prepared using VAX DOCUMENT, Version 1.2 ________________________________________________________________ Contents __________________________________________________________ PREFACE v ________________________________________________________________ CHAPTER 1 PREINSTALLATION 1-1 __________________________________________________________ 1.1 THE DISTRIBUTION KIT 1-1 __________________________________________________________ 1.2 PREREQUISITE SOFTWARE 1-2 __________________________________________________________ 1.3 INSTALLATION PROCEDURE REQUIREMENTS 1-2 1.3.1 Checking for adequate disk space 1-2 1.3.2 Checking the System Parameters 1-3 1.3.3 Files provided by the Xway Installation Procedure 1-5 ________________________________________________________________ CHAPTER 2 INSTALLATION 2-1 __________________________________________________________ 2.1 INSTALLING VAX XWAY 2-1 __________________________________________________________ 2.2 INSTALLATION PROCEDURE 2-2 __________________________________________________________ 2.3 INSTALLATION ERROR MESSAGES 2-9 iii Contents ________________________________________________________________ CHAPTER 3 RUNNING THE INSTALLATION VERIFICATION PROCEDURE 3-1 ________________________________________________________________ CHAPTER 4 POST-INSTALLATION 4-1 __________________________________________________________ 4.1 MODIFYING THE SYSTARTUP_V5.COM FILE 4-1 __________________________________________________________ 4.2 XWAY LOGICAL NAMES 4-1 __________________________________________________________ 4.3 USING XWAY IN A VAXCLUSTER ENVIRONMENT 4-2 ________________________________________________________________ APPENDIX A SAMPLE INSTALLATION A-1 ________________________________________________________________ TABLES 1-1 Directories and Files for Xway Installation 1-5 iv ________________________________________________________________ Preface This installation guide describes how to install VAX Xway on the VAX/VMS operating system. It is for system managers. Keep this installation guide with your distribution kit. You will need to refer to it again if you receive any maintenance updates or need to reinstall VAX Xway. The installation guide describes the installation procedure step by step. The dialog is interactive. The installation procedure prompts you to answer questions and change volumes, and waits for you to tell it to continue. This installation guide does not contain the release notes. The release notes are provided on-line. You can display and print them from within the installation procedure. To read the release notes after the installation, type or print the file SYS$HELP:XWAY012.RELEASE_NOTES. v _______________________________________________________ 1 Preinstallation This chapter describes how to prepare for the installation of VAX Xway V1.2 software on your VAX/VMS system. __________________________________________________________ 1.1 The Distribution Kit You can receive VAX Xway V1.2 on two different media types: MAG tape (16MT9) and TK50. The installation procedure prompts you to mount the volumes. To mount the distribution medium, see Chapter 3 ("Installing Software") of the VMS System Manager's Manual for your system. The chapter also details several options to the installation procedure. Be sure to read it. Each distribution kit includes all files needed to install and execute Xway V1.2. Release notes about the Xway installation and operation are available on- line and can be displayed and printed from within the installation procedure. The VAX Xway kit contains three savesets: o XWAY012.A o XWAY012.B o XWAY012.C 1-1 Preinstallation __________________________________________________________ 1.2 Prerequisite Software To run Xway V1.2 you must have VMS V5.0 or later on your system. __________________________________________________________ 1.3 Installation Procedure Requirements Before you can install Xway, you must have the following: o An Xway distribution kit o Access to a privileged system manager's account o A minimum of 2,200 free blocks during installation and a minimum of 1,800 free blocks after installation o A minimum of 400 unused global pages and a minimum of 10 global sections o A proper license installed and loaded _____________________________ 1.3.1 Checking for adequate disk space You need at least 2,200 free blocks before attempting this installation. 1,800 blocks of this will be space permanently allocated to Xway files. Use the following command to determine if you have enough free blocks on your system disk (or target disk system) to install Xway: $ SHOW DEVICE SYS$SYSDEVICE 1-2 Preinstallation _____________________________ 1.3.2 Checking the System Parameters Before you install Xway, you must compare the required number of global pages and global sections with the values on your system. The installation procedure checks these system parameters. If a parameter does not meet the minimum value, the installation will terminate. See the VAX/VMS System Manager's Reference Manual for information on modifying GBLPAGES and GBLSECTIONS values. To determine the number of global pages and sections on your system, do the following: 1 Invoke the INSTALL utility by entering: $ INSTALL :== $INSTALL/COMMAND_MODE $ INSTALL 2 Determine the number of available global pages by entering: INSTALL> LIST/GLOBAL This command determines whether enough global pages are available to install Xway. It displays a list of all currently known global sections. At the end of the list is a summary of the number of global sections used, the number of global pages used, and the number of global pages unused. Xway requires approximately 400 global pages. If there are fewer than 400 unused pages, you can delete an existing known image by using the INSTALL utility. You can also increase the GBLPAGES system parameter with the SYSTEM GENERATION utility by using AUTOGEN.COM. For more information on using AUTOGEN, see the VAX/VMS System Manager's Reference Manual. 1-3 Preinstallation Note Record the number of global sections used because you will need this information when checking the global sections. 3 Exit from the INSTALL utility. INSTALL> EXIT 4 Determine the number of available global sections by using the SYSGEN utility. Enter the following: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE CURRENT SYSGEN> SHOW GBLSECTIONS These commands determine whether enough global sections are available to install Xway. The first number displayed is the maximum number of global sections. Compare this number to the number of global sections in use displayed by the INSTALL utility. Xway requires 10 global sections. Therefore if the amount displayed plus 10 exceeds the system maximum, you must increase the number of available global sections before you can install Xway. To increase the number, you must increase the GBLSECTIONS parameter with the SYSTEM GENERATION utility by using AUTOGEN.COM. For more information on AUTOGEN, refer to the VAX/VMS System Manager's Reference Guide. If the amount displayed plus 10 is less than the system maximum, you can install Xway. 1-4 Preinstallation _____________________________ 1.3.3 Files provided by the Xway Installation Procedure The following table lists the new files the installation procedure adds to your system. ________________________________________________________________ Table 1-1 Directories and Files for Xway Installation _______________________________________________________ Directory_____________File_____________________________ SYS$SYSTEM: XWAY$MAIN.EXE SYS$LIBRARY: XWAY$MENUSHR.EXE SYS$LIBRARY: XWAY$SHARE.EXE XWAY$HELP.TXT XWAY012.RELEASE_NOTES SYS$STARTUP: XWAY$STARTUP.COM SYS$MESSAGE: XWAY$MESSAGE.EXE SYS$TEST: XWAY$IVP.COM SYS$TEST:[XWAY] XWAY$IVP.XWAY XWAY$IVP_C.OBJ XWAY$IVP_INPUT.DIF XWAY$IVP_INPUT.DMP XWAY$IVP_INPUT.WKS 1-5 Preinstallation ________________________________________________________________ Table 1-1 (Cont.) Directories and Files for Xway Installation _______________________________________________________ Directory_____________File_____________________________ XWAY$IVP_PAS.OBJ SYS$COMMON:[XWAY] XWAY$DEF.FOR XWAY$DEF.H XWAY$DEF.MAR XWAY$DEF.PAS XWAY$DEF.PEN XWAY$DEF.R32 XWAY$XCIB.FOR XWAY$XCIB.H XWAY$XCIB.MAR XWAY$XCIB.PAS XWAY$XCIB.PEN XWAY$XCIB.R32 XWAY$EXAMPLES: XWAY$IVP_C.C _______________________________XWAY$IVP_PAS.PAS_________________ 1-6 _______________________________________________________ 2 Installation This chapter explains how to install VAX Xway and describes error messages you might receive during installation. __________________________________________________________ 2.1 Installing VAX Xway This section contains the steps you follow to install Xway. You will have to log on to the system manager's account and make a backup of the system disk, checking all parameters. You should install Xway in stand-alone mode. You will have to make sure all users have logged off of the system and that all batch jobs are complete. Then you will shut down the DECnet network and invoke VMSINSTAL to install Xway. VMSINSTAL prompts you to enter information. Most queries require a simple YES or NO answer. Respond with Y or N, as appropriate, or press to choose the default. Enhancements to VMSINSTAL in future releases of VMS might result in additional prompts appearing during the installation. Although such prompts might not be documented in this installation guide, the installation will proceed normally. 2-1 Installation __________________________________________________________ 2.2 Installation Procedure 1 Log on to the system manager's account. Set the default directory to SYS$UPDATE by entering: $ SET DEFAULT SYS$UPDATE 2 Make a backup of the system disk and check the system parameters. 3 Start the installation by entering: $ @VMSINSTAL XWAY012 [device] options N [device] is the name of the device on which you will mount the Xway distribution media (for example, MUA0:.) VMSINSTAL displays information similar to the following: VAX/VMS Software Product Installation Procedure V5.0 It is 22-JUL-1990 at 08:08. Enter a question mark (?) at any time for help. Are you satisfied with the backup of your system disk [YES]? Enter a question mark (?) at any prompt to get on-line help. If you have not made a backup of your system disk, type N and . You will exit from the installation procedure. If you have backed up your system disk, enter Y or just press to continue the installation procedure. VMSINSTAL checks to see if users are logged on to the system. If so, VMSINSTAL displays a warning message. You can stop the installation by pressing when prompted to continue the installation. 2-2 Installation 4 Mount the first installation kit volume when VMSINSTAL displays a message similar to the following: Please mount the first volume of the set on [device] Are you ready? 5 After mounting the volume, type Y and press to continue the installation. VMSINSTAL displays the following messages: %MOUNT-I-MOUNTED, XWAY mounted on [device]: The following products will be processed: XWAY V1.2 Beginning installation of XWAY V1.2 at 08:10 %VMSINSTAL-I-RESTORE, Restoring product saveset A... Release Note Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 6 Select a release notes option. If you select Option 1, VMSINSTAL displays the release notes immediately on your screen. If you select Option 2 or 3, VMSINSTAL prompts you for a queue name: * Queue name [SYS$PRINT]: Enter a queue name or press to indicate the default output print device SYS$PRINT. If you select Option 4, VMSINSTAL does not display or print the release notes. 2-3 Installation VMSINSTAL asks if you want to continue with the installation: Do you want to continue the installation [NO]? : 7 Enter N or press to stop the installation. Enter Y to continue. If you enter Y to continue the installation, VMSINSTAL displays the following message: *************************************************************** * * * Xway Data Format Conversion Program V1.2 * * * * Installation Procedure * * * * Copyright 1990, Digital Equipment Corporation * * * *************************************************************** Product: VAX XWAY Producer: DEC Version: 1.2 Release Date: 19-JUL-1990 * Does this product have an authorization key registered and loaded? yes 8 If you have already registered and loaded the VAX Xway license, enter YES. The installation will continue at Step 9. If your license is not registered and loaded, enter NO. VMSINSTAL displays the following message: 2-4 Installation You do not have the Xway license currently installed on your system. You may continue with this installation, or you may stop to load the license at this time. If you do continue, you will not be able to use the Xway product until the license is loaded. * Do you wish to continue with the Xway installation? [N]? YES a. You can elect to continue the installation even though you have not loaded the VAX Xway license. If you enter YES, VMSINSTAL displays the following messages: It is recommended that the IVP be run after the license has been registered The installation then continues at Step 9. b. You can choose to stop the installation at this point by entering NO or by pressing so you can load the Xway license. VMSINSTAL displays the following messages and ends the installation. You have chosen to quit this installation. To install the Xway license, use the procedure: SYS$UPDATE:VMSLICENSE.COM %VMSINSTAL-E-INSFAIL, The installation of XWAY V1.2 has failed. VMSINSTAL procedure done at 11:11 9 This installation procedure provides an automated Installation Verification Procedure (IVP). You have the option of running the IVP automatically after the installation. * Do you want to run the IVP after the installation [YES]? 2-5 Installation Digital recommends that the IVP always be run after an installation. However, if the VAX Xway license is not already loaded, then the IVP will fail. If you answered NO to question 8 above, you should also enter NO to this question. 10 During this installation, VMSINSTAL provides new files to replace existing versions. You should purge the older versions to save disk space. (You can keep them if you feel they might be useful.) * Do you want to purge the files replaced by this installation [YES]? Press or enter Y to purge the old version of Xway from your system. Enter N to keep the old version of Xway. 11 VMSINSTAL asks you where you want to place Xway V1.2 library files. You should place them in the directory SYS$COMMON:[XWAY], which is the default location. If you do not have enough space on your system disk, you can specify another location by entering a valid VMS directory specification in the form: device:[directory]. If the directory you specify does not exist, VMSINSTAL will create it. VMSINSTAL will equate the system logical XWAY$LIBRARY to the directory that you specify. If the directory SYS$COMMON:[XWAY] currently exists on your system, VMSINSTAL displays the following message: The directory SYS$COMMON:[XWAY] currently exists on your system. This is the recommended location for the Xway V1.2 library files 2-6 Installation The Xway required files are copied to the Xway library (XWAY$LIBRARY) Enter ? to get help. * Specify Xway library location [SYS$COMMON:[XWAY]]? 12 Enter the device and directory you want to use. If the device you specified does not exist on the system, VMSINSTAL repeats the prompt. Specify another device and directory. VMSINSTAL continues the installation without asking any more questions. VMSINSTAL optionally runs the Installation Verification Procedure (IVP) after it completes the installation. VMSINSTAL displays the following messages as it completes the installation and the IVP: All questions necessary for the installation of Xway have been answered. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... *********************************************************** * * * Xway Data Format Conversion Program V1.2 * * * * Installation Verification * * * *********************************************************** *** Xway V1.2 Installation Verification Procedure *** When the IVP has completed you will see one of the following messages: "Xway V1.2 IVP has FAILED" 2-7 Installation or "Xway V1.2 IVP was a success!" The IVP is entirely noninteractive. You do not have to enter filenames or any other information. Testing Xway V1.2 exchange noninteractively ... xway/nointeractive/log=Xway$ivp.log Xway$ivp_input.dif- /format=dif xway$ivp_output.tab/format=tabular/separator="," The log file from the exchange will now appear: Xway V1.2-020 9-July-1990 11:29:36 %XWAY-S-FILEIN, 38 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.DIF;2 %XWAY-S-FILEOUT, 3 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.TAB;1 Linking with XWAY$MENUSHR and performing a test exchange... Enter Xway Definition file specification: xway$ivp.xway Linking with XWAY$SHARE and performing a test exchange... Types of conversions: (1) Lotus WKS to DECalc V22 (2) DECalc V22 to Lotus WRK (3) Lotus WRK to DECalc V30 (4) DECalc V30 to Lotus WK1 Enter the type of conversion: 2-8 Installation 1 Enter the input file specification: xway$ivp_input.wks Enter the output file specification: xway$ivp_output.dmp %XWAY-S-FILEIN, 44 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.WKS;2 %XWAY-S-FILEOUT, 67 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.DMP;1 Xway V1.2 IVP was a success! Installation of XWAY V1.2 completed at 11:29 VMSINSTAL procedure done at 11:29 $ __________________________________________________________ 2.3 Installation Error Messages This section describes error messages you might receive during installation. Operating System Failure If the power goes off during the installation or the operating system fails for any other reason, you must restart the system and the installation procedure. The following errors can occur during the installation procedure: %XWAY-E-BADVMS, Xway V1.2 requires VMS version V5.0 or later to install. Facility: VAX Xway Severity: Error 2-9 Installation Explanation: Your VAX system must be running VMS V5.0 or later to install VAX Xway V1.2. VMSINSTAL detected that an earlier version of VMS running on your system. Upgrade to VMS V5.0 and then repeat the VAX Xway V1.2 installation. %XWAY-I-DIRNOTSPEC, No directory was specified, please re-specify. Facility: VAX Xway Severity: Information Explanation: When prompted for a directory specification, no directory was specified. VMSINSTAL will reprompt for the directory specification. Be sure to include a valid directory. %XWAY-I-NODEVICE, The specified device does not exist on this system, please re-specify. Facility: VAX Xway Severity: Information Explanation: When prompted for a directory specification, a device was specified that does not currently exist on your system. VMSINSTAL will reprompt for the directory specification. Be sure to include a valid device. %XWAY-E-NOSPACE, There is insufficient disk space to continue the installation. Xway V1.2 requires 2,200 free blocks to install. Facility: VAX Xway Severity: Error 2-10 Installation Explanation: The system disk on your system must have at least 2,200 free blocks to install VAX Xway V1.2. VMSINSTAL found less than 2,200 blocks and terminated. Make sure that at least 2,200 blocks are available on your system disk and repeat the VAX Xway V1.2 installation. 2-11 _______________________________________________________ 3 Running the Installation Verification Procedure You can execute the Xway Installation Verification Procedure (IVP) from a privileged account any time after you install Xway on your system. To execute the IVP, enter the following: $ @SYS$TEST:XWAY$IVP.COM The IVP displays the following message: *********************************************************** * * * Xway Data Format Conversion Program V1.2 * * * * Installation Verification * * * *********************************************************** *** Xway V1.2 Installation Verification Procedure *** When the IVP has completed you will see one of the following messages: "Xway V1.2 IVP has FAILED" or "Xway V1.2 IVP was a success!" The IVP is entirely noninteractive. You do not have to enter filenames or any other information. Testing Xway V1.2 exchange noninteractively ... 3-1 Running the Installation Verification Procedure xway/nointeractive/log=Xway$ivp.log Xway$ivp_input.dif/format=dif- xway$ivp_output.tab/format=tabular/separator="," The log file from the exchange will now appear: Xway V1.2-020 9-July-1990 11:29:36 %XWAY-S-FILEIN, 38 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.DIF;2 %XWAY-S-FILEOUT, 3 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.TAB;1 Linking with XWAY$MENUSHR and performing a test exchange... Enter Xway Definition file specification: xway$ivp.xway Linking with XWAY$SHARE and performing a test exchange... Types of conversions: (1) Lotus WKS to DECalc V22 (2) DECalc V22 to Lotus WRK (3) Lotus WRK to DECalc V30 (4) DECalc V30 to Lotus WK1 Enter the type of conversion: 1 Enter the input file specification: xway$ivp_input.wks Enter the output file specification: xway$ivp_output.dmp %XWAY-S-FILEIN, 44 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.WKS;2 %XWAY-S-FILEOUT, 67 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.DMP;1 Xway V1.2 IVP was a success! 3-2 Running the Installation Verification Procedure If the IVP fails, it displays a message indicating the reason for failure. See Section 2.3, Installation Error Messages, for an explanation of the message. 3-3 _______________________________________________________ 4 Post-Installation __________________________________________________________ 4.1 Modifying the SYSTARTUP_V5.COM File The installation procedure for VAX Xway V1.2 will add the command file for starting Xway (SYS$STARTUP:XWAY$STARTUP.COM) to the SYSMAN startup database. You should remove any references to XWAY$STARTUP.COM from your SYSTARTUP_V5.COM procedure. If you do not, the command procedure will be executed twice at system startup. __________________________________________________________ 4.2 Xway Logical Names The VAX Xway V1.2 installation procedure creates the following directories: XWAY$LIBRARY XWAY$EXAMPLES The logical XWAY$LIBRARY defaults to SYS$COMMON:[XWAY]. However, the installation procedure creates it on your system according to the answer you gave during the installation. The logical XWAY$EXAMPLES defaults to SYS$COMMON:[SYSHLP.EXAMPLES.XWAY]. This directory contains simple examples of how to use the Xway Callable Interface to perform conversions from user programs. These examples are the source programs used during the Installation Verification Procedure. Both logicals are defined in SYS$STARTUP:XWAY$STARTUP.COM. 4-1 Post-Installation __________________________________________________________ 4.3 Using Xway in a VAXcluster Environment If you are using Xway on other nodes in a VAX cluster, you must also perform the following steps to insure that VAX Xway is available to other licensed nodes: 1 Replace the DCL tables on the other nodes. 2 Run the Xway startup command procedure on each node. To do this, you should use the SYSMAN utility by entering the following commands: $ SYSMAN :== $SYS$SYSTEM:SYSMAN $ SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER SYSMAN> DO @SYS$STARTUP:XWAY$STARTUP.COM SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE SYSMAN> EXIT $ 4-2 _______________________________________________________ A Sample Installation Username: SYSTEM Password: $ set default sys$update $ @VMSINSTAL XWAY012 VAX/VMS Software Product Installation Procedure V5.3 It is 9-JUL-1990 at 11:27. Enter a question mark (?) at any time for help. %VMSINSTAL-W-ACTIVE, The following processes are still active: [XWAY.KIT] _RTA5: _RTA6: * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: dh$:[xway.kit] * Enter installation options you wish to use (none): The following products will be processed: XWAY V1.2 Beginning installation of XWAY V1.2 at 11:27 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. A-1 Sample Installation *************************************************************** * * * Xway Data Format Conversion Program V1.2 * * * * Installation Procedure * * * * Copyright 1990, Digital Equipment Corporation * * * *************************************************************** Product: VAX XWAY Producer: DEC Version: 1.2 Release Date: 19-JUL-1990 * Does this product have an authorization key registered and loaded? yes * Do you want to run the IVP after the installation [YES]? * Do you want to purge files replaced by this installation [YES]? yes The logical XWAY$LIBRARY is currently defined as SYS$COMMON:[XWAY] * Would you like to put the Xway version V1.2 library files there [YES]? yes All questions necessary for the installation of Xway have been answered. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... A-2 Sample Installation *********************************************************** * * * Xway Data Format Conversion Program V1.2 * * * * Installation Verification * * * *********************************************************** *** Xway V1.2 Installation Verification Procedure *** When the IVP has completed you will see one of the following messages: "Xway V1.2 IVP has FAILED" or "Xway V1.2 IVP was a success!" The IVP is entirely noninteractive. You do not have to enter filenames or any other information. Testing Xway V1.2 exchange noninteractively ... xway/nointeractive/log=Xway$ivp.log Xway$ivp_input.dif/format=dif- xway$ivp_output.tab/format=tabular/separator="," The log file from the exchange will now appear: Xway V1.2-020 9-July-1990 11:29:36 %XWAY-S-FILEIN, 38 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.DIF;2 %XWAY-S-FILEOUT, 3 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.TAB;1 Linking with XWAY$MENUSHR and performing a test exchange... Enter Xway Definition file specification: xway$ivp.xway A-3 Sample Installation Linking with XWAY$SHARE and performing a test exchange... Types of conversions: (1) Lotus WKS to DECalc V22 (2) DECalc V22 to Lotus WRK (3) Lotus WRK to DECalc V30 (4) DECalc V30 to Lotus WK1 Enter the type of conversion: 1 Enter the input file specification: xway$ivp_input.wks Enter the output file specification: xway$ivp_output.dmp %XWAY-S-FILEIN, 44 lines read from VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_INPUT.WKS;2 %XWAY-S-FILEOUT, 67 lines written to VMI$ROOT:[SYSHLP.EXAMPLES.XWAY]XWAY$IVP_OUTPUT.DMP;1 Xway V1.2 IVP was a success! Installation of XWAY V1.2 completed at 11:29 VMSINSTAL procedure done at 11:29 $ A-4