DISPLAY LSSTATUS on Multiplatforms

Use the MQSC command DISPLAY LSSTATUS to display status information for one or more listeners.


Use MQSC commands

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

Synonym: DIS LSSTATUS

DISPLAY LSSTATUS

DISPLAY LSSTATUS ( generic-listener-name ) WHERE(FilterCondition)
  • ALL
  • requested attrs
  • Requested attrs,ADAPTER1
  • BACKLOGCOMMANDS1
  • CONTROLDESCRIPADDRLOCLNAME1
  • NTBNAMES1
  • PIDPORTSESSIONS1
  • SOCKET1
  • STARTDASTARTTISTATUSTPNAME1
  • TRPTYPE
  • Notes:

    • 1 Valid only on Windows.


    Keyword and parameter descriptions for DISPLAY LSSTATUS

    You must specify a listener for which you want to display status information. We can specify a listener by using either a specific listener name or a generic listener name. By using a generic listener name, we can display either:

    • Status information for all listener definitions, by using a single asterisk (*), or
    • Status information for one or more listeners that match the specified name.

      ( generic-listener-name )
      The name of the listener definition for which status information is to be displayed. A single asterisk (*) specifies that information for all connection identifiers is to be displayed. A character string with an asterisk at the end matches all listeners with the string followed by zero or more characters.

      WHERE
      Specify a filter condition to display information for those listeners that satisfy the selection criterion of the filter condition. The filter condition is in three parts: filter-keyword, operator, and filter-value:

        filter-keyword
        Any parameter that can be used to display attributes for this DISPLAY command.
        operator
        This is used to determine whether a listener 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.
        • A generic value. This is a character string. 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.

          We cannot use a generic filter-value for parameters with numeric values or with one of a set of values.

      ALL
      Display all the status information for each specified listener. This is the default if we do not specify a generic name, and do not request any specific parameters.


    Requested parameters

    Specify one or more attributes that define the data to be displayed. The attributes can be specified in any order. Do not specify the same attribute more than once.

      ADAPTER
      The adapter number on which NetBIOS listens.

      BACKLOG
      The number of concurrent connection requests that the listener supports.

      CONTROL
      How the listener is to be started and stopped:

        MANUAL
        The listener is not to be started automatically or stopped automatically. It is to be controlled by use of the START LISTENER and STOP LISTENER commands.
        QMGR
        The listener being defined is to be started and stopped at the same time as the queue manager is started and stopped.
        STARTONLY
        The listener is to be started at the same time as the queue manager is started, but is not requested to stop when the queue manager is stopped.

      DESCR
      Descriptive comment.

      IPADDR
      The listener's IP address.

      LOCLNAME
      The NetBIOS local name that the listener uses.

      NTBNAMES
      The number of names that the listener can use.

      PID
      The operating system process identifier associated with the listener.

      PORT
      The port number for TCP/IP.

      SESSIONS
      The number of sessions that the listener can use.

      SOCKET
      SPX socket.

      STARTDA
      The date on which the listener was started.

      STARTTI
      The time at which the listener was started.

      STATUS
      The current status of the listener. It can be one of:

        RUNNING
        The listener is running.

        STARTING
        The listener is in the process of initializing.

        STOPPING
        The listener is stopping.

      TPNAME
      The LU6.2 transaction program name.

      TRPTYPE
      Transport type.

    For more information on these parameters, see DEFINE LISTENER on Multiplatforms.