Preface

This document describes problems you might encounter when running the Sun Mainframe Transaction Processing software (Sun MTP), and recommends ways to solve them. It also provides information about ways you can modify your system to improve performance.

How This Book Is Organized

The chapters in this document are organized according to the kinds of problems you might encounter. Each chapter describes the problems and includes recommendations for solving them.

Chapter 1 describes initial installation problems, as well as problems that can arise during a software upgrade.

Chapter 2 describes problems that can prevent Sun MTP from starting.

Chapter 3 describes abnormal terminations of regions and transactions and how to recover from them.

Chapter 4 describes client terminal-related problems.

Chapter 5 describes causes of data corruption and ways to recover VSAM files.

Chapter 7 describes problems with asynchronously started transactions.

Chapter 8 describes problems you can encounter when using a third-party database product.

Chapter 9 describes problems related to standard batch operations.

Chapter 10 describes startup problems related to the administration server, and explains how to enable debug tracing.

Chapter 11 describes problems you may encounter when running the Sun Mainframe Security Facility (Sun MSF).

Chapter 12 explains how to determine the causes of performance problems.

Chapter 13 describes the Sun MTP diagnostic tools.

The glossary contains a list of terms used in this document.

Using UNIX Commands

This document does not contain information about basic UNIX® commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:

Software documentation that you received with your system

Solaris operating environment documentation, which is at

http://docs.sun.com

Typographic Conventions

Typeface/ Command Notation`^[1]`	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your`.login` file. Use `ls` `-a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.	Read Chapter 6 in the User's Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` filename.
`[ ]`	Optional arguments in a command	`unikixmain [-Q]`
`{ }`	Contain alternative options separated by a vertical bar	`kixfile [-r{Y\|N}]`
`\|`	Separates alternative arguments	`EXEC CICS READ DATASET \| FILE`

This document uses the following format for commands:

$ command required-argument [optional-argument]

If a command does not support optional arguments, type the command and press Return.

Shell Prompts

Shell	Prompt
C shell	machine-name`%`
C shell superuser	machine-name`#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Related Documentation

Product	Title	Part Number
Sun Mainframe Transaction Processing software	Sun Mainframe Transaction Processing Software Administrator's Guide	816-5327-11
	Sun Mainframe Transaction Processing Software Configuration Guide	816-5328-11
	Sun Mainframe Transaction Processing Software Developer's Guide	816-5329-11
	Sun Mainframe Transaction Processing Software Installation Guide	816-5330-11
	Sun Mainframe Transaction Processing Software Message Guide	816-5331-11
	Sun Mainframe Transaction Processing Software Reference Guide	816-5334-11
	Sun Mainframe Transaction Processing Software Release Notes for Solaris Platforms	817-5613-10
	Sun Mainframe Transaction Processing Software Release Notes for AIX Platforms	817-5614-10
Sun Mainframe Batch Manager software	Sun Mainframe Batch Manager Software Configuration Guide	816-5342-11
	Sun Mainframe Batch Manager Software Installation Guide	816-5343-11
	Sun Mainframe Batch Manager Software Message Guide	816-5345-11
	Sun Mainframe Batch Manager Software Migration Guide	816-5346-11
	Sun Mainframe Batch Manager Software Reference Guide	816-5347-11
	Sun Mainframe Batch Manager Software Release Notes for Solaris Platforms	817-5615-10
	Sun Mainframe Batch Manager Software Release Notes for AIX Platforms	817-5616-10
	Sun Mainframe Batch Manager Software User's Guide	816-5349-11
IBM CICS	CICS Application Programming Reference	SC33-1170
	CICS Application Programming Primer	SC33-0674
	CICS Master Index	SC33-1074
	CICS Supplied Transactions	SC33-1686
	CICS System Programming Reference	SC33-1689
Micro Focus Server Express	Micro Focus Server Express documentation CD-ROM	*
Liant Open PL/I	Liant Open PL/I User's Guide	*
	Liant Open PL/I Language Reference Manual	*
	Liant CodeWatch Reference Manual	*
C	C Compiler documentation	*
C-ISAM	C-ISAM Programmer's Manual	*
	System Performance Tuning by Mike Loukides, published by O'Reilly & Associates as part of their "Nutshell" series
^{* These manuals vary with the platform being used. Consult your vendors for the manuals that are applicable to your platform.}

Accessing Sun Documentation

You can view, print, or purchase a broad selection of Sun documentation, including localized versions, at:

http://www.sun.com/documentation

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in this document, go to:

http://www.sun.com/service/contacting

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can submit your comments by going to:

http://www.sun.com/hwdocs/feedback

Please include the title and part number of your document with your feedback:

Sun Mainframe Transaction Processing Software Troubleshooting and Tuning Guide, part number 816-5333-11

^{1 (TableFootnote) The settings on your browser might differ from these settings.}