[UNIX, Linux, Windows, IBM i]

DISPLAY COMMINFO (display communication information) on Multiplatforms

Use the MQSC command DISPLAY COMMINFO to display the attributes of a communication information object.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

Synonym: DIS COMMINFO

DISPLAY COMMINFO

Read syntax diagramSkip visual syntax diagram DISPLAY COMMINFO ( generic-comminfo-name ) WHERE(FilterCondition) ALL TYPE(MULTICAST)requested attrs
Requested attrs
Read syntax diagramSkip visual syntax diagram,ALTDATEALTTIMEBRIDGECCSIDCOMMEVDESCRENCODINGGRPADDRMCHBINTMCPROPMONINTMSGHISTNSUBHISTPORT

Parameter descriptions for DISPLAY COMMINFO

You must specify the name of the communication information object you want to display. This can be a specific communication information object name or a generic communication information object name. By using a generic communication information object name, you can display either:
  • All communication information object definitions
  • One or more communication information objects that match the specified name
(generic-comminfo-name)
The name of the communication information object definition to be displayed (see Rules for naming IBM® MQ objects ). A trailing asterisk (*) matches all communication information objects with the specified stem followed by zero or more characters. An asterisk (*) on its own specifies all communication information objects. The names must all be defined to the local queue manager.
WHERE
Specify a filter condition to display only those communication information object definitions 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.
operator
This is used to determine whether a communication information object definition 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
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 DISABLED on the COMMEV 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*. 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.
ALL
Specify this to display all the parameters. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.
TYPE
Indicates the type of namelist to be displayed.
MULTICAST
Displays multicast communication information objects. This is the default.

Requested parameters

Specify one or more parameters that define the data to be displayed. The parameters can be specified in any order, but do not specify the same parameter more than once.

The default, if no parameters are specified (and the ALL parameter is not specified) is that the object names and TYPE parameters are displayed.
ALTDATE
The date on which the definition was last altered, in the form yyyy-mm-dd
ALTTIME
The time at which the definition was last altered, in the form hh.mm.ss
BRIDGE
Multicast bridging
CCSID
The coded character set identifier that messages are transmitted on.
COMMEV
Whether event messages are generated for Multicast.
DESCR( string )
Description
ENCODING
The encoding that the messages are transmitted in.
GRPADDR
The group IP address or DNS name.
MCHBINT
Multicast heartbeat interval.
MCPROP
Multicast property control
MONINT
Monitoring frequency.
MSGHIST
The amount of message history in kilobytes that is kept by the system to handle retransmissions in the case of NACKs (negative acknowledgments).
NSUBHIST
How much history a new subscriber joining a publication stream receives.
PORT
The port number to transmit on.