Displays the status of the database system monitor switches that are currently active. Monitor switches instruct the database manager to collect database activity information.
Each application using the database system monitor interface has its own set of monitor switches. A database system monitor switch is ON when any of the monitoring applications has turned it ON. This command is used to determine what data the database system monitor is currently collecting. It is possible that more data is being collected than is specified in the default monitor switches that are set in the database manager configuration because an application has a switch set to ON in its view.
This command is issued on the currently attached member and, by default, returns information only for that member. In the case of multiple members per host, the currently attached member is the first member that is listed in the db2nodes.cfg file on that host.
To issue the command for a specific member that is not the currently attached member, specify the ATTACH_MEMBER parameter. To issue the command for all members and receive an aggregated result, specify the GLOBAL parameter.
To change the currently attached member, issue the SET CLIENT command with the ATTACH_MEMBER parameter . You must issue the DETACH command followed by the ATTACH command from your application for this change to take effect.
To display the settings for a remote instance, or for a different local instance, it is necessary to first attach to that instance.
>>-GET--+-DATABASE MANAGER-+--MONITOR SWITCHES------------------> +-DB MANAGER-------+ '-DBM--------------' >--+--------------------------+-------------------------------->< +-AT MEMBER--member-number-+ '-GLOBAL-------------------'
The following is sample output from GET DATABASE MANAGER MONITOR SWITCHES:
DBM System Monitor Information Collected
Switch list for member number 1
Buffer Pool Activity Information (BUFFERPOOL) = ON 06-11-2003 10:11:01.738377
Lock Information (LOCK) = OFF
Sorting Information (SORT) = ON 06-11-2003 10:11:01.738400
SQL Statement Information (STATEMENT) = OFF
Table Activity Information (TABLE) = OFF
Take Timestamp Information (TIMESTAMP) = ON 06-11-2003 10:11:01.738525
Unit of Work Information (UOW) = ON 06-11-2003 10:11:01.738353
The recording switches BUFFERPOOL, LOCK, SORT, STATEMENT, TABLE, and UOW are OFF by default, but can be switched ON using the UPDATE MONITOR SWITCHES command. If any of these switches are ON, this command also displays the time stamp for when the switch was turned ON.
If the TIMESTAMP switch is OFF, timestamp operating system calls are not issued to determine these elements and these elements will contain zero. Turning this switch OFF becomes important as CPU utilization approaches 100%; when this occurs, the CPU time required for issuing timestamps increases dramatically.