AcuConnect Version 4.3 User's Guide

Table of Contents

Introduction
Overview Overview Platform Support Platform Support Theory Theory AcuConnect Configuration Files Process Flow Synchronous or Asynchronous Operation Getting Started Getting Started Preparing Your Application
Designing Your Application Designing Your Application Embedding COBOL CALLs Embedding COBOL CALLs Terminating the Remote Application Exception Handling Synchronous or Asynchronous Execution Synchronous vs. Asynchronous CALLs CALLing C$ASYNCRUN CALLing C$ASYNCPOLL Memory/Environment Issues Memory/Environment Issues Runtimes Memory Environment Open Connections EXTERNAL Data Items CHAIN Command International Character Handling International Character Handling Creating a Runtime Configuration File Creating a Runtime Configuration File Sample Programs Overview of Samples "prog1.cbl" "prog2.cbl" "asynch.cbl" Preparing the Server
Four Basic Steps Four Basic Steps Installing AcuConnect Installing AcuConnect Installing AcuConnect UNIX Installation Windows NT (Intel) Installation Relinking the Server Runtime Relinking the Server Runtime Relinking under Windows NT (Intel) Relinking under UNIX Using AcuConnect as a Stand-Alone Runtime Using AcuConnect as a Stand-Alone Runtime Establishing System Security Establishing System Security Windows NT (Intel) Access Permissions UNIX Ownerships and Permissions The Server Access File (AcuAccess) The Server Access File Using an Existing AcuAccess File Access Records The Access File Manager Using the Access File Manager Starting the access file manager Creating or opening an access file Adding an access record Removing an access record Modifying an access record Displaying an access record Exiting the access manager Creating a Server Configuration File Creating a Server Configuration File ACCESS-FILE Configuration Variable DEFAULT-USER Configuration Variable PASSWORD-ATTEMPTS Configuration Variable SERVER-IP Configuration Variable SERVER-NAME Configuration Variable SERVER-PORT Configuration Variable SERVER-START-<port #> Configuration Variable Sample "server.cfg" file Installing Server Programs Installing Server Programs AcuConnect Connection Logic AcuConnect Connection Logic Passwords Preparing the Client Three Basic Steps Three Basic Steps Installing the ACUCOBOL-GT Runtime Installing the ACUCOBOL-GT Runtime Passwords for clients Setting up the host name Setting up the user name Confirming network services Relinking the Client Runtime Relinking the Client Runtime Relinking under MS Windows Relinking under Windows 95/98 and Windows NT (Intel) Relinking under UNIX Removing AcuConnect client support from the runtime Removing Client Support in Windows 3.x Removing Client Support in Windows 95/98/NT Removing Client Support in UNIX Creating a Client Configuration File Creating a Client Configuration File Creating a Client Configuration File Defining Remote Application Paths Defining Remote Application Path CODE-PREFIX Code Name Aliases Other Variables Other Variables ACUCONNECT-CLOSE-AFTER-CANCEL ACUCONNECT-CONFIGURATION-FILE ACUCONNECT-RUNTIME-FLAGS DEFAULT-MAP-FILE <server>-MAP-FILE SERVER-PORT (on the client) TEXT Sample "client.cfg" file Sample "client.cfg" file Installing Client Programs Installing Client Programs Accessing Applications Accessing Applications Accessing Applications Starting AcuConnect on the Server Starting AcuConnect on the Server UNIX Start-up Windows NT (Intel) Start-up Communicating with the services Executing Programs on the Client Executing Programs on the Client Stopping AcuConnect UNIX Shut-Down Windows NT (Intel) Shut-Down Running the Sample Programs Running the Sample Programs In UNIX In Windows 95/98/NT In Windows 3.x Results Managing the System Modifying Application Distribution Modifying Application Distribution Distribution Considerations When to Use a Fat Client When to Use a Thin Client When to Use a Smart Client Troubleshooting AcuConnect Fails to Start Connection refused Invalid password Machine Failures Problems starting/stopping services Unexpected user name Technical Support The acuconnect Command The acuconnect Command acuconnect Command Formats