Installing a Requestor
So that you can reach the CICS TS v. 2.2 part of our product, Services Builder for CICS 3270 Bridge provides:
- Windows requestors that run on Windows 2000 and 2003 server platforms and provide COM+ and .NET client interfaces.
- Java requestors that run on UNIX platforms and provide:
- Stateful EJB to make sure the data you pass to the screen in the host application matches the correct field.
- Data-driven JCA RA to support any J2EE-compliant application server (WebSphere, WebLogic, Oracle9i, and Sun Java System).
- Java application support.
|To install the .NET or COM requestor
To install the .NET or COM requestor on a machine running Windows 2000 Server or Windows 2003 Server:
- Insert the product CD into the CD drive.
If the setup utility does not run automatically, browse to the CD root directory and double-click autosetup.exe.
- Select Install .NET Requestor or Install COM Requestor.
- Type the access code for your installation, and then click Next.
The access code is located on the Attachmate Software License Agreement or the Attachmate Additional License Agreement.
- Respond to the subsequent prompts.
If you intend to use MCS to manage CICS terminal IDs, be sure to specify the location of your MCS server.
|To install the Java requestor or the J2EE EJB and Resource Adaptor requestor
The following procedure explains how to install these components in UNIX environments. You can install using either the default Attachmate HTTP engine or a WebLogic application server.
||If you use WebLogic, your WebLogic domain must exist before you begin the installation. If you need to create a new domain, do so using one of the methods provided by BEA.
To install the Java requestor on a machine running a non-Windows operating system:
- If necessary, create your WebLogic domain.
- From the product CD, copy the file CICS_Bridge.tar.gz to your computer.
- To expand the archive into its own empty directory, type the following from the command line:
gunzip -c CICS_Bridge.tar.gz | tar xvf -
- Change to the CICS_Bridge directory and run ./setup.sh.
- Review and accept the terms of the license agreement.
- Follow the remaining prompts.
||For Solaris, required patches are searched for by the installer. Warning messages are displayed for each path not found. For other environments, you should check with the manufacturer for required patches because, although patches may be required, they are not detected by the installation program.
- When the installation is complete, you can return to the main menu and select other components to install.
- Reassigning file ownership
If you perform an installation while logged in as the root user, you can re-assign file ownership for all Attachmate files to another user. You can choose a user name other than the default. If this user does not exist on the system, the installation script creates it for you, and prompts you for group name, home directory, and password. If you specify a user other than the default, you must specify an existing user account for which a home directory already exists. Assigning files to a system user account such as "nobody" or "other" without an existing home directory will prevent the HTTP engine from restarting properly.
- Installing with limited rights
If you are not logged on as the root user or if you do not have root-level rights, your installation location may be limited to your own home directory.
- Installing on computers with inadequate memory
To avoid errors associated with attempting to run on a computer with limited RAM or virtual memory, edit attachmateinstalldir/catalina.sh before running the installation. Change the first value in the line
JAVA_OPTS=\"-Xms256m -Xmx256m \"\\
to something smaller, for example,
JAVA_OPTS=\"-Xms32m -Xmx256m \"\\.
If you do not make these changes, you may encounter problems. You can check for associated errors in the synapta_setup.log, such as "unable to allocate memory" or "heap allocation failure."
- Adjusting the Java VM heap size
The Java VM heap size may need to be adjusted to allow for the number of sessions or threads running in your environment. As noted above, this option can be changed in attachmateinstalldir/catalina.sh, either before or after installation.