# DIGITAL TP Web Connector
DIGITAL Database Web Connector
Getting Started

Previous | Contents | Index

# 2.3 Using the Setup Windows

To install TP Web Connector and Database Web Connector, run the `setup` program as instructed in Sections Section 2.4 and Section 2.5. Use the `Back`, `Cancel`, and `Next` buttons that are displayed on the `setup` windows as follows:

- To complete the choices on a window, click on the `Next` button. The software processes the responses that you gave on the current window and continues to the next window.
- To return to a previous window, click on the `Back` button.
- To exit without completing the installation, click on the `Cancel` button.

# 2.4 TP Web Connector Installation Procedure

To install DIGITAL TP Web Connector, perform the following steps:

1. Remove any previous TP Web Connector kit from the system (see Section 2.7).
2. Place the TP Web Connector disk in the :CD--ROM drive that you can access on your Windows NT system.
3. Run the `setup.exe` program in the appropriate directory on the :CD--ROM drive. Use one of the following directory paths:

    \ntalpha
    \ntintel

The `setup` program displays a wait message box while it initializes. When `setup` completes initialization, it displays the `welcome` window.

4. Read the `Welcome` window and click `Next`. Read the `Information` window and click `OK`.
   If you do not have a TPware component installed on your system, the `setup` program displays the `Choose Target Directory` window.
   If you have a TPware component installed on your system, you do not see the `Choose Target Directory` window or the `Select Program Group` window, and `setup` displays the `Select Additional Components` window. The installation uses the current target directory and program folder on your system.
5. On the `Choose Target Directory` window, do one of the following:

1. If the default target directory is acceptable, click on `Next`. The `setup` program displays the `Select Program Group` window.
2. To choose a different target directory, click on the `Browse` button to display the `Target Directory Options` dialog box. Specify the target directory by either typing in the path text field or by using the `Directories` box.
   After you select the desired directory, click on `OK` in the `Target Directory Options` dialog box and on `Next` in the `Choose Target Directory` window. If the selected target directory does not exist, `setup` asks you whether it is OK to create the target directory. `Setup` displays the `Select Program Group` window.

6. On the `Select Program Group` window, do one of the following:

1. If the suggested program group is acceptable, click on `Next`. `Setup` displays the `Select Additional Components` window.
2. If the program group name is not acceptable, enter the new program group name and click `Next`. `Setup` displays the `Select Additional Components` window.

7. On the `Select Additional Components` window, click in each of the check boxes for the software that you want installed:

- STDL compiler---for developing clients
- ACMS Desktop Support---for clients calling ACMS tasks
- DIGITAL DCE Support---for clients calling ACMSxp tasks
- Samples---for sample STDL and C source code for clients

After you select the components, click `Next`. You see the `Selecting Files to Copy` window and `setup` performs registry operations.
If you are installing TPware software for the first time, `setup` creates the TP Web Connector environment and displays a `Reboot` window.
If you already have a TPware component on your system, the environment is established and you do not see the `Reboot` window. The user interaction is complete.

8. In the `Reboot` window, click `Yes` to activate the environment by rebooting the computer or click `No` to continue running without activating the TP Web Connector environment. After you indicate your choice, the user interaction is complete.

The `setup` utility checks whether there is sufficient disk storage, and installs the selected software components. If `setup` finds that a requisite software product is not installed or that the minimum version of a requisite product is not on the system, it displays an `Error` box showing the product name and version. You must install the prerequisite software (see Section 2.2 and Table 2-2) and retry the TP Web Connector installation.

If you reboot your machine, the TP Web Connector environment is set up.

After you install TP Web Connector, you can install Database Web Connector (see Section 2.5) or read suggestions on what to do after the installation (see Section 2.6).

# 2.5 Database Web Connector Installation Procedure

To install DIGITAL Database Web Connector, perform the following steps:

1. Remove any previous Database Web Connector kit from the system (see Section 2.7).
2. Place the Database Web Connector disk in the :CD--ROM drive that you can access on your Windows NT system.
3. Run the `setup.exe` program in the appropriate directory on the :CD--ROM drive. Use one of the following directory paths:

    \ntalpha
    \ntintel

The `setup` program displays a wait message box while it initializes. When `setup` completes initialization, it displays the `Welcome` window.

4. Read the `Welcome` window and click `Next`. Read the `Information` window and click `OK`.
   If you do not have a TPware component installed on your system, the `setup` program displays the `Choose Target Directory` window.
   If you have a TPware component installed on your system, you do not see the `Choose Target Directory` window or the `Select Program Group` window, and `setup` displays the `Select Additional Components` window. The installation uses the current target directory and program folder on your system.
5. On the `Choose Target Directory` window, do one of the following:

1. If the default target directory is acceptable, click on `Next`. The `setup` program displays the `Select Program Group` window.
2. To choose a different target directory, click on the `Browse` button to display the `Target Directory Options` dialog box. Specify the target directory by either typing in the path text field or by using the `Directories` box.
   After you select the desired directory, click on `OK` in the `Target Directory Options` dialog box and on `Next` in the `Choose Target Directory` window. If the selected target directory does not exist, `setup` asks you whether it is OK to create the target directory. `Setup` displays the `Select Program Group` window.

