IBM Integration Bus, Version 10.0.0.0 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


mqsichangeflowmonitoring command - z/OS

Use the mqsireportflowmonitoring command on z/OS® to display the current options for monitoring that have been set by the mqsichangeflowmonitoring command.

Syntax

z/OS console command

Synonym: rm

Read syntax diagramSkip visual syntax diagram
>>-+-mqsireportflowmonitoring-+--integrationNodeName------------>
   '-rm-----------------------'                        

>--+-| SingleFlow |----+---------------------------------------><
   '-| MultipleFlows |-'   

SingleFlow

|--e=IntegrationServerName--f=MessageFlow----------------------->

>--+----------------------------------+-------------------------|
   +-n=yes----------------------------+   
   +-a=yes----------------------------+   
   |     .-,------------------.       |   
   |     V                    |       |   
   +-s=----EventSourceAddress-+-------+   
   +-x=yes--p=File--------------------+   
   '-k=ApplicationName--y=LibraryName-'   

MultipleFlows

|--+-e=IntegrationServerName--+-f=MessageFlow-+-+--------------->
   |                          '-j=yes---------' |   
   '-g=yes--------------------------------------'   

>--k=ApplicationName--y=LibraryName-----------------------------|

Parameters

integrationNodeName
(Required) Specify the label of the integration node, for which monitoring options are to be reported.
a
(Optional) Report the flow-level monitoring properties and the properties of all event sources within the flow, whether configured or not.
e IntegrationServerName
(Required) Specify the name for the integration server, for which monitoring options are to be reported.

You must specify either -e or -g. If you do not specify one of these arguments you receive an error message.

f MessageFlow
(Required) Specify the label for the message flow, for which monitoring options are to be reported.

You must specify either -f or -j. If you do not specify one of these arguments you receive an error message.

g
(Required) Specifies that the command applies to all integration servers that belong to the integration node.

You must specify either -e or -g. If you do not specify one of these arguments you receive an error message.

j
(Required) Specifies that the command applies to all message flows that belong to the integration server.

You must specify either -f or -j. If you do not specify one of these arguments you receive an error message.

Note: If you set the -g option for all integration servers, you must use -j instead of -f.
k applicationName
(Optional) This parameter specifies the name of the application that contains the message flow being monitored.

When you set this parameter, you must also set either the -f (message flow) parameter, or the -j (all message flows) parameter. To display monitoring options for a named message flow in a specific application, set the -k and -f parameters. To display monitoring options for all message flows in an application, set the -k and -j parameters.

You can use this parameter with the -y (library name) parameter to specify that the message flow is contained in a library referenced by the application.

n
(Optional) Report the flow-level monitoring properties and the properties of any configured event sources within the flow.
p
(Optional unless -x is specified.) The file name to which the monitoring profile will be written, in XML format.
s EventSourceAddress
(Optional) Report the flow-level monitoring properties and the properties of the specified event sources within the flow, whether configured or not.
You must provide a comma-separated list of the event source addresses for which monitoring options are to be reported. An event source address takes the form <node name>.<event source>, where <event source> is one of the following values:
  • 'terminal.<terminal name>'
  • 'transaction.Start'
  • 'transaction.End'
  • 'transaction.Rollback'

If a message flow contains two or more nodes with identical names, the event sources on those nodes cannot be accurately addressed. If this is attempted, behavior is undefined.

Note: <node name> is the label of the node as known by the IBM® Integration Bus runtime components. If the node is in a subflow the label reflects this. For example, flow A contains an instance of flow B as a subflow labeled 'myB'; flow B contains an instance of a Compute node labeled 'myCompute'. The <node name> for the Compute node is 'myB.myCompute'.
x
(Optional; if you specify -x you must also specify the -p parameter.) Outputs the current monitoring properties for the specified message flow as a monitoring profile XML file.
y libraryName
(Optional) This parameter specifies the name of the library that contains the message flow being monitored.

When you set this parameter, you must also set either the -f (message flow) parameter, or the -j (all message flows) parameter. To display monitoring options for a named message flow in a specific library, set the -k and -f parameters. To display monitoring options for all message flows in a library, set the -k and -j parameters.

Note:
  • If all flags are omitted, only the flow-level properties are reported.
  • Flags -n, -a, -s and -x can be used only when -f is present.
  • Flags -n, -a, -s and -x are alternatives and cannot be used together.

Examples

Request a report of monitoring options for message flow "MFlow1" in the integration server "default":
F MI10BRK,rm e='default',f='MFlow1' 
Request a report of the current monitoring options for all message flows in all integration servers:
F MI10BRK,rm g=yes,j=yes 
Display monitoring options for all message flows in application application1 in integration server default:
F IBNODE,rm e=default,k=application1,j=yes 
Display monitoring options for message flow myflow1 in library library1, referenced by application application1, in integration server default:
F IBNODE,rm e=default,y=library1,k=application1,f=myflow1
For more examples, see Reporting monitoring settings.

an37940_.htm | Last updated 2015-03-27 19:27:10