Installing Entire Connection

This document covers the following topics:


Prerequisites

Entire Connection is a 32-bit application. When installed on a 64-bit Windows operating system, Entire Connection will run under WOW64. WOW64 is an x86 emulator that allows 32-bit Windows-based applications to run seamlessly on 64-bit Windows.

The following hardware and software is required in order to install and run Entire Connection:

Hardware Any PC capable of running Microsoft Windows. Approximately 80 MB of free disk space. During installation, additional 80 MB are required in the Temp directory.
Operating System Entire Connection can be installed on the following operating systems:
  • Microsoft Windows 7 Professional

  • Microsoft Windows 8 Professional

  • Microsoft Windows Server 2008

  • Microsoft Windows Server 2012

Communication Method At least one of the supported PC-to-host communication methods.
Data Transfer Software If you want to transfer data between the host and your PC, the following Software AG products must be installed on the host to which the PC is being linked:
  • A version of Natural for Mainframes, Natural for UNIX or Natural for OpenVMS which supports the use of Entire Connection.

  • Natural for Mainframes: The version of Natural Connection that is compatible with the version of Natural you are using.

    Note:
    Natural Connection is automatically installed when Natural for UNIX or Natural for OpenVMS is installed.

If you want to download data to Excel format or upload Excel data, Microsoft Excel 97 or higher must be installed on your PC. The Excel version depends on the operating system you are using.

Online Documentation Microsoft Internet Explorer 4.0 or higher for viewing the Entire Connection documentation in HTML help format.

Installing Entire Connection for the Administrator

Before installing Entire Connection, read the file Install.txt on the Entire Connection installation medium.

The setup program on the installation medium installs Entire Connection for one user, the administrator. In the simplest case, this is a single installation on a local PC, where the user can act as an administrator and define all required object types.

When several users are to work with the same installation (multi-user installation), the administrator can install Entire Connection on a network file server or shared drive and prepare the system for all users who are to access Entire Connection from different client workstations. For this type of  installation, you have to choose the setup type Complete (or the setup type Custom and select the option Client Setup). The Client Setup option creates the netsetup folder in the Entire Connection 4.5 folder. By default, this is \Program Files\Software AG\Entire Connection 4.5\netsetup. The netsetup folder contains the client installation program Setup.exe. Each user can run this program from his or her client workstation. It registers Entire Connection on the client workstation and creates an Entire Connection folder in the Start menu of the client workstation. When started, Setup.exe searches for the Readme.doc file in the netsetup folder. When found, its content is displayed. The administrator can use this file to provide the users with site-specific information for their work with Entire Connection (such as user names, defaults or session names). See Installing Entire Connection on a Client Workstation later in this section for information about the installation on the client workstation.

The following setup types are available:

Setup Type Installs
Typical (default) The most common options. Recommended for most users.
Complete All options. Required for a multi-user installation.
Custom You may select the options you want to install. Recommended for advanced users.

The following table indicates the options that are (or can be) installed with a specific setup type:

Option Typical Complete Custom
Configuration Manager X X X
Terminal X X X
Format Converter X X X
Host Printer LU Support   X (X)
Sample Procedures X X X
Sample Natural Programs X X X
Client Setup   X (X)

The default setting for a custom installation is the same as for the setup type Typical.

The following options are always installed: Configuration Manager and Terminal. With a custom installation, it is not possible to deselect these options.

Start of instruction set To install Entire Connection

  1. Close any active Windows applications.

  2. Insert the Entire Connection installation medium into your CD/DVD drive.

    The setup program is automatically started and guides you through the installation.

    If the automatic startup option is disabled on your system, you must run Setup.exe which is located in the root directory of the installation medium.

  3. After the installation, the administrator can define parameters, objects (for example, sessions), user groups and access rights for all users (see the section Configuration Manager). As the first step, make sure that the settings in the System Preferences dialog box are valid for all users. It is important that the directories for the procedure files and for the log and trace files can be accessed by all users.

  4. If you want to merge version 3.1 user profiles, you must do this directly after installation. See Merging Existing User Profiles in the Configuration Manager section for further information.

  5. If you upgrade from a previous 4.n.n version of Entire Connection, you have to upgrade your share file. Otherwise, specific new features will not be available. See Upgrading the Share File in the Configuration Manager section for further information.

