DECnet/SNA VMS Remote Job Entry Installation AA-NF48A-TE This document describes how to install the DECnet/SNA VMS Remote Job Entry software. Revision/Update Information: This is a new manual. Operating System and Version: VMS V5.0 or later Software Version: DECnet/SNA VMS Remote Job Entry Version 1.4 Digital Equipment Corporation ________________________ June 1989 __________ The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. __________ Copyright © 1989 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. __________ The postpaid READER'S COMMENTS form on the last page of this document requests the user's critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DEC DIBOL UNIBUS DEC/CMS EduSystem VAX DEC/MMS IAS VAXcluster DECnet MASSBUS VMS DECsystem-10 PDP VT DECSYSTEM-20 PDT DECUS RSTS DECwriter RSX DIGITAL This document was prepared using VAX DOCUMENT, Version 1.1 Contents ________________________________________________________________ __________________________________________________________ PREFACE v ________________________________________________________________ CHAPTER 1 INSTALLATION 1-1 1.1 RUNNING THE VMSINSTAL PROCEDURE 1-3 1.1.1 Logging In to the System Manager's Account 1-4 1.1.2 Making a Backup Copy of the System Disk 1-5 1.1.3 Mounting the Distribution Kit Volume 1-6 1.1.4 Confirming Your License 1-7 1.1.5 Purging the Distribution Files 1-8 1.2 RUNNING THE INSTALLATION VERIFICATION PROCEDURE 1-9 1.3 LOCATING FILES AFTER INSTALLATION 1-12 1.4 VERIFYING INSTALLATION OF THE RJE SOFTWARE 1-14 ________________________________________________________________ INDEX Index-1 iii ________________________________________________________________ TABLES 1-1 Installation Specifications for VMS RJE Software 1-1 1-2 Location of RJE Files After Installation 1-13 iv Preface ________________________________________________________________ __________________________________________________________ Objective of this Manual This manual provides the information you need to install the DECnet/SNA VMS Remote Job Entry access routine software. __________________________________________________________ Intended Audience This manual assumes that you have user-level knowledge of the VMS operating system. __________________________________________________________ Structure of this Manual This manual contains a brief explanation of how to install the DECnet/SNA VMS Remote Job Entry access routine software. __________________________________________________________ Associated Documents o VMS/SNA Installation o VMS/SNA Management o VMS/SNA Problem Solving o DECnet/SNA VMS Remote Job Entry Problem Solving v o DECnet/SNA VMS Remote Job Entry Use o DECnet/SNA Gateway Installation Guide o DECnet/SNA Gateway Problem Determination Guide o DECnet/SNA Gateway Guide to IBM Parameters o Guide to DECnet/SNA VMS Gateway Management for DECSA o DECnet/SNA Gateway-ST Installation Guide o DECnet/SNA Gateway-ST Problem Determination Guide o DECnet/SNA Gateway-ST Guide to IBM Parameters o DECnet/SNA Gateway-CT Installation Guide o DECnet/SNA Gateway-CT Problem Determination Guide o DECnet/SNA Gateway-CT Guide to IBM Parameters o DECnet/SNA VMS Gateway Management Installation Guide o DECnet/SNA VMS Gateway Management Guide o VMS Network Control Program Manual o VMS Networking Manual __________________________________________________________ Acronyms The following acronyms appear throughout this manual: DCL Digital Command Language RJE Remote Job Entry RJS Remote Job Server SNA IBM's Systems Network Architecture VMS Virtual Memory System vi __________________________________________________________ Graphic Conventions The following graphic conventions apply throughout this manual: _____________________________________________________________ Convention Meaning ------------------------------------------------------------- $ The dollar sign prompt precedes a command line for a VMS system. SNARJE> The SNARJE angle bracket prompt indicates that you should use the SNARJE command language. monospaced type Monospaced type indicates system input and output. System output is in black; user input is in red. Red type Red type indicates user-entered commands or responses. UPPERCASE Uppercase letters indicate that you must enter the characters exactly as shown. You can abbreviate command keywords to the first unique characters. lowercase italics Lowercase italic type indicates variables in command lines. You must specify these variables. This symbol indicates the RETURN key on the keyboard. Unless otherwise specified, terminate every command line by pressing the RETURN key. vii _____________________________________________________________ Convention Meaning ------------------------------------------------------------- This symbol indicates a control charac- ter; x is an alphabetic character. Press the CONTROL key and the alphabetic key simultaneously. dd-mmm-yyyy This is the required VMS format for spec- ifying a date, as in 21-Apr-1989. See the DCL Dictionary for further information. hh:mm:ss[.cc] This is the required VMS format for specifying a time, as in 09:44:23.49. [.cc] represents hundredths of a second. These often appear in system messages, but you need not supply them when you are specifying a time. See the DCL Dictionary for further information. -------------------------------------------------------------- All numbers are decimal unless otherwise noted. viii Chapter 1 Installation ________________________________________________________________ This manual refers to the base communications software as the "Gateway." Unless otherwise stated, the term "Gateway" applies to any or all of the following: o VMS/SNA o DECnet/SNA Gateway o DECnet/SNA Gateway-CT o DECnet/SNA Gateway-ST Before you begin to install the DECnet/SNA VMS Remote Job Entry software, you need to know what software, system priv- ileges, and disk space are required for your installation. The following table lists the preliminary requirements for installing the RJE software. Table 1-1: Installation Specifications for VMS RJE Software ------------------------------------------------------------ Software VMS V5.0 or 5.1 Privileges System manager level Disk space 2200 blocks minimum during installation 1000 blocks minimum after installation Installation 1-1 Table 1-1 (Cont.): Installation Specifications for VMS RJE Software ------------------------------------------------------------- Approximate 6 to 30 minutes, depending on the time distribution media required for installation Associated The VMS software installation guide for documents your particular processor (contains general installation information. _____________________________________________________________ 1-2 Installation In addition, the following VMS classes are required for full functionality of DECnet/SNA VMS Remote Job Entry: o VMS Required Saveset o Network Support o Secure User's Environment The installation process consists of five major tasks. You must complete each installation task before you begin the next task. 1. Ensure that you have adequate disk space before you begin to install RJE. 2. Check to make sure that you have a complete distribution kit. Each RJE distribution kit consists of one or more volume(s) of software and a set of documentation. 3. Log in to the system manager's account, and execute the VMSINSTAL installation procedure. 4. After you exit from the VMSINSTAL procedure, locate the RJE files on your system. 5. Verify the successful installation of the RJE software. __________________________________________________________ 1.1 Running the VMSINSTAL Procedure The VMSINSTAL procedure allows you to install files onto your VMS system from the distribution kit. VMSINSTAL is automated and requires little input from you beyond responding to prompts displayed on your screen. Most of the prompts require only a YES (Y) or NO (N) response. Default answers to prompts are displayed within brackets, as shown in the following example: [YES]: To select the default answer, press . Installation 1-3 __________________________________________________________ 1.1.1 Logging In to the System Manager's Account To begin the VMSINSTAL procedure you must log in to the system manager's account and enter a command, as in the following example, to install the distribution kit on your VMS host: $ @SYS$UPDATE:VMSINSTAL SNARJE dduu: where o dduu: identifies the device on which the distribution kit is mounted. o SNARJE is the name of the distribution kit for the DECnet/SNA VMS RJE software. The VMSINSTAL sample shown in this manual describes a simple installation. Your installation might include additional prompts, depending on your configuration and whether you have other products already installed. For a full description of the VMSINSTAL procedure, refer to the VMS System Manager's Manual. After you log in to the system manager's account and load the volume(s) from your distribution kit, VMSINSTAL displays the following text: VMS Software Product Installation Procedure It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. Next, VMSINSTAL shows you the status of your current active processes and asks you if you want to continue with the installation. 1-4 Installation %VMSINSTAL-W-ACTIVE, The following processes are still active: SMISERVER BATCH_601 SERVER_002C _RTA3: * Do you want to continue anyway [NO]? If you continue with the installation procedure, the active processes might be affected, depending upon the utilities these processes are using. If you answer with the default NO, VMSINSTAL terminates. A YES answer causes VMSINSTAL to continue. __________________________________________________________ 1.1.2 Making a Backup Copy of the System Disk The VMSINSTAL procedure then prompts you as follows: * Are you satisfied with the backup of your system disk [YES]? Make sure that you have a backup copy of your system disk before you proceed with an installation that writes to your system disk. Having a backup copy is important because your disk could be corrupted during installation. If you do not have a backup copy of your system disk, en- ter N, and VMSINSTAL stops to allow you to create one. For instructions on how to back up a system disk, see the VMS Backup Utility Manual. After you have created a backup copy, start the VMSINSTAL procedure again. If you already have a backup copy of your system disk, press to continue the installation without interruption. Installation 1-5 __________________________________________________________ 1.1.3 Mounting the Distribution Kit Volume Next, VMSINSTAL tells you to mount the distribution kit volume on the the device you specified when you began the procedure. It then asks if you are ready to continue with the installation, as follows: Please mount the first volume of the set on dduu * Are you ready? NOTE VMSINSTAL is a universal installation procedure, and you can use it to install products with more than one volume in the distribution kit. When you are in- stalling a product that contains only one volume in the kit, like RJE, the procedure still asks you to mount "the first volume" but does not prompt you to mount any additional volumes. After you have mounted the distribution kit volume, answer YES to the question * Are you ready?. VMSINSTAL responds with a message verifying that you mounted the volume correctly and the installation is continuing, as follows: %MOUNT-I-MOUNTED, SNARJE mounted on dduu: The following products will be processed: SNARJE V1.4 Beginning installation of SNARJE V1.4 at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A ... %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. 1-6 Installation __________________________________________________________ 1.1.4 Confirming Your License During the installation of the RJE software, the VMSINSTAL procedure asks you to confirm that you registered your Product Authorization Key (PAK) and are licensed to run RJE. Product: SNA-RJE Producer: DEC Version: V1.4 Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded? If you answer YES, VMSINSTAL continues with the installation. If you answer NO, VMSINSTAL displays the following message: DECnet/SNA Remote Job Entry requires you to register your Product Authorization Key (PAK). You should have received the PAK with your kit. Register your PAK with... $ @sys$update:vmslicense after the installation completes. The product will not function until this is done. As the example indicates, if you have not registered your PAK, the installation will complete successfully, but you will not be able to run RJE. You can use the product only after registering your PAK. Installation 1-7 __________________________________________________________ 1.1.5 Purging the Distribution Files This installation creates new distribution files on your system. The VMSINSTAL procedure next asks if you want to delete the existing versions (if any) of these files that are superseded by the new files. * Do you want to purge files replaced by this installation [YES]? If this is your first RJE software installation, you will have no files to purge. Type NO and press . To delete the old files, answer with the default YES; VMSINSTAL auto- matically deletes the old files. At this point, VMSINSTAL describes the Installation Verification Procedure (IVP). The system message appears as follows: You can verify the SNA-RJE installation using the IVP. This is recommended, and will help ensure that the installation has completed correctly by: o Removing or renaming the V1.3 files, only if they exist. o Stopping the V1.3 processes, only if they exist. o Verifying the existence of the V1.4 files. o Initializing the V1.4 processes. o Verifying inter-process communication. Once the installation is complete, you can execute the IVP by using the command: $ @sys$test:snarje$ivp.com NOTE: Do NOT execute the IVP unless you have a PAK registered for SNA-RJE V1.4. The IVP will not complete successfully due to the RJE components failing their license check. 1-8 Installation Then the installation completes, and the following messages appear: All installation questions have been asked. No more input from the terminal will be required. Your DECnet/SNA VMS RJE V1.4 installation is nearing completion. Remember to use.. $ @sys$startup:snarje$startup to start the detached processes. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Installation of SNARJE V1.4 completed at hh:mm The procedure then prompts you for the next product you wish to install. If you have another product to install, enter the product name and respond to the prompts as they appear. Consult the installation manual for that product for further information. If you have no further products to install, press , and VMSINSTAL terminates with a confirmation message as follows: Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at hh:mm __________________________________________________________ 1.2 Running the Installation Verification Procedure To run the Installation Verification Procedure (IVP), enter the following command at the DCL prompt: @SYS$TEST:SNARJE$IVP.COM Installation 1-9 The following message appears: Starting RJE Installation Verification Procedure (IVP) This procedure will first check for the existence of V1.3 processes and files. This will take a moment. If the IVP finds files from Version 1.3 of RJE in your system directories, the procedure informs you that it has found these files. It then asks if you want to delete them. You currently have DECnet/SNA VMS Remote Job Entry V1.3 files in your system directories. The naming convention for V1.4 has been updated, and the older files should either be DELETED, or RENAMED. * Delete the outdated files [Y/N]: To delete the outdated files, answer YES. VMSINSTAL deletes the files and sends you confirming messages, as in the fol- lowing example: The following outdated files are being DELETED. %DELETE-I-FILDEL, SYS$COMMON:[SYSEXE]SNAREADER.EXE;7 deleted (60 blocks) To keep the outdated files, answer NO. The outdated files will appear in the system directories with the designation "_V13" appended to the file name. Next, VMSINSTAL begins to initialize the RJE Version 1.4 processes, as in the following example: Now the V1.4 processes will be initialized, using @sys$startup:snarje$startup.com Creating detached process - SNARJE$MPX %RUN-S-PROC_ID, identification of created process is 24600957 Creating detached process - SNARJE$SERVER %RUN-S-PROC_ID, identification of created process is 24600958 1-10 Installation The process initialization may take a few moments. The IVP will wait until both processes are fully declared, and will then proceed. When initialization of the Version 1.4 process is complete, the IVP creates a workstation and automatically executes a series of RJE commands to verify that RJE is correctly installed. The following is an example of normal IVP output: A workstation will now be created and some very basic tests will be performed. This workstation will make use of the VMS based RJE Server. SNARJE> show workstation Workstations on 12-APR-1989 17:24:31.32 Current IVP_TEST SNARJE> assign [] pr1 SNARJE> assign snarje$reader rd1 SNARJE> show status Status of workstation IVP_TEST on 12-APR-1989 17:24:43.95 Server node: MOUSSY State: OFF Access name: IVP_A Application: Circuit: Logon mode: Stream PR1 (Translate) Assigned: _MOUSSY::VMI$ROOT:[SYSUPD.SNARJE014] Current: none Stream RD1 Queue: SNARJE$READER Current: none SNARJE> show counters Counters for workstation IVP_TEST on 12-APR-1989 17:24:51.19 24 Seconds since last zeroed 0 Maximum active files 0 Resource errors 0 Records read 0 Records written 0 Files accessed 0 File open errors Installation 1-11 0 File read errors 0 File write errors 0 File close errors 0 Stream aborts 0 SNA protocol errors Stream PR1 0 Records written 0 Records written (active file) 0 Files accessed 0 File open errors 0 File write errors 0 File close errors 0 Stream aborts 0 SNA protocol errors Stream RD1 0 Records read 0 Records read (active file) 0 Files accessed 0 File open errors 0 File read errors 0 File close errors 0 Stream aborts 0 SNA protocol errors SNA RJE workstation IVP_TEST terminated on 12-APR-1989 17:24:58.48 The SNARJE$IVP has completed successfully. This IVP has tested out connections to the MPX and SERVER, but to ensure the correctness of the RJE system, please see DECnet/SNA VMS Remote Job Entry Installation and SUBMIT/SNA a test JCL. __________________________________________________________ 1.3 Locating Files After Installation After you run the VMSINSTAL procedure, you can find the RJE files in the following locations on your system: 1-12 Installation -------------------------------------------------------------- Table_1-2: Location of RJE Files After Installation -------------------------------------------------------------- File Name Location Description -------------------------------------------------------------- SNARJE.EXE SYS$SYSTEM RJE operator utility SNARJE$MPX.EXE SYS$SYSTEM RJE control program SNARJE$SERVER.EXE SYS$SYSTEM RJE server SNARJE$RDR.EXE SYS$SYSTEM RJE reader stream processor SNASUBMIT.EXE SYS$SYSTEM RJE submit command processor SNARJE$RJEMSG.EXE SYS$MESSAGE RJE message file SNARJE$RJSMSG.EXE SYS$MESSAGE RJS message file SNARJE.HLB SYS$HELP RJE HELP library SNARJE$STARTUP.COM SYS$STARTUP RJE initialization command procedure SNARJE014.RELEASE_ SYS$HELP RJE release notes NOTES SNARJE$MPX.COM SYS$STARTUP called in by SNARJE$STARTUP.COM SNARJE$SERVER.COM SYS$STARTUP called in by SNARJE$STARTUP.COM SNARJE$RJESYMBOL.COM SYS$LIBRARY RJE error symbols SNARJE$RJSSYMBOL.COM SYS$LIBRARY RJS error symbols Installation 1-13 Table_1-2_(Cont.): Location of RJE Files After Installation ---------------------------------------------------------------- File_Name Location Description ---------------------------------------------------------------- SNARJE$IVP.COM SYS$TEST RJE installation verifica- tion procedure ---------------------------------------------------------------- When you install RJE, VMSINSTAL automatically creates an RJE server, SNARJE$SERVER.EXE., on your VMS system. If your Gateway resources are limited because your Gateway is sup- porting multiple tasks, you can try to increase throughput by running RJE through the RJE server on your VMS system. NOTE HELP information for the DECnet/SNA RJE has been added to the SYS$HELP:HELPLIB.HLB library. __________________________________________________________ 1.4 Verifying Installation of the RJE Software After you have installed the DECnet/SNA VMS RJE software, you should verify that it can communicate with the appropriate IBM application subsystem. You should be able to verify communication provided the following conditions exist: o All other components in your configuration are properly installed. o You have a link from your system to the IBM host. This section provides sample procedures for accessing an IBM Job Entry Subsystem by using two commonly available IBM utilities: JES2 and JES3. If you need more information about any command variables used in the following samples, see DECnet/SNA VMS Remote Job Entry Use. To verify that you 1-14 Installation have successfully installed the DECnet/SNA VMS RJE software, complete the following steps: 1. Run the SNARJE$STARTUP.COM file. 2. Verify that the RJE software is installed on your system and that all other necessary components are installed and running. 3. Set up your terminal by entering the following VMS com- mand: $ SET TERMINAL/BROADCAST 4. Enter the following commands to invoke RJE and to identify the workstation: $ RUN SYS$SYSTEM:SNARJE SNARJE> USE workstation-name where workstation-name is a one- to eight-character name you assign to the workstation you are creating. 5. Configure or set up the workstation using the following sequence of commands: SNARJE> SET WORKSTATION/GATEWAY=gateway-node-name SNARJE> SET WORKSTATION/ACCESS=access-name/DATA=logon-data SNARJE> SET MONITOR 6. Assign the default queue SNARJE$READER to the reader stream: SNARJE> ASSIGN SNARJE$READER RD1 7. Configure a print stream: SNARJE> ASSIGN disk:[directory] PR1 8. Set the workstation ON: SNARJE> SET WORKSTATION/STATE=ON Installation 1-15 Setting the workstation ON enables messages from the IBM host to be displayed on your screen. 9. Enter interactive console mode: SNARJE> SET CONSOLE 10. TypeIBM RJE console commands to send data to your ter- minal. For example, for JES2 type the following command: $DU,JES workstation where JES workstation is a valid JES workstation designa- tion. For JES3, type the following command: I,Q,N=ALL These commands cause JES2 or JES3 to display data on your screen. 11. Press to return to SNARJE. Then type EXIT to return to DCL. At this point your RJE software is installed correctly. 1-16 Installation Index __________________________________________________________ ___________________________ A Default queue, 1-15 ___________________________ Deleting old files, 1-8 Active processes, 1-4 Digital Command Language, ASSIGN command, 1-15 vi Authorization to run RJE, Displaying data, 1-16 1-7 Distribution files, 1-8 ___________________________ purging, 1-8 B Distribution kit ___________________________ installing, 1-4 Backing up system disk, Distribution kit volume, 1-5 1-6 ___________________________ ___________________________ C E ___________________________ ___________________________ Configuring a workstation, Exiting from RJE, 1-16 1-15 ___________________________ Console G commands, 1-16 ___________________________ mode, 1-16 Gateway, 1-1 ___________________________ -CT, 1-1 D DECnet/SNA, 1-1 ___________________________ -ST, 1-1 DCL, vi ___________________________ DCL commands H RUN SYS$SYSTEM:SNARJE, ___________________________ 1-15 HELP information, 1-14 SET TERMINAL/BROADCAST, 1-15 DECnet/SNA Gateway, 1-1 DECnet/SNA Gateway-CT, 1-1 DECnet/SNA Gateway-ST, 1-1 Default answers, 1-3 Index-1 ___________________________ ___________________________ I R ___________________________ ___________________________ Initialization of process, Reader stream, 1-15 1-11 Remote Job Entry, vi Installation Remote Job Server, vi process, 1-3 RJE, vi requirements, 1-1 RJE commands verifying, 1-14 ASSIGN, 1-15 Installing other products, SET CONSOLE, 1-16 1-9 SET MONITOR, 1-15 Interactive mode, 1-16 SET WORKSTATION/ACCESS, ___________________________ 1-15 J SET WORKSTATION/GATEWAY, ___________________________ 1-15 JES2, 1-15 SET WORKSTATION/STATE=ON, JES3, 1-15 1-15 ___________________________ USE, 1-15 L RJE files, 1-12 ___________________________ RJE server on VMS system, License, 1-7 1-14 Link, 1-14 RJS, vi Locating RJE files, 1-12 RUN SYS$SYSTEM:SNARJE ___________________________ M command, 1-15 ___________________________ ___________________________ Mounting distribution kit S volume, 1-6 ___________________________ ___________________________ SET CONSOLE command, 1-16 P SET MONITOR command, 1-15 ___________________________ SET TERMINAL/BROADCAST PAK, 1-7 command, 1-15 Print stream, 1-15 SET WORKSTATION/ACCESS Process initialization, command, 1-15 1-11 SET WORKSTATION/GATEWAY Product Authorization Key, command, 1-15 1-7 SET WORKSTATION/STATE=ON Purging distribution files, command, 1-15 1-8 SNA, vi Purging files, 1-8 System disk backup, 1-5 System manager account, 1-4 privileges, 1-1 2-Index Systems Network Virtual Memory System, vi Architecture, vi VMS, vi ___________________________ VMS/SNA, 1-1 U VMSINSTAL, 1-3 ___________________________ sample text, 1-4 USE command, 1-15 ___________________________ ___________________________ W V ___________________________ ___________________________ Workstation, 1-11 Verifying installation, configuring, 1-15 1-14 setting ON, 1-15 Index-3