DISPLAY CHANNEL (MQTT)
Use the MQSC command DISPLAY CHANNEL to display a IBM® WebSphere® MQ Telemetry channel definition.
UNIX and Linux® | Windows |
---|---|
DISPLAY CHANNEL (MQTT) command is only valid for WebSphere MQ Telemetry channels.
Parameter descriptions for DISPLAY CHANNEL
- All channel definitions
- One or more channel definitions that match the specified name
- (generic-channel-name)
- The name of the channel definition to be displayed (see Rules for naming IBM WebSphere MQ objects ). A trailing asterisk (*) matches all channel definitions with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all channel definitions.
- WHERE
- Specify a filter
condition to display only those channels that satisfy the selection criterion of the filter
condition. The filter condition is in three parts: filter-keyword,
operator, and filter-value:
- filter-keyword
- Almost any parameter that can be used to display attributes for this DISPLAY command. However, you cannot use the CMDSCOPE, QSGDISP, or MCANAME parameters as filter keywords. You cannot use TYPE (or CHLTYPE) if it is also used to select channels. Channels of a type for which the filter keyword is not a valid attribute are not displayed.
- operator
- This is used to determine whether a channel satisfies the filter value on the given filter
keyword. The operators are:
- LT
- Less than
- GT
- Greater than
- EQ
- Equal to
- NE
- Not equal to
- LE
- Less than or equal to
- GE
- Greater than or equal to
- LK
- Matches a generic string that you provide as a filter-value
- NL
- Does not match a generic string that you provide as a filter-value
- CT
- Contains a specified item. If the filter-keyword is a list, you can use this to display objects the attributes of which contain the specified item.
- EX
- Does not contain a specified item. If the filter-keyword is a list, you can use this to display objects the attributes of which do not contain the specified item.
- CTG
- Contains an item which matches a generic string that you provide as a filter-value. If the filter-keyword is a list, you can use this to display objects the attributes of which match the generic string.
- EXG
- Does not contain any item which matches a generic string that you provide as a filter-value. If thefilter-keyword is a list, you can use this to display objects the attributes of which do not match the generic string.
- filter-value
- The value that the attribute value must be tested against using the operator. Depending on the
filter-keyword, this can be:
- An explicit value, that is a valid value for the attribute being tested.
You can use operators LT, GT, EQ, NE, LE, or GE only. However, if the attribute value is one from a possible set of values on a parameter (for example, the value SDR on the TYPE parameter), you can only use EQ or NE.
- A generic value. This is a character string (such as the character string you supply for the
DESCR parameter) with an asterisk at the end, for example ABC*. The characters must be valid for the
attribute you are testing. If the operator is LK, all items where the attribute value begins with
the string (ABC in the example) are listed. If the operator is NL, all items where the attribute
value does not begin with the string are listed. Only a single trailing wildcard character
(asterisk) is permitted.
You cannot use a generic filter-value for parameters with numeric values or with one of a set of values.
- An item in a list of values. The value can be explicit or, if it is a character value, it can be explicit or generic. If it is explicit, use CT or EX as the operator. For example, if the value DEF is specified with the operator CT, all items where one of the attribute values is DEF are listed. If it is generic, use CTG or EXG as the operator. If ABC* is specified with the operator CTG, all items where one of the attribute values begins with ABC are listed.
- An explicit value, that is a valid value for the attribute being tested.
- ALL
- Specify ALL to display
the results of querying all the parameters. If ALL is specified, any request for a specific
parameter is ignored. The result of querying with ALL is to return the results for all of the
possible parameters.
This is the default, if you do not specify a generic name and do not request any specific parameters.
On z/OS® this is also the default if you specify a filter condition using the WHERE parameter, but on other platforms, only requested attributes are displayed.
If no parameters are specified (and the ALL parameter is not specified or defaulted), the default is that the channel names only are displayed. On z/OS, the CHLTYPE and QSGDISP values are also displayed.
- TYPE
- This is optional. It
can be used to restrict the display to channels of one type. The value is one of the following:
- MQTT
- Telemetry channels only are displayed.
CHLTYPE(type) can be used as a synonym for this parameter.
Requested parameters
Specify one or more DISPLAY CHANNEL parameters that define the data to be displayed. You can specify the parameters in any order, but do not specify the same parameter more than once.