1. Замечания по использованию для DISPLAY QSTATUS
2. Описание параметров для DISPLAY QSTATUS
3. Статус очереди
4. Состояние ручки

Используйте команду MQSC DISPLAY QSTATUS для отображения состояния одной или нескольких очередей.

Замечания по использованию для DISPLAY QSTATUS

Состояние асинхронных потребителей ASTATE отражает состояние прокси-сервера-подключения от имени клиентского приложения; он не отражает состояние клиентского приложения.

Описание параметров для DISPLAY QSTATUS

Вы должны указать имя очереди, для которой вы хотите отобразить информацию о состоянии. Это имя может быть конкретным именем очереди или общим именем очереди. Используя общее имя очереди, вы можете отобразить либо:

• Информация о состоянии для всех очередей или
• Информация о состоянии для одной или нескольких очередей, которые соответствуют указанному имени и другим критериям выбора

Вы также должны указать, хотите ли вы получить информацию о статусе:

• Очереди
• Дескрипторы, которые обращаются к очередям

Примечание. Команду DISPLAY QSTATUS нельзя использовать для отображения состояния очереди псевдонимов или удаленной очереди. Если вы укажете имя очереди одного из этих типов, данные не будут возвращены. Однако вы можете указать имя локальной очереди или очереди передачи, в которую разрешается очередь псевдонимов или удаленная очередь.

(generic-qname) Имя очереди, для которой должна отображаться информация о состоянии. Завершающая звездочка (*) соответствует всем очередям с указанным основанием, за которым следует ноль или более символов. Звездочка (*) сама по себе соответствует всем очередям. ГДЕ Укажите условие фильтра для отображения информации о состоянии для очередей, которые удовлетворяют критерию выбора условия фильтра. Условие фильтра состоит из трех частей: ключевое слово фильтра, оператор и значение фильтра: ключевое слово фильтра Почти любой параметр, который можно использовать для отображения атрибутов этой команды DISPLAY. Однако в качестве ключевых слов фильтра нельзя использовать параметры CMDSCOPE, MONITOR, OPENTYPE, QSGDISP, QTIME, TYPE или URID. оператор Оператор используется для определения того, удовлетворяет ли очередь значению фильтра для данного ключевого слова фильтра. Операторы: LT меньше чем GT больше чем EQ равно NE Не равно LE меньше или равно GE больше или равно LK Соответствует общей строке, которую вы указываете в качестве значения фильтра NL Не соответствует общей строке, которая Вы предоставляете в качестве значения фильтра CT Содержит указанный элемент. Если ключевое слово filter представляет собой список, вы можете использовать этот фильтр для отображения объектов, атрибуты которых содержат указанный элемент. EX не содержит указанный элемент. Если ключевое слово filter представляет собой список, вы можете использовать этот фильтр для отображения объектов, атрибуты которых не содержат указанный элемент. filter-value Значение, с которым должно быть проверено значение атрибута с использованием оператора. В зависимости от ключевого слова фильтра это значение может быть:

• Явное значение, которое является допустимым значением для проверяемого атрибута.

  Вы можете использовать только операторы LT, GT, EQ, NE, LE или GE. Однако, если значение атрибута является одним из возможного набора значений параметра (например, значение NO в параметре UNCOM), вы можете использовать только EQ или NE.

• Родовое значение. Это значение представляет собой строку символов (например, строку символов в параметре APPLTAG) со звездочкой в ​​конце, например, ABC *. Если оператор LK, все элементы, где значение атрибута начинается со строки (в примере ABC), перечислены. Если оператором является NL, перечислены все элементы, где значение атрибута не начинается со строки. Разрешен только один завершающий подстановочный знак (звездочка).

  Вы не можете использовать универсальное значение фильтра для параметров с числовыми значениями или с одним из набора значений.

