Inquire Application Status (Response) on Multiplatforms

The response to the Inquire Application Status (MQCMD_INQUIRE_APPL_STATUS) command consists of the response header followed by the ApplicationName structure and the requested combination of attribute parameter structures (where applicable) for the requested ApplicationStatusInfoType.

Always returned:

ApplicationName

Returned if ApplicationStatusInfoType is MQIACF_APPL_INFO_APPL:

Balanced, ClusterName, InstanceCount, MovableInstanceCount, MqiacfApplInfoAppl

Returned if ApplicationStatusInfoType is MQIACF_APPL_INFO_QMGR:

BalanceState, InstanceCount, LastMessageDate, LastMessageTime, MovableInstanceCount, QueueManagerActive, QueueManagerID, QueueManagerName, MqiacfApplInfoQmgr

Returned if ApplicationStatusInfoType is MQIACF_APPL_INFO_LOCAL:

Connections, ConnectionTag, ImmovableCount, ImmovableDate, ImmovableReason, ImmovableTime, Movable, MqiacfApplInfoLocal

Response data (MQIACF_APPL_INFO_APPL)

Balanced (MQCFIN)

The overall state of this application relative to whether it is balanced in a uniform cluster or not (parameter identifier: MQIACF_BALANCED).The value can be any of the following values:

MQBALANCED_NO

This application is not considered balanced in the uniform cluster.

MQBALANCED_YES

This application is considered balanced in the uniform cluster.

MQBALANCED_NOT_APPLICABLE

This application is not shared across a uniform cluster.

MQBALANCED_UNKNOWN

This is a temporary state, representing an application that has not yet undergone a scan to calculate whether it is balanced or not, on at least one queue manager, across the uniform cluster.

ClusterName (MQCFST)

The name of the uniform cluster in which details of this application are being distributed (parameter identifier: MQCA_CLUSTER_NAME).

The maximum length of the string is MQ_CLUSTER_NAME_LENGTH.

The value can be any of the following values:

Blank

If this application is not being distributed around a uniform cluster. This might be because the application has never connected in a way which is compatible with being moved (not reconnectable, for example) or it might be that the queue manager is not a member of a uniform cluster.

String

The name of the uniform cluster.

InstanceCount (MQCFIN)

The summary count of application instances for this application. This includes the local queue managers count of instances, plus those from any queue manager in a uniform cluster that has distributed details about this application (parameter identifier: MQIACF_APPL_COUNT).

MovableInstanceCount (MQCFIN)

The summary count of the movable application instances for this application. This includes the local queue managers count of movable instances, plus those from any queue manager in a uniform cluster that has distributed details about this application (parameter identifier: MQIACF_MOVABLE_APPL_COUNT).

MqiacfApplInfoAppl

Signifies that the response type is an application.

Response data (MQIACF_APPL_INFO_QMGR)

BalanceState (MQCFIN)

The current state of this application for the queue manager being reported against, relative to whether it is considered balanced across a uniform cluster or not. This information is only updated periodically at the time when a scan causes the rebalancing to occur and might not be based on the current values for InstanceCount and MovableInstanceCount (parameter identifier: MQIACF_BALSTATE).The value can be any of the following values:

MQBALSTATE_LOW

This application is not balanced in the uniform cluster and has a deficit of application instances. A queue manager in this state usually requests applications to be rebalanced to it, so as to balance out the cluster.

MQBALSTATE_OK

This application is balanced in the uniform cluster.

MQBALSTATE_HIGH

This application is not balanced in the uniform cluster and has a surplus of application instances. A queue manager in this state usually honors requests to rebalance some of the applications connected to it, over to a queue manager in the LOW state.

MQBALSTATE_NOT_APPLICABLE

This queue manager is not in a uniform cluster and, therefore, balancing cannot occur.

MQBALSTATE_UNKNOWN

This is a temporary state representing an application that is new to the uniform cluster, and which has not yet undergone a scan to calculate whether it is balanced or not.

InstanceCount (MQCFIN)

The count of application instances for this application, on the queue manager being reported (parameter identifier: MQIACF_APPL_COUNT).

LastMessageDate (MQCFST)

Local date on which the queue manager being reported against, has distributed information on its application instances. For the local queue manager, this is just the current date. (parameter identifier: MQCACF_LAST_MSG_DATE).

The length of the string is MQ_DATE_LENGTH

LastMessageTime (MQCFST)

