Inquire Channel Initiator (Response) on z/OS
The response to the Inquire Channel Initiator (MQCMD_INQUIRE_CHANNEL_INIT) command consists of one response with a series of attribute parameter structures showing the status of the channel initiator (shown by the ChannelInitiatorStatus parameter), and one response for each listener (shown by the ListenerStatus parameter).
- Always returned (one message with channel initiator information):
- ActiveChannels, ActiveChannelsMax, ActiveChannelsPaused, ActiveChannelsRetrying, ActiveChannelsStarted, ActiveChannelsStopped, AdaptersMax, AdaptersStarted, ChannelInitiatorStatus, CurrentChannels, CurrentChannelsLU62, CurrentChannelsMax, CurrentChannelsTCP, DispatchersMax, DispatchersStarted, SSLTasksStarted, TCPName
- Always returned (one message for each listener ):
- InboundDisposition, ListenerStatus, TransportType
- Returned if applicable for the listener:
- IPAddress, LUName, Port
Response data - channel initiator information
- ActiveChannels (MQCFIN)
- The number of active channel connections (parameter identifier: MQIACH_ACTIVE_CHL).
- ActiveChannelsMax (MQCFIN)
- The requested number of active channel connections (parameter identifier: MQIACH_ACTIVE_CHL_MAX).
- ActiveChannelsPaused (MQCFIN)
- The number of active channel connections that have paused, waiting to become active, because the limit for active channels has been reached (parameter identifier: MQIACH_ACTIVE_CHL_PAUSED).
- ActiveChannelsRetrying (MQCFIN)
- The number of active channel connections that are attempting to reconnect following a temporary error (parameter identifier: MQIACH_ACTIVE_CHL_RETRY).
- ActiveChannelsStarted (MQCFIN)
- The number of active channel connections that have started (parameter identifier: MQIACH_ACTIVE_CHL_STARTED).
- ActiveChannelsStopped (MQCFIN)
- The number of active channel connections that have stopped, requiring manual intervention (parameter identifier: MQIACH_ACTIVE_CHL_STOPPED).
- AdaptersMax (MQCFIN)
- The requested number of adapter subtasks (parameter identifier: MQIACH_ADAPS_MAX).
- AdaptersStarted (MQCFIN)
- The number of active adapter subtasks (parameter identifier: MQIACH_ADAPS_STARTED).
- ChannelInitiatorStatus (MQCFIN)
- Status of the channel initiator (parameter identifier: MQIACF_CHINIT_STATUS).
The value can be:
- MQSVC_STATUS_STOPPED
- The channel initiator is not running.
- MQSVC_STATUS_RUNNING
- The channel initiator is fully initialized and is running.
- CurrentChannels (MQCFIN)
- The number of current channel connections (parameter identifier: MQIACH_CURRENT_CHL).
- CurrentChannelsLU62 (MQCFIN)
- The number of current LU 6.2 channel connections (parameter identifier: MQIACH_CURRENT_CHL_LU62).
- CurrentChannelsMax (MQCFIN)
- The requested number of channel connections (parameter identifier: MQIACH_CURRENT_CHL_MAX).
- CurrentChannelsTCP (MQCFIN)
- The number of current TCP/IP channel connections (parameter identifier: MQIACH_CURRENT_CHL_TCP).
- DispatchersMax (MQCFIN)
- The requested number of dispatchers (parameter identifier: MQIACH_DISPS_MAX).
- DispatchersStarted (MQCFIN)
- The number of active dispatchers (parameter identifier: MQIACH_DISPS_STARTED).
- SSLTasksMax (MQCFIN)
- The requested number of TLS server subtasks (parameter identifier: MQIACH_SSLTASKS_MAX).
- SSLTasksStarted (MQCFIN)
- The number of active TLS server subtasks (parameter identifier: MQIACH_SSLTASKS_STARTED).
- TCPName (MQCFST)
- TCP system name (parameter identifier: MQCACH_TCP_NAME).
The maximum length is MQ_TCP_NAME_LENGTH.
Response data - listener information
- InboundDisposition (MQCFIN)
- Inbound transmission disposition (parameter identifier: MQIACH_INBOUND_DISP).
Specifies the disposition of the inbound transmissions that the listener handles. The value can
be any of the following values:
- MQINBD_Q_MGR
- Handling for transmissions directed to the queue manager. MQINBD_Q_MGR is the default.
- MQINBD_GROUP
- Handling for transmissions directed to the queue sharing group. MQINBD_GROUP is permitted only if there is a shared queue manager environment.
- IPAddress (MQCFST)
- IP address on which the listener listens (parameter identifier: MQCACH_IP_ADDRESS).
- ListenerStatus (MQCFIN)
- Listener status (parameter identifier: MQIACH_LISTENER_STATUS).
The value can be:
- MQSVC_STATUS_RUNNING
- The listener has started.
- MQSVC_STATUS_STOPPED
- The listener has stopped.
- MQSVC_STATUS_RETRYING
- The listener is trying again.
- LUName (MQCFST)
- LU name on which the listener listens (parameter identifier: MQCACH_LU_NAME).
The maximum length is MQ_LU_NAME_LENGTH.
- Port (MQCFIN)
- Port number on which the listener listens (parameter identifier: MQIACH_PORT_NUMBER).
- TransportType (MQCFIN)
- Transmission protocol type that the listener is using (parameter identifier:
MQIACH_XMIT_PROTOCOL_TYPE).
The value can be:
- MQXPT_LU62
- LU62.
- MQXPT_TCP
- TCP.
Parent topic: Definitions of the Programmable Command Formats