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