1 Introduction
1.1 Overview
1.2 Platform Support
1.3 Theory
1.3 Theory
1.3.1 AcuConnect Configuration Files
1.3.2 Process Flow
1.4 Getting Started
1.4 Getting Started
2 Preparing Your Application
2.1 Designing Your Application
2.2 Embedding COBOL CALLs
2.2 Embedding COBOL CALLs
2.2.1 Terminating the Remote Application
2.2.2 Exception Handling
2.2.3 CALLing Multiple Programs
2.3 Synchronous or Asynchronous Execution?
2.3 Synchronous or Asynchronous Execution?
2.3.1 CALLing C$ASYNCRUN
2.3.2 CALLing C$ASYNCPOLL
2.4 Memory and Environment Issues
2.4 Memory and Environment Issues
2.5 International Character Handling
2.5 International Character Handling
2.6 Creating a Runtime Configuration File
2.6 Creating a Runtime Configuration File
2.7 Sample Programs
2.7 Sample Programs
"prog1.cbl"
"prog2.cbl"
"asynch.cbl"
3 Preparing the Server
3.1 Preparing the Server
3.2 Installing AcuConnect
3.2 Installing AcuConnect
To install AcuConnect on a UNIX server
To install AcuConnect on a Windows NT or Windows 2000 server
3.2.1 Relinking the Server Runtime
3.2.1 Relinking the Server Runtime
To relink the server runtime under Windows NT or Windows 2000
To relink the server runtime under UNIX
3.2.2 Using AcuConnect as a Stand-Alone Runtime
3.2.2 Using AcuConnect as a Stand-Alone Runtime
3.3 Establishing System Security
3.3 Establishing System Security
3.3.1 The Server Access File
3.3.1 The Server Access File
To use an existing AcuAccess file
3.3.2 Access Records
3.3.2 Access Records
3.3.3 Using the Access File Manager
3.3.3 Using the Access File Manager
To start the access file manager
To create or open an access file
To add an access record
To remove an access record
To modify an access record
To display an access record
To exit the access manager
3.4 Creating a Server Configuration File
3.4 Creating a Server Configuration File
3.4.1 ACCESS_FILE
3.4.2 DEFAULT_USER
3.4.3 PASSWORD_ATTEMPTS
3.4.4 SERVER_IP
3.4.5 SERVER_NAME
3.4.6 SERVER_PORT
3.4.7 SERVER_START_port #
3.4.8 Sample "server.cfg" file
3.5 Installing Server Programs
3.5 Installing Server Programs
3.6 AcuConnect Connection Logic
3.6 AcuConnect Connection Logic
3.6.1 Passwords
4 Preparing the Client(s)
4.1 Preparing the Client(s)
4.2 Installing the ACUCOBOL-GT Runtime
4.2 Installing the ACUCOBOL-GT Runtime
4.2.1 Relinking the Client Runtime
4.2.1 Relinking the Client Runtime
To relink the client runtime under Windows
To relink the client runtime under UNIX
4.2.2 Removing AcuConnect Client Support From the Runtime
4.2.2 Removing AcuConnect Client Support From the Runtime
To remove AcuConnect support from Windows clients
To remove AcuConnect support from UNIX clients
4.2.3 Passwords for Clients
4.2.3 Passwords for Clients
4.2.4 Setting Up the Host Name
4.2.4 Setting Up the Host Name
4.2.5 Setting Up the User Name
4.2.5 Setting Up the User Name
4.2.6 Confirming Network Services
4.2.6 Confirming Network Services
4.3 Creating a Client Configuration File
4.3 Creating a Client Configuration File
4.3.1 Defining Remote Application Path
4.3.1 Defining Remote Application Path
4.3.1.1 CODE_PREFIX
4.3.1.2 Code Name Aliases
4.3.2 Other Variables
4.3.2 Other Variables
ACUCONNECT_RUNTIME_FLAGS
ACUCONNECT_CONFIGURATION_FILE
ACUCONNECT_CLOSE_AFTER_CANCEL
DEFAULT_MAP_FILE
server_MAP_FILE
SERVER_PORT
TEXT
4.3.3 Sample "client.cfg" file
4.3.3 Sample "client.cfg" file
4.4 Installing Client Programs
4.4 Installing Client Programs
5 Accessing Applications
5.1 Accessing Applications
5.2 Starting AcuConnect on the Server
5.2 Starting AcuConnect on the Server
5.2.1 UNIX Startup
5.2.1 UNIX Startup
To start AcuConnect on unrestricted UNIX sites
To start AcuConnect on restricted UNIX sites
Running AcuConnect on HP MPE/iX systems
5.2.2 Windows NT and Windows 2000 Startup
5.2.2 Windows NT and Windows 2000 Startup
To communicate with the services
5.3 Executing Programs on the Client
5.3 Executing Programs on the Client
5.4 Stopping AcuConnect
5.4 Stopping AcuConnect
To stop AcuConnect on a UNIX server
To stop AcuConnect on a Windows NT or Windows 2000 server
5.5 Running the Sample Programs
5.5 Running the Sample Programs
To run the sample programs in UNIX
To run the sample programs in Windows
5.5.1 Results
6 Managing the System
6.1 Modifying Application Distribution
6.1 Modifying Application Distribution
6.1.1 Distribution Considerations
6.2 Machine Failures
6.2 Machine Failures
6.3 Troubleshooting
6.3 Troubleshooting
6.3.1 Technical Support
6.3.2 Unexpected User Name
6.3.2 Unexpected User Name
UNIX Diagnostics
Windows Diagnostics
6.3.3 Connection Refused
6.3.3 Connection Refused
UNIX Diagnostics
Windows Diagnostics
6.3.4 Invalid Password
6.3.4 Invalid Password
Diagnostics
6.3.5 AcuConnect Fails to Start
6.3.5 AcuConnect Fails to Start
UNIX Diagnostics
Windows NT and Windows 2000 Diagnostics
6.3.6 Problems Starting and Stopping Services
6.3.6 Problems Starting and Stopping Services
Diagnostics
A The "acuconnect" Command
A.1 The "acuconnect" Command
A.2 "acuconnect" Command Formats
Glossary of Terms
Glossary of Terms
(c) Copyright Acucorp, Inc., 1988-2001. ALL RIGHTS RESERVED.
Acucorp, Acucobol, AcuBench, AcuConnect, AcuServer, AcuSQL, Acu4GL, AcuLaunch, and extend are trademarks of Acucorp, Inc. AcuODBC is a registered trademark of Acucorp, Inc. Acu4GL is protected by U.S. patent no. 5,640,550. Other brand and product names are trademarks or registered trademarks of their holders.