 















                   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 <Return> 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 <Return>. You will exit from the
                      installation procedure.

                      If you have backed up your system disk, enter Y or
                      just press <Return> 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
                      <Return> 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 <Return>
                      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 <Return> 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 <Return> 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 <Return>
                         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 <Return> 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