Local time on which the queue manager being reported against, has distributed information on its application instances. For the local queue manager, this is just the current time. (parameter identifier: MQCACF_LAST_MSG_TIME).

The length of the string is MQ_TIME_LENGTH

MovableInstanceCount (MQCFIN)

The summary count of the movable application instances for this application on the queue manager being reported for (parameter identifier: MQIA_MOVABLE_APPL_COUNT).

QueueManagerActive(MQCFIN)

Indicates whether the queue manager being reported for is currently considered active. Application instances on an inactive queue manager are not included in the numbers used to calculate application instance balancing. (parameter identifier: MQIACF_REMOTE_QMGR_ACTIVE). The value can be any of the following values:

MQACTIVE_NO

This queue manager is not considered active, because it has not distributed its application balancing information to the local queue manager recently.

MQACTIVE_YES

This queue manager is considered active, and is actively distributing its application balancing information.

QueueManagerID (MQCFST)

The internally generated unique queue manager identifier of the queue manager being reported for (parameter identifier: MQCA_Q_MGR_IDENTIFIER).

The length of the string is MQ_Q_MGR_IDENTIFIER_LENGTH.

QueueManagerName (MQCFST)

The queue manager name of the queue manager being reported for (parameter identifier: MQCA_Q_MGR_NAME).

The length of the string is MQ_Q_MGR_NAME_LENGTH.

MqiacfApplInfoQmgr

Signifies that the response type is a queue manager.

Response data (MQIACF_APPL_INFO_LOCAL)

Connections(MQCFIN)

The number of queue manager connections this application instance currently has open. (parameter identifier: MQIACF_CONNECTION_COUNT).

ConnectionTag (MQCFBS)

The connection tag associated with this application instance. When generated by the queue manager, this is a UTF8 string. (parameter identifier: MQBACF_CONN_TAG).

The maximum length of this field is MQ_CONN_TAG_LENGTH

ImmovableCount (MQCFIN)

The count of times this application instance has been requested to move to another queue manager and has not yet disconnected. Any value higher than one is an indication that the application is failing to rebalance when requested to. (parameter identifier: MQIACF_APPL_IMMOVABLE_COUNT).

ImmovableDate (MQCFST)

Date on which this local instance is considered eligible for being moved around a uniform cluster. This field is blank unless there is a temporary condition which prevents an application instance being moved to another queue manager in a uniform cluster. (parameter identifier: MQCACF_APPL_IMMOVABLE_DATE).

The length of the string is MQ_DATE_LENGTH

ImmovableReason (MQCFIN)

The reason why this application is currently considered to be immovable and, therefore, will not be rebalanced around the cluster. Some reasons are temporary, and have an associated ImmovableDate and ImmovableTime, or ImmovableTime reason. Other reasons persist for the lifetime of this application instance. (parameter identifier: MQIACF_APPL_IMMOVABLE_REASON). The value can be any of the following values:

MQIMMREASON_NONE

This application instance is currently considered movable.

MQIMMREASON_NOT_CLIENT

This application instance cannot be moved as it is not a client connection.

MQIMMREASON_NOT_RECONNECTABLE

This application instance cannot be moved as it is not a reconnectable client connection.

MQIMMREASON_MOVING

This application instance cannot be moved as it has recently been requested to move, and has not yet disconnected.

MQIMMREASON_APPLNAME_CHANGED

This application instance cannot be moved as it is sharing a socket with a connection from an application instance which has a different application name.

ImmovableTime (MQCFST)

Time on which this local instance is considered eligible for being moved around a uniform cluster. This field is blank unless there is a temporary condition which prevents an application instance being moved to another queue manager in a uniform cluster. (parameter identifier: MQCACF_APPL_IMMOVABLE_TIME).

The length of the string is MQ_TIME_LENGTH

Movable (MQCFIN)

Indicates whether this application instance is considered eligible for moving around the uniform cluster. At a minimum, a movable application must be a client connection which has connected as reconnectable. (parameter identifier: MQIACF_APPL_MOVABLE). The value can be any of the following values:

MQACTIVE_YES

This application instance is considered movable.

MQACTIVE_NO

This application instance is not considered movable.

MqiacfApplInfoLocal

Signifies that the response type is local.

Parent topic: Definitions of the Programmable Command Formats

Related reference

• DISPLAY APSTATUS

Related information

• Monitor application balancing