QMGTOOLS: Administrative Domain Debug Data
The admin domain debug data function in QMGTOOLS assist in collecting data for IBM support.
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
- Relevant joblogs
- Trace data if requested by IBM support
If QMGTOOLS is not installed on your system, follow this link to get it.
Once QMGTOOLS is installed, type GO QMGTOOLS/MG to get to the main menu. From there, choose the HA option.
In the HA menu, choose the option to collect admin domain debug data.
The option has these parameters listed.
*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|
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):
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
More support for:
Component: Administration domain
Software version: All Versions
Operating system(s): IBM i
Reference #: 0792149
Modified date: 20 December 2018