C H A P T E R 10 |
Sun Mainframe Administration Tool |
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:
Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for information about configuring and running the Mainframe Administration Tool.
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.
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:
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.
To Configure Debug Tracing |
1. Set the MTPADMINTRACE environment variable to a numeric value of at least 1.
When unikixadmin completes initialization, it writes a message in the following format to the unikixmain.dbg file:
nnnn is the port number specified on the -X option to unikixmain at startup.
rrrr is the region's $KIXSYS directory.
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.