![[UNIX, Linux, Windows, IBM i]](ngmulti.gif)
MQCMD_INQUIRE_LISTENER (Inquire Channel Listener) Response on Multiplatforms
The response to the Inquire Channel Listener (MQCMD_INQUIRE_LISTENER) PCF command consists of
the response header followed by the ListenerName
structure and
the requested combination of attribute parameter structures.
- 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.