Previously I wrote a blog about collecting the mqsidc file for support:
This is a continuation of that to explain why we ask for it and what we look for.
Please note that with each new iteration of the product, the collector may collect additional data. This detail is from IIB 10.0.0.10.
Also note that the files could be extremely large as the stderr/stdout/console.txt files can contain a lot of information. Especially if there are very many Integration Servers.
The MQSIDC collector
The MQSIDC collector is a simple tool that will collect data about your Broker/Integration node with a command line interface. This information includes, but is not limited to:
- Broker names and fixpack levelsâ¨â
- MQ Versionâ¨
- iFixes installedâ¨
- Execution Group Detailsâ¨
- Error logs (syslog, Event Viewer, stderr/stdout, console.txt)â¨
- Basic system informationâ¨â
- odbc files and locationsâ¨
- Environment Variablesâ¨
- Abend files, javacores, heap dumps, snap traces
Once the collector has been run, you will have a zipped file containing a great deal of information.
- a) autodpzip which contains information about the collector tool including logs. This will only be needed if the collector failsâ¨â
b) WMB_Broker_Problem, which is the data collected
- a) Broker which is the detailed broker collectorâ¨â
b) common which are more generic details.
The Common Directoryâ¨
Under the common directory, you will see the following details:
**All of the files collected should be able to be reviewed with a text editor. In some cases they may be too large, but all are in simple text format.
- common_error_directory_listing.txt will give you a quick view of what files are located inâ¨ workspace/common/errors directory. Theseâ¨ files include abends, javacores, heap dumps, snap traces. You cannot review these files from here, but this does let you know whatâ¨ exists in that location.
- dspmqver.txt displays the current MQ version running with the Integration Node. This will allow us to verify that the environmentâ¨âis on a supported configuration
- env.txt is a list of the current environment variables on the system
- java_version.txt The java version being run:
- mqsiListOuptut.txt is a list of the brokers running (and stopped) along with their queue managers:
- mqsiServiceOutput.txt shows the fixpack level of the broker along with any iFixes installed (if applicable).
- operatingSystemDetails.txt, Operating System information
- On Unix Operating systems, you will also most likely see files for odbc.ini and odbcinst.ini.â¨ These are located by how they are referenced in the environment variables ODCBINI and ODBCSYSINI.â¨ If you are having database connectivity issues, this is the first place to look. Please make sure there are no extra characters such asâ¨âwhite spaces or carriage returns, as these can cause unexpected results.
Also if making changes to the odbc* files, please make sure you are changing the ones indicated in the collector.
The Broker Directory
- mqsiAgentJVMSettings will allow us to see some of the attributes of the Broker Agent JVM, including min and max heap size:
- mqsiAllReportableEntity.txt will show us all of the configurable services which have been set up on the broker
- mqsiAuthorizationMode.txt will allow us to review what authorization mode is configured on the Integration Node and ifâ¨âadmin security is enabled.
- mqsiDeployInfoOutput.txt will show all of the artifacts that are deployed to every Integration Server on the Integration Node
- mqsiBrokerRegistry.txtallows us to view the actual broker Registry:
- mqsicvpOutput.txt runs the broker wide mqsicvp check, which is a simple test tool to make sure the broker meets the minimumâ¨ârequirements, and can access the databases.
- mqsiExecutionGrouptsOutput.txt will display the attributes of the EGs defined on the broker, such as Execution Group names andâ¨âUUIDs.
- mqsifileauthdetails will show the details of the file authorizations
- mqsiHTTPConnectorProperties.txt and mqsiHTTPSConnectorProperties.txt display all of the properties defined on the HTTP andâ¨âHTTPS connector. This is very useful for SSL debugging.
- mqsilistBroker.txt displays the EGs running on the broker:
- mqsilistBrokerOutput.txt gives further detail on the Integration Servers that are on the Integration Node:
- mqsiReportBrokerOutput.txt contains a great deal of information about the broker:
- Last mqsistart path will let us know at what fixpack level the broker was startedâ¨
- Work path will show the current workpath locationâ¨
- Any lil or exit paths are displayedâ¨
- Operation mode (advanced, express, etc)â¨
- Fixpack capability Level. This actually can make a difference if there is a new functionality introduced in a new fixpack. For example, using LDAP Authentication for the WebUI was introduced in IIB 10.0.0.4. If you were running with IIB 10.0.0.7,â¨ but the fixpack capability level was set to 10.0.0.1, you still cannot use this functionality.â¨
- If admin security is enabled or disabled.â¨
- The shared workpath (if applicable)â¨
- If the broker is being started as an MQ service.â¨
- The httpListener portâ¨
- The default CCSID of the broker
The âBroker nameâ directory
Under this directory, there are 2 additional directories (BrokerLogs and common)
- Broker Logs contains the stderr/stdout files for the broker, any execution groups (by UUID), and the http listener (on Windows), stderr/stout are combined into a file called âconsole.txtâ
- These are the error logs and can contain a great deal of information as well as being the collecting area for many user specifiedâ¨âtraces (GC trace, JSSE trace,etc.) If the stdout file is growing exponentially, there is a very good chance that a trace is running. You willâ¨âalso find java out of memory errors in these error logs.
The common directory contains the errors and profiles directories.â¨
- The common directory will contain any abend files java cores, heaps and snap traces. On a Unix system, if a kill -3 is run the filesâ¨âare collected here:
- The profile directory contains any user specific profiles set on the broker. These would either be set with a file ending in .sh (Unix)â¨âor .cmd (Windows)