Inquire Queue Manager (Response)
The response to the Inquire Queue Manager (MQCMD_INQUIRE_Q_MGR) command consists of the response header followed by the QMgrName structure and the requested combination of attribute parameter structures.
- Always returned:
- QMgrName
- Returned if requested:
- AccountingConnOverride , AccountingInterval , ActivityConnOverride , ActivityRecording , ActivityTrace , AdoptNewMCACheck , AdoptNewMCAType , AdvancedCapability , AlterationDate , AlterationTime , AMQPCapability , AuthorityEvent , BridgeEvent , CertificateLabel , CertificateValPolicy , CFConlos , ChannelAutoDef , ChannelAutoDefEvent , ChannelAutoDefExit , ChannelAuthenticationRecords , ChannelEvent , ChannelInitiatorControl , ChannelMonitoring , ChannelStatistics , ChinitAdapters , ChinitDispatchers , ChinitServiceParm , ChinitTraceAutoStart , ChinitTraceTableSize , ClusterSenderMonitoringDefault , ClusterSenderStatistics , ClusterWorkloadData , ClusterWorkloadExit , ClusterWorkloadLength , CLWLMRUChannels , CLWLUseQ , CodedCharSetId , CommandEvent , CommandInputQName , CommandLevel , CommandServerControl , ConfigurationEvent , ConnAuth , CreationDate , CreationTime , Custom , DeadLetterQName , DefClusterXmitQueueType , DefXmitQName , DistLists , DNSGroup , DNSWLM , EncryptionPolicySuiteB , ExpiryInterval , GroupUR , IGQPutAuthority , IGQUserId , ImageInterval, ImagelogLength, ImageRecoverObject, ImageRecoverQueue, ImageSchedule, InhibitEvent , IntraGroupQueuing , IPAddressVersion , ListenerTimer , LocalEvent , LoggerEvent , LUGroupName , LUName , LU62ARMSuffix , LU62Channels , MaxChannels , MaxActiveChannels , MaxHandles , MaxMsgLength , MaxPriority , MaxPropertiesLength , MaxUncommittedMsgs , MQIAccounting , MQIStatistics OutboundPortMax , OutboundPortMin , Parent , PerformanceEvent , Platform , PubSubClus , PubSubMaxMsgRetryCount , PubSubMode , QmgrDesc , QMgrIdentifier , QSGCertificateLabel , QSGName , QueueAccounting , QueueMonitoring , QueueStatistics , ReceiveTimeout , ReceiveTimeoutMin , ReceiveTimeoutType , RemoteEvent , RepositoryName , RepositoryNamelist , RevDns , SecurityCase , SharedQQmgrName , Splcap , SSLCRLNamelist , SSLCryptoHardware , SSLEvent , SSLFIPSRequired , SSLKeyRepository , SSLKeyResetCount , SSLTasks , StartStopEvent , StatisticsInterval , SyncPoint , TCPChannels , TCPKeepAlive , TCPName , TCPStackType , TraceRouteRecording , TreeLifeTime , TriggerInterval , Version
Response data
-
Specifies whether applications can override the settings of the
QueueAccounting and
MQIAccounting queue manager parameters (parameter identifier:
MQIA_ACCOUNTING_CONN_OVERRIDE). The value can be any of the following values:
- MQMON_DISABLED
- Applications cannot override the settings of the QueueAccounting and MQIAccounting parameters.
- MQMON_ENABLED
- Applications can override the settings of the QueueAccounting and MQIAccounting parameters by using the options field of the MQCNO structure of the MQCONNX API call.
This parameter applies only to UNIX, Linux, and Windows.
- The time interval, in seconds, at which intermediate accounting records are written (parameter
identifier: MQIA_ACCOUNTING_INTERVAL).
It is a value in the range 1 through 604 000.
This parameter applies only to UNIX, Linux, and Windows.
-
Specifies whether applications can override the setting of the
ACTVTRC value in the queue manager attribute (parameter identifier:
MQIA_ACTIVITY_CONN_OVERRIDE). The value can be any of the following values:
- MQMON_DISABLED
- Applications cannot override the setting of the ACTVTRC queue manager attribute using the Options field in the MQCNO structure on the MQCONNX call. This is the default value.
- MQMON_ENABLED
- Applications can override the ACTVTRC queue manager attribute using the Options field in the MQCNO structure.
Changes to this value are only effective for connections to the queue manager after the change to the attribute.
This parameter applies only to IBM i, UNIX, and Windows.
- Whether activity reports can be generated (parameter identifier:
MQIA_ACTIVITY_RECORDING).
The value can be:
- MQRECORDING_DISABLED
- Activity reports cannot be generated.
- MQRECORDING_MSG
- Activity reports can be generated and sent to the destination specified by the originator of the message causing the report.
- MQRECORDING_Q
- Activity reports can be generated and sent to SYSTEM.ADMIN.ACTIVITY.QUEUE.
- Whether activity reports can be generated (parameter identifier:
MQIA_ACTIVITY_TRACE).
The value can be:
- MQMON_OFF
- Do not collect IBM MQ MQI application activity
trace. This is the default value.
If you set the queue manager attribute ACTVCONO to ENABLED, this value might be overridden for individual connections using the Options field in the MQCNO structure.
- MQMON_ON
- Collect IBM MQ MQI application activity trace.
Changes to this value are only effective for connections to the queue manager after the change to the attribute.
This parameter applies only to IBM i, UNIX, and Windows.
- The elements checked to determine whether an MCA must be adopted (restarted) when a new inbound
channel is detected. It is adopted if it has the same name as a currently active MCA (parameter
identifier: MQIA_ADOPTNEWMCA_CHECK).
The value can be:
- MQADOPT_CHECK_Q_MGR_NAME
- Check the queue manager name.
- MQADOPT_CHECK_NET_ADDR
- Check the network address.
- MQADOPT_CHECK_ALL
- Check the queue manager name and network address.
- MQADOPT_CHECK_NONE
- Do not check any elements.
This parameter is valid only on z/OS .
- Adoption of orphaned channel instances (parameter identifier:
MQIA_ADOPTNEWMCA_TYPE).
The value can be:
- MQADOPT_TYPE_NO
- Do not adopt orphaned channel instances.
- MQADOPT_TYPE_ALL
- Adopt all channel types.
This parameter is valid only on z/OS.
- Whether IBM MQ Advanced extended capabilities are
available for a queue manager (parameter identifier: MQIA_ADVANCED_CAPABILITY).
On z/OS, the queue manager sets the value to be MQCAP_SUPPORTED, only if the value of QMGRPROD is ADVANCEDVUE. For any other value of QMGRPROD, or if QMGRPROD is not set, the queue manager sets the value to MQCAP_NOTSUPPORTED. See START QMGR on z/OS for more information.
On other platforms, from IBM MQ Version 9.1, the queue manager sets the value to be MQCAP_SUPPORTED, only if you have installed Managed File Transfer, XR, or Advanced Message Security. If we have not installed Managed File Transfer, XR, or Advanced Message Security, AdvancedCapability is set to MQCAP_NOTSUPPORTED. See IBM MQ components and features for more information.
- Alteration date (parameter identifier: MQCA_ALTERATION_DATE).
The date, in the form yyyy-mm-dd, on which the information was last altered.
- Alteration time (parameter identifier: MQCA_ALTERATION_TIME).
The time, in the form hh.mm.ss, at which the information was last altered.
- Whether AMQP capabilities are available on a queue manager (parameter identifier:
MQIA_AMQP_CAPABILITY).
The value can be one of the following values:
- MQCAP_SUPPORTED
- AMQP capability has been installed.
- MQCAP_NOT_SUPPORTED
- AMQP capability has not been installed.
- Controls whether authorization (Not Authorized) events are generated (parameter identifier:
MQIA_AUTHORITY_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Controls whether IMS bridge events are generated (parameter identifier:
MQIA_BRIDGE_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
This parameter is valid only on z/OS.
- Certificate label in the key repository for this queue manager to use (parameter identifier:
MQCA_CERT_LABEL).
The maximum length of the string is MQ_CERT_LABEL_LENGTH.
- Specifies which TLS certificate validation policy is used to validate digital certificates
received from remote partner systems (parameter identifier: MQIA_CERT_VAL_POLICY).
This attribute can be used to control how strictly the certificate chain validation conforms to industry security standards. This parameter is valid only on UNIX, Linux, and Windows. For more information, see Certificate validation policies in IBM MQ.
The value can be any of the following values:- MQ_CERT_VAL_POLICY_ANY
- Apply each of the certificate validation policies supported by the secure sockets library and accept the certificate chain if any of the policies considers the certificate chain valid. This setting can be used for maximum backwards compatibility with older digital certificates which do not comply with the modern certificate standards.
- MQ_CERT_VAL_POLICY_RFC5280
- Apply only the RFC 5280 compliant certificate validation policy. This setting provides stricter validation than the ANY setting, but rejects some older digital certificates.
- Specifies the action to be taken when the queue manager loses connectivity to the administration
structure, or any CF structures with CFCONLOS set to ASQMGR
(parameter identifier: MQIA_QMGR_CFCONLOS).
The value can be:
- MQCFCONLOS_TERMINATE
- The queue manager terminates when connectivity to CF structures is lost.
- MQCFCONLOS_TOLERATE
- The queue manager tolerates loss of connectivity to CF structures without terminating.
This parameter is valid only on z/OS.
- Controls whether receiver and server-connection channels can be auto-defined (parameter
identifier: MQIA_CHANNEL_AUTO_DEF).
The value can be:
- MQCHAD_DISABLED
- Channel auto-definition disabled.
- MQCHAD_ENABLED
- Channel auto-definition enabled.
- Controls whether channel auto-definition events are generated (parameter identifier:
MQIA_CHANNEL_AUTO_DEF_EVENT), when a receiver, server-connection, or cluster-sender
channel is auto-defined.
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Channel auto-definition exit name (parameter identifier:
MQCA_CHANNEL_AUTO_DEF_EXIT).
The maximum length of the exit name depends on the environment in which the exit is running. MQ_EXIT_NAME_LENGTH gives the maximum length for the environment in which your application is running. MQ_MAX_EXIT_NAME_LENGTH gives the maximum for all supported environments.
- Controls whether channel authentication records are checked (parameter identifier:
MQIA_CHLAUTH_RECORDS).
The value can be:
- MQCHLA_DISABLED
- Channel authentication records are not checked.
- MQCHLA_ENABLED
- Channel authentication records are checked.
- Controls whether channel events are generated (parameter identifier:
MQIA_CHANNEL_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- MQEVR_EXCEPTION
- Reporting of exception channel events enabled.
- Start the channel initiator during queue manager start (parameter identifier:
MQIA_CHINIT_CONTROL). This parameter is not available on z/OS.
The value can be:
- MQSVC_CONTROL_MANUAL
- The channel initiator is not to be started automatically when the queue manager starts.
- MQSVC_CONTROL_Q_MGR
- The channel initiator is to be started automatically when the queue manager starts.
- Default setting for online monitoring for channels (parameter identifier:
MQIA_MONITORING_CHANNEL).
If the ChannelMonitoring channel attribute is set to
MQMON_Q_MGR
, this attribute specifies the value which is assumed by the channel. The value can be any
of the following values:
- MQMON_OFF
- Online monitoring data collection is turned off.
- MQMON_NONE
- Online monitoring data collection is turned off for channels regardless of the setting of their ChannelMonitoring attribute.
- MQMON_LOW
- Online monitoring data collection is turned on, with a low ratio of data collection.
- MQMON_MEDIUM
- Online monitoring data collection is turned on, with a moderate ratio of data collection.
- MQMON_HIGH
- Online monitoring data collection is turned on, with a high ratio of data collection.
- Specifies whether statistics data is to be collected for channels (parameter identifier:
MQIA_STATISTICS_CHANNEL).
The value can be:
- MQMON_OFF
- Statistics data collection is turned off.
- MQMON_LOW
- Statistics data collection is turned on, with a low ratio of data collection.
- MQMON_MEDIUM
- Statistics data collection is turned on, with a moderate ratio of data collection.
- MQMON_HIGH
- Statistics data collection is turned on, with a high ratio of data collection.
On z/OS systems, enabling this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results. This parameter must be enabled in order to collect channel accounting records.
This parameter is valid only on z/OS.
- Number of adapter subtasks (parameter identifier: MQIA_CHINIT_ADAPTERS).
The number of adapter subtasks to use for processing IBM MQ calls. This parameter is valid only on z/OS.
- Number of dispatchers (parameter identifier: MQIA_CHINIT_DISPATCHERS).
The number of dispatchers to use for the channel initiator. This parameter is valid only on z/OS.
- Reserved for use by IBM (parameter identifier: MQCA_CHINIT_SERVICE_PARM).
- Specifies whether the channel initiator trace must start automatically (parameter identifier:
MQIA_CHINIT_TRACE_AUTO_START).
The value can be:
- MQTRAXSTR_YES
- Channel initiator trace is to start automatically.
- MQTRAXSTR_NO
- Channel initiator trace is not to start automatically.
This parameter is valid only on z/OS.
- The size, in megabytes, of the trace data space of the channel initiator (parameter identifier:
MQIA_CHINIT_TRACE_TABLE_SIZE).
This parameter is valid only on z/OS.
- Set for online monitoring for automatically defined cluster-sender channels (parameter
identifier: MQIA_MONITORING_AUTO_CLUSSDR).
The value can be:
- MQMON_Q_MGR
- Collection of online monitoring data is inherited from the setting of the queue manager's ChannelMonitoring parameter.
- MQMON_OFF
- Monitor for the channel is disabled.
- MQMON_LOW
- Specifies a low rate of data collection with a minimal effect on system performance unless ChannelMonitoring for the queue manager is MQMON_NONE. The data collected is not likely to be the most current.
- MQMON_MEDIUM
- Specifies a moderate rate of data collection with limited effect on system performance unless ChannelMonitoring for the queue manager is MQMON_NONE.
- MQMON_HIGH
- Specifies a high rate of data collection with a likely effect on system performance unless ChannelMonitoring for the queue manager is MQMON_NONE. The data collected is the most current available.
On z/OS systems, enabling this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results.
- Specifies whether statistics data is to be collected for auto-defined cluster-sender channels
(parameter identifier: MQIA_STATISTICS_AUTO_CLUSSDR).
The value can be:
- MQMON_Q_MGR
- Collection of statistics data is inherited from the setting of the queue manager's ChannelStatistics parameter.
- MQMON_OFF
- Statistics data collection for the channel is disabled.
- MQMON_LOW
- Specifies a low rate of data collection with a minimal effect on system performance.
- MQMON_MEDIUM
- Specifies a moderate rate of data collection.
- MQMON_HIGH
- Specifies a high rate of data collection.
On z/OS systems, enabling this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results. This parameter must be enabled in order to collect channel accounting records.
- Data passed to the cluster workload exit (parameter identifier: MQCA_CLUSTER_WORKLOAD_DATA).
- Name of the cluster workload exit (parameter identifier:
MQCA_CLUSTER_WORKLOAD_EXIT).
The maximum length of the exit name depends on the environment in which the exit is running. MQ_EXIT_NAME_LENGTH gives the maximum length for the environment in which your application is running. MQ_MAX_EXIT_NAME_LENGTH gives the maximum for all supported environments.
- Cluster workload length (parameter identifier: MQIA_CLUSTER_WORKLOAD_LENGTH).
The maximum length of the message passed to the cluster workload exit.
- Cluster workload most recently used (MRU) channels (parameter identifier:
MQIA_CLWL_MRU_CHANNELS).
The maximum number of active most recently used outbound channels.
- Use of remote queue (parameter identifier: MQIA_CLWL_USEQ).
Specifies whether a cluster queue manager is to use remote puts to other queues defined in other queue managers within the cluster during workload management.
The value can be any of the following values:- MQCLWL_USEQ_ANY
- Use remote queues.
- MQCLWL_USEQ_LOCAL
- Do not use remote queues.
- Coded character set identifier (parameter identifier: MQIA_CODED_CHAR_SET_ID).
- Controls whether command events are generated (parameter identifier:
MQIA_COMMAND_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- MQEVR_NODISPLAY
- Event reporting enabled for all successful commands except Inquire commands.
- Command input queue name (parameter identifier: MQCA_COMMAND_INPUT_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- Command level supported by queue manager (parameter identifier:
MQIA_COMMAND_LEVEL).
The value can be:
- MQCMDL_LEVEL_1
- Level 1 of system control commands. This value is returned by the following platforms:
- MQSeries for AIX V2.2
- MQSeries for OS/400:
- V2R3
- V3R1
- V3R6
- MQSeries for Windows V2.0
- MQCMDL_LEVEL_101
- MQSeries for Windows V2.0.1
- MQCMDL_LEVEL_110
- MQSeries for Windows V2.1
- MQCMDL_LEVEL_200
- MQSeries for Windows NT V2.0
- MQCMDL_LEVEL_220
- Level 220 of system control commands. This value is returned by the following platforms:
- MQSeries for AT&T GIS UNIX V2.2
- MQSeries for SINIX and DC/OSx V2.2
- MQSeries for Compaq NonStop Kernel V2.2.0.1
- MQCMDL_LEVEL_221
- Level 221 of system control commands. This value is returned by the following platforms:
- MQSeries for AIX Version 2.2.1
- MQSeries for DIGITAL UNIX (Compaq Tru64 UNIX ) V2.2.1
- MQCMDL_LEVEL_320
- MQSeries for OS/400 V3R2 and V3R7
- MQCMDL_LEVEL_420
- MQSeries for AS/400 V4R2 and R2.1
- MQCMDL_LEVEL_500
- Level 500 of system control commands. This value is returned by the following platforms:
- MQSeries for AIX V5.0
- MQSeries for Windows NT V5.0
- MQCMDL_LEVEL_510
- Level 510 of system control commands. This value is returned by the following platforms:
- MQSeries for AIX V5.1
- MQSeries for AS/400 V5.1
- MQSeries for Compaq Tru64 UNIX, V5.1
- IBM WebSphere MQ for HP Integrity NonStop Server V5.3
- MQSeries for Windows NT V5.1
- MQCMDL_LEVEL_520
- Level 520 of system control commands. This value is returned by the following platforms:
- MQSeries for AIX V5.2
- MQSeries for AS/400 V5.2
- MQSeries for Linux V5.2
- MQSeries for Windows NT V5.2
- MQSeries for Windows 2000 V5.2
- MQCMDL_LEVEL_530
- Level 530 of system control commands. This value is returned by the following platforms:
- IBM WebSphere MQ for AIX, V5.3
- IBM WebSphere MQ for IBM i, V5.3
- IBM WebSphere MQ for Linux, V5.3
- IBM WebSphere MQ for Windows NT and Windows 2000, Version 5.3
- MQCMDL_LEVEL_531
- Level 531 of system control commands.
- MQCMDL_LEVEL_600
- Level 600 of system control commands.
- MQCMDL_LEVEL_700
- Level 700 of system control commands.
- MQCMDL_LEVEL_701
- Level 701 of system control commands.
- MQCMDL_LEVEL_710
- Level 710 of system control commands.
- MQCMDL_LEVEL_750
- Level 750 of system control commands. This value is returned by the following platforms:
- IBM WebSphere MQ for AIX, V7.5
- IBM WebSphere MQ for Linux, V7.5
- IBM WebSphere MQ for Windows V7.5
- MQCMDL_LEVEL_800
- Level 800 of system control commands.
- MQCMDL_LEVEL_801
- Level 801 of system control commands.
- MQCMDL_LEVEL_900
- Level 900 of system control commands.
- MQCMDL_LEVEL_901
- Level 901 of system control commands.
- MQCMDL_LEVEL_902
- Level 902 of system control commands.
- MQCMDL_LEVEL_903
- Level 903 of system control commands.
- MQCMDL_LEVEL_904
- Level 904 of system control commands.
- MQCMDL_LEVEL_905
- Level 905 of system control commands.
- MQCMDL_LEVEL_910
- Level 910 of system control commands.
- MQCMDL_LEVEL_911
- Level 911 of system control commands.
- MQCMDL_LEVEL_912
- Level 912 of system control commands.
- MQCMDL_LEVEL_913
- Level 913 of system control commands.
The set of system control commands that corresponds to a particular value of the CommandLevel attribute varies. It varies according to the value of the Platform attribute; both must be used to decide which system control commands are supported.
Note: Support for the HP-UX operating system for all IBM MQ components, including server and clients, is removed from Version 9.1. - Start the command server during queue manager start (parameter identifier:
MQIA_CMD_SERVER_CONTROL). This parameter is not available on z/OS.
The value can be:
- MQSVC_CONTROL_MANUAL
- The command server is not to be started automatically when the queue manager starts.
- MQSVC_CONTROL_Q_MGR
- The command server is to be started automatically when the queue manager starts.
- Controls whether configuration events are generated (parameter identifier:
MQIA_CONFIGURATION_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Name of the authentication information object that is used to provide the location of user ID and password authentication (parameter identifier: MQCA_CONN_AUTH).
- Custom attribute for new features (parameter identifier: MQCA_CUSTOM).
This attribute is reserved for the configuration of new features before separate attributes are introduced. It can contain the values of zero or more attributes as pairs of attribute name and value, separated by at least one space. The attribute name-value pairs have the form NAME(VALUE).
This description is updated when features using this attribute are introduced.
- Dead letter (undelivered message) queue name (parameter identifier:
MQCA_DEAD_LETTER_Q_NAME).
Specifies the name of the local queue that is to be used for undelivered messages. Messages are put on this queue if they cannot be routed to their correct destination.
The maximum length of the string is MQ_Q_NAME_LENGTH.
- The DefClusterXmitQueueType attribute controls which transmission queue is selected by default by cluster-sender channels to get messages from, to send the messages to cluster-receiver channels. (Parameter identifier:
MQIA_DEF_CLUSTER_XMIT_Q_TYPE.) The values of DefClusterXmitQueueType are
MQCLXQ_SCTQ or MQCLXQ_CHANNEL.
- MQCLXQ_SCTQ
-
All cluster-sender channels send messages from SYSTEM.CLUSTER.TRANSMIT.QUEUE. The correlID of messages placed on the transmission queue identifies which cluster-sender channel the message is destined for.
SCTQ is set when a queue manager is defined. This behavior is implicit in versions of IBM WebSphere MQ, earlier than Version 7.5. In earlier versions, the queue manager attribute DefClusterXmitQueueType was not present.
- MQCLXQ_CHANNEL
- Each cluster-sender channel sends messages from a different transmission queue. Each transmission queue is created as a permanent dynamic queue from the model queue SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE.
- Default transmission queue name (parameter identifier: MQCA_DEF_XMIT_Q_NAME).
The default transmission queue is used for the transmission of messages to remote queue managers. It is used if there is no other indication of which transmission queue to use.
The maximum length of the string is MQ_Q_NAME_LENGTH.
- Distribution list support (parameter identifier: MQIA_DIST_LISTS).
The value can be:
- MQDL_SUPPORTED
- Distribution lists supported.
- MQDL_NOT_SUPPORTED
- Distribution lists not supported.
- DNS group name (parameter identifier: MQCA_DNS_GROUP).
This parameter is no longer used. See z/OS: WLM/DNS no longer supported.
This parameter is valid only on z/OS.
- WLM/DNS Control: (parameter identifier: MQIA_DNS_WLM).
This parameter is no longer used. See z/OS: WLM/DNS no longer supported.
The value can be any of the following values:- MQDNSWLM_NO
- MQDNSWLM_NO is the only value supported by the queue manager.
This parameter is valid only on z/OS.
- Specifies whether Suite B-compliant cryptography is used and what level of strength is employed
(parameter identifier: MQIA_SUITE_B_STRENGTH). For more information about Suite B
configuration and its effect on TLS channels, see NSA Suite B Cryptography in IBM MQ .
The value can be one, or more, of:
- MQ_SUITE_B_NONE
- Suite B-compliant cryptography is not used.
- MQ_SUITE_B_128_BIT
- Suite B 128-bit strength security is used.
- MQ_SUITE_B_192_BIT
- Suite B 192-bit strength security is used.
- MQ_SUITE_B_128_BIT,MQ_SUITE_B_192_BIT
- Suite B 128-bit and Suite B 192-bit strength security is used.
- Interval between scans for expired messages (parameter identifier:
MQIA_EXPIRY_INTERVAL).
Specifies the frequency with which the queue manager scans the queues looking for expired
messages. This parameter is a time interval in seconds in the range 1 through 99 999 999, or the
following special value:
- MQEXPI_OFF
- No scans for expired messages.
This parameter is valid only on z/OS.
- Identifies whether XA client applications can establish transactions with a
GROUP unit of recovery disposition.
The value can be:
- MQGUR_DISABLED
- XA client applications must connect using a queue manager name.
- MQGUR_ENABLED
- XA client applications can establish transactions with a group unit of recovery disposition by specifying a queue sharing group name when they connect.
This parameter is valid only on z/OS.
- Type of authority checking used by the intra-group queuing agent (parameter identifier:
MQIA_IGQ_PUT_AUTHORITY).
The attribute indicates the type of authority checking that is performed by the local intra-group
queuing agent (IGQ agent). The checking is performed when the IGQ agent removes a message from the
shared transmission queue and places the message on a local queue. The value can be any of the
following values:
- MQIGQPA_DEFAULT
- Default user identifier is used.
- MQIGQPA_CONTEXT
- Context user identifier is used.
- MQIGQPA_ONLY_IGQ
- Only the IGQ user identifier is used.
- MQIGQPA_ALTERNATE_OR_IGQ
- Alternate user identifier or IGQ-agent user identifier is used.
This parameter is valid only on z/OS.
- User identifier used by the intra-group queuing agent (parameter identifier:
MQCA_IGQ_USER_ID).
The maximum length of the string is MQ_USER_ID_LENGTH. This parameter is valid only on z/OS.
- The target frequency with which the queue manager automatically writes media images (parameter
identifier: MQIA_MEDIA_IMAGE_INTERVAL). This parameter is not valid on z/OS.The value can be:
- The time interval, at which the queue manager automatically writes media images.
- MQMEDIMGINTVL_OFF
- Automatic media images are not written on a time interval basis.
- The target size of the recovery log (parameter identifier:
MQIA_MEDIA_IMAGE_LOG_LENGTH). This parameter is not valid on z/OS.The value can be:
- The size of the recovery log.
- MQMEDIMGLOGLN_OFF
- Automatic media images are not written.
- Specifies the recoverable objects from a media image, if linear logging is being used (parameter
identifier: MQIA_MEDIA_IMAGE_RECOVER_OBJ). This parameter is not valid on z/OS.The value can be:
- MQIMGRCOV_NO
- Automatic media images, if enabled, are not written for these objects.
- MQIMGRCOV_YES
- These objects are recoverable.
- Displays the default ImageRecoverQueue attribute for local and permanent
dynamic queue objects, when used with this parameter (parameter identifier:
MQIA_MEDIA_IMAGE_RECOVER_Q). This parameter is not valid on z/OS.The value can be:
- MQIMGRCOV_NO
- The ImageRecoverQueue attribute for local and permanent dynamic queue objects is set to MQIMGRCOV_NO .
- MQIMGRCOV_YES
- The ImageRecoverQueue attribute for local and permanent dynamic queue objects is set to MQIMGRCOV_YES .
- Whether the queue manager automatically writes media images (parameter identifier:
MQIA_MEDIA_IMAGE_SCHEDULING). This parameter is not valid on z/OS.The value can be:
- MQMEDIMGSCHED_AUTO
- The queue manager automatically writes a media image for an object.
- MQMEDIMGSCHED_MANUAL
- Automatic media images are not written.
- Controls whether inhibit (Inhibit Get and Inhibit Put) events are generated (parameter
identifier: MQIA_INHIBIT_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Specifies whether intra-group queuing is used (parameter identifier:
MQIA_INTRA_GROUP_QUEUING).
The value can be:
- MQIGQ_DISABLED
- Intra-group queuing is disabled. All messages destined for other queue managers in the queue sharing group are transmitted using conventional channels.
- MQIGQ_ENABLED
- Intra-group queuing is enabled.
This parameter is valid only on z/OS.
- IP address version selector (parameter identifier: MQIA_IP_ADDRESS_VERSION).
Specifies which IP address version, either IPv4
or IPv6, is used. The value can be:
- MQIPADDR_IPv4
- IPv4 is used.
- MQIPADDR_IPv6
- IPv6 is used.
- Listener restart interval (parameter identifier: MQIA_LISTENER_TIMER).
The time interval, in seconds, between attempts by IBM MQ to restart the listener after an APPC or TCP/IP failure.
- Controls whether local error events are generated (parameter identifier:
MQIA_LOCAL_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
This parameter is valid only on z/OS.
- Controls whether recovery log events are generated (parameter identifier:
MQIA_LOGGER_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
This parameter applies only to UNIX, Linux, and Windows.
- Generic LU name for the LU 6.2 listener (parameter identifier:
MQCA_LU_GROUP_NAME).
The generic LU name to be used by the LU 6.2 listener that handles inbound transmissions for the queue sharing group. This parameter is valid only on z/OS.
- LU name to use for outbound LU 6.2 transmissions (parameter identifier:
MQCA_LU_NAME).
The name of the LU to use for outbound LU 6.2 transmissions. This parameter is valid only on z/OS.
- APPCPM suffix (parameter identifier: MQCA_LU62_ARM_SUFFIX).
The suffix of the APPCPM member of SYS1.PARMLIB. This suffix nominates the LUADD for this channel initiator. This parameter is valid only on z/OS.
- Maximum number of LU 6.2 channels (parameter identifier: MQIA_LU62_CHANNELS).
The maximum number of channels that can be current, or clients that can be connected, that use the LU 6.2 transmission protocol. This parameter is valid only on z/OS.
- Maximum number of channels (parameter identifier: MQIA_ACTIVE_CHANNELS).
The maximum number of channels that can be active at any time. This parameter is valid only on z/OS.
- Maximum number of current channels (parameter identifier: MQIA_MAX_CHANNELS).
The maximum number of channels that can be current (including server-connection channels with connected clients). This parameter is valid only on z/OS.
- Maximum number of handles (parameter identifier: MQIA_MAX_HANDLES).
Specifies the maximum number of handles that any one connection can have open at the same time.
- Maximum message length (parameter identifier: MQIA_MAX_MSG_LENGTH).
- Maximum priority (parameter identifier: MQIA_MAX_PRIORITY).
- Maximum properties length (parameter identifier: MQIA_MAX_PROPERTIES_LENGTH).
- Maximum number of uncommitted messages within a unit of work (parameter identifier:
MQIA_MAX_UNCOMMITTED_MSGS).
This number is the sum of the following number of messages under any one sync point. :
- The number of messages that can be retrieved, plus
- The number of messages that can be put on a queue, plus
- Any trigger messages generated within this unit of work
The limit does not apply to messages that are retrieved or put outside sync point.
- Specifies whether accounting information for MQI data is to be collected (parameter identifier:
MQIA_ACCOUNTING_MQI).
The value can be:
- MQMON_OFF
- MQI accounting data collection is disabled.
- MQMON_ON
- MQI accounting data collection is enabled.
This parameter applies only to UNIX, Linux, and Windows.
- Specifies whether statistics monitoring data is to be collected for the queue manager (parameter
identifier: MQIA_STATISTICS_MQI).
The value can be:
- MQMON_OFF
- Data collection for MQI statistics is disabled. MQMON_OFF is the initial default value of the queue manager.
- MQMON_ON
- Data collection for MQI statistics is enabled.
This parameter applies only to UNIX, Linux, and Windows.
- Mark-browse interval (parameter identifier: MQIA_MSG_MARK_BROWSE_INTERVAL). The time interval in milliseconds after which the queue manager can automatically unmark messages. Attention: This value should not be below the default of 5000.
- The maximum value in the range for the binding of outgoing channels (parameter identifier:
MQIA_OUTBOUND_PORT_MAX).
The maximum value in the range of port numbers to be used when binding outgoing channels. This parameter is valid only on z/OS.
- The minimum value in the range for the binding of outgoing channels (parameter identifier:
MQIA_OUTBOUND_PORT_MIN).
The minimum value in the range of port numbers to be used when binding outgoing channels. This parameter is valid only on z/OS.
- The name of the hierarchically connected queue manager nominated as the parent of this queue manager (parameter identifier: MQCA_PARENT).
- Controls whether performance-related events are generated (parameter identifier:
MQIA_PERFORMANCE_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Platform on which the queue manager resides (parameter identifier:
MQIA_PLATFORM).
The value can be:
- MQPL_AIX
- AIX (same value as MQPL_UNIX).
- MQPL_APPLIANCE
- IBM MQ Appliance
- MQPL_NSK
- HP Integrity NonStop Server.
- MQPL_OS400
- IBM i.
- MQPL_UNIX
- UNIX.
- MQPL_WINDOWS_NT
- Windows.
- MQPL_ZOS
- z/OS
- Controls whether the queue manager participates in publish/subscribe clustering (parameter
identifier: MQIA_PUBSUB_CLUSTER).
The value can be:
- MQPSCLUS_ENABLED
- The creating or receipt of clustered topic definitions and cluster subscriptions is permitted. Note: The introduction of a clustered topic into a large IBM MQ cluster can cause a degradation in performance. This degradation occurs because all partial repositories are notified of all the other members of the cluster. Unexpected subscriptions might be created at all other nodes; for example, where proxysub(FORCE) is specified. Large numbers of channels might be started from a queue manager; for example, on resync after a queue manager failure.
- MQPSCLUS_DISABLED
- The creating or receipt of clustered topic definitions and cluster subscriptions is inhibited. The creations or receipts are recorded as warnings in the queue manager error logs.
- The number of attempts to reprocess a failed command message under sync point (parameter identifier: MQIA_PUBSUB_MAXMSG_RETRY_COUNT).
- Specifies whether the publish/subscribe engine and the queued publish/subscribe interface are
running. The publish/subscribe engine enables applications to publish or subscribe by using the
application programming interface. The publish/subscribe interface monitors the queues used the
queued publish/subscribe interface (parameter identifier: MQIA_PUBSUB_MODE).
The values can be as follows:
- MQPSM_COMPAT
- The publish/subscribe engine is running. It is therefore possible to publish or subscribe by using the application programming interface. The queued publish/subscribe interface is not running. Therefore any message that is put to the queues that are monitored by the queued publish/subscribe interface is not acted on. MQPSM_COMPAT is used for compatibility with versions of IBM Integration Bus, (formerly known as WebSphere Message Broker) prior to version 7 that use this queue manager.
- MQPSM_DISABLED
- The publish/subscribe engine and the queued publish/subscribe interface are not running. It is therefore not possible to publish or subscribe by using the application programming interface. Any publish/subscribe messages that are put to the queues that are monitored by the queued publish/subscribe interface are not acted on.
- MQPSM_ENABLED
- The publish/subscribe engine and the queued publish/subscribe interface are running. It is therefore possible to publish or subscribe by using the application programming interface and the queues that are being monitored by the queued publish/subscribe interface. MQPSM_ENABLED is the initial default value of the queue manager.
- Specifies whether to discard or keep an undelivered input message (parameter identifier:
MQIA_PUBSUB_NP_MSG).
The values can be as follows:
- MQUNDELIVERED_DISCARD
- Non-persistent input messages can be discarded if they cannot be processed. MQUNDELIVERED_DISCARD is the default value.
- MQUNDELIVERED_KEEP
- Non-persistent input messages are not discarded if they cannot be processed. The queued publish/subscribe interface continues to try the process again at appropriate intervals. It does not continue processing subsequent messages.
- Controls the behavior of undelivered response messages (parameter identifier:
MQIA_PUBSUB_NP_RESP).
The values can be as follows:
- MQUNDELIVERED_NORMAL
- Non-persistent responses that cannot be placed on the reply queue are put on the dead letter queue. If they cannot be placed on the dead letter queue, they are discarded.
- MQUNDELIVERED_SAFE
- Non-persistent responses that cannot be placed on the reply queue are put on the dead letter queue. If the response cannot be sent and cannot be placed on the dead letter queue the queued publish/subscribe interface rolls back the current operation. The operation is tried again at appropriate intervals and does not continue processing subsequent messages.
- MQUNDELIVERED_DISCARD
- Non-persistent responses that cannot be placed on the reply queue are discarded. MQUNDELIVERED_DISCARD is the default value for new queue managers.
- MQUNDELIVERED_KEEP
- Non-persistent responses are not placed on the dead letter queue or discarded. Instead, the queued publish/subscribe interface backs out the current operation and then tries it again at appropriate intervals.
- Specifies whether only persistent messages or all messages are processed under sync point
(parameter identifier: MQIA_PUBSUB_SYNC_PT).
The values can be as follows:
- MQSYNCPOINT_IFPER
- This makes the queued publish/subscribe interface receive non-persistent messages outside sync point. If the daemon receives a publication outside sync point, the daemon forwards the publication to subscribers known to it outside sync point. MQSYNCPOINT_IFPER is the default value.
- MQSYNCPOINT_YES
- MQSYNCPOINT_YES makes the queued publish/subscribe interface receive all messages under sync point.
- Queue manager description (parameter identifier: MQCA_Q_MGR_DESC).
This parameter is text that briefly describes the object.
The maximum length of the string is MQ_Q_MGR_DESC_LENGTH.
Use characters from the character set identified by the coded character set identifier (CCSID) for the queue manager on which the command is executing. Using this character set ensures that the text is translated correctly.
- Queue manager identifier (parameter identifier: MQCA_Q_MGR_IDENTIFIER).
The unique identifier of the queue manager.
- Name of local queue manager (parameter identifier: MQCA_Q_MGR_NAME).
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
- Certificate label in the key repository for this queue sharing group to use (parameter
identifier: MQCA_QSG_CERT_LABEL).
The maximum length of the string is MQ_QSG_CERT_LABEL_LENGTH. This parameter is valid only on z/OS.
- Queue sharing group name (parameter identifier: MQCA_QSG_NAME).
The maximum length of the string is MQ_QSG_NAME_LENGTH. This parameter is valid only on z/OS.
- Collection of accounting (thread-level and queue-level accounting) data for queues (parameter
identifier: MQIA_ACCOUNTING_Q).
The value can be:
- MQMON_NONE
- Accounting data collection for queues is disabled.
- MQMON_OFF
- Accounting data collection is disabled for queues specifying a value of MQMON_Q_MGR in the QueueAccounting parameter.
- MQMON_ON
- Accounting data collection is enabled for queues specifying a value of MQMON_Q_MGR in the QueueAccounting parameter.
- Default setting for online monitoring for queues (parameter identifier:
MQIA_MONITORING_Q).
If the QueueMonitoring queue attribute is set to
MQMON_Q_MGR, this attribute specifies the value which is assumed by the channel.
The value can be any of the following values:
- MQMON_OFF
- Online monitoring data collection is turned off.
- MQMON_NONE
- Online monitoring data collection is turned off for queues regardless of the setting of their QueueMonitoring attribute.
- MQMON_LOW
- Online monitoring data collection is turned on, with a low ratio of data collection.
- MQMON_MEDIUM
- Online monitoring data collection is turned on, with a moderate ratio of data collection.
- MQMON_HIGH
- Online monitoring data collection is turned on, with a high ratio of data collection.
- Specifies whether statistics data is to be collected for queues (parameter identifier:
MQIA_STATISTICS_Q).
The value can be:
- MQMON_NONE
- Statistics data collection is turned off for queues regardless of the setting of their QueueStatistics parameter.
- MQMON_OFF
- Statistics data collection is turned off for queues specifying a value of MQMON_Q_MGR in their QueueStatistics parameter.
- MQMON_ON
- Statistics data collection is turned on for queues specifying a value of MQMON_Q_MGR in their QueueStatistics parameter.
This parameter is valid only on Multiplatforms.
- How long a TCP/IP channel waits to receive data from its partner (parameter identifier:
MQIA_RECEIVE_TIMEOUT).
The length of time that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state.
This parameter is valid only on z/OS.
- The minimum length of time that a TCP/IP channel waits to receive data from its partner
(parameter identifier: MQIA_RECEIVE_TIMEOUT_MIN).
The minimum length of time that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state. This parameter is valid only on z/OS.
- The qualifier to apply to
ReceiveTimeout
(parameter identifier: MQIA_RECEIVE_TIMEOUT_TYPE).
The qualifier to apply to ReceiveTimeoutType to calculate how long a TCP/IP channel waits to receive data from its partner. The wait includes heartbeats. If the wait interval expires the channel returns to the inactive state. This parameter is valid only on z/OS.
The value can be:- MQRCVTIME_MULTIPLY
- The ReceiveTimeout value is a multiplier to be applied to the negotiated value of HeartbeatInterval to determine how long a channel waits.
- MQRCVTIME_ADD
- ReceiveTimeout is a value, in seconds, to be added to the negotiated value of HeartbeatInterval to determine how long a channel waits.
- MQRCVTIME_EQUAL
- ReceiveTimeout is a value, in seconds, representing how long a channel waits.
- Controls whether remote error events are generated (parameter identifier:
MQIA_REMOTE_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Repository name (parameter identifier: MQCA_REPOSITORY_NAME).
The name of a cluster for which this queue manager is to provide a repository service.
- Repository name list (parameter identifier: MQCA_REPOSITORY_NAMELIST).
The name of a list of clusters for which this queue manager is to provide a repository service.
- Whether reverse lookup of the host name from a Domain Name Server is carried out. (parameter
identifier: MQIA_REVERSE_DNS_LOOKUP).
This attribute has an effect only on channels using a transport type (TRPTYPE) of TCP.
The value can be:- MQRDNS_DISABLED
- DNS host names are not reverse looked-up for the IP addresses of inbound channels. With this setting any CHLAUTH rules using host names are not matched.
- MQRDNS_ENABLED
- DNS host names are reverse looked-up for the IP addresses of inbound channels when this information is required. This setting is required for matching against CHLAUTH rules that contain host names, and for writing out error messages.
- Security case supported (parameter identifier: MQIA_SECURITY_CASE).
Specifies whether the queue manager supports security profile names in mixed case, or in uppercase only. The value is activated when a Refresh Security command is run with SecurityType(MQSECTYPE_CLASSES) specified.
The value can be:- MQSCYC_UPPER
- Security profile names must be in uppercase.
- MQSCYC_MIXED
- Security profile names can be in uppercase or in mixed case.
This parameter is valid only on z/OS.
- Shared-queue queue manager name (parameter identifier: MQIA_SHARED_Q_Q_MGR_NAME
).
A queue manager makes an MQOPEN call for a shared queue. The queue manager that is specified in the ObjectQmgrName parameter of the MQOPEN call is in the same queue sharing group as the processing queue manager. The SQQMNAME attribute specifies whether the ObjectQmgrName is used or whether the processing queue manager opens the shared queue directly.
The value can be any of the following values:- MQSQQM_USE
- ObjectQmgrName is used and the appropriate transmission queue is opened.
- MQSQQM_IGNORE
- The processing queue manager opens the shared queue directly.
This parameter is valid only on z/OS.
- Specifies whether the Advanced Message Security component is installed
for the version of IBM MQ that the queue manager is
running under (parameter identifier: MQIA_PROT_POLICY_CAPABILITY).
The value can be one of the following values:
- MQCAP_SUPPORTED
- If the AMS component is installed for the version of IBM MQ that the queue manager is running under.
- MQCAP_NOT_SUPPORTED
- If the AMS component is not installed.
- The TLS certificate revocation location namelist (parameter identifier:
MQCA_SSL_CRL_NAMELIST).
The length of the string is MQ_NAMELIST_NAME_LENGTH.
Indicates the name of a namelist of authentication information objects to be used for certificate revocation checking by the queue manager.
Only authentication information objects with types of LDAPCRL or OCSP are allowed in the namelist referred to by SSLCRLNamelist (MQCFST). Any other type results in an error message when the list is processed and is subsequently ignored.
- Parameters to configure the TLS cryptographic hardware (parameter identifier:
MQCA_SSL_CRYPTO_HARDWARE).
The length of the string is MQ_SSL_CRYPTO_HARDWARE_LENGTH.
Sets the name of the parameter string required to configure the cryptographic hardware present on the system.
This parameter is valid only on Multiplatforms.
- Controls whether TLS events are generated (parameter identifier:
MQIA_SSL_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- Controls whether only FIPS-certified algorithms are to be used if cryptography is executed in
IBM MQ itself (parameter identifier:
MQIA_SSL_FIPS_REQUIRED). This parameter is valid only on z/OS, UNIX, Linux, and Windows.
The value can be:
- MQSSL_FIPS_NO
- Any supported CipherSpec can be used.
- MQSSL_FIPS_YES
- Only FIPS-certified cryptographic algorithms are to be used if cryptography is executed in IBM MQ rather than cryptographic hardware.
- Location and name of the TLS key repository (parameter identifier:
MQCA_SSL_KEY_REPOSITORY).
The length of the string is MQ_SSL_KEY_REPOSITORY_LENGTH.
Indicates the name of the Secure Sockets Layer key repository.
The format of the name depends on the environment.
- TLS key reset count (parameter identifier: MQIA_SSL_RESET_COUNT).
The number of unencrypted bytes that initiating TLS channel MCAs send or receive before renegotiating the secret key.
- Number of server subtasks used for processing TLS calls (parameter identifier:
MQIA_SSL_TASKS).
The number of server subtasks used for processing TLS calls. This parameter is valid only on z/OS.
- Controls whether start and stop events are generated (parameter identifier:
MQIA_START_STOP_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- The time interval, in seconds, at which statistics monitoring data is written to the monitoring
queue (parameter identifier: MQIA_STATISTICS_INTERVAL).
This parameter is valid only on Multiplatforms.
- Sync point availability (parameter identifier: MQIA_SYNCPOINT).
The value can be:
- MQSP_AVAILABLE
- Units of work and sync pointing available.
- MQSP_NOT_AVAILABLE
- Units of work and sync pointing not available.
- The maximum number of channels that can be current, or clients that can be connected, that use
the TCP/IP transmission protocol (parameter identifier: MQIA_TCP_CHANNELS).
This parameter is valid only on z/OS.
- Specifies whether the TCP KEEPALIVE facility is to be used to check whether the other end of the
connection is still available (parameter identifier: MQIA_TCP_KEEP_ALIVE).
The value can be:
- MQTCPKEEP_YES
- The TCP KEEPALIVE facility is to be used as specified in the TCP profile configuration data set. The interval is specified in the KeepAliveInterval channel attribute.
- MQTCPKEEP_NO
- The TCP KEEPALIVE facility is not to be used.
This parameter is valid only on z/OS.
- The name of the TCP/IP system that we are using (parameter identifier:
MQIA_TCP_NAME).
This parameter is valid only on z/OS.
- Specifies whether the channel initiator can use only the TCP/IP address space specified in
TCPName, or can optionally bind to any selected TCP/IP address
(parameter identifier: MQIA_TCP_STACK_TYPE).
The value can be:
- MQTCPSTACK_SINGLE
- The channel initiator can use only the TCP/IP address space specified in TCPName.
- MQTCPSTACK_MULTIPLE
- The channel initiator can use any TCP/IP address space available to it.
This parameter is valid only on z/OS.
- Specifies whether trace-route information can be recorded and a reply message generated
(parameter identifier: MQIA_TRACE_ROUTE_RECORDING).
The value can be:
- MQRECORDING_DISABLED
- Trace-route information cannot be recorded.
- MQRECORDING_MSG
- Trace-route information can be recorded and sent to the destination specified by the originator of the message causing the trace route record.
- MQRECORDING_Q
- Trace-route information can be recorded and sent to SYSTEM.ADMIN.TRACE.ROUTE.QUEUE.
- The lifetime in seconds of non-administrative topics (parameter identifier:
MQIA_TREE_LIFE_TIME).
Non-administrative topics are those topics created when an application publishes to, or subscribes on, a topic string that does not exist as an administrative node. When this non-administrative node no longer has any active subscriptions, this parameter determines how long the queue manager waits before removing that node. Only non-administrative topics that are in use by a durable subscription remain after the queue manager it recycled.
The value can be in the range 0 - 604,000. A value of 0 means that non-administrative topics are not removed by the queue manager. The initial default value of the queue manager is 1800.
- Trigger interval (parameter identifier: MQIA_TRIGGER_INTERVAL).
Specifies the trigger time interval, expressed in milliseconds, for use only with queues where TriggerType has a value of MQTT_FIRST.
- The version of the IBM MQ code (parameter
identifier: MQCA_VERSION).
The version of the IBM MQ code is shown as VVRRMMFF:
VV: Version
RR: Release
MM: Maintenance level
FF: Fix level
-
Specifies whether the MQ Telemetry capability and commands are supported by the queue manager where XrCapability has a value of MQCAP_SUPPORTED or MQCAP_NOT_SUPPORTED (parameter identifier: MQIA_XR_CAPABILITY).
This parameter applies only to IBM i, UNIX, and Windows.
Parent topic: Definitions of the Programmable Command Formats
Related information
- Specify that only FIPS-certified CipherSpecs are used at run time on the MQI client
- Federal Information Processing Standards (FIPS) for UNIX, Linux and Windows