Sun Logo


Sun Mainframe Transaction Processing Software Configuration Guide

Release 8.0.1

816-5328-11



Contents

Figures

Tables

Code Samples

Preface

1. Introduction to Configuring Sun MTP

Configuration Tasks

Sun MTP Standards

Screen Formats

Function Keys

Data Entry Validation

File Identifiers

2. Setting Region Environment Variables

Region Configuration Tasks

Creating a Directory Structure

Environment Variables

Standard Environment Variables

Sun MTP Secure Environment Variables

Sun MSF Environment Variables

Defining a Region's Environment

Defining and Executing a Setup File

Setting Environment Variables in a Login File

procedure iconsmall spaceTo Set the Environment Variables for the User Automatically at Login

Setting Environment Variables in the Bourne or Korn Shell .profile File

Setting Environment Variables in the C Shell .login File

3. Starting and Stopping Sun MTP

Starting the Sun MTP Server

procedure iconsmall spaceTo Start the Server

Starting a Local Client

procedure iconsmall spaceTo Make a Local Connection

Executing a Transaction

procedure iconsmall spaceTo Execute a Transaction

Shutting Down Sun MTP

Shutting Down a User Session

Shutting Down the Sun MTP Server

Shutting Down the Region From Within Sun MTP

Shutting Down the Region Using kixstop

Client Connections

4. Configuration Guidelines

Sun MTP Transaction Servers

Determining the Number of Transaction Servers

Determining the Maximum Number of Background Tasks

Determining the Maximum Number of Batch Jobs

Determining the Maximum Number of Query Jobs

Choosing a Recovery Method

Effect of Recovery on Configuration

Determining the Number of Sun MTP Processes

Shared Memory Requirements

Calculating Shared Memory Requirements

Determining Where to Attach Shared Memory

Heap Space

Shared Library Usage

Where to Attach Sun MTP Shared Memory

Determining the VSAM Buffer Size

Determining Swap Space

Kernel Parameters

Changing Kernel Parameters

5. Defining Application Resources

Opening Table Manager

procedure iconsmall spaceTo Open Table Manager

procedure iconsmall spaceTo Display the Standard Tables Menu

Customizing the VCT

procedure iconsmall spaceTo Customize the VCT

Defining Transactions in the PCT

procedure iconsmall spaceTo Define Transactions

Defining VSAM Files in the FCT

procedure iconsmall spaceTo Define Files

Defining Resources in the PPT

procedure iconsmall spaceTo Define Online Programs and Maps

Customizing the SIT

procedure iconsmall spaceTo Customize the SIT

6. Configuring Recovery

Setting Up the NRFS Partition

procedure iconsmall spaceTo Set Up the NRFS Partition

Configuring Recovery in the VCT

procedure iconsmall spaceTo Configure Recovery

procedure iconsmall spaceTo Change Recovery Methods

Configuring Recovery on VSAM Datasets

procedure iconsmall spaceTo Specify Recovery for KSDS and RRDS Files

Configuring Recovery for ESDS Datasets

7. Alternate Resource Definition

Resource Types and Commands

Supported Commands

Enabling the Region for Alternate Resource Definition

procedure iconsmall spaceTo Define the rdo Group

Adding the Resource Definition File

procedure iconsmall spaceTo Define the DFHUSD File in the Catalog

Configuring Resources

Enabling Resources During Region Startup

procedure iconsmall spaceTo Enable Resources During Startup

Managing Resources

Advantages and Disadvantages of Using Alternate Resource Definition

8. Configuring a UNIX Terminal

Key Files

Creating or Editing a Key File Using kixkeydef

procedure iconsmall spaceTo Create or Modify a Key File Using kixkeydef

procedure iconsmall spaceTo Define a Return Key, a Linefeed Key, and a Backspace Key

Editing a Key File Directly

Sun MTP X Client Definitions

Initializing ASCII Terminals

9. Configuring Printers

Configuring the Default Printer

procedure iconsmall spaceTo Configure the Default Printer

Configuring Additional Printers

Configuring Printers That Use Transient Data Queues

procedure iconsmall spaceTo Define a TDQ as a Printer in the DCT

procedure iconsmall spaceTo Associate the TDQ with a Printer

Specifying Printer Sizes

Configuring Printers With kixprint

Modifying the kixprint Shell Script

10. Configuring Intersystem Communications (ISC)

Supported ISC Functions

Configuring a Region for SNA

Setting Up Communications Manager

procedure iconsmall spaceTo Configure unikixCommMgr to Start unikixdcl

Defining the Remote System

procedure iconsmall spaceTo Define the Remote System

Configuring a Region for TCP/IP

procedure iconsmall spaceTo Configure the TCP Server (unikixtcp)

Transaction Security

Autoinstalling Remote Regions

11. Configuring Sun MTP for Remote Clients

Configuring a Region for TN3270 Clients

procedure iconsmall spaceTo Set Up the TN3270 Server

Setting Up Communications Manager for TN3270 Connections

procedure iconsmall spaceTo Configure unikixCommMgr

Configuring a Region for SNA 3270 Clients

Configuring the TPS PU4/5 Server

PU2 Configuration

PU4/5 Configuration

Configuring a Region to Work With the TPS PU4/5 SNA Server

procedure iconsmall spaceTo Configure the Region

Configuring a Region for ECI/EPI Clients

procedure iconsmall spaceTo Configure a Region to Accept ECI/EPI Clients

Autoinstalling ECI/EPI Clients

Starting the TCP/IP Socket Listener

procedure iconsmall spaceTo Start the unikixsock Process

Configuring a Region for SSL Clients

procedure iconsmall spaceTo Configure a Region to Accept SSL Requests

Setting Up the Certificate Databases

Setting Up the Communications Manager for the unikixssl Server

procedure iconsmall spaceTo Configure unikixCommMgr to Start unikixssl

procedure iconsmall spaceTo Start the Region and the SSL Server

Configuring a Region for MQSeries Clients

procedure iconsmall spaceTo Configure unikixCommMgr to Start the unikixqm Server

12. Configuring Sun MTP to Work With Sun MBM

Enabling Sun MBM in the VCT

procedure iconsmall spaceTo Enable Sun MBM in the VCT

Defining a VSAM File as Nonreusable

procedure iconsmall spaceTo Define a VSAM File as Nonreusable Using File Manager

procedure iconsmall spaceTo Define Files as Nonreusable Using the Utilities

13. Configuring a Region to Work With an RDBMS

Setting RDBMS Environment Variables

Selecting an RDBMS Using kixinstall

procedure iconsmall spaceTo Select an RDBMS

Specifying RDBMS Values in the SIT

procedure iconsmall spaceTo Set RDBMS-Specific Values in the SIT

Oracle Caveats

Starting a Region With an RDBMS

procedure iconsmall spaceTo Start the Region With an RDBMS

Bypassing the RDBMS at Startup

procedure iconsmall spaceTo Bypass the RDBMS

14. Enabling DBCS Support

Prerequisites

Enabling DBCS for a Region

procedure iconsmall spaceTo Enable Support for DBCS

Using DBCS and ISC

procedure iconsmall spaceTo Define Data Conversion Templates

Conversion Tables

Usage Considerations

A. Keyboard Mapping

NCD 101-Key Keyboards

NCD 97-Key Keyboards

VT-type Keyboards

Sun Keyboards

Default X Keyboards

Desktop Terminal Keyboards

Glossary

Index