IMS User Guide

Introducing Oracle Tuxedo Mainframe Adapter for TCP (IMS)

What You Need to Know

Features/Benefits

Oracle TMA TCP for IMS Architecture

Oracle Tuxedo Mainframe Adapter for TCP Functionality

Domains-based Gateway Connectivity

Security

Domain Name Server Support

Dynamic Configuration

Required System Components

Oracle TMA Gateway Program

IBM LE/370

IBM TCP/IP for z/OS

IMS Server Transactions

IMS Client Transactions

Understanding How Oracle TMA TCP for IMS Works

Inbound Processing

Outbound Processing

How Oracle TMA TCP for IMS Is Initialized

Processing IMS Server Requests

Processing IMS Client Requests

Two Phases of an IMS Client Request

How Oracle TMA TCP for IMS Processes an IMS Client Request

How Oracle TMA TCP for IMS Shuts Down

Configuring Oracle Tuxedo Mainframe Adapter for TCP Security

Security Checking from Tuxedo to Mainframe

Security Checking from Mainframe to UNIX

Setting Up Security for TMA TCP for IMS

Securing Connections from IMS to UNIX

Securing Connections from IMS to IMS

Securing Connections from IMS to CICS

Securing Services

Configuring Oracle TMA TCP for IMS

System Configuration Parameters

Syntax of the SYSTEM Statement

Description of SYSTEM Parameters

Defining the Local Host

Syntax of the HOST Statement

Description of HOST Parameters

Defining the Local Gateway

Syntax of the GATEWAY TYPE=LOCAL Statement

Description of GATEWAY TYPE=LOCAL Parameters

Defining Remote Gateways

Syntax of the GATEWAY TYPE=REMOTE Statement

Description of GATEWAY TYPE=REMOTE Parameters

Defining Remote Services

Syntax of the SERVICE TYPE=REMOTE Statement

Description of SERVICE TYPE=REMOTE Parameters

Defining Local Services

Syntax of the SERVICE TYPE=LOCAL Statement

Description of SERVICES Parameters

Dynamically Configuring TMA TCP for IMS

Modifying SYSTEM Parameters

Writing the Configuration to a File

Processing a File

Changing Gateway Configurations

Adding a Gateway

Starting a Gateway

Stopping a Gateway

Modifying an Existing Gateway

Changing IMS Host Configurations

Adding a Host

Starting a Host

Modifying an Existing Host

Stopping a Host

Changing Remote Service Definitions

Adding a Remote Service

Stopping a Remote Service

Modifying an Existing Remote Service

Starting a Remote Service

Changing Local Service Definitions

Adding a Local Service

Stopping a Local Service

Modifying an Existing Local Service

Starting a Local Service

Display Status Information

Monitoring Oracle TMA TCP for IMS

Testing Connectivity with Remote Systems

Monitoring and Troubleshooting OTMA

Operating Oracle TMA TCP for IMS

Initialization

Normal Operation

Operator Commands

Issuing Session-related Messages

Termination

SHUTDOWN Command

A Client-Initiated Shutdown

The Oracle TMA TCP for IMS Message Log

Message Format

z/OS Console Messages

The Server Response Log File

Programming Oracle TMA TCP for IMS

Programming Your Application

Programming Interface

IMS Server Requests

Message Format

Field Descriptions

Header Files and Copybooks

Returning a Response

OTMA Client Gateway

IMS Client Requests

Message Format

Field Descriptions

Header Files and Copybooks

Error Handling

Types of Errors

Other Errors

How Oracle TMA TCP Gateway Translates Data

Oracle Tuxedo Buffer Types

Data Translation Rules

Strings and Numeric Data: A Closer Look

Including NULL Characters in String Length Calculations

Converting Numeric Data

System Services Descriptions

TCP/IP for z/OS

LE/370

z/OS

Error and Informational Messages

Logical Machine IDs

Messages Returned to the Remote Gateway

Messages Written to the Oracle TMA TCP for IMS Message Log

Example Configuration Files

Sample JCL and User Exits

JCL for Executing TMA TCP for IMS

Executing TMA TCP for IMS

Sample User Exits Enabling IMS Clients to Communicate to Remote Services

OTMA Prerouting User Exit (DFSYPRX0)

Sample DSECT BEAOTM

OTMA Destination Resolution User Exit (DFSYDRU0)

Sample IMS Client and Server Transactions

IMS Server Transaction

BEASVR01 - A Sample IMS Server Transaction

Notes

IMS Client Transactions

Request Phase

Response Phase

BEACRQ01 - A Sample IMS Client Request Transaction

Notes

BEACRP01 - A Sample IMS Client Response Transaction

Notes

BEACRR01 - A Sample IMS Client Request/Response Transaction

Notes

Error and Reason Codes

Glossary