6. On the `Select Program Group` window, do one of the following:

1. If the suggested program group is acceptable, click on `Next`. `Setup` displays the `Select Additional Components` window.
2. If the program group name is not acceptable, enter the new program group name and click `Next`. `Setup` displays the `Select Additional Components` window.

7. On the `Select Additional Components` window, click in each of the check boxes for the software that you want installed:

- STDL compiler---for developing clients
- Samples---for sample STDL processing group specifications and C source code for clients and processing procedures

After you select the components, click `Next`. You see the `Selecting Files to Copy` window and `setup` performs registry operations.
If you are installing TPware software for the first time, `setup` creates the Database Web Connector environment and displays a `Reboot` window.
If you already have a TPware component on your system, the environment is established and you do not see the `Reboot` window. The user interaction is complete.

8. In the `Reboot` window, click `Yes` to activate the environment by rebooting the computer or click `No` to continue running without activating the Database Web Connector environment. After you indicate your choice, the user interaction is complete.

The `setup` utility checks whether there is sufficient disk storage, and installs the selected software components. If `setup` finds that a requisite software product is not installed or that the minimum version of a requisite product is not on the system, it displays an `Error` box showing the product name and version. You must install the prerequisite software (see Section 2.2 and Table 2-2) and retry the Database Web Connector installation.

If you reboot your machine, the TP Web Connector environment is set up.

After you install Database Web Connector, you can install TP Web Connector (see Section 2.4) or read suggestions on what to do after the installation (see Section 2.6).

# 2.6 After Installing TPware Components

This section describes some procedures you may want to do after you install the product.

## 2.6.1 Environment Setup

After you install the TP Web Connector and Database Web Connector kits and reboot your computer, the TPware run-time environment is set up. However, you must set up the environment for each command window that is used for development (see Section 5.2).

## 2.6.2 After Installing TP Web Connector

After you install TP Web Connector, you can:

- Develop a client that calls ACMS tasks (see Section 2.6.2.1).
- Develop a client that calls ACMSxp tasks (see Section 2.6.2.2).

### 2.6.2.1 Steps for Calling ACMS Tasks

If you are developing clients that call ACMS tasks, follow these general steps:

- Install TP Web Connector components on OpenVMS systems (see Chapter 3).
- Use TP Web Connector components on OpenVMS systems to begin the client development (see Chapter 6).
- Develop the client (using output from following guidelines in Chapter 6) on a Windows NT system on which you have installed TP Web Connector components (see Chapter 4).
- Configure TPware parameters on a Windows NT system (see Chapter 7).
- Set up an ACMS Desktop adapter gateway on a OpenVMS system (see Chapter 8).

### 2.6.2.2 Steps for Calling ACMSxp Tasks

If you are developing clients that call ACMSxp tasks, follow these general steps:

- Develop the client (see Chapter 4).
- Configure TPware parameters on a Windows NT system (see Chapter 7).

## 2.6.3 After Installing Database Web Connector

After you install Database Web Connector, you can develop a client that calls local STDL processing procedures (see Chapter 4).

# 2.7 Removing the Installed Software

To remove the TP Web Connector and Database Web Connector software from your system, use the `Uninstall` item in the `TPware` menu. Follow these steps:

1. If you are running TPware with an Automation client, shut down the Internet Information Server (IIS) to flush the DLL cache (see Section 4.6.4).
2. On the task bar, click `Start`, and, in `Programs`, select `TPware`, and click `Uninstall`. A window with names of components appears.
3. In the `Uninstall` window, select the components to remove from the system. Use the following guidelines:

1. If you have either TP Web Connector or Database Web Connector software (but not both) installed, click on that entry.
2. If you have both TP Web Connector and Database Web Connector software installed, click the entry for the product you most recently installed. You must remove the products from the system in the reverse order in which you installed them, because your first installation included base components common to both products.
   If you choose the wrong order, the software displays a message telling you which product to remove first.

4. After the software is successfully removed, click on the `OK` button to dismiss the window.
5. If you shut down IIS, restart it (see Section 4.6.4).

If you have added any files to the TP Web Connector or Database Web Connector target directories, those files are not deleted from your system. This can happen if you build the samples without copying them. If you have not deleted all these files, manually delete them.

# Chapter 3
Installing TPware Components on an OpenVMS System

This chapter describes the installation of the TPware components on an OpenVMS system running ACMS software, including requirements and activities associated with the installation.

# 3.1 Installation Overview

The TP Web Connector kit includes both development and runtime software for building and running TP Web Connector with an existing ACMS system. This kit does not include the ability to build and run ACMS task or processing servers.

The TP Web Connector :CD--ROM contains the following components that are installed on an OpenVMS system if ACMS applications are to be used with TP Web Connector.

- Modified ACMS utility images (supporting the STDL-based ACMS Desktop adapter and collectively referred to as the ACMSADU extension)

