DISPLAY COMMINFO on Multiplatforms

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


Use MQSC commands

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

Synonym: DIS COMMINFO

DISPLAY COMMINFO

DISPLAY COMMINFO ( generic-comminfo-name ) WHERE(FilterCondition) ALL TYPE(MULTICAST)requested attrsRequested attrs,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, we 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.

        We 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), we 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.