Listener properties
We can set attributes for all types of listeners. Some attributes are specific to certain types of listener.
The following table lists all the attributes that we can set.
For each attribute, there is a brief description of when you might need to configure the attribute. The tables also give the equivalent MQSC parameter for the ALTER LISTENER and DISPLAY LISTENER commands. For more information about MQSC commands, see Script (MQSC) Commands in the online IBM MQ product documentation.
General page
The following table lists the attributes that we can set on the General page of the Listener properties dialog.
| Attribute | Meaning | MQSC parameter |
|---|---|---|
| Listener name | Read-only. We cannot change the name of the listener after it has been created. | LISTENER |
| Description | Type a meaningful description of the purpose of the listener. See Entering strings in MQ Explorer. | DESCR |
| Control | To configure the listener to start and stop when the queue manager starts and stops, click Queue Manager; to configure the listener to start when the queue manager starts but not stopped when the queue manager is stopped, click Queue Manager Start; to configure the listener so that it does not start automatically and must be started manually, click Manual. | CONTROL |
| Transmission protocol | Read-only. This attribute shows the transport protocol that the listener uses. To use a different transport protocol, you must create a new listener object; we cannot change the transport protocol of an existing listener object. | TRPTYPE |
| Port | Type the port number on which the listener listens for connections. | PORT |
| IP address | Type the name of the computer on which the listener listens for connections. We can use any of the following formats: IPv4 dotted decimal, IPv6 hexadecimal, or the fully qualified host name, for example joho.hursley.ibm.com. If no value is specified, the listener listens on all available IPv4 and IPv6 addresses. | IPADDR |
| TP Name | Type the LU 6.2 transaction program name. | TPNAME |
| Adapter | Type the number of the adapter on which NetBIOS listens. The default value is adapter 0. | ADAPTER |
| Local Name | Type the NetBIOS local name that the listener uses. The default value is defined by the protocol. | LOCLNAME |
| Name count | Type the number of names that the listener can use. The default value is defined by the protocol. | NTBNAMES |
| Session count | Type the number of sessions that the listener can use. The default value is defined by the protocol. | SESSIONS |
| Command count | Type the number of commands that the listener can use. The default value is defined by the protocol. | COMMANDS |
| Backlog | Type the maximum number of concurrent connection requests that the listener supports. The default value is defined by the protocol. | BACKLOG |
| Socket | Type the number of the SPX socket on which the listener listens for connections. The default value is hexadecimal 5E86. | SOCKET |
| Listener status | Read-only. This attribute shows the current status of the listener, which can be Running, Starting, or Stop. | STATUS |
| Alteration date | Read-only. This attribute shows the date on which the listener's attributes were last altered. | ALTDATE |
| Alteration time | Read-only. This attribute shows the time at which the listener's attributes were last altered. | ALTTIME |
General page for z/OS listeners
Z/OS listener properties cannot be altered once the listener has been defined. The properties are set when you add a new z/OS® listener.
| Attribute | Meaning | MQSC parameter |
|---|---|---|
| Listener status | Read-only. This attribute shows the current status of the listener, which can Running, Starting, Retrying, or Stop. | STATUS |
| Transmission protocol | Read-only. This attribute shows the transport protocol that the listener uses. To use a different transport protocol, you must create a new listener; we cannot change the transport protocol of an existing listener object. | TRPTYPE |
| Port number | Read-only. The port number on which the listener listens for connections. | PORT |
| IP address | Read-only. The name of the computer on which the listener listens for connections. | IPADDR |
| Inbound | Read-only. This attribute Specifies the disposition of the inbound transmissions that are to be handled. The possible values are: Group or Queue Manager. | INDISP |
| LU name | Read-only. The LU name of the listener, we can set it when you define the listener. | LUNAME |