• Элемент в списке значений. Оператор должен быть CT или EX. Если это символьное значение, оно может быть явным или общим. Например, если значение DEF указано с помощью оператора CT, будут перечислены все элементы, для которых одним из значений атрибута является DEF. Если указано значение ABC *, отображаются все элементы, в которых одно из значений атрибута начинается с ABC.

ALL Отображение всей информации о состоянии для каждой указанной очереди.

Это значение используется по умолчанию, если вы не задаете универсальное имя и не запрашиваете какие-либо конкретные параметры.

В z / OS это значение также является значением по умолчанию, если вы задаете условие фильтрации с помощью параметра WHERE, но на других платформах отображаются только запрошенные атрибуты.

CMDSCOPE Этот параметр указывает, как команда выполняется, когда администратор очередей является членом группы совместного использования очередей. Это действительно только для z / OS. '' Команда выполняется в администраторе очередей, в котором она была введена. Это значение по умолчанию. qmgr-name Команда выполняется в указанном администраторе очередей, при условии, что администратор очередей активен в группе совместного использования очередей.

Вы можете указать имя администратора очередей, отличное от диспетчера очереди, в котором была введена команда, только если вы используете групповую среду совместного использования очередей и если командный сервер включен.

Команда выполняется в локальном администраторе очередей, а также передается каждому активному администратору очередей в группе совместного использования очередей. Эффект этого значения аналогичен вводу команды для каждого администратора очередей в группе совместного использования очередей.

Вы не можете использовать CMDSCOPE в качестве ключевого слова фильтра.

MONITOR Укажите это значение для возврата набора параметров онлайн-мониторинга. Это LGETDATE, LGETTIME, LPUTDATE, LPUTTIME, MONQ, MSGAGE и QTIME. Если вы укажете этот параметр, любой из параметров мониторинга, который вы запрашиваете, не имеет никакого эффекта; все параметры мониторинга по-прежнему отображаются. OPENTYPE Ограничивает выбранные очереди очередями, которые имеют дескрипторы с указанным типом доступа: ВСЕ Выбирает очереди, открытые с любым типом доступа. Это значение является значением по умолчанию, если параметр OPENTYPE не указан. INPUT Выбирает очереди, которые открыты только для ввода. Эта опция не выбирает очереди, которые открыты для просмотра. ВЫХОД Выбирает очереди, которые открыты только для вывода.

Параметр OPENTYPE действителен, только если также указан TYPE (HANDLE).

Вы не можете использовать OPENTYPE в качестве ключевого слова фильтра.

TYPE Определяет тип требуемой информации о состоянии: QUEUE Отображается информация о состоянии, относящаяся к очередям. Это значение является значением по умолчанию, если параметр TYPE не указан. РУЧКА Отображается информация о состоянии, относящаяся к дескрипторам, которые обращаются к очередям.

Вы не можете использовать TYPE в качестве ключевого слова фильтра.

Статус очереди

Для состояния очереди следующая информация всегда возвращается для каждой очереди, которая удовлетворяет критериям выбора, кроме случаев, где указано: Для TYPE (QUEUE) могут быть заданы следующие параметры для запроса дополнительной информации для каждой очереди. Если указан параметр, который не относится к очереди, операционной среде или типу запрашиваемой информации о состоянии, этот параметр игнорируется. CURDEPTH Текущая глубина очереди, то есть количество сообщений в очереди, включая как подтвержденные, так и неподтвержденные сообщения. IPPROCS Количество дескрипторов, которые в данный момент открыты для ввода в очередь (совместно используемые или не входные). В это число не входят ручки, открытые для просмотра.

Для общих очередей возвращаемое число применяется только к администратору очередей, генерирующему ответ. Число не является общим для всех администраторов очередей в группе совместного использования очередей.

LGETDATE Дата, когда последнее сообщение было получено из очереди с момента запуска администратора очередей. Просматриваемое сообщение не считается полученным сообщением. Если дата получения недоступна, возможно, из-за того, что сообщение не было получено из очереди с момента запуска администратора очередей, значение отображается пустым. Для очередей с QSGDISP (SHARED) показанное значение предназначено для измерений, собранных только в этом администраторе очередей.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

