Control Monitoring tab

The Control Monitoring tab lets you select the types of dynamic objects you want to monitor. The following figure shows the Control Monitoring tab.

Figure 1. Dynamic Object Tracking dialog box with Control Monitoring tab


The Control Monitoring tab contains a treeview control that displays the types of dynamic objects you can monitor, organized within object categories. The following list shows the dynamic object types you can monitor, as they appear on the Control Monitoring tab:
Table 1. Database Objects
QUERY (excluding query handles for static queries)BUFFER (excluding buffer handles for static buffers)
TEMP-TABLE (excluding table handles for static temp-tables)DATASET
DATA-SOURCE
Note: BUFFER-FIELD objects are not listed, since an application has no control over their creation or destruction.
Table 2. User Interface widgets
BROWSEBROWSE-COLUMN (excluding handles associated with static browse objects)
BUTTONCOMBO-BOX
EDITORFILL-IN
FRAMEIMAGE
MENUMENU-ITEM
RADIO-SETRECTANGLE
SELECTION-LISTSLIDER
SUB-MENUTEXT
TOGGLE-BOXWINDOW
Table 3. XML Objects
SAX-ATTRIBUTESSAX-READER
SAX-WRITERSOAP-HEADER
SOAP-HEADER-ENTRYREFX-DOCUMENT
X-NODEREF
Note: SOAP-FAULT and SOAP-FAULT-DETAIL objects are not listed, since an application has no control over their creation or destruction.
Table 4. Other Objects
ASYNC-REQUESTCALL
CONTROL-FRAMEMEMPTR (any memory allocated for a MEMPTR)
PROCEDURE (excluding handles, such as THIS-PROCEDURE, for non-persistent procedures)SERVER
SERVER-SOCKETSOCKET
Note: For more information on these dynamic object types, see ABL Reference.

To expand a category node, click the plus sign (+) next to the node. To collapse a category node, click the minus sign () next to the node.

You can select all object types within a category by selecting the check box at the category node level, whether or not the node is expanded. You can also select one or more individual object types within a category, after you expand the category node, by:

  • Selecting the category node check box, which selects all object types within that category, and clearing the check box for each object type you want to exclude
  • Clearing the category node check box, which clears all object types within that category, and selecting the check box for each object type you want to include

To begin tracking the creation and destruction of the object instances for the object types you selected, click the Start Monitoring button. Then, use the View Objects tab to monitor the active object instances. An active object instance is an instance of a dynamic object the application has created, but not yet destroyed, since you started or restarted monitoring.

QUERY (excluding query handles for static queries) BUFFER (excluding buffer handles for static buffers)
TEMP-TABLE (excluding table handles for static temp-tables) DATASET
DATA-SOURCE
Note: BUFFER-FIELD objects are not listed, since an application has no control over their creation or destruction.
  • User Interface widgets
BROWSE BROWSE-COLUMN (excluding handles associated with static browse objects)
BUTTON COMBO-BOX
EDITOR FILL-IN
FRAME IMAGE
MENU MENU-ITEM
RADIO-SET RECTANGLE
SELECTION-LIST SLIDER
SUB-MENU TEXT
TOGGLE-BOX WINDOW
Table 5. XML Objects
SAX-ATTRIBUTES SAX-READER
SAX-WRITER SOAP-HEADER
SOAP-HEADER-ENTRYREF X-DOCUMENT
X-NODEREF
Note: SOAP-FAULT and SOAP-FAULT-DETAIL objects are not listed, since an application has no control over their creation or destruction.
Table 6. Other Objects
ASYNC-REQUEST CALL
CONTROL-FRAME MEMPTR (any memory allocated for a MEMPTR)
PROCEDURE (excluding handles, such as THIS-PROCEDURE, for non-persistent procedures) SERVER
SERVER-SOCKET SOCKET
Note: For more information on these dynamic object types, see ABL Reference.

To expand a category node, click the plus sign (+) next to the node. To collapse a category node, click the minus sign () next to the node.

You can select all object types within a category by selecting the check box at the category node level, whether or not the node is expanded. You can also select one or more individual object types within a category, after you expand the category node, by:

  • Selecting the category node check box, which selects all object types within that category, and clearing the check box for each object type you want to exclude
  • Clearing the category node check box, which clears all object types within that category, and selecting the check box for each object type you want to include

To begin tracking the creation and destruction of the object instances for the object types you selected, click the Start Monitoring button. Then, use the View Objects tab to monitor the active object instances. An active object instance is an instance of a dynamic object the application has created, but not yet destroyed, since you started or restarted monitoring.