Las secciones siguientes describen cada una de las opciones del mandato dxxadm que están disponibles para los programadores de sistemas:
Finalidad
Conecta y habilita una base de datos para que pueda ser utilizada con el XML Extender. Cuando se habilita la base de datos, el XML Extender crea los objetos siguientes:
Formato
enable_db |
---|
>>-dxxadm--enable_db--nombre_bd----+--------------------+-------> '--l--nomb_inic_ses--' >-----+-----------------+-------------------------------------->< '--p--contraseña--' |
Parámetros
Tabla 14. Parámetros de enable_db
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos XML. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente habilita la base de datos SALES_DB.
dxxadm enable_db SALES_DB
Finalidad
Conecta y desconecta la base de datos habilitada para XML. Cuando la base de datos está inhabilitada, ya no puede ser utilizada por el XML Extender. Cuando el XML Extender inhabilita la base de datos, elimina los objetos siguientes:
Formato
disable_db |
---|
>>-dxxadm--disable_db--nombre_bd----+--------------------+------> '--l--nomb_inic_ses--' >-----+-----------------+-------------------------------------->< '--p--contraseña--' |
Parámetros
Tabla 15. Parámetros de disable_db
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos XML. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente inhabilita la base de datos SALES_DB.
dxxadm disable_db SALES_DB
Finalidad
Conecta a una base de datos y habilita una columna XML para que pueda contener los UDT del XML Extender. Cuando habilita una columna, el XML Extender realiza estas tareas:
Formato
enable_column |
---|
>>-dxxadm--enable_column--nombre_bd--nombre_tab--nombre_col--archivo_DAD--> >----+--------------------+---+------------------------+--------> '--t--espaciotablas--' '--v--vista_predefinida--' >-----+--------------+---+--------------------+-----------------> '--r--id_raíz--' '--l--nomb_inic_ses--' >-----+-----------------+-------------------------------------->< '--p--contraseña--' |
Parámetros
Tabla 16. Parámetros de enable_column
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos XML. |
nombre_tab | Es el nombre de la tabla donde reside la columna XML. |
nombre_col | Es el nombre de la columna XML. |
archivo_DAD | Es el nombre del archivo DAD que correlaciona el documento XML con la columna XML y las tablas secundarias. |
-t espaciotablas | Es el espacio de tablas (opcional) donde residen las tablas secundarias asociadas a la columna XML. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. |
-v vista_predefinida | Es el nombre de la vista predefinida (opcional) que asocia la columna XML y las tablas secundarias. |
-r id_raíz | Es el nombre de la clave primaria, contenida en la tabla de columnas XML, que se utilizará como id_raíz para las tablas secundarias. El id_raíz es opcional. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente habilita una columna XML.
dxxadm enable_column SALES_DB SALES_TAB ORDER -v sales_order_view -r INVOICE_NUMBER
Finalidad
Conecta a una base de datos e inhabilita la columna habilitada para XML. Cuando la columna está inhabilitada, ya no puede contener tipos de datos XML. Cuando se inhabilita una columna habilitada para XML, se producen las acciones siguientes:
Importante: Debe inhabilitar una columna XML antes de eliminar una tabla XML. Si se elimina una tabla XML, pero no se inhabilita su columna XML, el XML Extender conserva las tablas secundarias que creó y también la entrada de la tabla XML_USAGE correspondiente a la columna XML.
Formato
disable_column |
---|
>>-dxxadm--disable_column--nombre_bd--nombre_tab--nombre_col----> >-----+--------------------+---+-----------------+------------->< '--l--nomb_inic_ses--' '--p--contraseña--' |
Parámetros
Tabla 17. Parámetros de disable_column
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos. |
nombre_tab | Es el nombre de la tabla donde reside la columna XML. |
nombre_col | Es el nombre de la columna XML. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente inhabilita una columna habilitada para XML.
dxxadm disable_column SALES_DB SALES_TAB ORDER
Finalidad
Conecta a una base de datos y habilita una colección XML de acuerdo con la DAD especificada. Cuando habilita una colección, el XML Extender realiza estas tareas:
Formato
enable_collection |
---|
>>-dxxadm--enable_collection---nombre_bd---nombre_colección-----> >----archivo_DAD----+--------------------+----------------------> '--t--espaciotablas--' >-----+--------------------+---+-----------------+------------->< '--l--nomb_inic_ses--' '--p--contraseña--' |
Parámetros
Tabla 18. Parámetros de enable_collection
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos. |
nombre_colección | Es el nombre de la colección XML. |
archivo_DAD | Es el nombre del archivo DAD que correlaciona el documento XML con las tablas relacionales de la colección. |
-t espaciotablas | Es el nombre del espacio de tablas (opcional) que está asociado a la colección. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente habilita una colección XML.
dxxadm enable_collection SALES_DB sales_ord getstart_xcollection.dad -t orderspace
Finalidad
Conecta a una base de datos e inhabilita la colección habilitada para XML. Cuando se inhabilita una colección XML, el nombre de la colección ya no puede utilizarse en los procedimientos almacenados de composición (dxxRetrieveXML) y descomposición (dxxInsertXML) de documentos. Se suprime la entrada de la tabla XML_USAGE correspondiente a la colección. Observe que el inhabilitar la colección no elimina las tablas de colección que se crean durante el paso enable_collection.
Formato
disable_collection |
---|
>>-dxxadm--disable_collection---nombre_bd---nombre_colección----> >-----+--------------------+---+-----------------+------------->< '--l--nomb_inic_ses--' '--p--contraseña--' |
Parámetros
Tabla 19. Parámetros de disable_collection
Parámetro | Descripción |
---|---|
nombre_bd | Es el nombre de la base de datos donde residen los datos. |
nombre_colección | Es el nombre de la colección XML. |
-l nomb_inic_ses | Es el ID usuario (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza el ID de usuario actual. |
-p contraseña | Es la contraseña (opcional) que se utiliza para conectarse a la base de datos, si se especifica. Si no se especifica este parámetro, se utiliza la contraseña actual. |
Ejemplos
El ejemplo siguiente inhabilita una colección XML.
dxxadm disable_collection SALES_DB sales_ord