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