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.
Step 3
In the HA menu, choose the option to collect admin domain debug data.
Step 4
The option has these parameters listed.
| 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.
Uploading data to IBM
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010370
Was this topic helpful?
Document Information
Modified date:
20 December 2018
UID
ibm10792149