LGETTIME Время, когда последнее сообщение было извлечено из очереди с момента запуска администратора очередей. Просматриваемое сообщение не считается полученным сообщением. Если время получения недоступно, возможно, из-за того, что сообщение не было получено из очереди с момента запуска администратора очередей, значение отображается пустым. Для очередей с QSGDISP (SHARED) показанное значение предназначено для измерений, собранных только в этом администраторе очередей.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

LPUTDATE Дата, когда последнее сообщение было помещено в очередь с момента запуска администратора очередей. Если дата размещения недоступна, возможно, из-за того, что с момента запуска администратора очередей в очередь не было помещено ни одного сообщения, значение отображается пустым. Для очередей с QSGDISP (SHARED) показанное значение предназначено для измерений, собранных только в этом администраторе очередей.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

LPUTTIME Время, когда последнее сообщение было помещено в очередь с момента запуска администратора очередей. Когда нет доступного времени, возможно, из-за того, что с момента запуска администратора очередей в очередь не было помещено ни одного сообщения, значение отображается пустым. Для очередей с QSGDISP (SHARED) показанное значение предназначено для измерений, собранных только в этом администраторе очередей.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

Примечание. Следует избегать перемещения системных часов назад, если LPUTTIME используется для мониторинга сообщений. LPUTTIME очереди обновляется только тогда, когда сообщение, поступающее в очередь, имеет PutTime больше, чем существующее значение LPUTTIME. Поскольку в этом случае PutTime сообщения меньше, чем существующий LPUTTIME очереди, время остается неизменным.

MEDIALOG Экстент журнала или получатель журнала, необходимый для восстановления носителя из очереди. В администраторах очередей, в которых ведется циклическое ведение журнала, MEDIALOG возвращается в виде пустой строки.

Этот параметр действителен в AIX, HP-UX, Linux, IBM i, Solaris и Windows.

MONQ Текущий уровень сбора данных мониторинга для очереди.

Этот параметр также отображается при указании параметра MONITOR.

MSGAGE Возраст самого старшего сообщения в очереди в секундах. Максимальное отображаемое значение - 999999999; если возраст превышает это значение, отображается 999999999.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

OPPROCS Это количество дескрипторов, которые в данный момент открыты для вывода в очередь.

Для общих очередей возвращаемое число применяется только к администратору очередей, генерирующему ответ. Число не является общим для всех администраторов очередей в группе совместного использования очередей.

QSGDISP Указывает расположение очереди. Отображаемое значение является одним из следующих: QMGR Объект был определен с помощью QSGDISP (QMGR). COPY Объект был определен с помощью QSGDISP (COPY). SHARED Объект был определен с помощью QSGDISP (SHARED).

Этот параметр действителен только в z / OS.

Для общих очередей, если структура CF, используемая в очереди, недоступна или не выполнена, информация о состоянии может быть ненадежной.

Вы не можете использовать QSGDISP в качестве ключевого слова фильтра.

QTIME Интервал, в микросекундах, между сообщениями, помещаемыми в очередь и затем деструктивно читаемыми. Максимальное отображаемое значение - 999999999; если интервал превышает это значение, отображается 999999999.

Интервал измеряется с момента, когда сообщение помещается в очередь, до тех пор, пока оно не будет деструктивно извлечено приложением, и, следовательно, включает в себя любой интервал, вызванный задержкой в ​​принятии приложением-отправителем.

Отображаются два значения, которые пересчитываются только при обработке сообщений:

• Значение на основе последних обработанных сообщений
• Значение, основанное на большей выборке недавно обработанных сообщений

Эти значения зависят от конфигурации и поведения вашей системы, а также от уровней активности в ней и служат индикатором нормальной работы вашей системы. Значительное изменение этих значений может указывать на проблему с вашей системой. Для очередей с QSGDISP (SHARED) значения показаны для измерений, собранных только в этом администраторе очередей.

