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 documentI may be photocopied, reproduced or translated to anotherN 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 itsG preparation. However, no responsibility, financial orL otherwise, is accepted for any consequences arising out of+ the use of this material.O The information contained herein is subject to change withoutM notice and should not be construed as a commitment by Touch$ Technologies, Inc.O The following are trademarks of Touch Technologies, Inc., andN may be used only to describe products of Touch Technologies, Inc.:Q DYNAMIC TAPE ACCELERATOR INTOUCH REMOTE TAPE FACILITYf DYNAMIC LOAD BALANCER PLUS FRAGMENTATION CONTROLLER REMOTE DEVICE FACILITYM The following are trademarks of System Management Software,K Inc., and may be used only to describe products of System, Management Software, Inc.: RMS ExpertP 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 __________________________________________________________________ ContentsU ____________________________________________________________U PREFACE ivU __________________________________________________________________U CHAPTER 1 VMS REQUIREMENTS 1-1U ____________________________________________________________U 1.1 VMS REQUIREMENTS 1-1U ____________________________________________________________U 1.2 AUTHORIZE 1-1U ____________________________________________________________U 1.3 SYSGEN 1-2U __________________________________________________________________U CHAPTER 2 INSTALLING INTOUCH ON YOUR VAX 2-1U ____________________________________________________________U 2.1 INSTRUCTIONS 2-1U __________________________________________________________________U APPENDIX A AN INSTALLATION EXAMPLE A-1U __________________________________________________________________ INDEXU __________________________________________________________________ EXAMPLESU 2-1 INTOUCH Demonstration System Menu ____________ 2-3U A-1 Benchmarking _________________________________ A-2U __________________________________________________________________ TABLESU 1-1 Authorize Quotas _____________________________ 1-1U 1-2 Minimum SYSGEN Parameter Values ______________ 1-2U iii  Q __________________________________________________________________ Preface INTOUCHL INTOUCH is the Next Generation Language for VAX computers.K It allows you to develop complex applications rapidly andL accurately. The power of INTOUCH comes from its integrated> database access and development environment. PurposeL 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. AudienceP This manual is intended for use by the system manager or other& technical personnel.I IF THE APPROPRIATE PERSONNEL ARE NOT AVAILABLE, ORJ 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 REQUIREMENTSQ __________________________________________________________________ 1.1 VMS REQUIREMENTS8 Listed below are the VMS requirements: o VMS Version1 VMS version 4.5 or greaterQ __________________________________________________________________ 1.2 AUTHORIZEP 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 statementQ 1-1   VMS REQUIREMENTSQ __________________________________________________________________ 1.3 SYSGENL 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 2400Q 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 imagesI ____________________ 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 VAXP 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 tape9 o The "Installation Instructions"3 o INTOUCH reference manualsQ __________________________________________________________________ 2.1 InstructionsP To install INTOUCH on your VAX computer, you will need to workK from a DEC VT100 or compatible terminal. Follow the stepsK listed below. You should type the commands shown. The VAXL system is space conscious, so be sure to type the commands# exactly as shown.5 1 Log onto the system account4 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 should9 see the message No files found.Q 2-1  - INSTALLING INTOUCH ON YOUR VAX' $ DIR3 No files found.C 5 Put the INTOUCH distribution tape on your0 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 theC appropriate identifier for your system.J 7 Backup the distribution tape-transfer INTOUCH to disk.G $ BACKUP/LOG MSA0:*.* *.*/NEW_VERSIOND 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_BUILDE 9 Activate INTOUCH by executing the following" command:, $ @INTOUCHI 10 Add the above command to your system-wide loginJ 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 VAX0 $ INTOUCH_DEMOH The INTOUCH Demonstration System menu should2 appear on your screen:? Example 2-1 INTOUCH Demonstration System MenuL __________________________________________________________a INTOUCH Demo 3.0-2 INTOUCH Demonstration System 07-Feb-1994a MAIN Touch Technologies, Inc. Level: 1 Procedures1 OVERVIEW INTOUCH overview5 BENCHMARK Benchmark Procedures6 FUNCTION INTOUCH FunctionalityF SOURCE Print Source Code for Demo Procedures Miscellaneous/ VMS VMS Facilities) MAIL VMS Mail$ Item? ____________G Type HELP for assistanceb EXIT = Exit \ = Back HELP = HelpL __________________________________________________________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 EXAMPLEQ 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_DEMOQ A-1  & AN INSTALLATION EXAMPLE* Example A-1 BenchmarkingQ _______________________________________________________________a INTOUCH Demo 3.0-2 INTOUCH Demonstration System 07-Feb-1994a MAIN Touch Technologies, Inc. Level: 1 Procedures1 OVERVIEW INTOUCH overview5 BENCHMARK Benchmark Procedures6 FUNCTION INTOUCH FunctionalityF SOURCE Print Source Code for Demo Procedures Miscellaneous/ VMS VMS Facilities) MAIL VMS Mail$ Item? benchmark___G Type HELP for assistanceb EXIT = Exit \ = Back HELP = HelpQ _______________________________________________________________ A-2  T _________________________________________________________________ Index2 _______________________________M A Install instructionso2-1< _______________________________ INTOUCHO AUTHORIZE Installation exampleoA-1E Quotaso1-1 installingo2-1O Install instructionso2-1T _______________________________ _______________________________6 I ST _______________________________ _______________________________; Installation exampleoA-1 SYSGENE Installation packageo2-1 Parameterso1-22 Guide to the INTOUCH LanguageT documento2-1 _______________________________6 Installation instructionso VT 2-1 _______________________________I INTOUCH tapeo2-1 VMS Requirementso1-1I Release noteso2-1 VMS REQUIREMENTSo1-1D Software Performance Report VMS Versiono1-1 formso2-1T Index-1