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. Unless otherwise specified, every command line is terminated by pressing . Control characters are shown as s, where x is an alphabetic char- acter. Press 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 . 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 key. Unless it is otherwise stated, end every command line by pressing . To terminate the procedure at any time during the installa- tion, press . When you press , the installa- tion procedure deletes all files it has created up to that point and exits. To restart the installation procedure af- ter pressing , 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 Password: Step 2: Invoke VMSINSTAL. $ @SYS$UPDATE:VMSINSTAL SNA3270nnn ddcn: OPTIONS N 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]? 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]? %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]: If you select option 1, VMSINSTAL displays the release notes immediately on your screen. You can terminate the display at any time by pressing . If you select option 2, VMSINSTAL prompts you for a queue name. * Queue name [SYS$PRINT]: Either type a queue name, or press 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 %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. To continue the installation, type Y and press . If you type N and press or just press , 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 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]? The installation verification procedure (IVP) checks whether the installation procedure was successful. Press 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]? 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 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 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 or the 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 . $ @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