Этот параметр также отображается при указании параметра MONITOR.

Значение отображается только для этого параметра, если для MONQ установлено значение, отличное от OFF для этой очереди.

UNCOM Указывает, есть ли какие-либо незавершенные изменения (помещает и получает), ожидающие для очереди. Отображаемое значение является одним из следующих: ДА

В z / OS имеется одно или несколько незавершенных изменений.

НЕТ Нет ожидающих изменений. n На платформах, отличных от z / OS, целочисленное значение, указывающее, сколько незавершенных изменений ожидают.

Для общих очередей возвращаемое значение применяется только к администратору очередей, генерирующему ответ. Это значение не относится ко всем администраторам очередей в группе совместного использования очередей.

Состояние ручки

Для статуса дескриптора всегда возвращается следующая информация для каждой очереди, которая удовлетворяет критериям выбора, кроме случаев, где указано:

• Имя очереди
• Тип возвращаемой информации (параметр TYPE)
• На платформах, отличных от z / OS, идентификатор пользователя (параметр USERID) - не возвращается для APPLTYPE (SYSTEM)
• На платформах, отличных от z / OS, идентификатор процесса (параметр PID)
• На платформах, отличных от z / OS, идентификатор потока (параметр TID)
• На платформах, отличных от z / OS, тег приложения (параметр APPLTAG)
• Тип приложения (параметр APPLTYPE)
• На платформах, отличных от z / OS, предоставляет ли дескриптор доступ к входу (параметр INPUT)
• На платформах, отличных от z / OS, предоставляет ли дескриптор доступ к выходу (параметр OUTPUT)
• На платформах, отличных от z / OS, предоставляет ли дескриптор доступ для просмотра (параметр BROWSE)
• На платформах, отличных от z / OS, предоставляет ли дескриптор доступ по запросу (параметр INQUIRE)
• На платформах, отличных от z / OS, предоставляет ли дескриптор установленный доступ (параметр SET)

Следующие параметры могут быть указаны для TYPE (HANDLE) для запроса дополнительной информации для каждой очереди. Если для очереди, операционной среды или типа запрашиваемой информации о состоянии указан параметр, который не имеет значения, этот параметр игнорируется. APPLDESC Строка, содержащая описание приложения, подключенного к администратору очередей, где оно известно. Если приложение не распознается администратором очередей, возвращаемое описание будет пустым. APPLTAG Строка, содержащая тег приложения, подключенного к администратору очередей. Это одно из следующего:

• Имя пакетного задания z / OS
• TSO USERID
• CICS APPLID
• Название региона IMS
• Имя задания инициатора канала
• IBM i название работы
• Процесс UNIX

  Примечание. В HP-UX, если имя процесса превышает 14 символов, отображаются только первые 14 символов. На всех других платформах, если имя процесса превышает 28 символов, отображаются только первые 28 символов.

• Процесс Windows

  Примечание. Возвращаемое значение состоит из полного пути к программе и имени исполняемого файла. Если длина превышает 28 символов, отображаются только первые 28 символов.

• Имя процесса внутреннего администратора очередей

Имя приложения представляет собой имя процесса или задания, которое подключилось к администратору очередей. В случае, если этот процесс или задание подключены через канал, имя приложения представляет удаленный процесс или задание, а не процесс или задание локального канала.

APPLTYPE Строка, указывающая тип приложения, которое подключено к администратору очередей. Это одно из следующих: Приложение BATCH, использующее пакетное соединение RRSBATCH Приложение, координируемое RRS, использующее пакетное соединение Транзакция CICS CICS IMS IMS CHINIT Инициатор канала SYSTEM Администратор очередей SYSTEMEXT Приложение, выполняющее расширение функции, предоставляемое администратором очередей USER A пользовательское приложение ASID Четырехсимвольный идентификатор адресного пространства приложения, идентифицируемый APPLTAG. Он различает повторяющиеся значения APPLTAG.

