 

















               DECnet/SNA
               Data_Transfer_Facility________________________
               Installation (VMS)

               Order Number: AA-JM76C-TE


               June 1991

               This document describes how to install either the
               DECnet/SNA VMS Data Transfer Facility (VMS/DTF)
               server software or the DECnet/SNA VMS Data Transfer
               Facility (VMS/DTF) utilities software from a
               VMSINSTAL kit.





               Revision/Update Information:  This is a new manual.

               Operating System and Version: VMS V5.2 - V5.4

               Software Version:             DECnet/SNA VMS Data
                                             Transfer Facility
                                             V3.0

 






         ________________________
         June 1991

         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 a 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 ©1988, 1991 Digital Equipment Corporation
                            All Rights Reserved
                             Printed in U.S.A.

         The postage-prepaid Reader's Comments form on the last
         page of this document requests the user's critical
         evaluation to assist us in preparing future documentation.

         The following are trademarks of Digital Equipment
         Corporation:

         DEC           PDP           VAXcluster
         DECUS         ULTRIX        VMS
         DECnet        UNIBUS
         EDE           VAX           DIGITAL

         IBM is a registered trademark of International Business
         Machines Corporation.
         MS-DOS is a registered trademark of Microsoft Corporation.
         OS/2 is a registered trademark of Microsoft Corporation.

         This manual was produced by Telecommunications and
         Networks Publications.

 













________________________________________________________________

                                                        Contents


Preface..................................................      v


1  Preparing to Install the Software

      A Server Node or a Client Node?....................    1-1
      Installation Requirements..........................    1-2
      Inspect the Distribution Kit.......................    1-4
      Verify Required Disk Space.........................    1-4
      Verify Required Amount of Global Pages and Global
      Sections...........................................    1-5
      Register and Load the Product Authorization Key....    1-6
      Choose Locations for the DTF Directories...........    1-6
      Select UICs for the DTF Directories................    1-6
      Select a Password for the SNADTF$MGR Account
      (Server Only)......................................    1-7
      Verify That the Queue Manager Is Running...........    1-7
      Back Up Your System Disk...........................    1-7

2  Installing the Software

      The Installation Dialog............................    2-1
      Files Installed....................................   2-22
      Changes to the DECnet Databases....................   2-24