- ACMADUSHR.EXE
- ACMSADU.EXE
- ACMCDUSHR.EXE
- ACMCMUSHR.EXE
- ACMTDUSHR.EXE
- ACMUTLMSG.EXE

- Release notes
- ACMS Desktop adapter gateway images supporting the ACMS RPC requests between the ACMS Desktop adapter and the ACMS system and command procedures for controlling the ACMS Desktop adapter gateway process

- ACMSDA$FORMS_MANAGER_SHR.EXE
- ACMSDA$GATEWAY.EXE
- ACMSDA$GATEWAY_MESSAGES.TXT
- ACMSDA$GATEWAY_SHR.EXE
- ACMSDA$MSG.EXE
- ACMSDA$SHUTDOWN.COM
- ACMSDA$STARTUP.COM
- ACMSDA$STARTUP.PRM
- ACMSDA$STOP_DESKTOP_GATEWAY.EXE
- ACMSDA$TSS_SHR.EXE

The ACMS Desktop adapter gateway can be installed on the same ACMS host system as the ACMSADU extension or on a different ACMS system.

Use the VMSINSTAL utility to install the ACMSADU extension and the ACMS Desktop adapter gateway. The ACMSADU extension replaces the ACMSADU and related images currently on the system.

# 3.2 Preparing to Install the TP Web Connector Components

This section describes support and preparations required on the OpenVMS system for you to successfully install and use the ACMSADU extension and the ACMS Desktop adapter gateway. The saveset for the ACMSADU extension and the ACMS Desktop adapter gateway includes on-line release notes. DIGITAL recommends that you read the release notes before installation because they may contain important information about the installation procedure.

## 3.2.1 Hardware Support

TPware components for OpenVMS platforms run on the following hardware types:

- DIGITAL Alpha system
- DIGITAL VAX system

## 3.2.2 Privileges and Authorization

To install the TP Web Connector software, you must be logged in to an account with the following privileges:

- NETMBX
- SETPRV
- TMPMBX

The SYSTEM account has all the required privileges for the installation.

VMSINSTAL turns off the BYPASS privilege at the start of the installation and sets the privileges that it needs during the installation.

The account under which you run VMSINSTAL must have sufficient disk quotas to install.

## 3.2.3 Prerequisite Software

The minimum software requirement needed to install and run TP Web Connector on OpenVMS platforms is shown in Table 3-1.

Table 3-1 Required Software on OpenVMS Systems

TP Web Connector Component | Title of Required Product | Version
--- | --- | ---
ACMSADU extension | ACMS with Development license | 4.2 or higher
ACMS Desktop adapter gateway | ACMS with Development, Runtime, or Front-End license | 4.2 or higher

If the interface that you are developing works with web clients and calls ACMS task servers (TP Web Connector only), the minimum software requirement for the web client software is Internet Information Server Version 3.0.

## 3.2.4 System Requirements

The ACMSADU extension and the ACMS Desktop adapter gateway are supported on the following versions of OpenVMS software:

- OpenVMS VAX 5.5-2, 6.1, 6.2, and 7.1
- OpenVMS Alpha 6.1, 6.2, and 7.1

The ACMSADU BUILD GROUP command must be run with an ACMS Version 4.2 Development kit and development license.

The ACMSADU BUILD APPLICATION command can be run on an ACMS Version 4.2 Development system or with an ACMS Version 4.2 Runtime kit with the appropriate license.

System administrators install the ACMSADU extension using VMSINSTAL. The installation procedure checks that the proper ACMS version is installed on the system.

The Software Product Description (SPD) contains a complete list of the products that are compatible with this version of the software. On OpenVMS Alpha systems, the SPD is on the media :CD--ROM.

## 3.2.5 Disk Space Requirements

The TP Web Connector OpenVMS components require a peak amount of free storage space during the installation and a net amount of storage after the installation, as shown in Table 3-2.

Table 3-2 TPware Disk Space Requirements

| Blocks
--- | ---
Usage | Peak | Net
ACMS Desktop adapter gateway | 24K | 2K
ACMSADU extension | 28K | 7K

## 3.2.6 Installation Procedure Requirements

The installation procedure imposes the following requirements:

- Time
  The TP Web Connector components for OpenVMS systems require approximately five minutes to install.
- System Disk Backup
  At the beginning of the installation, VMSINSTAL asks whether your system disk is backed up. DIGITAL recommends that you always back up the system disk before installing new software on the operating system.
- Print Queue for Release Notes
  If you select the option to print the release notes during installation, VMSINSTAL asks for a print queue name. The default name is SYS$PRINT. Enter the name of an ANSI queue on your system to change the default queue.
- Installation Verification Procedure
  The installation verification procedure (IVP) for the TP Web Connector OpenVMS components verifies that the software is installed correctly. During installation, VMSINSTAL gives you the option of running the IVP as part of the installation procedure.
  After you install the TP Web Connector components, you can run the IVP independently to verify that the software is available on your system. See Section 3.6.3 for information about running the IVP separately from the installation procedure.

Previous | Next | Contents | Index