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.) 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 to accept a default answer. Press to abort the installation procedure at any time; later, you can restart the installation at 2. Installing the Software 2-1 Username: SYSTEM 1 Password: password $ SET DEFAULT SYS$UPDATE $ @VMSINSTAL product-name ddcu: [OPTIONS N] 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 3 * Are you satisfied with the backup of your system disk [YES]? 4 Please mount the first volume of the set on MUA0:. * Are you ready? yes 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 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 . To stop the installation, press . 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 . If you do not have a good backup copy, type N and press 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 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]: 6 * Queue name [SYS$PRINT]: Job product-name030 (queue SYS$PRINT, entry 681) started on LPA0 * Do you want to continue the installation [NO]? Y 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]? 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 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 to terminate the display. If you select option 2, VMSINSTAL prompts you for a queue name. Either type a queue name or press 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 . If you type N or press , 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 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]? 11 * Device to be used for the DTF directories [SYS$COMMON:]: 12 %VMSINSTAL-I-SYSDISK, This product creates system disk directory SYS$COMMON:[SNADTF]. * Do you want installation to delete old DTF databases [YES]? 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 . 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]]: 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): 16 * Password verification: 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]]: %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 ; 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 . 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