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.
HP Integrity NonStop Server | UNIX and Linux® | Windows |
---|---|---|
Always returned:
QMgrName
Returned if requested:
-
AccountingConnOverride
,AccountingInterval
,ActivityConnOverride
,ActivityRecording
,ActivityTrace
,AdoptNewMCACheck
,AdoptNewMCAType
,AlterationDate
,AlterationTime
,AuthorityEvent
,BridgeEvent
,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
,CreationDate
,CreationTime
,Custom
,DeadLetterQName
,DefClusterXmitQueueType
,DefXmitQName
,DistLists
,DNSGroup
,DNSWLM
,EncryptionPolicySuiteB
,ExpiryInterval
,GroupUR
,IGQPutAuthority
,IGQUserId
,InhibitEvent
,IntraGroupQueuing
,IPAddressVersion
,ListenerTimer
,LocalEvent
,LoggerEvent
,LUGroupName
,LUName
,LU62ARMSuffix
,LU62Channels
,MaxChannels
,MaxActiveChanels
,MaxHandles
,MaxMsgLength
,MaxPriority
,MaxPropertiesLength
,MaxUncommittedMsgs
,MQIAccounting
,MQIStatistics
OutboundPortMax
,OutboundPortMin
,Parent
,PerformanceEvent
,Platform
,PubSubClus
,PubSubMaxMsgRetryCount
,PubSubMode
,QmgrDesc
,QMgrIdentifier
,QSGName
,QueueAccounting
,QueueMonitoring
,QueueStatistics
,ReceiveTimeout
,ReceiveTimeoutMin
,ReceiveTimeoutType
,RemoteEvent
,RepositoryName
,RepositoryNamelist
,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
andMQIAccounting
queue manager parameters (parameter identifier:MQIA_ACCOUNTING_CONN_OVERRIDE
).The value can be:MQMON_DISABLED
- Applications cannot override the settings of the
QueueAccounting
andMQIAccounting
parameters. MQMON_ENABLED
- Applications can override the settings of the
QueueAccounting
andMQIAccounting
parameters by using the options field of the MQCNO structure of the MQCONNX API call.
This parameter applies only to AIX®, HP-UX, IBM® i, Linux, Solaris, 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 AIX, HP-UX, IBM i, Linux, Solaris, 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: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.
This parameter applies only to IBM i, Unix systems, 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 WebSphere 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 WebSphere MQ MQI application activity trace.
This parameter applies only to IBM i, Unix systems, 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.
- 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. - 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.
- Specifies which SSL/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 only valid on UNIX, Linux, and Windows. For more information, see Certificate validation policies in WebSphere MQ.
The value can be: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 theChannelMonitoring
channel attribute is set to
, this attribute specifies the value which is assumed by the channel. The value can be:MQMON_Q_MGR
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_NONE
- Statistics data collection is turned off for channels regardless
of the setting of their
ChannelStatistics
parameter. MQMON_NONE is the initial default value of the queue manager. MQMON_OFF
- Statistics data collection is turned off for channels specifying
a value of
MQMON_Q_MGR
in theirChannelStatistics
parameter. MQMON_LOW
- Statistics data collection is turned on, with a low ratio of data
collection, for channels specifying a value of
MQMON_Q_MGR
in theirChannelStatistics
parameter. MQMON_MEDIUM
- Statistics data collection is turned on, with a moderate ratio
of data collection, for channels specifying a value of
MQMON_Q_MGR
in theirChannelStatistics
parameter. MQMON_HIGH
- Statistics data collection is turned on, with a high ratio of
data collection, for channels specifying a value of
MQMON_Q_MGR
in theirChannelStatistics
parameter.
This parameter applies only to AIX, HP-UX, IBM i, Linux, Solaris, and Windows.
- Number of adapter subtasks (parameter identifier:
MQIA_CHINIT_ADAPTERS
).The number of adapter subtasks to use for processing WebSphere® 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.
- Setting 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
- Monitoring for the channel is switched off.
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.
- 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 switched off.
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.
This parameter applies only to AIX, HP-UX, IBM i, Linux, Solaris, and Windows.
- 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: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 HP-UX V5.0
- MQSeries for Solaris 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 HP-UX V5.1
- MQSeries for Compaq Tru64 UNIX, V5.1
- IBM WebSphere MQ for HP Integrity NonStop Server v5.3
- MQSeries for Solaris V5.1
- 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 HP-UX V5.2
- MQSeries for Linux V5.2
- MQSeries for Solaris 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 HP-UX, V5.3
- IBM WebSphere MQ for Linux, V5.3
- IBM WebSphere MQ for Sun Solaris, Version 5.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.
The set of system control commands that corresponds to a particular value of the
CommandLevel
attribute varies. It varies according to the value of thePlatform
attribute; both must be used to decide which system control commands are supported. - 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.
- 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 and 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 areMQCLXQ_SCTQ
orMQCLXQ_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
).The name of the group that the TCP listener handling inbound transmissions for the queue-sharing group joins. It must join this group when using Workload Manager for Dynamic Domain Name Services support (DDNS).
This parameter is valid only on z/OS.
- Controls whether the TCP listener that handles inbound transmissions
for the queue-sharing group must register with Workload Manager (WLM)
for DDNS: (parameter identifier:
MQIA_DNS_WLM
).The value can be:MQDNSWLM_YES
- The listener must register with WLM.
MQDNSWLM_NO
- The listener is not to register with WLM. MQDNSWLM_NO is the initial default value of 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 SSL and TLS channels, see NSA Suite B Cryptography in IBM WebSphere 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 QSG 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: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. - 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 WebSphere 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 AIX, HP-UX, IBM i, Linux, Solaris, 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
- 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 AIX, HP-UX, IBM i, Linux, Solaris, 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 AIX, HP-UX, IBM i, Linux, Solaris, 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_NSK
- HP Integrity NonStop Server.
MQPL_OS400
- IBM i.
MQPL_UNIX
- UNIX systems.
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 WebSphere 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 WebSphere Message Broker V6 or earlier versions of WebSphere Message Broker that use this queue manager. WebSphere Message Broker reads the same queues from which the queued publish/subscribe interface normally reads. 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
. - 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 theQueueAccounting
parameter. MQMON_ON
- Accounting data collection is enabled for queues specifying a
value of
MQMON_Q_MGR
in theQueueAccounting
parameter.
- Default setting for online monitoring for queues (parameter identifier:
MQIA_MONITORING_Q
).If theQueueMonitoring
queue attribute is set toMQMON_Q_MGR
, this attribute specifies the value which is assumed by the channel. The value can be: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 theirQueueStatistics
parameter. MQMON_ON
- Statistics data collection is turned on for queues specifying
a value of
MQMON_Q_MGR
in theirQueueStatistics
parameter.
- 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 ofHeartbeatInterval
to determine how long a channel waits. MQRCVTIME_ADD
ReceiveTimeout
is a value, in seconds, to be added to the negotiated value ofHeartbeatInterval
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.
- 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 theObjectQmgrName
is used or whether the processing queue manager opens the shared queue directly.The value can be: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.
- If the WebSphere MQ AMS component is installed for the version
of WebSphere MQ that the queue manager is running under, the attribute
has a value YES
(MQCAP_SUPPORTED)
. If the WebSphere MQ AMS component is not installed, the value is NO(MQCAP_NOT_SUPPORTED)
(parameter identifier:MQIA_PROT_POLICY_CAPABILITY
).The value can be one of the following values:MQCAP_SUPPORTED
- If the WebSphere MQ AMS component is installed for the version of WebSphere MQ that the queue manager is running under.
MQCAP_NOT_SUPPORTED
- If the WebSphere MQ AMS component is not installed.
- The SSL 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.
- Parameters to configure the SSL 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 supported on AIX, HP-UX, Solaris, Linux, and Windows only.
- Controls whether SSL 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 WebSphere MQ
itself (parameter identifier:
MQIA_SSL_FIPS_REQUIRED
). This parameter is valid only on Windows Linux UNIX and z/OS platforms.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 WebSphere MQ rather than cryptographic hardware.
- Location and name of the SSL 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.
- SSL key reset count (parameter identifier:
MQIA_SSL_RESET_COUNT
).The number of unencrypted bytes that initiating SSL channel MCAs send or receive before renegotiating the secret key.
- Number of server subtasks used for processing SSL calls (parameter
identifier:
MQIA_SSL_TASKS
).The number of server subtasks used for processing SSL 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 AIX, HP-UX, Linux, IBM i, Solaris, and Windows.
- 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 you 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 ofMQTT_FIRST
. - The version of the IBM WebSphere MQ code (parameter
identifier:
MQCA_VERSION
).The version of the IBM WebSphere MQ code is shown as
VVRRMMFF
:VV
: VersionRR
: ReleaseMM
: Maintenance levelFF
: Fix level -
Specifies whether the IBM WebSphere MQ Telemetry capability and commands are supported by the queue manager where
XrCapability
has a value ofMQCAP_SUPPORTED
orMQCAP_NOT_SUPPORTED
(parameter identifier:MQIA_XR_CAPABILITY
).This parameter applies only to IBM i, Unix systems, and Windows.