Query SQL Database Monitor (QQQQSDBM) API


  Required Parameter Group:

1 Qualified job name Input Char(26)
2 Number of active monitors Output Binary(4)
3 Size of active monitors array Input Binary(4)
4 Type of active monitors array Output Array(*) of Char(10)
5 Memory handle Output Char(10)
6 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes


The Query SQL Database Monitor (QQQSSDBM) API returns information about the activity of the SQL and the original database monitor. Associated APIs include the following:


Authorities and Locks

None


Required Parameter Group

Qualified job name
INPUT; CHAR(26)

The job for which status is being requested. The qualified job name has three parts:


Job name CHAR(10). A specific job name, a generic name, or one of the following special values:


* or *CURRENT Only the job that this program is running in. The rest of the qualified job name parameter must be blank.
*ALL All jobs. The rest of the job name parameter must be blank.

User name CHAR(10). A specific user profile name.
Job number CHAR(6). A specific job number.

Number of active monitors
OUTPUT; BINARY(4)

The number of active database monitors. If the number of active monitors is greater than the size of the type of active monitors array allocated by the user, the type of active monitors array is truncated to the size allocated by the user.

Size of active monitors array
INPUT; BINARY(4)

The amount of storage (number of character(10) array entries) allocated by the caller for the type of active monitors array parameter.

Type of active monitors array
OUTPUT; Array(*) of CHAR(10)

The types of database monitors that are active. The values may include:

*FILE The file-based database monitor (STRDBMON) is active
*SQLMEMORY The SQL memory-based database monitor (QQQSSDBM) is active.

Memory handle
OUTPUT; CHAR(10)

The memory handle used for the specified job if the memory-based monitor is active. Only the first 6 characters will be used for naming the memory handle.

This field is blank if the SQL memory-based database monitor is not active.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.


Error Messages

Message ID Error Message Text
CPF0172 E Parameters passed on CALL do not match those required.
CPF1321 E job &1 user &2 job number &3 not found.
CPF3CF1 E Error code parameter not valid.
CPF436E E Job &1 user &2 job number &3 is not active.


API introduced: V4R3
Top | Database and File APIs | APIs by category