The following sections describe how you can call up XCON directly in the command line. However, we recommend not calling XCONS directly in the command line but always via the Database Manager CLI or CCMS. In this way, you avoid problems with access rights to Unix/Linux, amongst other things.
See:
Database Manager CLI, show
○ Database Administration in CCMS, Database Console (only in SAP systems)
x_cons <database_name> <command> [<interval> [<repeat>]]
<command> |
XCONS command |
<interval> |
Time between repetitions 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. |
affinity <uktindex> |
Note that this command was designed for development tasks and for this reason should not be used in production operation. Only use this command if requested to do so by Support. This command allows the user kernel thread with the index uktindex to be bound to one processor. |
cancel <taskindex> |
Cancels the command that has just been executed by the task with the index <taskindex> |
diagnose_pagecache |
Analyzes the page cache. The results are written to the core log file (see Concepts of the Database System, Log Files). |
kill <taskindex> |
Ends the session of the task with the index <taskindex> |
pagecache_release |
Releases the page cache |
procmask <procmask> |
Note that this command was designed for development tasks and for this reason should not be used in production operation. Only use this command if requested to do so by Support. For Microsoft Windows only. User kernel threads are permanently bound to individual processors. |
show active [dw | sv | us | gc] |
Shows statistics for active tasks. You can also show the statistics for specific task groups only: DW (data writer=pager), SV (server task), US (user task), GC (garbage collector). |
show aio |
Only for backups; shows volume access statistics |
show all |
Shows all available information and statistics |
show io |
Shows volume access statistics |
show moveinfo |
Only for load balancing; shows history and how tasks are currently moving between user kernel threads |
show queues |
Shows queues |
show regions |
Shows information about the critical regions |
show rte |
Shows information about the runtime environment (threads, and so on) |
show runnable [dw | sv | us | gc] |
Shows information about runnable tasks; can also be used for specific task groups only |
show sleep |
Shows statistics that indicate how long the individual user kernel threads were suspended |
show state |
Displaying the operational state of the database instance In addition to the operational states, intermediate statuses are also displayed here. These are short-term statuses occupied by the database instance when moving between two operational states such as: STARTING, SHUTDOWN, SHUTDOWNREINIT, SHUTDOWNKILL, STOP, KILL, ABORT, UNKNOWN |
show storage |
Shows the memory utilization. On Microsoft Windows, the task stack is also displayed. |
show suspends |
Shows the reasons why tasks that are currently suspended have been suspended |
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_move |
Only for load balancing; indicates whether tasks can currently be moved from one user kernel thread to another |
show t_queue |
Shows task queues |
show t_reg |
Shows semaphores (use of critical regions by the tasks) |
show t_stat |
Shows task statistics |
show tasks |
Shows statistics for all tasks |
show thrd_times |
For Microsoft Windows only. Shows how much processor time the threads have used |
show tstack |
UNIX/Linux only: Overview of the current task stack consumption and the location of the task stack in the virtual address space of the kernel process. |
show versions |
Shows the version of the database kernel and the runtime environment |
time <enable | disable> |
Activates the internal time measurement function. Note that this can have a negative effect on the performance of your system. |
trace_flush |
Flushes the trace file |
In Microsoft Windows, show all active tasks of database instance DEMODB and repeat the command 10 times at intervals of 1 second.
x_cons DEMODB show active 1 10
Display help for all XCONS commands:
x_cons DEMODB help
See also:
Concepts of the Database System, Overview of Tasks