DISPLAY LISTENER
Use the MQSC command DISPLAY LISTENER to display information about a listener.
Using MQSC commands
For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.
IBM® i | UNIX and Linux® | Windows | z/OS® |
---|---|---|---|
Usage notes
The values displayed describe the current definition of the listener. If the listener has been altered since it was started, the currently running instance of the listener object may not have the same values as the current definition.
Keyword and parameter descriptions for DISPLAY LISTENER
- Information about all listener definitions, by using a single asterisk (*), or
- Information about one or more listeners that match the specified name.
- ( generic-listener-name )
- The name of the listener definition for which information is to be displayed. A single asterisk (*) specifies that information for all listener 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.
- TRPTYPE
-
Transmission protocol. If you specify this parameter, it must follow directly after the generic-listener-name parameter. If you do not specify this parameter, a default of ALL is assumed. Values are:
- ALL
- This is the default value and displays information for all listeners.
- LU62
- Displays information for all listeners defined with a value of LU62 in their TRPTYPE parameter.
- NETBIOS
- Displays information for all listeners defined with a value of NETBIOS in their TRPTYPE parameter.
- SPX
- Displays information for all listeners defined with a value of SPX in their TRPTYPE parameter.
- TCP
- Displays information for all listeners defined with a value of TCP in their TRPTYPE parameter.
- 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.
You cannot use a generic filter-value for parameters with numeric values or with one of a set of values.
- ALL
-
Specify this to display all the listener information for each specified listener. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.
This is the default if you do not specify a generic identifier, 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.
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.
- 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
. - BACKLOG
- The number of concurrent connection requests that the listener supports.
- COMMANDS
- The number of commands that the listener can use.
- 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.
- PORT
- The port number for TCP/IP.
- SESSIONS
- The number of sessions that the listener can use.
- SOCKET
- SPX socket.
- TPNAME
- The LU6.2 transaction program name.