IBM Books

Administración y programación


Procedimientos almacenados de administración

Estos procedimientos almacenados se utilizan para tareas administrativas, tales como habilitar o inhabilitar una columna o colección XML. Se invocan mediante el asistente de administración del XML Extender y el mandato de administración dxxadm.

dxxEnableDB()

Finalidad

Habilita la base de datos. Cuando se habilita la base de datos, el XML Extender crea los objetos siguientes:

dxxEnableDB(char(UDB_SIZE)  nombreBd,    /* entrada */
            long           códigoRetorno,    /* salida */
            varchar(1024)  mensRetorno)      /* salida */

Parámetros

Tabla 40. Parámetros de dxxEnableDB()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA

dxxDisableDB()

Finalidad

Inhabilita la base de datos. Cuando el XML Extender inhabilita la base de datos, elimina los objetos siguientes:

Importante: Debe inhabilitar todas las columnas XML antes de intentar inhabilitar una base de datos. El XML Extender no puede inhabilitar una base de datos que contenga columnas o colecciones habilitadas para XML.

dxxDisableDB(char(UDB_SIZE)     nombreBd,     /* entrada */
             long           códigoRetorno,    /* salida */
             varchar(1024)  mensRetorno)      /* salida */

Parámetros

Tabla 41. Parámetros de dxxDisableDB()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA

dxxEnableColumn()

Finalidad

Habilita una columna XML. Cuando habilita una columna, el XML Extender realiza estas tareas:

dxxEnableColumn(char(UDB_SIZE) nombreBd,        /* entrada */
                char(UDB_SIZE) nombreTb,        /* entrada */
                char(UDB_SIZE) nombreCol,       /* entrada */
                CLOB(100K)     DAD,             /* entrada */
                char(UDB_SIZE) espaciotablas,   /* entrada */
                char(UDB_SIZE) vistaPredefinida,/* entrada */
                char(UDB_SIZE) ID_raíz,         /* entrada */
                long           códigoRetorno,   /* salida */
                varchar(1024)  mensRetorno)     /* salida */

Parámetros

Tabla 42. Parámetros de dxxEnableColumn()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
nombreTb Es el nombre de la tabla donde reside la columna XML. ENTRADA
nombreCol Es el nombre de la columna XML. ENTRADA
DAD Es un CLOB donde reside el archivo DAD. ENTRADA
espaciotablas Es el espacio de tablas, distinto del espacio de tablas predefinido, que contiene las tablas secundarias. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. ENTRADA
vistaPredefinida Es el nombre de la vista predefinida que asocia la tabla de aplicación y las tablas secundarias. ENTRADA
ID_raíz Es el nombre de la clave primaria, contenida en la tabla de aplicación, que se utilizará como id_raíz para la tabla secundaria. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA

dxxDisableColumn()

Finalidad

Inhabilita la columna habilitada para XML. Cuando la columna XML está inhabilitada, ya no puede contener tipos de datos XML.

dxxDisableColumn(char(UDB_SIZE) nombreBd,        /* entrada */
                 char(UDB_SIZE) nombreTb,        /* entrada */
                 char(UDB_SIZE) nombreCol,       /* entrada */
                      long                    códigoRetorno,   /* salida */
                      varchar(1024)           mensRetorno)     /* salida */

Parámetros

Tabla 43. Parámetros de dxxDisableColumn()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
nombreTb Es el nombre de la tabla donde reside la columna XML. ENTRADA
nombreCol Es el nombre de la columna XML. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA

dxxEnableCollection()

Finalidad

Habilita una colección XML que está asociada a una tabla de aplicación.

dxxEnableCollection(char(UDB_SIZE) nombreBd,   /* entrada */
                 char(UDB_SIZE) nombreCol,   /* entrada */
                    CLOB(100K)     DAD,         /* entrada */
                    char(UDB_SIZE) espaciotablas,  /* entrada */
             long           códigoRetorno,    /* salida */
             varchar(1024)  mensRetorno)      /* salida */

Parámetros

Tabla 44. Parámetros de dxxEnableCollection()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
nombreCol Es el nombre de la colección XML. ENTRADA
DAD Es un CLOB donde reside el archivo DAD. ENTRADA
espaciotablas Es el espacio de tablas, distinto del espacio de tablas predefinido, que contiene las tablas secundarias. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA

dxxDisableCollection()

Finalidad

Inhabilita una colección habilitada para XML, eliminando los marcadores que identifican tablas y columnas como integrantes de una colección.

dxxDisableCollection(char(UDB_SIZE) nombreBd     /* entrada */
                     char(UDB_SIZE) nombreCol,    /* entrada */
             long           códigoRetorno,    /* salida */
             varchar(1024)  mensRetorno)      /* salida */

Parámetros

Tabla 45. Parámetros de dxxDisableCollection()
Parámetro Descripción Parámetro de E/S
nombreBd Es el nombre de la base de datos. ENTRADA
nombreCol Es el nombre de la colección XML. ENTRADA
códigoRetorno Es el código de retorno que emite el procedimiento almacenado. SALIDA
mensRetorno Es el texto del mensaje que se devuelve en caso de error. SALIDA


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]