QUERY function description

The QUERY function determines the ages of the messages on different destinations queues and produces a data report.

You can run the QUERY functions through the IMS Queue Control Facility ISPF panels, as batch JCL job streams, and there are some special IMS Queue Control Facility server commands that you can run through the z/OS® MODIFY command.

The QUERY function examines the IMS message queues for the age of messages on various destination queues that you specified. The QUERY function lists all message queues that have messages on them, and the age of the oldest and newest message.

The QUERY function produces reports of the data that it processes. The QUERY function differs from the BROWSE function in that the QUERY function cannot produce an output data set containing the messages that satisfy the request. The output QUERY data set contains only summary information about the destinations.

You can use the QUERY function to display the top nn destinations (any number up to 99) that have the most messages on the messages queue.

These destinations can be listed as a user-defined message queue utilization percentage when overflow protection starts user-defined procedures to browse or unload queues, or both browse and unload queues.

You must generate control cards for the QUERY function with the new parameter in the default card members. Panels have been changed to allow generation of the new parameter.

The destinations can be listed at any time without waiting to reach a defined percentage level. A user-defined procedure must be started to process the QUERY function with the new parameter.

The QUERY function selects information about a message's age from the message queues for purely informational purposes. The QUERY function performs the following tasks:

  1. Determines queue selection from the QUEUETYPE= keyword of the FUNCTION statement
  2. Determines message age selection criteria for message destinations from the AGE= keyword of the FUNCTION statement.
  3. Discards or ignores records that fail to meet the selection criteria of the FUNCTION, INCLUDE, and EXCLUDE statements
  4. Produces reports on the number of destination queues the QUERY function queried from the message queues
  5. Returns control to IMS Queue Control Facility control processing logic

The job steps that are required for the QUERY function are: QUERY