Home

 

Current-only status

 

The following information applies only to current channel instances. The information applies to all channel types, except where stated.

BATCHES

Number of completed batches during this session (since the channel was started).
BATCHSZ

The batch size being used for this session (valid only on AIX, HP OpenVMS, HP-UX, Linux, i5/OS, Solaris, Windows, and z/OS).

This parameter does not apply to server-connection channels, and no values are returned; if specified on the command, this is ignored.

BUFSRCVD

Number of transmission buffers received. This includes transmissions to receive control information only.
BUFSSENT

Number of transmission buffers sent. This includes transmissions to send control information only.
BYTSRCVD

Number of bytes received during this session (since the channel was started). This includes control information received by the message channel agent.
BYTSSENT

Number of bytes sent during this session (since the channel was started). This includes control information sent by the message channel agent.
CHSTADA

Date when this channel was started (in the form yyyy-mm-dd).
CHSTATI

Time when this channel was started (in the form hh.mm.ss).

COMPHDR

The technique used to compress the header data sent by the channel. Two values are displayed:

COMPMSG

The technique used to compress the message data sent by the channel. Two values are displayed:

  • The default message data compression value negotiated for this channel.

  • The message data compression value used for the last message sent. The message data compression value can be altered in a sending channels message exit. If no message has been sent, the second value is blank.

COMPRATE

The compression rate achieved displayed to the nearest percentage. Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING. If monitoring data is not being collected, or if no messages have been sent by the channel, the values are shown as blank.

A value is only displayed for this parameter if MONCHL is set for this channel.

COMPTIME

The amount of time per message, displayed in microseconds, spent during compression or decompression. Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING. If monitoring data is not being collected, or if no messages have been sent by the channel, the values are shown as blank.

A value is only displayed for this parameter if MONCHL is set for this channel.

EXITTIME

Amount of time, displayed in microseconds, spent processing user exits per message. Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values may indicate a problem with your system. They are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING.

This parameter is also displayed when you specify the MONITOR parameter.

A value is only displayed for this parameter if MONCHL is set for this channel.

HBINT

The heartbeat interval being used for this session.
JOBNAME

Name of job currently serving the channel.

  • On HP OpenVMS, this is the process identifier, displayed in hexadecimal.

  • On i5/OS, UNIX systems, and Windows, this is the concatenation of the process identifier and the thread identifier of the MCA program, displayed in hexadecimal.

  • On Compaq NSK, this is the CPU ID and PID, displayed in hexadecimal.

This information is not available on z/OS. The parameter is ignored if specified.

You cannot use JOBNAME as a filter keyword on z/OS.

KAINT

The keepalive interval being used for this session. This is valid only on z/OS.

LOCLADDR

Local communications address for the channel. The value returned depends on the TRPRYPE of the channel (currently only TCP/IP is supported).
LONGRTS

Number of long retry wait start attempts left. This applies only to sender or server channels.
LSTMSGDA

Date when the last message was sent or MQI call was handled, see LSTMSGTI.
LSTMSGTI

Time when the last message was sent or MQI call was handled.

For a sender or server, this is the time the last message (the last part of it if it was split) was sent. For a requester or receiver, it is the time the last message was put to its target queue. For a server-connection channel, it is the time when the last MQI call completed.

MAXMSGL

The maximum message length being used for this session (valid only on z/OS).
MCASTAT

Whether the Message Channel Agent is currently running. This is either "running" or "not running".

Note that it is possible for a channel to be in stopped state, but for the program still to be running.

This information is not available on z/OS. The parameter is ignored if specified.

We cannot use MCASTAT as a filter keyword on z/OS.

MCAUSER

The user ID used by the MCA. This can be the user ID set in the channel definition, the default user ID for MCA channels, a user ID transferred from a client if this is a server-connection channel, or a user ID specified by a security exit.

This parameter applies only to server-connection, receiver, requester, and cluster-receiver channels.

The maximum length is 12 characters on z/OS; on other platforms, it is 64 characters.

MONCHL

Current level of monitoring data collection for the channel.

This parameter is also displayed when you specify the MONITOR parameter.

MSGS

Number of messages sent or received (or, for server-connection channels, the number of MQI calls handled) during this session (since the channel was started).

NETTIME

Amount of time, displayed in microseconds, to send a request to the remote end of the channel and receive a response. Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values may indicate a problem with your system. They are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING.

This parameter applies only to sender, server, and cluster-sender channels.

This parameter is also displayed when you specify the MONITOR parameter.

