1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_trace_status">
<refmeta>
<refentrytitle>trace_status</refentrytitle>
<refmiscinfo>admin</refmiscinfo>
</refmeta>
<refnamediv>
<refname>trace_status</refname>
<refpurpose>show current trace settings</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_trace_status">
<funcprototype id="fproto_trace_status">
<funcdef>void<function>trace_status</function>
</funcdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>You must have DBA privileges to run that function.</para>
<para>
This function returns an array of all available trace options and current status of the traces.
</para>
</refsect1>
<refsect1 id="examples_trace_status">
<title>Examples</title>
<example id="ex_trace_status"><title>Example</title>
<para>This is to show the current state of all trace log options.</para>
<screen>
<![CDATA[
SQl> create procedure trace_status_show ()
{
declare i, l integer;
declare opt, status varchar;
declare arr any;
arr := trace_status();
i := 0; l := length (arr);
result_names (opt, status);
while (i < l)
{
result (arr[i], arr[i+1]);
i := i + 2;
}
};
SQL> trace_status_show();
opt status
VARCHAR VARCHAR
_______________________________________________________________________________
user_log off
failed_log off
compile on
ddl_log off
client_sql off
errors off
dsn off
sql_send off
transact on
remote_transact off
exec off
soap off
]]>
</screen>
</example>
</refsect1>
<refsect1 id="seealso_trace_status"><title>See Also</title>
<para><link linkend="fn_trace_on"><function>trace_on()</function></link></para>
<para><link linkend="fn_trace_off"><function>trace_off()</function></link></para>
</refsect1>
</refentry>
|