Inquire Channel Listener (Response) on Multiplatforms
The response to the Inquire Channel Listener (MQCMD_INQUIRE_LISTENER) command consists of the response header followed by the ListenerName structure and the requested combination of attribute parameter structures.
If a generic listener name was specified, one such message is generated for each listener found.
- Always returned:
- ListenerName
- Returned if requested:
- Adapter, AlterationDate, AlterationTime, Backlog, Commands, IPAddress, ListenerDesc, LocalName, NetbiosNames, Port, Sessions, Socket, StartMode, TPname, TransportType
Response data
- AlterationDate (MQCFST)
- Alteration date (parameter identifier: MQCA_ALTERATION_DATE).
The date, in the form yyyy-mm-dd, on which the information was last altered.
- AlterationTime (MQCFST)
- Alteration time (parameter identifier: MQCA_ALTERATION_TIME).
The time, in the form hh.mm.ss, at which the information was last altered.
- Adapter (MQCFIN)
- Adapter number (parameter identifier: MQIACH_ADAPTER).
The adapter number on which NetBIOS listens. This parameter is valid only on Windows.
- Backlog (MQCFIN)
- Backlog (parameter identifier: MQIACH_BACKLOG).
The number of concurrent connection requests that the listener supports.
- Commands (MQCFIN)
- Adapter number (parameter identifier: MQIACH_COMMAND_COUNT).
The number of commands that the listener can use. This parameter is valid only on Windows.
- IPAddress (MQCFST)
- IP address (parameter identifier: MQCACH_IP_ADDRESS).
IP address for the listener specified in IPv4 dotted decimal, IPv6 hexadecimal notation, or alphanumeric host name form.
The maximum length of the string is MQ_CONN_NAME_LENGTH
- ListenerDesc (MQCFST)
- Description of listener definition (parameter identifier: MQCACH_LISTENER_DESC).
The maximum length of the string is MQ_LISTENER_DESC_LENGTH.
- ListenerName (MQCFST)
- Name of listener definition (parameter identifier: MQCACH_LISTENER_NAME).
The maximum length of the string is MQ_LISTENER_NAME_LENGTH.
- LocalName (MQCFST)
- NetBIOS local name (parameter identifier: MQCACH_LOCAL_NAME).
The NetBIOS local name that the listener uses. This parameter is valid only on Windows.
The maximum length of the string is MQ_CONN_NAME_LENGTH
- NetbiosNames (MQCFIN)
- NetBIOS names (parameter identifier: MQIACH_NAME_COUNT).
The number of names that the listener supports. This parameter is valid only on Windows.
- Port (MQCFIN)
- Port number (parameter identifier: MQIACH_PORT).
The port number for TCP/IP. This parameter is valid only if the value of TransportType is MQXPT_TCP.
- Sessions (MQCFIN)
- NetBIOS sessions (parameter identifier: MQIACH_SESSION_COUNT).
The number of sessions that the listener can use. This parameter is valid only on Windows.
- Socket (MQCFIN)
- SPX socket number (parameter identifier: MQIACH_SOCKET).
The SPX socket on which to listen. This parameter is valid only if the value of TransportType is MQXPT_SPX.
- StartMode (MQCFIN)
- Service mode (parameter identifier: MQIACH_LISTENER_CONTROL).
Specifies how the listener is to be started and stopped. The value can be any of the following values:
- MQSVC_CONTROL_MANUAL
- The listener is not to be started automatically or stopped automatically. It is to be controlled by user command. MQSVC_CONTROL_MANUAL is the default value.
- MQSVC_CONTROL_Q_MGR
- The listener being defined is to be started and stopped at the same time as the queue manager is started and stopped.
- MQSVC_CONTROL_Q_MGR_START
- The listener is to be started at the same time as the queue manager is started, but is not request to stop when the queue manager is stopped.
- TPName (MQCFST)
- Transaction program name (parameter identifier: MQCACH_TP_NAME).
The LU 6.2 transaction program name. This parameter is valid only on Windows.
The maximum length of the string is MQ_TP_NAME_LENGTH
- TransportType (MQCFIN)
- Transmission protocol (parameter identifier: MQIACH_XMIT_PROTOCOL_TYPE).
The value can be:
- MQXPT_TCP
- TCP.
- MQXPT_LU62
- LU 6.2. MQXPT_LU62 is valid only on Windows.
- MQXPT_NETBIOS
- NetBIOS. MQXPT_NETBIOS is valid only on Windows.
- MQXPT_SPX
- SPX. MQXPT_SPX is valid only on Windows.
Parent topic: Definitions of the Programmable Command Formats