

 















             DECnet/SNA VMS 3270 Data Stream

             Programming Interface

             Installation

             Order Number: AA-EV64C-TE


             This document tells the user how to install the DECnet/SNA
             VMS 3270 Data Stream Programming Interface Version 1.4 soft-
             ware. The document also explains how to configure the IBM
             software to communicate with the interface.




             Revision/Update Information:  This is a revised manual.

             Operating System and Version: VMS Version 5.0 or 5.1

             Software Version:             DECnet/SNA VMS 3270 Data Stream
                                           Programming Interface Version
                                           1.4




             Digital Equipment Corporation

 





             ________________________
             May 1989

             __________
             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.

             __________
             Copyright 1989 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             DIBOL         UNIBUS
             DEC/CMS         EduSystem     VAX
             DEC/MMS         IAS           VAXcluster
             DECnet          MASSBUS       VMS
             DECsystem-10    PDP           VT
             DECSYSTEM-20    PDT
             DECUS           RSTS
             DECwriter       RSX           DIGITAL

             This document was prepared using VAX DOCUMENT, Version 1.1

 







                                                                  Contents
          ________________________________________________________________

                __________________________________________________________
                PREFACE                                                 vi

          ________________________________________________________________
          CHAPTER 1  PREPARING FOR INSTALLATION                        1-1


                1.1   CHECKING THE DISTRIBUTION KIT                    1-1

                1.2   PREREQUISITE SOFTWARE                            1-1


                1.3   VMS SYSTEM REQUIREMENTS                          1-2
                1.3.1     Installation Requirements                    1-2
                1.3.2     VMS License Management Facility
                          Requirements                                 1-4
                1.3.3     VMS Tailor Requirements                      1-4
                1.3.4     Checking System Parameter Values             1-5
                1.3.5     Calculating the Value for GBLSECTIONS        1-5
                1.3.6     Changing System Parameter Values with
                          AUTOGEN                                      1-6

                1.4   VMSINSTAL REQUIREMENTS                           1-7
                1.4.1     Using VMSINSTAL                              1-8


                1.5   ON-LINE RELEASE NOTES                            1-9









                                                                       iii

 






          ________________________________________________________________
          CHAPTER 2  INSTALLING THE 3270 DS INTERFACE                  2-1


                2.1   INSTALLATION PROCEDURE                           2-1
                2.1.1     Running VMSINSTAL                            2-1

                2.2   POSTINSTALLATION CONSIDERATIONS                  2-7
                2.2.1     Files Created During Installation            2-7


                2.3   ADDING THE SNA_3270DS HELP FILE TO AN EDT
                      HELP FILE                                        2-9

                2.4   VERIFYING THE INSTALLATION OF THE 3270 DS
                      INTERFACE SOFTWARE                               2-9


                2.5   INSTALLING THE 3270 DS PROGRAMMING INTERFACE
                      AS A SHAREABLE IMAGE                            2-11

                2.6   USING THE 3270 DS INTERFACE SOFTWARE IN A
                      VAXCLUSTER                                      2-11


                2.7   SAMPLE INSTALLATION                             2-12

          ________________________________________________________________
          TABLES

                1-1   Installation Requirements for the 3270 DS
                      Interface                                        1-3

                2-1   Files Created During Installation                2-7





          iv

 













                                                                   Preface
          ________________________________________________________________


             The DECnet/SNA VMS 3270 Data Stream Programming Interface
             (3270 DS Interface) enables VMS users to communicate with
             programs running on an IBM host. The interface allows you

             to develop applications on a VMS system that require support
             for an IBM SNA logical unit (LU) type 2 session. Access to
             the IBM SNA network is through one of the following trans-
             port products: VMS/SNA, DECnet/SNA Gateway V1.5, DECnet/SNA
             Gateway-ST, or DECnet/SNA Gateway-CT.

          __________________________________________________________

          Manual Objectives

             The (DECnet/SNA VMS 3270 Data Stream Programming Interface
             Installation) manual provides the information needed to
             install and verify the 3270 DS Interface software.

          __________________________________________________________

          Intended Audience

             This manual is for system managers responsible for installing
             the 3270 DS Interface and configuring the IBM software to
             communicate with the 3270 DS Interface. Readers of this
             manual must have a working knowledge of the Digital and IBM
             systems they will be using.

          vi

 





          __________________________________________________________

          Document Structure

             This document consists of two chapters.

             Chapter 1   Provides introductory information about the 3270
                         DS Interface.

             Chapter 2   Describes the installation process including the
                         Product Authorization Key (PAK) and Installation
                         Verification Procedure (IVP). It also contains
                         sample installations.

          __________________________________________________________

          Associated Documents

             The following is a list of documents related to this product:

              o DECnet/SNA VMS 3270 Data Stream Programming Interface
                Problem Solving

              o DECnet/SNA VMS 3270 Data Stream Programming Interface
                Programming

              o DECnet/SNA VMS Gateway Management Guide

              o VMS/SNA Management Guide

              o DECnet/SNA Gateway-ST Problem Solving

              o DECnet/SNA Gateway-CT Problem Determination Guide

              o DECnet/SNA Gateway Problem Determination Guide

              o VMS/SNA Problem Solving

              o DECnet/SNA Gateway Guide to IBM Parameters

              o DECnet/SNA Gateway-ST Guide to IBM Parameters

              o DECnet/SNA Gateway-CT Guide to IBM Parameters

              o VMS/SNA Guide to IBM Parameters

                                                                       vii

 






             You might find the following VMS manuals useful:

              o VMS Networking Manual

              o VMS Network Control Program Manual

              o VMS Install Utility Manual

              o VMS System Messages and Recovery Procedures

              o Guide to Maintaining a VMS System

              o Guide to VMS System Security

              o VMS Authorize Utility Manual
























          viii

 






          You may also find the following IBM documents useful:

              o IBM 3270 Information Display System Data Stream Programmer's
                Reference, Order No. GA23-0059

              o IBM 3270 Information Display System 3274 Control Unit
                Description and Programmer's Guide, Order No. GA23-0061

              o Systems Network Architecture-Format and Protocol Reference
                Manual, Order No. GC30-3112

              o Systems Network Architecture-Sessions Between Logical
                Units, Order No. GC20-1868

          __________________________________________________________

          Conventions

             This manual uses the following conventions:

             _____________________________________________________________
             Convention__________Meaning__________________________________

             UPPERCASE LETTERS   Represent constant values or symbols.
                                 Code these exactly as they are specified.

             lowercase italics   Represent variables for which you must
                                 supply a value.

             [  ]                Square brackets enclose optional values.
                                 Do not type the brackets in the line of
                                 code.

             (  )                Parentheses enclose group values that
                                 you must specify for a parameter. Type
                                 these values in the line of code in the
                                 indicated order. Type parentheses where
                                 they appear in a line of code.

                                                                        ix

 





             _____________________________________________________________
             Convention__________Meaning__________________________________

             Special type        This special type indicates an example of
                                 system output or user input. In interac-
                                 tive examples, system output is in black
                                 type, and user input is in red type.

             <RET>               Unless otherwise specified, every command
                                 line is terminated by pressing <RET>.

             <CTRL/x>            Control characters are shown as
                                 <CTRL/x>s, where x is an alphabetic char-
                                 acter. Press <CTRL> and the appropriate
             ____________________key_simultaneously.______________________

























          x

 











                                                                 Chapter 1


                                                Preparing for Installation
          ________________________________________________________________




             Before you install the DECnet/SNA VMS 3270 Data Stream
             Programming Interface (3270 DS Interface), you should prepare
             your system.

             This installation involves writing to your system disk,
             Digital Equipment Corporation recommends that you make a
             backup copy of your system disk before you begin.

          __________________________________________________________

          1.1  Checking the Distribution Kit

             Your bill of materials (BOM) specifies the number and con-
             tents of your media. Check the contents of your kit against
             the list in the BOM. If your kit is damaged or if you find
             that parts are missing, call your Digital representative.

          __________________________________________________________

          1.2  Prerequisite Software

             V1.4 of the 3270 DS Interface requires the following soft-
             ware:

              o VMS V5.0 or V5.1

                                           Preparing for Installation  1-1

 






              o Either DECnet/SNA Gateway V1.5, DECnet/SNA Gateway-ST
                V1.0, DECnet/SNA Gateway-CT V1.0, or VMS/SNA V2.0.

             The 3270 DS Interface also requires Gateway Management in-
             stalled on the VMS load host. The individual transport prod-
             ucts require the following versions of the Gateway Management
             product:

              o DECnet/SNA Gateway V1.5 requires Gateway Management for
                DECSA V1.5.

              o DECnet/SNA Gateway-ST requires Gateway Management V2.0.

              o DECnet/SNA Gateway-CT requires Gateway Management V2.0.

          __________________________________________________________

          1.3  VMS System Requirements

             This section discusses VMS requirements as well as checking,
             calculating, and changing parameter values for the 3270 DS
             Interface.

          __________________________________________________________

          1.3.1  Installation Requirements

             Before you install the 3270 DS Interface software, verify
             that the following installation requirements have been met:










          1-2  Preparing for Installation

 






             Table 1-1:  Installation Requirements for the 3270 DS
             ____________Interface________________________________________

             Requirements_______________Specifications____________________

             Software                   VMS V5.0 or V5.1
                                        DECnet/SNA Gateway V1.5, or
                                        DECnet/SNA Gateway-CT V1.0, or
                                        DECnet/SNA Gateway-ST V1.1, or
                                        VMS/SNA software V2.0,
                                        DECnet/SNA VMS Gateway Management
                                        for DECSA V1.5 or DECnet/SNA VMS
                                        Gateway Management V2.0

             Privileges                 System Manager level

             Disk Space                 1300 blocks minimum during instal-
                                        lation
                                        1100 blocks minimum after instal-
                                        lation

             Global Sections            4

             Global Pages               260

             Approximate Installation   6 to 30 minutes, depending on the
             Time                       type of medium used

             Associated Documents       VMS software installation guide
             ___________________________for_your_processor________________

             For background information on installing optional prod-
             ucts on a VMS system, refer to the Guide to VMS Software
             Installation.

             Make sure that you have registered and loaded the Product
             Authorization Key (PAK) before you begin the installation.
             Refer to the VMS License Management Utility Reference Manual
             for this information.

                                           Preparing for Installation  1-3

 






             The following sections show you how to check system parameter
             values, calculate values for the GBLSECTIONS system parame-
             ter, and change parameter values with the VMS AUTOGEN command
             procedure.

          __________________________________________________________

          1.3.2  VMS License Management Facility Requirements

             Before you install this product, you should register your
             Product Authorization Key (PAK) with the License Management
             Facility (LMF). The PAK, which contains information about the
             license, is a paper certificate shipped with the product.

             During the installation, you are asked if you have registered
             the 3270 DS Interface license and loaded the appropriate
             PAK. If you have not already done so, you can complete the
             installation. However, 3270 DS Interface and IVP will not
             run if you have not registered the license or loaded the PAK.
             Once you perform the license registration and have loaded the
             PAK, you will be able to run the 3270 DS Interface and IVP.

             To register and load the license, log in to the system man-
             ager's account. The type the following:

               $ @SYS$UPDATE:VMSLICENSE.COM

             When you are prompted for information, enter the data from
             your PAK. For more information on LMF, see the VMS License
             Management Utility Manual in the VMS documentation set.

          __________________________________________________________

          1.3.3  VMS Tailor Requirements

             The required classes are: VMS Required Save Set, Network
             Support, Programming Support, and Utilities. Be certain these
             classes are installed on your system before installing the
             product. Refer to the VMS Tailor documentation in the VMS
             documentation set for more information.

          1-4  Preparing for Installation

 





          __________________________________________________________

          1.3.4  Checking System Parameter Values

             To check the values of your system parameters, enter the
             following command at the DCL prompt to invoke the SYSGEN
             utility:

               $ RUN SYS$SYSTEM:SYSGEN
               SYSGEN>

             At the SYSGEN> prompt, enter the SHOW command to display
             the value of each system parameter. The values displayed
             should equal or exceed the value of each parameter listed in
             Table 1-1. The following command displays the value for the
             GBLSECTIONS system parameter:

               SYSGEN> SHOW GBLSECTIONS

             After you finish checking the parameters with the SHOW com-
             mand, you can enter the EXIT command at the SYSGEN> prompt to
             return to DCL level.

          __________________________________________________________

          1.3.5  Calculating the Value for GBLSECTIONS

             The value for GBLSECTIONS in Table 1-1 indicates that you
             must have at least three unused sections available on your
             system for the installation to process successfully. To
             calculate how many unused global sections your system has,
             perform the following steps:

              1.Run the VMS Install Utility (INSTALL) using the following
                DCL command:

                  $ INSTALL LIST /GLOBAL /SUMMARY

                The INSTALL utility displays a summary of global pages
                and global sections used by your system, as well as the
                current number of unused global pages. For example:

                                           Preparing for Installation  1-5

 






                                   Summary of Local Memory Global Sections

                  258 Global Sections Used,  22580/3420 Global Pages Used/Unused

              2.Note the amount shown for "Global Sections Used" (258 in
                the example).

              3.Run the SYSGEN utility. Use the SHOW command to determine
                the number of global sections allocated:

                  $ RUN SYS$SYSTEM:SYSGEN
                  SYSGEN> SHOW GBLSECTIONS

                  Parameter Name      Current   Default   Minimum   Maximum Unit  Dynamic
                  --------------      -------   -------   -------   ------- ----  -------
                  GBLSECTIONS         512       250        20       4095    Sections

              4.Subtract the amount shown in the summary (258 in the
                example) from the amount allocated. If the difference
                is less than the number required in Table 1-1, increase
                the value of the GBLSECTIONS parameter.

             Section 1.3.6 describes the procedures for increasing these
             values as well as those of other system parameters. Refer to
             the VMS documentation on system management and operations for
             more information.

          __________________________________________________________

          1.3.6  Changing System Parameter Values with AUTOGEN

             You use the AUTOGEN command procedure to change system param-
             eters. AUTOGEN automatically adjusts values for parameters
             that are associated with the ones you reset manually. To
             change system parameters with AUTOGEN, you must edit the
             following file:

               SYS$SYSTEM:MODPARAMS.DAT

          1-6  Preparing for Installation

 






             For example, to change the setting for the GBLSECTIONS system
             parameter, add this line to the file:

               GBLSECTIONS = 1024

             Now, 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. Also, on VMS V5.0 and V5.1 sys-
             tems you can add the [NO]FEEDBACK parameter to the AUTOGEN
             command line. For more information about using AUTOGEN, see
             the instructions on modifying system parameters in the VMS
             documentation on System Management and Operations.

          __________________________________________________________

          1.4  VMSINSTAL Requirements

             The procedure for installing files using VMSINSTAL on a VMS
             system is automated. You just answer questions displayed
             while the procedure (VMSINSTAL) runs.

             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:

               * Are you satisfied with the backup of your system disk [YES]:?

             To answer a question with the default, press <RET>.

             To install the distribution kit on your VMS host:

              o Log in to the system manager's account.

              o Make sure that all users are logged out and all batch jobs
                are complete.

              o Disable logins and shut down DECnet.

              o Make sure you have backed up the system disk.

                                           Preparing for Installation  1-7

 






              o Make sure you have more than 1300 free blocks on the
                system disk.

              o Make sure you have 260 global pages free. (If there are
                not enough global pages, the start-up procedure, invoked
                immediately before the Installation Verification Procedure
                (IVP), will fail.)

          __________________________________________________________

          1.4.1  Using VMSINSTAL

             VMSINSTAL is a command procedure that installs VMS layered
             software products. The VMSINSTAL command line has the follow-
             ing format:

                      $ @SYS$UPDATE:VMSINSTAL SNA3270nnn ddcu: [OPTIONS N]

             where:

             nnn represents the major version number and the current
             maintenance update in that version.

             The first and second digits represent the major version num-
             ber, and the third digit represents the current maintenance
             update version number. For the version number of your kit,
             refer to the label on the distribution kit or the BOM. If you
             do not supply the product name and version number, VMSINSTAL
             prompts you for them.

             ddcu: represents a device name for the 3270 DS Interface
             installation media, where dd is the device code, c is the
             controller id, and u is the unit number.

             It is not necessary to use the console drive. If you do not
             supply the device name, VMSINSTAL prompts you for it. MTA0:
             is the device name used in examples in this document.

             OPTIONS N is an optional parameter you should provide if 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.

          1-8  Preparing for Installation

 






             When you install a product using VMSINSTAL, you have two
             installation options. Either you can enter the VMSINSTAL
             command line specifying the product name, version number,
             device name, and release notes option, or you can enter the
             following command:

                      $ @SYS$UPDATE:VMSINSTAL

             If you enter the preceding command, VMSINSTAL prompts you for
             the product name, version number, and device name during the
             installation. If you use this command, you do not have the
             option of displaying or printing the release notes.

          __________________________________________________________

          1.5  On-Line Release Notes

             The 3270 DS Interface installation kit provides on-line
             release notes. A prompt to display or print the release
             notes appears during the installation procedure if you
             invoke VMSINSTAL with the OPTIONS N parameter. Later,
             you can read the release notes by typing or printing
             the file SYS$HELP:SNA3270nnn.RELEASE_NOTES (for example,
             SYS$HELP:SNA3270014.RELEASE_NOTES).

             nnn represents the major version number and all maintenance
             updates in that version. The first and second digits repre-
             sent the major version number, and the third digit represents
             the maintenance update version number.










                                           Preparing for Installation  1-9

 











                                                                 Chapter 2


                                          Installing the 3270 DS Interface
          ________________________________________________________________


          This chapter describes how to install the DECnet/SNA VMS 3270
          Data Stream Programming Interface (3270 DS Interface). It con-
          tains a step-by-step description of the installation consider-
          ations. The final section contains an actual system log of an
          installation_using_PAK_information_and_VMSINSTAL._________

          2.1  Installation Procedure

          The 3270 DS Interface installation consists of a series of
          questions and informational messages; the process takes 6 to
          30_minutes_to_complete.___________________________________

          2.1.1  Running VMSINSTAL

          This section shows the script you see when you use VMSINSTAL
          to install the 3270 DS Interface software. In addition, this
          section contains explanatory text for each prompt.
             When you run VMSINSTAL, you may accept the default values by
             pressing the <RET> key. Unless it is otherwise stated, end
             every command line by pressing <RET>.

             To terminate the procedure at any time during the installa-
             tion, press <CTRL/Y>. When you press <CTRL/Y>, the installa-
             tion procedure deletes all files it has created up to that
             point and exits. To restart the installation procedure af-
             ter pressing <CTRL/Y>, invoke VMSINSTAL again. See Step 2:
             Invoking VMSINSTAL.

                                     Installing the 3270 DS Interface  2-1

 






             Enhancements to VMSINSTAL in future releases of the VMS
             operating system might result in additional prompts appearing
             during the course of the installation. Although such prompts
             might not be documented in this installation guide, the
             installation should proceed normally.

             Step 1: Log in to the system manager's account.

               Username: SYSTEM <RET>
               Password:         <RET>

             Step 2: Invoke VMSINSTAL.

               $ @SYS$UPDATE:VMSINSTAL SNA3270nnn ddcn: OPTIONS N <RET>

             Replace nnn in the product name with the version number of
             the software, for example, SNA3270014.

             Replace ddcn with the name of the device on which you plan
             to mount the media, where dd is the device name, c is the
             controller ID, and n is the unit number.

                          VAX/VMS Software Product Installation Procedure V5.1

               It is dd-mmm-yyyy at hh:mm.
               Enter a question mark (?) at any time for help.

               * Are you satisfied with the backup of your system
               disk [YES]? <RET>

             Step 3: Product installation begins.

             VMSINSTAL displays a message that the media containing the
             3270 DS Interface software has been mounted on the specified
             device and that the installation has begun.




          2-2  Installing the 3270 DS Interface

 






               Please mount the first volume of the set on MTA0:.
               * Are you ready [YES]? <RET>
               %MOUNT-I-MOUNTED, SNA3270 mounted on _MTA0:

               The following products will be processed:

                 SNA3270 Vn.n

                       Beginning installation of SNA3270 Vn.n at hh:mm

               %VMSINSTAL-I-RESTORE, Restoring product saveset A...

             n.n is automatically replaced with the version number of the
             3270 DS Interface, for example, V1.4

             Step 4: Select a release notes option.

             The following prompts appear only if you specified OPTIONS N
             in step 2.

                   Release Notes Options:

                       1.  Display release notes
                       2.  Print release notes
                       3.  Both 1 and 2
                       4.  Copy release notes to SYS$HELP
                       5.  Do not display, print or copy release notes

               * Select option [3]: <RET>

             If you select option 1, VMSINSTAL displays the release notes
             immediately on your screen. You can terminate the display at
             any time by pressing <CTRL/C>.

             If you select option 2, VMSINSTAL prompts you for a queue
             name.

               * Queue name [SYS$PRINT]: <RET>

             Either type a queue name, or press <RET> to send the file to
             the default output print device.

                                     Installing the 3270 DS Interface  2-3

 






             If you select option 3, VMSINSTAL prompts you for a queue
             name and displays the release notes.

             After the release notes are displayed or printed, the follow-
             ing prompt and message appear:

               * Do you want to continue the installation? Y<RET>
               %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully
               moved to SYS$HELP.

             To continue the installation, type Y and press <RET>. If you
             type N and press <RET> or just press <RET>, VMSINSTAL stops
             the installation.

             Step 5: Register the product with the License Management
             Facility.

             You must use the VMS License Management Facility (LMF) to
             register the product. The following text appears:

                            Product:       SNA-3270-DSPI
                            Producer:      DEC
                            Version:       Vn.n
                            Release Date:  dd-mmm-yyyy

               * Does this product have an authorization key registered and
               loaded? Y <RET>

             Check to see if this is the same information contained in
             your Product Authorization Key (PAK). Type Y or N in response
             to the question.

             If you do not register and load your authorization key, the
             product will not run. For more information on LMF, refer to
             the VMS License Management Utility Reference Manual.




          2-4  Installing the 3270 DS Interface

 






             Step 6: Select installation options.

               * Do you want to run the IVP after the installation [YES]? <RET>

             The installation verification procedure (IVP) checks whether
             the installation procedure was successful. Press <RET> to run
             the IVP after the installation. If you do not want to run the
             IVP, type N in response to the prompt.

               * Do you want to purge files replaced by this installation [YES]? <RET>

             The system disk might contain previous versions of the dis-
             tribution files. The files are replaced during installa-
             tion with new files, but the old files are not automatically
             purged. Purging is recommended. In response to the purging
             prompt, press <RET> to purge the files, or type N to keep
             them.

                                          NOTE

                 Digital recommends that you do not delete previous
                 versions of on-line release notes after receiving a
                 new release of a product.

             Step 7: Read informational message.

             The installation procedure now displays the following infor-
             mational message:

                    All questions have been asked, installation continuing ...

                    The IVP for this product, SNA3270$IVP.COM can be found in
                    the SYS$TEST directory.

                    To install the 3270 Data Stream images as shareable each
                    time the system reboots, you must add the following line
                    to your system startup procedure:

                        $ @SYS$STARTUP:SNA3270$STARTUP

                    On-line release notes for this product can be found in the file,
                        SYS$HELP:SNA3270nnn.RELEASE_NOTES

                                     Installing the 3270 DS Interface  2-5

 






               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

             Step 8: The IVP is run.

             The installation procedure calls the IVP to verify that the
             3270 DS Interface software was successfully installed. The
             system displays the following messages:

               ** DECnet/SNA VMS 3270 Data Stream Interface Vn.n Installation Test **

               ... Testing 3270 Data Stream

               ** DECnet/SNA VMS 3270 Data Stream Interface Vn.n Test Successful  **

             Step 9: End the Installation Procedure.

                 Installation of SNA3270 Vn.n completed at hh:mm

             If you typed Y in response to the prompt that requests a file
             purge, previous versions of the files are now purged.

             If the installation procedure is successful, the executable
             files are moved to their target directory.

                                          NOTE

                 The release notes file installed by VMSINSTAL has a
                 different name in each maintenance release.

                       VMSINSTAL procedure done at hh:mm

               $ LOGOUT <RET>
               SYSTEM     logged out at dd-mmm-yyyy hh:mm

             When the installation procedure is complete, you can continue
             to install more products or end the installation procedure.
             To end the procedure, press <CTRL/Z> or the <RET> key.

             VMSINSTAL deletes or changes entries in the process symbol
             tables during the installation. Therefore, to continue using
             the system manager's account and restore those symbols you
             should log out and log in again.

          2-6  Installing the 3270 DS Interface

 





          __________________________________________________________

          2.2  Postinstallation Considerations

             The installation procedure for 3270 DS Interface installs
             SNA3270SH.EXE and SNA3270MG.EXE files as shareable images.
             Section 2.2.1 lists the files added to the system.

             The 3270 DS Interface Help file can be added to an EDT Help
             file. Section 2.2.2 shows the command procedure for adding
             3270 DS Interface Help.

             Verification of the installation can be done either during
             installation through the VMSINSTAL utility or at any other
             time by running SYS$TEST:SNA3270$IVP. This command proce-
             dure verifies that the 3270 DS Interface has been installed
             correctly on your system. Section 2.2.3 shows the command
             procedure for running the IVP.

             Using the SYS$STARTUP:SNA3270$STARTUP.COM command file you
             can install the 3270 DS Interface as a shareable image.
             Section 2.2.4 shows the procedure for doing this.

             You can install the 3270 DS Interface on a VAXcluster using
             the SNA3270$STARTUP.COM command procedure. Section 2.2.5
             shows the procedure for doing this.

          __________________________________________________________

          2.2.1  Files Created During Installation

             During installation, VMSINSTAL creates the files in the
             locations shown in Table 1-2.

             Table_2-1:__Files_Created_During_Installation________________

             File_Name_____________Location_______________________________

             SNA3270SH.EXE         SYS$SHARE

                                     Installing the 3270 DS Interface  2-7

 






             Table_2-1_(Cont.):__Files_Created_During_Installation________

             File_Name_____________Location_______________________________

             SNA3270MG.EXE         SYS$MESSAGE

             SNA3270DF.BAS         SYS$LIBRARY

             SNA3270DF.FOR         SYS$LIBRARY

             SNA3270DF.H           SYS$LIBRARY

             SNA3270DF.LIB         SYS$LIBRARY

             SNA3270DF.MAR         SYS$LIBRARY

             SNA3270DF.PAS         SYS$LIBRARY

             SNA3270DF.PEN         SYS$LIBRARY

             SNA3270DF.PLI         SYS$LIBRARY

             SNA3270DF.R32         SYS$LIBRARY

             SNA3270$STARTUP.COM   SYS$STARTUP

             SNA3270$IVP.COM       SYS$TEST

             SNA3270014.RELEASE_   SYS$HELP
             NOTES________________________________________________________

             You can find help information for the 3270 DS Interface in
             the system help facility under the topic SNA_3270DS.






          2-8  Installing the 3270 DS Interface

 





          __________________________________________________________

          2.3  Adding the SNA_3270DS Help File to an EDT Help File

             The 3270 DS Interface help information that is added to
             the HELPLIB file during installation can also be inserted
             into an EDT HELP file for programmers who use EDT to develop
             DECnet/SNA applications. The following commands are used to
             perform this task:

                                          NOTE

                 You must have system manager privileges to execute the
                 following commands.

               $ LIBRARY/HELP/EXTRACT=SNA_3270DS/OUTPUT=SNA3270DS SYS$HELP:HELPLIB
               $ LIBRARY/HELP/INSERT SYS$HELP:EDTHELP SNA3270DS
               $ DELETE SNA3270DS.HLP;*

          __________________________________________________________

          2.4  Verifying the Installation of the 3270 DS Interface

               Software

             The IVP runs automatically at the end of the installation
             if you have chosen that option. You can also run the IVP
             after the installation to verify that the 3270 DS Interface
             is installed and working properly. To run the IVP after
             installation, type the following command from your terminal:

               $ @SYS$TEST:SNA3270$IVP

             If the following text appears, the software is successfully
             installed:

               ** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Installation Test **

               ... Testing 3270 Data Stream

                                     Installing the 3270 DS Interface  2-9

 






               ** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Test Successful  **

                                          NOTE

                 The IVP does not verify that the 3270 DS Interface can
                 connect to an IBM system.

             If the software was not installed properly, error messages
             are displayed. Correct the problems indicated by the messages
             and rerun the 3270 DS Interface installation procedure. If
             you receive IVP errors, you have a damaged kit; contact your
             Digital representative.

                                          NOTE

                 For information about configuring your IBM SNA soft-
                 ware for LU type 2 communications, refer to Guide to
                 IBM Parameters for your particular transport product.

             If you have not registered the 3270 DS Interface with LMF,
             the following text appears:

               ** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Installation Test **

               %LICENSE-F-NOAUTH, DEC SNA-3270-DSPI use is not authorized on this node
               -LICENSE-F-NOLICENSE, no license is active for this software product
               -LICENSE-I-SYSMGR, please see your system manager
               %Failed to test program with shareable image

               ** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Test FAILED **

             Stop the installation and register the 3270 DS Interface with
             LMF as described in Step 5.






          2-10  Installing the 3270 DS Interface

 





          __________________________________________________________

          2.5  Installing the 3270 DS Programming Interface as a Shareable

               Image

             The file, SYS$STARTUP:SNA3270$STARTUP.COM, contains the
             start-up command procedure for the 3270 DS Programming
             Interface. To install the 3270 DS Programming Interface as a
             shareable image, execute the command procedure as follows:

               $ @SYS$STARTUP:SNA3270$STARTUP.COM

             Include this command in your system start-up procedure to
             automatically install the 3270 DS Programming Interface as a
             shareable image when you boot the system.

          __________________________________________________________

          2.6  Using the 3270 DS Interface Software in a VAXcluster

             After you have installed the 3270 DS Interface software on
             one node of a VAXcluster, you can install it on the other
             nodes of the VAXcluster by executing the SNA3270$STARTUP.COM
             procedure on each node as follows:

               $ @SYS$STARTUP:SNA3270$STARTUP.COM

             You must activate a 3270 DS Interface license for each node
             in the VAXcluster that will execute and run the interface
             software. You can activate the license in one of the follow-
             ing ways:

              o Log in to each VAXcluster node, and enter the LICENSE LOAD
                command.

              o Invoke the VMS SYSMAN Utility to execute the LICENSE
                LOAD command on the desired VAXcluster nodes. See the
                VMS SYSMAN Utility Manual for details on defining your
                management environment and executing commands on other
                nodes.

             For more information on the LICENSE LOAD command, refer to
             the  VMS License Management Utility Manual.

                                    Installing the 3270 DS Interface  2-11

 





          __________________________________________________________

          2.7  Sample Installation

             This section contains a sample installation of the 3270
             DS Interface software. The installation procedure might be
             modified slightly in maintenance updates of this product.

             Unless otherwise stated, every command line ends with a
             <RET>.

               $ @sys$update:vmsinstal sna3270014 MTA0: OPTIONS N

                     VAX/VMS Software Product Installation Procedure V5.1

               It is 24-MAR-1989 at 12:18.
               Enter a question mark (?) at any time for help.

               * Are you satisfied with the backup of your system disk [YES]?

               Please mount the first volume of the set on MTA0:
               * Are you ready [YES] ?

               The following products will be processed:
                 SNA3270 V1.4

                       Beginning installation of SNA3270 V1.4 at 12:18

               %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

                   Release Notes Options:

                       1.  Display release notes
                       2.  Print release notes
                       3.  Both 1 and 2
                       4.  Copy release notes to SYS$HELP
                       5.  Do not display, print or copy release notes

               * Select option [2]:
               * Queue name [SYS$PRINT]:
               Job SNA3270014 (queue SYS$PRINT, entry 317) started on LPA0
               * Do you want to continue the installation? Y
               %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully
               moved to SYS$HELP.

          2-12  Installing the 3270 DS Interface

 






                       Product:      SNA-3270-DSPI
                       Producer:     DEC
                       Version:      V1.4
                       Release Date: 28-APR-1989

               * Does this product have an authorization key registered and loaded? Y
               * Do you want to run the IVP after the installation [YES]?
               * Do you want to purge files replaced by this installation [YES]?

                   All questions have been asked, installation continuing ...

                   The IVP for this product, SNA3270$IVP.COM, can be found in
                   the SYS$TEST directory.

                   To install the 3270 Data Stream images as shareable each
                   time the system reboots, you must add the following line
                   to your system startup procedure:

                       $ @SYS$STARTUP:SNA3270$STARTUP

                   On-line release notes for this product can be found in the file,
                       SYS$HELP:SNA3270014.RELEASE_NOTES

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

               **** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Installation Test ****

               .... Testing 3270 Data Stream

               **** DECnet/SNA VMS 3270 Data Stream Interface V1.4 Test Successful ****

                       Installation of SNA3270 V1.4 completed at 12:25

                       VMSINSTAL procedure done at 12:25





                                    Installing the 3270 DS Interface  2-13