Silent Installation and Uninstallation

InstallShield enables you to install and uninstall Entire Connection in silent mode. This also includes silent update installations. No user interaction is required in this mode.

For installing or uninstalling in silent mode, you cannot run setup.exe from the root of the installation medium. In this case, you have to run setup.exe from the \Windows\PCC folder of the installation medium.

To make sure that no user interaction is required during silent mode installation or uninstallation, it may be necessary to turn off or disable the user account control (UAC).

Start of instruction set To install, update or uninstall in silent mode

  1. Insert the Entire Connection installation medium in the CD/DVD drive of the PC on which you want to install or uninstall Entire Connection in silent mode.

  2. Invoke the Command Prompt.

  3. Change to the \Windows\PCC folder on the Entire Connection installation medium.

  4. For a first-time installation or update installation, use the following installer command syntax:

    setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilentnnnmsi.log SERIALNUMBER=serial-number INSTALLDIR=installation-folder INSTALLLEVEL=installlevel /qn"

    Or:
    To uninstall, use the following installer command syntax:

    setup /s /w /x /v"/lvoicewarmup! %TEMP%\pccsilentnnnuninstmsi.log /qn"

    The options have the following meanings:

    /s Silent mode (no user interaction).
    /L1033 Optional. Language. "L1033" installs an English version of Entire Connection. "L1031" installs a German version.
    /w Optional. Used in combination with a preceding start /WAIT command. Causes setup.exe to wait until the first-time installation, update installation or uninstallation is finished.
    /x Uninstall mode. Uninstalls a previously installed product.
    /v List of parameters for the Windows installer. See below.
    /lvoicewarmup! %TEMP%\name.log Log file for the installation or uninstallation. It is not recommended to remove this parameter.

    For silent mode, it is recommended that you use the following log file names:

    • Installation: pccsilentnnnmsi.log

    • Uninstallation: pccsilentnnnuninstmsi.log

    where nnn in the log file name stands for the current version number of Entire Connection.

    SERIALNUMBER=serial-number Required for the installation. The serial number of Entire Connection.

    Important:
    For an update installation, you have to specify the serial number of the new version.

    INSTALLDIR=installation-folder The installation folder (the default is \Program Files\Software AG\Entire Connection 4.5).

    Important:
    For an update installation, you have to specify the same installation folder as for the original installation.

    INSTALLLEVEL=installlevel Optional. Possible values are 1 or 100 (the default is 1). The value 1 stands for the setup type Typical; the value 100 stands for the setup type Complete (see above).
    /qn Required. Silent mode for the Windows installer.

Examples

First-time installation

To start the first-time installation for the setup type Complete where setup.exe waits until the first-time installation is finished, enter the following command:

start /WAIT setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilent4530msi.log SERIALNUMBER=PCC4539999999999 INSTALLDIR=\"C:\Software AG\Entire Connection 4.5\" INSTALLLEVEL=100 /qn"

Update installation

To start an update installation for the setup type Typical where setup.exe does not wait until the update installation is finished, enter the following command:

setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilent4530msi.log SERIALNUMBER=PCC4539999999999 INSTALLDIR=\"C:\Software AG\Entire Connection 4.5\" /qn"

Uninstallation

To start an uninstallation where setup.exe waits until the uninstallation is finished, enter the following command:

start /WAIT setup /s /w /x /v"/lvoicewarmup! %TEMP%\pccsilent4530uninstmsi.log /qn"

Installation Log Files

By default, Entire Connection uses the following log files for additional information, especially in case of errors:

  • The installation and uninstallation log files in %TEMP%, with the names as described above.

  • The Windows event log.

