IBM Books

Administración y programación


Opciones del mandato de administración

Las secciones siguientes describen cada una de las opciones del mandato dxxadm que están disponibles para los programadores de sistemas:

enable_db

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

disable_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:

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.

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 

enable_column

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

disable_column

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

enable_collection

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

disable_collection

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


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