A value is only displayed for this parameter if MONCHL is set for this channel.

NPMSPEED

The nonpersistent message handling technique being used for this session.

RAPPLTAG

The remote partner application name. This is the name of the client application at the remote end of the channel. This parameter applies only to server-connection channels.

RQMNAME

The queue manager name, or queue-sharing group name, of the remote system. This parameter does not apply to server-connection channels.
SHORTRTS

Number of short retry wait start attempts left. This applies only to sender or server channels.

SSLCERTI

The full Distinguished Name of the issuer of the remote certificate. The issuer is the Certificate Authority that issued the certificate.

The maximum length is 256 characters. This limit might mean that exceptionally long Distinguished Names are truncated.

SSLCERTU

The local user ID associated with the remote certificate. This is valid on z/OS only.

SSLKEYDA

Date on which the previous successful SSL secret key reset was issued.

SSLKEYTI

Time at which the previous successful SSL secret key reset was issued.

SSLPEER

Distinguished Name of the peer queue manager or client at the other end of the channel.

The maximum length is 256 characters. This limit might mean that exceptionally long Distinguished Names are truncated.

SSLRKEYS

Number of successful SSL key resets. The count of SSL secret key resets is reset when the channel instance ends.
STOPREQ

Whether a user stop request is outstanding. This is either YES or NO.

SUBSTATE

Action being performed by the channel when this command is issued. The following substates are listed in precedence order, starting with the substate of the highest precedence:

ENDBATCH

Channel is performing end-of-batch processing.

SEND

A request has been made to the underlying communication subsystem to send some data.

RECEIVE

A request has been made to the underlying communication subsystem to receive some data.

SERIALIZE

Channel is serializing its access to the queue manager. This is valid on z/OS only.

RESYNCH

Channel is resynchronizing with the partner.

HEARTBEAT

Channel is heartbeating with the partner.

SCYEXIT

Channel is running the security exit.

RCVEXIT

Channel is running one of the receive exits.

SENDEXIT

Channel is running one of the send exits.

MSGEXIT

Channel is running one of the message exits.

MREXIT

Channel is running the message retry exit.

CHADEXIT

Channel is running through the channel auto-definition exit.

NETCONNECT

A request has been made to the underlying communication subsystem to connect a partner machine.

SSLHANDSHK

Channel is processing an SSL handshake.

NAMESERVER

A request has been made to the name server.

MQPUT

A request has been made to the queue manager to put a message on the destination queue.

MQGET

A request has been made to the queue manager to get a message from the transmission queue (if this is an MCA channel) or from an application queue (if this is an MQI channel).

MQICALL

A MQ API call, other than MQPUT and MQGET, is being executed.

COMPRESS

Channel is compressing or decompressing data.
Not all substates are valid for all channel types or channel states. There are occasions when no substate is valid, at which times a blank value is returned.

For channels running on multiple threads, this parameter displays the substate of the highest precedence.

XBATCHSZ

Size of the batches transmitted over the channel. Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values may indicate a problem with your system. They are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING.

This parameter does not apply to server-connection channels.

This parameter is also displayed when you specify the MONITOR parameter.

A value is only displayed for this parameter if MONCHL is set for this channel.

XQMSGSA

Number of messages queued on the transmission queue available to the channel for MQGETs.

This parameter has a maximum displayable value of 999. If the number of messages available exceeds 999, a value of 999 is displayed.

On z/OS, if the transmission queue is not indexed by CorrelId, this value is shown as blank.

This parameter applies to cluster-sender channels only.

This parameter is also displayed when you specify the MONITOR parameter.

A value is only displayed for this parameter if MONCHL is set for this channel.

XQTIME

The time, in microseconds, that messages remained on the transmission queue before being retrieved. The time is measured from when the message is put onto the transmission queue until it is retrieved to be sent on the channel and, therefore, includes any interval caused by a delay in the putting application.

Two values are displayed:

  • A value based on recent activity over a short period of time.

  • A value based on activity over a longer period of time.

These values depend on the configuration and behavior of your system, as well as the levels of activity within it, and serve as an indicator that your system is performing normally. A significant variation in these values may indicate a problem with your system. They are reset every time the channel is started and are displayed only when the STATUS of the channel is RUNNING.

This parameter applies only to sender, server, and cluster-sender channels.

This parameter is also displayed when you specify the MONITOR parameter.

A value is only displayed for this parameter if MONCHL is set for this channel.

 

Parent topic:

Parameter descriptions


sc11860_


 

Home