Structure of the URI 

objects/queueManagerName/objectType/objectName/fields
URI SegmentDescriptionWildcards SupportedWildcard Example
queueManagerNameName of the queue managerYES.* can be used to select all or part of the queue manager name
objectTypeSee DataTypes and CategoriesNO 
objectNameName of the MQ object. Example Queue NameYES.* can be used to select all or part of the object name
fieldsFields to select separated by a | characterYES

.* can be used to select all fields

| can be used as an OR statement to select multiple fields

Example

The following URI would show the fields CURDEPTH, IPPROCS and OPPROCS for all queues beginning with TEST on all queue managers. 

http://localhost:8085/objects/.*/QUEUE_STATUS/TEST.*/CURDEPTH|IPPROCS|IPPROCS 
{
	"queryTime": 0,
	"objects": [
		{
			"messageBrokerName": "TEST",
			"objectName": "TEST.LQ1",
			"objectType": "QUEUE_STATUS",
			"entryTime": "25/09/2018 12:58:47 PM",
			"fields": {
				"OPPROCS": "0",
				"IPPROCS": "0",
				"CURDEPTH": "0"
			}
		},
		{
			"messageBrokerName": "TEST",
			"objectName": "TEST.RESPONSE.Q",
			"objectType": "QUEUE_STATUS",
			"entryTime": "25/09/2018 12:58:47 PM",
			"fields": {
				"OPPROCS": "0",
				"IPPROCS": "0",
				"CURDEPTH": "0"
			}
		},
		{
			"messageBrokerName": "TEST",
			"objectName": "TEST_TOPIC.Q",
			"objectType": "QUEUE_STATUS",
			"entryTime": "25/09/2018 12:58:47 PM",
			"fields": {
				"OPPROCS": "0",
				"IPPROCS": "0",
				"CURDEPTH": "0"
			}
		},
		{
			"messageBrokerName": "TEST",
			"objectName": "TEST.REQUEST.Q",
			"objectType": "QUEUE_STATUS",
			"entryTime": "25/09/2018 12:58:47 PM",
			"fields": {
				"OPPROCS": "0",
				"IPPROCS": "0",
				"CURDEPTH": "0"
			}
		}
	]
}

 

Request headers

Each request must have an “Accept” header, where the value may be either application/json or application/xml. This tells the Lamaxu process whether you want JSON or XML formatted output.

If your Lamaxu process is configured with local and, or LDAP authentication, you will need to supply an “Authorization” header. A valid value may look like “Basic YWRtaW46YWRwaW4=”

Filter Examples

The URL below filters statistics for QUEUE1 based on the date.

http://hostname.com:8085/statistics/TEST/STATISTICS/QUEUE1/date/2017-09-29

The URLs below filter statistics for all queues matching the .* wildcard for the date or queue name.

http://hostname.com:8085/statistics/TEST/STATISTICS/.*/date/2017-09-29
http://hostname.com:8085/statistics/TEST/STATISTICS/QU.*1/date/2017-09-29
http://hostname.com:8085/statistics/TEST/STATISTICS/QU.*1/date/2017-09.*

Where:

{QMGR} - the name of the queue manager configured
objectype - one of the following, must be in UPPERCASE. Refer to the table below.
objectname - is the name of the queue manager object, i.e. a queue name.

Postman Example showing Accept header

  • No labels