Sun MTP Client User's Guide

Release 7.2

816-2797-11

Contents

Preface

How This Book Is Organized

Using UNIX Commands

Typographic Conventions

Shell Prompts

Related Documentation

Accessing Sun Documentation

Sun Welcomes Your Comments

1. Overview

Capabilities of Sun MTP Client

Supported Transport Protocols

TCP/IP

SNA

Operating Requirements

Terminology

2. Installation

Installing Sun MTP Client on Windows

To Install Sun MTP Client on Windows

Installing Sun MTP Client on Solaris

3. Configuring Sun MTP Client and Sun MTP

Configuring Sun MTP Client

Adding Systems to the KIXCLI.INI File

Required Fields for a TCP/IP-Connected System

Required Fields for an SNA-Connected System

Defining Client Behavior in the KIXCLI.INI File

Enabling and Disabling a Diagnostic Trace

To Run the Diagnostic Trace

To Disable the Diagnostic Trace

Configuring Sun MTP for a TCP/IP Connection to Sun MTP Client

To Configure Sun MTP

Configuring Sun MTP and SNA for an SNA-Connected Sun MTP Client

4. Starting Sun MTP Client and Sun MTP

Starting Sun MTP Client on Windows

Starting Sun MTP Client on Solaris

Enabling Sun MTP to Receive Connections

5. Sun MTP Client Administration

Administering Sun MTP Client on Windows

Control Panel

TCP Systems Panel

MS SNA Systems Panel

Messages Panel

Administering Sun MTP Client on Solaris

6. 3270 Terminal

Configuring the 3270 Terminal

To Configure Using Command Line Parameters

To Configure Using the Initialization File

Starting the 3270 Terminal

To Start the 3270 Terminal From the 3270 Terminal Icon

To Start the 3270 Terminal From a Command Line

3270 Terminal Screen

Stopping the 3270 Terminal

To Shut Down the 3270 Terminal

7. 3270 Printer

Configuring the 3270 Printer

To Configure the Printer

Example kixprnt Commands

Starting the 3270 Printer

To Start the 3270 Printer From the 3270 Printer Icon

To Start the 3270 Printer From a Command Line

3270 Printer Screen

Stopping the 3270 Printer

To Stop the Printer

8. External Call Interface (ECI)

ECI Example Code

How Does the Sun MTP ECI Work?

CICS_ExternalCall Call Types

Program Link Calls

Reply Solicitation Calls

Status Information Calls

Application Design

Managing Logical Units-of-Work

Designing an Application for Windows

Designing an Application for Solaris

ECI Data Structures

ECI Functions

CICS_ExternalCall()

CICS_EciListSystems()

KixCli_QueryFD()

Common ECI Scenarios

Performing a One-Shot DPL

Performing a One-shot Asynchronous DPL Using Message Notification

Performing a One-Shot Asynchronous DPL Using Semaphore Notification

Performing a One-Shot Asynchronous DPL Using Callback Notification

Performing a One-Shot Synchronous DPL

Starting a Multiple Part Unit-of-Work

Continuing a Long Running Unit-of-Work

Explicitly Syncpointing a Unit-of-Work

Rolling Back a Unit-of-Work

Interrogating Connections to a Remote System

Using Callbacks

Sun MTP ECI Interface Enhancements

Reply Message Formats

9. External Presentation Interface (EPI)

EPI Examples

Developing an EPI Application

Initializing and Terminating EPI

Adding and Deleting EPI Terminals

Starting Transactions

Processing Events

Event Notification on Windows

Event Notification on Solaris

Sending and Receiving Data

EPI Constants and Data Structures

Constants

Standard Data Types

Data Structures

CICS_EpiSystem_t

CICS_EpiDetails_t

CICS_EpiEventData_t

CICS_EpiSysError_t

CICS_EpiNotify_t

CICS_EpiEvent_t

CICS_EpiEnd_t

CICS_EpiATIState_t

CICS_EpiSenseCode_t

CICS_EpiWait_t

EPI Events

CICS_EPI_EVENT_SEND

CICS_EPI_EVENT_CONVERSE

CICS_EPI_EVENT_END_TRAN

CICS_EPI_EVENT_START_ATI

CICS_EPI_EVENT_END_TERM

EPI Functions

CICS_EpiInitialize()

CICS_EpiTerminate()

CICS_EpiListSystems()

CICS_EpiAddTerminal()

CICS_EpiDelTerminal()

CICS_EpiStartTran()

CICS_EpiReply()

CICS_EpiATIState()

CICS_EpiSenseCode()

CICS_EpiGetEvent()

CICS_EpiGetSysError()

CICS_EpiInquireSystem()

A. KIXTERM.INI

Identifying File Comments

Key Mappings

Defining the Normal and Light Colors for a Terminal

Mapping Colors

Resetting a Keyboard

B. Messages

Examining Messages

Message Format

Sun MTP Client Messages

Emulator Messages

Glossary

Index