DB2 Version 9.7 for Linux, UNIX, and Windows

SNAPSHOT_QUIESCERS table function

Read syntax diagramSkip visual syntax diagram
>>-SNAPSHOT_QUIESCERS--(--dbname--,--dbpartitionnum--)---------><

The schema is SYSPROC.

The SNAPSHOT_QUIESCERS function returns information about quiescers from a table space snapshot.

Table function parameters

dbname
An input argument of type VARCHAR(255) that specifies a valid database name in the same instance as the currently connected database when calling this function. Specify a database name that has a directory entry type of either "Indirect" or "Home", as returned by the LIST DATABASE DIRECTORY command. Specify the null value to take the snapshot from the currently connected database.
dbpartitionnum
An input argument of type INTEGER that specifies a valid database partition number. Specify -1 for the current database partition, or -2 for all active database partitions. An active database partition is a partition where the database is available for connection and use by applications.

If the null value is specified, -1 is set implicitly.

Authorization

One of the following authorities is required to execute the function:
  • EXECUTE privilege on the function
  • DATAACCESS authority
To access snapshot monitor data, one of the following authorities is required:
  • SYSMON authority
  • SYSCTRL authority
  • SYSMAINT authority
  • SYSADM authority

The function returns a table as shown in the following section.

Table 1. Information returned by the SNAPSHOT_QUIESCERS table function
Column name Data type Description or corresponding monitor element
SNAPSHOT_TIMESTAMP TIMESTAMP snapshot_timestamp - Snapshot timestamp
TABLESPACE_NAME VARCHAR(128) tablespace_name - Table space name
QUIESCER_TBS_ID BIGINT quiescer_ts_id - Quiescer table space identification
QUIESCER_OBJ_ID BIGINT quiescer_obj_id - Quiescer object identification
QUIESCER_AUTH_ID BIGINT quiescer_auth_id - Quiescer user authorization identification
QUIESCER_AGENT_ID BIGINT quiescer_agent_id - Quiescer agent identification
QUIESCER_STATE BIGINT quiescer_state - Quiescer state