Version 8.1 Windows 32 and 64-bit Quick Start Guide
Product and License Installation Procedures
Before You Begin
Follow the directions in the next section to install any products from the extend8 family on your machine. You may install Acucorp products on either the client or the server with the following exceptions:
The compiler and runtime can be run from a shared drive, but AcuBench® cannot. AcuBench and the AcuXDBC® client must be installed on each client machine.
Server-side products such as AcuServer®, AcuConnect®, and AcuXDBC Server, should not be installed on client machines.
If you install a server-side product, be sure to configure your system as described in the “Product Startup” section before attempting to access programs or data on the server. If the server will be accessed by users of the
ACUCOBOL-GT Web runtime, be sure to install a runtime license file on the server that includes permissions for the total number of concurrent Web runtime connections that you anticipate. Consult section 5.7.1 in
A Programmer’s Guide to the Internet for more information on licensing the Web runtime.
This 64-bit archive also installs 32-bit versions of those products that don’t have 64-bit equivalents. This includes program executables such as AcuBench as well as non-executables such as sample programs and tools. When selecting products to install on Windows x64 platforms the 32-bit products will be installed into a special Windows folder reserved for bit programs called “Program Files (x86)”. The Windows Start menu items will use these 32-bit versions. Some of the 32-32-bit products have 64-32-bit equivalents and are automatically installed into the Windows “Program Files” directory if the 32-bit product was selected to be installed. The 64-bit “Program Files” directory only contains the executables. The support files are found in the “Program Files (x86)” directory along with all the 32-bit executables.
Installation Instructions
1. Close all applications before proceeding.
2. Download the product from the Micro Focus supportline site. Open the product distribution (do not extract it)
and execute setup.exe from the zip file. This will create a temporary folder and then the installation screen should appear.
3. At the License Agreement screen, you must accept the terms in order to activate the Next button and continue
the install.
4. Enter the information on the Customer Information screen if desired, and whether to install the applications for
any user of the computer, or just for you.
5. At the Destination Folder screen, specify an installation directory or accept the default location. If you are a
previous user of Acucorp products, note these changes related to selecting an installation directory:
Default directory path: Starting with version 8.0, the default directory path includes “program files.” The full default path is: “C:\Program Files\Acucorp\Acucbl8xx”.
Installing in a non-default directory: When specifying a path other than the default, a subdirectory named with the release version numbers (e.g., Acucbl810) is not created. The software is installed in the directory you specify. There is no warning message if the directory already exists. This means that if you attempt to install version 8.x into an existing directory containing a previous version of
Acucorp products, that version will be overwritten by the current version you are installing. If you maintain several versions of Acucorp products, be sure to specify a different directory for each version.
Directory names containing spaces: You can specify a directory name that has embedded spaces. In pre-8.x versions, embedded spaces prevented the PATH variable from being properly set, which could cause other problems.
6. At the Select Products screen, select the products you wish to install. You must have product codes and keys to
activate each product; however, you can install all products now, and activate those products for which you do not have a license at a later date. (Be aware if you attempt to use products for which you do not have a license you may receive error messages indicating that no license file is available). When your products are selected, click Next.
NOTE: Be sure to select Online Documentation on this screen to install and access HTML versions of the
product user guides.
7. At the Installation Settings screen, select whether to add your Acucorp products to your machine’s path, and
whether to install and launch the License Activator.
NOTE: Only one version of Acucorp products should be specified in the path variable. Having more than one
version specified may cause unexpected results.
8. If you chose to launch the Activator, the setup program opens the Activator utility after the install process
completes. You then enter into the appropriate entry fields, the product codes and keys that came in your package. Note that the Activator is case insensitive and displays only uppercase characters. The Activator also ignores embedded spaces and separating characters. Product codes and keys do not contain the letters “O” or “I”.
NOTE: If you are installing the 64-bit version and you run the license activator from the command line, make
sure you are using the 64-bit version located in the “program files” directory.
User’s Guides
Online user’s guides are provided in HTML format and are viewed from an Internet browser such as Internet Explorer or Netscape. Note that you must have elected to have the documentation set installed in step 6 of the install process.
Alternatively, you can download PDF or HTML versions of the user’s guides from the support section of the Micro Focus website.
To view or access the installed components, click Start, point to Programs, then point to Acucorp 8xx. Open the menu item titled “extend8 Documentation Set”. Alternatively, go to where you installed your product and click on the folder called “docs”, then click the file called “acudocs”. This launches the main page from which you can select the user guide of interest.
Development System
AcuBench
AcuBench is a 32-bit product that doesn't have a 64-bit equivalent. When you compile and run programs from AcuBench, the 32-bit versions of the compiler and runtime are used. AcuBench doesn't require any path changes for this to occur. All the 32-bit versions are fully supported and functional in the 64-bit environments.
The ACUCOBOL-GT Development System (compiler, runtime, utilities) is completely integrated with AcuBench. To quickly see how you interact with the development tools via AcuBench, perform the following steps:
1. Launch AcuBench and select File > Open Workspace. Open the project “samples.pjt” located at Program Files\Acucorp\Acucbl8xx\ AcuGT\samples\acubench. See sections 6.2 and 6.3 in the AcuBench User’s Guide for details on workspaces and projects.
2. Select Project > Settings. The first tab displayed is the compiler settings tab. Note that you can apply your desired settings to single files or groups of files. For this demonstration, make no changes and close the dialog box. See section 2.1 in the ACUCOBOL-GT User's Guide for information on the compiler options.
3. Select Build > Build Workspace.
4. In the workspace File View, click Object folder and the object file of interest.
5. Select Project > Settings then select the runtime tab. Note that you can apply various runtime options to specific files or to groups of files. For this demonstration, make no changes and close the dialog box. See section 2.2 in the ACUCOBOL-GT User's Guide for information on the runtime options.
6. Click the Execute icon on the AcuBench toolbar. For more information about executing files, see section 6.25 in the AcuBench User’s Guide.
ACUCOBOL-GT Compiler
To use the compiler from outside AcuBench, open a command prompt and change directories to the location of the compiler executable ccbl32. The default location is Program Files\Acucorp\Acucbl8xx\ AcuGT\Bin. Enter a ccbl32 command. The general syntax is:
ccbl32 [options] source-file
See section 2.2 in the ACUCOBOL-GT User’s Guide for details on using the compiler and compiler options. To quickly view a list of options enter the command:
ccbl32 -help
ACUCOBOL-GT Runtime
To run a program from outside AcuBench, open a command prompt and change directories to the location of the runtime executable wrun32. The default location is the same director as the executable ccbl32. Enter a wrun32 command. The general syntax is:
wrun32 [options] object-file [parameters]
See section 2.3 in the ACUCOBOL-GT User’s Guide for details on using the runtime including options and parameters.
Server-side Solutions
TCP/IP connections are required for the following products.
AcuServer
Before using AcuServer, first set up user accounts and establish system configuration files on the server. For instructions, open the AcuServer User’s Guide and read Chapter 3, “Preparing Your Windows Network.” When done, you can begin using AcuServer by selecting AcuServer, AcuServer Control Panel. Click the Services tab, select the port you want, and click Start.
AcuConnect
To use AcuConnect, you must prepare your application, configure the server, and configure the client. For instructions regarding configuration issues for the distributed processing deployment, refer to Chapters 2-4 of the AcuConnect User’s Guide. For an AcuConnect thin client deployment, you must set up user accounts and establish system configuration files, as described in Chapters 6-7 of the AcuConnect User’s Guide.
To begin using AcuConnect, select AcuConnect, AcuConnect Control Panel. Click the Services tab, select the port you want, and click Start.
AcuXDBC Server
The use of AcuXDBC Server implies that AcuXDBC enabled clients will be accessing data files residing on a network server. This means there are steps to perform on both the client and server machine.
This document provides the general steps for using AcuXDBC Server. Each step provides the section number of the
AcuXDBC User’s Guide that corresponds to each step. You should refer to each of these sections for detailed
instructions on performing these tasks.
1. Be aware of the environment variable GENESIS_HOME that is automatically created when you install AcuXDBC. This variable defines the location of configuration files and the installation directory. See Section 5.2.1.
2. Create a system catalog, set permissions, and populate the catalog with data tables that are built from your XFDs. AucXDBC comes with tools that automate most of these processes. See Sections 5.3 - 5.5, note that once created, the system catalog should reside on the server.
3. Configure the client file NET.INI and the server file acuxdbc.cfg. See Section 4.3. 4. On the client machine, create a DSN that points to acuxdbc.cfg. See Section 5.8.1. 5. Start the AcuXDBC server. See Section 5.7.
6. Confirm client machines can access the DSN and data files from an application such as Microsoft Excel or Access, or from AcuXDBC’s built-in SQL query tool xdbcquery. See Chapter 8.
AcuXUI
To use AcuXUI, make sure that “acuxui.jar” is added to the CLASSPATH environment variable, then type “acuxui” on the server command line and press <Enter>. When prompted, enter the path of your COBOL program and command-line options. AcuXUI requires J2SE JRE Version 1.5.0 or later on the server. If desired, you can combine AcuXUI with AcuConnect to run a COBOL program on a remote server, or you can run it inside a browser as an applet. For more information, open ACUCOBOL-GT User Interface Programming and read Chapter 11, “Using AcuXUI to Deploy a Cross-Platform User Interface.”
Client-side Solutions
AcuXDBC
This section provides the general steps for using AcuXDBC in a local environment. If you want to use AcuXDBC in a network environment, you will also need AcuXDBC Server.
Each step below provides the section number of the AcuXDBC User’s Guide that corresponds to each step. You should refer to each of these sections for detailed instructions on performing these tasks.
1. Be aware of the environment variable GENESIS_HOME that is automatically created when you install AcuXDBC. This variable defines the location of configuration files and the installation directory. See Section 5.2.1.
2. Create a system catalog, set permissions, and populate the catalog with data tables that are built from your XFDs. AucXDBC comes with tools that automate most of these processes. See Sections 5.3 - 5.5. 3. Configure the client file acuxdbc.cfg. See Section 4.3.
4. Create a DSN that points to acuxdbc.cfg. See Section 5.8.1.
5. Confirm that you can access the DSN and data files from an application such as Microsoft Excel or Access, or from AcuXDBC’s built-in SQL query tool xdbcquery. See Chapter 8.
Web Runtime
To begin using the Web runtime, you must prepare and configure your application to work with the Web runtime, update your Web page to invoke the COBOL program, and configure the Web server. For instructions, open A Programmer’s Guide to the Internet and read Chapter 5, “Using the ACUCOBOL-GT Web Runtime.”
Database Solutions
Acu4GL
To begin using Acu4GL®, you must create data dictionaries (XFDs), create configuration files, and set database-specific variables. For an overview of these requirements, open the Acu4GL User’s Guide and read Chapter 1, “Acu4GL Overview.”
AcuSQL
To begin using AcuSQL®, prepare your ESQL COBOL source code for use with AcuSQL as described in Chapter 2, “Program Preparation,” of the AcuSQL User’s Guide. Launch AcuSQL from within AcuBench (see section 3.2.1) or on the ACUCOBOL-GT command line (see section 3.2.2).
Reaching Technical Services
In the U.S., you can reach Technical Services Monday through Friday from 6:00 a.m. to 5:00 p.m. Pacific time, excluding holidays.
In the United States
Phone: +1 858-795-1902 or 800-399-7220 (within the U.S. and Canada) E-mail: support@microfocus.com
Online: http://supportline.microfocus.com
For worldwide technical support information, please visit http://supportline.microfocus.com