Page 3 - Contents; ix
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Part I Using the Software Products Library CD 1 Before Installing TP Desktop Connector from the Software Products Library CD 1.1 Overview of the Software Products Library Ins...
Page 5 - Stopping the ACMS System and Gateway
7 Installing the TP Desktop Connector Client Services on Non-Windows Systems 7.1 Overview of the Client Services Installation . . . . . . . . . . . . . . . . 7–1 7.1.1 Software Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7–2 7.1.2 Disk Space . . . . . . . . . . . . . . ...
Page 9 - Preface; Intended Audience; This document is intended for:; Related Software; Compaq TP Desktop Connector for ACMSxp
Preface This guide presents information about installing the Compaq TP DesktopConnector software on desktop platforms, and the TP Desktop ConnectorGateway for ACMS software on OpenVMS platforms. Intended Audience This document is intended for: • System managers responsible for Compaq ACMS transactio...
Page 10 - Related Documents; Describes the installation of ACMS software on OpenVMS systems.
Related Documents Installation instructions for the ACMSxp version of TPware software appearsin the following manual: • Compaq TP Desktop Connector for ACMSxp Installation Guide The following manuals contain information about building client applicationswith TP Desktop Connector products: • Compaq T...
Page 11 - Structure
Finally, the Compaq TP Desktop Connector Release Notes contain informa-tion about new features and current restrictions for TP Desktop Connectorsoftware. In your Web browser, open the dskcon_release_notes.htm file in the intel32 directory on the TPware Product Suite CD. On the OpenVMS Software Produ...
Page 12 - Conventions; This manual uses the following conventions:
Component Description Part III: Installing the Gateway Software Chapter 8 Explains how to prepare your OpenVMS system for installing TPDesktop Connector gateway for ACMS software. Chapter 9 Describes how to install the TP Desktop Connector gateway forACMS software and sample server-side applications...
Page 13 - courier; user input; node
Convention Description courier This font indicates a command, programming language, or anobject on your screen. user input In examples, letters that you actually type are highlighted inboldface type. node In syntax format and examples, italic type indicates variables,parameters, or arguments. You ne...
Page 15 - Part I; Using the Software Products Library CD; After Installing from the Software Products Library CD
Part I Using the Software Products Library CD Part I describes how to install Compaq TP Desktop Connector and Compaq TPDesktop Connector Gateway for ACMS software from the OpenVMS SoftwareProducts Library compact disk. Part I presents the following major topics: • Before Installing TP Desktop Connec...
Page 17 - Overview of the Software Products Library Installation
1 Before Installing TP Desktop Connector from the Software Products Library CD This chapter discusses the preparations and requirements necessary forinstalling Compaq TP Desktop Connector and Compaq TP Desktop ConnectorGateway for ACMS software on an OpenVMS system from the SoftwareProducts Library ...
Page 18 - Software and Hardware Prerequisites
You install the client software by starting with a VMSINSTAL commandon an OpenVMS system. This places on the OpenVMS system the clientsoftware in the form of self-extracting archive files. The next steps dependon your target desktop platform. The use of the Software Products Library CD and VMSINSTAL...
Page 19 - Table 1–1 TP Desktop Connector Disk Space Requirements; SHOW DEVICE SYS$SYSDEVICE; In the output column under the heading; Free Blocks; is the number of 512-byte; Installation Procedure Requirements
In addition, installing TP Desktop Connector software requires a certainamount of free storage space. Table 1–1 summarizes the storage requirementsfor TP Desktop Connector during and after installation. Table 1–1 TP Desktop Connector Disk Space Requirements Blocks DuringInstallation Blocks AfterInst...
Page 21 - Installing the TP Desktop Connector Gateway for ACMS
2 Installing TP Desktop Connector from the Software Products Library CD This chapter explains how to install Compaq TP Desktop Connector andCompaq TP Desktop Connector gateway for ACMS from the Software ProductsLibrary CD. Table 2–1 shows the contents of the TP Desktop Connectordirectory on the Soft...
Page 22 - Installing the Client Kit; Example 2–1 shows the output from a sample installation.; Example 2–1 Sample Client Installation; OpenVMS VAX Software Product Installation Procedure V6.2
After you locate the product saveset, follow the instructions for VMSINSTAL inChapter 9. 2.2 Installing the Client Kit To install the client kit on the OpenVMS system, while logged in under theSYSTEM account at the DCL prompt, type a command in the following format: $ @SYS$UPDATE:VMSINSTAL TPW032 de...
Page 25 - After Installing the Gateway Software
3 After Installing from the Software Products Library CD This chapter describes the procedures, on both the OpenVMS system wherethe gateway kit was installed and on your target desktop system, that arerequired for server-side and client-side applications to run and communicate. 3.1 After Installing ...
Page 26 - Table 3–1 Contents of ACMSDI$NONVMS_CLIENTS
3.2.1 Editing Startup Files If TP Desktop Connector Gateway for ACMS is already installed on the samesystem, edit the gateway startup file, SYS$STARTUP:ACMSDI$STARTUP.COM.Remove the comment character ( ! ) from the following logical name definitionsfor the client directories: $! The next three logic...
Page 27 - ftp; nodename; binary; setup; program and Section 6.2 on setting up an
3.2.2.1 Transferring Client Files to a Windows System To place the client files on a Windows system, transfer the appropriate archivefile from the ACMSDI$NONVMS_CLIENTS directory on the OpenVMS system.For example: 1. Use a network file transfer utility such as FTP to copy from the OpenVMSsystem the ...
Page 28 - The archive expands into two; tar; files. To continue installation and setup, see
3.2.2.2 Transferring Client Files to a Tru64 UNIX System To place the client files on a Tru64 UNIX system, transfer the appropriatearchive file from the ACMSDI$NONVMS_CLIENTS directory on the OpenVMSsystem. For example: 1. Use a network file transfer utility such as FTP to copy from the OpenVMSsyste...
Page 29 - To build the sample application, follow these steps:
3.2.3 Installing the Client Services Interface on OpenVMS Systems The client services library is preconfigured for DECnet network access. Tobuild applications that use TCP/IP as a transport, you must reconfigure thelibrary before creating executable programs. The following steps are necessary to set...
Page 30 - Note; Run the application by entering the following command:; Setting Up the Avertz ACMS Sample Application on an; Run the command procedure to set up the application:
If you download TP Desktop Connector libraries to a different location, editthe makefile to indicate the new location of the libraries. Note On OpenVMS Alpha systems, the makefile expects the logicalACMSDI$VMS_ALPHA to point to the directory that contains theTP Desktop Connector client library. In a...
Page 31 - Multiversion; Modify the linker options files:
$ @ACMSDI$EXAMPLES_AVERTZ:VR_DA_RUNTIME_SETUP ... $ 2. Start the ACMS system (if necessary) and the application: $ ACMS/START SYSTEM $ ACMS/START APPLICATION VR_DA_APPL 3. Perform other management tasks related to your system, for example,authorizing user accounts. Refer to the management informatio...
Page 32 - To modify and rebuild the sample, follow these steps:
3.3.2 User Name Quotas for the Avertz ACMS Sample The VR_DA_RUNTIME_SETUP.COM command file assigns quotas for theAVERTZ_EXC, AVERTZ_UPD, and AVERTZ_READ user names that areadequate for running the VR_DA_APPL sample application. If your systemalready has these user names defined, the quotas for these...
Page 33 - All the setup and build activities are performed.
3. Run the command procedure VR_DA_BLD_MMS.COM without parameters: $ @ACMSDI$EXAMPLES:VR_DA_BLD_MMS All the setup and build activities are performed. To perform a specific activity, specify one of the parameters in Table 7–1. Table 3–2 VR_DA_BLD_MMS.COM Parameters Keyword Activity BLD Run MMS to bui...
Page 35 - Part II; Installing the TP Desktop Connector Client; TPware Product Suite CD-ROM Overview
Part II Installing the TP Desktop Connector Client Software Part II describes Compaq TP Desktop Connector software installation from theTPware Product Suite CD on a client system and presents the following majortopics: • TPware Product Suite CD-ROM Overview • Before Installing TP Desktop Connector S...
Page 37 - Table 4–1 Contents of the TPware Product Suite CD; dunix
4 TPware Product Suite CD-ROM Overview This chapter describes the TPware Product Suite CD distribution medium fromwhich you install TP Desktop Connector software and related components. 4.1 TPware Product Suite CD-ROM Contents The TPware Product Suite CD contains all the software required fordevelop...
Page 39 - Installation Overview
5 Before Installing TP Desktop Connector Software This chapter describes the preparations and requirements necessaryfor installing Compaq TP Desktop Connector software and also containsinformation on removing TP Desktop Connector software from Windowsplatforms. Your bill of materials (BOM) specifies...
Page 41 - Removing the Installed Software; Click the; Start; Programs; Choose the; TPware Products; TPware Products
Table 5–1 (Cont.) TP Desktop Connector Client Services Disk Space Requirements on Non-Windows Systems OpenVMS Alpha Client Number of Blocks Client services library and network software 709 Common headers 31 Motif sample files 489 Tru64 UNIX Client Number of Bytes Client services library and TCP/IP m...
Page 42 - Uninstall TPware; Double click the; Control Panel; Compaq TPware
4. Choose the Uninstall TPware item. • To remove the software using the system Add/Remove Programs utility: 1. Double click the Add/Remove Programs icon in the Control Panel window. 2. Choose the Compaq TPware item. 3. Click the Add/Remove... button. 5–4 Before Installing TP Desktop Connector Softwa...
Page 43 - Installation Procedure on Windows Operating Systems
6 Installing TP Desktop Connector Software on Windows Operating Systems This chapter describes the procedures for installing or reinstalling the CompaqTP Desktop Connector software from the TPware Product Suite CD running ona Windows system and also contains information on postinstallation tasks onW...
Page 44 - After Installing TP Desktop Connector Software
To do this... Click this button: Complete the choices in a dialog box and continue Next Return to a previous dialog box Back Exit without completing the installation Cancel Follow the instructions in the dialog boxes to select installation of Compaq TPDesktop Connector. The setup program checks whet...
Page 45 - Verifying the TP Desktop Connector Installation; ACMS Samples; item from the; TP Desktop Connector for; menu in the; program with the rest of the; Running the Windows Sample Client Application
6.2.2 Accessing the ACMS System For access to a Compaq ACMS transaction processing system, the TP DesktopConnector Gateway for ACMS must be installed on the OpenVMS system. Thegateway software is distributed on a separate CD included in the distributionkit; instructions for installing it are in Part...
Page 46 - command; Run; Code Conversion Libraries for Kanji; The following files are installed for Kanji applications:
C:\TPware\STDL_RT\bin\divb.dllC:\TPware\STDL_RT\bin\msvcrt40.dll To verify the success of your TP Desktop Connector client services installation,you can run the Visual Basic sample application. Follow these steps: 1. Open the VBAVERTZ project. 2. Verify that all the required files were loaded (see t...
Page 47 - Overview of the Client Services Installation; or some
7 Installing the TP Desktop Connector Client Services on Non-Windows Systems The TP Desktop Connector client services software was previously releasedas the ACMS Desktop ‘‘portable API’’ services. It allows client applicationsrunning on a variety of desktop platforms to call ACMS tasks. For the curr...
Page 49 - Installing the Client Services for OpenVMS; Create the client services directory on the desktop system.; Copy the file to the newly created directory.; cd; accept the default output filename; cd; accept the default output filename
7.2 Installing the Client Services for OpenVMS The client services files for OpenVMS are provided as a compressed savesetthat you can copy from the TPware Product Suite CD mounted on your desktopplatform. After you copy the client services software to the client system,decompress the file and restor...
Page 50 - Installing the Motif Sample Client for OpenVMS; Copy the Motif sample file.
3. The TP Desktop Connector library is preconfigured for DECnet networkaccess. To build applications that use TCP/IP as a transport, you mustreconfigure the library before creating executable programs. The following steps are necessary to set up the TP Desktop Connectorlibrary for TCP/IP access: a. ...
Page 51 - Verifying the Motif Sample Installation on OpenVMS; MMS
$ run vms_avertz.exe ... Return accept the default output filename ... $ backup/restore vms_avertz.sav/save *.*/log 4. Copy the Motif resource file to your home directory: $ copy m_avertz.dat sys$login:m_avertz.dat Table A–2 lists the files that are added to your desktop system. 7.2.3 Verifying the ...
Page 52 - The installation procedure is now complete and verified.; Setting Up the Avertz ACMS Sample Application on an OpenVMS
The m_avertz application displays the menu bar of the AVERTZ CarReservation System. If you want the sample desktop client program tocommunicate with the ACMS application, follow the procedures in Section 7.2.4to set up the sample application on the ACMS system. After you set up theACMS system, use t...
Page 55 - Installing the Tru64 UNIX Client Software; mkdir acmsdi; su
7.3 Installing the Tru64 UNIX Client Software The TP Desktop Connector client services and sample application files aredistributed on the Software Products Library CD and on the TPware ProductSuite CD. If you are installing the software from the TPware Product SuiteCD (see Section 5.1), you have two...
Page 56 - Installing the Motif Sample Client on Tru64 UNIX Platforms; mkdir avertz; cp
3. You can copy the client services library to /usr/lib/libacmsdi.a , so that you can refer to it in your link command as ’-lacmsdi’ . You need superuser privileges to copy into the /usr/lib directory. Copy the TP Desktop Connector client library to the system directory: # cp libacmsdi.a /usr/lib/li...
Page 57 - make
The sample makefile and executables for Motif on Tru64 UNIX use TCP/IP asthe default transport. If you have changed the client services library to useDECnet, you must relink the sample application before you run it. 7.3.2 Verifying the Motif Sample Installation on Tru64 UNIX Platforms Compile, link,...
Page 59 - Part III; Installing the Gateway Software; Installing TP Desktop Connector Gateway for ACMS Software
Part III Installing the Gateway Software Part III describes Compaq TP Desktop Connector Gateway for ACMS softwareinstallation from the TPware Product Suite CD on an OpenVMS system andpresents the following major topics: • Preparing to Install TP Desktop Connector Gateway for ACMS Software • Installi...
Page 61 - Required Operating System Components
8 Preparing to Install TP Desktop Connector Gateway for ACMS Software This chapter discusses the preparations and requirements necessary forinstalling Compaq TP Desktop Connector gateway for ACMS software. Yourbill of materials (BOM) specifies the number and contents of your media. Besure to verify ...
Page 62 - Table 8–1 Disk Space Requirements
You can avoid having to stop and restart VMSINSTAL by following thedirections in this section before you run VMSINSTAL. The time required forinstalling gateway software is approximately five minutes. 8.3.1 Disk Space Installing gateway software requires a certain amount of free storage spaceduring t...
Page 63 - OpenVMS License Management Facility
For the gateway process to be properly started, the user name under which theinstallation is done must be an authorized ACMS agent. Use the ACMSUDUUtility to authorize the user name. For example: $ SET DEFAULT SYS$SYSTEM $ RUN ACMSUDU UDU> ADD SYSTEM/AGENT UDU> If the user name is not authoriz...
Page 64 - Stopping the ACMS System and Gateway; SHOW DEVICE device-name
8.3.4 System Disk Backup At the beginning of the installation, VMSINSTAL asks whether your systemdisk is backed up. Compaq recommends that you always do a system diskbackup before installing new software on the operating system. Use the backup procedures that are established at your site to do this ...
Page 65 - The command lists the various backup savesets.
2. If the device is not mounted, enter a command in the following format: MOUNT/OVERRIDE=ID device-name For example: $ MOUNT/OVERRIDE=ID DKA200: 3. Locate the distribution files. Use a DIRECTORY command in the followingformat and specify the indicated directory specification and saveset name. DIRECT...
Page 67 - General Installation Information; This section includes the following information.
9 Installing TP Desktop Connector Gateway for ACMS Software This chapter describes how to install Compaq TP Desktop Connector gatewayfor ACMS software. Section 9.1 provides helpful information about installingthe gateway software. Section 9.2 contains a step-by-step description of theinstallation pr...
Page 69 - Installation Procedure; SET DEFAULT SYS$UPDATE; ACMSDI
9.1.4 Aborting the Installation To abort the installation procedure at any time, press Ctrl/Y . When you press Ctrl/Y , the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. 9.2 Installation Procedure Perform the steps in t...
Page 70 - Execute the installation procedure. For example:; Confirming active processes; YES; Confirm system backup; Mounting the media
3. Execute the installation procedure. For example: $ @SYS$UPDATE:VMSINSTAL ACMSDI DKA200:[000000] OPTIONS N This command begins installing the ACMSDI saveset found in the directory[000000] on the CD device named DKA200. VMSINSTAL asks several installation questions as described in Section 9.2.2. 9....
Page 71 - The following products will be processed:; Are you; Release Notes
Please mount the first volume of the set on DKA200:.* Are you ready? YES %MOUNT-I-MOUNTED, ACMSDI mounted on DKA200: The following products will be processed: ACMSDI V3.1A Beginning installation of ACMSDI V3.1A at 13:14 %VMSINSTAL-I-RESTORE, Restoring product save set A... If you enter the wrong dev...
Page 74 - Running the Installation Verification Procedure; Completing the Installation Procedure; Installation of ACMSDI V3.1A completed at 13:32; LOGOUT; SYSTEM; Recovering from System and Installation Failures
If the disk has quotas enabled, a message is displayed. The account must havesufficient disk quotas to install. Refer to Table 8–1. 9.2.4 Running the Installation Verification Procedure If you chose to run the IVP, VMSINSTAL runs it next. When the IVP runssuccessfully, you see the following messages...
Page 75 - The operating system version is incorrect.
• The system disk used by the installation was corrupted. VMSINSTALinstructs you to restore the system disk from the backup copy and restartthe installation. • VMSINSTAL continues the installation and can tell you to manuallypurge replaced files, even if you request that they be purged automatically...
Page 77 - After installing gateway software, perform the following tasks:; Editing the OpenVMS System Files; The following files are located in the SYS$STARTUP directory.
10 After Installing TP Desktop Connector Gateway for ACMS Software After installing gateway software, perform the following tasks: • Edit OpenVMS system startup and shutdown files (see Section 10.1). • Perform any cluster operations (see Section 10.2). • Match client and server versions (see Section...
Page 78 - Start ACMS software before you start TP Desktop software.
Position the TP Desktop startup command line after the line that invokes theACMS startup command procedure. For example: $ @SYS$STARTUP:ACMSTART.COM ... $ @SYS$STARTUP:ACMSDI$STARTUP.COM Note Start ACMS software before you start TP Desktop software. Starting TP Desktop software automatically enables...
Page 79 - At some point before this line, add the following command line:; Performing Cluster Procedures
10.1.2 Editing the System Shutdown File Find the following line, which stops the ACMS system, in the OpenVMSsystem shutdown file: $ @ACMSTOP.COM At some point before this line, add the following command line: $ @SYS$STARTUP:ACMSDI$SHUTDOWN.COM The command procedure cancels all active tasks and shuts...
Page 81 - All the necessary files are on the system.; Running the IVP Independently; This section describes the requirements and steps to run the IVP.
11 Running the TP Desktop Connector Gateway for ACMS IVP This chapter describes how to run the gateway installation verificationprocedure (IVP) separately from the installation procedure. The IVP can berun as a part of the normal installation when you answer YES to the IVPquestion. If the IVP fails ...
Page 83 - Part IV; Appendixes
Part IV Appendixes Part IV provides reference material related to software installation on asystem. Appendix A lists the files that are installed on your system for the varioussample programs. Appendix B contains helpful hints about errors that might occur when you runone of the sample applications.
Page 85 - Files Installed; OpenVMS Systems; Table A–2 Files Installed for the Motif Sample for OpenVMS Systems
A Files Installed The following tables list the files that are installed on your systems for thevarious sample applications. Table A–1 Files Installed for TP Desktop Connector Client Services for OpenVMS Systems Files Description ACMSDI.H Include file for the TP Desktop Connector client servicesdecl...
Page 87 - Table A–3 Files Installed for the Visual Basic Windows Sample
Table A–2 (Cont.) Files Installed for the Motif Sample for OpenVMS Systems Name Description m_sitelist.c Creates (using m_sites.dat) and manages the list box ofAVERTZ sites m_sitelist.h Header file for m_sitelist.c m_sites.dat Contains data about AVERTZ sites; read in at run time m_transceive.c Pres...
Page 88 - Table A–4 Files Installed for the Forced NonBlocking Tutorial
Table A–4 Files Installed for the Forced NonBlocking Tutorial Name Description ACMSDI.BAS ACMSDI declarations for Visual Basic applications FORM1.FRM GUI objects and code for the Forced Nonblocking Tutorialmain window FORMS.BAS DECforms message code definitions for Visual Basic FNBSAMPL.MAK Visual B...
Page 91 - Common Configuration Errors; B.1 Errors Related to the Desktop System; Errors can arise when any of the following conditions exits:
B Common Configuration Errors The following sections discuss some of the errors that can occur while runningthe TP Desktop Connector client services sample applications. B.1 Errors Related to the Desktop System Errors can arise when any of the following conditions exits: • The TP Desktop Connector c...
Page 92 - B.2 Errors Related to the ACMS System
If you encounter font-support problems running the program, modify thefonts used by editing the m_avertz resources file (m_avertz in the user ’s homedirectory). B.2 Errors Related to the ACMS System If you have used the client services sample to communicate with the ACMSsystem, errors will occur if ...
Page 93 - Index
Index A ACMS starting, 10–2stopping system, 8–4 ACMSADU utility use, 8–3ACMSDI$CLIENT modification, 9–7ACMSDI$SYSTEM_FILES.DAT, 9–2ACMS_DESKTOP_SERVER.DAT, 10–2Administrator privileges, ix API see TP Desktop Connector client services Authorization, 8–3Authorizing gateway user name, 8–3AVERTZ access ...
