eLink TCP for CICS User Guide

 

 

Introducing BEA eLink TCP for CICS

BEA eLink TCP for CICS Architecture

BEA eLink TCP Functionality

Domains-based Gateway Connectivity

Security

Domain Name Server Support

Dynamic Configuration

BEA eLink TCP for CICS Components

The eLink TCP for CICS Handler

The eLink TCP for CICS Application Handler

The eLink TCP for CICS Pre-requester

The eLink TCP for CICS Requester

IBM TCP/IP Sockets Interface

Using Other Supported TCP/IP Sockets Products

IBM TCP/IP Sockets for CICS Supplied Listener

IBM User Maintained Tables (UMT)

Processing Scenarios

Requests from within a BEA Tuxedo Domain

Requests from within CICS

Getting Started with eLink TCP for CICS

 

Understanding How BEA eLink TCP for CICS Works

Starting the Listener Program

Running BEA eLink TCP for CICS

Initializing the Handler

Processing Remote Service Requests

Shutting Down the Handler

Using BDWN to Shut Down the Handler

Starting the Requester Program

Processing eLink TCP for CICS Originated Service Requests

Shutting Down the Requester

Using BDWN to Shut Down the Requester

Translating Data with eLink TCP for Tuxedo

BEA Tuxedo Terminology

Data Translation Rules

Strings and Numeric Data: A Closer Look

Including NULL Characters in String Length Calculations

Converting Numeric Data

 

Configuring the eLink TCP Security

Service Request Processing with Security

Security Checking from UNIX to Mainframe

Security Checking from Mainframe to UNIX

Setting Up Security for eLink TCP for CICS

Securing User Connections

Securing Inbound Services

Securing Outbound Connections from CICS to UNIX

Securing Outbound Connections from CICS to CICS

Securing Outbound Connections from CICS to IMS

Securing Outbound Services

 

Configuring and Administering BEA eLink TCP for CICS

Menu Navigation

The Main Menu

Usage

The Connection Screens

PF Keys

Update Connection Screen (C2)

Fields

Inquire Connection Screen (C3)

Fields

Browse Connection Screen (C5)

The Requester Screens

PF Keys

Insert Requester Screen (R1)

Fields

Update Requester Screen (R2)

Fields

Inquire Requester Screen (R3)

Fields

Delete Requester Screen (R4)

Fields

Browse Requester Screen (R5)

The Outbound Service Information Screens

PF Keys

Insert Outbound Service Information Screen (S1)

Fields

Update Outbound Service Information Screen (S2)

Fields

Inquire Outbound Service Information Screen (S3)

Fields

Delete Outbound Service Information Screen (S4)

Fields

Browse Outbound Service Information Screen (S5)

The User Connection ACCOUNT Screens

PF Keys

Insert User Connection ACCOUNT Screen (U1)

Fields

Update User Connection ACCOUNT Screen (U2)

Fields

Inquire User Connection ACCOUNT Screen (U3)

Fields

Delete User Connection ACCOUNT Screen (U4)

Fields

The Browse User Connection ACCOUNT Screen (U5)

The Inbound Service Information Screens

PF Keys

Insert Inbound Service Information Screen (I1)

Fields

Update Inbound Service Information Screen (I2)

Fields

Inquire Inbound Service Information Screen (I3)

Fields

Delete Inbound Service Information Screen (I4)

Fields

The Browse Inbound Service Screen (I5)

The Handler Configuration Screens

PF Keys

Update Handler Configuration Screen (H2)

Fields

Inquire Handler Configuration Screen (H3)

Fields

Dynamically Configuring eLink TCP for CICS

Modifying Outbound Services

Modifying User Connection Accounts

Modifying Connections

Deleting Requester LMIDs

Configuring eLink TCP for CICS with Interlink CPT

Recommended Configuration

Administering the Gateways

 

Programming BEA eLink TCP for CICS

Client Application Considerations

Buffer Layout Issues

Making Calls from a CICS Client Program

Examples

Error Handling

Gateway Errors

MVS or CICS Errors

Application Errors

Server Application Considerations

Programming Services with a Response

Programming Services without a Response

Modifying the Length of the Return Message

Modifying Return Message Lengths for C Programs

Modifying Return Message Lengths for COBOL Programs

 

Error and Informational Messages

Messages Returned to the Remote Gateway

Messages Written to the eLink TCP for CICS Log

Codes Returned to a CICS Client Program

Informational Process Messages

Data Field Error Messages

System Error Messages