IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


mqsichangetrace command - Windows, Linux, and UNIX systems

Use the mqsichangetrace command to set the tracing characteristics for an integration node or for an integration server associated with an integration node.

Syntax

Some parameters have alternative long names; for example: -e and --integration-server are alternative parameter names for an integration server name. The long names available are listed in the Parameters section.

User trace

Read syntax diagramSkip visual syntax diagram
>>-mqsichangetrace--integrationNodeName------------------------->

>-- -e --integrationServerName-- -u --+------------+------------>
                                      '- -c --size-'   

>--+-------------+--+------------+--+------+-------------------><
   '- -l --level-'  '- -m --mode-'  '- -r -'   

Service trace

Read syntax diagramSkip visual syntax diagram
>>-mqsichangetrace--integrationNodeName-- -t ------------------->

>--+- -b ----------------------------------+--+------------+---->
   '- -e --integrationServerName--+------+-'  '- -c --size-'   
                                  '- -r -'                     

>--+-------------+--+------------+-----------------------------><
   '- -l --level-'  '- -m --mode-'   

Trace nodes

Read syntax diagramSkip visual syntax diagram
>>-mqsichangetrace--integrationNodeName-- -n --switch----------->

>-- -e --integrationServerName---------------------------------><

Parameters

integrationNodeName | --integration-node integrationNodeName
(Required) Specify the name of the integration node that you want to trace. All names are case sensitive on Linux and UNIX systems.
-c size | --file-size size

(Optional) The size of the trace file in KB (kilobytes). If you do not specify this parameter, the current value is left unchanged.

Each integration node starts with a default value of 102400 KB. Specify this option to reset the value.

On HP-UX, set the size value below 500 MB.

If you change this value, it affects tracing for the integration server (if you have specified one), or for the agent component (if you have not specified an integration server).

-e integrationServerName | --integration-server integrationServerName
(Required for user trace; required for service trace if you do not specify the -b flag)

Identifies the integration server for which trace options are to be modified (for example, started or stopped).

-l level | --level level
(Optional) Set the level of the trace. The following options are supported:
  • normal. This option provides a basic level of trace information.
  • none. This option switches tracing off.
  • debug. This option provides a more comprehensive trace.

Each integration node is created with a default value of none. If you do not specify this parameter, the current value is unchanged. When you have successfully changed this value, it is persistent.

-m mode | --mode mode
(Optional) Indicate the way trace information is to be buffered:
  • safe. This mode causes trace entries to be written to file when they are generated.
  • fast. This mode causes trace entries to be buffered, and written to file in batches.
Each integration node starts with a default value of safe. If you do not specify this parameter, the current value is unchanged.

If you change this value, it affects tracing for the integration server (if you have specified one), or for the agent component (if you have not specified an integration server).

-r | --reset

(Optional) This option requests that the trace log is reset: that is, all current records are discarded. Use this option when you start a new trace to ensure that all records in the log are unique to the new trace.

This option is valid only if you have specified an integration server (flag -e).

-u | --user-trace
(Required for user trace)

Specifies that user trace options are to be modified.

Additional parameters exclusive to service trace

Use these options only when directed to do so by your IBM® Support Center, or by a BIPxxxx message.

-b | --agent

(Required) Specifies that service trace options for the agent subcomponent of the integration node specified are to be modified (for example, started or stopped). You can specify this flag only if -t is also specified.

You must specify the -b flag or the -e flag, but not both.
-m mode | --mode mode
(Optional) In addition to the safe and fast modes available for user trace, there is a third temp mode available with integration server service trace only:
  • temp. This mode is the same as safe mode, but trace is automatically switched off when the component restarts. You can also specify BIP numbers to stop the trace automatically. You can specify up to 10 BIP numbers, separated by commas, as shown in the following examples:
    mqsichangetrace ACENODE -e N101ISAA -t -l debug -m temp
    mqsichangetrace ACENODE -e N101ISAA -t -l debug -m temp=BIP2213E
    mqsichangetrace ACENODE -e N101ISAA -t -l debug -m temp=BIP4395E,BIP2213E
-t | --service-trace

(Required) Specifies that service trace options are to be modified.

Additional parameters exclusive to Trace nodes

-n switch | --trace-nodes switch
(Required) Specifies the mode for trace flow. Valid values are on and off.
This command, with this flag or combination of flags, is not yet enabled for use with an integration node.

Examples

To collect and process a user trace for the integration server N101ISAA use the command:
mqsichangetrace INODE -u -e N101ISAA -l normal -c 5000
To collect and process a service trace for flow f1 in the integration server N101ISAA use the command:
mqsichangetrace INODE -t -e N101ISAA -m fast
To collect and process a service trace for an agent use the command:
mqsichangetrace INODE -t -b -m safe -l normal

an28100_.htm | Last updated 2018-11-02 14:46:00