Sun Logo


Sun Mainframe Transaction Processing Troubleshooting and Tuning Guide

Release 8.0.1

816-5333-11



Contents

Figures

Tables

Code Samples

Preface

1. Installation

License Problems

License File Does Not Exist

procedure iconsmall spaceTo Verify That a License File Exists

License File Error Messages Are Displayed

First-Time Installation

Insufficient Disk Space

kixinstall Displays Error Messages

Maintenance Installation

2. Startup

Cannot Start Sun MTP

Insufficient Memory

Kernel Parameters Incorrect

3. Abnormal Termination of Regions and Transactions

Abnormal Terminations

Sun MTP Crash

Application Transaction Abort

procedure iconsmall spaceTo Recover From an Abort While in the Debug Facility

Restarting After a Region Terminates Abnormally

procedure iconsmall spaceTo Clean Up After an Abnormal Termination

procedure iconsmall spaceTo Verify File Integrity or to Validate the Structure of VSAM Files

4. Client Terminal

Region Starts But Communication Servers Do Not

TN3270 Sessions Do Not Connect

Unable to Connect to Region Using PC-based TN3270 Client

Unable to Start unikixtne Server After the Region Is Restarted

procedure iconsmall spaceTo Clean Up unikixtne Process or Queues

Terminal or Keyboard Does Not Work on a Local Sun MTP Client

Creating and Installing terminfo Definitions

procedure iconsmall spaceTo Use the tic Command to Put a Terminal Definition Into the Standard terminfo Directory Structures

Changing Application Keypad Mode Settings With terminfo

Verifying terminfo Values

procedure iconsmall spaceTo Use a Particular terminfo Definition

Numeric Keypad Is Not in Application Mode

procedure iconsmall spaceTo Create a Script That Resets the Keypad to Application Mode

procedure iconsmall spaceTo Create a Script That Resets the Keypad to Numeric Mode

Arrow Keys Are Not in Cursor Mode for Animator

procedure iconsmall spaceTo Create a Script That Resets the Arrow Keys to Cursor Mode

Can Connect to Sun MTP Only From the User ID That Started It

procedure iconsmall spaceTo Resolve This Problem

Sun MTP Client Terminates Abnormally

5. Analyzing VSAM Files

Data Corruption

procedure iconsmall spaceTo Identify a Corrupted Dataset

procedure iconsmall spaceTo Salvage a Corrupted Dataset

procedure iconsmall spaceTo Load the Salvaged Dataset

VSAM Block Structure

Locating a Record in an ESDS File

procedure iconsmall spaceTo Calculate the Record Position for an ESDS File With Variable Length Records

procedure iconsmall spaceTo Calculate the Record Position for an ESDS File With Fixed Length Records

Locating a Record in an RRDS File

procedure iconsmall spaceTo Calculate the Offset in the File Where the Record Starts

Locating a Record in a KSDS File

VSAM Data and Index Formats

6. Debugging Programs

Remote Animation

procedure iconsmall spaceTo Shut Down the Remote Animator Process

7. Asynchronous START Transactions

Transactions Do Not Appear to Start

Transactions, Temporary Storage, and Their Effect on Performance

8. Tuning RDBMS Applications

Tuning an Oracle RDBMS

Tuning a Sybase RDBMS

9. Batch Processing

Batch Processing and Recovery

Batch Search Interval

10. Sun Mainframe Administration Tool

unikixadmin Fails to Start

Java Virtual Machine Not Configured

Debug Tracing

procedure iconsmall spaceTo Configure Debug Tracing

11. Sun Mainframe Security Facility

Java Class Files Cannot be Located By the JRE

Java Security Access Denial

Security Server Fails With a port out of range Message

Security Server Fails With a Permission denied Message

Security Server Fails With an Address already in use Message

JDBC Reports an SQL Error

12. Performance

Sun MTP Configuration Factors

Recovery Configuration

Recovery Method

Size of Recovery File

Semaphores and Mutual Exclusion Locks

Transaction Servers

Effect of Multiple Transaction Servers

Recycling Frequency

Failure to Recycle

Shared Memory

procedure iconsmall spaceTo Resolve the Shared Memory Problem

VSAM File Configuration Factors

Determining Sun MTP File Usage

Block Size

Temporary Storage and Response Time

I/O Bottlenecks

Large VSAM Files

Journal Buffer Size Too Small

Poor Throughput for VSAM Files

Too Few Buffers for VSAM Datasets

VSAM Buffer Pool

Program Factors

Conversational Transactions

Excessive Swapping or Paging

13. Diagnostic Tools

Using the Sun MTP Trace Facility

Dump Facilities

Application Dump Facility

Enabling and Disabling the Dump Facility

Identifying Where the Transaction Abended

unikixmain.err and unikixmain.log Entries

Dump File Output

Glossary

Index