Inquire Communication Information Object (Response) on Multiplatforms
The response to the Inquire Communication Information Object (MQCMD_INQUIRE_COMM_INFO) command consists of the response header followed by the ComminfoName structure, and the requested combination of attribute parameter structures (where applicable).
If a generic communication information name was specified, one such message is generated for each object found.
- Always returned:
- ComminfoName
- Returned if requested:
- AlterationDate, AlterationTime, Bridge, CCSID, CommEvent, Description, Encoding, GrpAddress, MonitorInterval, MulticastHeartbeat, MulticastPropControl, MsgHistory, NewSubHistory, PortNumber, Type
Response data
- AlterationDate (MQCFST)
- Alteration date (parameter identifier: MQCA_ALTERATION_DATE).
The date when the information was last altered, in the form yyyy-mm-dd.
- AlterationTime (MQCFST)
- Alteration time (parameter identifier: MQCA_ALTERATION_TIME).
The time when the information was last altered, in the form hh.mm.ss.
- Bridge (MQCFIN)
- Multicast Bridging (parameter identifier: MQIA_MCAST_BRIDGE).
Controls whether publications from applications not using Multicast are bridged to applications using multicast.
- CCSID (MQCFIN)
- CCSID that messages are trasmitted in (parameter identifier: MQIA_CODED_CHAR_SET_ID).
The coded character set identifier that messages are transmitted in.
- CommEvent (MQCFIN)
- Event Control (parameter identifier: MQIA_COMM_EVENT).
Controls whether event messages are generated for multicast handles that are created using this
COMMINFO object. The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- MQEVR_EXCEPTION
- Reporting of events for message reliability below the reliability threshold enabled.
- ComminfoName (MQCFST)
- The name of the communication information definition (parameter identifier:
MQCA_COMM_INFO_NAME).
The maximum length of the string is MQ_COMM_INFO_NAME_LENGTH.
- Description (MQCFST)
- Description of the communication information definition (parameter identifier:
MQCA_COMM_INFO_DESC).
The maximum length of the string is MQ_COMM_INFO_DESC_LENGTH.
- Encoding (MQCFIN)
- Encoding that messages are transmitted in (parameter identifier: MQIACF_ENCODING).
The encoding that messages are transmitted in. The value can be any of the following values:
- MQENC_AS_PUBLISHED
- Encoding taken from published message.
- MQENC_NORMAL
- MQENC_REVERSED
- MQENC_S390
- MQENC_TNS
- GrpAddress (MQCFST)
- The group IP address or DNS name (parameter identifier: MQCACH_GROUP_ADDRESS).
The maximum length of the string is MQ_GROUP_ADDRESS_LENGTH.
- MonitorInterval (MQCFIN)
- Frequency of monitoring (parameter identifier: MQIA_MONITOR_INTERVAL).
How frequently, in seconds, monitoring information is updated and event messages are generated.
- MulticastHeartbeat (MQCFIN)
- Heartbeat Interval for multicast (parameter identifier: MQIACH_MC_HB_INTERVAL).
The heartbeat interval, in milliseconds, for multicast transmitters.
- MulticastPropControl (MQCFIN)
- Multicast property control (parameter identifier: MQIACH_MULTICAST_PROPERTIES).
Control which MQMD properties and user properties flow with the message. The value can be any of
the following values:
- MQMCP_ALL
- All MQMD and user properties.
- MQMAP_REPLY
- Properties related to replying to messages.
- MQMAP_USER
- Only user properties.
- MQMAP_NONE
- No MQMD or user properties.
- MQMAP_COMPAT
- Properties are transmitted in a format compatible with previous Multicast clients.
- MsgHistory (MQCFIN)
- Message History (parameter identifier: MQIACH_MSG_HISTORY).
The amount of message history, in kilobytes, that is kept by the system to handle retransmissions in the case of NACKS.
- NewSubHistory (MQCFIN)
- New Subscriber History (parameter identifier: MQIACH_NEW_SUBSCRIBER_HISTORY).
Controls how much historical data a new subscriber receives. The value can be any of the
following values:
- MQNSH_NONE
- Only publications from the time of the subscription are sent.
- MQNSH_ALL
- As much history as is known is retransmitted.
- PortNumber (MQCFIN)
- Port Number (parameter identifier: MQIACH_PORT).
The port number to transmit on.
- Type (MQCFIN)
- The type of the communications information definition (parameter identifier:
MQIA_COMM_INFO_TYPE).
The value can be:
- MQCIT_MULTICAST
- Multicast.
Parent topic: Definitions of the Programmable Command Formats