Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Organization

Related Documentation

Conventions

1 Introduction

What is CICS?

System Requirements and Platforms

Definitions

Logical Unit (LU)

CPI-C

2 Installation and Configuration

Installing the CICS Adapter

Preinstallation Tasks

Installation Tasks

CICS Adapter Configuration

Using the Application Parameter

adapter.ini Initialization Parameter File

Hub.ini

Agent Connection Parameters

CICS Adapter Parameters

3 CICS and the CICS Adapter

The CICS Adapter

Message Description Language (MDL)

Classes

LU6.2 CPI-C Protocol Stack, ECI Protocol Stack, and URLs

How the CICS Adapter Communicates With CICS

Using SNA LU 6.2 CPI-C Protocol API

Using the ECI Protocol API

CICS Adapter Security

Using the LU 6.2 CPI-C Protocol

Using the ECI Protocol

Implementing the CICS Adapter

SNA LU 6.2 CPI-C Protocol API

ECI Protocol API

CICS Adapter

CICS Adapter Information Flow

Multi-Threading

Using the CICS Adapter Inbound

SNA LU 6.2 CPI-C Protocol

Application Start-up

Receiving a CICS Adapter Request from Oracle9iAS InterConnect

ECI Protocol

Application Start-up

Receiving a CICS Adapter Request from Oracle9iAS InterConnect

Design Time

Runtime

Creating an Implemented Procedure

Creating a Subscribed Event

4 Systems Network Architecture Definitions

LU 6.2 CPI-C Protocol Stack and URLs

Concepts and Terms

ABEND

Advanced Program-to-Program Communication (APPC)

CICS

CICS Region

CICS Transaction

Conversation

CPI Communications (CPI-C)

Logical Unit

Mode Name

Node

Node Type

Physical Unit (PU)

Session

System Management Facility (SMF)

Systems Network Architecture (SNA)

Systems Network Architecture (SNA) Controllers

Synchronization Levels

Synchronization Services

Transaction Program (TP)

Verb Control Block (VCB)

Verbs

CICS as a Transaction Program

5 Systems Network Architecture Concepts

Data Flow

Logical Units and Parallel Sessions

CICS Adapter Conversations

Security

LU 6.2 Security

Session Level Security

Session Level Cryptography

LU-LU Verification

Conversation Level Security

End-User Verification

Already-Verified Protocols

Persistent Verification

Password Expiration Management

CICS Security Implementation

Bind Time Security

Security For CICS in General

Security Specific to LU 6.2

User Security

Synchronization of Changes

Error Handling

6 Message Description Language Reference

What is Message Description Language?

Message Description Language Classes

Message Description Language File

Class Declaration

Typedef Declaration

Struct Declaration

Method Declaration

Return Type Declaration

Argument Declarations

Supported Data Types

Binary Types

Integral Types

Floating Point Types

String Types

Length-Prefixed Strings

Delimited Strings

Null Terminated Strings

Fixed-Length Padded Strings

Implicit Strings

Complex Types

Date Types

Numerical Types

Floating Point Numbers

Fixed Scale, Variable Precision Numbers

Fixed Scale, Fixed Precision Numbers

Packed Decimal

Array Types (Tables)

Fixed Length Tables

Prefixed Variable Length Tables

Explicitly Delimited Variable Length Sequences

Implicitly Delimited Variable Length Sequences

Structured Types

Message Description Language File Format General Syntax Conventions

Type parameters

Type modifiers

Keyword Modifiers

Type Declaration Modifiers

Expression

Alias

Comment Insertion

Case Sensitivity

Message Description Language File Example

7 Using the Configuration Editor

Using the Configuration Editor

Configuration Editor Login

General

Mode Name

Synchronization Level

Configuration Editor Security

Index