/
oci-set-module-name.xml
141 lines (128 loc) · 3.6 KB
/
oci-set-module-name.xml
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0640e024d4b8a9400d457143ccd0ea66e5f98ead Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.oci-set-module-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_set_module_name</refname>
<refpurpose>Establece el nombre de un módulo</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>oci_set_module_name</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam><type>string</type><parameter>module_name</parameter></methodparam>
</methodsynopsis>
<para>
Establece el nombre de un módulo para el rastreo de Oracle.
</para>
<para>
El nombre del módulo se registra con la base de datos cuando ocurra el
siguiente "viaje de ida y vuelta" desde PHP a la base de datos, normalemnte cuando una
sentencia SQL es ejecutada.
</para>
<para>
El nombre del módulo puede ser consultado posteriormente desde una vista de administración
de la base de datos como <literal>V$SESSION</literal>. Se puede usar para
rastrear y monitorizar como con <literal>V$SQLAREA</literal>
y <literal>DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE</literal>.
</para>
<para>
El valor podría manterse entre conexiones persistentes.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
&oci.parameter.connection;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>module_name</parameter></term>
<listitem>
<para>
El <type>string</type> elegido por el usuario, hasta 48 bytes de longitud.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&oci.availability.note.10g;
&oci.clientinfo.tip;
&oci.roundtrip.caution;
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Establecer el nombre del módulo</title>
<programlisting role="php">
<![CDATA[
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Grabar el módulo
oci_set_module_name($c, 'Home Page');
// Código que causa un viaje de ida y vuelta, por ejemplo una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
]]>
</programlisting>
<screen>
<![CDATA[
// Mientras el script se esté ejecutando, el administrador puede ver el
// módulo en uso:
sqlplus system/welcome
SQL> select module from v$session;
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>oci_set_action</function></member>
<member><function>oci_set_client_info</function></member>
<member><function>oci_set_client_identifier</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->