3  After Installing the Software

      Configure the VMS/DTF Software.....................    3-1
      Verify the Installation of the VMS/DTF Server
      Software...........................................    3-1
      Verify DTF for IBM with VMS/DTF....................    3-2
      Verify DTF for IBM Security Exits..................    3-2


                                                             iii

 






   Tables

         1-1       VMS/DTF Server Software Installation
                   Specifications...........................    1-2

         1-2       VMS/DTF Utilities Software Installation
                   Specifications...........................    1-3






































   iv

 











   ________________________________________________________________

                                                            Preface



         The DECnet/SNA Data Transfer Facility (DTF) software is
         a Digital Equipment Corporation product that allows you
         to transfer files between IBM MVS or VM systems in an SNA
         network and systems in a Digital network. To use the DTF
         access routine, you must first install the appropriate
         versions of the software and hardware that you plan to
         use. See the Software Product Description (SPD) for this
         information.

         The DTF access routine consists of two major parts: the
         IBM-resident software (DTF for IBM) and the Digital-
         resident software (VMS/DTF). The IBM-resident software
         can be installed on an MVS system or a VM system.

         This guide tells you how to install:

         o  VMS/DTF server software on a server node, or

         o  VMS/DTF utilities software on a client node

         To install the VMS/DTF utilities software successfully,
         you must also install the VMS/DTF server software on at
         least one server node.

   Associated Documents

         The DECnet/SNA Data Transfer Facility product documenta-
         tion consists of the following manuals:

         o   DECnet/SNA Data Transfer Facility Installation (VMS)

         o   DECnet/SNA Data Transfer Facility Management

         o   DECnet/SNA Data Transfer Facility Installation (VM)

         o   DECnet/SNA Data Transfer Facility Installation (MVS)

                                                                  v

 






         o   DECnet/SNA Data Transfer Facility Use

         o   DECnet/SNA Data Transfer Facility Problem Solving and
            Messages

         If you intend to perform field-level translation, you
         should also have the following Digital manuals available
         for reference:

         o  VAX Common Data Dictionary Summary Description

         o  VAX Common Data Dictionary User's Guide

         o  VAX Common Data Dictionary Utilities Reference

         o  VAX Common Data Dictionary Data Definition Language
            Reference

         VMS client users may also find the following Digital VMS
         manuals to be helpful:

         o  VMS General User's Guide

         o  VMS Convert and Convert/Reclaim Utility Manual

         o  VMS DATATRIEVE User's Guide

         o  VMS DCL Dictionary

         o  VMS DCL Concepts Manual

         o  VAX/VMS Record Management Services Manual

         ULTRIX client users may also find the following Digital
         DECnet-ULTRIX manual to be helpful:

         o  DECnet-ULTRIX Use

         DOS client users may also find the following PATHWORKS for
         DOS manual to be helpful:

         o  PATHWORKS for DOS DECnet User's Guide

         OS/2 client users may also find the following PATHWORKS
         for OS/2 manual to be helpful:

         o  PATHWORKS for OS/2 Utilities Guide

   vi

 






   Acronyms

         The following acronyms are used throughout this guide:

         DCL         Digital Command Language

         DTF         DECnet/SNA Data Transfer Facility access
                     routine

         IBM SNA     IBM's Systems Network Architecture

         SNADTFCFG   SNA DTF Configuration utility

         TRANSFER/DTFSNA DTF Transfer utility

         VMS/DTF     Digital-resident Data Transfer Facility
                     software

   Graphic Conventions

         The following conventions are used throughout this guide:

         Special     This special type indicates system output
         type        or user input. System output is in black type;

                     user input is in red type.

         UPPERCASE   Uppercase letters in command lines indicate
                     keywords that must be entered. You can enter
                     keywords in either uppercase or lowercase.
                     You can abbreviate command keywords to the
                     first three characters or their minimum unique
                     abbreviation.

         lowercase   Lowercase italics in command syntax or
         italics     examples indicate variables for which either
                     the user or the system supplies a value.








                                                                vii

 







         [ ]         Square brackets in command syntax statements
                     indicate that the enclosed values are
                     optional. You can enter none or one. Default
                     values apply for unspecified options. (Do not
                     type the brackets when you enter a command.)

         <Return>    Press the RETURN key. The RETURN key, which
                     you must press to execute commands, is assumed
                     in command examples and therefore is not
                     always shown in command displays.


































   viii

 









                                                                  1
   ________________________________________________________________

                                  Preparing to Install the Software



         The DECnet/SNA VMS Data Transfer Facility software
         (VMS/DTF) is divided into the following software
         installation kits:

         o  VMS/DTF server software

         o  VMS/DTF utilities software

         This chapter describes the preparations you must make
         before you install either the VMS/DTF server software or
         VMS/DTF utilities software.

   A Server Node or a Client Node?

         To use DTF to transfer data, you must install the VMS/DTF
         server software on at least one VMS node in your DECnet
         network. The VMS/DTF server software kit includes the
         VMS/DTF utilities software, so it is not necessary to
         install both the server and utilities software on the
         same node. You can also optionally install the VMS/DTF
         utilities software on additional client nodes in your
         network. The VMS/DTF utilities software lets you use
         features such as recoverable file transfer from a client
         node.

         A typical DTF site consists of multiple client nodes and a
         single server node. You can also set up your system with
         multiple client nodes attached to multiple server nodes.
         You should consider the price/performance ratio of server
         nodes to client nodes when deciding how many server and
         client nodes your site needs.

         Server nodes contain the SNA file access software
         necessary for communicating with the DTF for IBM software.
         A server node communicates with the IBM system through the
         DECnet/SNA Gateway or VMS/SNA.

                             Preparing to Install the Software  1-1

 






         Client nodes initiate file transfer requests. A client
         node can be the source or the destination of the transfer
         request. DECnet client nodes communicate with server nodes
         through DECnet. IBM client nodes communicate with the
         VMS/DTF server through a DECnet/SNA Gateway or VMS/SNA.

         After you decide how many server nodes and client nodes
         you need, you can begin to install the VMS/DTF software.

   Installation Requirements

         Before you begin to install the VMS/DTF software, you
         need to know what software, system privileges, and disk
         space are required for your installation. Table 1-1 and
         Table 1-2 list the preliminary installation requirements
         that you must satisfy before you can begin to install the
         VMS/DTF software.

   Table_1-1_VMS/DTF_Server_Software_Installation_Specifications___

   Requirements__________Specifications____________________________

   Distribution media    TK50 tape cassette distribution kit or
                         magnetic tape (1600 bpi) distribution kit

   Required software     VMS V5.2 - V5.4
                         DECnet-VAX V5.2 - V5.4

   Optional software     VAX Common Data Dictionary V3.4 or later
                         VAX DATATRIEVE V4.1 or later
                         DECnet/SNA VMS Gateway Management V2.0 or
                         later

   Privileges            System manager level

   Disk space            2400 blocks minimum during installation
                         2000 blocks minimum after installation

   Global pages          864

   Global sections       13

                                           (continued on next page)


   1-2 Preparing to Install the Software

 






   Table 1-1 (Cont.) VMS/DTF Server Software Installation
   __________________Specifications________________________________

   Requirements__________Specifications____________________________

   Estimated time to     5 to 15 minutes
   install

   Associated documents  Your processor-specific installa-
   ______________________tion/operations_guide_____________________


   Table_1-2_VMS/DTF_Utilities_Software_Installation_Specifications

   Requirements__________Specifications____________________________

   Distribution media    TK50 tape cassette distribution kit or
                         magnetic tape (1600 bpi) distribution kit

   Required software     VMS V5.2 - V5.4
                         DECnet-VAX V5.2 - V5.4

   Optional software     VAX DATATRIEVE V4.1 or later
                         DECnet/SNA VMS Gateway Management V2.0 or
                         later

   Privileges            System manager level

   Disk space            1600 blocks minimum during installation
                         950 blocks minimum after installation

   Global pages          258

   Global sections       8

   Estimated time to     5 to 15 minutes
   install

   Associated documents  Your processor-specific installa-
   ______________________tion/operations_guide_____________________





                             Preparing to Install the Software  1-3

 






   Inspect the Distribution Kit

         The software Bill of Materials (BOM) included with
         your distribution kit specifies the contents of the
         distribution kit. Carefully compare the items you received
         with the items listed in the BOM. If any components are
         missing or damaged, contact your Digital representative
         before continuing with the installation.

   Verify Required Disk Space

         Make sure that you have adequate disk space before you
         install the VMS/DTF software. You can check your available
         disk space by entering the following command:

         $ SHOW DEVICE system-disk

         where system-disk refers to the device name of the system
         disk. For more information about the SHOW DEVICE command,
         refer to the VMS DCL Dictionary.

























   1-4 Preparing to Install the Software

 






   Verify Required Amount of Global Pages and Global Sections

         Make sure that you have enough global pages and global
         sections free. If there are not enough global pages and
         global sections, the VMS/DTF software cannot be installed
         as a shareable image. You can check the number of global
         pages and global sections available by entering the
         following commands:

         $ RUN SYS$SYSTEM:SYSGEN
         SYSGEN> SHOW GBLPAGES
         SYSGEN> SHOW GBLSECTIONS

         You can then check the number of global pages and global
         sections in use by entering the following commands:

         $ INSTALL
         INSTALL> LIST/GLOBAL

         By subtracting the second set of values from the first,
         you can determine if there are enough global pages
         and global sections free for your use. If you need
         to increase the total available, you must edit the
         SYS$SYSTEM:MODPARAMS.DAT file and include the following
         lines:

         For server installation:

         ADD_GBLPAGES=864
         ADD_GBLSECTIONS=13

         For client installation:

         ADD_GBLPAGES=258
         ADD_GBLSECTIONS=8

         After modifying these values, you must run AUTOGEN by
         using the following commands:

         $ @SYS$UPDATE:AUTOGEN SAVPARAMS GENPARAMS
         $ @SYS$UPDATE:AUTOGEN SETPARAMS REBOOT

         These commands will recompute your system parameters.
         AUTOGEN will also perform an automatic shutdown and reboot
         when it is finished.

                             Preparing to Install the Software  1-5

 






   Register and Load the Product Authorization Key

         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.



   Choose Locations for the DTF Directories

         Select locations for the DTF directories. You need to
         determine which disk you want to contain the DTF work
         directories ([SNADTF] and [DTF$SERVER]). The default
         directory location, SYS$COMMON, is available to an entire
         cluster.

         The [SNADTF] directory contains the following information:

         o  All VMS/DTF databases (VMS/DTF server only)

         o  Execution queue work files

         o  Execution queue job files

         o  DTF log files

         The [DTF$SERVER] directory contains the log files for
         all IBM-initiated DTF transfer operations directed to
         nodes that don't have the VMS/DTF utilities software
         installed. In the case of IBM-initiated transfer request
         without access control information both the files and the
         log files for the transfer are placed in the DTF$SERVER
         directory.

   Select UICs for the DTF Directories

         Select user identification codes (UICs) for the DTF
         directories. You must assign unused UICs to the [SNADTF]
         and [DTF$SERVER] directories. The DTF directory UICs keep
         unauthorized users from accessing VMS/DTF databases and
         work files. The [SNADTF] directory default UIC of [55,56]
         is in the same group as the SNACSV account default UIC
         (the DECnet/SNA Gateway and VMS/SNA work directory). The
         [DTF$SERVER] directory default UIC is [54,56].

   1-6 Preparing to Install the Software

 






   Select a Password for the SNADTF$MGR Account (Server Only)

         Select a password of at least 6 characters for the
         SNADTF$MGR account. The SNADTF$MGR account is created
         by the server installation procedure and allows users on
         other nodes to access the VMS/DTF databases. This password
         ensures that only authorized users can access the VMS/DTF
         databases.


   Verify That the Queue Manager Is Running

         The installation procedure starts a VMS/DTF execution
         queue. Make sure that the queue manager is running; if
         it is not, the installation will fail. You can use the
         following command to start the queue manager:

         $ START/QUEUE/MANAGER

         For more information about the START/QUEUE/MANAGER
         command, refer to the VMS DCL Dictionary.

         When installing VMS/DTF on a node where any version of
         the product has previously been installed, you must stop
         all queues created by the previous installation of the DTF
         software. This ensures that the newly installed software
         rather than the previously installed software will handle
         the DTF queues.

   Back Up Your System Disk

         Before you start an installation that involves writing to
         your system disk, Digital Equipment Corporation recommends
         that you make a backup copy of your system disk. The
         System Manager's Manual explains how to back up your
         system disk.









                             Preparing to Install the Software  1-7

 









                                                                  2
   ________________________________________________________________

                                            Installing the Software



           ________________________Note ________________________

           If you install the VMS/DTF utilities software on
           a node that contains the VMS/DTF server software,
           the information that was added during the server
           software installation will be deleted.

           _____________________________________________________

   The Installation Dialog

         The procedure for installing files on a VMS system is
         automated. You simply answer questions displayed while
         the procedure (VMSINSTAL) runs. Most questions require a
         simple yes (Y) or no (N) answer. The VMS/DTF installation
         (whether server or utilities) should take no longer than
         15 minutes, depending on the type of medium you use. The
         estimated installation time does not include preparation
         time or problem resolution time.

         The following illustration shows how the installation
         information is presented.

         Most of the questions supply default answers which appear
         in brackets throughout the installation procedure. Press
         <Return> to accept a default answer. Press <Ctrl/Y> to
         abort the installation procedure at any time; later, you
         can restart the installation at 2.







                                       Installing the Software  2-1

 






   Username: SYSTEM   <Return>  1
   Password: password <Return>

   $ SET DEFAULT SYS$UPDATE <Return>

   $ @VMSINSTAL product-name ddcu:  [OPTIONS N] <Return>  2

           VAX/VMS Software Product Installation Procedure V5.3

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

   %VMSINSTAL-W-ACTIVE, The following processes are still active:
      JONES

   * Do you want to continue anyway [NO]? Y <Return> 3

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

   Please mount the first volume of the set on  MUA0:.
   * Are you ready? yes <Return> 5
   %MOUNT-I-MOUNTED, SNADTF mounted on _MUA0:

                      < Continued on page 2-4 >





















   2-2 Installing the Software

 






         1  Digital Equipment Corporation recommends that you
            install software from the system manager's account
            [SYSTEM] with your default device and directory set to
            SYS$UPDATE.

         2  VMSINSTAL prompts you if you do not supply the product
            and device names. If you want to be prompted for the
            product name, device name, and installation options,
            type the following:

            $ @SYS$UPDATE:VMSINSTAL <Return>

            product-name
            SNADTFU for the VMS/DTF utilities software distri-
            bution kit. SNADTFS for the VMS/DTF server software
            distribution kit.

            ddcu:
            A device name where the distribution kit for the
            VMS/DTF installation media will be mounted, where dd
            is the device, c is the controller, and u is the unit
            number. It is not necessary to use the console drive to
            install VMS/DTF. MUA0: is the device name used in this
            example.

            OPTIONS N
            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, but does copy them to SYS$HELP. VMSINSTAL also
            permits the use of several other options. For more
            information on options, see your processor-specific
            installation/operations guide.

         3  If users are logged in, you are asked whether you want
            to continue the installation. To continue, type Y
            and press <Return>. To stop the installation, press
            <Return>.

         4  Before you proceed with the installation, make sure you
            have a good backup copy. If you are satisfied with the
            backup of your system disk, press <Return>. If you do
            not have a good backup copy, type N and press <Return>
            to end the installation.

                                       Installing the Software  2-3

 






         5  This group of three lines appears only when your
            distribution medium is a tape. Mount the distribution
            kit volume on the appropriate drive. Type YES and press
            <Return> when you are ready.









































   2-4 Installing the Software

 






   The following products will be processed:

     product-name V3.0

           Beginning installation of product-name V3.0 at hh:mm

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

       Release notes included with this kit are always copied to SYS$HELP.

       Additional Release Notes Options:

       1. Display release notes
       2. Print release notes
       3. Both 1 and 2
       4. None of the above

   * Select option [2]: <Return>  6
   * Queue name [SYS$PRINT]: <Return>
   Job product-name030 (queue SYS$PRINT, entry 681) started on LPA0
   * Do you want to continue the installation [NO]? Y<Return> 7

   %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

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

           Product:      SNA-DTF-xxx 9
           Producer:     DEC
           Version:      V3.0
           Release Date: 1-JUL-1990

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

                      < Continued on page 2-6 >











                                       Installing the Software  2-5

 






         6  This step applies only if you specified OPTIONS N at 2.

            If you select option 1, VMSINSTAL displays the release
            notes. Press <Ctrl/C> to terminate the display.

            If you select option 2, VMSINSTAL prompts you for a
            queue name. Either type a queue name or press <Return>
            to send the file to the default output print device.

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

            If you select option 4, VMSINSTAL does not display or
            print the release notes.

           ________________________Note ________________________

           Printing the release notes is recommended because of
           their length.

           _____________________________________________________

            Read the release notes carefully before continuing with
            the VMSINSTAL procedure.

         7  To continue the installation, type Y and press
            <Return>. If you type N or press <Return>, VMSINSTAL
            moves the release notes to SYS$HELP and ends the
            installation.

         8  If you answer YES to this prompt, VMSINSTAL deletes
            previous versions of the distribution files.

            Press <Return> after the prompt if you want to purge
            the files replaced during installation.

         9  SNA-DTF-SVR for VMS/DTF server software; SNA-DTF-UTL
            for VMS/DTF utilities software.

         10 Use the VMS License Management Facility (LMF) to
            register the product.

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

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

   2-6 Installing the Software

 






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

   * Device to be used for the DTF directories [SYS$COMMON:]: <Return> 12

   %VMSINSTAL-I-SYSDISK, This product creates system disk directory SYS$COMMON:[SNADTF].
   * Do you want installation to delete old DTF databases [YES]?<Return> 13

                      < Continued on page 2-8 >





































                                       Installing the Software  2-7

 






         11 After you install the VMS/DTF software, you should
            verify that the software was properly installed. To
            include verification checking, press <Return>.

            The verification procedure begins later in the
            installation procedure and verifies the installation of
            the following:

            o  SNADTFCFG utility

            o  SNADTFCFG utility help files

            o  TRANSFER/DTF utility

            o  TRANSFER/DTF utility help files

            o  Default DTF queue file

            o  SNARCOPY object

            On server systems only: The verification procedure also
            verifies the modification of the File Access Listener
            (FAL) object.

         12 This prompt is displayed if you are installing VMS/DTF
            for the first time. Specify the disk on which you want
            the VMS/DTF [SNADTF] and [DTF$SERVER] directories to
            reside. The default device is SYS$COMMON. If a previous
            version of DTF is found you will receive a DIRALREXI
            error message in place of this prompt.

         13 DTF V2.0 server account, proxy, and file definition
            databases are not compatible with DTF V3.0. If the
            installation procedure finds these databases, the
            procedure automatically upgrades the databases to be
            DTF V3.0 compatible. The procedure then changes the
            extension of the old databases to be .OLD. These old
            databases are no longer needed. If you wish to delete
            the old databases, answer YES to this question.






   2-8 Installing the Software

 






   * UIC for directory SNADTF (include brackets) [[55,56]]: <Return> 14
   %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named SNADTF.15
   %UAF-I-ADDMSG, user record successfully added
   %UAF-I-RDBADDMSGU, identifier SNADTF value: [000055,000056] added to rights data
   base.
   %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named SNADTF.
   %UAF-I-MDFYMSG, user record(s) updated
   * Password for SNADTF$MGR account (6 characters minimum):       <Return> 16
   * Password verification:       <Return> 17
   %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named SNADTF$MGR. 18
   %UAF-I-ADDMSG, user record successfully added
   %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named SNADTF$MGR.
   %UAF-I-MDFYMSG, user record(s) updated

   VMSINSTAL-I-SYSDIR, This product creates system disk directory SYS$COMMON:[DTF 19
   $SERVER]
   * UIC for account DTF$SERVER (include brackets) [[54,56]]: <Return>

   %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named DTF$SERVER. 20
   %UAF-I-ADDMSG, user record successfully added
   %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DTF$SERVER.
   %UAF-I-MDFYMSG, user record(s) updated

                      < Continued on page 2-10 >





















                                       Installing the Software  2-9

 






         14 This prompt is displayed if you are installing VMS/DTF
            for the first time. Specify the user identification
            code (UIC) for the SNADTF account using the following
            standard UIC format:

            [g,u]

            where

            g   is the group number in octal. For security reasons,
                the group number should never be the same as an
                existing group number or the same as a system
                management group number (less than 10).

            u   is the user number in octal.

         15 These five lines are displayed if you are installing
            the VMS/DTF server software. If DTF is already
            installed, only the two update messages are displayed.

         16 This prompt is displayed if you are installing the
            VMS/DTF server software for the first time. Type a
            password for the SNADTF$MGR account and press <Return>;
            the password is not displayed on the screen for
            security reasons.

         17 This question is displayed to catch any typing errors
            that might have occurred when you entered the password
            for the SNADTF$MGR account. Type the password again and
            press <Return>.

         18 These 4 messages are displayed for server software
            installations only. If DTF is already installed, only
            the update message is displayed.

         19 These 2 messages are displayed for server and utilities
            software installations.

         20 These 4 messages are displayed for server and utilities
            software installations. If DTF is already installed,
            only the update message is displayed.




   2-10 Installing the Software

 






   %product-name-I-NOMORQUES, no further questions 21

       This installation has added the following files:

           [SYSHLP]SNADTF$CFG_HELP.HLB
           [SYSLIB]SNADTF$COPY.EXE
           [SYSMSG]SNADTF$MESSAGE.EXE
           [SYSHLP]SNADTF$RCOPY_HELP.HLB
           [SYSEXE]SNADTF$SYMBIONT.EXE
           [SYSEXE]SNADTFCFG.EXE
           [SYSEXE]SNARCOPY.EXE

       In addition, the following server specific files are added: 22

           [SNADTF]SNADTF$DISPATCHER.COM
           [SYSEXE]SNADTF$DISPATCHER.EXE
           [SYSEXE]SNADTF$FAL.COM
           [SYSEXE]SNADTF$FAL.EXE
           [SNADTF]SNADTF$FILE_DEFINITION.DAT
           [SNADTF]SNADTF$FILE_DEFINITION.FDL
           [SYSEXE]SNADTF$LOGIN.COM
           [SNADTF]SNADTF$PROXY.FDL
           [SNADTF]SNADTF$SERVER_ACCOUNT.DAT
           [SNADTF]SNADTF$SERVER_ACCOUNT.FDL
           [SYSTEST]SNADTF$SERVER_IVP.COM
           [SYS$STARTUP]SNADTF$STARTUP_SERVER.COM
           [SYSHLP]SNADTFS030.RELEASE_NOTES

       In addition, the following utilities specific files are added:23

           [SYSTEST]SNADTF$CLIENT_IVP.COM
           [SYS$STARTUP]SNADTF$STARTUP_CLIENT.COM
           [SYSHLP]SNADTFU030.RELEASE_NOTES

                      < Continued on page 2-12 >










                                      Installing the Software  2-11

 






         21 No more input is required. If you typed Y in response
            to the prompt at 8, previous versions of the files are
            now purged.

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

         22 These thirteen files are added if you are installing
            the VMS/DTF server software.

         23 These three files are added if you are installing the
            VMS/DTF utilities software.

































   2-12 Installing the Software

 






       This installation has defined a network task object called SNARCOPY.

       The FAL network object has been redefined to use the DTF server software. 24

       Run SYS$SYSTEM:NCP and issue the following to examine the object database:

           NCP> LIST OBJECT SNARCOPY CHARACTERISTICS
           NCP> LIST OBJECT FAL CHARACTERISTICS 25

       You must add the following line to the SYS$STARTUP:SYSTARTUP_V5.COM system
       startup procedure:

           $ @SYS$STARTUP:SNADTF$STARTUP_SERVER SYS$COMMON: [P2] [P3] [P4] -
           [P5] [P6] [P7] [P8] 26

                   where P2 is the list of SNADTF queues to be started at
                   system startup time, and P3 is a YES/NO value indicating
                   whether a generic SNADTF queue is to be started at system
                   startup time.  P4 is the list of server account names to be

                   used for server sessions by SNADTF$DISPATCHER and P5 is the

                   time interval the dispatcher is to wait before trying to
                   reconnect to the IBM host after a session disconnect. P6 is
                   the list of transfer account names to be used for transfer

                   sessions between SNADTF$FAL and DTF for IBM. P7 is YES or NO,

                   indicating whether SNADTF$DISPATCHER should send a cluster
                   alias or system-specific node name to DTF for IBM. P8 is the
                   translation table file name that will be used by
                   SNADTF$DISPATCHER for translating ASCII to EBCDIC and
                   vice versa. Please see the VMS/DTF Management manual for more
                   information and defaults used.

           $ @SYS$STARTUP:SNADTF$STARTUP_CLIENT SYS$COMMON: [P2] [P3] 27

                   where P2 is the list of SNADTF queues to be started at
                   system startup time, and P3 is a YES/NO value indicating
                   whether a generic SNADTF queue is to be started at system
                   startup time.  Please see the VMS/DTF Management manual for
                   more information.

                      < Continued on page 2-14 >

                                      Installing the Software  2-13

 






         24 This message is displayed if you are installing the
            VMS/DTF server software.

         25 This line is displayed if you are installing the
            VMS/DTF server software.

         26 This line and the following paragraph are displayed if
            you are installing the VMS/DTF server software.

         27 This line and the following paragraph are displayed if
            you are installing the VMS/DTF utilities software.


































   2-14 Installing the Software

 






       The installation process will now add the server accounts SNADTF and
       SNASERVER to the server account database. 28

   %SNADTF-I-ADDSER, server account SNADTF added 29
   %SNADTF-I-ADDSER, server account SNASERVER added
   %SNADTF-I-CREATEACC, if SNASERVER is used for file transfer, add a VMS account 30


       The installation process will now update the DTF databases to V3.0 31
       format, if necessary.

   %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
   Starting SNADTF Dispatcher; process name SNADTF$DISPATCH 32
   %RUN-S-PROC_ID, identification of created process is xxxxxxxx

                      < Continued on page 2-16 >





























                                      Installing the Software  2-15

 






         28 This sentence is displayed if you are installing the
            VMS/DTF server software for the first time.

         29 These two messages are displayed if you are installing
            the VMS/DTF server software for the first time.

         30 This message is displayed if you are installing the
            VMS/DTF server software for the first time. You can
            ignore this message because the SNASERVER account is
            used to handle IBM requests and not to transfer files.

         31 This sentence is displayed if you are installing
            the VMS/DTF server and you requested that the server
            databases be updated (see 13).

         32 These two messages are displayed if you are installing
            the VMS/DTF server software.




























   2-16 Installing the Software

 






       Running the product-name Installation Verification Procedure at hh:mm 33


      Checking NCP data base if Object FAL file is SNADTF$FAL.COM 34

   Object Volatile Summary as of dd-mmm-yyyy hh:mm:ss

      Object   Number  File/PID                   User Id          Password

     FAL           17  SYS$SYSTEM:SNADTF$FAL.COM

      Checking NCP data base if Object SNARCOPY file is SNARCOPY.EXE

   Object Volatile Summary as of dd-mmm-yyyy hh:mm:ss

      Object   Number  File/PID                   User Id          Password

     SNARCOPY       0  SYS$SYSTEM:SNARCOPY.EXE

       Testing configuration utility HELP command

     Information available:

     ADD        DISABLE    ENABLE     EXIT       HELP       MODIFY     REMOVE
     SHOW       USE_NODE

       Testing configuration utility SERVER_ACCOUNT commands

   %SNADTF-I-CREATEACC, if SNADTFIVP is used for file transfers, add a VMS account

   Server account:  SNADTFIVP
   Access Name:                PU:                            Node:
   Application:                Logon Mode:                    Session:

   Translation:     LOCAL      Null:        REJECT            Service m/c:

   File Definition:
   Gateway:

                      < Continued on page 2-18 >





                                      Installing the Software  2-17

 






         33 If you responded Y to the prompt at 11, the installa-
            tion procedure now calls the IVP to verify that the DTF
            software was successfully installed.

            If the installation procedure or IVP fails for any
            reason, the following message is displayed:

            %VMSINSTAL-E-INSFAIL, the installation of product-name V3.0
                                  has failed.

            Errors can result if any of the following conditions
            are true:

            o  Incorrect version of the VMS operating system

            o  Insufficient disk quotas

            The VMS System Manager's Manual explains error messages
            generated by these conditions.

            If you are notified that any of these conditions exist,
            you should take the action described in the message.
            You might need to change a system parameter or increase
            an authorized quota value.

            If an IVP failure causes the installation to fail,
            contact a Digital field service representative.

         34 The SNADTF$FAL section is displayed if you are running
            the VMS/DTF server IVP.















   2-18 Installing the Software

 






       Testing configuration utility FILE_DEFINITION commands

   !
   !   File definition: SNADTFIVP
   !
   BASE
       RELEASE                     NO
       SINGLE                      NO
       SPANNED                     NO
       SUPERSEDE                   NO
       TRANSLATE                   YES
       VSAM_SEQUENTIAL             NO


       Testing TRANSFER/DTF utility HELP command

   HELP

       The HELP command displays on-line documentation for the VMS/DTF
       utility.

       Format:

         HELP [keyword...]

     Additional information available:

     CANCEL     COPY       EXIT       HELP       SET        SHOW

       Testing TRANSFER/DTF  utility SHOW QUEUE command

   SNADTF queue SNADTF$QUEUE, on OSAKA::
       /BASE_PRIORITY=4 /OWNER=[SYSTEM] /PROTECTION=(S:E,O:D,G:R,W:W)

     Default INTERVAL:     0 00:30:00.00  Minimum INTERVAL:  Unspecified
     Default RETRIES:     48              Maximum RETRIES:   Unspecified
     Default TIME:         1 00:00:00.00  Maximum TIME:      Unspecified

       product-name Installation Verification Procedure completed successfully.
           Installation of product-name V3.0 completed at hh:mm

           VMSINSTAL procedure done at hh:mm



                                      Installing the Software  2-19

 






   $ LOGOUT  35

   SYSTEM     logged out at dd-mmm-yyyy hh:mm










































   2-20 Installing the Software

 






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








































                                      Installing the Software  2-21

 






   Files Installed

         All files are installed in SYS$COMMON.

         VMSINSTAL installs the following files on both VMS/DTF
         server nodes and VMS/DTF client nodes:

         o  [SYSHLP]:SNADTF$CFG_HELP.HLB
                 SNADTFCFG help library

         o  [SYSLIB]:SNADTF$COPY.EXE
                 VMS/DTF shareable library

         o  [SYSMSG]:SNADTF$MESSAGE.EXE
                 VMS/DTF error message file

         o  [SYSHLP]:SNADTF$RCOPY_HELP.HLB
                 TRANSFER/DTF help library

         o  [SYSEXE]:SNADTF$SYMBIONT.EXE
                 Symbiont for VMS/DTF queues

         o  [SYSEXE]:SNADTFCFG.EXE
                 SNADTFCFG utility

         o  [SYSEXE]:SNARCOPY.EXE
                 TRANSFER/DTF utility

           ________________________Note ________________________

           The DCL tables found in SYS$LIBRARY:DCLTABLES.EXE
           are updated during installation.

           _____________________________________________________

         VMSINSTAL installs the following additional files on your
         VMS/DTF server node:

         o  [SYS$STARTUP]:SNADTF$STARTUP_SERVER.COM
                 Command procedure executed at system startup

         o  [SNADTF]:SNADTF$DISPATCHER.COM
                 Dispatcher startup file

         o  [SYSEXE]:SNADTF$DISPATCHER.EXE
                 IBM command dispatcher

         o  [SYSEXE]:SNADTF$FAL.COM
                 Command file for FAL object

   2-22 Installing the Software

 






         o  [SYSEXE]:SNADTF$FAL.EXE
                 File Access Listener (FAL)

         o  [SNADTF]:SNADTF$FILE_DEFINITION.DAT
                 File definition database

         o  [SNADTF]:SNADTF$FILE_DEFINITION.FDL
                 RMS file definition for the file definition
            database

         o  [SYSEXE]:SNADTF$LOGIN.COM
                 Login command file used by VMS/DTF server accounts

         o  [SNADTF]:SNADTF$PROXY.FDL
                 RMS file definition for proxy database

         o  [SNADTF]:SNADTF$SERVER_ACCOUNT.DAT
                 Server account database

         o  [SNADTF]:SNADTF$SERVER_ACCOUNT.FDL
                 RMS file definition for the server account
            database

         o  [SYSTEST]:SNADTF$SERVER_IVP.COM
                 Server verification procedure

         o  [SYSHLP]:SNADTFS030.RELEASE_NOTES
                 Release notes

         VMSINSTAL installs the following additional files on your
         VMS/DTF client node:

         o  [SYSTEST]:SNADTF$CLIENT_IVP.COM
                 Utilities verification procedure

         o  [SYS$STARTUP]:SNADTF$STARTUP_CLIENT.COM
                 Command procedure executed at system startup

         o  [SYSHLP]:SNADTFU030.RELEASE_NOTES
                 Release notes





                                      Installing the Software  2-23

 






   Changes to the DECnet Databases

         The following changes are made to the DECnet databases as
         a result of installing the VMS/DTF software:

         1. For VMS/DTF server software only, the File Access
            Listener (FAL) object is modified in both the DECnet
            permanent database and the DECnet volatile database.

         2. The SNARCOPY object is defined in both the DECnet
            permanent database and the DECnet volatile database.

           ________________________Note ________________________

           If you have altered the FAL on your VMS/DTF server
           node, you must add the alterations to the FAL
           installed with the VMS/DTF server software.

           _____________________________________________________


























   2-24 Installing the Software

 









                                                                  3
   ________________________________________________________________

                                      After Installing the Software



         This chapter describes the tasks you should do after you
         install the VMS/DTF software on the system.

   Configure the VMS/DTF Software

         After you have successfully installed the VMS/DTF software
         and before you can begin transferring files, you must
         configure VMS/DTF. To configure VMS/DTF, do the following
         tasks:

         1. Server Only: Set up the server account database.

         2. Server Only: Authorize access to server accounts.

         3. Server Only: Optionally, set up the proxy database.

         4. Server Only: Optionally, set up the file definition
            database.

         5. Edit the SYS$MANAGER:SYSTARTUP_V5.COM system startup
            procedure to include @SYS$STARTUP:SNADTF$STARTUP_SERVER
            or @SYS$STARTUP:SNADTF$STARTUP_CLIENT. Optionally,
            add startup parameters to control the DTF operating
            environment.

         Refer to  DECnet/SNA Data Transfer Facility Management for
         information on configuring and managing VMS/DTF.

   Verify the Installation of the VMS/DTF Server Software

         The installation verification procedure (IVP) runs
         automatically at the end of the installation if you have
         chosen that option. You can run the IVP at any time by
         executing the following command:

         For Server Nodes:

         $ @SYSTEST:SNADTF$SERVER_IVP.COM

                                 After Installing the Software  3-1

 






         For Client Nodes:

         $ @SYSTEST:SNADTF$CLIENT_IVP.COM

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

           ________________________Note ________________________

           The IVP does not verify whether the VMS/DTF server
           software can communicate with an IBM system.

           _____________________________________________________

   Verify DTF for IBM with VMS/DTF

         After the VMS/DTF and DTF for IBM software has been
         installed and configured, use the VMS/DTF software to
         see if DTF for IBM can perform the following functions:

         o  Create and delete a non-VSAM file.

         o  Copy to and from a non-VSAM file.

         o  Create and delete a VSAM file.

         o  Copy to and from a VSAM file.

         If you cannot perform these functions, see the  DECnet/SNA
         Data Transfer Facility Use.

   Verify DTF for IBM Security Exits

         Verify DTF for IBM security exits by using the DCL
         commands supported by DTF in the manner described in the
         following paragraphs.

         You should test the following cases using the DIRECTORY
         command:

         o  An invalid user ID

         o  A valid user ID with an invalid password

         o  A valid user ID with an expired password

   3-2 After Installing the Software

 






         You should test the following case using the DELETE
         command:

         o  A valid user ID and password but no authorization to
            delete

         You should test the following case using the CREATE
         command:

         o  A valid user ID and password but no authorization to
            create

         You should test the following case using the TYPE command:

         o  A valid user ID and password but no authorization to
            read

         You should test the following case using the OPEN and
         WRITE commands:

         o  A valid user ID and password but no authorization to
            write

         You should test the following case using the COPY command:

         o  A valid user ID and password but no authorization to
            update

         On VM systems, you may wish to test the following
         additional cases:

         o  An invalid owner ID

         o  A valid owner ID with an invalid minidisk password

         o  A valid owner ID and password but not authorized for
            delete, create, read, write, and update








                                 After Installing the Software  3-3
