IBM Support

QMGTOOLS: Administrative Domain Debug Data

Product Documentation


Abstract

The admin domain debug data function in QMGTOOLS assist in collecting data for IBM support.

Content

The QMGTOOLS library contains a function to assist a user in collecting debug data for administrative domain issues. Manual data collection without using QMGTOOLS includes:

- MustGather: High Availability - Administrative Domain Issues Checklist
http://www-01.ibm.com/support/docview.wss?uid=nas8N1012991
- Relevant joblogs
- Trace data if requested by IBM support

Step 1 

If QMGTOOLS is not installed on your system, follow this link to get it.
http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297

Step 2 

Once QMGTOOLS is installed, type GO QMGTOOLS/MG to get to the main menu. From there, choose the HA option.

QMGTOOLS main menu

Step 3

In the HA menu, choose the option to collect admin domain debug data.

HA menu

Step 4

The option has these parameters listed. 

Admin domain debug data options

Function

*STRTRC - enable tracing, *DUMP - dump debug data

Using *DUMP will end the trace along with dumping data. If you wish not to dump data but stop the trace, delete data area QMRDEBUG in library QUSRSYS.

Admin domain name Use *AUTO to let the program determine the admin domain CRG or enter the name of the administrative domain
Trace leve The level of trace used if specifying *STRTRC for the function. Trace levels are *LOW, *MED, *HIGH, and *VERYHIGH
Print MREs Default is N. Choose Y or N to print MREs (monitored resource entries).
Output *IFS - to dump data into an IFS directory, *PF - to dump data into a physical file
IFS directory to store data If using *IFS for output, the IFS directory where the data will be stored
File to store data If using *PF for output, the file to store the data
Library to store file If using *PF for output, the library to store 

 

 

 

 

 

 

 

 

 

Usage

The following example enables tracing for the admin domain with trace level of *LOW:
QMGTOOLS/ADMNDBG FUNCTION(*STRTRC) TRCLVL(*LOW)    

The following example dumps data into the IFS (the default output is *IFS so there is no need to specify the output parameter):
QMGTOOLS/ADMNDBG FUNCTION(*DUMP)   

You can use *DUMP for the function without the need to enable tracing as other relevant data will be collected.

Once the data is collected, a status like this example is presented to the user. In this example, a zip file called MGTOOL72_ADMIN_DEBUG_DATA.zip is created in directory /tmp. That would be the file to send to IBM for analysis.

Status screen after function is completed

Uploading data to IBM

http://www-01.ibm.com/support/docview.wss?uid=nas8N1010370

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Document information

More support for: PowerHA SystemMirror

Component: Administration domain

Software version: All Versions

Operating system(s): IBM i

Reference #: 0792149

Modified date: 20 December 2018