Queue status - Middleware News
For queue status, the following information is always returned for each queue that satisfies the selection criteria, except where indicated:
Queue name
Type of information returned (TYPE parameter)
On platforms other than z/OS®, current queue depth (CURDEPTH parameter)
On z/OS only, the queue-sharing group disposition (QSGDISP parameter)
The following parameters can be specified for TYPE(QUEUE) to request additional information for each queue. If a parameter is specified that is not relevant for the queue, operating environment, or type of status information requested, that parameter is ignored.
CURDEPTH
The current depth of the queue, that is, the number of messages on the queue. This includes both committed messages and uncommitted messages.
IPPROCS
The number of handles that are currently open for input for the queue (either input-shared or input-exclusive). This does not include handles that are open for browse.
For shared queues, the number returned applies only to the queue manager generating the reply. The number is not the total for all the queue managers in the queue-sharing group.
LGETDATE
The date on which the last message was retrieved from the queue since the queue manager started. A message being browsed does not count as a message being retrieved. When no get date is available, perhaps because no message has been retrieved from the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LGETTIME
The time at which the last message was retrieved from the queue since the queue manager started. A message being browsed does not count as a message being retrieved. When no get time is available, perhaps because no message has been retrieved from the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LPUTDATE
The date on which the last message was put to the queue since the queue manager started. When no put date is available, perhaps because no message has been put to the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LPUTTIME
The time at which the last message was put to the queue since the queue manager started. When no put time is available, perhaps because no message has been put to the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
MEDIALOG
The log extent or journal receiver needed for media recovery of the queue. On queue managers on which circular logging is in place, MEDIALOG is returned as a null string.
This is valid on AIX®, HP-UX, Linux, i5/OS®, Solaris, and Windows.
MONQ
Current level of monitoring data collection for the queue.
This parameter is also displayed when you specify the MONITOR parameter.
MSGAGE
Age, in seconds, of the oldest message on the queue. The maximum displayable value is 999 999 999; if the age exceeds this value, 999 999 999 is displayed.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
OPPROCS
This is the number of handles that are currently open for output for the queue.
For shared queues, the number returned applies only to the queue manager generating the reply. The number is not the total for all the queue managers in the queue-sharing group.
QSGDISP
Indicates the disposition of the queue. The value displayed is one of the following:
QMGR
The object was defined with QSGDISP(QMGR).
COPY
The object was defined with QSGDISP(COPY).
SHARED
The object was defined with QSGDISP(SHARED).
This parameter is valid on z/OS only.
For shared queues, if the CF structure used by the queue is unavailable or has failed, the status information might be unreliable.
You cannot use QSGDISP as a filter keyword.
QTIME
Interval, in microseconds, between messages being put on the queue and then being destructively read. The maximum displayable value is 999 999 999; if the interval exceeds this value, 999 999 999 is displayed.
The interval is measured from the time that the message is placed on the queue until it is retrieved by an application and, therefore, includes any interval caused by a delay in committing by 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. For queues with QSGDISP(SHARED), the values shown are for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
UNCOM
Indicates whether there are any uncommitted changes (puts and gets) pending for the queue. The value displayed is one of the following:
YES
On z/OS, there are one or more uncommitted changes pending.
NO
There are no uncommitted changes pending.
n
On platforms other than z/OS, an integer value indicating how many uncommitted changes are pending.
For shared queues, the value returned applies only to the queue manager generating the reply. The value does not apply to all the queue managers in the queue-sharing group.
For queue status, the following information is always returned for each queue that satisfies the selection criteria, except where indicated:
Queue name
Type of information returned (TYPE parameter)
On platforms other than z/OS®, current queue depth (CURDEPTH parameter)
On z/OS only, the queue-sharing group disposition (QSGDISP parameter)
The following parameters can be specified for TYPE(QUEUE) to request additional information for each queue. If a parameter is specified that is not relevant for the queue, operating environment, or type of status information requested, that parameter is ignored.
CURDEPTH
The current depth of the queue, that is, the number of messages on the queue. This includes both committed messages and uncommitted messages.
IPPROCS
The number of handles that are currently open for input for the queue (either input-shared or input-exclusive). This does not include handles that are open for browse.
For shared queues, the number returned applies only to the queue manager generating the reply. The number is not the total for all the queue managers in the queue-sharing group.
LGETDATE
The date on which the last message was retrieved from the queue since the queue manager started. A message being browsed does not count as a message being retrieved. When no get date is available, perhaps because no message has been retrieved from the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LGETTIME
The time at which the last message was retrieved from the queue since the queue manager started. A message being browsed does not count as a message being retrieved. When no get time is available, perhaps because no message has been retrieved from the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LPUTDATE
The date on which the last message was put to the queue since the queue manager started. When no put date is available, perhaps because no message has been put to the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
LPUTTIME
The time at which the last message was put to the queue since the queue manager started. When no put time is available, perhaps because no message has been put to the queue since the queue manager was started, the value is shown as a blank. For queues with QSGDISP(SHARED), the value shown is for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
MEDIALOG
The log extent or journal receiver needed for media recovery of the queue. On queue managers on which circular logging is in place, MEDIALOG is returned as a null string.
This is valid on AIX®, HP-UX, Linux, i5/OS®, Solaris, and Windows.
MONQ
Current level of monitoring data collection for the queue.
This parameter is also displayed when you specify the MONITOR parameter.
MSGAGE
Age, in seconds, of the oldest message on the queue. The maximum displayable value is 999 999 999; if the age exceeds this value, 999 999 999 is displayed.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
OPPROCS
This is the number of handles that are currently open for output for the queue.
For shared queues, the number returned applies only to the queue manager generating the reply. The number is not the total for all the queue managers in the queue-sharing group.
QSGDISP
Indicates the disposition of the queue. The value displayed is one of the following:
QMGR
The object was defined with QSGDISP(QMGR).
COPY
The object was defined with QSGDISP(COPY).
SHARED
The object was defined with QSGDISP(SHARED).
This parameter is valid on z/OS only.
For shared queues, if the CF structure used by the queue is unavailable or has failed, the status information might be unreliable.
You cannot use QSGDISP as a filter keyword.
QTIME
Interval, in microseconds, between messages being put on the queue and then being destructively read. The maximum displayable value is 999 999 999; if the interval exceeds this value, 999 999 999 is displayed.
The interval is measured from the time that the message is placed on the queue until it is retrieved by an application and, therefore, includes any interval caused by a delay in committing by 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. For queues with QSGDISP(SHARED), the values shown are for measurements collected on this queue manager only.
This parameter is also displayed when you specify the MONITOR parameter.
A value is only displayed for this parameter if MONQ is set to a value other than OFF for this queue.
UNCOM
Indicates whether there are any uncommitted changes (puts and gets) pending for the queue. The value displayed is one of the following:
YES
On z/OS, there are one or more uncommitted changes pending.
NO
There are no uncommitted changes pending.
n
On platforms other than z/OS, an integer value indicating how many uncommitted changes are pending.
For shared queues, the value returned applies only to the queue manager generating the reply. The value does not apply to all the queue managers in the queue-sharing group.
Comments
Post a Comment