XCONS (database console) is a database tool that gives you a quick overview of the operating system resources being used by the database system, the distribution of the database sessions among the threads, and the status of the active database sessions. XCONS is called from the command line.
XCONS is a tool designed for troubleshooting and development tasks. Contact your support team before using XCONS in a production environment.
x_cons <database_name> <command> [<interval> [<repeat>]]
interval |
Time between repetition of the same command. If you do not specify an interval, the command is executed once. |
repeat |
Number of times the command is repeated. If you specify an interval but no repeat, the command is repeated an unlimited number of times. |
Displaying all tasks of the database instance HOTELDB and repeating this command 10 times at one second intervals:
x_cons HOTELDB show active 1 10
An
overview of all commands and their options:
x_cons
<database_name> help
time <enable | disable> |
Enables internal time measurement. Note that this can have a negative effect on the performance of your system. |
cancel <taskindex> |
Cancels the command that has just been executed by the task with the index taskindex |
pagecache_release |
Releases the page cache |
diagnose_pagecache |
Analyzes the page cache. The results are written to the log file knldiag. |
kill <taskindex> |
Ends the session of the task with the index taskindex |
affinity <uktindex> |
Note that this command was designed for development tasks. Do not use it in a production environment. Use this command only when asked to by the support team. This command enables the user kernel thread with the index uktindex to be bound to a processor. |
procmask <procmask> |
Note that this command was designed for development tasks. Do not use it in a production environment. Use this command only when asked to by the support team. For Microsoft Windows only: Binds user kernel threads to processors |
trace_flush |
Flushes the trace file |
show io |
Displays statistics about access to the volumes |
show aio |
For backups only: displays statistics about access to the volumes |
show storage |
Displays memory usage. On Microsoft Windows, the task stack is also displayed. |
show tasks |
Displays statistics for all tasks |
show active [dw | sv | us | gc] |
Displays statistics for the active tasks. You also have the option of only displaying the statistics of specific task groups: DW (Data Writer=Pager), SV (Server Task), US (User Task), GC (Garbage Collector). |
show runnable [dw | sv | us | gc] |
Displays information about runnable tasks; you also have the option of displaying this information for specific task groups. |
show moveinfo |
For load balancing only; history and current movement of tasks between user kernel threads |
show t_cnt [dw | sv | us | gc | <taskindex>] |
Displays detailed information about all tasks in a specific task group or about the task with the index taskindex |
show t_queue |
Displays the task queues |
show t_reg |
Displays the semaphores (usage of the critical sections by the tasks) |
show t_stat |
Displays task statistics |
show t_move |
For load balancing only; shows whether tasks are currently allowed to move from one user kernel thread to another |
show versions |
Displays the version of the database kernel and the runtime environment |
show regions |
Displays information about the critical section |
show state |
Displays the operational state of the database instance |
show rte |
Displays information about the runtime environment (such as threads) |
show queues |
Displays the queues |
show suspends |
Displays the reasons why suspended tasks have been suspended |
show sleep |
Displays statistics about how long the individual user kernel threads have been suspended |
show thrd_times |
For Microsoft Windows only: Displays how much processor time the threads have used |
show all |
Displays all available information and statistics |
See also:
· Database Manager CLI, display of information about the database instance
·
Calling XCONS in the Database Assistant of an SAP
system:
Database Administration in CCMS: MySQL
MaxDB,
Database Console
Database Administration in CCMS: SAP
liveCache,
Console