 




















                                   VAX[] INTOUCH[]

                                  and STANDALONE UTILITIES












                          This document contains PROPRIETARY and
                          CONFIDENTIAL information and such information
                          may not be disclosed to others for any
                          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



               ____________________
               VAX is a registered trademark of Digital Equipment

                Corporation.
               INTOUCH is a registered trademark of Touch Technologies,

                Inc.

 





























































               ii

 

                  Touch Technologies, Inc. (TTI) has prepared this publication
                  for use by TTI personnel, licensees, and customers. This
                  information is protected by copyright. No part of this document
                  may be photocopied, reproduced or translated to another
                  language without prior written consent of Touch Technologies
                  Incorporated.

                  TTI believes the information described in this publication
                  is accurate and reliable; much care has been taken in its
                  preparation. However, no responsibility, financial or
                  otherwise, is accepted for any consequences arising out of
                  the use of this material.

                  The information contained herein is subject to change without
                  notice and should not be construed as a commitment by Touch
                  Technologies, Inc.

                  The following are trademarks of Touch Technologies, Inc., and
                  may be used only to describe products of Touch Technologies,
                  Inc.:

                  DYNAMIC TAPE ACCELERATOR      INTOUCH      REMOTE TAPE FACILITY

                  DYNAMIC LOAD BALANCER PLUS      FRAGMENTATION CONTROLLER      REMOTE DEVICE FACILITY

                  The following are trademarks of System Management Software,
                  Inc., and may be used only to describe products of System
                  Management Software, Inc.:

                  RMS Expert

                  The following are trademarks of Digital Equipment Corporation,
                  and may be used only to describe products of Digital Equipment
                  Corporation:

                  DBMS   DCL   DECNET   RDB   RMS   VAX   VMS
















                     ________________________
                  Last revision date 14-Feb-1994



                  __________
                  Copyright 1992, 1994 Touch Technologies, Inc.

 









                   __________________________________________________________________

                   Contents

                         ____________________________________________________________
                         PREFACE                                                   iv

                   __________________________________________________________________
                   CHAPTER 1  VMS REQUIREMENTS                                    1-1

                         ____________________________________________________________
                         1.1   VMS REQUIREMENTS                                   1-1

                         ____________________________________________________________
                         1.2   AUTHORIZE                                          1-1

                         ____________________________________________________________
                         1.3   SYSGEN                                             1-2


                   __________________________________________________________________
                   CHAPTER 2  INSTALLING INTOUCH ON YOUR VAX                      2-1

                         ____________________________________________________________
                         2.1   INSTRUCTIONS                                       2-1


                   __________________________________________________________________
                   APPENDIX A  AN INSTALLATION EXAMPLE                            A-1


                   __________________________________________________________________
                   INDEX


                   __________________________________________________________________
                   EXAMPLES

                         2-1   INTOUCH Demonstration System Menu  ____________    2-3

                         A-1   Benchmarking  _________________________________    A-2

                   __________________________________________________________________
                   TABLES

                         1-1   Authorize Quotas  _____________________________    1-1

                         1-2   Minimum SYSGEN Parameter Values  ______________    1-2






                                                                                  iii

 







               __________________________________________________________________

               Preface

                  INTOUCH

                  INTOUCH is the Next Generation Language for VAX computers.
                  It allows you to develop complex applications rapidly and
                  accurately. The power of INTOUCH comes from its integrated
                  database access and development environment.

                  Purpose

                  The purpose of this booklet is to provide instructions for
                  installing INTOUCH on your VAX computer.

                  This booklet also should be used to install INTOUCH Standalone
                  Utilities, e.g., Guided Query Language.

                  Audience

                  This manual is intended for use by the system manager or other
                  technical personnel.




                       IF THE APPROPRIATE PERSONNEL ARE NOT AVAILABLE, OR
                       YOU HAVE QUESTIONS ABOUT INSTALLING INTOUCH, PLEASE
                       CALL TOUCH TECHNOLOGIES, INC. AT:

                       1-800-525-2527 toll free within the U.S. and Canada
                       1-619-455-7404 elsewhere





















               iv

 








               __________________________________________________________________

       1       VMS REQUIREMENTS




               __________________________________________________________________

       1.1     VMS REQUIREMENTS

                  Listed below are the VMS requirements:

                  o  VMS Version

                       VMS version 4.5 or greater

               __________________________________________________________________

       1.2     AUTHORIZE

                  o  The following AUTHORIZE quotas and limits must be increased
                     to these minimum values:

                  Table_1-1_Authorize_Quotas_____________________________________

                  Quota/Limit________Minimum_Value_______________________________

                  BYTLM (byte        90000
                  limit)

                  PGFLQUO            50000

                  PRCLM (subprocess  1
                  limit)_________________________________________________________

                  If INTOUCH is run from another product, such as ALL-IN-1, or
                  through a menu, the subprocess quota must be two or greater.

                  Failure to make these changes will cause the following INTOUCH
                  features to malfunction:

                       o  EDIT

                       o  DCL pass-through

                       o  The PASS statement






                                                                              1-1

 


               VMS REQUIREMENTS




               __________________________________________________________________

       1.3     SYSGEN

                  The following SYSGEN parameters must be increased to these
                  minimum values:

                  Table_1-2_Minimum_SYSGEN_Parameter_Values______________________

                  Parameter__________Minimum_Value_______________________________

                  RMS_GBLBUFQUO      16384

                  GBLPAGFIL          16384

                  GBLPAGES           50000

                  GBLSECTIONS        800

                  PQL_MENQLM         600

                  LOCKIDTBL          4000

                  LOCKIDTBL_MAX      16000

                  RESHASHTBL         2500

                  MAXBUF             2400

                  PROCSECTCNT________128_________________________________________

                  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

                           ____________________ Note ____________________

                           INTOUCH/COMPILE image names will have the
                           extension .INT_IMG for VAX systems and .INT_
                           IMG_AXP for AXP (ALPHA) systems.











               1-2

 








               __________________________________________________________________

       2       INSTALLING INTOUCH ON YOUR VAX



                  INTOUCH can be installed on any VAX computer running under VMS
                  version 4.5 or greater. The following items are included with
                  this installation package:

                       o  An INTOUCH distribution tape

                       o  The "Installation Instructions"

                       o  INTOUCH reference manuals

               __________________________________________________________________

       2.1     Instructions

                  To install INTOUCH on your VAX computer, you will need to work
                  from a DEC VT100 or compatible terminal. Follow the steps
                  listed below. You should type the commands shown. The VAX
                  system is space conscious, so be sure to type the commands
                  exactly as shown.

                       1  Log onto the system account

                                  Username:   SYSTEM
                                  Password:

                       2  Create the INTOUCH directory:

                                  $ CREATE/DIRECTORY SYS$SYSDEVICE:[INTOUCH]



                       3  Enter the INTOUCH directory:

                                  $ SET DEFAULT SYS$SYSDEVICE:[INTOUCH]


                       4  Verify you are in the new directory. You should
                          see the message No files found.









                                                                              2-1

 


               INSTALLING INTOUCH ON YOUR VAX





                                  $ DIR
                                    No files found.


                       5  Put the INTOUCH distribution tape on your
                          computer's tape drive.


                       6  Make the tape drive available.

                                  $ MOUNT MSA0:/FOREIGN
                                    Volume is write locked
                                    INTOUCH mounted on _MSA0:

                            "MSA0" may have to be replaced with the
                            appropriate identifier for your system.


                       7  Backup the distribution tape-transfer INTOUCH to
                          disk.

                                  $ BACKUP/LOG MSA0:*.* *.*/NEW_VERSION


                            The backup will take about 5 minutes. As
                            INTOUCH is transferred to disk, you will see
                            a list of the files being transferred.


                       8  Build INTOUCH utilities:

                                  $ @INTOUCH_BUILD

                       9  Activate INTOUCH by executing the following
                          command:

                                  $ @INTOUCH


                      10  Add the above command to your system-wide login
                          command procedure. This will cause INTOUCH to be
                          available to other users when they log in.


                      11  INTOUCH has now been installed on your computer.
                          Verify this by typing the command "INTOUCH_DEMO"
                          at the VAX system prompt.






               2-2

 


                                                   INSTALLING INTOUCH ON YOUR VAX





                                  $ INTOUCH_DEMO


                            The INTOUCH Demonstration System menu should
                            appear on your screen:

                  Example 2-1 INTOUCH Demonstration System Menu
                  __________________________________________________________

                   INTOUCH Demo 3.0-2      INTOUCH Demonstration System               07-Feb-1994
                   MAIN                      Touch Technologies, Inc.                    Level: 1

                  Procedures
                    OVERVIEW     INTOUCH overview
                    BENCHMARK    Benchmark Procedures
                    FUNCTION     INTOUCH Functionality
                    SOURCE       Print Source Code for Demo Procedures

                  Miscellaneous
                    VMS          VMS Facilities
                    MAIL         VMS Mail

                  Item? ____________

                                             Type  HELP  for assistance
                  EXIT = Exit                                                \ = Back  HELP = Help


                  __________________________________________________________


                      12  If you are new to INTOUCH, we encourage you to try
                          each of the INTOUCH DEMO menu items. The BENCHMARK
                          item is especially impressive. It shows that
                          INTOUCH is truly "faster than ALL other OpenVMS
                          languages" when doing I/O operations!

















                                                                              2-3

 








               __________________________________________________________________

       A       AN INSTALLATION EXAMPLE



                  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


























                                                                              A-1

 


               AN INSTALLATION EXAMPLE




                  Example A-1 Benchmarking
                  _______________________________________________________________

                   INTOUCH Demo 3.0-2      INTOUCH Demonstration System               07-Feb-1994
                   MAIN                      Touch Technologies, Inc.                    Level: 1

                  Procedures
                    OVERVIEW     INTOUCH overview
                    BENCHMARK    Benchmark Procedures
                    FUNCTION     INTOUCH Functionality
                    SOURCE       Print Source Code for Demo Procedures

                  Miscellaneous
                    VMS          VMS Facilities
                    MAIL         VMS Mail

                  Item? benchmark___

                                             Type  HELP  for assistance
                  EXIT = Exit                                                \ = Back  HELP = Help


                  _______________________________________________________________































               A-2

 









                   _________________________________________________________________

                   Index

                   _______________________________
                   A                                 Install instructionso2-1
                   _______________________________   INTOUCH
                   AUTHORIZE                           Installation exampleoA-1
                     Quotaso1-1                        installingo2-1
                                                       Install instructionso2-1

                   _______________________________   _______________________________

                   I                                 S
                   _______________________________   _______________________________
                   Installation exampleoA-1          SYSGEN
                   Installation packageo2-1            Parameterso1-2
                     Guide to the INTOUCH Language
                       documento2-1                  _______________________________
                     Installation instructionso      V
                       2-1                           _______________________________
                     INTOUCH tapeo2-1                VMS Requirementso1-1
                     Release noteso2-1               VMS REQUIREMENTSo1-1
                     Software Performance Report     VMS Versiono1-1
                       formso2-1





























                                                                             Index-1
