Preface

This document describes the messages generated by the Sun Mainframe Transaction Processing software (Sun MTP); intersystem communications (ISC); 3270 clients; the Sun Mainframe Security Facility (Sun MSF); and kixnrfs, the Sun MTP Native Recovery File System (NRFS) configuration utility.

How This Book Is Organized

Chapter 1 lists the Sun MTP and ISC messages in numerical order.

Chapter 2 lists the messages produced by the 3270 client and the 3270 client initiator.

Chapter 3 lists the messages generated by Sun MSF.

Chapter 4 lists the messages issued by kixnrfs.

Appendix A contains a lists of ISC suberror codes.

Message Categories

There are three message categories:

System	Information about the operation of the Sun MTP software. They are written to the files `unikixmain.log` and `unikixmain.err`. Most messages are in this category.
Application	Displays when a transaction aborts and appears on line 24 of the transaction screen.
Utility	Generated by the Development System and other configuration utilities, such as the Sun MTP Table Manager, File Manager, Record Editor, and the Screen Generation Utility (SGU). These messages appear on line 23 of the screen of the issuing utility.

In addition, Sun MTP might report messages from the optional Sun Mainframe Batch Manager (Sun MBM) message exchange facility (MEF). Text of these messages might include MEF as the source of the message.

Message Format

The Sun MTP messages use the following format:

KIX####a Text of message

where:

`####`	Error number
`a`	Letter indicating the severity of the error
`I`	Informational message
`W`	Warning message
`E`	Nonfatal error
`F`	Fatal error
`T`	Transaction termination occurred that did not affect Sun MTP
`Text of message`	Message. In some cases, the name of the subroutine that originated the message appears in brackets before the message text. In these cases, the message appears as: KIX####a [subroutine_name] Text of message

For convenience, the messages are listed in numerical order, and the KIX prefix is omitted from the error numbers. In the message text, the following variables are used:

%c	Replaced in the message by a single character.
%d	Replaced in the message by a decimal value.
%s	Replaced in the message by a string of characters.
%r	Replaced in the message by the name of a subroutine or method.
%x	Replaced in the message by a hexadecimal value.

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`^[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.

Typeface^[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.

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 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 Transaction Processing Software Troubleshooting and Tuning Guide	816-5333-11
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 Message Guide, part number 816-5331-11

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