Этот параметр возвращается только в том случае, если администратор очередей, которому принадлежит очередь, работает в z / OS, а параметр APPLTYPE не имеет значения SYSTEM.

ASTATE Состояние асинхронного потребителя в этой очереди.

Возможные значения:

ACTIVE. При вызове MQCB была настроена функция обратного вызова для асинхронной обработки сообщений, и был запущен дескриптор соединения, чтобы можно было продолжить асинхронное использование сообщений. НЕАКТИВНО Вызов MQCB настроил функцию обратного вызова для обработки сообщений асинхронно, но дескриптор соединения еще не был запущен, или был остановлен или приостановлен, поэтому асинхронное использование сообщений в настоящее время не может продолжаться. SUSPENDED Асинхронный обратный вызов потребления был приостановлен, поэтому асинхронное потребление сообщений в настоящее время не может продолжаться в этой очереди. Это может быть связано либо с тем, что приложение произвело вызов MQCB с операцией MQOP_SUSPEND для этого дескриптора объекта, либо из-за того, что оно было приостановлено системой. Если оно было приостановлено системой, в рамках процесса приостановки асинхронного потребления сообщений инициируется функция обратного вызова с кодом причины, который описывает проблему, приводящую к приостановке. Этот код сообщается в поле «Причина» в структуре MQCBC, которая передается в функцию обратного вызова.

Для продолжения использования асинхронного сообщения приложение должно выполнить вызов MQCB с параметром Operation, установленным в MQOP_RESUME.

SUSPTEMP Асинхронный обратный вызов потребления был временно приостановлен системой, поэтому асинхронное потребление сообщений в настоящее время не может продолжаться в этой очереди. Как часть процесса приостановки асинхронного потребления сообщений, вызывается функция обратного вызова с кодом причины, который описывает проблему, приводящую к приостановке. Этот код сообщается в поле «Причина» в структуре MQCBC, переданной функции обратного вызова.

Функция обратного вызова инициируется снова, когда система возобновляет потребление асинхронных сообщений, когда временное условие разрешено.

NONE Для этого дескриптора не был выполнен вызов MQCB, поэтому для этого дескриптора не настроено асинхронное использование сообщений. BROWSE Указывает, предоставляет ли дескриптор доступ к очереди. Значение является одним из следующих: ДА Дескриптор обеспечивает доступ к просмотру. НЕТ Дескриптор не предоставляет доступ к просмотру. CHANNEL Название канала, которому принадлежит дескриптор. Если с дескриптором не связан ни один канал, этот параметр будет пустым.

Этот параметр возвращается, только когда дескриптор принадлежит инициатору канала.

CONNAME Имя соединения, связанное с каналом, которому принадлежит дескриптор. Если с дескриптором не связан ни один канал, этот параметр будет пустым.

Этот параметр возвращается, только когда дескриптор принадлежит инициатору канала.

HSTATE Идет ли вызов API. Возможные значения: ACTIVE Для этого объекта в данный момент выполняется вызов API из соединения. Для очереди это условие может возникнуть, когда выполняется вызов MQGET WAIT.

Если существует MQGET SIGNAL, то это значение само по себе не означает, что дескриптор активен.

INACTIVE Для этого объекта в данный момент не выполняется вызов API из соединения. Для очереди это условие может возникнуть, когда не выполняется вызов MQGET WAIT. INPUT Указывает, предоставляет ли дескриптор входной доступ к очереди. Это одно из следующих значений: SHARED Дескриптор обеспечивает доступ с общим входом. EXCL Дескриптор обеспечивает эксклюзивный доступ. НЕТ Дескриптор не обеспечивает входной доступ. INQUIRE Указывает, предоставляет ли дескриптор в настоящее время доступ к очереди. Это одно из следующих значений: ДА Дескриптор обеспечивает доступ по запросу. НЕТ Ручка не обеспечивает доступ к запросу. OUTPUT Указывает, предоставляет ли дескриптор доступ к очереди. Это одно из следующих значений: ДА Дескриптор обеспечивает доступ к выходу. НЕТ Дескриптор не обеспечивает выходной доступ. Номер PID, указывающий идентификатор процесса приложения, открывшего указанную очередь.

