                                           4                                    VAX[] INTOUCH[]  :                                   and STANDALONE UTILITIES                        @                           This document contains PROPRIETARY andG                           CONFIDENTIAL information and such information @                           may not be disclosed to others for anyG                           purpose without written permission from Touch ,                           Technologies, Inc.              =                                      Touch Technologies, Inc. @                                    9988 Hibert Street, Suite 310?                                     San Diego, California 92131 ;                                        Phone (800) 525-2527 :                                         FAX (619) 566-3663      #                ____________________ B                VAX is a registered trademark of Digital Equipment                   Corporation.H                INTOUCH is a registered trademark of Touch Technologies,                   Inc.                                                                                                                                               ii        N                   Touch Technologies, Inc. (TTI) has prepared this publicationJ                   for use by TTI personnel, licensees, and customers. ThisQ                   information is protected by copyright. No part of this document I                   may be photocopied, reproduced or translated to another N                   language without prior written consent of Touch Technologies                   Incorporated.   L                   TTI believes the information described in this publicationK                   is accurate and reliable; much care has been taken in its G                   preparation. However, no responsibility, financial or L                   otherwise, is accepted for any consequences arising out of+                   the use of this material.   O                   The information contained herein is subject to change without M                   notice and should not be construed as a commitment by Touch $                   Technologies, Inc.  O                   The following are trademarks of Touch Technologies, Inc., and N                   may be used only to describe products of Touch Technologies,                   Inc.:   Q                   DYNAMIC TAPE ACCELERATOR      INTOUCH      REMOTE TAPE FACILITY   f                   DYNAMIC LOAD BALANCER PLUS      FRAGMENTATION CONTROLLER      REMOTE DEVICE FACILITY  M                   The following are trademarks of System Management Software, K                   Inc., and may be used only to describe products of System ,                   Management Software, Inc.:                     RMS Expert  P                   The following are trademarks of Digital Equipment Corporation,P                   and may be used only to describe products of Digital Equipment                   Corporation:  =                   DBMS   DCL   DECNET   RDB   RMS   VAX   VMS                                 -                      ________________________ 0                   Last revision date 14-Feb-1994                         __________@                   Copyright 1992, 1994 Touch Technologies, Inc.                       U                    __________________________________________________________________                       Contents   U                          ____________________________________________________________ U                          PREFACE                                                   iv   U                    __________________________________________________________________ U                    CHAPTER 1  VMS REQUIREMENTS                                    1-1   U                          ____________________________________________________________ U                          1.1   VMS REQUIREMENTS                                   1-1   U                          ____________________________________________________________ U                          1.2   AUTHORIZE                                          1-1   U                          ____________________________________________________________ U                          1.3   SYSGEN                                             1-2     U                    __________________________________________________________________ U                    CHAPTER 2  INSTALLING INTOUCH ON YOUR VAX                      2-1   U                          ____________________________________________________________ U                          2.1   INSTRUCTIONS                                       2-1     U                    __________________________________________________________________ U                    APPENDIX A  AN INSTALLATION EXAMPLE                            A-1     U                    __________________________________________________________________                     INDEX    U                    __________________________________________________________________                     EXAMPLES   U                          2-1   INTOUCH Demonstration System Menu  ____________    2-3   U                          A-1   Benchmarking  _________________________________    A-2   U                    __________________________________________________________________                     TABLES   U                          1-1   Authorize Quotas  _____________________________    1-1   U                          1-2   Minimum SYSGEN Parameter Values  ______________    1-2             U                                                                                   iii                    Q                __________________________________________________________________                   Preface                     INTOUCH   L                   INTOUCH is the Next Generation Language for VAX computers.K                   It allows you to develop complex applications rapidly and L                   accurately. The power of INTOUCH comes from its integrated>                   database access and development environment.                     Purpose   L                   The purpose of this booklet is to provide instructions for:                   installing INTOUCH on your VAX computer.  P                   This booklet also should be used to install INTOUCH Standalone9                   Utilities, e.g., Guided Query Language.                      Audience  P                   This manual is intended for use by the system manager or other&                   technical personnel.        I                        IF THE APPROPRIATE PERSONNEL ARE NOT AVAILABLE, OR J                        YOU HAVE QUESTIONS ABOUT INSTALLING INTOUCH, PLEASE8                        CALL TOUCH TECHNOLOGIES, INC. AT:  J                        1-800-525-2527 toll free within the U.S. and Canada/                        1-619-455-7404 elsewhere                                                           iv                      Q                __________________________________________________________________           1       VMS REQUIREMENTS         Q                __________________________________________________________________           1.1     VMS REQUIREMENTS   8                   Listed below are the VMS requirements:                      o  VMS Version  1                        VMS version 4.5 or greater   Q                __________________________________________________________________           1.2     AUTHORIZE  P                   o  The following AUTHORIZE quotas and limits must be increased-                      to these minimum values:   Q                   Table_1-1_Authorize_Quotas_____________________________________   Q                   Quota/Limit________Minimum_Value_______________________________   *                   BYTLM (byte        90000                   limit)  *                   PGFLQUO            50000  &                   PRCLM (subprocess  1Q                   limit)_________________________________________________________   N                   If INTOUCH is run from another product, such as ALL-IN-1, orN                   through a menu, the subprocess quota must be two or greater.  P                   Failure to make these changes will cause the following INTOUCH*                   features to malfunction:                          o  EDIT  *                        o  DCL pass-through  ,                        o  The PASS statement            Q                                                                               1-1                          VMS REQUIREMENTS         Q                __________________________________________________________________           1.3     SYSGEN   L                   The following SYSGEN parameters must be increased to these!                   minimum values:   Q                   Table_1-2_Minimum_SYSGEN_Parameter_Values______________________   Q                   Parameter__________Minimum_Value_______________________________   *                   RMS_GBLBUFQUO      16384  *                   GBLPAGFIL          16384  *                   GBLPAGES           50000  (                   GBLSECTIONS        800  (                   PQL_MENQLM         600  )                   LOCKIDTBL          4000   *                   LOCKIDTBL_MAX      16000  )                   RESHASHTBL         2500   )                   MAXBUF             2400   Q                   PROCSECTCNT________128_________________________________________   O                   Failure to make these changes may cause the following INTOUCH *                   features to malfunction:  @                        o  OPEN statement when opening many files  <                        o  /COMPILE to create compiled images  I                            ____________________ Note ____________________   D                            INTOUCH/COMPILE image names will have theG                            extension .INT_IMG for VAX systems and .INT_ ;                            IMG_AXP for AXP (ALPHA) systems.                                       1-2                     Q                __________________________________________________________________   -        2       INSTALLING INTOUCH ON YOUR VAX       P                   INTOUCH can be installed on any VAX computer running under VMSO                   version 4.5 or greater. The following items are included with ,                   this installation package:  6                        o  An INTOUCH distribution tape  9                        o  The "Installation Instructions"   3                        o  INTOUCH reference manuals   Q                __________________________________________________________________           2.1     Instructions   P                   To install INTOUCH on your VAX computer, you will need to workK                   from a DEC VT100 or compatible terminal. Follow the steps K                   listed below. You should type the commands shown. The VAX L                   system is space conscious, so be sure to type the commands#                   exactly as shown.   5                        1  Log onto the system account   4                                   Username:   SYSTEM+                                   Password:   7                        2  Create the INTOUCH directory:   L                                   $ CREATE/DIRECTORY SYS$SYSDEVICE:[INTOUCH]      6                        3  Enter the INTOUCH directory:  G                                   $ SET DEFAULT SYS$SYSDEVICE:[INTOUCH]     I                        4  Verify you are in the new directory. You should 9                           see the message No files found.                   Q                                                                               2-1          -                INSTALLING INTOUCH ON YOUR VAX           '                                   $ DIR 3                                     No files found.     C                        5  Put the INTOUCH distribution tape on your 0                           computer's tape drive.    8                        6  Make the tape drive available.  7                                   $ MOUNT MSA0:/FOREIGN :                                     Volume is write locked=                                     INTOUCH mounted on _MSA0:   C                             "MSA0" may have to be replaced with the C                             appropriate identifier for your system.     J                        7  Backup the distribution tape-transfer INTOUCH to                           disk.   G                                   $ BACKUP/LOG MSA0:*.* *.*/NEW_VERSION     D                             The backup will take about 5 minutes. AsH                             INTOUCH is transferred to disk, you will seeB                             a list of the files being transferred.    2                        8  Build INTOUCH utilities:  2                                   $ @INTOUCH_BUILD  E                        9  Activate INTOUCH by executing the following "                           command:  ,                                   $ @INTOUCH    I                       10  Add the above command to your system-wide login J                           command procedure. This will cause INTOUCH to beD                           available to other users when they log in.    J                       11  INTOUCH has now been installed on your computer.J                           Verify this by typing the command "INTOUCH_DEMO"3                           at the VAX system prompt.                             2-2         Q                                                    INSTALLING INTOUCH ON YOUR VAX           0                                   $ INTOUCH_DEMO    H                             The INTOUCH Demonstration System menu should2                             appear on your screen:  ?                   Example 2-1 INTOUCH Demonstration System Menu L                   __________________________________________________________  a                    INTOUCH Demo 3.0-2      INTOUCH Demonstration System               07-Feb-1994 a                    MAIN                      Touch Technologies, Inc.                    Level: 1                      Procedures1                     OVERVIEW     INTOUCH overview 5                     BENCHMARK    Benchmark Procedures 6                     FUNCTION     INTOUCH FunctionalityF                     SOURCE       Print Source Code for Demo Procedures                     Miscellaneous /                     VMS          VMS Facilities )                     MAIL         VMS Mail   $                   Item? ____________  G                                              Type  HELP  for assistance b                   EXIT = Exit                                                \ = Back  HELP = Help    L                   __________________________________________________________    L                       12  If you are new to INTOUCH, we encourage you to tryL                           each of the INTOUCH DEMO menu items. The BENCHMARKF                           item is especially impressive. It shows thatI                           INTOUCH is truly "faster than ALL other OpenVMS ?                           languages" when doing I/O operations!                                   Q                                                                               2-3                      Q                __________________________________________________________________   &        A       AN INSTALLATION EXAMPLE      Q                   The following is an example of the installation of INTOUCH on a &                   VAX computer system:  &                      Username:  SYSTEM                      Password:  ?                      $ CREATE/DIRECTORY SYS$SYSDEVICE:[INTOUCH] :                      $ SET DEFAULT SYS$SYSDEVICE:[INTOUCH]                      $ DIR'                         No files found. *                      $ MOUNT MSA0:/FOREIGN+                      Volume is write locked .                      INTOUCH mounted on _MSA0:  :                      $ BACKUP/LOG MSA0:*.* *.*/NEW_VERSION                              .                              .                              .                      $ @INTOUCH   #                      $ INTOUCH_DEMO                                                     Q                                                                               A-1          &                AN INSTALLATION EXAMPLE        *                   Example A-1 BenchmarkingQ                   _______________________________________________________________   a                    INTOUCH Demo 3.0-2      INTOUCH Demonstration System               07-Feb-1994 a                    MAIN                      Touch Technologies, Inc.                    Level: 1                      Procedures1                     OVERVIEW     INTOUCH overview 5                     BENCHMARK    Benchmark Procedures 6                     FUNCTION     INTOUCH FunctionalityF                     SOURCE       Print Source Code for Demo Procedures                     Miscellaneous /                     VMS          VMS Facilities )                     MAIL         VMS Mail   $                   Item? benchmark___  G                                              Type  HELP  for assistance b                   EXIT = Exit                                                \ = Back  HELP = Help    Q                   _______________________________________________________________                                                                               A-2                       T                    _________________________________________________________________                      Index  2                    _______________________________M                    A                                 Install instructionso2-1 <                    _______________________________   INTOUCHO                    AUTHORIZE                           Installation exampleoA-1 E                      Quotaso1-1                        installingo2-1 O                                                        Install instructionso2-1   T                    _______________________________   _______________________________  6                    I                                 ST                    _______________________________   _______________________________;                    Installation exampleoA-1          SYSGEN E                    Installation packageo2-1            Parameterso1-2 2                      Guide to the INTOUCH LanguageT                        documento2-1                  _______________________________6                      Installation instructionso      VT                        2-1                           _______________________________I                      INTOUCH tapeo2-1                VMS Requirementso1-1 I                      Release noteso2-1               VMS REQUIREMENTSo1-1 D                      Software Performance Report     VMS Versiono1-1                         formso2-1                                                          T                                                                              Index-1