Introducing BEA Tuxedo Mainframe Adapter for TCP (IMS)
What You Need to Know
Features/Benefits
BEA TMA TCP for IMS Architecture
BEA Tuxedo Mainframe Adapter for TCP Functionality
Domains-based Gateway Connectivity
Required System Components
BEA TMA Gateway Program
IBM LE/370
IBM TCP/IP for z/OS
IMS Server Transactions
IMS Client Transactions
Understanding How BEA TMA TCP for IMS Works
Inbound Processing
Outbound Processing
How BEA TMA TCP for IMS Is Initialized
Processing IMS Server Requests
Processing IMS Client Requests
Two Phases of an IMS Client Request
How BEA TMA TCP for IMS Processes an IMS Client Request
How BEA TMA TCP for IMS Shuts Down
Configuring BEA 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 BEA 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
Changing IMS Host Configurations
Changing Remote Service Definitions
Modifying an Existing Remote Service
Changing Local Service Definitions
Modifying an Existing Local Service
Display Status Information
Monitoring BEA TMA TCP for IMS
Testing Connectivity with Remote Systems
Monitoring and Troubleshooting OTMA
Operating BEA TMA TCP for IMS
Initialization
Normal Operation
Issuing Session-related Messages
Termination
The BEA TMA TCP for IMS Message Log
Message Format
z/OS Console Messages
The Server Response Log File
Programming BEA 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 BEA TMA TCP Gateway Translates Data
BEA Tuxedo Buffer Types
Data Translation Rules
Strings and Numeric Data: A Closer Look
Including NULL Characters in String Length Calculations
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 BEA 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)
OTMA Destination Resolution User Exit (DFSYDRU0)
Sample IMS Client and Server Transactions
IMS Server Transaction
BEASVR01 - A Sample IMS Server Transaction
IMS Client Transactions
Request Phase
Response Phase
BEACRQ01 - A Sample IMS Client Request Transaction
BEACRP01 - A Sample IMS Client Response Transaction
BEACRR01 - A Sample IMS Client Request/Response Transaction
Error and Reason Codes
Glossary