How to read the error log and FFDCs for DOS and Windows 3.1
RUNMQFMT reformats the trace, error, and FFDC files. Before running RUNMQFMT have access to the error message file, amq9.msg. You can give RUNMQFMT access either by putting the file in the local directory or by adding its location to the DOS APPEND statement.
RUNMQFMT has one optional parameter, the name of the file to be processed. If you do not specify a file name and tracing is on, FORMAT TRACE/ERROR FILE attempts to format the trace file; if tracing is not on, it attempts to format the error file. The output is written to stdout to enable you to browse it; alternatively you can redirect the output to a printer. The oldest message is listed first.
To print the output file: RUNMQFMT filename > printername
- Note:
- The normal default 'printer name' is LPT1, which is the port assigned to a printer. Alternatively, you can direct the output to a file, replacing the printer name with the file name when you issue the command.
Your application program should handle any MQI reason codes to allow your program to end in a controlled manner because there is no MQI error handling within the product.
There are three ways of using RUNMQFMT:
- Specify the full path and name of the error log.
- Specify the name of the error log, in which case the default path is used.
- Enter only the command name, RUNMQFMT. The command assumes that the error log is in the default location, unless this has been changed by the MQDATA environment variable. If tracing is on, the trace is formatted; if tracing is off, the error log is formatted.