CICS User Guide

Introducing Tuxedo Mainframe Adapter for TCP (CICS)

What You Need to Know

Oracle TMA TCP for CICS Architecture

Oracle TMA TCP Functionality

Domains-based Gateway Connectivity

Security

Domain Name Server Support

Dynamic Configuration

Load Balancing of a Requester

Automatic Enabling of LMID

Oracle TMA TCP for CICS Components

The TMA TCP for CICS Handler

The TMA TCP for CICS Application Handler

The TMA TCP for CICS Pre-requester

The TMA 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 an Oracle Tuxedo Domain

Requests from within CICS

Getting Started with TMA TCP for CICS

Understanding How Oracle TMA TCP for CICS Works

Starting the Listener Program

Running Oracle TMA 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 TMA TCP for CICS Originated Service Requests

Shutting Down the Requester

Using BDWN to Shut Down the Requester

Translating Data with TMA TCP gateway

Oracle Tuxedo Terminology

Data Translation Rules

Strings and Numeric Data: A Closer Look

Including NULL Characters in String Length Calculations

Converting Numeric Data

Configuring the TMA TCP Security

Service Request Processing with Security

Security Checking from UNIX to Mainframe

Security Checking from Mainframe to UNIX

Setting Up Security for TMA 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 Oracle TMA 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 TMA TCP for CICS

Modifying Outbound Services

Modifying User Connection Accounts

Modifying Connections

Deleting Requester LMIDs

Administering the Gateways

Programming Oracle Tuxedo Mainframe Adapter for TCP (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 TMA TCP for CICS Log

Codes Returned to a CICS Client Program

Informational Process Messages

Data Field Error Messages

System Error Messages