Inquire Communication Information Object on Multiplatforms
The Inquire Communication Information Object (MQCMD_INQUIRE_COMM_INFO) command inquires about the attributes of existing IBM MQ communication information objects.
- Required parameters:
- ComminfoName
- Optional parameters:
- ComminfoAttrs, IntegerFilterCommand, StringFilterCommand
Required parameters
- ComminfoName (MQCFST)
- The name of the communication information definition about which information is to be returned
(parameter identifier: MQCA_COMM_INFO_NAME).
The communication information name is always returned regardless of the attributes requested.
The maximum length of the string is MQ_COMM_INFO_NAME_LENGTH.
Optional parameters
- ComminfoAttrs (MQCFIL)
- Comminfo attributes (parameter identifier: MQIACF_COMM_INFO_ATTRS).
The attribute list might specify the following value on its own - default value if the parameter
is not specified:
- MQIACF_ALL
- All attributes.
or a combination of the following:
- MQIA_CODED_CHAR_SET_ID
- CCSID for transmitted messages.
- MQIA_COMM_EVENT
- Comminfo event control.
- MQIA_MCAST_BRIDGE
- Multicast bridging.
- MQIA_MONITOR_INTERVAL
- Frequency of update for monitoring information.
- MQIACF_ENCODING
- Encoding for transmitted messages.
- MQIACH_MC_HB_INTERVAL
- Multicast heartbeat interval.
- MQIACH_MSG_HISTORY
- Amount of message history being kept.
- MQIACH_MULTICAST_PROPERTIES
- Multicast properties control.
- MQIACH_NEW_SUBSCRIBER_HISTORY
- New subscriber history.
- MQIACH_PORT
- Port Number.
- MQCA_ALTERATION_DATE
- The date on which the information was last altered.
- MQCA_ALTERATION_TIME
- The time at which the information was last altered.
- MQCA_COMM_INFO_DESC
- Comminfo description.
- MQCA_COMM_INFO_TYPE
- Comminfo type
- MQCACH_GROUP_ADDRESS
- Group Address.
- IntegerFilterCommand (MQCFIF)
- Integer filter command descriptor. The parameter identifier must be any integer type parameter
allowed in ComminfoAttrs except MQIACF_ALL.
Use this parameter to restrict the output from the command by
specifying a filter condition. See MQCFIF - PCF integer filter parameter for information about using this
filter condition.
If you specify an integer filter for ComminfoType (MQIA_COMM_INFO_TYPE), we cannot also specify the ComminfoType parameter.
If you specify an integer filter, we cannot also specify a string filter using the StringFilterCommand parameter.
- StringFilterCommand (MQCFSF)
- String filter command descriptor. The parameter identifier must be any string type parameter
allowed in ComminfoAttrs except MQCA_COMM_INFO_NAME.
Use this parameter to restrict the output from the command by specifying a filter condition. See
MQCFSF - PCF string filter parameter for information about using this filter condition.
If you specify a string filter, we cannot also specify an integer filter using the IntegerFilterCommand parameter.
Parent topic: Definitions of the Programmable Command Formats