Sun Mainframe Transaction Processing Troubleshooting and Tuning Guide

This chapter describes problems you might encounter when starting and using the Sun Mainframe Administration Tool (Sun MAT) and Sun Mainframe Administration Agent (Sun MAA). It contains the following topics:

• unikixadmin Fails to Start
• Java Virtual Machine Not Configured
• Debug Tracing

Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for information about configuring and running the Mainframe Administration Tool.

---

unikixadmin Fails to Start

If the unikixadmin server fails to initialize itself correctly, any associated error messages are written to the console. The unikixadmin server terminates and remote administration is disabled for the region.

For example, if unikixadmin fails to attach to Sun MTP shared memory, the following error message is displayed on the console:

unikixadmin: KIX0177F [unikixadmin] Cannot link to shared memory

This occurs because the shared memory settings for the region are not properly configured to support the unikixadmin process. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for shared memory configuration guidelines.

---

Java Virtual Machine Not Configured

The unikixadmin server requires access to a Java virtual machine (JVM)^[1], version 1.4. The LD_LIBARRY_PATH environment variable must be set with the location of the JVM software before starting the region. If the unikixadmin server is unable to locate and load the software, the following messages are written to the unikixmain.err file:

ld.so.1: unikixadmin: fatal: libjvs.so: open failed: No such file or directory

08/09/2002 15:23:27 unikixmain :KIX0330E Trace dump requested: 510df

08/09/2002 15:23:28 unikixmain :KIX0117F Process 123 (type a) ended unexpectedly: exit code 0 signal 9

---

Debug Tracing

When the unikixadmin server starts normally, any error messages that are issued are written to the unikixmain.err file. However, if you are having startup problems that are difficult to diagnose, you should configure the unikixadmin server to write debug information to the console and to the unikixmain.dbg file. The MTPADMINTRACE environment variable sets debug tracing on. It dumps parameters passed to the unikixadmin server and to the JVM software.

1. Set the MTPADMINTRACE environment variable to a numeric value of at least 1.

2. Start the region.

When unikixadmin completes initialization, it writes a message in the following format to the unikixmain.dbg file:

unikixadmin :registered as //:nnnn/MTP:rrrr:unikixAdmin

where:

nnnn is the port number specified on the -X option to unikixmain at startup.

rrrr is the region's $KIXSYS directory.

^{1 (Footnote) The terms "Java Virtual Machine" and "JVM" mean a virtual machine for the Java platform.}

Sun Mainframe Transaction Processing Troubleshooting and Tuning Guide

816-5333-11

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.