Этот параметр недопустим в z / OS.

PSBNAME Длинное имя из восьми символов блока спецификации программы (PSB), связанное с запущенной транзакцией IMS. Вы можете использовать PSBNAME и PSTID для очистки транзакции с помощью команд IMS. Это действительно только для z / OS.

Этот параметр возвращается только тогда, когда параметр APPLTYPE имеет значение IMS.

PSTID Четырехсимвольный идентификатор области таблицы спецификации программы IMS для подключенной области IMS. Это действительно только для z / OS.

Этот параметр возвращается только тогда, когда параметр APPLTYPE имеет значение IMS.

QMURID Блок администратора очередей идентификатора восстановления. В z / OS это значение представляет собой 8-байтовый журнал RBA, отображаемый в виде 16 шестнадцатеричных символов. На платформах, отличных от z / OS, это значение представляет собой 8-байтовый идентификатор транзакции, отображаемый как mn, где m и n - десятичное представление первых и последних 4 байтов идентификатора транзакции.

Вы можете использовать QMURID в качестве ключевого слова фильтра. В z / OS вы должны указать значение фильтра в виде шестнадцатеричной строки. На платформах, отличных от z / OS, вы должны указать значение фильтра в виде пары десятичных чисел, разделенных точкой (.). Вы можете использовать только операторы фильтров EQ, NE, GT, LT, GE или LE.

QSGDISP Указывает расположение очереди. Это действительно только для z / OS. Это одно из следующих значений : QMGR Объект был определен с помощью QSGDISP (QMGR). COPY Объект был определен с помощью QSGDISP (COPY). SHARED Объект был определен с помощью QSGDISP (SHARED).

Вы не можете использовать QSGDISP в качестве ключевого слова фильтра.

SET Указывает, предоставляет ли дескриптор установленный доступ к очереди. Это одно из следующих значений: ДА Дескриптор предоставляет доступ к набору. НЕТ Дескриптор не предоставляет установленный доступ. TASKNO Семизначный номер задачи CICS. Этот номер можно использовать в команде CICS "CEMT SET TASK (taskno) PURGE", чтобы завершить задачу CICS. Этот параметр действителен только в z / OS.

Этот параметр возвращается только тогда, когда параметр APPLTYPE имеет значение CICS.

Номер TID, указывающий идентификатор потока в процессе приложения, открывшего указанную очередь.

Этот параметр недопустим в z / OS.

Звездочка указывает, что эта очередь была открыта с использованием общего подключения.

Для получения дополнительной информации об общих подключениях см. Общие (независимые от потоков) соединения с MQCONNX ,

ТрансИД Четырехсимвольный идентификатор транзакции CICS. Этот параметр действителен только в z / OS.

Этот параметр возвращается только тогда, когда параметр APPLTYPE имеет значение CICS.

URID Внешний блок идентификатора восстановления, связанный с соединением. Это идентификатор восстановления, известный во внешнем координаторе точки синхронизации. Его формат определяется значением URTYPE.

Вы не можете использовать URID в качестве ключевого слова фильтра.

URTYPE Тип единицы восстановления, видимый администратором очередей. Это одно из следующего:

• CICS (действует только в z / OS)
• XA
• RRS (действует только в z / OS)
• IMS (действует только в z / OS)
• QMGR

URTYPE определяет тип EXTURID, а не тип координатора транзакций. Когда URTYPE - QMGR, связанный идентификатор находится в QMURID (а не URID).

USERID Идентификатор пользователя, связанный с дескриптором.

Этот параметр не возвращается, когда APPLTYPE имеет значение SYSTEM.

Похожие