endmqtrc (end trace)

End trace for some or all of the entities that are being traced.

Purpose

You can use the endmqtrc command to end tracing for a specified entity, or for all entities.

Syntax

Read syntax diagramSkip visual syntax diagram endmqtrc  -m QMgrName -i PidTids -p Apps -e  -a  -w

Parameters

-m QMgrName
Specifies the name of the queue manager for which to end tracing.
The QMgrName supplied must match exactly the QMgrName supplied on the strmqtrc command. If the strmqtrc command used wildcard characters, the endmqtrc command must use the same wildcard characters.
A maximum of one -m flag can be supplied on the command.
-i PidTids
Specifies the process identifier (PID) and thread identifier (TID) for which to end tracing.
You cannot use the -i flag with the -e flag.
This parameter must be used only under the guidance of IBM Service personnel.
-p Apps
Specifies the processes for which to end tracing.
Specify Apps as a comma-separated list, with each name in the list specified exactly as the program name would be displayed in the "Program Name" FDC header. You can use an asterisk (*) as a wildcard to match zero or more characters. You can use a question mark (?) to match a single character.
You cannot use the -p flag with the -e flag.
-e
Specifies that early tracing of all processes ends.
You cannot use the -e flag with the -m flag, the -i flag, or the -p flag.
-a
Ends all tracing.
This flag must be specified alone.
-w
Restrict triggering of trace to applications run by an IBM® MQ Appliance administrator.

Usage notes

  • This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • Specifying endmqtrc with no parameters has the same effect as specifying endmqtrc -e.
  • For more information about this command in IBM MQ, see endmqtrc in the IBM MQ documentation.

Examples

  • The following command ends tracing of data for a queue manager called QM1:
    endmqtrc -m QM1
    
  • The following command ends tracing for queue manager QM2 only. Any other traces that are running are not affected:
    endmqtrc -m QM2
    

Related commands