Contents

Title Page

Copyright Page

Preface

Purpose of This Manual

Who Should Read This Manual

Prerequisites

How This Manual Is Organized

How to Use This Manual

Online Document Considerations

Opening the Manual in a Web Browser

Printing from a Web Browser

Document Conventions

Related Documentation

Connect Documentation

Product Manuals

Other Publications

Contact Information

Documentation Support

Customer Support

1. Introducing BEA Connect TPS

Connect TPS and the BEA TUXEDO Architecture

Connect TPS Components

The Liaison (TPSL)

Requesters (TPSR)

Handlers (TPSH)

How Connect TPS Affects BEA TUXEDO Application Programs

VIEW Definitions

FML Buffer Support

How Connect TPS Affects BEA TUXEDO Administration

2. Understanding How BEA Connect TPS Works

Initializing Connect TPS

How Connect TPS Processes Local Service Requests

Step 1: Receiving a Service Request from BEA TUXEDO Software

Step 2: Connecting to a Remote System

Step 3: Converting Input Buffer Types

Step 4: Translating Input Data

Step 5: Transmitting the Service Request

Step 6: Receiving a Reply

Step 7: Translating the Reply

Step 8: Converting Output Data

Step 9: Sending the Reply to the Caller

How Connect TPS Processes Remote Service Requests

How Connect TPS Shuts Down

Programming Considerations

Introduction

Input and Output Issues

Preparing Input and Output Data with Connect TPS

Service Request Parameters

Output Data Considerations

Error Handling

Gateway Errors

Remote System Failures

Application Errors

Limitations on the Use of Certain ATMI Functions

Conversational Communication Functions

Non-Transactional Communications

Client Authentication Keys and Client Identifiers

The tpsprio() and tpgprio() Functions

The tpbroadcast() and tpnotify() Functions

3. Installing and Getting Ready to Configure BEA Connect TPS

How to Install BEA Connect TPS

Installing BEA Connect TPS on UNIX

Installing BEA Connect TCP on MVS

Installing BEA Connect TPS on Windows NT

How Connect TPS Converts Input and Output Data

Buffers and Records

Buffers Received from Local Programs

Records Received from Remote Programs

Configuration Parameters for Managing Conversion

Parameters for Locally Originated Calls

Guidelines for Mapping Input Buffers to Input Records

The INBUFTYPE Parameter

The INRECTYPE Parameter

Guidelines for Mapping Output Records to Output Buffers

The OUTRECTYPE Parameter

The OUTBUFTYPE Parameter

Parameters for Remotely Originated Calls

Guidelines for Mapping Input Records to Input Buffers

The INRECTYPE Parameter

The INBUFTYPE Parameter

Guidelines for Mapping Output Buffers to Output Records

The OUTBUFTYPE Parameter

The OUTRECTYPE Parameter

Guidelines for Setting Parameters

Mapping Input Buffers to Input Records

Setting the INBUFTYPE and INRECTYPE Parameters

Mapping Output Records to Output Buffers

Setting the OUTRECTYPE and OUTBUFTYPE Parameters

How Connect TPS Translates Data

Introduction

Data Translation Rules

Strings and Numeric Data: A Closer Look

NULL Characters in String Length Calculations (C Programs)

NULL Characters in String Length Calculations
(COBOL Programs)

Converting Numeric Data

How the Connect TPS Configuration Helps with Error Handling

Introduction

Configuration Parameters for Managing Application Errors

Example

Creating VIEW Definitions to Facilitate Buffer Conversion

Introduction

Preparing VIEW Definitions

4. Configuring BEA Connect TPS

Introduction

Updating the TUXEDO UBBCONFIG File

Updating the *GROUPS Section

Overview

Syntax

Example

Updating the *SERVERS Section

Overview

Syntax

Other Options for Configuring Servers

Example

The TPSINIT File: An Introduction

Sections in the TPSINIT File

General Suggestions and Observations

Updating the *GENERAL Section of the TPSINIT File

Description

Syntax

Parameters

Updating the *GATEWAYS Section of the TPSINIT File

Description

Syntax

The Reserved Word DEFAULT:

The Nodename Tag

Parameters

Updating the *SERVICES Section of the TPSINIT File

Description

Syntax

The Reserved Word DEFAULT:

The Svc_name Tag

Parameters

5. Starting BEA Connect TPS

Setting Environment Variables

Invoking Connect TPS

Testing Connectivity with Remote Regions

6. Administering BEA Connect TPS

Introduction

The printdomain Subcommand

Description

Syntax and Usage

Example

The stats Subcommand

Description

Syntax and Usage

Example

The mode Subcommand

Description

Syntax and Usage

A. Operational Considerations and Compatibility

Operational Considerations

Compatibility

B. Customizing Character Set Mapping Tables

Introduction

The Character Set Mapping Table

Customizing a Character Set

Step 1: Copy the Appropriate Source File

Step 2: Edit the Source File Copy

Introduction

Contents of Set 1

Contents of Set 2

Editing Character Mappings

Step 3: Validate the Source File Copy

Step 4: Generate the Catalog File

Step 5: Configure Connect TPS to Use the New Catalog File

C. BEA Connect TPS Error Messages