IBM MQ Monitoring | X4Documentation

The adapter monitors an IBM Websphere MQ Server via commands which are handed over.

Dependencies

The adapter requires the chargeable library com.ibm.mq.allclient.jar within the Classpath.

Properties

Operation

Defines the operation executed by the function adapter

Possible values:

Query: Executes the commands handed over within an input XML document and outputs them in an XML document

Parameters

MonitorIp

IP address of the MQ server to be monitored

Possible values: any valid string (e. g. 127.0.0.1 )

MonitorPort

Port of the MQ server to be monitored

Possible values: any positive number (e. g. 4711 )

MonitorChannel

Name of the Channel to be monitored on the MQ server

Possible values: any valid string (e. g. Channel)

Status values

`1 (successful)`	All commands have been executed successfully
`-1 (failed)`	The request failed due to a technical error

Input

This adapter expects an XML document as input, which has the following structure:

XML

<Commands>
	<{Command} />
</Commands>

The following commands are supported:

InquireQueue
InquireChannelNames
InquireChannelStatus

Example for the three commands:

XML

<Commands>
	<InquireQueue queue="{value}" />
	<InquireChannelNames channel="{value}" />
	<InquireChannelStatus channel="{value}" />
</Commands>

Output

The adapter expands within the output XML document the command element by the corresponding result.

Example

XML

<Commands>
	<InquireQueue queue="{value}">
		<Message>
			<Value name="{value}">{value}</Value>
		</Message>
	</InquireQueue>
	<InquireChannelNames channel="{value}">
		<NoResult />	
	</InquireChannelNames>
	<InquireChannelStatus channel="{value}">
		<Message>
			<Value name="{value}">{value}</Value>
			<Value name="{value}">{value}</Value>
		</Message>
	</InquireChannelStatus>
</Commands>