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 TCP Documentation

Product Manuals

Other Publications

Contact Information

Documentation Support

Customer Support

1. Introducing BEA Connect TCP for CICS

Feature Overview

Connect TCP for CICS Architecture

Connect TCP for CICS Components

The Connect TCP for CICS Handler

The Connect TCP for CICS Pre-requester

The Connect TCP for CICS Requester

IBM TCP/IP Sockets Interface

Using Other Supported TCP/IP Sockets Products

IBM User Maintained Tables (UMT)

IBM TCP/IP Sockets for CICS Supplied Listener

Processing Scenarios

Requests from within a BEA TUXEDO Domain

Requests from within CICS

Getting Started with BEA Connect TCP for CICS

2. Understanding How BEA Connect TCP for CICS Works

Overview of Connect TCP for CICS Operations

How the Connect TCP for CICS Handler Is Initialized

How Connect TCP for CICS Processes Remote Service Requests

How the Connect TCP for CICS Handler Shuts Down

How Connect TCP for CICS Processes CICS Originated Service
Requests

How the Connect TCP for CICS Requester Shuts Down

3. Installing BEA Connect TCP for CICS

System Requirements

Host Requirements (Hardware)

Host Requirements (Software)

BEA TUXEDO Platform Requirements (Hardware)

BEA TUXEDO Platform Requirements (Software)

Installation

Prerequisite

Step 1

Step 2

Step 3

Step 4

Step 5

Step 6

Step 7

Step 8

Step 9

Step 10

Step 11

Step 12

Step 13

Step 14

Step 15

Step 16

Step 17

Step 18

Step 19

List of Distribution Files and Members

BEATCPC.DIST.CONTROL

BEATCPC.DIST.JCL

BEATCPC.DIST.OBJECT

BEATCPC.DIST.SOURCE

BEATCPC.DIST.INCLUDE

BEATCPC.DIST.PLKED

4. Configuring BEA Connect TCP for CICS

Introduction

How Connect TPS Translates Data

Introduction

BEA TUXEDO Terminology

Data Translation Rules

Strings and Numeric Data: A Closer Look

Including NULL Characters in String Length Calculations

Converting Numeric Data

5. Administering BEA Connect TCP for CICS

Starting BEA Connect TCP for CICS

Starting the Listener Program

Invoking Connect TCP for CICS

Starting the Requester Program

Administrative Commands

The printdomain Subcommand

Syntax and Usage

Example

The stats Subcommand

Syntax and Usage

Example

The BEA Connect TCP Maintenance System

Menu Navigation

The Main Menu

Usage

The Connections Screens

The Connections Update Screen (C2)

The Connections Inquire Screen (C3)

The Connections Browse Screen (C5)

The Requester Screens

The Insert Requester Screen (R1)

The Update Requester Screen (R2)

The Inquire Requester Screen (R3)

The Delete Requester Screen (R4)

The Browse Requester Screen (R5)

The Service Screens

The Service Insert Screen (S1)

The Service Update Screen (S2)

The Service Inquire Screen (S3)

The Service Delete Screen (S4)

The Service Browse Screen (S5)

6. Programming BEA Connect TCP for CICS

Programming Considerations

Introduction

Buffer Layout Issues

Making Calls from a CICS Client Program

Examples

Error Handling

Gateway Errors

MVS or CICS Errors

Application Errors

Application Server Considerations

A. Error and Informational Messages

Messages Returned to the Remote Gateway

Messages Written to the BEA Connect CICS Log

Codes Returned to a CICS Client Program

Informational Process Messages

Data Field Error Messages

System Error Messages