Inquire Application Status on Multiplatforms

The Inquire Application Status (MQCMD_INQUIRE_APPL_STATUS) command inquires about the applications and application instances connected to a queue manager or uniform cluster.

We must specify the application name for which we want to receive status information.


Required parameters

    ApplicationName (MQCFST)
    Application name set using the APPPLTAG parameter (parameter identifier: MQCACF_APPL_NAME).

    Generic application names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all applications having names that start with the selected character string. An asterisk on its own matches all possible names.

    The application name is always returned, regardless of the attributes requested.

    The maximum length of the string is MQ_APPL_NAME_LENGTH.


Optional parameters

    ApplicationInfoAttrs (MQCFIL)
    Application information attributes (parameter identifier: MQIACF_APPL_INFO_ATTRS)
    If not provided, defaults to MQIACF_ALL
    Alternatively, we can specify any of the parameter values listed in the Inquire Application Status (Response)command, which are valid for the requested status type.

    ApplicationStatusInfoType (MQCFIN)
    The type of status to return (parameter identifier: MQIACF_APPL_INFO_TYPE). The value can be:

    • MQIACF_APPL_INFO_APPL
    • MQIACF_APPL_INFO_QMGR
    • MQIACF_APPL_INFO_LOCAL

    The default value, if this parameter is not specified, is MQIACF_APPL_INFO_APPL.

    IntegerFilterCommand (MQCFIF)
    Integer filter command descriptor that we use to restrict the output from the command. The parameter identifier must be an integer type, and must be one of the values allowed for the ApplicationStatusInfoType selected, except MQIACF_ALL.

    If you specify an integer filter, we cannot also specify a string filter using the StringFilterCommand parameter.

    StringFilterCommand (MQCFSF)
    String filter command descriptor. The parameter identifier must be any string type parameter except MQCA_APPL_NAME. Use this parameter to restrict the output from the command by specifying a filter condition.

    Ensure that the parameter is valid for the type selected in ApplicationStatusInfoType.

    If you specify a string filter, we cannot also specify an integer filter using the IntegerFilterCommand parameter. Note: Although the ConnectionTag (MQBACF_CONN_TAG) field in Inquire Application Status (Response) is defined as a binary field, the contents should be UTF8.

    Because of this, use a StringFilter for this field, not a ByteStringFilter, and we can use all valid StringFilter operators.

Parent topic: Definitions of the Programmable Command Formats