Entering content frame

 XCONS (Database Console) 

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.

Syntax

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

Commands

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

 

Leaving content frame