Standard-Format Queries

The queries have been organized into three groups, each containing all queries that share an argument structure.

---

1. MQM_GetProcessList

   Returns process count and a list of all processes in the application.

   Arguments:      OUT:    MQM_process_list_size
                           MQM_process_list
   

   ---

2. MQM_WaitingMsgs
   
3. MQM_IncompleteSends
   
4. MQM_WaitingSends
   
5. MQM_IncompleteRecvs
   
6. MQM_WaitingRecvs

   Returns count and list of descriptors for all messages satisfisfying the appropriate condition:

   • WaitingMsgs - messages queued to be received; applies to the destination of all send operations and send portion of combined point-to-point communication.
   • IncompleteSends - messages being sent by nonblocking operations; applies to the source of nonblocking sends, either acknowledged or unacknowledged.
   • WaitingSends - messages being sent by blocking operations; applies to the source of blocking sends, either acknowledged or unacknowledged.
   • IncompleteRecvs - messages being received by nonblocking operations; applies to the destination of nonblocking receives.
   • WaitingRecvs - messages being received by blocking operations; applies to the destination of blocking receives.

   Arguments:      IN:     MQM_process_list_size
                           MQM_process_list
                   OUT:    MQM_desc_list_size
                           MQM_desc_list
   

   The queries can be restricted to a subset of processes, by specifying their count/list in the first two arguments. Otherwise, MQM_ALL is used as the first argument to signify all processes, while a null pointer can be used for the second argument. If the OUT arguments return as MQM_NONE and MQM_NULL_LIST, respectively, no processes were found to satisfy the query.

   ---

7. MQM_BarrierArrived

   Returns number and list of processes that are currently blocked at any barrier.

   Arguments:      IN:     MQM_process_list_size
                           MQM_process_list
                   OUT:    MQM_process_list_size
                           MQM_process_list
   

   Can be restricted to a process subset as in (2)-(6).

• Pre-defined constants

  #define MQM_NONE 0
  Constant indicating that a subsequent list argument is empty

  #define MQM_ALL -1
  Wild card constant indicating "all possible elements"

  #define MQM_NULL_LIST NULL
  Null pointer for an empty list

• Processes

  char * MQM_process;
  A process id

  MQM_process * MQM_process_list;
  Array of MQM_process

  int MQM_process_list_size;
  Number of MQM_process in MQM_process_list

• User-defined message tags

  int MQM_msgtag;
  User-defined message tag

  MQM_msgtag * MQM_msgtag_list;
  Array of MQM_msgtag

  int MQM_msgtag_list_size;
  Number of MQM_msgtag in MQM_msgtag_list.

• Message Descriptor

  typedef struct {MQM_process             src,
                  MQM_process             dest,
                  MQM_msgtag              tag,
                  MQM_msg_size            size,
                 } MQM_msg_desc;
  

  Message descriptor indicating source, destination, tag, and the size of the messages. Fields can be 0 or NULL if the element doesn't apply to a particular message operation. Wild card constant can be applied to src, dest, and tag.

  MQM_msg_desc * MQM_desc_list;
  Array of MQM_msg_desc

  int MQM_desc_list_size;
  Number of MQM_msg_desc in MQM_desc_list

The update is handled by the Update Module as long as the ACTIVE_UPDATE variable in file gui/mqm_main has been set to 1 (the default value). Then, any call to the C routine MQM_ActiveUpdate (in file query_manager/main.c) will cause the Update Module to perform the display update.