Program Folders

By default, Entire Connection is installed in the following program folder:

\Program Files\Software AG\Entire Connection 4.5

Notes:

  1. The Windows Explorer always shows a language-specific symbolic name for the program files folder. When the language of your operating system is English, the symbolic name is also "Program Files". This is different with other languages. For example, when the language of your operating system is German, the name "Programme" is shown in the Windows Explorer.
  2. On a 64-bit Windows operating system, Entire Connection is installed in the following program files folder by default: "Program Files (x86)". The symbolic name, for example, for a German operating system is then "Programme (x86)".
Program Folder Contents
\Entire Connection 4.5

*.exe
*.dll
API ActiveX control PccAPI.ocx.

\Entire Connection 4.5\doc

Readme.txt

English and German online documentation, and the help files Pccnnnxx.chm (where nnn is the current version number and xx is the language code "US" for US English or "GR" for German).

\Entire Connection 4.5\netsetup Client installation program Setup.exe. Only available when the option Client Setup has been specified during installation (setup type Custom).

The folders for the user data are by default installed at the following location:

\ProgramData\Software AG\Entire Connection

The ProgramData folder is a hidden folder. It is only shown in the Explorer when you have activated the corresponding setting in the folder options of the Explorer.

If you do not install into the default program folder (that is: the Program Files folder of Windows), the folders for the user data are installed into the specified installation folder.

The folders for the user data are:

Folder Contents
certs Files for TN3270 SSL/TLS support.
data Share411.sag.
home

Empty after installation.
*.log
Trace files (e.g. Monnn.trc and Hllapi.trc).
Temporary files for host printer LU support.

proc System procedure files. If specified during installation, this folder may also contain sample procedure files and sample Natural programs.
tables Translation tables, keyboard tables, physical terminal function code tables.

If you install for multiple users on Terminal Services, and if you want to allow the users to change their profiles in the share file, you have to change the security properties for the file Share411.sag to allow write access for the users.

Environment Variables

Entire Connection does not change any environment variables.

Upgrading Entire Connection

Only one version of Entire Connection 4 can be installed on a PC (installation for an administrator). When you upgrade Entire Connection, the previous version is removed and the new version is installed. Any user data from the previous version, especially the share file, will be saved and restored.

Since the default location for the user data has changed as of Entire Connection Version 4.5.1, the user data can also be found at the new location after the upgrade.

Caution:
The folder names that are stored in your share file may no longer be valid if the upgrade has changed the folder that contains your user data. In this case, after upgrading to Entire Connection Version 4.5.2 or later, you have to adjust these folder names to ensure that Entire Connection can find your procedure files, log files and trace files. The folder names that Entire Connection uses to locate these files are stored in the system preferences and in the user properties.

Installing Entire Connection on a Client Workstation

For a multi-user installation, the administrator must first install and prepare Entire Connection on a network file server or shared drive (see Installing Entire Connection for the Administrator). When this has been done, each user can run Setup.exe in the netsetup folder from his or her client workstation. It registers Entire Connection on the client workstation and creates an Entire Connection folder in the Start menu of the client workstation.

Important:
Each user who wants to install Entire Connection on a client workstation as described above needs administrator rights.

Upgrading Entire Connection on a Client Workstation

There is no upgrade installation for the client workstation.

The administrator must first upgrade the existing Entire Connection installation on the network file server or shared drive (see Upgrading Entire Connection). Then, for the PC on which you have an existing client installation, proceed as follows:

  1. Uninstall Entire Connection on all client workstations (see below).

  2. Install Entire Connection on all client workstations (see above).

Uninstalling Entire Connection on a Client Workstation

See Uninstalling Entire Connection.

Uninstalling Entire Connection

Use the standard Windows functionality in the Control Panel to uninstall Entire Connection, or uninstall Entire Connection in silent mode.

The uninstall does not remove any user-supplied files in the Entire Connection installation folders. This also includes the share file in the data folder.