DB 2 N 0 Z 80

IBM DB2 Universal Database
Consulta de mandatos
V ersin 8
SC10-3725-00
IBM DB2 Universal Database
Consulta de mandatos
V ersin 8
SC10-3725-00
Antes de utilizar esta informacin y el producto al que da soporte, asegrese de leer la informacin general incluida en el apartado Avisos.
Este manual es la traduccin del original ingls IBM DB2 Universal Database Command Reference Version 8 (SC09-4828-00). Este documento contiene informacin sobre productos patentados de IBM. Se proporciona segn un acuerdo de licencia y est protegido por la ley de la propiedad intelectual. La presente publicacin no incluye garantas del producto y las declaraciones que contiene no deben interpretarse como tales. Puede realizar pedidos de publicaciones en lnea o a travs del representante de IBM de su localidad. v Para realizar pedidos de publicaciones en lnea, vaya a IBM Publications Center en www.ibm.com/shop/publications/order v Para encontrar el representante de IBM correspondiente a su localidad, vaya a IBM Directory of Worldwide Contacts en www.ibm.com/planetwide Para realizar pedidos de publicaciones en mrketing y ventas de DB2 de los EE.UU. o de Canad, llame al nmero 1-800-IBM-4YOU (426-4968). Cuando enva informacin a IBM, otorga a IBM un derecho no exclusivo para utilizar o distribuir dicha informacin en la forma en que IBM considere adecuada, sin contraer por ello ninguna obligacin con el remitente. Copyright International Business Machines Corporation 1993-2002. Reservados todos los derechos.
Contenido
Acerca de este manual . . . . . Quin debe utilizar este manual . . Cmo est estructurado este manual. . . . . . . . vii . vii . vii Mandato db2dart - Herramienta de informes y anlisis de base de datos . . . . . . . 48 db2dclgn -Mandato Generador de declaraciones. . . . . . . . . . . . 53 Mandato db2drdat - Rastreo DRDA . . . . 56 db2empfa -Mandato Habilitar la asignacin de archivos de mltiples pginas . . . . . 58 db2eva -Mandato Analizador de sucesos . . 59 db2evmon -Mandato Herramienta de productividad del supervisor de sucesos . . 61 db2evtbl -Mandato Generar definiciones de tabla de destino del supervisor de sucesos . . 63 db2exfmt -Mandato Herramienta de formato de tabla de explicacin . . . . . . . . 65 db2expln -Mandato Herramienta de explicacin SQL de DB2 . . . . . . . . 66 db2flsn - Mandato Buscar nmero de secuencia de anotacin cronolgica . . . . 67 db2fm - Mandato Supervisor de anomalas de DB2 . . . . . . . . . . . . . . . 69 db2gncol -Mandato Actualizar valores de columna generados . . . . . . . . . 72 db2gov -Mandato Rutina de gobierno de DB2 74 db2govlg -Mandato Consulta de anotacin cronolgica de rutina de gobierno de DB2 . . 76 db2hc -Mandato Iniciar el Centro de salud . . 78 Mandato db2iclus - Servidor de clsteres de Microsoft . . . . . . . . . . . . . 79 db2icrt -Mandato Crear instancia . . . . . 83 db2idrop -Mandato Eliminar instancia . . . 86 db2ilist -Mandato Listar instancias . . . . 87 db2imigr -Mandato Migrar instancia . . . . 88 db2inidb - Mandato Inicializar una base de datos duplicada . . . . . . . . . . . 90 db2inspf -Mandato Formatear resultados de inspeccin. . . . . . . . . . . . . 92 db2isetup -Mandato Iniciar interfaz de creacin de instancias . . . . . . . . . 93 db2iupdt -Mandato Actualizar instancias . . 95 db2ldcfg -Mandato Configurar entorno de LDAP . . . . . . . . . . . . . . 97 db2level -Mandato Mostrar nivel de servicio de DB2. . . . . . . . . . . . . . 99 db2licm -Mandato Herramienta de gestin de licencias . . . . . . . . . . . . 100
Captulo 1. Mandatos del sistema . . . . 1 Cmo estn organizadas las descripciones de los mandatos . . . . . . . . . . . . 1 Mandato dasauto - Servidor de administracin DB2 Autostart . . . . . . . . . . . . 3 dascrt -Mandato Crear un servidor de administracin DB2 . . . . . . . . . . 4 dasdrop - Mandato Eliminar un Servidor de administracin DB2 . . . . . . . . . . 5 dasmigr -Mandato Migrar el Servidor de administracin DB2 . . . . . . . . . . 6 db2admin -Mandato Servidor de administracin DB2 . . . . . . . . . . 7 db2adutl - Mandato Trabajar con imgenes TSM archivadas . . . . . . . . . . . 9 db2advis -Mandato Asesor de ndices DB2 . . 14 db2audit -Mandato Herramienta de administrador del recurso de comprobacin . 18 db2atld -Mandato Cargador automtico . . . 19 db2batch -Mandato Herramienta de banco de pruebas . . . . . . . . . . . . . 20 db2bfd -Mandato Herramienta de descripcin de archivo de vinculacin . . . . . . . 27 db2cap -Mandato Herramienta de vinculacin de paquetes estticos CLI/ODBC . . . . . 28 db2cc -Mandato Iniciar el Centro de control 30 db2cfexp -Mandato Herramienta de exportacin de configuracin de conectividad . 32 db2cfimp -Mandato Herramienta de importacin de configuracin de conectividad 34 db2cidmg -Mandato Migracin de base de datos remota . . . . . . . . . . . . 35 db2ckbkp - Mandato Comprobar copia de seguridad . . . . . . . . . . . . . 37 db2ckmig -Mandato Herramienta de premigracin de base de datos . . . . . . 41 db2ckrst - Mandato Comprobar secuencia de imgenes de restauracin incremental . . . 42 db2cli -Mandato CLI interactiva de DB2. . . 45 db2cmd -Mandato Abrir ventana de mandato DB2 . . . . . . . . . . . . . . . 46
Copyright IBM Corp. 1993-2002
iii
Mandato db2logsforrfwd - Listar registros necesarios para recuperacin en avance . . db2look -Mandato Herramienta de extraccin de DDL y de estadsticas de DB2 . db2move - Mandato Herramienta de movimiento de base de datos . . . . . . db2mscs - Mandato Configurar programa de utilidad Failover de Windows . . . . . . db2mtrk -Mandato Rastreador de memoria db2nchg -Mandato Cambiar configuracin de servidor de particiones de base de datos . db2ncrt -Mandato Aadir servidor de particiones de base de datos a una instancia . db2ndrop -Mandato Eliminar servidor de particiones de base de datos de una instancia . . . . . . . . . . . . . db2osconf - Mandato Programa de utilidad para los valores de parmetro de kernel . . db2perfc -Mandato Restablecer valores de rendimiento de base de datos . . . . . . db2perfi -Mandato Programa de utilidad de registro de contadores de rendimiento . . . db2perfr -Mandato Herramienta de registro de supervisor de rendimiento . . . . . . db2profc -Mandato Personalizador de perfiles SQLj de DB2 . . . . . . . . . db2profp -Mandato Impresora de perfiles SQLj de DB2 . . . . . . . . . . . db2rbind -Mandato Volver a vincular todos los paquetes . . . . . . . . . . . db2_recon_aid -Mandato RECONCILE en mltiples tablas . . . . . . . . . . db2relocatedb - Mandato Reubicar base de datos . . . . . . . . . . . . . . db2sampl -Mandato Crear base de datos de ejemplo . . . . . . . . . . . . . db2set -Mandato Registro de perfiles de DB2 db2setup -Mandato Instalar DB2 . . . . . db2sql92 -Mandato Procesador de sentencias de SQL conforme con SQL92 . . . . . . db2start -Mandato Iniciar DB2 . . . . . db2stop -Mandato Detener DB2 . . . . . db2support -Mandato Herramienta de anlisis de problemas y recoleccin del entorno . . . . . . . . . . . . . db2sync -Mandato Iniciar el sincronizador de DB2 . . . . . . . . . . . . . db2tbst -Mandato Obtener estado de espacio de tabla . . . . . . . . . . . . . db2trc -Mandato Rastrear . . . . . . .
102 103 110 116 121 124 126
db2undgp -Mandato Revocar privilegio de ejecucin. . . . . . . . . . . . . 173 db2uiddl -Mandato Preparar conversin de ndices exclusivos a semntica de V5 . . . 174 db2untag -Mandato Liberar identificador de contenedor . . . . . . . . . . . . 176 Captulo 2. Procesador de lnea de mandatos (CLP) . . . . . . . . . Opciones del procesador de lnea de mandatos . . . . . . . . . . . Cdigos de retorno del procesador de lnea de mandatos . . . . . . . . . . Utilizacin del procesador de lnea de mandatos . . . . . . . . . . . Utilizacin del procesador de lnea de mandatos en archivos de mandatos . . Diseo del procesador de lnea de mandatos . . . . . . . . . . Notas sobre el uso del CLP . . . .
. 179 . 181 . 189 . 190 . 191 . 191 . 194
129 131 135 137 138 140 142 144 146 150 151 153 157 159 163 164
165 168 169 170
Captulo 3. Mandatos de CLP . . . . . 197 Mandato ACTIVATE DATABASE . . . . 197 Mandato ADD CONTACT . . . . . . . 200 Mandato ADD CONTACTGROUP . . . . 202 Mandato ADD DATALINKS MANAGER 203 Mandato ADD DBPARTITIONNUM . . . 205 Mandato ARCHIVE LOG . . . . . . . 208 Mandato ATTACH . . . . . . . . . 211 Mandato AUTOCONFIGURE . . . . . . 213 Mandato BACKUP DATABASE . . . . . 216 Mandato BIND . . . . . . . . . . 222 Mandato CATALOG APPC NODE . . . . 244 Mandato CATALOG APPN NODE . . . . 247 Mandato CATALOG DATABASE . . . . 250 Mandato CATALOG DCS DATABASE . . . 255 Mandato CATALOG LDAP DATABASE . . 258 Mandato CATALOG LDAP NODE . . . . 262 Mandato CATALOG LOCAL NODE . . . 264 Mandato CATALOG NAMED PIPE NODE 267 Mandato CATALOG NETBIOS NODE . . . 270 Mandato CATALOG ODBC DATA SOURCE 273 Mandato CATALOG TCP/IP NODE . . . 274 Mandato CHANGE DATABASE COMMENT 278 Mandato CHANGE ISOLATION LEVEL . . 280 Mandato CREATE DATABASE . . . . . 283 Mandato CREATE TOOLS CATALOG . . . 295 Mandato DEACTIVATE DATABASE . . . 298 Mandato DEREGISTER . . . . . . . . 300 Mandato DESCRIBE . . . . . . . . . 302
iv
Command Reference
Mandato DETACH . . . . . . . . . Mandato DROP CONTACT . . . . . . Mandato DROP CONTACTGROUP . . . . Mandato DROP DATABASE . . . . . . Mandato DROP DATALINKS MANAGER Mandato DROP DBPARTITIONNUM VERIFY . . . . . . . . . . . . . Mandato DROP TOOLS CATALOG . . . . Mandato ECHO . . . . . . . . . . Mandato EXPORT . . . . . . . . . Restricciones de los delimitadores . . . Mandato FORCE APPLICATION . . . . Mandato GET ADMIN CONFIGURATION Mandato GET ALERT CONFIGURATION Mandato GET AUTHORIZATIONS . . . . Mandato GET CLI CONFIGURATION . . . Mandato GET CONNECTION STATE . . . Mandato GET CONTACTGROUP . . . . Mandato GET CONTACTGROUPS . . . . Mandato GET CONTACTS. . . . . . . Mandato GET DATABASE CONFIGURATION . . . . . . . . . Mandato GET DATABASE MANAGER CONFIGURATION . . . . . . . . . Mandato GET DATABASE MANAGER MONITOR SWITCHES . . . . . . . . Mandato GET DESCRIPTION FOR HEALTH INDICATOR . . . . . . . . . . . Mandato GET HEALTH NOTIFICATION CONTACT LIST . . . . . . . . . . Mandato GET HEALTH SNAPSHOT . . . Mandato GET INSTANCE . . . . . . . Mandato GET MONITOR SWITCHES . . . Mandato GET RECOMMENDATIONS . . . Mandato GET ROUTINE . . . . . . . Mandato GET SNAPSHOT. . . . . . . Mandato HELP . . . . . . . . . . Mandato IMPORT . . . . . . . . . Mandato INITIALIZE TAPE . . . . . . Mandato INSPECT . . . . . . . . . Mandato LIST ACTIVE DATABASES . . . Mandato LIST APPLICATIONS . . . . . Mandato LIST COMMAND OPTIONS . . . Mandato LIST DATABASE DIRECTORY . . Mandato LIST DATABASE PARTITION GROUPS. . . . . . . . . . . . . Mandato LIST DATALINKS MANAGERS Mandato LIST DBPARTITIONNUMS . . . Mandato LIST DCS APPLICATIONS . . . Mandato LIST DCS DIRECTORY . . . .
306 307 308 309 312 317 319 321 322 330 333 335 337 340 342 345 346 347 348 349 354 358 361 363 364 366 367 370 372 374 396 398 425 427 433 435 438 440 444 447 448 449 453
Mandato LIST DRDA INDOUBT TRANSACTIONS . . . . . . . . . . Mandato LIST HISTORY . . . . . . . Mandato LIST INDOUBT TRANSACTIONS Mandato LIST NODE DIRECTORY . . . . Mandato LIST ODBC DATA SOURCES . . Mandato LIST PACKAGES/TABLES . . . Mandato LIST TABLESPACE CONTAINERS Mandato LIST TABLESPACES . . . . . Mandato LOAD . . . . . . . . . . Mandato LOAD QUERY . . . . . . . Mandato MIGRATE DATABASE . . . . . Mandato PING . . . . . . . . . . Mandato PRECOMPILE. . . . . . . . Mandato PRUNE HISTORY/LOGFILE . . . Mandato PUT ROUTINE . . . . . . . Mandato QUERY CLIENT . . . . . . . Mandato QUIESCE . . . . . . . . . Mandato QUIESCE TABLESPACES FOR TABLE . . . . . . . . . . . . . Mandato QUIT. . . . . . . . . . . Mandato REBIND. . . . . . . . . . Mandato RECONCILE . . . . . . . . Mandato REDISTRIBUTE DATABASE PARTITION GROUP . . . . . . . . . Mandato REFRESH LDAP . . . . . . . Mandato REGISTER . . . . . . . . . Mandato REORG INDEXES/TABLE . . . Mandato REORGCHK . . . . . . . . Mandato RESET ADMIN CONFIGURATION Mandato RESET ALERT CONFIGURATION Mandato RESET DATABASE CONFIGURATION . . . . . . . . . Mandato RESET DATABASE MANAGER CONFIGURATION . . . . . . . . . Mandato RESET MONITOR . . . . . . Mandato RESTART DATABASE . . . . . Mandato RESTORE DATABASE . . . . . Mandato REWIND TAPE . . . . . . . Mandato ROLLFORWARD DATABASE . . Mandato RUNSTATS. . . . . . . . . Mandato SET CLIENT . . . . . . . . Mandato SET RUNTIME DEGREE . . . . Mandato SET TABLESPACE CONTAINERS Mandato SET TAPE POSITION . . . . . Mandato SET WRITE . . . . . . . . Mandato START DATABASE MANAGER Mandato STOP DATABASE MANAGER . . Mandato TERMINATE . . . . . . . . Mandato UNCATALOG DATABASE . . .
455 457 460 465 468 470 473 475 481 529 533 535 537 568 570 572 573 576 580 581 585 591 596 598 603 612 623 625 627 629 631 633 636 646 647 659 669 673 675 678 679 681 687 691 692
Contenido
Mandato UNCATALOG DCS DATABASE Mandato UNCATALOG LDAP DATABASE Mandato UNCATALOG LDAP NODE . . Mandato UNCATALOG NODE . . . . Mandato UNCATALOG ODBC DATA SOURCE . . . . . . . . . . . . Mandato UNQUIESCE . . . . . . . Mandato UPDATE ADMIN CONFIGURATION . . . . . . . . Mandato UPDATE ALERT CONFIGURATION . . . . . . . . Mandato UPDATE CLI CONFIGURATION Mandato UPDATE COMMAND OPTIONS Mandato UPDATE CONTACT . . . . Mandato UPDATE CONTACTGROUP . . Mandato UPDATE DATABASE CONFIGURATION . . . . . . . . Mandato UPDATE DATABASE MANAGER CONFIGURATION . . . . . . . . Mandato UPDATE HEALTH NOTIFICATION CONTACT LIST . . . Mandato UPDATE HISTORY FILE . . . Mandato UPDATE LDAP NODE. . . . Mandato UPDATE MONITOR SWITCHES Captulo 4. Utilizacin de sentencias de SQL de la lnea de mandatos . . . .
694 696 . 698 . 699 . 701 . 702 . 704 . 707 712 714 . 716 . 717 . 718 . 721 . 724 . 725 . 727 730
. 733
Apndice A. Lectura de los diagramas de sintaxis . . . . . . . . . . . . . 743 Apndice B. Convenios de denominacin 747 Apndice C. Informacin tcnica sobre DB2 Universal Database . . . . . . Visin general de la informacin tcnica de DB2 Universal Database . . . . . . FixPaks para la documentacin de DB2 Categoras de la informacin tcnica de DB2 . . . . . . . . . . . . Impresin de manuales de DB2 desde archivos PDF . . . . . . . . . .
Solicitud de manuales de DB2 impresos . . Acceso a la ayuda en lnea . . . . . . . Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador . . . . . . . . . . . . Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin . . . . . . . . . . . Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2 . . . . . . . . . . . Actualizacin de la documentacin HTML instalada en la mquina. . . . . . . . Copia de archivos desde el CD de documentacin HTML de DB2 en un servidor Web . . . . . . . . . . . Resolucin de problemas de bsqueda de documentacin de DB2 con Netscape 4.x . . Bsqueda en la documentacin de DB2 . . Informacin en lnea de resolucin de problemas de DB2 . . . . . . . . . Accesibilidad . . . . . . . . . . . Entrada de teclado y navegacin . . . . Pantalla accesible . . . . . . . . . Seales de alerta alternativas . . . . . Compatibilidad con tecnologas de asistencia . . . . . . . . . . . Documentacin accesible . . . . . . Guas de aprendizaje de DB2 . . . . . . Acceso al Centro de informacin de DB2 desde un navegador . . . . . . . . .
758 759
761
763
765 766
767 768 769 770 771 771 772 772 772 772 772 773
. 749 . 749 749 . 749
Apndice D. Avisos . . . . . . . . 775 Marcas registradas . . . . . . . . . 778 Apndice E. Cmo ponerse en contacto con IBM. . . . . . . . . . . . . 781 Informacin sobre productos . . . . . . 781 ndice . . . . . . . . . . . . . 783
. 757
vi
Command Reference
Acerca de este manual

Este manual proporciona informacin acerca del uso de mandatos del sistema y del procesador de la lnea de mandatos (CLP) IBM DB2 Universal Database para ejecutar funciones administrativas de base de datos.
Quin debe utilizar este manual

Se supone que el lector tiene conocimientos de administracin de bases de datos y conoce el Lenguaje de Consulta Estructurada (SQL).
Cmo est estructurado este manual

Este manual proporciona la informacin de consulta necesaria para utilizar el CLP. Se incluyen los temas siguientes: Captulo 1 Describe los mandatos que se pueden entrar en un indicador de mandatos de sistema operativo o en un script de shell para acceder al gestor de bases de datos. Captulo 2 Explica cmo invocar y utilizar el procesador de lnea de mandatos y describe las opciones del CLP. Captulo 3 Proporciona una descripcin de todos los mandatos del gestor de bases de datos. Captulo 4 Proporciona informacin sobre cmo utilizar las sentencias de SQL desde la lnea de mandatos. Apndice A Explica los convenios utilizados en los diagramas de sintaxis. Apndice B Explica los convenios utilizados para denominar bases de datos y tablas.
vii
viii
Command Reference
Captulo 1. Mandatos del sistema

Esta seccin proporciona informacin acerca de los mandatos que se pueden entrar en un indicador de mandatos de sistema operativo o en un script de shell para acceder al gestor de bases de datos y mantenerlo. Notas: 1. Las barras inclinadas (/) que aparecen en las vas de acceso de directorio son especficas de los sistemas basados en UNIX y son equivalentes a las barras inclinadas invertidas (\) en las vas de acceso de directorio en los sistemas operativos Windows. 2. Normalmente, el trmino Windows hace referencia a todas las versiones soportadas de Microsoft Windows. Las versiones soportadas incluyen las basadas en Windows NT y las basadas en Windows 9x. Pueden producirse referencias especficas a sistemas operativos basados en Windows NT cuando la funcin en cuestin est soportada en Windows NT 4, Windows 2000, Windows .NET y Windows XP, pero no en Windows 9x. Si hay una funcin especfica de una versin de Windows en particular, se notar la versin o versiones vlida(s) del sistema operativo.
Cmo estn organizadas las descripciones de los mandatos

Una breve descripcin de cada mandato precede a algunas o a la totalidad de las subsecciones siguientes. mbito: mbito de operacin del mandato dentro de la instancia. En un sistema de una sola particin de base de datos, el mbito es el de una sola particin de base de datos nicamente. En un sistema de varias particiones de base de datos, es la coleccin de todas las particiones lgicas de base de datos definidas en el archivo de configuracin de particiones de base de datos, db2nodes.cfg. Autorizacin: Autorizacin necesaria para invocar el mandato satisfactoriamente. Conexin necesaria: Una de las siguientes: base de datos, instancia, ninguna o establece una conexin. Indica si la funcin necesita una conexin de base de datos, una conexin de instancia o ninguna conexin para operar satisfactoriamente.
Mandatos del sistema

Puede que sea necesaria una conexin explcita a la base de datos o una conexin a la instancia antes de poder emitir un mandato determinado. Los mandatos que necesitan una conexin de base de datos o una conexin de instancia pueden ejecutarse de forma local o remota. Aquellos que no necesitan ninguna de las dos no pueden ejecutarse de forma remota; cuando se emiten en el cliente, slo afectan al entorno del cliente. Sintaxis del mandato: Un diagrama de sintaxis muestra cmo se debe especificar un mandato para que el sistema operativo pueda interpretar correctamente lo que se escribe. Para obtener ms informacin sobre los diagramas de sintaxis, consulte el Apndice A, Lectura de los diagramas de sintaxis en la pgina 743. Parmetros del mandato: Descripcin de los parmetros disponibles para el mandato. Notas de uso: Informacin adicional. Informacin relacionada: Referencia cruzada a informacin relacionada.
Command Reference
dasauto - Servidor de administracin DB2 Mandato dasauto - Servidor de administracin DB2 Autostart
Habilita o inhabilita la iniciacin automtica del Servidor de administracin DB2. Este mandato slo est disponible en los sistemas basados en UNIX. Est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX, y /opt/IBM/db2/V8.1 en Linux, y /opt/IBM/db2/V8.1 en todos los dems sistemas basados en UNIX. Autorizacin: dasadm Conexin necesaria: Ninguna Sintaxis del mandato:
dasauto -h -? -on -off
Parmetros del mandato: -h/-? Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Habilita la iniciacin automtica del Servidor de administracin DB2. El prxima vez que el sistema se reinicie, el Servidor de administrador DB2 se iniciar automticamente. Inhabilita la iniciacin automtica del Servidor de administracin DB2. El prxima vez que el sistema se reinicie, el Servidor de administrador DB2 no se iniciar automticamente.
-on
-off
dascrt - Crear un Servidor de administracin DB2 dascrt -Mandato Crear un servidor de administracin DB2
El Servidor de administracin DB2 (DAS) proporciona servicios de soporte para las herramientas de DB2, tales como el Centro de control y el Asistente de configuracin. Si un sistema carece de DAS, puede utilizarse este mandato para generarlo manualmente. Este mandato slo est disponible en los sistemas basados en UNIX. En los sistemas Windows, puede utilizar el mandato db2admin create con la misma finalidad. Autorizacin: Autorizacin raz. Conexin necesaria: Ninguna. Sintaxis del mandato:
dascrt -u usuarioDAS
Parmetros del mandato: -u usuarioDAS usuarioDAS es el nombre de usuario con el que inicio la sesin cuando cre el Servidor de administracin DB2. Notas de uso: v En versiones anteriores de DB2, este mandato era conocido como dasicrt. v El mandato dascrt se encuentra en el subdirectorio instance bajo el subdirectorio especfico de la versin y el release de DB2 que se ha instalado.
Command Reference
dasdrop - Eliminar un Servidor de administracin DB2 dasdrop - Mandato Eliminar un Servidor de administracin DB2
Slo en los sistemas operativos UNIX, elimina el Servidor de administracin DB2 (DAS). El Servidor de administracin proporciona servicios de soporte para las herramientas de DB2, tales como el Centro de control y el Asistente de configuracin. Autorizacin: Autorizacin raz. Conexin necesaria: Ninguna. Sintaxis del mandato:
dasdrop
Notas de uso: v El mandato dasdrop se encuentra en el subdirectorio instance bajo el subdirectorio especfico de la versin y el release de DB2 que se ha instalado. v Este mandato eliminar el subdirectorio das bajo el directorio inicial del Servidor de administracin DB2. Para eliminar el DAS, ejecute el script de inicio y asegrese de que el Servidor de administracin est detenido antes de ejecutar dasdrop. El procedimiento es el siguiente: 1. Inicie la sesin como un usuario con autorizacin DASADM. 2. Ejecute el script de configuracin utilizando una de las expresiones siguientes:
. INICIODAS/das/dasprofile (para el shell Bourne o Korn) source INICIODAS/das/dascshrc (para el shell C)
donde INICIODAS es el directorio inicial del propietario de DAS. 3. Detenga el DAS de la manera siguiente:
db2admin stop
4. Haga una copia de seguridad (si es necesario) de todos los archivos del subdirectorio das que est bajo el directorio inicial del DAS. 5. Inicie la sesin como root y elimine el DAS utilizando el mandato dasdrop:
dasdrop
dasmigr - Migrar el Servidor de administracin DB2 dasmigr -Mandato Migrar el Servidor de administracin DB2
Migra el servidor de administracin DB2 despus de la instalacin. En los sistemas basados en UNIX, este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX y /usr/IBM/db2/V8.1 en todos los dems sistemas basados en UNIX. Autorizacin: No se necesita ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
dasmigr
Notas de uso: Migrar el servidor de administracin DB2 requiere que se cree y se active un catlogo de herramientas para el DAS. Tareas relacionadas: v Configuring the DAS del manual Administration Guide: Implementation Informacin relacionada: v Mandato CREATE TOOLS CATALOG en la pgina 295
Command Reference
db2admin - Servidor de administracin DB2 db2admin -Mandato Servidor de administracin DB2

Este programa de utilidad se utiliza para gestionar el Servidor de administracin DB2. Autorizacin: Administrador local en Windows o DASADM en sistemas basados en UNIX. Conexin necesaria: Ninguna Sintaxis del mandato:
db2admin
START STOP /FORCE CREATE /USER: cuenta-usuario /PASSWORD: DROP SETID cuenta-usuario contrasea-usuario SETSCHEDID usuario-planif contrasea-planif -? -q contrasea-usuario
Parmetros del mandato: Nota: Si no se especifica ningn parmetro y el Servidor de administracin DB2 existe, este mandato devuelve el nombre del Servidor de administracin DB2. START Inicia el Servidor de administracin DB2. STOP /FORCE Detiene el Servidor de administracin DB2. La opcin force se utiliza para forzar la detencin del Servidor de administracin DB2, independientemente de si est en proceso de dar servicio a alguna peticin o no. CREATE /USER: cuenta-usuario /PASSWORD: contrasea-usuario Crea el Servidor de administracin DB2. Si se especifican un nombre de usuario y una contrasea, el Servidor de administracin DB2 se asociar a esta cuenta de usuario. Si los valores especificados no son vlidos, el programa de utilidad devuelve un error de autentificacin. La cuenta de usuario especificada debe ser un identificador SQL
db2admin - Servidor de administracin DB2

vlido y debe existir en la base de datos de seguridad. Se recomienda especificar una cuenta de usuario para asegurarse de que se puede acceder a todas las funciones del Servidor de administracin DB2. Nota: Para crear un DAS en sistemas UNIX, utilice el mandato dascrt. DROP Suprime el Servidor de administracin DB2. Nota: Para eliminar un DAS en UNIX, debe utilizar el mandato dasdrop. SETID cuenta-usuario/contrasea-usuario Establece o modifica la cuenta de usuario asociada al Servidor de administracin DB2. SETSCHEDID usuario-planif/contrasea-planif Establece la cuenta de inicio de sesin utilizada por el planificador para conectar con la base de datos del catlogo de herramientas. Slo es necesario si el planificador est habilitado y la base de datos del catlogo de herramientas es remota en el Servidor de administracin DB2. Para obtener ms informacin acerca del planificador, consulte la Gua de administracin. -? Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Ejecute el mandato db2admin en modalidad silenciosa. Cuando se ejecute este mandato, no se visualizar ningn mensaje. Esta opcin puede combinarse con cualquiera de las dems opciones del mandato.
-q
Notas de uso: En los sistemas operativos basados en UNIX, el archivo ejecutable para el mandato db2admin puede encontrarse en el directorio home/DASuser/das/bin, donde usuarioDAS es el nombre del usuario del Servidor de administracin DB2. En Windows, el ejecutable de db2admin se encuentra bajo el directorio sqllib/bin. Informacin relacionada: v dasdrop - Mandato Eliminar un Servidor de administracin DB2 en la pgina 5 v dascrt -Mandato Crear un servidor de administracin DB2 en la pgina 4
Command Reference
db2adutl - Trabajar con imgenes TSM archivadas db2adutl - Mandato Trabajar con imgenes TSM archivadas
Permite a los usuarios consultar, extraer, verificar y suprimir imgenes de copia de seguridad, anotaciones cronolgicas, y cargar imgenes de copia guardadas utilizando Tivoli Storage Manager (antes ADSM). En los sistemas operativos basados en UNIX, este programa de utilidad est ubicado en el directorio sqllib/adsm. En Windows, est ubicado en sqllib\bin. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2adutl QUERY TABLESPACE FULL NONINCREMENTAL INCREMENTAL DELTA SHOW INACTIVE
LOADCOPY LOGS BETWEEN ns1 AND ns2 EXTRACT TABLESPACE FULL NONINCREMENTAL INCREMENTAL DELTA SHOW INACTIVE TAKEN AT indicfechahora
LOADCOPY LOGS BETWEEN ns1 AND ns2 DELETE TABLESPACE FULL NONINCREMENTAL INCREMENTAL DELTA AND ns2 SHOW INACTIVE TAKEN AT indicfechahora indicfechahora THAN n days TAKEN AT indicfechahora KEEP n OLDER
LOADCOPY LOGS BETWEEN ns1 VERIFY TABLESPACE FULL
NONINCREMENTAL INCREMENTAL DELTA DBPARTITIONNUM
DATABASE DB
nombre_basedatos
nmero-particin-bd
PASSWORD
contrasea
NODENAME nombre_nodo
WITHOUT PROMPTING
OWNER
propietario
VERBOSE
Parmetros del mandato: QUERY Consulta objetos DB2 en el servidor TSM.
db2adutl - Trabajar con imgenes TSM archivadas

EXTRACT Copia objetos DB2 del servidor TSM en el directorio actual de la mquina local. DELETE Desactiva objetos de copia de seguridad o suprime archivos de anotaciones cronolgicas del servidor TSM. VERIFY Realiza la comprobacin de coherencia en la copia de seguridad que est en el servidor. Nota: Este parmetro hace que se transfiera por la red la imagen de copia de seguridad entera. TABLESPACE Slo incluye imgenes de copia de seguridad del espacio de tabla. FULL Slo incluye imgenes completas de copia de seguridad de base de datos.
NONINCREMENTAL Slo incluye imgenes de copia de seguridad no incrementales. INCREMENTAL Slo incluye imgenes de copia de seguridad incrementales. DELTA Slo incluye imgenes de copia de seguridad delta incrementales. LOADCOPY Slo incluye imgenes de copia de carga. LOGS Slo incluye imgenes de archivo de anotaciones cronolgicas. BETWEEN ns1 AND ns2 Especifica que deben utilizarse las anotaciones cronolgicas entre el nmero de secuencia de anotacin cronolgica 1 y el nmero de secuencia de anotacin cronolgica 2. SHOW INACTIVE Incluye objetos de copia de seguridad que se han desactivado. TAKEN AT indicfechahora Especifica una imagen de copia de seguridad por su indicacin de fecha y hora. KEEP n Desactiva todos los objetos del tipo especificado excepto los n ms recientes por indicacin de fecha y hora.
10
Command Reference

OLDER THAN indicfechahora o n das Especifica que se desactivarn los objetos con una indicacin de fecha y hora anterior a indicfechahora o n das. DATABASE nombre_basedatos Slo tiene en cuenta los objetos asociados con el nombre de base de datos especificado. DBPARTITIONNUM nmero-particin-bd Slo tiene en cuenta los objetos creados por el nmero de particin de base de datos especificado. PASSWORD contrasea Especifica la contrasea de cliente TSM para este nodo, si es necesaria. Si se especifica una base de datos y no se proporciona la contrasea, el valor especificado para el parmetro de configuracin de base de datos contrasea_tsm se pasa a TSM; de lo contrario, no se utiliza ninguna contrasea. NODENAME nombre_nodo Slo tiene en cuenta las imgenes asociadas con un nombre de nodo TSM especfico. WITHOUT PROMPTING No se le solicita verificacin al usuario antes de suprimir objetos. OWNER propietario Slo tiene en cuenta los objetos creados por el propietario especificado. VERBOSE Muestra informacin adicional de archivo Ejemplos: A continuacin se muestra un ejemplo de salida de: db2 backup database rawsampl use tsm
Copia de seguridad satisfactoria. La indicacin horaria para esta copia de seguridad es : 19970929130942 db2adutl query Consulta para base de datos RAWSAMPL Recuperando informacin de copia de seguridad de base de datos completa. imagen copia seg. base datos completa: 1, Hora: 19970929130942, Anot. ms antigua: S0000053.LOG, Sesiones usadas: 1 imagen copia seg. base datos completa: 2, Hora: 19970929142241, Anot. ms antigua: S0000054.LOG, Sesiones usadas: 1 Recuperando informacin de copia de seguridad de espacio de tabla. imagen copia seguridad espacio tabla: 1, Hora: 19970929094003,
11

Anot. ms antigua: S0000051.LOG, Sesiones usadas: 1 imagen copia seguridad espacio tabla: 2, Hora: 19970929093043, Anot. ms antigua: S0000050.LOG, Sesiones usadas: 1 imagen copia seguridad espacio tabla: 3, Hora: 19970929105905, Anot. ms antigua: S0000052.LOG, Sesiones usadas: 1 Recuperando informacin de archivo de anotaciones cronolgicas. Archivo de anotaciones cronolgicas: S0000050.LOG Archivo de anotaciones cronolgicas: S0000051.LOG Archivo de anotaciones cronolgicas: S0000052.LOG Archivo de anotaciones cronolgicas: S0000053.LOG Archivo de anotaciones cronolgicas: S0000054.LOG Archivo de anotaciones cronolgicas: S0000055.LOG
A continuacin se muestra un ejemplo de salida de: db2adutl delete full taken at 19950929130942 db rawsampl
Consulta para base de datos RAWSAMPL Recuperando informacin de copia de seguridad de base de datos completa. Espere, por favor. imagen copia seg. base datos completa: \ RAWSAMPL.0.db26000.0.19970929130942.001 Desea desactivar este imagen de copia de seguridad (S/N)? s Est seguro (S/N)? s db2adutl query Consulta para base de datos RAWSAMPL Recuperando informacin de copia de seguridad de base de datos completa. imagen copia seg. base datos completa: 2, Hora: 19950929142241, Anot. ms antigua: S0000054.LOG, Sesiones usadas: 1 Recuperando informacin de copia de seguridad de espacio de tabla. imagen copia seguridad espacio tabla: 1, Hora: 19950929094003, Anot. ms antigua: S0000051.LOG, Sesiones usadas: 1 imagen copia seguridad espacio tabla: 2, Hora: 19950929093043, Anot. ms antigua: S0000050.LOG, Sesiones usadas: 1 imagen copia seguridad espacio tabla: 3, Hora: 19950929105905, Anot. ms antigua: S0000052.LOG, Sesiones usadas: 1 Recuperando informacin de archivo de anotaciones cronolgicas. Archivo de anotaciones cronolgicas: S0000050.LOG Archivo de anotaciones cronolgicas: S0000051.LOG Archivo de anotaciones cronolgicas: S0000052.LOG Archivo de anotaciones cronolgicas: S0000053.LOG Archivo de anotaciones cronolgicas: S0000054.LOG Archivo de anotaciones cronolgicas: S0000055.LOG
12
Command Reference

Notas de uso: Un parmetro de cada uno de los grupos de ms abajo puede utilizarse para restringir cules sern los tipos de imgenes de copia de seguridad que se incluirn en la operacin: Granularidad: v FULL - slo incluye imgenes de copia de seguridad de base de datos. v TABLESPACE - slo incluye imgenes de copia de seguridad de espacio de tabla. Acumulatividad: v NONINCREMENTAL - slo incluye imgenes de copia de seguridad no incrementales. v INCREMENTAL - slo incluye imgenes de copia de seguridad incrementales. v DELTA - slo incluye imgenes de copia de seguridad delta incrementales. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM.
13
db2advis - Asesor de ndices DB2 db2advis -Mandato Asesor de ndices DB2

Aconseja a los usuarios qu ndices se deben crear para una o ms sentencias de SQL. Un grupo de sentencias de SQL relacionadas se conoce como carga de trabajo. Los usuarios pueden clasificar la importancia de cada sentencia de una carga de trabajo y especificar la frecuencia con la que debe ejecutarse cada sentencia de la carga de trabajo. Los ndices recomendados para cada tabla, las estadsticas obtenidas para ellos, as como el DDL mediante el cual puede crearse cada uno, se graban en una tabla creada por el usuario, ADVISE_INDEX. Nota: Cuando se ejecuta este mandato no se tienen en cuenta las columnas de tipo estructurado. Autorizacin: Acceso de lectura a la base de datos. Acceso de lectura y grabacin a las tablas de explicacin. Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2advis -d nombre-base-datos -w -s -i nombre-carga-trabajo sentencia nombre-archivo
-a
idusuario /contrasea
-l
lmite-disco
-t
tiempo-mx-aconsejado
-h
-p
-o
archivosalida
Parmetros del mandato: -d nombre-base-datos Especifica el nombre de la base de datos con la que debe establecerse una conexin. -w nombre-carga-trabajo Especifica el nombre de la carga de trabajo para la que deben aconsejarse ndices. Este nombre se utiliza en la tabla ADVISE_WORKLOAD.
14
Command Reference
db2advis - Asesor de ndices DB2

-s sentencia Especifica el texto de una sola sentencia de SQL cuyos ndices deben aconsejarse. La sentencia debe escribirse entre comillas dobles. -i nombre-archivo Especifica el nombre de un archivo de entrada que contiene una o ms sentencias de SQL. El valor por omisin es la entrada estndar. El texto de comentario se identifica con dos guiones al principio de cada lnea; es decir, -- <comentario>. Las sentencias deben delimitarse con punto y coma. La frecuencia con la que debe ejecutarse cada sentencia de la carga de trabajo puede cambiarse insertando la lnea siguiente en el archivo de entrada:
--#SET FREQUENCY <x>
La frecuencia puede actualizarse en el archivo tantas veces como se desee. -a idusuario/contrasea Nombre y contrasea que se utilizan para conectarse a la base de datos. Se debe incluir la barra inclinada (/) si se especifica una contrasea. -l lmite-disco Especifica el nmero mximo de megabytes disponibles para todos los ndices en el esquema existente. El valor por omisin es el lmite del gestor de bases de datos en el tamao mximo de un ndice por particin (64 GB). -t tiempo-mx-aconsejado Especifica el tiempo mximo permitido, en minutos, para realizar la operacin. El valor por omisin es 10. El tiempo ilimitado se especifica mediante un valor de cero. -h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Mantiene los planes que se generaron al ejecutar la herramienta en las tablas de explicacin.
-p
-o archsalida Guarda el script para crear los objetos recomendados en archsalida. Ejemplos: En el ejemplo siguiente, el programa de utilidad se conecta con la base de datos PROTOTYPE y recomienda ndices para la tabla ADDRESSES sin restricciones en la solucin:
15

db2advis -d prototype -s "select * from addresses a where a.zip in (93213, 98567, 93412) and (company like IBM% or company like %otus)"
En el ejemplo siguiente, el programa de utilidad se conecta con la base de datos PROTOTYPE y recomienda ndices que no excedern de 53 MB para las consultas de la tabla ADVISE_WORKLOAD cuyo nombre de carga de trabajo es igual a production. El tiempo mximo permitido para encontrar una solucin es de 20 minutos.
db2advis -d prototype -w production -l 53 -t 20
En el ejemplo final, un archivo de entrada llamado db2advis.in contiene sentencias de SQL y una especificacin de la frecuencia con la que debe ejecutarse cada sentencia:
--#SET FREQUENCY 100 SELECT COUNT(*) FROM EMPLOYEE; SELECT * FROM EMPLOYEE WHERE LASTNAME=HAAS; --#SET FREQUENCY 1 SELECT AVG(BONUS), AVG(SALARY) FROM EMPLOYEE GROUP BY WORKDEPT ORDER BY WORKDEPT;
El programa de utilidad se conecta a la base de datos SAMPLE y recomienda ndices para cada tabla a la que hacen referencia las consultas del archivo de entrada. El tiempo mximo permitido para encontrar una solucin es de 5 minutos:
db2advis -d sample -f db2advis.in -t 5
Notas de uso: Para las sentencias de SQL dinmicas, la frecuencia con la que se ejecutan las sentencias puede obtenerse del supervisor del modo siguiente: 1. Emita
db2 reset monitor for database <alias-base-datos>
Espere un intervalo de tiempo apropiado. 2. Emita

db2 get snapshot for dynamic sql on <alias-base-datos> write to file
3. Emita
db2 "insert into advise_workload (select myworkload, 0, stmt_text, cast(generate_unique() as char(254)), num_executions, 1, num_executions, 0, 0 from table(SYSFUN.SQLCACHE_SNAPSHOT()) as correlations_name"
16
Command Reference

La frecuencia por omisin para cada sentencia de SQL en una carga de trabajo es de 1 y la importancia por omisin es tambin de 1. La funcin generate_unique() asigna un identificador exclusivo a la sentencia, que el usuario puede actualizar para que sea una descripcin ms significativa de dicha sentencia de SQL.
17
db2audit - Herramienta de administrador del recurso de comprobacin db2audit -Mandato Herramienta de administrador del recurso de comprobacin
DB2 proporciona un recurso de comprobacin para ayudarle a detectar el acceso desconocido o inesperado a los datos. El recurso de comprobacin de DB2 genera y permite el mantenimiento de un seguimiento de comprobacin para una serie de sucesos predefinidos de la base de datos. Los registros generados desde este recurso se conservan en un archivo de anotaciones cronolgicas de comprobacin. El anlisis de estos registros puede revelar patrones de uso que identificarn el uso incorrecto del sistema. Una vez identificado, se pueden realizar acciones para reducir o eliminar dicho uso incorrecto del sistema. El recurso de comprobacin acta a nivel de instancia, registrando todas las actividades a nivel de instancia y las actividades a nivel de base de datos. Los usuarios autorizados del recurso de comprobacin pueden controlar las acciones siguientes en dicho recurso, utilizando db2audit: v Empezar a registrar sucesos comprobables en la instancia de DB2. v Dejar de registrar sucesos comprobables en la instancia de DB2. v Configurar el comportamiento del recurso de comprobacin. v Seleccionar las categoras de los sucesos comprobables que se deben registrar. v Solicitar una descripcin de la configuracin de comprobacin actual. v Desechar los registros de comprobacin pendientes de la instancia y grabarlos en la anotacin cronolgica de comprobacin. v Extraer registros de comprobacin formatendolos y copindolos de la anotacin cronolgica de comprobacin a un archivo plano o archivos ASCII delimitados. La extraccin se efecta por una de dos razones: Para prepararse para el anlisis de los registros de anotacin cronolgica o para prepararse para la poda de registros de anotacin cronolgica. v Podar registros de comprobacin de la anotacin cronolgica de comprobacin actual.
18
Command Reference
db2atld - Autoloader db2atld -Mandato Cargador automtico

Autoloader (cargador automtico) es una herramienta para particionar y cargar datos en un entorno MPP. Este programa de utilidad puede: v Transferir datos de un sistema (por ejemplo MVS) a un sistema AIX (RS/6000 o SP2) v Particionar datos en paralelo v Cargar datos simultneamente en las particiones de base de datos correspondientes. Informacin relacionada: v Mandato LOAD en la pgina 481
19
db2batch - Herramienta Benchmark db2batch -Mandato Herramienta de banco de pruebas

Lee las sentencias de SQL de un archivo plano o de la entrada estndar, prepara dinmicamente y describe las sentencias y devuelve un conjunto de respuestas. Esta herramienta puede funcionar en una base de datos de una nica particin o en una base de datos de mltiples particiones. Mediante los parmetros opcionales de la herramienta puede controlar el nmero de filas que se deben captar del conjunto de respuestas, el nmeros de filas captadas que se deben enviar al archivo de salida o a la salida estndar, y el nivel de informacin de rendimiento que se debe devolver. El valor por omisin de salida es utilizar la salida estndar. Puede nombrar el archivo de salida para el resumen de resultados. Cuando est trabajando en una base de datos particionada y utiliza la opcin -r para nombrar el archivo de salida, la salida para cada particin de base de datos va a un archivo separado con el mismo nombre en cada particin de base de datos. La excepcin es cuando el archivo especificado est en un sistema de archivos montado en NFS. Cuando es ste el caso, en una base de datos de mltiples particiones, todos los resultados se mantienen en este archivo. Autorizacin: El mismo nivel de autorizacin que el necesario para las sentencias de SQL que se van a leer. En modalidad paralela, los usuarios deben tener la autorizacin para ejecutar db2_all. Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2batch -d nombrebd -f nombre_archivo
-a
idusuario/contrasea
-t
delcol
20
Command Reference
db2batch - Herramienta Benchmark

-r archivosalida ,archivosalida2 -c on off short long complete
-i
-o
opciones -v
off on
-s
on off
-q
off on del
-l
-p
s t tabla d
-cli tamao-antememoria
-h
Parmetros del mandato: -d nombrebd Nombre de alias de la base de datos en la que deben aplicarse las sentencias de SQL. Si no se especifica esta opcin, se utiliza el valor de la variable de entorno DB2DBDFT. -f nombre_archivo Nombre de un archivo de entrada que contiene sentencias de SQL. El valor por omisin es la entrada estndar. El texto de comentario se identifica con dos guiones al principio de cada lnea, es decir, -- <comentario>. Si el comentario debe incluirse en la salida, mrquelo del modo siguiente: --#COMMENT <comentario>. Un bloque es un conjunto de sentencias de SQL que se trata como si fuera una sola sentencia, es decir, se rene informacin para todas esas sentencias a la vez, en lugar de una en una. El principio de un bloque de consultas se identifica del modo siguiente: --#BGBLK. El final de un bloque de consultas se identifica del modo siguiente: --#EOBLK. Especifique una o ms opciones de control del modo siguiente: --#SET <opcin de control> <valor>. Las opciones de control vlidas son: ROWS_FETCH Nmero de filas a captar del conjunto de respuestas. Los valores vlidos son -1 a n. El valor por omisin es -1 (se deben captar todas las filas). ROWS_OUT Nmero de filas captadas que se deben enviar a la salida. Los valores vlidos son -1 a n. El valor por omisin es -1 (deben enviarse a la salida todas las filas captadas).
21

PERF_DETAIL Especifica el nivel de informacin de rendimiento que se debe devolver. Los valores vlidos son: 0 1 2 3 4 No debe realizarse ninguna temporizacin. Devolver slo el tiempo transcurrido. Devolver el tiempo transcurrido y el tiempo de CPU. Devolver un resumen de informacin de supervisin. Devolver una instantnea para el gestor de bases de datos, la base de datos, la aplicacin y la sentencia (sta ltima slo se devuelve si el compromiso automtico est desactivado y se estn procesando sentencias individuales, no bloques de sentencias). Devolver una instantnea para el gestor de bases de datos, la base de datos, la aplicacin y la sentencia (sta ltima slo se devuelve si el compromiso automtico est desactivado y se estn procesando sentencias individuales, no bloques de sentencias). Devolver tambin una instantnea para las agrupaciones de almacenamientos intermedios, los espacios de tabla y el FCM (una instantnea de FCM slo est disponible en un entorno de mltiples particiones de base de datos).
El valor por omisin es 1. Un valor >1 slo es vlido en servidores DB2 Versin 2 y DB2 UDB y no est soportado actualmente en las mquinas de sistema principal. DELIMITER Delimitador de fin de sentencia de uno o dos caracteres. El valor por omisin es un punto y coma (;). SLEEP Nmero de segundos a permanecer inactivo. Los valores vlidos son 1 a n. PAUSE Solicita al usuario que contine. TIMESTAMP Genera una indicacin de fecha y hora. -a idusuario/contrasea Nombre y contrasea que se utilizan para conectarse a la base de datos. Se debe incluir la barra inclinada (/).
22
Command Reference

-tdelcol Especifica un separador de columna de un solo carcter. Nota: Para incluir un delimitador de columna de tabulador utilice -t TAB. -r archivosalida Archivo de salida que contendr los resultados de la consulta. Un archivosalida2 opcional contendr un resumen de resultados. El valor por omisin es la salida estndar. -c -i Compromete automticamente los cambios resultantes de cada sentencia de SQL. Intervalo de tiempo transcurrido (en segundos). short long Tiempo tomado para abrir el cursor, realizar la captacin y cerrar el cursor. Tiempo transcurrido desde el inicio de una consulta hasta el inicio de la consulta siguiente, incluyendo los tiempos de pausa y de inactividad y la actividad general del mandato.
complete Tiempo para preparar, ejecutar y captar, expresado por separado. -o opciones Opciones de control. Las opciones vlidas son: f rows_fetch Nmero de filas a captar del conjunto de respuestas. Los valores vlidos son -1 a n. El valor por omisin es -1 (se deben captar todas las filas). r rows_out Nmero de filas captadas que se deben enviar a la salida. Los valores vlidos son -1 a n. El valor por omisin es -1 (deben enviarse a la salida todas las filas captadas). p perf_detail Especifica el nivel de informacin de rendimiento que se debe devolver. Los valores vlidos son: 0 1 2 3 4 No debe realizarse ninguna temporizacin. Devolver slo el tiempo transcurrido. Devolver el tiempo transcurrido y el tiempo de CPU. Devolver un resumen de informacin de supervisin. Devolver una instantnea para el gestor de bases de
23

datos, la base de datos, la aplicacin y la sentencia (sta ltima slo se devuelve si el compromiso automtico est desactivado y se estn procesando sentencias individuales, no bloques de sentencias). 5 Devolver una instantnea para el gestor de bases de datos, la base de datos, la aplicacin y la sentencia (sta ltima slo se devuelve si el compromiso automtico est desactivado y se estn procesando sentencias individuales, no bloques de sentencias). Devolver tambin una instantnea para las agrupaciones de almacenamientos intermedios, los espacios de tabla y el FCM (una instantnea de FCM slo est disponible en un entorno de mltiples particiones de base de datos).
El valor por omisin es 1. Un valor >1 slo es vlido en servidores DB2 Versin 2 y DB2 UDB y no est soportado actualmente en las mquinas de sistema principal. o query_optimization_class Establece la clase de optimizacin de consulta. e explain_mode Establece la modalidad de explicacin bajo la cual se ejecuta db2batch. Las tablas de explicacin deben crearse antes de utilizar esta opcin. Los valores vlidos son: 0 1 Slo ejecutar consulta (valor por omisin). Slo llenar de datos las tablas de explicacin. Esta opcin llena de datos las tablas de explicacin y hace que se tomen instantneas de explicacin. Llenar de datos las tablas de explicacin y ejecutar la consulta. Esta opcin llena de datos las tablas de explicacin y hace que se tomen instantneas de explicacin.
-v -s
Verboso. Enva informacin al error estndar durante el proceso de la consulta. El valor por omisin es off (desactivado). Tabla de resumen. Proporciona una tabla de resumen para cada consulta o bloque de consultas, que contiene el tiempo transcurrido (si se ha seleccionado), los tiempos de CPU (si se han seleccionado), las filas captadas y las filas impresas. Se proporcionan las medias aritmtica y geomtrica para el tiempo transcurrido y los tiempos de CPU si stos se han reunido. Consulta la salida. Los valores vlidos son:
-q
24
Command Reference

on off del -l x -p Imprimir slo la salida no delimitada de la consulta. Imprimir la salida de la consulta y toda la informacin asociada. ste es el valor por omisin. Imprimir slo la salida delimitada de la consulta.
Especifica el carcter de terminacin. Paralelo (slo ESE). En esta modalidad slo se soportan las sentencias SELECT. Los nombres de salida deben tener una va de acceso totalmente calificada. Los valores vlidos son: s Consulta de unin colocada o tabla individual. Las sentencias SELECT no pueden contener solamente funciones de columna. Esto es un requisito de la funcin DBPARTITIONNUM que se aade a la consulta. Si se especifica esta opcin, la funcin DBPARTITIONNUM se aadir a la clusula WHERE de la consulta y no se crear una tabla temporal. Esta opcin slo es vlida si la consulta contiene una sola tabla en la clusula FROM o si se colocan las tablas contenidas en la clusula FROM. Si se especifica esta opcin y la consulta contiene una clusula GROUP BY, las columnas especificadas en GROUP BY deben ser un superconjunto de la clave de particionamiento de tablas. t tabla Especifica el nombre de una tabla existente a utilizar como la tabla intermedia que se va a llenar con los datos de exportacin. Si la consulta contiene mltiples tablas en la clusula FROM y las tablas no estn colocadas, se inserta el conjunto de resultados en la tabla especificada y se emite un SELECT en paralelo en todas las particiones para generar los archivos con los datos de exportacin. Crea una tabla de sistema en IBMDEFAULTGROUP que se deber utilizar para una sentencia INSERT INTO. Si la consulta contiene mltiples tablas en la clusula FROM y las tablas no estn colocadas, se inserta el conjunto de resultados en la tabla especificada y se emite un SELECT en paralelo en todas las particiones para generar los archivos con los datos de exportacin.
Si se especifica un archivo de salida local (utilizando la opcin -r), la salida de cada particin de base de datos ir a un archivo independiente con el mismo nombre en cada particin de base de
25

datos. Si se especifica un archivo que est en un sistema de archivos montado por NFS, toda la salida ir a dicho archivo. -cli Ejecuta db2batch en modalidad CLI. El valor por omisin es utilizar el SQL dinmico incorporado. La memoria de la sentencia puede establecerse manualmente, utilizando el parmetro tamao-antememoria.
tamao-antememoria Tamao de la memoria de la sentencia, expresado como nmero de sentencias. El valor por omisin es 25. Si el programa de utilidad encuentra una sentencia de SQL que ya se ha preparado, volver a utilizar los planes anteriores. Este parmetro slo se puede establecer cuando db2batch se ejecuta en modalidad CLI. -h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
Notas de uso: 1. Aunque las sentencias de SQL pueden tener hasta 65.535 caracteres de longitud, ninguna lnea de texto del archivo de entrada puede exceder de 3.898 caracteres y las sentencias largas debern dividirse entre varias lneas. Las sentencias deben terminarse con un delimitador (el valor por omisin es un punto y coma). 2. Las sentencias de SQL se ejecutan con el nivel de aislamiento de lectura repetible (RR). 3. Las consultas de SQL que incluyen columnas LOB en su salida no estn soportadas. Informacin relacionada: v db2sql92 -Mandato Procesador de sentencias de SQL conforme con SQL92 en la pgina 159
26
Command Reference
db2bfd - Herramienta de descripcin de archivo de vinculacin db2bfd -Mandato Herramienta de descripcin de archivo de vinculacin
Visualiza el contenido de un archivo de vinculacin. Este programa de utilidad, que se puede utilizar para examinar y verificar las sentencias de SQL de un archivo de vinculacin, as como para visualizar las opciones de precompilacin utilizadas para crear el archivo de vinculacin, puede ser til en la determinacin de problemas relacionados con el archivo de vinculacin de una aplicacin. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
, db2bfd -h -b -s -v espec-archivo
Parmetros del mandato: -h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Visualiza la cabecera del archivo de vinculacin. Visualiza las sentencias de SQL. Visualiza las declaraciones de variables de sistema principal.
-b -s -v
espec-archivo Nombre del archivo de vinculacin cuyo contenido debe visualizarse.
27
db2cap - Herramienta de vinculacin de paquetes estticos CLI/ODBC db2cap -Mandato Herramienta de vinculacin de paquetes estticos CLI/ODBC
Vincula un archivo de captura para generar uno o ms paquetes estticos. Un archivo de captura se genera durante una sesin de perfil esttico de una aplicacin CLI/ODBC/JDBC y contiene sentencias de SQL capturadas durante la ejecucin de la aplicacin. Este programa de utilidad procesa el archivo de captura para que lo pueda utilizar el controlador CLI/ODBC/JDBC para ejecutar SQL esttico para la aplicacin. Autorizacin: v Privilegios de acceso a cualquier objeto de base de datos al que se haga referencia en las sentencias de SQL registradas en el archivo de captura. v Autorizacin suficiente para establecer opciones de vinculacin como por ejemplo OWNER y QUALIFIER si son diferentes del ID de conexin que se ha utilizado para emitir el mandato db2cap. v Autorizacin BINDADD si el paquete se est vinculando por primera vez; de lo contrario, se necesita autorizacin BIND. Sintaxis del mandato:
db2cap -h -? bind archivo-captura -d alias_basedatos
-u
idusuario -p contrasea
Parmetros del mandato: -h/-? Visualiza texto de ayuda para la sintaxis del mandato.
bind archivo-captura Vincula las sentencias del archivo de captura y crea uno o ms paquetes. -d alias_basedatos Especifica el alias de base de datos para la base de datos que contendr uno o ms paquetes. -u idusuario Especifica el ID de usuario que debe utilizarse para conectarse a la fuente de datos. Nota: Si no se especifica ningn ID de usuario, se obtiene un ID de autorizacin fiable del sistema.
28
Command Reference
db2cap - Herramienta de vinculacin de paquetes estticos CLI/ODBC

-pcontrasea Especifica la contrasea que debe utilizarse para conectarse a la fuente de datos. Notas de uso: Este mandato se debe entrar en minsculas en las plataformas UNIX, pero se puede entrar en minsculas o en maysculas en los sistemas operativos Windows. Este programa de utilidad soporta varias opciones de vinculacin especificadas por el usuario que se pueden encontrar en el archivo de captura. Para poder cambiar las opciones de vinculacin, abra el archivo de captura con un editor de textos. Las opciones de vinculacin SQLERROR(CONTINUE) y VALIDATE(RUN) se pueden utilizar para crear un paquete. Cuando se utiliza este programa de utilidad para crear un paquete, debe inhabilitarse el perfil esttico. El nmero de paquetes creados depende de los niveles de aislamiento utilizados para las sentencias de SQL registradas en el archivo de captura. El nombre de paquete consta de un mximo de los siete primeros caracteres de la palabra clave del paquete del archivo de captura y uno de los siguientes sufijos de nico carcter: v 0 - Lectura no comprometida (UR) v 1 - Estabilidad del cursor (CS) v 2 - Estabilidad de lectura (RS) v 3 - Lectura repetible (RR) v 4 - Ningn compromiso (NC) Para obtener informacin especfica sobre paquetes, el usuario puede: v Consultar las tablas de catlogos SYSIBM adecuadas utilizando las palabras clave COLLECTION y PACKAGE que se han encontrado en el archivo de captura. v Ver el archivo de captura.
29
db2cc - Iniciar el Centro de control db2cc -Mandato Iniciar el Centro de control

Inicia el Centro de control. El Centro de control es una interfaz grfica que se utiliza para gestionar objetos de base de datos (por ejemplo, bases de datos, tablas y paquetes) y la relacin entre los mismos. Autorizacin: sysadm Sintaxis del mandato:
db2cc -wc -rc -tc -j -hc -mv -tm -icc -t -tcomms -tfilter + filtro
-ccf
nombre-archivo
-ic
-ict segundos
-h
sistema
-i
instancia
-d basedatos
-sub subsistema
Parmetros del mandato: -wc -rc -hc -tc -j -mv -tm -icc -t Abre el Centro de depsito. Abre el Centro de duplicacin. Abre el Centro de salud. Abre el Centro de tareas. Abre el Diario. Abre el Visualizador de memoria. Abre el Gestor de transacciones de identificacin dudosa. Abre el Gestor de catlogos de informacin. Activa el Rastreo de centro de control para un cdigo de inicializacin.
-tcomms Limita el rastreo a los sucesos de comunicaciones.
30
Command Reference
db2cc - Iniciar el Centro de control

-tfilter filtro Limita el rastreo a las entradas que contienen el filtro o los filtros especificados. -ccf nombre-archivo Abre el Centro de mandatos. Si se especifica un nombre de archivo, el contenido de este archivo se carga en la pgina Script del Centro de mandatos. Tenga en cuenta que, al especificar un nombre de archivo, se debe proporcionar la va de acceso absoluta al archivo. -ic Abre el Centro de informacin.
-ict segundos Temporizador de conexin desocupada. Cierra las conexiones desocupadas de las agrupaciones mantenidas por el Centro de control despus del nmero de segundos especificados. El temporizador por omisin es de 30 minutos. -h sistema Abre el Centro de control en el contexto de un sistema. -i instancia Abre el Centro de control en el contexto de una instancia. -d basedatos Abre el Centro de control en el contexto de una base de datos. -sub subsistema Abre el Centro de control en el contexto de un subsistema. Informacin relacionada: v Mandato GET ADMIN CONFIGURATION en la pgina 335 v Mandato RESET ADMIN CONFIGURATION en la pgina 623 v Mandato UPDATE ADMIN CONFIGURATION en la pgina 704
31
db2cfexp - Herramienta de exportacin de configuracin de conectividad db2cfexp -Mandato Herramienta de exportacin de configuracin de conectividad
Exporta informacin de configuracin de conectividad a un perfil de exportacin, que se puede importar posteriormente a otra instancia de estacin de trabajo de DB2 Universal Database (UDB) de un tipo de instancia similar. Este programa de utilidad exporta la informacin de configuracin de conectividad a un archivo conocido como perfil de configuracin. Se trata de un programa de utilidad no interactivo que empaqueta toda la informacin de configuracin necesaria para satisfacer los requisitos de las opciones de exportacin especificadas. Los elementos que se pueden exportar son: v Informacin de base de datos (incluyendo informacin de DCS y ODBC) v Informacin de nodo v v v v Informacin de protocolo Valores de configuracin del gestor de bases de datos Valores de registro UDB Valores de ODBC/CLI comunes.
Este programa de utilidad es especialmente til para exportar informacin de configuracin de conectividad en estaciones de trabajo que no tienen instalado el Asistente de configuracin de DB2 y en situaciones en que se han de instalar, configurar y mantener varios clientes UDB remotos similares. Autorizacin: Una de las siguientes: v sysadm v sysctrl Sintaxis del mandato:
db2cfexp nombre-archivo TEMPLATE BACKUP MAINTAIN
Parmetros del mandato: nombre-archivo Especifica el nombre totalmente calificado del archivo de exportacin de destino. Este archivo se conoce como perfil de configuracin.
32
Command Reference
db2cfexp - Herramienta de exportacin de configuracin de conectividad

TEMPLATE Crea un perfil de configuracin que se utiliza como plantilla para otras instancias del mismo tipo de instancia. El perfil incluye informacin acerca de: v Todas las bases de datos, incluyendo informacin de ODBC y DCS relacionada v Todos los nodos asociados con las bases de datos exportadas v Valores de ODBC/CLI comunes v Valores de cliente comunes de la configuracin del gestor de bases de datos v Valores de cliente comunes del registro UDB. BACKUP Crea un perfil de configuracin de la instancia UDB con el fin de realizar copias de seguridad locales. Este perfil contiene toda la informacin de configuracin de instancia, incluyendo informacin de naturaleza especfica pertinente slo en esta instancia local. El perfil incluye informacin acerca de: v Todas las bases de datos, incluyendo informacin de ODBC y DCS relacionada v Todos los nodos asociados con las bases de datos exportadas v Valores de ODBC/CLI comunes v Todos los valores de la configuracin del gestor de bases de datos v Todos los valores del registro UDB v Toda la informacin de protocolo. MAINTAIN Crea un perfil de configuracin que slo contiene informacin relacionada con bases de datos y nodos para el mantenimiento o la actualizacin de otras instancias.
33
db2cfimp - Herramienta de importacin de configuracin de conectividad db2cfimp -Mandato Herramienta de importacin de configuracin de conectividad
Importa la informacin de configuracin de conectividad de un archivo conocido como perfil de configuracin. Se trata de un programa de utilidad no interactivo que intentar importar toda la informacin encontrada en el perfil de configuracin. Un perfil de configuracin puede contener elementos de conectividad como los siguientes: v Informacin de base de datos (incluyendo informacin de DB2 Connect y ODBC) v Informacin de nodo v Informacin de protocolo v Valores de configuracin del gestor de bases de datos v Valores de registro de Universal Database (UDB) v Valores de ODBC/CLI comunes. Este programa de utilidad se puede utilizar para duplicar la informacin de conectividad de otra instancia similar que se ha configurado anteriormente. Es especialmente til en estaciones de trabajo que no tienen instalado el Asistente de configuracin (CA) de DB2 y en situaciones en las que se han de instalar, configurar y mantener varios clientes UDB remotos similares. Autorizacin: Una de las siguientes: v sysadm v sysctrl Sintaxis del mandato:
db2cfimp nombre-archivo
Parmetros del mandato: nombre-archivo Especifica el nombre totalmente calificado del perfil de configuracin a importar. Los perfiles de configuracin de importacin vlidos son: perfiles creados mediante cualquier mtodo de exportacin de configuracin de conectividad de DB2 UDB o DB2 Connect, o perfiles de acceso a servidor.
34
Command Reference
db2cidmg - Migracin de base de datos remota db2cidmg -Mandato Migracin de base de datos remota
Soporta la migracin remota desatendida en el entorno de arquitectura CID (Configuration, Installation, and Distribution - Configuracin, Instalacin y Distribucin). Autorizacin: Una de las siguientes: v sysadm v dbadm Sintaxis del mandato:
db2cidmg basedatos /r=archivo-resp /e /l1=archivo-anot-cron /b
Parmetros del mandato: basedatos Especifica un nombre de alias para la base de datos que se va a migrar. Si no se especifica, se deber proporcionar un archivo de respuestas o /e para la invocacin del programa. Tenga en cuenta que el alias de la base de datos debe estar catalogado en la estacin de trabajo de destino. Sin embargo, puede ser una base de datos local o remota. /r Especifica un archivo de respuestas que se deber utilizar para la migracin CID. El archivo de respuestas es un archivo ASCII que contiene una lista de las bases de datos que deben migrarse. Si no se especifica, se deber proporcionar un alias de base de datos o /e para la invocacin del programa. Indica que debe migrarse cada base de datos individual catalogada en el directorio de bases de datos del sistema. Si no se especifica /e, se deber proporcionar un alias de base de datos o un archivo de respuestas. Especifica el nombre de va de acceso del archivo en el que se puede copiar informacin de anotacin cronolgica de errores de estaciones de trabajo remotas despus de que se haya completado el proceso de migracin. Si se especifica ms de una base de datos en el archivo de respuestas, se aade la informacin de anotacin cronolgica de cada migracin de base de datos al final del archivo. Independientemente de que se haya especificado /l1 o no, se genera un archivo de anotaciones cronolgicas con el nombre DB2CIDMG.LOG y se mantiene
/e
/l1
35
db2cidmg - Migracin de base de datos remota

dicho archivo en el sistema de archivos de la estacin de trabajo donde se ha efectuado la migracin de base de datos. /b Indica que todos los paquetes de la base de datos se deben volver a vincular una vez que se haya completado la migracin.
36
Command Reference
db2ckbkp - Comprobar copia de seguridad db2ckbkp - Mandato Comprobar copia de seguridad

Este programa de utilidad se puede utilizar para probar la integridad de una imagen de copia de seguridad y para determinar si la imagen se puede restaurar o no. Tambin se puede utilizar para visualizar los metadatos almacenados en la cabecera de la copia de seguridad. Autorizacin: Cualquier usuario puede acceder a este programa de utilidad, pero deber tener permisos de lectura para las copias de seguridad de imagen a fin de ejecutar este programa de utilidad en ellas. Conexin necesaria: Ninguna Sintaxis del mandato:
, db2ckbkp -a -c -d -h -H -l -n -o , nombre-archivo
Parmetros del mandato: -a -c -d -h Visualiza toda la informacin disponible. Visualiza resultados de bits de comprobacin y sumas de comprobacin. Visualiza informacin de las cabeceras de las pginas de datos de espacios de tabla DMS. Visualiza informacin de cabecera de soporte, incluyendo el nombre y la va de acceso de la imagen esperada por el programa de utilidad de restauracin. Visualiza la misma informacin que -h, pero slo lee la informacin de cabecera de soporte de 4 K desde el principio de la imagen. Esta opcin no valida la imagen.
-H
37
db2ckbkp - Comprobar copia de seguridad

Nota: Esta opcin no se puede utilizar en combinacin con ninguna otra opcin. -l -n -o Visualiza datos de cabecera de archivo de anotaciones cronolgicas. Solicita el montaje de la cinta. Se supone que es una cinta por dispositivo. Visualiza informacin detallada de las cabeceras de objetos.
nombre-archivo Nombre del archivo de imagen de copia de seguridad. Se pueden comprobar uno o varios archivos a la vez. Notas: 1. Si la copia de seguridad completa consta de mltiples objetos, la validacin slo ser satisfactoria si db2ckbkp se utiliza para validar todos los objetos al mismo tiempo. 2. Cuando se comprueban varias partes de una imagen, se debe especificar en primer lugar el primer objeto de imagen de copia de seguridad (.001). Ejemplos: Ejemplo 1 (en plataformas UNIX)
db2ckbkp SAMPLE.0.krodger.NODE0000.CATN0000.19990817150714.001 SAMPLE.0.krodger.NODE0000.CATN0000.19990817150714.002 SAMPLE.0.krodger.NODE0000.CATN0000.19990817150714.003 [1] Almacenamientos intermedios procesados: ## [2] Almacenamientos intermedios procesados: ## [3] Almacenamientos intermedios procesados: ## Verificacin de imagen completada - satisfactoria.
Ejemplo 2 (en plataformas Windows)

db2ckbkp SAMPLE.0\krodger\NODE0000\CATN0000\19990817\150714.001 SAMPLE.0\krodger\NODE0000\CATN0000\19990817\150714.002 SAMPLE.0\krodger\NODE0000\CATN0000\19990817\150714.003 [1] Almacenamientos intermedios procesados: ## [2] Almacenamientos intermedios procesados: ## [3] Almacenamientos intermedios procesados: ## Verificacin de imagen completada - satisfactoria.
Ejemplo 3
db2ckbkp -h SAMPLE2.0.krodger.NODE0000.CATN0000.19990818122909.001 ===================== CABECERA DE SOPORTE DE ALMACENAMIENTO ALCANZADA: ===================== Nombre base datos servidor -- SAMPLE2
38
Command Reference

Alias base datos servidor Alias base datos cliente Indicacin fecha y hora Nmero de particin de base de datos Instancia Nmero de secuencia ID release Nmero generador base de datos Pg. cdigos comentario BD (Volumen) Comentario BD (Volumen) Pg. cdigos comentario BD (Sistema) Comentario BD (Sistema) Valor de autentificacin Modalidad de copia de seguridad Tipo de copia de seguridad Gran. copia de seguridad Distintivos de estado Cats. sistema inc. Nm particin base datos de catlogo Conjunto de cdigos de BD Territorio de BD Tamao alm. interm. copia seguridad Nmero de sesiones Plataforma ------------------------SAMPLE2 SAMPLE2 19990818122909 0 krodger 1 900 65E0B395 0 0 255 0 0 0 11 1 0 ISO8859-1 4194304 1 0
El nombre de archivo de imagen correcto sera: SAMPLE2.0.krodger.NODE0000.CATN0000.19990818122909.001 [1] Almacenamientos intermedios procesados: #### Verificacin de imagen completada - satisfactoria.
Notas de uso: 1. Si una imagen de copia de seguridad se ha creado utilizando varias sesiones, db2ckbkp puede examinar todos los archivos al mismo tiempo. Los usuarios son responsables de asegurarse de que la sesin con el nmero de secuencia 001 sea el primer archivo especificado. 2. Este programa de utilidad tambin puede verificar las imgenes de copia de seguridad que se almacenan en cinta (salvo las imgenes que se han creado con un tamao de bloque variable). Esto se realiza preparando la cinta como para una operacin de restauracin y, a continuacin, ejecutando el programa de utilidad especificando el nombre de dispositivo de cinta. Por ejemplo, en sistemas basados en UNIX:
db2ckbkp -h /dev/rmt0
y en Windows:
db2ckbkp -d \\.\tape1
3. Si la imagen est en un dispositivo de cinta, especifique la va de acceso del dispositivo de cinta. Se le solicitar que se asegure que est montado, a menos que se proporcione la opcin -n. Si hay varias cintas, la primera
39

cinta debe montarse en la primera va de acceso de dispositivo que se proporciona. (Es la cinta que tiene la secuencia 001 en la cabecera). El valor por omisin cuando se detecta un dispositivo de cinta es solicitar al usuario que monte la cinta. En la solicitud, el usuario tiene la posibilidad de elegir. sta es la solicitud y las opciones disponibles: (donde el dispositivo I especificado est en la va de acceso de dispositivo /dev/rmt0)
Monte el soporte de origen en el dispositivo /dev/rmt0. Continuar(c), terminar slo este dispositivo(d) o cancelar anormalmente esta herra (c/d/t)
El usuario recibir una solicitud para cada dispositivo especificado y cuando el dispositivo llegue al final de la cinta. Informacin relacionada: v db2adutl - Mandato Trabajar con imgenes TSM archivadas en la pgina 9
40
Command Reference
db2ckmig - Herramienta de premigracin de base de datos db2ckmig -Mandato Herramienta de premigracin de base de datos
Verifica si una base de datos se puede migrar. Autorizacin: sysadm Conexin necesaria: Ninguna Sintaxis del mandato:
db2ckmig basedatos -e -l nombre-archivo -u idusuario -p contrasea
Parmetros del mandato: basedatos Especifica un nombre de alias de una base de datos a explorar. -e -l Especifica que se deben explorar todas las bases de datos locales catalogadas. Especifica un archivo de anotaciones cronolgicas para mantener una lista de los errores y avisos generados para la base de datos explorada. Especifica el ID de usuario del administrador del sistema. Especifica la contrasea del ID de usuario del administrador del sistema.
-u -p
Notas de uso: Para verificar el estado de una base de datos: 1. Conctese como propietario de la instancia. 2. Emita el mandato db2ckmig. 3. Compruebe el archivo de anotaciones cronolgicas. Nota: El archivo de anotaciones cronolgicas visualiza los errores que se producen cuando se ejecuta el mandato db2ckmig. Compruebe que la anotacin cronolgica est vaca antes de continuar con el proceso de migracin.
41
db2ckrst - Comprobar secuencia de imgenes de restauracin incremental db2ckrst - Mandato Comprobar secuencia de imgenes de restauracin incremental
Consulta el histrico de la base de datos y genera una lista de indicaciones de fecha y hora para las imgenes de copia de seguridad que se necesitan para una restauracin incremental. Tambin se genera una sintaxis de restauracin simplificada para una restauracin incremental manual. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2ckrst -d nombre basedatos -t indicfechahora -r database tablespace
-n
nombre espaciotabla
-h -u -?
Parmetros del mandato: -d nombre basedatos nombre-archivo Especifica el nombre de alias para la base de datos que se restaurar. -t indicfechahora Especifica la indicacin de fecha y hora para una imagen de copia de seguridad que se restaurar en incremento. -r Especifica el tipo de restauracin que se ejecutar. El valor por omisin es database. Nota: Si se elige tablespace y no se proporcionan nombres de espacio de tabla, el programa de utilidad busca en la entrada del histrico de la imagen especificada y utiliza los nombres de espacio de tabla que se listan para la restauracin. -n nombre espaciotabla Especifica el nombre de uno o ms espacios de tabla que se restaurarn.
42
Command Reference
db2ckrst - Comprobar secuencia de imgenes de restauracin incremental

Nota: Si se selecciona un tipo de restauracin database y se especifica una lista de nombres de espacios de tabla, el programa de utilidad continuar como una restauracin tablespace utilizando los nombres de espacio de tabla proporcionados. -h/-u/-? Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Ejemplos:
db2ckrst -d mr -t 20001015193455 -r database db2ckrst -d mr -t 20001015193455 -r tablespace db2ckrst -d mr -t 20001015193455 -r tablespace -n tbsp1 tbsp2 > db2 backup db mr Copia de seguridad satisfactoria. La indicacin de fecha y hora para esta imagen de copia de seguridad es : 20001016001426 > db2 backup db mr incremental Copia de seguridad satisfactoria. La indicacin de fecha y hora para esta imagen de copia de seguridad es : 20001016001445 > db2ckrst -d mr -t 20001016001445 Orden de restauracin sugerido para la imgenes utilizando la indicacin de fecha y hora 20001016001445 para database mr. =================================================================== db2 restore db mr incremental taken at 20001016001445 db2 restore db mr incremental taken at 20001016001426 db2 restore db mr incremental taken at 20001016001445 =================================================================== > db2ckrst -d mr -t 20001016001445 -r tablespace -n userspace1 Orden de restauracin sugerido para la imgenes utilizando la indicacin de fecha y hora 20001016001445 para database mr. =================================================================== db2 restore db mr tablespace ( USERSPACE1 ) incremental taken at 20001016001445 db2 restore db mr tablespace ( USERSPACE1 ) incremental taken at 20001016001426 db2 restore db mr tablespace ( USERSPACE1 ) incremental taken at 20001016001445 ===================================================================
Notas de uso: Para poder utilizar este programa de utilidad, el histrico de base de datos debe existir. Si el histrico de base de datos no existe, especifique la opcin HISTORY FILE en el mandato RESTORE utilizando este programa de utilidad.
43
db2ckrst - Comprobar secuencia de imgenes de restauracin incremental

Si se utiliza la opcin FORCE del mandato PRUNE HISTORY, puede suprimir las entradas necesarias para la restauracin incremental automtica de las bases de datos. Las restauraciones manuales seguirn funcionando correctamente. La utilizacin de este mandato tambin puede evitar que el programa de utilidad dbckrst pueda analizar correctamente la cadena completa de imgenes de copia de seguridad necesarias. La operacin por omisin del mandato PRUNE HISTORY evita que se supriman las entradas necesarias. Se recomienda no utilizar la opcin FORCE del mandato PRUNE HISTORY. Este programa de utilidad no debe utilizarse como sustituto para mantener registros de las copias de seguridad.
44
Command Reference
db2cli - CLI interactiva de DB2 db2cli -Mandato CLI interactiva de DB2

Arranca el entorno de Call Level Interface (Interfaz de nivel de llamada) interactiva para el diseo y la creacin de prototipos en la CLI. Se encuentra en el subdirectorio sqllib/samples/cli/ del directorio inicial del propietario de la instancia de base de datos. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2cli
Parmetros del mandato: Ninguno Notas de uso: La CLI interactiva de DB2 consta de un conjunto de mandatos que se pueden utilizar para disear, crear prototipos y probar llamadas de funcin CLI. Es una herramienta de prueba de los programadores que se proporciona para comodidad de quienes deseen utilizarla e IBM no proporciona garantas respecto a su rendimiento. La CLI interactiva de DB2 no est destinada a los usuarios finales y, por consiguiente, no tiene muchas posibilidades de comprobacin de errores. Se soportan dos tipos de mandatos: Mandatos de CLI Mandatos que corresponden a (y tienen el mismo nombre que) cada una de las llamadas de funcin soportadas por la CLI de IBM Mandatos de soporte Mandatos que no tienen una funcin CLI equivalente. Los mandatos pueden emitirse de forma interactiva o desde dentro de un archivo. Asimismo, la salida del mandato puede visualizarse en el terminal o grabarse en un archivo. Una caracterstica til del controlador de mandatos de CLI es la posibilidad de capturar todos los mandatos que se entran durante una sesin y grabarlos en un archivo, creando de este modo un script de mandatos que se puede volver a ejecutar posteriormente.
45
db2cmd - Abrir ventana de mandato DB2 db2cmd -Mandato Abrir ventana de mandato DB2
Abre la ventana de DB2 habilitada para CLP e inicializa el entorno de lnea de mandatos de DB2. La emisin de este mandato equivale a pulsar el icono Ventana de mandatos DB2. Este mandato slo est disponible en Windows. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2cmd -c -w -i -t
Parmetros del mandato: -c Ejecuta el mandato y, a continuacin, termina. Por ejemplo, db2cmd /c dir hace que se invoque el mandato dir en una ventana de mandato y, a continuacin, la ventana de mandato se cierra. Espera hasta que termina el proceso cmd.exe. Por ejemplo, db2cmd /c /w dir invoca el mandato dir y db2cmd.exe no termina hasta que se cierra la ventana de mandato. Ejecuta la ventana de mandato, compartiendo la misma consola y heredando los mismos descriptores de archivo. Por ejemplo, db2cmd /c /w /i db2 get dbm cfg > misalida invoca cmd.exe para ejecutar el mandato db2 y esperar a que termine. No se asigna una consola nueva y la salida estndar se dirige al archivo misalida. En lugar de utilizar DB2 CLP como ttulo de la ventana de mandato, hereda el ttulo de la ventana que realiza la invocacin. Esto es til si, por ejemplo, se desea configurar un icono con un ttulo diferente que invoque db2cmd /t.
-w
-i
-t
Nota: Deben aparecer todos los conmutadores antes de los mandatos que se van a ejecutar. Por ejemplo: db2cmd /t db2.
46
Command Reference
db2cmd - Abrir ventana de mandato DB2

Notas de uso: Si se devuelve DB21061E (Entorno de lnea de mandatos no inicializado.) al arrancar la ventana de DB2 habilitada para CLP o al ejecutar mandatos CLP en Windows 98, puede que el sistema operativo est agotando el espacio de entorno. Compruebe en el archivo config.sys el parmetro de configuracin de entorno SHELL y aumente su valor como corresponda. Por ejemplo:
SHELL=C:\COMMAND.COM C:\ /P /E:32768
47
db2dart - Herramientas de informes y anlisis de base de datos Mandato db2dart - Herramienta de informes y anlisis de base de datos
Examina las bases de datos para comprobar si su estructura arquitectnica es correcta e informa acerca de los errores encontrados. Autorizacin: sysadm Conexin necesaria: Ninguna. db2dart se debe ejecutar sin usuarios conectados a la base de datos. Sintaxis del mandato:
db2dart nombre-base-datos accin opciones
Parmetros del mandato: Acciones de inspeccin /DB /T /TSF /TSC /TS Inspecciona toda la base de datos. Es la opcin por omisin. Inspecciona una sola tabla. Requiere dos valores de entrada: un ID de espacio de tabla y el ID de objeto de tabla o el nombre de tabla. Inspecciona slo los contenedores y archivos de espacios de tabla. Inspecciona una construccin de espacio de tabla, pero no sus tablas. Requiere un valor de entrada: ID de espacio de tabla. Inspecciona un solo especio de tabla y sus tablas. Requiere un valor de entrada: ID de espacio de tabla.
/ATSC Inspecciona las construcciones de todos los espacios de tabla, pero no sus tablas. Acciones de formateado de datos /DD Vuelva datos de tabla sin formato. Requiere cinco valores de entrada: un ID de objeto de tabla o nombre de tabla, ID de espacio de tabla, nmero de pgina con la que empezar, nmero de pginas y seleccin verbosa. Vuelca datos de ndice con formato. Requiere cinco valores de entrada: un ID de objeto de tabla o nombre de tabla, ID de espacio de tabla, nmero de pgina con la que empezar, nmero de pginas y seleccin verbosa. Vuelca datos de correlacin de bloques con formato. Requiere cinco
/DI
/DM
48
Command Reference
db2dart - Herramientas de informes y anlisis de base de datos

valores de entrada: un ID de objeto de tabla o nombre de tabla, ID de espacio de tabla, nmero de pgina con la que empezar, nmero de pginas y seleccin verbosa. /DP Vuelca pginas en formato hexadecimal. Requiere tres valores de entrada: ID de espacio de tabla DMS, nmero de pgina con la que empezar y nmero de pginas.
/DTSF Vuelca informacin de archivo de espacio de tabla con formato. /DEMP Vuelca informacin EMP con formato para una tabla DMS. Requiere dos valores de entrada: ID de espacio de tabla y el ID de objeto de tabla o nombre de tabla. /DDEL Vuelca datos de tabla con formato en formato ASCII delimitado. Requiere cuatro valores de entrada: un ID de objeto de tabla o nombre de tabla, ID de espacio de tabla, nmero de pgina con la que empezar y nmero de pginas. /DHWM Vuelca la informacin de lmite superior. Requiere un valor de entrada: ID de espacio de tabla. /LHWM Sugiere maneras de disminuir el lmite superior. Requiere dos valores de entrada: ID de espacio de tabla y nmero de pginas. Reparar acciones /ETS /MI Ampla el lmite de tabla en un espacio de tabla de 4 KB (slo DMS), si es posible. Requiere un valor de entrada: ID de espacio de tabla. Marque el ndice como no vlido. Cuando se especifica este parmetro, la base de datos debe estar fuera de lnea. Requiere dos valores de entrada: ID de espacio de tabla e ID de objeto de tabla Marca la tabla con estado Descartar pendiente. Cuando se especifica este parmetro, la base de datos debe estar fuera de lnea. Requiere tres valores de entrada: ID de espacio de tabla, ID de objeto de tabla o nombre de tabla y contrasea. Inicializa la pgina de datos de una tabla como vaca. Cuando se especifica este parmetro, la base de datos debe estar fuera de lnea. Requiere cinco valores de entrada: nombre de tabla o ID de objeto de tabla, ID de espacio de tabla, nmero de pgina con la que empezar, nmero de pginas y contrasea.
/MT
/IP
49

Cambiar acciones de estado /CHST Cambia el estado de una base de datos. Cuando se especifica este parmetro, la base de datos debe estar fuera de lnea. Requiere un valor de entrada: estado Copia de seguridad de base de datos pendiente. Ayuda /H Visualiza informacin de ayuda.
Opciones de valores de entrada /OI id-objecto Especifica el ID de objeto. /TN nombre-tabla Especifica el nombre de tabla. /TSI id-espacio-tabla Especifica el ID de espacio de tabla. /ROW suma Identifica si se deben comprobar los descriptores de campos largos, los descriptores de LOB y la informacin de control. Puede especificar una opcin y aadir los valores para especificar ms de una opcin. 1 2 Comprueba la informacin de control por filas. Comprueba los descriptores de campos largos y de LOB.
/PW contrasea Contrasea necesaria para ejecutar la accin db2dart. Pngase en contacto con el Servicio de DB2 para una contrasea vlida. /RPT va-acceso Va de acceso opcional para el archivo de salida de informe. /RPTN nombre-archivo Nombre opcional para el archivo de salida de informe. /PS nmero Especifica el nmero de pgina con el que empezar. Nota: El nmero de pgina debe tener el sufijo p para relacin de agrupacin. /NP nmero Especifica el nmero de pginas.
50
Command Reference

/V opcin Especifica si se debe implementar la opcin verbosa. Los valores vlidos son: Y N Especifica que se debe implementar la modalidad verbosa. Especifica que no se debe implementar la modalidad verbosa.
option /SCR Especifica el tipo de salida de pantalla, si existe. Los valores vlidos son: Y M N Se produce una salida normal de pantalla. Se produce una salida minimizada de pantalla. No se produce salida de pantalla.
/RPTF opcin Especifica el tipo de salida de archivo de informe, si existe. Los valores vlidos son: Y E N Se produce una salida normal de informe. Se produce slo informacin de errror en el archivo de informe. No se produce ninguna salida de archivo de informe.
/ERR opcin Especifica el tipo de registro que se produce en DART.INF, si existe. Los valores vlidos son: Y N E Produce un registro normal en el archivo DART.INF. Minimiza la salida al archivo de registro DART.INF. Minimina el archivo DART.INF y la salida de pantalla. Slo se enva informacin de error al archivo de informe.
/WHAT DBBP opcin Especifica el estado Copia de seguridad de base de datos pendiente. Los valores vlidos son: OFF ON Notas de uso: Cuando se invoca el mandato db2dart, puede especificar slo una accin. Es posible que una accin soporte un nmero variable de opciones. Estado desactivado. Estado activado.
51

Si no especifica todos los valores de entrada necesarios cuando invoque el mandato db2dart, se le solicitarn los valores. Para las acciones /DDEL y /IP, no se pueden especificar las opciones desde la lnea de mandatos y se deben entrar cuando db2dart lo solicite. Todas las opciones /ROW, /RPT, /RPTN, /SCR, /RPTF, /ERR y /WHAT DBBP se pueden invocar adems de la accin. Ninguna de las acciones las necesitan. Informacin relacionada: v rah and db2_all command descriptions del manual Administration Guide: Implementation
52
Command Reference
db2dclgn - Generador de declaraciones db2dclgn -Mandato Generador de declaraciones

Genera declaraciones para una tabla de base de datos especificada, eliminando la necesidad de consultar dichas declaraciones en la documentacin. Las declaraciones generadas pueden modificarse como sea necesario. Los lenguajes de sistema principal soportados son C/C++, COBOL, JAVA y FORTRAN. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2dclgn -d
nombre-base-datos -t
nombre-tabla opcin
Parmetros del mandato: -d nombre-base-datos Especifica el nombre de la base de datos con la que debe establecerse una conexin. -t nombre-tabla Especifica el nombre de la tabla de la que debe recuperarse informacin de columna para generar declaraciones. opcin Una o varias de las siguientes: -a accin Especifica si las declaraciones se deben aadir o sustituir. Los valores vlidos son ADD y REPLACE. El valor por omisin es ADD. -b tipo-var-lob Especifica el tipo de variable que se debe generar para una columna LOB. Los valores vlidos son: LOB (valor por omisin) Por ejemplo, en C, SQL TYPE es CLOB(5K) x. LOCATOR Por ejemplo, en C, SQL TYPE es CLOB_LOCATOR x. FILE Por ejemplo, en C, SQL TYPE es CLOB_FILE x.
53
db2dclgn - Generador de declaraciones

-c Especifica si el nombre de columna debe utilizarse como sufijo en el nombre de campo cuando se especifica un prefijo (-n). Si no se especifica ningn prefijo, se ignora esta opcin. El comportamiento por omisin es no utilizar el nombre de columna como sufijo, sino utilizar en su lugar el nmero de columna, que empieza en 1. Especifica si deben generarse variables de indicador. Dado que las estructuras de sistema principal se soportan en C y COBOL, se genera una tabla de indicadores de un tamao igual al nmero de columnas, mientras que para JAVA y FORTRAN, se generan variables de indicadores individuales para cada columna. Los nombres de la tabla de indicadores y la variable son iguales que el nombre de tabla y el nombre de columna, respectivamente, con el prefijo IND- (para COBOL) o ind_ (para los dems lenguajes). El comportamiento por omisin es no generar variables de indicadores.
-i
-l lenguaje Especifica el lenguaje de sistema principal en el que deben generarse las declaraciones. Los valores vlidos son C, COBOL, JAVA y FORTRAN. El comportamiento por omisin es generar declaraciones en C, que tambin son vlidas para C++. -n nombre Especifica un prefijo para cada uno de los nombres de campo. Se debe especificar un prefijo si se utiliza la opcin -c. Si no se especifica, se utiliza el nombre de columna como nombre de campo. -o archivo-salida Especifica el nombre del archivo de salida para las declaraciones. El comportamiento por omisin es utilizar el nombre de tabla como nombre de archivo base, con una extensin que refleje el lenguaje de sistema principal generado:
.h para C .cbl para COBOL .java para JAVA .f para FORTRAN (UNIX) .for para FORTRAN (INTEL)
-p contrasea Especifica la contrasea que se debe utilizar para conectarse a la base de datos. Se debe especificar si se especifica un ID de usuario. El comportamiento por omisin es no proporcionar ninguna contrasea al establecer una conexin.
54
Command Reference
db2dclgn - Generador de declaraciones

-r observaciones Especifica si se deben utilizar observaciones de columna, si estn disponibles, como comentarios en las declaraciones, para proporcionar descripciones ms detalladas de los campos. -s nombre-estructura Especifica el nombre de estructura que se debe generar para agrupar todos los campos en las declaraciones. El valor por omisin es utilizar el nombre de tabla no calificado. -u idusuario Especifica el ID de usuario a utilizar para conectarse a la base de datos. Se debe especificar si se especifica una contrasea. El comportamiento por omisin es no proporcionar ningn ID de usuario al establecer una conexin. -v Especifica si se debe visualizar el estado (por ejemplo, el estado de la conexin) del programa de utilidad. El comportamiento por omisin es visualizar slo mensajes de error.
-w tipo-var-DBCS Especifica si se debe utilizar sqldbchar o wchar_t para una columna GRAPHIC/VARGRAPHIC/DBCLOB en C. -y smbolo-DBCS Especifica si se debe utilizar G o N como smbolo DBCS en COBOL. -z codificacin Especifica la codificacin del convenio de codificacin de acuerdo al servidor especfico. La codificacin puede ser UDB u OS390. Si se especificara OS390, el archivo generado parecera idntico a un archivo generado por OS390.
55
db2drdat - Rastreo DRDA Mandato db2drdat - Rastreo DRDA

Permite al usuario capturar la corriente de datos DRDA intercambiada entre el AR (Application Requestor - Peticionario de aplicaciones) DRDA y el AS (Application Server - Servidor de aplicaciones) DRDA DB2 UDB. Aunque esta herramienta se utiliza ms comnmente para la determinacin de problemas, determinando cuntos envos y cuntas recepciones son necesarias para ejecutar una aplicacin, tambin se puede utilizar para el ajuste de rendimiento en un entorno de cliente/servidor. Autorizacin: Ninguna Sintaxis del mandato:
on db2drdat -r -s -c -i off -t=archivo-rastreo -p=pid -l=longitud
Parmetros del mandato: on off -r -s -c Activa los sucesos de rastreo AS (todos, si no se especifica ninguno). Desactiva los sucesos de rastreo AS. Rastrea las peticiones DRDA recibidas del AR DRDA. Rastrea las respuestas DRDA enviadas al AR DRDA. Rastrea la SQLCA recibida del servidor DRDA en el sistema principal. Se trata de una versin formateada fcil de leer de las SQLCA no nulas. Incluye indicaciones de fecha y hora en la informacin de rastreo. Especifica el tamao del almacenamiento intermedio utilizado para almacenar la informacin de rastreo. Slo rastrea los sucesos para este proceso. Si no se especifica -p, se rastrean todos los agentes con conexiones DRDA de entrada en el servidor. Nota: El pid que se debe rastrear puede encontrarse en el campo agente devuelto por el mandato LIST APPLICATIONS.
-i -l -p
56
Command Reference
db2drdat - Rastreo DRDA

-t Especifica el destino del rastreo. Si se especifica un nombre de archivo sin una va de acceso completa, la informacin que falta se toma de la va de acceso actual. Nota: Si no se especifica archivo-rastreo, los mensajes se dirigen a db2drdat.dmp en el directorio actual. Notas de uso: No emita mandatos db2trc mientras db2drdat est activo. db2drdat graba la informacin siguiente en archivo-rastreo: 1. -r v Tipo de peticin DRDA v Recibir almacenamiento intermedio. 2. -s v Tipo de respuesta/objeto DRDA v Enviar almacenamiento intermedio. 3. Informacin de error de CPI-C v Gravedad v Protocolo utilizado v v v v API utilizada Nombre de LU local Funcin CPI-C anmala Cdigo de retorno de CPI-C.
El mandato devuelve un cdigo de salida. Un valor de cero indica que el mandato se ha completado satisfactoriamente y un valor distinto de cero indica que el mandato no ha sido satisfactorio. Nota: Si db2drdat enva la salida a un archivo que ya existe, se borrar el archivo anterior a no ser que los permisos del archivo no permitan que se borre, en cuyo caso el sistema operativo devolver un error. Informacin relacionada: v Mandato LIST APPLICATIONS en la pgina 435
57
db2empfa - Habilitar la asignacin de archivos de mltiples pginas db2empfa -Mandato Habilitar la asignacin de archivos de mltiples pginas
Habilita el uso de la asignacin de archivos de mltiples pginas para una base de datos. Con la asignacin de archivos de mltiples pginas habilitada para espacios de tabla SMS, al espacio de disco se le asigna una extensin en lugar de una pgina a la vez. mbito: Este mandato slo afecta a la particin de base de datos en la que se ejecuta. Autorizacin: sysadm Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2empfa alias-base-datos
Parmetros del mandato: alias-base-datos Especifica el alias de la base de datos para la que ha de habilitarse la asignacin de archivos de mltiples pginas. Notas de uso: Este programa de utilidad: v Conecta con la particin de base de datos (donde sea aplicable) en modalidad exclusiva v En todos los espacios de tabla SMS, asigna pginas vacas para llenar la ltima extensin en todos los archivos de datos e ndices que tienen un tamao que supera una extensin v Cambia el valor del parmetro de configuracin de base de datos multipage_alloc a YES v Desconecta. Dado que db2empfa conecta con la particin de base de datos en modalidad exclusiva, no se puede ejecutar simultneamente en la particin de base de datos de catlogo ni en ninguna otra particin de base de datos.
58
Command Reference
db2eva - Analizador de sucesos db2eva -Mandato Analizador de sucesos

Inicia el analizador de sucesos, lo que permite al usuario rastrear los datos de rendimiento producidos por los supervisores de sucesos DB2 cuyos datos estn dirigidos a tablas. Autorizacin: El Analizador de sucesos lee los datos de las tablas de supervisor de sucesos almacenadas con la base de datos. Por este motivo, debe tener la siguiente autorizacin para acceder a estos datos: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Conexin a bases de datos Sintaxis del mandato:
db2eva -db alias-base-datos -evm nombre-supervisor-sucesos
Parmetros del mandato: Nota: Los parmetros de db2eva son opcionales. Si no especifica parmetros, aparecer el recuadro de dilogo Abrir analizador de sucesos para solicitarle el nombre de la base de datos y del supervisor de sucesos. -db alias-base-datos Especifica el nombre de la base de datos definida para el supervisor de sucesos. -evm nombre-supervisor-sucesos Especifica el nombre del supervisor de sucesos cuyos rastreos deben analizarse. Notas de uso: Si el usuario carece del acceso necesario, no podr recuperar los datos del supervisor de sucesos. Hay dos mtodos para recuperar los rastreos del supervisor de sucesos:
59
db2eva - Analizador de sucesos

1. El usuario puede entrar db2eva en la lnea de mandatos y el recuadro de dilogo Abrir Analizador de sucesos se abrir para permitirle elegir los nombres de la base de datos y del supervisor de sucesos en las listas desplegables, antes de pulsar Aceptar para abrir el recuadro de dilogo Analizador de sucesos. 2. El usuario puede especificar los parmetros -db y -evm desde la lnea de mandatos y el dilogo Analizador de sucesos se abrir en la base de datos especificada. El analizador de sucesos conecta con la base de datos y emite un mandato de seleccin de destino de SYSIBM.SYSEVENTTABLES para obtener las tablas del supervisor de sucesos. La conexin queda liberada una vez que se han recuperado los datos necesarios. Nota: El analizador de sucesos puede utilizarse para analizar los datos producidos por un supervisor de sucesos activo. No obstante, es posible que no se muestre un supervisor de sucesos capturado despus de haberse invocado el analizador de sucesos. Desactive el supervisor de sucesos antes de invocar al Analizador de sucesos para asegurarse de que los datos se visualicen correctamente.
60
Command Reference
db2evmon - Herramienta de productividad del supervisor de sucesos db2evmon -Mandato Herramienta de productividad del supervisor de sucesos
Formatea la salida del rea de interconexin con nombre y del archivo de supervisor de sucesos y la graba en la salida estndar. Autorizacin: Ninguna, a no ser que se est conectando con la base de datos (-evm, -db,); en ese caso, se necesita una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Ninguna Sintaxis del mandato:
db2evmon -db alias-base-datos -evm nombre-supervisor-sucesos -path destino-supervisor-sucesos
Parmetros del mandato: -db alias-base-datos Especifica la base de datos cuyos datos deben visualizarse. Este parmetro es sensible a las maysculas y minsculas. -evm nombre-supervisor-sucesos Nombre de una sola parte del supervisor de sucesos. Identificador normal o delimitado de SQL. Este parmetro es sensible a las maysculas y minsculas. -path destino-supervisor-sucesos Especifica el directorio que contiene los archivos de rastreo del supervisor de sucesos. Notas de uso: Si se estn grabando los datos en archivos, la herramienta formatea los archivos para su visualizacin utilizando la salida estndar. En este caso, el supervisor se activa primero y la herramienta visualiza los datos de sucesos de los archivos. Para ver los datos grabados en los archivos despus de que se haya ejecutado la herramienta, vuelva a emitir db2evmon.
61
db2evmon - Herramienta de productividad del supervisor de sucesos

Si los datos se estn grabando en un rea de interconexin, la herramienta formatea la salida para su visualizacin utilizando la salida estndar a medida que se producen los sucesos. En este caso, la herramienta se inicia antes de que se active el supervisor.
62
Command Reference
db2evtbl - Generar definiciones de tabla de destino del supervisor de sucesos db2evtbl -Mandato Generar definiciones de tabla de destino del supervisor de sucesos
Genera sentencias CREATE EVENT MONITOR de SQL que pueden utilizarse al definir supervisores de sucesos que escriben en tablas SQL. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
, db2evtbl -schema nombre -evm Nombregsuc tipo de suceso
Parmetros del mandato: -schema Nombre de esquema. Si no se especifica, los nombres de tabla no se califican. -evm Nombre del supervisor de sucesos.
tipo de suceso Cualquiera de los tipos de suceso disponibles en la sentencia CREATE EVENT MONITOR, por ejemplo, DATABASE, TABLES, TRANSACTIONS. Ejemplos:
db2evtbl -schema smith -evm foo basedatos, tablas, espaciostabla, agrupacionesalmint
Notas de uso: La salida se escribe en la salida estndar. Definir supervisores de sucesos WRITE TO TABLE es una accin ms directa cuando se utiliza la herramienta db2evtbl. Por ejemplo, se pueden seguir los pasos siguientes para definir y activar un supervisor de sucesos. 1. Utilice db2evtbl para generar la sentencia CREATE EVENT MONITOR. 2. Edite la sentencia SQL, eliminando las columnas no deseadas.
63
db2evtbl - Generar definiciones de tabla de destino del supervisor de sucesos

3. Utilice el CLP para procesar la sentencia de SQL. (Cuando se est ejecutando la sentencia CREATE EVENT MONITOR, se crean las tablas de destino.) 4. Emita SET EVENT MONITOR para activar el nuevo supervisor de sucesos. Dado que se pueden desechar todos los sucesos distintos de los supervisores de sucesos de punto muerto, creando ms de un registro por suceso, los usuarios que no utilicen la sentencia FLUSH EVENT MONITOR pueden dejar el elemento evmon_flushes fuera de cualquier tabla de destino.
64
Command Reference
db2exfmt - Herramienta de formato de tabla de explicacin db2exfmt -Mandato Herramienta de formato de tabla de explicacin
Formatea el contenido de las tablas de explicacin. Para obtener una descripcin completa de este mandato, consulte la publicacin Administration Guide. Conceptos relacionados: v db2exfmt - Explain table-format tool del manual Administration Guide: Performance Informacin relacionada: v db2expln -Mandato Herramienta de explicacin SQL de DB2 en la pgina 66
65
db2expln - Herramienta de explicacin SQL de DB2 db2expln -Mandato Herramienta de explicacin SQL de DB2
Describe la seleccin de plan de acceso para las sentencias de SQL estticas de los paquetes que estn almacenados en los catlogos de sistema servidor comunes de DB2. Dando un nombre de base de datos, un nombre de paquete, un creador de paquete y un nmero de seccin, la herramienta interpreta y describe la informacin de estos catlogos. Conceptos relacionados: v db2expln syntax and parameters del manual Administration Guide: Performance Informacin relacionada: v db2exfmt -Mandato Herramienta de formato de tabla de explicacin en la pgina 65
66
Command Reference
db2flsn - Buscar nmero de secuencia de anotacin cronolgica db2flsn - Mandato Buscar nmero de secuencia de anotacin cronolgica
Devuelve el nombre del archivo que contiene el registro de anotacin cronolgica identificado por un nmero de secuencia de anotacin cronolgica (LSN) especificado. Autorizacin: Ninguna Sintaxis del mandato:
db2flsn -q LSN_entrada
Parmetros del mandato: -q Especifica que se imprima solamente el nombre del archivo de anotaciones cronolgicas. No se imprimir ningn mensaje de error o aviso y el estado slo puede determinarse mediante el cdigo de retorno. Los cdigos de error vlidos son: v v v v v -100 -101 -102 -103 -104 Entrada no vlida No se puede abrir el archivo LFH No se ha podido leer el archivo LFH LFH no vlido La base de datos no es recuperable
v -105 LSN demasiado grande v -500 Error lgico. Otros cdigos de retorno vlidos son: v 0 Ejecucin satisfactoria v 99 Aviso: el resultado se basa en el ltimo tamao conocido del archivo de anotaciones cronolgicas. LSN_entrada Serie de 12 bytes que representa el valor hexadecimal (6 bytes) interno con ceros iniciales. Ejemplos:
db2flsn 000000BF0030 El LSN proporcionado est contenido en el archivo de anotaciones cronolgicas S0000002.LOG db2flsn -q 000000BF0030 S0000002.LOG
67
db2flsn - Buscar nmero de secuencia de anotacin cronolgica

db2flsn 000000BE0030 Aviso: el resultado se basa en el ltimo tamao conocido del archivo de anotaciones cronolgicas. El ltimo tamao conocido del archivo de anotaciones cronolgicas es de 23 pginas de 4 K empezando desde la extensin de anotacin cronolgica 2. El LSN proporcionado est contenido en el archivo de anotaciones cronolgicas S0000001.LOG db2flsn -q 000000BE0030 S0000001.LOG
Notas de uso: El archivo de control de cabecera de anotacin cronolgica SQLOGCTL.LFH debe residir en el directorio actual. Dado que este archivo est ubicado en el directorio de base de datos, se puede ejecutar la herramienta desde el directorio de base de datos o se puede copiar el archivo de control en el directorio desde el que se ejecutar la herramienta. La herramienta utiliza el parmetro de configuracin de base de datos logfilsiz. DB2 registra los tres valores ms recientes de este parmetro y el primer archivo de anotaciones cronolgicas que se crea con cada valor de logfilsiz; esto permite a la herramienta funcionar correctamente cuando se cambia logfilsiz. Si el LSN especificado tiene una fecha anterior al valor de logfilsiz registrado en primer lugar, la herramienta utiliza este valor y devuelve un aviso. La herramienta puede utilizarse con gestores de bases de datos anteriores a UDB Versin 5.2; en este caso, se devuelve el aviso incluso con un resultado correcto (obtenido si el valor logfilsiz permanece sin modificaciones). Esta herramienta slo se puede utilizar con bases de datos recuperables. Una base de datos es recuperable si est configurada con logretain establecido en RECOVERY o userexit establecido en ON.
68
Command Reference
db2fm - Supervisor de anomalas de DB2 db2fm - Mandato Supervisor de anomalas de DB2

Controla el daemon del supervisor de anomalas de DB2. Puede utilizar db2fm para configurar el supervisor de anomalas. Autorizacin: Autorizacin para la instancia en la que est ejecutando el mandato. Conexin necesaria: Ninguna. Sintaxis del mandato:
db2fm -t -i servicio instancia -m va de acceso de mdulo
-u -d -s -k -U -D -S -K -f -a -T -l -R -n -h -?
on off on off T1/T2 I1/I2 R1/R2 correo electrnico
Parmetros del mandato: -m va-mdulo Define la va de acceso completa de la biblioteca compartida del supervisor de anomalas para el producto que se est supervisando. El valor por omisin es $INSTANCEHOME/sqllib/lib/libdb2gcf. -t servicio Proporciona el descriptor de texto exclusivo para un servicio. -i instancia Define la instancia del servicio. -u Conecta el servicio.
69
db2fm - Supervisor de anomalas de DB2

-U -d -D -k -K -s -S Conecta el daemon del supervisor de anomalas. Desconecta el servicio. Desconecta el daemon del supervisor de anomalas. Interrumpe el servicio. Interrumpe el daemon del supervisor de anomalas. Devuelve el estado del servicio. Devuelve el estado del daemon del supervisor de anomalas. Nota: el estado del servicio o del supervisor de anomalas puede ser uno de los siguientes v No instalado correctamente, v INSTALADO CORRECTAMENTE, pero NO ACTIVO, v ACTIVO pero NO DISPONIBLE (mantenimiento), v DISPONIBLE, o v DESCONOCIDO -f on|off Conecta o desconecta el supervisor de anomalas. Nota: Si esta opcin est desconectada, el daemon del supervisor de anomalas no se iniciar, o el daemon saldr si se est ejecutando. -a on|off Activa o desactiva la supervisin de anomalas. Nota: Si esta opcin est desactivada, el supervisor de anomalas no estar supervisando activamente, lo que quiere decir que, si el servicio se desactiva, no intentar volver a ponerlo en marcha. -T T1/T2 Escribe encima del tiempo de espera de inicio y de detencin. Por ejemplo: v -T 15/10 actualiza los dos tiempos de espera respectivamente v -T 15 actualiza el tiempo de espera de inicio a 15 segundos v -T /10 actualiza el tiempo de espera de detencin a 10 segundos -I I1/I2 Define el intervalo y el tiempo de espera del estado respectivamente. -R R1/R2 Define el nmero de reintentos del mtodo y la accin de estado antes de abandonar.
70
Command Reference
db2fm - Supervisor de anomalas de DB2

-n correo electrnico Define la direccin de correo electrnico para la notificacin de sucesos. -h -? Imprime el uso. Imprime el uso.
Notas de uso: 1. Este mandato slo puede utilizarse en las plataformas UNIX.
71
db2gncol - Actualizar valores de columna generados db2gncol -Mandato Actualizar valores de columna generados
Actualiza las columnas generadas en las tablas que estn en modalidad pendiente de comprobacin y tienen un espacio de anotacin cronolgica limitado. Esta herramienta se utiliza como preparacin para una sentencia SET INTEGRITY en una tabla que tiene columnas generadas mediante expresiones. Autorizacin: Una de las siguientes v sysadm v dbadm Sintaxis del mandato:
db2gncol -d -c basedatos -s nombre_esquema -t nombre_tabla
cuenta_compromisos -u idusuario -p contrasea -h
Parmetros del mandato: -d basedatos Especifica un nombre de alias para la base de datos en la que se ubica la tabla. -s nombre_esquema Especifica el nombre de esquema para la tabla. El nombre de esquema es sensible a las maysculas y minsculas. -t nombre_tabla Especifica la tabla para la que se calculan los nuevos valores de columna generados por las expresiones. El nombre de tabla es sensible a las maysculas y minsculas. -c cuenta_compromisos Especifica el nmero de filas actualizadas entre compromisos. Este parmetro influye en el tamao del espacio de anotacin cronolgica necesario para generar los valores de columna. -u idusuario Especifica un ID de usuario con privilegios de administrador del sistema o administrador de base de datos. Si se omite esta opcin, se utiliza el usuario actual. -pcontrasea Especifica la contrasea para el ID de usuario especificado.
72
Command Reference
db2gncol - Actualizar valores de columna generados

-h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
Notas de uso: La utilizacin de esta herramienta en lugar de la opcin FORCE GENERATED de la sentencia SET INTEGRITY puede ser necesaria si una tabla es grande y existen las condiciones siguientes: v Deben generarse todos los valores de columna despus de modificar la expresin de generacin de una columna generada. v Se ha cambiado una UDF externa utilizada en una columna generada, lo cual ha hecho que cambien muchos valores de columna. v Se ha aadido una columna generada a la tabla. v Se ha realizado una carga grande o una adicin de carga en la que no se han proporcionado los valores para las columnas generadas. v El espacio de anotacin cronolgica es demasiado pequeo debido a transacciones simultnea de ejecucin larga o al tamao de la tabla. Esta herramienta volver a generar todos los valores de columna que se han creado basndose en las expresiones. Mientras se actualiza la tabla, se realizan compromisos intermitentes para evitar agotar todo el espacio de anotacin cronolgica. Despus de ejecutar db2gncol, la tabla puede sacarse de la modalidad de pendiente de comprobacin utilizando la sentencia SET INTEGRITY.
73
db2gov - Rutina de gobierno de DB2 db2gov -Mandato Rutina de gobierno de DB2

Supervisa y cambia el comportamiento de las aplicaciones que se ejecutan en una base de datos. Por omisin, se inicia un daemon en cada particin de base de datos, pero se puede utilizar el programa de utilidad frontal para iniciar un solo daemon en una particin de base de datos especfica. Para obtener ms informacin acerca de este mandato, consulte la publicacin Administration Guide. Autorizacin: Una de las siguientes: v sysadm v sysctrl Sintaxis del mandato:
db2gov START basedatos DBPARTITIONNUM nmero-particin-bd STOP basedatos DBPARTITIONNUM nmero-particin-bd archivo-config archivo-anot
Parmetros del mandato: START basedatos Inicia el daemon de rutina de gobierno para supervisar la base de datos especificada. Se puede especificar el nombre de la base de datos o el alias de la misma. El nombre especificado debe ser el mismo que el especificado en el archivo de configuracin de rutina de gobierno. Nota: Se ejecuta un daemon para cada base de datos que se est supervisando. En un entorno de base de datos particionada, se ejecuta un daemon para cada particin de la base de datos. Si la rutina de gobierno se ejecuta para ms de una base de datos, habr ms de un daemon ejecutndose en ese servidor de base de datos. DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos en la que se debe iniciar o detener el daemon de rutina de gobierno. El nmero especificado debe ser el mismo que el especificado en el archivo de configuracin de particin de base de datos. archivo-config Especifica el archivo de configuracin que se debe utilizar al supervisar la base de datos. La ubicacin por omisin para el archivo
74
Command Reference
db2gov - Rutina de gobierno de DB2

de configuracin es el directorio sqllib. Si el archivo especificado no se encuentra en dicho directorio, el componente frontal supone que el nombre especificado es el nombre completo del archivo. archivo-anot Especifica el nombre base del archivo en el que la rutina de gobierno graba los registros de anotacin cronolgica. El archivo de anotaciones cronolgicas se almacena en el subdirectorio de anotaciones cronolgicas del directorio sqllib. El nmero de particiones de base de datos en las que se ejecuta la rutina de gobierno se aade automticamente al nombre de archivo de anotaciones cronolgicas. Por ejemplo, mianotacion.0, mianotacion.1, mianotacion.2. STOP basedatos Detiene el daemon de rutina de gobierno que est supervisando la base de datos especificada. En un entorno de base de datos particionada, el programa de utilidad frontal detiene la rutina de gobierno en todas las particiones de base de datos leyendo el archivo de configuracin de particin de base de datos db2nodes.cfg. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODENUM puede sustituirse por DBPARTITIONNUM.
75
db2govlg - Consulta de anotacin cronolgica de rutina de gobierno de DB2 db2govlg -Mandato Consulta de anotacin cronolgica de rutina de gobierno de DB2
Extrae los registros del tipo especificado de los archivos de anotaciones cronolgicas de rutina de gobierno. La rutina de gobierno de DB2 supervisa y cambia el comportamiento de las aplicaciones que se ejecutan en una base de datos. Autorizacin: Ninguna Sintaxis del mandato:
db2govlg archivo-anot dbpartitionnum nmero-particin-bd
rectype
tipo-registro
Parmetros del mandato: archivo-anot Nombre base de uno o ms archivos de anotaciones cronolgicas que deben consultarse. dbpartitionnum nmero-particin-bd Nmero de la particin de base de datos en la que se est ejecutando la rutina de gobierno. rectype tipo-registro Tipo de registro que se debe consultar. Los tipos de registro vlidos son: v START v FORCE v NICE v ERROR v v v v WARNING READCFG STOP ACCOUNT
Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave nodenum puede sustituirse por dbpartitionnum.
76
Command Reference
db2govlg - Consulta de anotacin cronolgica de rutina de gobierno de DB2

Informacin relacionada: v db2gov -Mandato Rutina de gobierno de DB2 en la pgina 74
77
db2hc - Iniciar el Centro de salud db2hc -Mandato Iniciar el Centro de salud

Inicia el Centro de salud. El Centro de salud es una interfaz grfica que se utiliza para ver la salud general de los sistemas de base de datos. Mediante el Centro de salud se pueden ver detalles y recomendaciones para alertas en indicadores de salud y emprender las acciones recomendadas para resolver dichas alertas. Autorizacin: No se necesita ninguna autorizacin especial para ver la informacin. Se necesita la autorizacin adecuada para emprender acciones. Conexin necesaria: Instancia Sintaxis del mandato:
db2hc -t -tcomms -tfilter filtro
Parmetros del mandato: -t Activa NavTrace para el cdigo de inicializacin. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique.
-tcomms Limita el rastreo a los sucesos de comunicaciones. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique. -tfilter filtro Limita el rastreo a las entradas que contienen el filtro o los filtros especificados. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique.
78
Command Reference
db2iclus - Servidor de clsteres de Microsoft Mandato db2iclus - Servidor de clsteres de Microsoft

Permite a los usuarios aadir, descartar, migrar y deshacer migraciones de instancias y servidores de administracin DB2 (DAS) en un entorno de Servidor de clsteres de Microsoft (MSCS). Este mandato slo est disponible en plataformas Windows. Autorizacin: Es necesaria la autorizacin de administrador local en la mquina donde se realizar la tarea. Si se aade una mquina remota a una instancia o se elimina una mquina remota de una instancia, es necesaria la autorizacin de administrador local en la mquina de destino. Conexin necesaria: Ninguna. Sintaxis del mandato:
db2iclus ADD /u: nombreusuario,contrasea /m: DROP /m: nombre de la mquina MIGRATE /p: VaPerfInst UNMIGRATE nombre de la mquina
/i:
nombre de la instancia
/DAS:
nombre del DAS
/c:
nombre del clster
Parmetros del mandato: ADD Aade un nodo de MSCS a una instancia de MSCS de DB2.
DROP Elimina un nodo de MSCS de una instancia de MSCS de DB2. MIGRATE Migra una instancia que no es de MSCS a una instancia de MSCS. UNMIGRATE Deshace una migracin de MSCS. /DAS:nombre DAS Especifica el nombre del DAS. Esta opcin es necesaria al realizar la operacin de clster contra el servidor de administracin de DB2. /c:nombre de clster Especifica el nombre de clster de MSCS si es diferente del clster por omisin/actual.
79
db2iclus - Servidor de clsteres de Microsoft

/p:vaacceso perfil instancia Especifica la va de acceso de perfil de instancia. Esta va de acceso debe estar ubicada en un disco de clsteres de forma que sea accesible cuando DB2 est activo en cualquier mquina en el clster de MSCS. Esta opcin es necesaria cuando se migra una instancia que no es de MSCS a una instancia de MSCS. /u:nombreusuario,contrasea Especifica el nombre de cuenta y la contrasea para el servicio DB2. Esta opcin es necesaria cuando se aade otro nodo de MSCS a la instancia de base de datos particionada de MSCS de DB2. /m:nombre_mquina Especifica el nombre de sistema remoto para aadir o eliminar un nodo de MSCS. /i:nombre_instancia Especifica el nombre de instancia si es diferente de la instancia por omisin/actual. Ejemplos: Este ejemplo muestra el uso del mandato db2iclus para configurar manualmente la instancia de DB2 para que se ejecute en una configuracin de espera en caliente que consta de dos mquinas, WA26 y WA27. 1. Para empezar, MSCS y DB2 UDB Enterprise Server Edition deben estar instalados en ambas mquinas. 2. Cree una nueva instancia llamada DB2 en la mquina WA26:
db2icrt DB2
3. En el recuadro de dilogo Servicios de Windows, asegrese de que la instancia est configurada para iniciarse manualmente. 4. Si se est ejecutando la instancia de DB2, detngala con el mandato DB2STOP. 5. Instale el tipo de recurso de DB2 desde WA26:
c:>db2wolfi i ok
Si el mandato db2wolfi devuelve Error : 183, ya est instalado. Para confirmar, se puede descartar y volver a aadir el tipo de recurso. Adems, si no existe, el tipo de recurso no se mostrar en Administrador de clsteres.
c:>db2wolfi u ok c:>db2wolfi i ok
80
Command Reference

6. Desde WA26, utilice el mandato db2iclus para transformar la instancia de DB2 en una instancia de clsteres.
c:\>db2iclus migrate /i:db2 /c:miclster /m:wa26 /p:p:\db2profs DBI1912I El mandato DB2 Cluster ha sido satisfactorio. Explicacin: La peticin del usuario se ha procesado satisfactoriamente. Respuesta del usuario: No se necesita ninguna accin.
Nota: El directorio p:\db2profs debe estar en una unidad con clsteres y debe existir ya. Esta unidad tambin debe ser actualmente propiedad de la mquina WA26. 7. Desde WA26, utilice el mandato db2iclus para aadir otras mquinas a la lista de clsteres de DB2:
c:\>db2iclus add /i:db2 /c:miclster /m:wa27 DBI1912I El mandato DB2 Cluster ha sido satisfactorio. Explicacin: La peticin del usuario se ha procesado satisfactoriamente. Respuesta del usuario: No se necesita ninguna accin.
Este mandato se debe ejecutar para cada mquina subsiguiente en el clster. 8. Desde el Administrador de clsteres, cree un nuevo grupo denominado Grupo DB2. 9. Desde el Administrador de clsteres, mueva el Disco O y el Disco P de recursos del Disco fsico al Grupo DB2. 10. Desde el Administrador de clsteres, cree un nuevo tipo de recurso de tipo Direccin IP denominado mscs5 que se ubique en la Red pblica. Este recurso debe tambin pertenecer al Grupo DB2. Ser una direccin IP altamente disponible y esta direccin no debe corresponder a ninguna mquina en la red. Ponga en lnea el tipo de recurso de Direccin IP y asegrese de que se puede realizar ping en la direccin desde una mquina remota. 11. Desde el Administrador de clsteres, cree un nuevo recurso de tipo DB2 que pertenecer al Grupo DB2. El nombre de este recurso debe ser exactamente idntico al nombre de instancia, de forma que se denomina DB2 para este caso. Cuando el Administrador de clsteres solicita dependencias asociadas con el recurso de DB2, asegrese de que es dependiente del Disco O, Disco P y mscs5. 12. Configure el Grupo DB2 para la retrotraccin, si se desea, mediante el Administrador de clsteres y utilizando la variable de perfil DB2_FALLBACK. 13. Cree o restaure todas las bases de datos poniendo todos los datos en el Disco O y el Disco P. 14. Pruebe la configuracin a prueba de errores.
81

Notas de uso: Para migrar una instancia para que se ejecute en un entorno a prueba de fallos de MSCS, necesita migrar en primer lugar la instancia de la mquina actual y, a continuacin, aadir otros nodos de MSCS a la instancia utilizando db2iclus con la opcin ADD. Para invertir la instancia de MSCS de nuevo a una instancia normal, en primer lugar necesita eliminar todos los otros nodos de MSCS de la instancia utilizando db2iclus con la opcin DROP. A continuacin, debe deshacer la migracin para la instancia en la mquina actual.
82
Command Reference
db2icrt - Crear instancia db2icrt -Mandato Crear instancia

Crea instancias de DB2. En los sistemas basados en UNIX, este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX y /opt/IBM/db2/V8.1 en todos los dems sistemas basados en UNIX. En los sistemas operativos Windows, est ubicado en el subdirectorio \sqllib\bin. Autorizacin: Acceso de root en los sistemas basados en UNIX o autorizacin de Administrador local en los sistemas operativos Windows. Sintaxis del mandato: Para sistemas basados en UNIX
db2icrt -h -? -d -a TipoAut -p NombrePuerto
NombreInst -s TipoInst -w AnchuraPalabra -u IDconBarrera
Para sistemas operativos Windows

db2icrt -s TipoInst -u NombreUsuario, Contrasea NombreInst -p VaPerfInst -h NombreSistpral -r RangoPuertos
Parmetros del mandato: Para sistemas basados en UNIX -h o -? Visualiza la informacin de uso. -d Activa la modalidad de depuracin. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique.
-a TipoAuten Especifica el tipo de autentificacin (SERVER, CLIENT o SERVER_ENCRYPT) para la instancia. El valor por omisin es SERVER. -p NombrePuerto Especifica el nombre o el nmero de puerto utilizado por la instancia.
83
db2icrt - Crear instancia

-s TipoInst Especifica el tipo de instancia a crear. Utilice la opcin -s slo cuando est creando una instancia que no sea el valor por omisin del sistema. Los valores vlidos son: CLIENT Se utiliza para crear una instancia para un cliente. ESE Se utiliza para crear una instancia para un servidor de base de datos con clientes locales y remotos. Nota: Especifique esta opcin si est creando una instancia para un sistema de base de datos PE, un sistema de base de datos ESE de una sola particin, o DB2 Connect. WSE Se utiliza para crear una instancia para un servidor Workgroup Server Edition.
-w AnchuraPalabra Especifica la anchura, en bits, de la instancia que va a crearse. Los valores vlidos son 32 y 64. Este parmetro slo es vlido en AIX 5L, HP-UX y el Entorno operativo Solaris. -u IDdeliminado Especifica el nombre del ID de usuario bajo el que se ejecutarn las funciones definidas por el usuario deliminado y los procedimientos almacenados delimitados. Es necesaria la opcin -u si est creando una instancia de servidor. NombreInst Especifica el nombre de la instancia. Para sistemas operativos Windows -s TipoInst Especifica el tipo de instancia a crear. Los valores vlidos son: Client Se utiliza para crear una instancia para un cliente. Nota: Utilice este valor si utiliza DB2 Connect Personal Edition. Standalone Se utiliza para crear una instancia para un servidor de base de datos con clientes locales. ESE Se utiliza para crear una instancia para un servidor de base de datos con clientes locales y remotos.
84
Command Reference
db2icrt - Crear instancia

Nota: Especifique esta opcin si est creando una instancia para un sistema de base de datos PE, un sistema de base de datos ESE de una sola particin, o DB2 Connect. WSE Se utiliza para crear una instancia para un servidor Workgroup Server Edition.
-u nombreUsuario, Contrasea Especifica el nombre de cuenta y la contrasea para el servicio DB2. Esta opcin es necesaria al crear una instancia de base de datos particionada. -p VaPerfInst Especifica la va de acceso de perfil de instancia. -h NombreSistPral Altera temporalmente el nombre de sistema principal TCP/IP por omisin si hay ms de uno para la mquina actual. El nombre de sistema principal TCP/IP se utiliza al crear la particin de base de datos por omisin (particin de base de datos 0). Esta opcin slo es vlida para instancias de bases de datos particionadas. -r RangoPuertos Especifica un rango de puertos TCP/IP que deber utilizar la instancia de base de datos particionada al ejecutar en modalidad MPP. El archivo de servicios de la mquina local se actualizar con las entradas siguientes si se especifica esta opcin:
DB2_InstName DB2_InstName_END baseport/tcp endport/tcp
NombreInst Especifica el nombre de la instancia. Notas de uso: La opcin -s est destinada para situaciones en las que desee crear una instancia que no utilice todas las funciones del sistema. Por ejemplo, si est utilizando Enterprise Server Edition (ESE), pero no desea funciones de particin, puede crear una instancia de Workgroup Server Edition (WSE) utilizando la opcin -s WSE. Para crear una instancia de DB2 que soporte Microsoft Cluster Server, cree en primer lugar una instancia y luego utilice el mandato db2iclus para migrarla para ejecutar una instancia de MSCS.
85
db2idrop - Eliminar instancia db2idrop -Mandato Eliminar instancia

Elimina una instancia de DB2 creada por db2icrt. Elimina la entrada de la instancia de la lista de instancias. En los sistemas basados en UNIX, este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/lpp/db2_07_01 en AIX, /usr/IBMdb2/V7.1 en Linux, y /opt/IBMdb2/V7.1 en todos los dems sistemas basados en UNIX. En el sistema operativo Windows, est ubicado en el subdirectorio \sqllib\bin. Autorizacin: Acceso de root en los sistemas basados en UNIX o Administrador local en los sistemas operativos Windows. Sintaxis del mandato: Para sistemas basados en UNIX
db2idrop -h -? NombreInst
Para los sistemas operativos Windows

db2idrop -f NombreInst
Parmetros del mandato: Para sistemas basados en UNIX -h o -? Visualiza la informacin de uso. NombreInst Especifica el nombre de la instancia. Para los sistemas operativos Windows; -f Especifica el distintivo de forzar aplicaciones. Si se especifica este distintivo, se forzar la terminacin de todas las aplicaciones que utilicen la instancia.
NombreInst Especifica el nombre de la instancia. Informacin relacionada: v db2icrt -Mandato Crear instancia en la pgina 83
86
Command Reference
db2ilist - Listar instancias db2ilist -Mandato Listar instancias

Lista todas las instancias que estn disponibles en un sistema. En los sistemas basados en UNIX, este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX, y /opt/IBM/db2/V8.1 en todos los dems sistemas basados en UNIX. En el sistema operativo Windows, est ubicado en el subdirectorio \sqllib\bin. Autorizacin: Acceso de root en sistemas basados en UNIX. En los sistemas operativos Windows, no se necesita ninguna autorizacin. Sintaxis del mandato:
db2ilist
Parmetros del mandato: Ninguno
87
db2imigr - Migrar instancia db2imigr -Mandato Migrar instancia

Migra una instancia existente a continuacin de la instalacin del gestor de bases de datos. Este mandato slo est disponible en los sistemas basados en UNIX. En Windows, la migracin de la instancia se realiza implcitamente durante la migracin. Este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX y /opt/IBM/db2/V8.1 en todos los dems sistemas basados en UNIX. Autorizacin: Acceso de root en sistemas basados en UNIX. Sintaxis del mandato:
db2imigr -d -a TipoAut -u -g IDconBarrera dlfmxgrpid NombreInst
Parmetros del mandato: -d Activa la modalidad de depuracin. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique.
-a TipoAuten Especifica el tipo de autentificacin (SERVER, CLIENT o SERVER_ENCRYPT) para la instancia. El valor por omisin es SERVER. -u IDdelimitado Especifica el nombre del ID de usuario bajo el que se ejecutarn las funciones definidas por el usuario deliminado y los procedimientos almacenados delimitados. Esta opcin no es necesaria si slo hay un cliente DB2 instalado. -g dlfmxgrpid Especifica el ID dlfmxgrp. Se debe utilizar esta opcin si se migra una instancia de Data Links File Manager Versin 7 o anterior. El ID de grupo del sistema aqu especificado se utiliza exclusivamente con el Data Links File Manager. El propietario de instancia de base de datos de DLFM, que es dlfm por omisin, ser el nico ID de usuario del sistema definido como miembro de este grupo. NombreInst Especifica el nombre de la instancia.
88
Command Reference
db2imigr - Migrar instancia

Conceptos relacionados: v Antes de instalar DB2 Data Links Manager (AIX) del manual Gua rpida de iniciacin para Data Links Manager v Antes de instalar DB2 Data Links Manager (entorno del sistema operativo Solaris) del manual Gua rpida de iniciacin para Data Links Manager
89
db2inidb - Inicializar una base de datos duplicada db2inidb - Mandato Inicializar una base de datos duplicada
Inicializa una base de datos duplicada en un entorno de duplicacin de divisin. La base de datos duplicada puede inicializarse como un clon de la base de datos primaria, en estado de pendiente de avance, o utilizarse como una imagen de copia de seguridad para restaurar la base de datos primaria. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna Sintaxis del mandato:
db2inidb alias_basedatos AS SNAPSHOT STANDBY MIRROR RELOCATE USING archivoConfig
Parmetros del mandato: alias_basedatos Especifica el alias de la base de datos que debe inicializarse. SNAPSHOT Especifica que la base de datos duplicada debe inicializarse como un clon de la base de datos primaria. STANDBY Especifica que la base de datos se pasar a estado de pendiente de avance. Nota: Nuevas anotaciones cronolgicas de la base de datos primaria se pueden captar y aplicar a la base de datos de reserva. A continuacin, la base de datos de reserva puede utilizarse en lugar de la base de datos primaria si sta tiene alguna anomala. MIRROR Especifica que la base de datos duplicada debe utilizarse como imagen de copia de seguridad que puede utilizarse para restaurar la base de datos primaria.
90
Command Reference
db2inidb - Inicializar una base de datos duplicada

RELOCATE USING archivoConfig Especifica que los archivos de base de datos deben volverse a ubicar basndose en la informacin listada en el archivo de configuracin. Informacin relacionada: v db2relocatedb - Mandato Reubicar base de datos en la pgina 150
91
db2inspf - Formatear resultados de inspeccin db2inspf -Mandato Formatear resultados de inspeccin

Este programa de utilidad formatea los datos de los resultados de INSPECT CHECK en formato ASCII. Utilice este programa de utilidad para ver detalles de la inspeccin. El formato realizado por el programa de utilidad db2inspf puede ser un formato para slo una tabla, slo un espacio de tabla, slo errores o slo un resumen. Autorizacin: Cualquier usuario puede acceder a este programa de utilidad, pero deber tener permiso de lectura del archivo de resultados a fin de ejecutar este programa de utilidad en ellos. Conexin necesaria: Ninguna Sintaxis del mandato:
, db2inspf archivo-datos archivo-salida tsi n ti n e s
Parmetros del mandato: archivo-datos El archivo de resultados de inspeccin no formateado que se va a formatear. archivo-salida El archivo de salida para la salida formateada. -tsi n -ti n -e -s ID de espacio de tabla. Formatea slo para las tablas de este espacio de tabla. ID de tabla. Formatea slo para la tabla que tiene este ID y tambin debe proporcionarse el ID de espacio de tabla. Slo formatea errores. Slo resumen.
92
Command Reference
db2isetup - Iniciar interfaz de creacin de instancias db2isetup -Mandato Iniciar interfaz de creacin de instancias
Inicia el asistente de Configuracin de instancias de DB2, una herramienta grfica para crear instancias y configurar una nueva funcionalidad sobre las instancias existentes. Por ejemplo, si crea una instancia y, a continuacin, instala ms productos tales como Relational Connect, al emitir este mandato se iniciar la interfaz grfica utilizada para configurar la funcionalidad de Relational Connect sobre la instancia existente. Autorizacin: Autorizacin root sobre el sistema en el que se emite el mandato. Conexin necesaria: Ninguna. Sintaxis del mandato:
db2isetup -t archrastreo -l archanotcron -i cdigo-idioma
-?
Parmetros del mandato: -t archrastreo Va de acceso y nombre completos del archivo de rastreo especificado por archrastreo. -l Va de acceso y nombre completos del archivo de anotaciones cronolgicas. Si no se especifica ningn nombre, la va de acceso y el nombre de archivo toman por omisin el valor /tmp/db2isetup.log
-i cdigo-idioma Cdigo de dos letras correspondiente al idioma preferido en el que ha de ejecutarse la instalacin. Si no se especifica, este parmetro tomar por omisin el cdigo de entorno local del usuario actual. -?, -h Informacin de uso de salida.
Notas de uso: 1. Este asistente de configuracin de instancias proporciona un subconjunto de la funcionalidad proporcionada por el asistente de Configuracin de DB2. El asistente de Configuracin de DB2 (que se ejecuta desde el soporte de instalacin) permite instalar componentes de DB2, efectuar tareas de configuracin del sistema tales como la creacin/configuracin de DAS y
93
db2isetup - Iniciar interfaz de creacin de instancias

configurar instancias. El asistente de Configuracin de instancias de DB2 slo proporciona la funcionalidad que pertenece a la configuracin de instancias. 2. El archivo ejecutable correspondiente a este mandato est ubicado en el directorio /dir instalacin producto/instance, junto con otros scripts de instancia tales como db2icrt y db2iupdt. Como estos otros scripts de instancia, se necesita autorizacin root, y como estos otros scripts de instancia, no forma parte de la instancia de DB2 en UNIX. 3. db2isetup se ejecuta en todas las plataformas UNIX soportadas.
94
Command Reference
db2iupdt - Actualizar instancias db2iupdt -Mandato Actualizar instancias

En sistemas basados en UNIX, este mandato actualiza una instancia de DB2 especificada para permitir la adquisicin de una nueva configuracin del sistema o para acceder a la funcin asociada con la instalacin o el desmontaje de determinadas opciones de producto. Este programa de utilidad est ubicado en el directorio DB2DIR/instance, donde DB2DIR representa /usr/opt/db2_08_01 en AIX y /opt/IBM/db2/V8.1 en Linux, y /opt/IBMdb2/V8.1 en todos los dems sistemas basados en UNIX. En los sistemas operativos Windows, este mandato actualiza instancias de una sola particin para utilizarlas en un sistema de base de datos particionado. Est ubicado en el subdirectorio \sqllib\bin. Autorizacin: Acceso de root en los sistemas basados en UNIX o Administrador local en Windows. Sintaxis del mandato: Para sistemas basados en UNIX
db2iupdt -h -? -d -k -s -a TipoAut
-w
AnchuraPalabra
-u
IDconBarrera
NombreInst -e
Para Windows
db2iupdt NombreInst /u: nombreusuario,contrasea
/p:
vaacceso perfil instancia
/r:
puertobase,puertofinal
/h:
nombresistpral
Parmetros del mandato: Para sistemas basados en UNIX -h o -? Visualiza la informacin de uso. -d -k Activa la modalidad de depuracin. Conserva el tipo de instancia actual durante la actualizacin.
95
db2iupdt - Actualizar instancias

-s Ignora el directorio de anotacin cronolgica SPM existente.
-a TipoAut Especifica el tipo de autentificacin (SERVER, SERVER_ENCRYPT o CLIENT) correspondiente a la instancia. El valor por omisin es SERVER. -w AnchuraPalabra Especifica la anchura, en bits, de la instancia que va a crearse. Los valores vlidos son 32 y 64. Este parmetro slo es vlido en AIX, HP-UX y el Entorno operativo Solaris. La versin requisito previo de DB2 debe estar instalada (32 bits o 64 bits). -u IDconBarrera Especifica el nombre del ID de usuario bajo el que se ejecutarn las funciones con barrera definidas por el usuario y los procedimientos con barrera almacenados. NombreInst Especifica el nombre de la instancia. -e Actualiza cada instancia.
Para Windows NombreInst Especifica el nombre de la instancia. /u:nombreusuario,contrasea Especifica el nombre de cuenta y la contrasea para el servicio DB2. /p:vaacceso perfil instancia Especifica la nueva va de acceso de perfil de la instancia actualizada. /r:puertobase,puertofinal Especifica el rango de puertos TCP/IP que deber utilizar la instancia de base de datos particionada al ejecutar en modalidad MPP. Cuando se especifica esta opcin, el archivo de servicios de la mquina local se actualizar con las entradas siguientes:
DB2_InstName DB2_InstName_END baseport/tcp endport/tcp
/h:nombresistpral Altera temporalmente el nombre de sistema principal TCP/IP por omisin si hay ms de un nombre de sistema principal TCP/IP para la mquina actual.
96
Command Reference
db2ldcfg - Configurar entorno de LDAP db2ldcfg -Mandato Configurar entorno de LDAP

Configura el nombre distinguido (DN) de usuario de LDAP (Lightweight Directory Access Protocol) y la contrasea para el usuario de la conexin actual en un entorno de LDAP que utiliza un cliente LDAP de IBM. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2ldcfg -u -r Nombre distinguido usuario -w contrasea
Parmetros del mandato: -u Nombre distinguido usuario Especifica el Nombre distinguido del usuario LDAP que se debe utilizar al acceder al directorio de LDAP. Tal como se muestra en el siguiente ejemplo, el Nombre distinguido tiene varias partes: el ID de usuario, como jdoe, los nombres de dominio y de organizacin, y el sufijo, como com u org. -w contrasea Especifica la contrasea. -r Elimina el DN del usuario y la contrasea del entorno de mquina.
Ejemplo:
db2ldcfg -u "uid=jdoe,dc=midominio,dc=miorg,dc=com" -w contrasea
Notas de uso: En un entorno de LDAP que utiliza un cliente LDAP de IBM, se pueden configurar el DN del usuario de LDAP y la contrasea por omisin para el usuario de la conexin actual. Una vez que se han configurado, el DN de usuario de LDAP y la contrasea se guardan en el entorno del usuario y se utilizan siempre que DB2 accede al directorio de LDAP. Esto elimina la necesidad de especificar el DN de usuario de LDAP y la contrasea al emitir la API o el mandato de LDAP. No obstante, si se especifican el DN de usuario de LDAP y la contrasea cuando se emite la API o el mandato, se alterarn temporalmente los valores por omisin.
97
db2ldcfg - Configurar entorno de LDAP

Este mandato slo puede ejecutarse cuando se utiliza un cliente LDAP de IBM. En un cliente LDAP de Microsoft, se utilizarn las credenciales del usuario de la conexin actual.
98
Command Reference
db2level - Mostrar nivel de servicio de DB2 db2level -Mandato Mostrar nivel de servicio de DB2
Muestra la Versin y el Nivel de servicio actuales del producto DB2 instalado. La salida de este mandato va por omisin a la consola. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
db2level
Ejemplos: Un resultado tpico de ejecutar el mandato db2level en un sistema Windows sera el siguiente:
DB21085I Instancia "kirton" utiliza release de cdigo de DB2 "SQL08010" con identificador de nivel "01010106" y seales informativas "DB2 v8.1.0", "n020320" y "
La salida informativa producida por el mandato incluye el Release, el Nivel y diversas seales informativas.
99
db2licm - Herramienta de gestin de licencias db2licm -Mandato Herramienta de gestin de licencias

Efecta funciones de licencia bsicas en ausencia del Centro de control. Aade, elimina, lista y modifica licencias y polticas instaladas en el sistema local. Autorizacin: En los sistemas basados en UNIX, la autorizacin root slo es necesaria para eliminar una clave de licencia. En los sistemas operativos Windows, no se necesita ninguna autorizacin. Conexin necesaria: Ninguna Sintaxis del mandato:
db2licm -a -l -p nombre-archivo contrasea-prod REGISTERED -r -u -n -e -v -h -? contrasea-prod contrasea-prod contrasea-prod HARD SOFT CONCURRENT INTERNET MEASURED
nm-usuarios nm-procesadores
Parmetros del mandato: -a nombre-archivo Aade una licencia para un producto. Especifique un nombre de archivo que contenga informacin de licencia vlida. -l Lista todos los productos con informacin de licencia disponible.
-p contrasea-prod palabra-clave Actualiza el tipo de poltica de licencia a utilizar en el sistema. Pueden especificarse las palabras clave CONCURRENT, REGISTERED o CONCURRENT REGISTERED. Adems, puede especificar INTERNET para los productos DB2 UDB Workgroup Server, o MEASURED para los productos DB2 Connect Unlimited. -r contrasea-prod Elimina la licencia para un producto. Despus de eliminar la licencia,
100
Command Reference
db2licm - Herramienta de gestin de licencias

el producto funciona en modalidad de probar y comprar (Try & Buy). Para obtener la contrasea para un producto especfico, invoque el mandato con la opcin -l. -u contrasea-prod nm-usuarios Actualiza el nmero de licencias de usuario que el cliente ha comprado. Especifica el nmero de usuarios y la contrasea del producto para el que se han comprado las licencias. -n contrasea-prod nm-procesadores Actualiza el nmero de procesadores en los que el cliente tiene licencia para utilizar DB2. -e Actualiza la poltica de aplicacin en el sistema. Los valores vlidos son: HARD y SOFT. HARD especifica que no se permitirn peticiones sin licencia. SOFT especifica que las peticiones sin licencia se anotarn cronolgicamente pero no se restringirn. Visualiza informacin de versin. Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
-v -h/-?
Ejemplos:
db2licm db2licm db2licm db2licm db2licm -a -p -r -u -n db2ese.lic db2wse registered concurrent db2ese db2wse 10 db2ese 8
101
db2logsforffwd - Listar registros necesarios para recuperacin en avance Mandato db2logsforrfwd - Listar registros necesarios para recuperacin en avance
Analiza el archivo DB2TSCHG.HIS. Este programa de utilidad permite al usuario saber los archivos del registro que son necesarios para una operacin de recuperacin en avance de espacio de tabla. Este programa de utilidad est ubicado en sqllib/bin. Autorizacin: Conexin necesaria: Ninguna. Sintaxis del mandato:
db2logsforrfwd vaacceso -all
Parmetros del mandato: vaacceso Va de acceso y nombre completos del archivo DB2TSCHG.HIS. -all Visualiza informacin ms detallada.
Ejemplos:
db2logsForRfwd /home/ofer/ofer/NODE0000/S0000001/DB2TSCHG.HIS db2logsForRfwd DB2TSCHG.HIS -all
102
Command Reference
db2look - Herramienta de extraccin de DDL y de estadsticas de DB2 db2look -Mandato Herramienta de extraccin de DDL y de estadsticas de DB2
Extrae las sentencias DDL necesarias para reproducir los objetos de una base de datos de produccin en una base de datos de prueba. Esta herramienta tambin puede generar las sentencias UPDATE necesarias que se utilizan para reproducir las estadsticas acerca de los objetos de una base de datos de prueba, as como los parmetros de configuracin de actualizar la configuracin de base de datos y de actualizar el gestor de bases de datos y las sentencias db2set, de modo que las variables de registro y los valores de parmetros de configuracin de la base de datos de prueba coincidan con los de la base de datos de produccin. Normalmente es ventajoso tener un sistema de prueba que contenga un subconjunto de los datos del sistema de produccin. Sin embargo, los planes de acceso seleccionados para dicho sistema de prueba no son necesariamente los mismos que los que se seleccionaran para el sistema de produccin. Las estadsticas de catlogos y los parmetros de configuracin para el sistema de prueba deben actualizarse para que coincidan con los del sistema de produccin. La utilizacin de esta herramienta hace que sea posible crear una base de datos de prueba donde los planes de acceso sean similares a los que se utilizaran en el sistema de produccin. Autorizacin: Privilegio SELECT en los catlogos del sistema. Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2look -d NombreDB -u Creador -s -g -a -h -r
-c
-td
-p
-z
esquema
-xd
-noview
-o
NombreA
-e -t
NombreT
-m -t
NombreT
-l
-x
-i
idusuario
-w
contrasea
-f
103
db2look - Herramienta de extraccin de DDL y de estadsticas de DB2

Parmetros del mandato: -d NombreDB Nombre de alias de la base de datos de produccin que se va a consultar. NombreBD puede ser el nombre de una base de datos UDB de DB2 para UNIX, Windows o DB2 Universal Database para OS/390 y z/OS. Si el NombreDB es una base de datos DB2 Universal Database para OS/390 y z/OS, el programa de utilidad db2look extraer las sentencias de estadsticas UPDATE y DDL para los objetos de OS/390.Estas sentencias de estadsticas UPDATE y DDL son sentencias aplicables a una base de datos DB2 UDB y no a una base de datos DB2 para OS/390. Esto es til para usuarios que desean extraer objetos de OS/390 y volver a crearlos en una base de datos DB2 UDB. Si NombreDB es una base de datos OS/390, la salida de db2look est limitada a lo siguiente: v Generar DDL para Tablas, ndices, Vistas y Tipos diferenciados definidos por el usuario v Generar sentencias de estadsticas UPDATE para Tablas, Columnas, Distribuciones de columna e ndices -u Creador ID de creador. Limita la salida a objetos con este ID de creador. Si se especifica la opcin -a, se pasa por alto este parmetro. Si no se especifica -u ni -a, se utiliza la variable de entorno USER. -s Genera un archivo PostScript. Notas: 1. Esta opcin elimina todos los archivos LaTeX y .tmp PostScript. 2. Software no IBM necesario: LaTeX, dvips. 3. El archivo psfig.tex debe estar en la va de acceso de entrada de LaTeX. -g Utiliza un grfico para mostrar pares de pginas de captacin para ndices. Notas: 1. Esta opcin genera un archivo nombre-archivo.ps, as como el archivo LaTeX. 2. Software no IBM necesario: Gnuplot. 3. El archivo psfig.tex debe estar en la va de acceso de entrada de LaTeX. -a Cuando se especifica esta opcin, la salida no est limitada a los objetos creados bajo un ID de creador determinado. Se tienen en cuenta todos los objetos creados por todos los usuarios. Por ejemplo,
104
Command Reference

si se especifica esta opcin con la opcin -e, se extraen sentencias DDL para todos los objetos de la base de datos. Si se especifica esta opcin con la opcin -m, se extraen sentencias de estadsticas UPDATE para todas las tablas y todos los ndices de la base de datos creados por el usuario. Nota: Si no se especifica -u ni -a, se utiliza la variable de entorno USER. En sistemas basados en UNIX, esta variable no tiene que establecerse explcitamente; sin embargo, en Windows NT no existe ningn valor por omisin para la variable de entorno USER: en esta plataforma, se debe establecer una variable de usuario en las variables SYSTEM o se debe emitir set USER=<nombreusuario> para la sesin. -h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. Cuando se especifica esta opcin junto con la opcin -m, db2look no genera el mandato RUNSTATS. La accin por omisin es generar el mandato RUNSTATS. La opcin -r se ignora si no se especifica la opcin -m. Cuando se especifica esta opcin junto con la opcin -m, db2look no genera sentencias COMMIT, CONNECT y CONNECT RESET. La accin por omisin es generar dichas sentencias. La opcin -c se pasa por alto si no se especifica la opcin -m. Especifica el delimitador de sentencia para las sentencias de SQL generadas por db2look. Si no se especifica esta opcin, el valor por omisin es el punto y coma (;). Se recomienda que esta opcin se utilice si se especifica la opcin -e. En este caso, los objetos extrados pueden contener desencadenantes o rutinas SQL.
-r
-c
-td x
-t NombreT1, NombreT2, ..., NombreTN Lista de nombres de tabla. Limita la salida a tablas determinadas de la lista de tablas. El nmero mximo de tablas es 30. Los nombres de tabla sensibles a las maysculas y minsculas y con varias palabras deben encerrarse entre una barra inclinada invertida y un par de comillas, por ejemplo, \" Mi TabLa \". -p Utiliza formato de texto corriente.
-z esquema Nombre de esquema. Limita la salida a objetos con este nombre de esquema. Si se especifica la opcin -a, se pasa por alto este parmetro. Si no se especifica este parmetro, se extraen los objetos con todos los nombres de esquema. -xd Si se especifica esta opcin, el programa de utilidad db2look generar
105

todo el DDL de autorizacin, incluido el DDL de autorizacin para los objetos cuyas autorizaciones otorga SYSIBM durante la creacin de objetos. -noview Si se especifica esta opcin, no se extraern las sentencias DDL CREATE VIEW. -o NombreA Si se utiliza el formato LaTeX, la salida se graba en nombre-archivo.tex. Si se utiliza formato de texto corriente, graba la salida en nombre-archivo.txt. Si no se especifica esta opcin, la salida se graba en la salida estndar. -e Extrae sentencias DDL para objetos de base de datos. Esta opcin puede utilizarse junto con la opcin -m. Se extraen DDL para los objetos de base de datos siguientes cuando se utiliza la opcin -e: v v v v v Tablas Vistas Tablas de resumen automtico (AST) Alias ndices
v Desencadenantes v Secuencias v Tipos diferenciados definidos por el usuario v v v v Restricciones de Clave primaria, RI y CHECK Tipos estructurados definidos por el usuario Funciones definidas por el usuario Mtodos definidos por el usuario
v Transformaciones definidas por el usuario Nota: El DDL generado por db2look puede utilizarse para volver a crear de forma satisfactoria funciones definidas por el usuario. Sin embargo, el cdigo fuente de usuario al que hace referencia una funcin determinada definida por el usuario (por ejemplo, la clusula EXTERNAL NAME) debe estar disponible para que la funcin definida por el usuario sea utilizable. -m Genera las sentencias UPDATE necesarias para reproducir las estadsticas en tablas, columnas e ndices. Las opciones -p, -g y -s se pasan por alto cuando se especifica la opcin -m. Si se especifica esta opcin, el programa de utilidad db2look generar el DDL para los espacios de tabla, los grupos de particiones de base de datos y las agrupaciones de almacenamientos intermedios
-l
106
Command Reference

definidos por el usuario. Se extrae el DDL para los objetos de base de datos siguientes cuando se utiliza la opcin -l: v Espacios de tabla definidos por el usuario v Grupos de particiones de base de datos definidos por el usuario v Agrupaciones de almacenamientos intermedios definidos por el usuario -x Si se especifica esta opcin, el programa de utilidad db2look generar el DDL de autorizacin (por ejemplo la sentencia GRANT).
-i idusuario Utilice esta opcin cuando trabaje con una base de datos remota. -w contrasea Si se utiliza con la opcin -i, este parmetro permite que el usuario ejecute db2look para una base de datos que resida en un sistema remoto. db2look utiliza el ID de usuario y la contrasea para conectarse al sistema remoto. -f Utilice esta opcin para extraer parmetros de configuracin y variables de registro. Nota: Slo se extraen parmetros de configuracin y variables de registro que afectan al optimizador de consulta DB2. Ejemplos: Generar las sentencias DDL para los objetos creados por el usuario idwal en la base de datos DEPARTAMENTO. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -u idwal -e -o db2look.sql
Generar las sentencias DDL para los objetos que tienen el nombre de esquema ianhe, creados por el usuario idwal en la base de datos DEPARTAMENTO. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -u idwal -z ianhe -e -o db2look.sql
Generar las sentencias UPDATE para reproducir las estadsticas para las tablas y los ndices creados por el usuario idwal en la base de datos DEPARTAMENTO. La salida se enva al archivo db2look.sql:
db2look -d departamento -u idwal -m -o db2look.sql
Generar las sentencias DDL para los objetos creados por el usuario idwal y las sentencias UPDATE para reproducir las estadsticas en las tablas y los ndices creados por el mismo usuario. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -u idwal -e -m -o db2look.sql
107

Generar las sentencias DDL para los objetos creados por todos los usuarios en la base de datos DEPARTAMENTO. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -a -e -o db2look.sql
Generar las sentencias DDL para todos los grupos de particiones de base de datos, las agrupaciones de almacenamientos intermedios y los espacios de tabla definidos por el usuario. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -l -o db2look.sql
Generar las sentencias UPDATE para los parmetros de configuracin de la base de datos y del gestor de base de datos, as como las sentencias db2set para las variables de registro en la base de datos DEPARTAMENTO. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -f -o db2look.sql
Generar DDL para todos los objetos de la base de datos DEPARTAMENTO, las sentencias UPDATE para reproducir las estadsticas en todas las tablas y los ndices de la base de datos DEPARTAMENTO, las sentencias de autorizacin GRANT, las sentencias UPDATE para los parmetros de configuracin de la base de datos y del gestor de bases de datos, las sentencias db2set para las variables de registro y el DDL para todos los grupos de particiones de base de datos, las agrupaciones de almacenamientos intermedios y los espacios de tabla definidos por el usuario en la base de datos DEPARTAMENTO. La salida se enva al archivo db2look.sql.
db2look -d departamento -a -e -m -l -x -f -o db2look.sql
Generar todos los DDL de autorizacin para todos los objetos de la base de datos DEPARTAMENTO, incluidos los objetos creados por el creador original. (En este caso, SYSIBM otorg las autorizaciones durante la creacin de objetos.) La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -xd -o db2look.sql
Generar las sentencias DDL para los objetos creados por todos los usuarios en la base de datos DEPARTAMENTO. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -a -e -td % -o db2look.sql db2 -td% -f db2look.sql
Generar las sentencias DDL para los objetos de la base de datos DEPARTAMENTO, excluyendo las sentencias CREATE VIEW. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -e -noview -o db2look.sql
108
Command Reference

Generar las sentencias DDL para los objetos de la base de datos DEPARTAMENTO relacionados con las tablas especificadas. La salida de db2look se enva al archivo db2look.sql:
db2look -d departamento -e -t tab1, \"Mi TaBlA2\" -o db2look.sql
Notas de uso: Las opciones de lnea de mandatos de db2look pueden especificarse en cualquier orden. Todas las opciones de lnea de mandatos son opcionales, salvo la opcin -d, que es obligatoria y debe ir seguida de un nombre de alias de base de datos vlido.
109
db2move - Herramienta de movimiento de base de datos db2move - Mandato Herramienta de movimiento de base de datos
Esta herramienta facilita el movimiento de una gran cantidad de tablas entre bases de datos DB2 ubicadas en estaciones de trabajo. La herramienta consulta las tablas de catlogos del sistema de una base de datos determinada y compila una lista de todas las tablas de usuario. Entonces exporta dichas tablas en formato PC/IXF. Los archivos PC/IXF pueden importarse o cargarse en otra base de datos DB2 local del mismo sistema o pueden transferirse a otra plataforma de estacin de trabajo e importarse y cargarse en una base de datos DB2 de dicha plataforma. Nota: Las tablas con columnas de tipo estructurado no se mueven cuando se utiliza esta herramienta. Autorizacin: Esta herramienta llama a las API de exportacin, importacin y carga de DB2, en funcin de la accin solicitada por el usuario. Por consiguiente, el ID del usuario que realiza la peticin debe tener la autorizacin correcta necesaria para dichas API o, de lo contrario, fallar la peticin. Sintaxis del mandato:
db2move
nombrebd
accin -tc creadores-tablas -tn nombres-tablas -sn nombres-esquema -io opcin-importacin -lo opcin-carga -l vasaccesolob -u idusuario -p contrasea -aw
Parmetros del mandato: nombrebd Nombre de la base de datos. accin Debe ser una de las siguientes: EXPORT, IMPORT o LOAD. -tc creadores-tablas. El valor por omisin es todos los creadores. Se trata de una accin de EXPORT solamente. Si se especifica, slo se exportan las tablas creadas por los creadores listados con esta opcin. Si no se especifica, el valor por omisin es utilizar todos los creadores. Cuando se especifican varios creadores, cada uno debe estar separado por comas; no se permiten espacios en blanco entre los ID de creador.
110
Command Reference
db2move - Herramienta de movimiento de base de datos

El nmero mximo de creadores que se puede especificar es de 10. Esta opcin puede utilizarse con la opcin -tn nombres-tablas para seleccionar las tablas para exportacin. Se puede utilizar un asterisco (*) como carcter comodn que puede colocarse en cualquier lugar de la serie. -tn nombres-tablas. El valor por omisin es todas las tablas de usuario. Se trata de una accin de EXPORT solamente. Si se especifica, slo se exportan las tablas cuyos nombres coinciden exactamente con los de la serie especificada. Si no se especifica, el valor por omisin es utilizar todas las tablas de usuario. Cuando se especifican varios nombres de tablas, cada uno debe estar separado por comas; no se permiten espacios en blanco entre los nombres de tablas. El nmero mximo de nombres de tablas que se puede especificar es de 10. Esta opcin puede utilizarse con la opcin -tc creadores-tablas para seleccionar las tablas para exportacin. db2move exportar solamente las tablas cuyos nombres coincidan con los nombres de tablas especificados y cuyos creadores coincidan con los creadores de tablas especificados. Se puede utilizar un asterisco (*) como carcter comodn que puede colocarse en cualquier lugar de la serie. -sn nombres-esquema. Si se especifica, slo se exportarn las tablas cuyos nombres de esquema coincidan exactamente. Si se utiliza el asterisco de carcter comodn (*) en el nombre o nombres de esquema, se cambiar por un signo de porcentaje (%) y el nombre de tabla (con el signo de porcentaje) se utilizar en el predicado LIKE de la clusula WHERE. Si no se especifica, se utilizar el valor por omisin (todos los esquemas). Si se especifican varios nombres de esquema, deben ir separados por comas y no se permiten blancos. El nmero mximo de nombres de esquema que puede especificarse es de 10. Si se utiliza con la opcin -tn o -tc, db2move slo exportar las tablas cuyos esquemas coincidan con los nombres de esquema especificados y cuyos creadores coincidan con los creadores especificados. Nota: Los nombres de esquema de menos de 8 caracteres se rellenan hasta una longitud de 8 caracteres. As, para el nombre de esquema fred, el usuario tendr que especificar -sn fr*d* en lugar de -sn fr*d cuando utilice el ASTERISCO. -io opcin-importacin. El valor por omisin es REPLACE_CREATE. Las opciones vlidas son: INSERT, INSERT_UPDATE, REPLACE, CREATE y REPLACE_CREATE. -lo opcin-carga. El valor por omisin es INSERT.
111

Las opciones vlidas son: INSERT y REPLACE. -l vasaccesolob. El valor por omisin es el directorio actual. Esta opcin especifica los nombres absolutos de las vas de acceso donde se crean los archivos LOB (como parte de EXPORT) o donde se buscan dichos archivos (como parte de IMPORT o LOAD). Cuando se especifican varias vas de acceso de LOB, cada una debe estar separada por comas; no se permiten espacios en blanco entre las vas de acceso de LOB. Si la primera va de acceso se queda sin espacio (durante la operacin EXPORT) o si no se encuentran los archivos en la va de acceso (durante la operacin IMPORT o LOAD), se utiliza la segunda va de acceso y as sucesivamente. Si la accin es EXPORT y se especifican vas de acceso de LOB, se suprimirn todos los archivos de los directorios de las vas de acceso de LOB, se eliminarn los directorios y se crearn directorios nuevos. Si no se especifica, se utiliza el directorio actual para la va de acceso de LOB. -u idusuario. El valor por omisin es el ID de usuario conectado. El ID de usuario y la contrasea son opcionales. Sin embargo, si se especifica uno de ellos, debe especificarse el otro. Si el mandato se ejecuta en un cliente que se conecta a un servidor remoto, se debern especificar el ID de usuario y la contrasea. -p contrasea. El valor por omisin es la contrasea de conexin. El ID de usuario y la contrasea son opcionales. Sin embargo, si se especifica uno de ellos, debe especificarse el otro. Si el mandato se ejecuta en un cliente que se conecta a un servidor remoto, se debern especificar el ID de usuario y la contrasea. -aw Permitir avisos. Cuando no se especifica -aw, las tablas que han recibido avisos durante la exportacin no se incluyen en el archivo db2move.lst (aunque se siguen generando los archivos .ixf y .msg de dichas tablas). En algunos escenarios (como el truncamiento de datos), puede que el usuario quiera que esas tablas se incluyan en el archivo db2move.lst. Especificar esta opcin permite que las tablas que reciban avisos durante la exportacin se incluyan en el archivo .lst.
Ejemplos: v db2move sample export Esta accin exportar todas las tablas de la base de datos SAMPLE; se utilizan los valores por omisin para todas las opciones. v db2move sample export -tc idusuario1,idus*ario2 -tn nombretb1,nombre*tb2
112
Command Reference

Esta accin exportar todas las tablas creadas por idusuario1 o los ID de usuario COMO idus%ario2 y con el nombre nombretb1 o los nombres de tablas COMO nombre%tb2. v db2move sample import -l D:\LOBPATH1,C:\LOBPATH2 Este ejemplo slo es aplicable al sistema operativo Windows. El mandato importar todas las tablas de la base de datos SAMPLE; se deben buscar archivos LOB en las vas de acceso de LOB D:\LOBPATH1 y C:\LOBPATH2. v db2move sample load -l /home/userid/lobpath,/tmp Este ejemplo slo es aplicable a sistemas basados en UNIX. El mandato cargar todas las tablas de la base de datos SAMPLE; se debern buscar archivos LOB en el subdirectorio /home/userid/lobpath y el subdirectorio tmp. v db2move sample import -io replace -u idusuario -p contrasea Esta accin importar todas las tablas de la base de datos SAMPLE en modalidad REPLACE; se utilizarn el ID de usuario y la contrasea que se han especificado. Notas de uso: Esta herramienta exporta, importa y carga tablas creadas por el usuario. Si se debe duplicar una base de datos de un sistema operativo a otro, db2move facilita el movimiento de las tablas. Tambin es necesario mover todos los dems objetos asociados con las tablas, por ejemplo: alias, vistas, desencadenantes, funciones definidas por el usuario, etc. Cuando db2move llama a las API de exportacin, importacin o carga, el parmetro FileTypeMod se establece en lobsinfile. Es decir, los datos LOB se conservan en archivos independientes de los archivos PC/IXF. Existen 26.000 nombres de archivo disponibles para los archivos LOB. La accin LOAD debe ejecutarse localmente en la mquina donde residen la base de datos y los archivos de datos. Cuando db2move llama a la API de carga, el parmetro CopyTargetList se establece en NULL; es decir, no se realiza ninguna copia. Si logretain est activado, la operacin de carga no puede recuperarse posteriormente. El espacio de tabla donde residen las tablas cargadas se coloca en estado de pendiente de copia de seguridad y no es accesible. Se necesita una copia de seguridad de la base de datos completa o una copia de seguridad del espacio de tabla para que el espacio de tabla salga del estado de pendiente de copia de seguridad. Nota: Se puede mejorar el rendimiento de db2move import modificando la agrupacin de almacenamientos intermedios por omisin, IBMDEFAULTBP; y modificando los parmetros de configuracin
113

sortheap, util_heap_sz, logfilsz y logprimary. Por favor, consulte el volumen Performance del manual Administration Guide para obtener ms informacin. Archivos necesarios/generados al utilizar EXPORT: v Entrada: Ninguno. v Salida: EXPORT.out db2move.lst Resultado resumido de la accin EXPORT. Lista de nombres de tabla originales, sus nombres de archivo PC/IXF correspondientes (tabnnn.ixf) y nombres de archivos de mensajes (tabnnn.msg). Esta lista, los archivos PC/IXF exportados y los archivos LOB (tabnnnc.yyy) se utilizan como entrada a la accin IMPORT o LOAD de db2move. Archivo PC/IXF exportado de una tabla especfica. Archivo de mensajes de exportacin de la tabla correspondiente. Archivos LOB exportados de una tabla especfica. nnn es el nmero de tabla. c es una letra del alfabeto. yyy es un nmero en el rango de 001 a 999. Estos archivos slo se crean si la tabla que se est exportando contiene datos LOB. Si se crean, estos archivos LOB se colocan en los directorios vaaccesolob. Existe un total de 26.000 nombres posibles para los archivos LOB. system.msg Archivo de mensajes que contiene mensajes del sistema para crear o suprimir mandatos de archivo o directorio. Slo se utiliza si la accin es EXPORT y se especifica una va de acceso de LOB.
tabnnn.ixf tabnnn.msg tabnnnc.yyy
Archivos necesarios/generados al utilizar IMPORT: v Entrada: db2move.lst tabnnn.ixf tabnnnc.yyy v Salida: IMPORT.out tabnnn.msg Resultado resumido de la accin IMPORT. Archivo de mensajes de importacin de la tabla correspondiente. Un archivo de salida de la accin EXPORT. Un archivo de salida de la accin EXPORT. Un archivo de salida de la accin EXPORT.
114
Command Reference

Archivos necesarios/generados al utilizar LOAD: v Entrada: db2move.lst tabnnn.ixf tabnnnc.yyy v Salida: LOAD.out tabnnn.msg Un archivo de salida de la accin EXPORT. Un archivo de salida de la accin EXPORT. Un archivo de salida de la accin EXPORT. Resultado resumido de la accin LOAD. Archivo de mensajes de LOAD de la tabla correspondiente.
Conceptos relacionados: v Management of multiple database buffer pools del manual Administration Guide: Performance Informacin relacionada: v Size of Log Files configuration parameter - logfilsiz del manual Administration Guide: Performance v Number of Primary Log Files configuration parameter - logprimary del manual Administration Guide: Performance v Sort Heap Size configuration parameter - sortheap del manual Administration Guide: Performance v Utility Heap Size configuration parameter - util_heap_sz del manual Administration Guide: Performance v db2look -Mandato Herramienta de extraccin de DDL y de estadsticas de DB2 en la pgina 103
115
db2mscs - Configurar programa de utilidad Failover de Windows db2mscs - Mandato Configurar programa de utilidad Failover de Windows
Crea la infraestructura para el soporte de failover de DB2 en Windows utilizando Microsoft Cluster Server (MSCS). Este programa de utilidad puede utilizarse para habilitar failover en entornos de base de datos particionada y de una sola particin. Autorizacin: El usuario deber estar conectado a una cuenta de usuario de dominio que pertenezca al grupo de Administradores de cada mquina del cluster MSCS. Sintaxis del mandato:
db2mscs -f: -u: archivo_entrada nombre_instancia
Parmetros del mandato: -f:archivo_entrada Especifica el archivo de entrada DB2MSCS.CFG que el programa de utilidad MSCS deber utilizar. Si no se especifica este parmetro, el programa de utilidad DB2MSCS leer el archivo DB2MSCS.CFG que hay en el directorio actual. -u:nombre_instancia Esta opcin permite deshacer la operacin de db2mscs y devolver la instancia a la instancia no MSCS especificada por nombre_instancia. Notas de uso: El programa de utilidad DB2MSCS es un programa de utilidad autnomo de lnea de mandatos que se utiliza para transformar una instancia no MSCS en una instancia MSCS. El programa de utilidad crear todos los grupos, recursos y dependencias de recursos MSCS. Tambin copiar toda la informacin de DB2 almacenada en el registro de Windows a la parte de clster del registro, y adems mover el directorio de la instancia a un disco de clster compartido. El programa de utilidad DB2MSCS toma como entrada un archivo de configuracin proporcionado por el usuario que especifica cmo debe configurarse el clster. El archivo DB2MSCS.CFG es un archivo de texto ASCII que contiene parmetros que el programa de utilidad DB2MSCS lee. Especifique cada parmetro de entrada en una lnea distinta, utilizando el siguiente formato: PALABRA_CLAVE_PARMETRO=valor_parmetro. Por ejemplo:
CLUSTER_NAME=FINANCE GROUP_NAME=Grupo DB2 IP_ADDRESS=9.21.22.89
116
Command Reference
db2mscs - Configurar programa de utilidad Failover de Windows

Pueden encontrarse dos ejemplos de archivos de configuracin en el subdirectorio CFG bajo el directorio de instalacin de DB2. El primero, DB2MSCS.EE, es un ejemplo de entornos de base de datos de una sola particin. El segundo, DB2MSCS.EEE, es un ejemplo de entornos de base de datos particionados. Los parmetros del archivo DB2MSCS.CFG son los siguientes: DB2_INSTANCE Nombre de la instancia de DB2. Este parmetro tiene un mbito global y slo debe especificarse una vez en el archivo DB2MSCS.CFG. DAS_INSTANCE Nombre de la instancia del Servidor de administracin DB2. Especifique este parmetro para migrar el Servidor de administracin DB2 a fin de ejecutarlo en el entorno MSCS. Este parmetro tiene un mbito global y slo debe especificarse una vez en el archivo DB2MSCS.CFG. CLUSTER_NAME Nombre del clster MSCS. Todos los recursos especificados siguiendo esta lnea se crean en este clster hasta que se especifica otro parmetro CLUSTER_NAME. DB2_LOGON_USERNAME Nombre de usuario de la cuenta de dominio para el servicio DB2 (o sea, dominio\usuario). Este parmetro tiene un mbito global y slo debe especificarse una vez en el archivo DB2MSCS.CFG. DB2_LOGON_PASSWORD Contrasea de la cuenta de dominio para el servicio DB2. Este parmetro tiene un mbito global y slo debe especificarse una vez en el archivo DB2MSCS.CFG. GROUP_NAME Nombre del grupo MSCS. Si se especifica este parmetro, se crea un nuevo grupo MSCS si no existe. Si el grupo ya existe, se utiliza como grupo de destino. Cualquier recurso MSCS especificado despus de este parmetro se crear en este grupo o se mover a este grupo hasta que se especifique otro parmetro GROUP_NAME. Especifique este parmetro una vez para cada grupo. DB2_NODE Nmero de particin del servidor de particiones de base de datos (o particin de base de datos) que ha de incluirse en el grupo MSCS actual. Si hay varias particiones lgicas de base de datos en la misma mquina, cada particin de base de datos requiere un parmetro DB2_NODE distinto. Especifique este parmetro despus del parmetro GROUP_NAME para que los recursos DB2 se creen en el
117

grupo MSCS correcto. Este parmetro es necesario para un sistema de base de datos con mltiples particiones. IP_NAME Nombre del recurso de Direccin IP. El valor de IP_NAME es arbitrario, pero debe ser exclusivo en el clster. Cuando se especifica este parmetro, se crea un recurso MSCS del tipo Direccin IP. Este parmetro es necesario para las conexiones TCP/IP remotas. Este parmetro es opcional en un entorno de una sola particin. Un nombre recomendado es el nombre de sistema principal que corresponde a la direccin IP. IP_ADDRESS Direccin TCP/IP para el recurso IP especificado por el parmetro IP_NAME anterior. Este parmetro es necesario si se especifica el parmetro IP_NAME. Es una direccin IP nueva que no utiliza ninguna mquina de la red. IP_SUBNET Mscara de subred TCP/IP para el recurso IP especificado por el parmetro IP_NAME anterior. Este parmetro es necesario si se especifica el parmetro IP_NAME. IP_NETWORK Nombre de la red MSCS a la que pertenece el recurso Direccin IP anterior. Este parmetro es opcional. Si no se especifica, se utiliza la primera red MSCS detectada por el sistema. El nombre de la red MSCS se debe entrar exactamente tal como se ve bajo la rama Redes del Administrador de clsteres. Nota: Las cuatro palabras clave IP anteriores se utilizan para crear un recurso Direccin IP. NETNAME_NAME Nombre del recurso Nombre de red. Especifique este parmetro para crear el recurso Nombre de red. Este parmetro es opcional para un entorno de base de datos de una sola particin. Debe especificar este parmetro para la mquina propietaria de la instancia en un entorno de base de datos particionado. NETNAME_VALUE Valor del recurso Nombre de red. Este parmetro debe especificarse si se especifica el parmetro NETNAME_NAME. NETNAME_DEPENDENCY Nombre del recurso IP del que depende el recurso Nombre de red. Cada recurso Nombre de red debe tener una dependencia de un
118
Command Reference

recurso Direccin IP. Este parmetro es opcional. Si no se especifica, el recurso Nombre de red tendr una dependencia del primer recurso IP del grupo. SERVICE_DISPLAY_NAME Nombre de pantalla del recurso Servicio genrico. Especifique este parmetro si desea crear un recurso Servicio genrico. SERVICE_NAME Nombre de servicio del recurso Servicio genrico. Este parmetro debe especificarse si se especifica el parmetro SERVICE_DISPLAY_NAME. SERVICE_STARTUP Parmetro de arranque opcional para el servicio Recurso genrico. DISK_NAME Nombre del recurso de disco fsico que ha de trasladarse al grupo actual. Especifique todos los recursos de disco que necesite. Los recursos de disco ya deben existir. Cuando el programa de utilidad DB2MSCS configura la instancia de DB2 para el soporte de failover, el directorio de la instancia se copia al primer disco MSCS del grupo. Para especificar un disco MSCS diferente para el directorio de la instancia, utilice el parmetro INSTPROF_DISK. El nombre de disco utilizado se debe entrar exactamente tal como se ve en el Administrador de clsteres. INSTPROF_DISK Parmetro opcional para especificar un disco MSCS que contenga el directorio de la instancia de DB2. Si no se especifica este parmetro, el programa de utilidad DB2MSCS utiliza el primer disco que pertenezca al mismo grupo. INSTPROF_PATH Parmetro opcional para especificar la va de acceso exacta en la que se copiar el directorio de la instancia. Este parmetro DEBE especificarse cuando se utilice IPSHAdisks, un recurso de disco Netfinity de ServerRAID (o sea, INSTPROF_PATH=p:\db2profs). INSTPROF_PATH tendr preferencia sobre INSTPROF_DISK si se especifican ambos. TARGET_DRVMAP_DISK Parmetro opcional para especificar el disco MSCS de destino para la correlacin de unidades de base de datos para un sistema de base de datos de mltiples particiones. Este parmetro especificar el disco donde se crear la base de datos al correlacionarla desde la unidad especificada por el mandato de crear base de datos. Si no se especifica este parmetro, es preciso registrar manualmente la correlacin de unidades de base de datos mediante el programa de utilidad DB2DRVMP.
119

DB2_FALLBACK Parmetro opcional para controlar si se debe forzar o no la desactivacin de las aplicaciones cuando el recurso DB2 se ponga fuera de lnea. Si no se especifica, el valor de DB2_FALLBACK ser YES. Si no desea que se fuerce la desactivacin de las aplicaciones, defina DB2_FALLBACK como NO.
120
Command Reference
db2mtrk - Rastreador de memoria db2mtrk -Mandato Rastreador de memoria

Proporciona un informe completo del estado de la memoria para instancias, bases de datos y agentes. Este mandato proporciona como salida la siguiente informacin sobre la asignacin de agrupaciones de memoria: v Tamao actual v Tamao mximo (lmite fijo) v Tamao mayor (marca de nivel) v Tipo (identificador que indica la funcin para la que se utilizar la memoria) v Agente que ha asignado la agrupacin (slo si sta es privada) La misma informacin est disponible tambin en el supervisor de instantneas. mbito En un entorno de bases de datos particionado, este mandato puede invocarse desde cualquier particin de base de datos definida en el archivo db2nodes.cfg. Devuelve informacin nicamente para esa particin. Este mandato no devuelve informacin para servidores remotos. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. La aplicacin crea una conexin de instancia por omisin si no hay una presente. Sintaxis del mandato:
db2mtrk i d p m w r intervalo recuento v
121
db2mtrk - Rastreador de memoria

Parmetros del mandato: -i -d Mostrar memoria a nivel de instancia. Mostrar memoria a nivel de base de datos. No est disponible en los sistemas Windows. -p -m -w -r Mostrar memoria privada. Mostrar valores mximos para cada agrupacin. Mostrar valores de nivel para cada agrupacin. Modalidad de repeticin
intervalo Nmero de segundos que hay que esperar entre llamadas posteriores al rastreador de memoria (en modalidad de repeticin). recuento Nmero de veces que hay que repetir. -v -h Salida verbosa. Mostrar pantalla de ayuda. Si se especifica -h, slo aparece la pantalla de ayuda. No se visualiza otra informacin.
Ejemplos: La siguiente llamada devuelve valores normales de base de datos y de instancia y se repite cada 10 segundos:
db2mtrk -i -d -v -r 10
Examine los siguientes ejemplos de salida: El mandato db2mtrk -i -d -p muestra la siguiente salida:
Rastreando memoria el: 2002/02/25 a las 02:14:10 Memoria para instancia monh otra 168 3,1M Memoria para base de datos: EKWAN utilh pckcacheh catcacheh lockh 56 588,8K 470,2K 432,8K Memoria para base de datos: AJSTORM utilh pckcacheh catcacheh lockh 56 55,6K 38,3K 432,8K Memoria para agente 154374 apph appctlh stmth 357,1K 37,2K 209,5K dbh 1,8M dbh 1,7M otra 5,1M otra 5,1M
122
Command Reference
db2mtrk - Rastreador de memoria

Memoria para agente 213930 apph appctlh 26,3K 4,0K
El mandato db2mtrk -i -d -p -v muestra la siguiente salida:

Rastreando memoria el: 2002/02/25 a las 17:19:12 Memoria para instancia La Pila de supervisor de base de datos tiene un tamao de 168 bytes Otra Memoria tiene un tamao de 3275619 bytes Total: 3275787 bytes Memoria para base de datos: EKWAN La Copia seguridad/Restauracin/Pila util tiene el tamao de 56 bytes La Antememoria de paquete tiene el tamao de 56888 bytes La Pila de antememoria de catlogo tiene el tamao de 39184 bytes La Pila de gestor de bloqueos tiene el tamao de 443200 bytes La Pila de base de datos tiene un tamao de 1749734 bytes Otra Memoria tiene un tamao de 5349197 bytes Total: 7638259 bytes Memoria para base de datos: AJSTORM La Copia seguridad/Restauracin/Pila util tiene el tamao de 56 bytes La Antememoria de paquete tiene el tamao de 56888 bytes La Pila de antememoria de catlogo tiene el tamao de 39184 bytes La Pila de gestor de bloqueos tiene el tamao de 443200 bytes La Pila de base de datos tiene un tamao de 1749734 bytes Otra Memoria tiene un tamao de 5349197 bytes Total: 7638259 bytes Memoria para agente 154374 La Pila de aplicacin tiene un tamao de 26888 bytes La Pila de control de aplicacin tiene un tamao de 4107 bytes Total: 30995 bytes Memoria para agente 213930 La Pila de aplicacin tiene un tamao de 26888 bytes La Pila de control de aplicacin tiene un tamao de 4107 bytes Total: 30995 bytes
Notas de uso: Notas: 1. Cuando no se especifica ningn distintivo, se devuelve el uso. 2. Cuando se especifica el distintivo -p, se devuelve la informacin de uso de memoria privada detallada, ordenada por el ID de agente. 3. En algunos casos (como la antememoria de paquete) el tamao mximo visualizado ser mayor que el valor asignado al parmetro de configuracin. En tales casos, el valor asignado al parmetro de configuracin se utiliza como lmite flexible y el uso real de la memoria de la agrupacin puede crecer ms all del tamao configurado.
123
db2nchg - Cambiar configuracin de servidor de particiones de base de datos db2nchg -Mandato Cambiar configuracin de servidor de particiones de base de datos
Modifica la configuracin de servidor de particiones de base de datos. Esto incluye el traslado del servidor de particiones de base de datos (nodo) de una mquina a otra, el cambio del nombre de sistema principal TCP/IP de la mquina y la seleccin de un nmero de puerto lgico diferente o un nombre de red diferente para el servidor de particiones de base de datos (nodo). Este mandato slo se puede utilizar si se detiene el servidor de particiones de base de datos. Este mandato slo est disponible en los sistemas operativos basados en Windows NT. Autorizacin: Administrador local Sintaxis del mandato:
db2nchg /n: nm_particin_bd /i: nombre_instancia
/u:
usuario,contrasea
/p:
puerto_lgico
/h:
nombresistpral
/m:
nombre_mquina
/g:
nombre_red
Parmetros del mandato: /n:nm_particin_bd Especifica el nmero de particin de base de datos de la configuracin del servidor de particiones de base de datos que se ha de cambiar. /i:nombre_instancia Especifica la instancia en la que participa este servidor de particiones de base de datos. Si no se especifica ningn parmetro, el valor por omisin es la instancia actual. /u:nombreusuario,contrasea Especifica el nombre de usuario y la contrasea. Si no se especifica ningn parmetro, se aplicarn el nombre de usuario y la contrasea existentes. /p:puerto_lgico Especifica el puerto lgico para el servidor de particiones de base de datos. Este parmetro debe especificarse para trasladar el servidor de
124
Command Reference
db2nchg - Cambiar configuracin de servidor de particiones de base de datos

particiones de base de datos a una mquina diferente. Si no se especifica ningn parmetro, permanecer el nmero de puerto lgico sin modificarse. /h:nombre_sistpral Especifica el nombre de sistema principal TCP/IP utilizado por FCM para las comunicaciones internas. Si no se especifica este parmetro, el nombre de sistema principal seguir siendo el mismo. /m:nombre_mquina Especifica la mquina donde residir el servidor de particiones de base de datos. El servidor de particiones de base de datos slo se puede mover si no hay ninguna base de datos existente en la instancia. /g:nombre_red Cambia el nombre de red para el servidor de particiones de base de datos. Este parmetro puede utilizarse para aplicar una direccin IP especfica al servidor de particiones de base de datos cuando hay mltiples direcciones IP en una mquina. Se puede entrar el nombre de red o la direccin IP. Ejemplos: Para cambiar el puerto lgico asignado a la particin de base de datos 2, que participa en la instancia TESTMPP, al puerto lgico 3, entre el siguiente mandato:
db2nchg /n:2 /i:TESTMPP /p:3
Informacin relacionada: v db2ncrt -Mandato Aadir servidor de particiones de base de datos a una instancia en la pgina 126 v db2ndrop -Mandato Eliminar servidor de particiones de base de datos de una instancia en la pgina 129
125
db2ncrt - Aadir servidor de particiones de base de datos a una instancia db2ncrt -Mandato Aadir servidor de particiones de base de datos a una instancia
Aade un servidor de particiones de base de datos (nodo) a una instancia. Este mandato slo est disponible en los sistemas operativos basados en Windows NT. mbito: Si se aade un servidor de particiones de base de datos a un sistema en el que ya existe una instancia, se aade un servidor de particiones de base de datos al sistema como un servidor lgico de particiones de base de datos. Si se aade un servidor de particiones de base de datos a un sistema en el que no exista una instancia, se aade la instancia y el sistema se convierte en un nuevo servidor fsico de particiones de base de datos. Este mandato no debe utilizarse si existen bases de datos en una instancia. En su lugar, se deber utilizar el mandato db2start addnode nodenum. Esto asegura que la base de datos se aada correctamente al nuevo servidor de particiones de base de datos. Tambin es posible aadir un servidor de particiones de base de datos a una instancia en la que se ha creado una base de datos. Nota: El archivo db2nodes.cfg no deber editarse porque, si se modifica el archivo, se pueden producir incoherencias en el sistema de base de datos particionada. Autorizacin: Autorizacin de Administrador local en el sistema donde se aade el nuevo servidor de particiones de base de datos. Sintaxis del mandato:
db2ncrt /n: nm_particin_bd /u: nombreusuario,contrasea
/i:
nombre_instancia
/m:
nombre_mquina
/p:
puerto_lgico
/h:
nombre_sistpral
/g:
nombre_red
/o:
mquina_propietaria_instancia
126
Command Reference
db2ncrt - Aadir servidor de particiones de base de datos a una instancia

Parmetros del mandato: /n:nm_particin_bd Nmero exclusivo de particin de base de datos que identifica el servidor de particiones de base de datos. El nmero entrado puede estar en el rango de 1 a 999. /u:nombre_dominio\nombreusuario,contrasea Especifica el dominio, el nombre de cuenta de conexin y la contrasea para DB2. /i:nombre_instancia Especifica el nombre de instancia. Si no se especifica ningn parmetro, el valor por omisin es la instancia actual. /m:nombre_mquina Especifica el nombre de sistema de la estacin de trabajo Windows en la que reside el servidor de particiones de base de datos. Este parmetro es necesario si se aade un servidor de particiones de base de datos en un sistema remoto. /p:puerto_lgico Especifica el nmero de puerto lgico utilizado para el servidor de particiones de base de datos. Si no se especifica este parmetro, el nmero de puerto lgico asignado ser 0. Nota: Al crear un servidor lgico de particiones de base de datos, debe especificarse este parmetro y debe seleccionarse un nmero de puerto lgico que no se est utilizando. Tenga en cuenta las restricciones siguientes: v Cada sistema debe tener un servidor de particiones de base de datos que tiene un puerto lgico 0. v Este nmero de puerto no puede exceder el rango de puerto reservado para las comunicaciones FCM en el directorio x:\winnt\system32\drivers\etc\. Por ejemplo, si se ha reservado un rango de 4 puertos para la instancia actual, el nmero mximo de puerto es 3. El puerto 0 se utiliza para el servidor lgico de particiones de base de datos por omisin. /h:nombre_sistpral Especifica el nombre de sistema principal TCP/IP utilizado por FCM para las comunicaciones internas. Este parmetro es necesario cuando se aade un servidor de particiones de base de datos en un sistema remoto. /g:nombre_red Especifica el nombre de red para el servidor de particiones de base de datos. Si no se especifica ningn parmetro, se utilizar la primera direccin IP detectada en el sistema. Este parmetro puede utilizarse
127
db2ncrt - Aadir servidor de particiones de base de datos a una instancia

para aplicar una direccin IP especfica al servidor de particiones de base de datos cuando hay mltiples direcciones IP en un sistema. Se puede entrar el nombre de red o la direccin IP. /o:mquina_propietaria_instancia Especifica el nombre de sistema del sistema propietario de la instancia. El valor por omisin es el sistema local. Este parmetro es necesario cuando se invoca el mandato db2ncrt en cualquier sistema que no sea el sistema propietario de la instancia. Ejemplos: Para aadir un servidor de particiones de base de datos nuevo a la instancia TESTMPP en el sistema propietario de instancia SHAYER, donde el nuevo servidor de particiones de base de datos se conoce como particin de base de datos 2 y utiliza el puerto lgico 1, entre el mandato siguiente:
db2ncrt /n:2 /u:QBPAULZ\paulz,g1reeky /i:TESTMPP /m:TEST /p:1 /o:SHAYER
Informacin relacionada: v db2nchg -Mandato Cambiar configuracin de servidor de particiones de base de datos en la pgina 124 v db2ndrop -Mandato Eliminar servidor de particiones de base de datos de una instancia en la pgina 129
128
Command Reference
db2ndrop - Eliminar servidor de particiones de base de datos de una instancia db2ndrop -Mandato Eliminar servidor de particiones de base de datos de una instancia
Elimina un servidor de particiones de base de datos (nodo) de una instancia que no tiene bases de datos. Si se elimina un servidor de particiones de base de datos, su nmero de particin de base de datos se puede volver a utilizar para un nuevo servidor de particiones de base de datos. Este mandato slo se puede utilizar si se detiene el servidor de particiones de base de datos. Este mandato slo est disponible en los sistemas operativos basados en Windows NT. Autorizacin: Autorizacin de Administrador local en la mquina donde se est eliminando el servidor de particiones de base de datos. Sintaxis del mandato:
db2ndrop /n: nm_particin_bd /i: nombre_instancia
Parmetros del mandato: /n:nm_particin_bd Nmero exclusivo de particin de base de datos que identifica el servidor de particiones de base de datos. /i:nombre_instancia Especifica el nombre de instancia. Si no se especifica ningn parmetro, el valor por omisin es la instancia actual. Ejemplos:
db2ndrop /n:2 /i=KMASCI
Notas de uso: Si se elimina de la instancia el servidor de particiones de base de datos propietario de instancia (nm_particin_bd 0), la instancia queda inutilizable. Para eliminar la instancia, utilice el mandato db2idrop. Este mandato no debe utilizarse si existen bases de datos en esta instancia. En su lugar, se deber utilizar el mandato db2stop drop nodenum. ste asegura que el servidor de particiones de base de datos se elimine correctamente del sistema de base de datos de particin. Tambin es posible eliminar un servidor de particiones de base de datos en una instancia donde existe una base de datos.
129
db2ndrop - Eliminar servidor de particiones de base de datos de una instancia

Nota: El archivo db2nodes.cfg no deber editarse porque, si se modifica el archivo, se pueden producir incoherencias en el sistema de base de datos particionada. Para eliminar un servidor de particiones de base de datos asignado al puerto lgico 0 de una mquina que ejecuta mltiples servidores lgicos de particiones de base de datos, primero se deben eliminar todos los dems servidores de particiones de base de datos asignados a los dems puertos lgicos. Cada servidor de particiones de base de datos debe tener un servidor de particiones de base de datos asignado al puerto lgico 0. Informacin relacionada: v db2nchg -Mandato Cambiar configuracin de servidor de particiones de base de datos en la pgina 124 v db2ncrt -Mandato Aadir servidor de particiones de base de datos a una instancia en la pgina 126
130
Command Reference
db2osconf - Programa de utilidad para los valores de parmetro de kernel db2osconf - Mandato Programa de utilidad para los valores de parmetro de kernel
Efecta recomendaciones para los valores de parmetro de kernel en base al tamao de un sistema. Los valores recomendados son lo bastante elevados para un sistema determinado para que puedan admitir la mayor parte de cargas de trabajo razonables. Este mandato slo est disponible actualmente para DB2 en sistemas Solaris. Autorizacin: Para utilizar este programa de utilidad, debe tener acceso root o ser miembro del grupo sys. Conexin necesaria: Sintaxis del mandato: Para obtener la lista de opciones soportadas actualmente, basta con entrar db2osconf -h:
db2osconf -h Uso: -c -f -h -l -m <mem en GB> -n <nm CPU> -p <nivel perf> -s <factor escala> -t <hebras> # # # # # # # # # Slo cliente Comparar con actual Pantalla de ayuda Listar actual Especificar memoria en GB Especificar nmero de las CPU Nivel de rendimiento de C mens. (0-3) Factor de escala (1-3) Nmero de hebras
El conmutador -c es para instalaciones que son slo de cliente. Parmetros del mandato:
-f
El conmutador -f puede utilizarse para comparar los parmetros de kernel actuales con los valores que el programa de utilidad db2osconf recomendara. Slo se mostrarn los parmetros de kernel que difieran. Dado que los parmetros de kernel actuales se toman directamente del kernel activo, puede que no coincidan con los de /etc/system, el archivo de especificaciones del sistema Solaris. Si los parmetros de kernel del kernel activo son distintos de los listados en /etc/system, el archivo /etc/system puede haberse modificado sin rearrancar o puede haber un error de sintaxis en el archivo.
131
db2osconf - Programa de utilidad para los valores de parmetro de kernel

-l -m El conmutador -l simplemente lista los parmetros actuales de kernel El conmutador -m altera temporalmente la cantidad de memoria fsica en GB. Normalmente, el programa de utilidad db2osconf determinar automticamente la cantidad de memoria fsica. El conmutador -n altera temporalmente el nmero de las CPU del sistema. Normalmente, los programas de utilidad db2osconf determinarn automticamente el nmero de las CPU. El conmutador -p define el nivel de rendimiento para las colas de mensaje SYSV. 0 (cero) es el valor por omisin y 3 es el valor ms elevado. Definir un valor mayor puede aumentar el rendimiento del recurso de colas de mensajes a costa de la utilizacin de ms memoria. El conmutador -s define el factor de escala. El factor de escala por omisin es 1 y debe ser suficiente para casi cualquier carga de trabajo. Si no basta con un factor de escala 1, el sistema puede ser demasiado pequeo para manejar la carga de trabajo. El factor de escala define las recomendaciones de los parmetros de kernel como los de un sistema proporcionalmente mayor que el tamao del sistema actual. Por ejemplo, con un factor de escala 2,5 se recomendaran parmetros de kernel para un sistema con un tamao equivalente a 2,5 veces el del sistema actual. El conmutador -t proporciona recomendaciones para los valores de parmetros de kernel semsys:seminfo_semume y shmsys:shminfo_shmseg. En el caso de los programas de mltiples hebras con un nmero equitativo de conexiones, estos parmetros de kernel se pueden haber definido con valores superiores a sus valores por omisin. Slo tienen que restablecerse si el programa de mltiples hebras que los necesita es una aplicacin local: semsys:seminfo_semume Lmite de estructuras de deshacer de semforo que cualquier proceso individual puede utilizar shmsys:shminfo_shmseg Lmite del nmero de segmentos de memoria compartida que cualquier proceso individual puede crear. Estos parmetros estn definidos en el archivo /etc/system. A continuacin se muestra una gua para definir los valores y es lo que la herramienta db2osconf utiliza para recomendarlos. Por cada conexin local, DB2 utilizar un semforo y un segmento de memoria compartida para comunicarse. Si suponemos que la aplicacin de mltiples hebras es una aplicacin local y tiene un nmero X de conexiones con DB2, esa aplicacin (proceso) necesitar un nmero X
-n
-p
-s
-t
132
Command Reference

de segmentos de memoria compartida y un nmero X de estructuras de deshacer de semforo para comunicarse con DB2. Por consiguiente, el valor de los dos parmetros de kernel se debe definir como X + 10 (el valor 10 adicional proporciona un margen de seguridad). Sin los conmutadores -l o -f, el programa de utilidad db2osconf muestra los parmetros de kernel utilizando la sintaxis del archivo /etc/system. Para prevenir errores humanos, la salida se puede cortar y pegar directamente en el archivo /etc/system. Los parmetros de kernel se recomiendan segn el nmero de las CPU y la cantidad de memoria fsica en el sistema. Si uno es desproporcionadamente bajo, las recomendaciones se basarn en el valor ms bajo de los dos. Ejemplos: sta es una salida de ejemplo producida al ejecutar la herramienta con el conmutador -t definido para 500 hebras. Nota: Los resultados recibidos son especficos de la mquina, de modo que los resultados que se reciban variarn segn el entorno Solaris.
db2osconf -t 500 set set set set set set set set set set set set set set set msgsys:msginfo_msgmax msgsys:msginfo_msgmnb msgsys:msginfo_msgssz msgsys:msginfo_msgseg msgsys:msginfo_msgmap msgsys:msginfo_msgmni msgsys:msginfo_msgtql semsys:seminfo_semmap semsys:seminfo_semmni semsys:seminfo_semmns semsys:seminfo_semmnu semsys:seminfo_semume shmsys:shminfo_shmmax shmsys:shminfo_shmmni shmsys:shminfo_shmseg = = = = = = = = = = = = = = = 65535 65535 32 32767 2562 2560 2560 3074 3072 6452 3072 600 2134020096 3072 600
Espacio de kernel total para IPC: 0,35MB (shm) + 1,77MB (sem) + 1,34MB (msg) == 3,46MB (total)
Los valores recomendados para set semsys:seminfo_semume y set shmsys:shminfo_shmseg eran los valores adicionales proporcionados al ejecutar db2osconf -t 500.
133

Notas de uso: Aunque es posible recomendar parmetros de kernel basados en una carga de trabajo determinada de DB2, este nivel de precisin no es beneficioso. Si los valores de parmetros de kernel son demasiado prximos a los realmente necesarios y la carga de trabajo cambia en el futuro, DB2 puede tener un problema a causa de la falta de recursos de comunicaciones entre procesos (IPC). La carencia de recursos IPC puede conducir a una interrupcin del servicio no planificada para DB2 y sera necesario rearrancar para aumentar los parmetros de kernel. Al definir los parmetros de kernel con valores razonablemente elevados, se debera reducir o eliminar la necesidad de cambiarlos en el futuro. La cantidad de memoria consumida por las recomendaciones de parmetros de kernel es casi trivial, comparada con el tamao del sistema. Por ejemplo, para un sistema con 4 GB de RAM y 4 CPU, la cantidad de memoria para los parmetros de kernel recomendados es de 4,67 MB o 0,11%. Dados los beneficios que produce, esta pequea fraccin de memoria utilizada para los parmetros de kernel debe ser aceptable. Hay dos versiones del programa de utilidad db2osconf: una para los kernels de 64 bits y una para los kernels de 32 bits. El programa de utilidad tambin tiene que ejecutarse como root o con el grupo sys, ya que accede a los siguientes dispositivos especiales (los accesos son de slo lectura):
crw-r----crw-rw-rwcrw-r----1 root 1 root 1 root sys sys sys 13, 72, 13, 1 Jul 19 18:06 /dev/kmem 0 Feb 19 1999 /dev/ksyms 0 Feb 19 1999 /dev/mem
134
Command Reference
db2perfc - Restablecer valores de rendimiento de base de datos db2perfc -Mandato Restablecer valores de rendimiento de base de datos
Restablece los valores de rendimiento para una o ms bases de datos. Se utiliza con el Supervisor de rendimiento en los sistemas operativos Windows. Autorizacin: Administrador local de Windows. Conexin necesaria: Ninguna Sintaxis del mandato:
db2perfc -d aliasbd
Parmetros del mandato: -d Especifica que se deben restablecer los valores de rendimiento para las bases de datos DCS.
aliasbd Especifica las bases de datos para las que se deben restablecer los valores de rendimiento. Si no se especifica ninguna base de datos, se restablecern los valores de rendimiento para todas las bases de datos activas. Notas de uso: Cuando una aplicacin llama a las API del supervisor DB2, la informacin devuelta consta normalmente de los valores acumulativos desde que se inici el servidor DB2. Sin embargo, normalmente es til restablecer los valores de rendimiento, ejecutar una prueba, restablecer los valores de nuevo y, a continuacin, volver a ejecutar la prueba. El programa restablece los valores para todos los programas que acceden actualmente a la informacin de rendimiento de la base de datos para la instancia de servidor DB2 relevante (es decir, la retenida en db2instance en la sesin en la que se ejecuta db2perfc). Al invocar db2perfc tambin se restablecen los valores vistos por cualquier usuario que acceda remotamente a la informacin de rendimiento de DB2 cuando se ejecute el mandato. La API db2ResetMonitor permite que una aplicacin restablezca los valores que ve localmente, no globalmente, para bases de datos especficas.
135
db2perfc - Restablecer valores de rendimiento de base de datos

Ejemplos: El ejemplo siguiente restablece los valores de rendimiento para todas las bases de datos DB2 activas:
db2perfc
El ejemplo siguiente restablece los valores de rendimiento para bases de datos DB2 especficas:
db2perfc aliasbd1 aliasbd2
El ejemplo siguiente restablece los valores de rendimiento para todas las bases de datos DCS DB2 activas:
db2perfc -d
El ejemplo siguiente restablece los valores de rendimiento para bases de datos DCS DB2 especficas:
db2perfc -d aliasbd1 aliasbd2
Informacin relacionada: v db2ResetMonitor - Reset Monitor del manual Administrative API Reference
136
Command Reference
db2perfi - Programa de utilidad de registro de contadores de rendimiento db2perfi -Mandato Programa de utilidad de registro de contadores de rendimiento
Aade los Contadores de rendimiento de DB2 al sistema operativo Windows. Esto debe realizarse para que la informacin de rendimiento de DB2 y DB2 Connect sea accesible para el Supervisor de rendimiento de Windows. Autorizacin: Administrador local de Windows. Conexin necesaria: Ninguna Sintaxis del mandato:
db2perfi -i -u
Parmetros del mandato: -i -u Registra los contadores de rendimiento de DB2. Elimina el registro de los contadores de rendimiento de DB2.
Notas de uso: El mandato db2perfi -i realizar las acciones siguientes: 1. Aadir los nombres y las descripciones de los objetos de contadores de DB2 al registro de Windows. 2. Crear una clave de registro en la clave Servicios del registro de Windows, como se indica a continuacin:
HKEY_LOCAL_MACHINE \System \CurrentControlSet \Services \DB2_NT_Performance \Performance Library=Nombre de la DLL de soporte de rendimiento de DB2 Open=Nombre de la funcin de abrir, llamada cuando se carga la DLL por primera vez Collect=Nombre de la funcin de recoger, llamada para solicitar la informacin de rendimiento Close=Nombre de la funcin de cerrar, llamada cuando se descarga la DLL
137
db2perfr - Herramienta de registro de supervisor de rendimiento db2perfr -Mandato Herramienta de registro de supervisor de rendimiento
Se utiliza con el Supervisor de rendimiento en los sistemas operativos Windows. El mandato db2perfr se utiliza para registrar un nombre de usuario administrador y su contrasea con DB2 cuando se accede a los contadores de rendimiento. Esto permite que una peticin remota del Supervisor de rendimiento se identifique correctamente ante el gestor de bases de datos DB2 y se le permita acceder a informacin de rendimiento relevante de DB2. Tambin tiene que registrar un nombre de usuario administrador y una contrasea si desea anotar cronolgicamente la informacin de contador en un archivo utilizando la funcin Anotaciones cronolgicas de rendimiento. Autorizacin: Administrador local de Windows. Conexin necesaria: Ninguna Sintaxis del mandato:
db2perfr -r nombreusuario -u contrasea
Parmetros del mandato: -r -u Registra el nombre de usuario y la contrasea. Elimina el registro del nombre de usuario y la contrasea.
Notas de uso: v Una vez que se ha registrado una combinacin de nombre de usuario y contrasea con DB2, incluso las instancias locales del Supervisor de rendimiento se conectarn de forma explcita utilizando ese nombre de usuario y esa contrasea. Esto quiere decir que, si la informacin de nombre de usuario registrada con DB2 no coincide, las sesiones locales del Supervisor de rendimiento no mostrarn la informacin de rendimiento de DB2. v La combinacin del nombre de usuario y la contrasea debe mantenerse para que coincida con los valores de nombre de usuario y contrasea que estn almacenados en la base de datos de Seguridad de Windows NT. Si se cambia el nombre de usuario o la contrasea en la base de datos de Seguridad de Windows NT, debe restablecerse la combinacin de nombre de usuario y contrasea utilizada para la supervisin de rendimiento.
138
Command Reference
db2perfr - Herramienta de registro de supervisor de rendimiento

v El nombre de usuario por omisin del Supervisor de rendimiento de Windows, SYSTEM, es una palabra reservada de DB2 y no se puede utilizar.
139
db2profc - Personalizador de perfiles SQLj de DB2 db2profc -Mandato Personalizador de perfiles SQLj de DB2
Procesa un perfil SQLj que contiene sentencias de SQL incorporadas. Por omisin, se crea un paquete DB2 en la base de datos; este programa de utilidad aumenta el perfil con informacin especfica de DB2 para utilizarla durante la ejecucin. Este programa de utilidad debe ejecutarse despus de haber convertido la aplicacin SQLj, pero antes de que sta se ejecute. Autorizacin: Una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio BINDADD si no existe un paquete y una de las opciones siguientes: Autorizacin de IMPLICIT_SCHEMA en la base de datos si no existe el nombre de esquema del paquete Privilegio CREATEIN en el esquema si existe el nombre de esquema del paquete v Privilegio ALTERIN en el esquema si existe el paquete v Privilegio BIND en el paquete si ste existe. El usuario tambin necesita todos los privilegios necesarios para compilar las sentencias de SQL estticas en la aplicacin. Los privilegios otorgados a grupos no se utilizan para la comprobacin de autorizacin de las sentencias estticas. Si el usuario tiene autorizacin sysadm, pero no tiene privilegios explcitos para completar la vinculacin, el gestor de bases de datos otorga automticamente autorizacin dbadm explcita. Conexin necesaria: Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2profc -user= nombreusuario -password= contrasea url-JDBC nombreperfil
-url= -prepoptions= opciones-precompilacin
Parmetros del mandato: -user= nombreusuario Especifica el nombre utilizado al conectarse a una base de datos para realizar la personalizacin de perfil.
140
Command Reference
db2profc - Personalizador de perfiles SQLj de DB2

-password= contrasea Especifica la contrasea para el nombre de usuario. -prepoptions= opciones-precompilacin Especifica una lista de opciones de precompilacin que deber utilizar el precompilador DB2. La opcin de precompilacin PACKAGE USING nombre-paquete especifica el nombre del paquete que el precompilador deber generar. Si no se entra ningn nombre, se utilizar el nombre del perfil (menos la extensin y convertido a maysculas). La longitud mxima es de 8 caracteres. La opcin de precompilacin BINDFILE USING archivo-vinculacin especifica el nombre del archivo de vinculacin que deber generar el precompilador. El nombre de archivo debe tener una extensin de .bnd. Si no se entra ningn nombre de archivo, el precompilador utilizar el nombre del perfil y aadir la extensin .bnd. Si no se proporciona una va de acceso, el archivo de vinculacin se crea en el directorio actual. -url= url-JDBC Especifica un URL JDBC para establecer la conexin de base de datos. nombreperfil Especifica el nombre de un perfil en el que estn almacenadas las sentencias de SQL. Cuando un archivo SQLj se convierte en un archivo Java, la informacin acerca de las operaciones SQL que contiene se almacena en archivos de recursos generados por SQLj que se denominan perfiles. Los perfiles se identifican por el sufijo _SJProfileN (donde N es un entero) a continuacin del nombre del archivo de entrada original. Tienen una extensin .ser. Los nombres de perfil pueden especificarse con o sin la extensin .ser. Ejemplos:
db2profc -user=nombreusuario -password=contrasea -url=url-JDBC -prepoptions="bindfile using pgmname1.bnd package using pgmname1" pgmname_SJProfile1.ser
Notas de uso: Informacin relacionada: v db2profp -Mandato Impresora de perfiles SQLj de DB2 en la pgina 142
141
db2profp - Impresora de perfiles SQLj de DB2 db2profp -Mandato Impresora de perfiles SQLj de DB2
Imprime el contenido de una versin DB2 personalizada de un perfil en texto plano. Autorizacin: Ninguna Conexin necesaria: Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2profp -user= nombreusuario -password= contrasea -url= url-JDBC
nombreperfil
Parmetros del mandato: -user= nombreusuario Especifica el nombre utilizado al conectarse a una base de datos para imprimir el perfil personalizado. -password= contrasea Especifica la contrasea para el nombre de usuario. -url= url-JDBC Especifica un URL JDBC para establecer la conexin de base de datos. nombreperfil Especifica uno o ms perfiles en los que se almacenan sentencias de SQL. Cuando un archivo SQLj se convierte en un archivo Java, la informacin acerca de las operaciones SQL que contiene se almacena en archivos de recursos generados por SQLj que se denominan perfiles. Los perfiles se identifican por el sufijo _SJProfileN (donde N es un entero) a continuacin del nombre del archivo de entrada original. Tienen una extensin .ser. Los nombres de perfil pueden especificarse con o sin la extensin .ser. Ejemplos:
db2profp -user=nombreusuario -password=contrasea -url=url-JDBC pgmname_SJProfile1.ser
142
Command Reference
db2profp - Impresora de perfiles SQLj de DB2

Informacin relacionada: v db2profc -Mandato Personalizador de perfiles SQLj de DB2 en la pgina 140
143
db2rbind - Volver a vincular todos los paquetes db2rbind -Mandato Volver a vincular todos los paquetes
Vuelve a vincular paquetes de una base de datos. Autorizacin: Una de las siguientes: v sysadm v dbadm Conexin necesaria: Ninguna Sintaxis del mandato:
db2rbind basedatos /l archivoanotcron all
/r /u idusuario /p contrasea
conservative any
Parmetros del mandato: basedatos Especifica un nombre de alias para la base de datos cuyos paquetes deben revalidarse. /l Especifica la va de acceso (opcional) y el nombre de archivo (obligatorio) que se deben utilizar para registrar errores resultantes del procedimiento de revalidacin de paquetes. Especifica que se deben volver a vincular todos los paquetes vlidos y no vlidos. Si no se especifica esta opcin, se examinan todos los paquetes de la base de datos, pero slo se vuelven a vincular los paquetes que estn marcados como no vlidos, de modo que se no se vuelvan a vincular implcitamente durante la ejecucin de la aplicacin. ID de usuario. Se debe especificar este parmetro si se especifica una contrasea. Contrasea. Se debe especificar este parmetro si se especifica un ID de usuario. Resolver. Especifica si se debe volver a vincular el paquete con o sin semntica de vinculacin conservadora. Esto afecta al hecho de que se tengan en cuenta las funciones y los tipos de datos nuevos durante la
all
/u /p /r
144
Command Reference
db2rbind - Volver a vincular todos los paquetes

resolucin de funcin y la resolucin de tipo en las sentencias DML estticas del paquete. DRDA no soporta esta opcin. Los valores vlidos son: conservative Para la resolucin de funciones y tipos slo se tienen en cuenta las funciones y los tipos de la va de acceso de SQL que se han definido antes de la ltima indicacin de fecha y hora explcita de vinculacin. Se utiliza semntica de vinculacin conservadora. ste es el valor por omisin. Esta opcin no est soportada para un paquete no operativo. any Para la resolucin de funciones y tipos se tiene en cuenta cualquiera de las funciones y de los tipos de la va de acceso de SQL. No se utiliza semntica de vinculacin conservadora.
Notas de uso: v Este mandato utiliza la API de volver a vincular (sqlarbnd) para intentar volver a validar todos los paquetes de una base de datos. v El uso de db2rbind no es obligatorio. v En el caso de los paquetes no vlidos, se puede elegir que se pueda volver a validar los paquetes de forma implcita cuando el paquete se utilice por primera vez. Puede elegir volver a validar los paquetes selectivamente con el mandato REBIND o BIND. v Si al volver a vincular cualquier paquete se encuentra un punto muerto o un tiempo de espera excedido de bloqueo, se retrotraer la operacin de todos los paquetes de volver a vincular. Informacin relacionada: v Mandato BIND en la pgina 222 v Mandato PRECOMPILE en la pgina 537 v Mandato REBIND en la pgina 581
145
db2_recon_aid - RECONCILE en mltiples tablas db2_recon_aid -Mandato RECONCILE en mltiples tablas

El programa de utilidad db2_recon_aid proporciona una interfaz para el programa de utilidad RECONCILE de DB2. El programa de utilidad RECONCILE opera en una sola tabla a la vez para validar todas las referencias de columnas DATALINK de esa tabla (y repararlas de la manera correspondiente). Hay ocasiones en que es posible que el programa de utilidad RECONCILE tenga que ejecutarse para mltiples tablas. Con esta finalidad se proporciona db2_recon_aid. Como el programa de utilidad RECONCILE, el programa de utilidad db2_recon_aid debe ejecutarse en un servidor DB2 que contenga tablas con columnas DATALINK que hay que reconciliar. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Ninguna. Este mandato establece automticamente una conexin a la base de datos especificada. Sintaxis del mandato:
db2_recon_aid
-db nombre basedatos -check -reportdir directorio de informes -selective -server servidor dlfm prefixes
lista prefijos
Donde lista prefijos es uno o ms prefijos DLFS delimitados por un carcter de dos puntos, por ejemplo prefijo1:prefijo2:prefijo3.
146
Command Reference
db2_recon_aid - RECONCILE en mltiples tablas

Parmetros del mandato: -db nombre base datos Nombre de la base de datos que contiene las tablas con columnas DATALINK que hay que reconciliar. Este parmetro es necesario. -check Lista las tablas que posiblemente sea preciso reconciliar. Si utiliza este parmetro, no se ejecutar ninguna operacin de reconciliacin. Este parmetro es necesario cuando se no se ha especificado el parmetro -reportdir. -reportdir Especifica el directorio donde el programa de utilidad ha de colocar un informe para cada una de las operaciones de reconciliacin. Para cada tabla en la que se realice la reconciliacin, se crearn archivos del formato <esquematabla>.<nombretabla>.<ext>, donde v <esquematabla> es el esquema de la tabla; v <nombretabla> es el nombre de tabla; v <ext> es .ulk o .exp. El archivo .ulk contiene una lista de archivos que se desenlazaron en el servidor de Data Links y el archivo .exp contiene una lista de archivos que estaban como excepciones en el servidor de Data Links. Si se especifica tanto -check como -reportdir, -reportdir se pasa por alto. -selective Slo se procesan las tablas con columnas DATALINK que contengan referencias de archivos que coincidan con los criterios de -server y -prefixes especificados. v Si utiliza este parmetro, tambin debe utilizar los parmetros -server y -prefixes. v Si no utiliza este parmetro, todos los servidores Data Links y sus prefijos registrados con la base de datos DB2 especificada se reconciliarn o se marcarn con distintivos para indicar que es necesaria su reconciliacin. -prefixes lista prefijos Es necesario cuando se utiliza el parmetro -selective. Especifica el nombre de uno o ms prefijos del Sistema de archivos de Data Links (DLFS). Los valores de prefijo deben empezar por una barra inclinada y deben estar registrados con el servidor de archivos de Data Links especificado. Separe mltiples nombres de prefijo con signos de dos puntos (:), pero no incluya espacios incorporados. Por ejemplo:
/dlfsdir1/smith/:/dlfsdir2/smith/
147

Se considera que la va de acceso de un valor de columna DATALINK coincide con la lista de prefijos si cualquiera de los prefijos de la lista es la subserie ms a la izquierda de la va de acceso. Si no se utiliza este parmetro, todos los prefijos de todos los servidores de Data Links que estn registrados con la base de datos DB2 especificada se reconciliarn. -server Nombre del servidor Data Links para el que ha de realizarse la operacin de reconciliacin. El parmetro servidor dlfm representa un nombre de sistema principal IP. Este nombre de sistema principal debe coincidir exactamente con el nombre de sistema principal de servidor DLFM registrado con la base de datos DB2 proporcionada. Ejemplos:
db2_recon_aid db2_recon_aid -db STAFF -db STAFF -check -reportdir /home/smith -selective -server dlmserver.services.com -selective -server dlmserver.services.com
db2_recon_aid -db STAFF -check -prefixes /dlfsdir1/smith/
db2_recon_aid -db STAFF -reportdir /home/smith -prefixes /dlfsdir1/smith/:/dlfsdir2/smith/
Notas de uso: 1. En los sistemas AIX o en los entornos operativos Solaris, el programa de utilidad db2_recon_aid est ubicado en el directorio INSTHOME/sqllib/adm, donde INSTHOME es el directorio inicial del propietario de la instancia. 2. En los sistemas Windows, el programa de utilidad est ubicado en el directorio x:\sqllib\bin, donde x: es la unidad donde se ha instalado DB2 Data Links Manager. 3. db2_recon_aid puede identificar todas las tablas de una base de datos determinada que contienen columnas DATALINK con el atributo de columna FILE LINK CONTROL. Son estos tipos de columnas los que pueden necesitar la validacin de referencias de archivos a travs del programa de utilidad RECONCILE. Al especificar la opcin -check, las tablas de inters simplemente pueden listarse. Al especificar la opcin -reportdir, el programa de utilidad RECONCILE se puede ejecutar automticamente para este conjunto de tablas. Al especificar la opcin -selective, puede reducir el conjunto de tablas que db2_recon_aid identifica como candidatas para la reconciliacin (basndose en la(s) columna(s) DATALINK de la tabla que contiene(n) referencias a un servidor de Data Links especfico y uno o ms de sus sistemas de archivos de Data Links).
148
Command Reference

4. Dependiendo del problema que se intente solucionar, tendr que elegir entre ejecutar el programa de utilidad RECONCILE o db2_recon_aid. La consideracin preferente es cuntas tablas es posible que tengan que reconciliarse. Por ejemplo: v Si tiene una tabla individual en un estado como DRP o DRNP, puede que slo tenga que ejecutar RECONCILE para esta tabla especfica para restaurar la tabla a un estado normal. v Si un sistema de archivos de Data Links (DLFS) se ha daado o perdido en un servidor determinado de Data Links, debe utilizar db2_recon_aid (con la opcin -selective) para localizar todas las tablas que hagan referencia a ese servidor de Data Links y a ese prefijo especfico (va de acceso de DLFS) y realizar la reconciliacin en cada una de estas tablas. v Si slo desea validar TODAS las referencias de archivos DATALINK en la base de datos, debera ejecutar db2_recon_aid (sin la opcin -selective). 5. Cada prefijo debe ser una va de acceso absoluta (o sea, debe empezar por una barra inclinada) y debe registrarse con el servidor DLFM proporcionado. 6. Se considera que la va de acceso de un valor de columna DATALINK coincide con la lista de prefijos si cualquiera de los prefijos de la lista es la subserie ms a la izquierda de la va de acceso.
149
db2relocatedb - Reubicar base de datos db2relocatedb - Mandato Reubicar base de datos

Reubica una base de datos tal como se especifica en el archivo de configuracin proporcionado por el usuario. Autorizacin: Ninguna Sintaxis del mandato:
db2relocatedb -f nombreArchivoconfig
Parmetros del mandato: -f nombreArchivoconfig Especifica el nombre del archivo que contiene la informacin de configuracin necesaria para reubicar la base de datos. Puede ser un nombre de archivo relativo o absoluto. Informacin relacionada: v db2inidb - Mandato Inicializar una base de datos duplicada en la pgina 90
150
Command Reference
db2sampl - Crear base de datos de ejemplo db2sampl -Mandato Crear base de datos de ejemplo
Crea una base de datos de ejemplo llamada SAMPLE. Autorizacin: Una de las siguientes: v sysadm v sysctrl Sintaxis del mandato:
db2sampl vaacceso -k
Parmetros del mandato: vaacceso Especifica la va de acceso en la que se debe crear la base de datos SAMPLE. La va de acceso es una sola letra de unidad para Windows. Si no se especifica ninguna va de acceso, SAMPLE se crea en la va de acceso de base de datos por omisin (el parmetro dftdbpath del archivo de configuracin del gestor de bases de datos). En sistemas basados en UNIX, el valor por omisin es el directorio HOME del propietario de la instancia. En los sistemas operativos Windows, es el directorio raz (donde se instala DB2). -k Crea claves primarias en las tablas siguientes de SAMPLE:
Tabla ----DEPARTMENT EMPLOYEE ORG PROJECT STAFF STAFFG Clave primaria ----------DEPTNO EMPNO DEPTNUMB PROJNO ID ID (slo DBCS)
Nota: La va de acceso debe especificarse antes que esta opcin. Notas de uso: Este mandato slo se puede ejecutar desde nodos de servidor. SAMPLE no puede crearse en nodos que slo son clientes de la base de datos. La base de datos SAMPLE se crea con el tipo de autentificacin de instancia especificado por el parmetro de configuracin de gestor de bases de datos authentication.
151
db2sampl - Crear base de datos de ejemplo

Los calificadores para las tablas de SAMPLE los determina el ID de usuario que emite el mandato. Si SAMPLE ya existe, db2sampl crea las tablas para el ID de usuario que emite el mandato y otorga los privilegios apropiados. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354
152
Command Reference
db2set - Mandato de registro de perfiles de DB2 db2set -Mandato Registro de perfiles de DB2
Visualiza, establece o elimina variables de perfiles de DB2. Mandato de registro de entorno externo que soporta la administracin local y remota, a travs del Servidor de administracin DB2, de las variables de entorno de DB2 almacenadas en el registro de perfiles de DB2. Autorizacin: sysadm Conexin necesaria: Ninguna Sintaxis del mandato:
db2set variable= valor -g -i instancia nmero-particin-bd
-all
-null
-r
instancia nmero-particin-bd
-n
nodo DAS -u usuario -p contrasea
-l -lr
-v
-ul -ur
-h -?
Parmetros del mandato: variable= valor Establece una variable especificada en un valor especificado. Para suprimir una variable, no especifique un valor para la variable especificada. Los cambios efectuados en los valores entran en vigor despus de que se haya reiniciado la instancia. -g -i Accede a las variables de perfil globales. Especifica el perfil de instancia a utilizar en lugar del actual o del valor por omisin.
nmero-particin-bd Especifica un nmero listado en el archivo db2nodes.cfg.
153
db2set - Mandato de registro de perfiles de DB2

-all Visualiza todas las apariciones de las variables de entorno locales como se han definido en: v El entorno, indicado mediante [e] v El registro de nivel de nodo, indicado mediante [n] v El registro de nivel de instancia, indicado mediante [i] v El registro de nivel global, indicado mediante [g]. Establece en NULL el valor de la variable en el nivel de registro especificado. Esto evita tener que consultar el valor en el siguiente nivel de registro, como lo define el orden de bsqueda.
-null
-r instancia Restablece el registro de perfil para la instancia en concreto. -n nodo DAS Especifica el nombre de nodo de servidor de administracin de DB2. -u usuario Especifica el ID de usuario a utilizar para la conexin de servidor de administracin. -p contrasea Especifica la contrasea a utilizar para la conexin de servidor de administracin. -l -lr -v -ul Lista todos los perfiles de instancia. Lista todas las variables de registro soportadas. Especifica la modalidad verbosa. Accede a las variables de perfil de usuario. Nota: Este parmetro slo se soporta en sistemas operativos Windows. -ur Renueva las variables de perfil de usuario. Nota: Este parmetro slo se soporta en sistemas operativos Windows. -h/-? Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
Ejemplos: v Visualizar todos los perfiles definidos (instancias de DB2):

db2set -l
v Visualizar todas las variables de registro soportadas:

db2set -lr
154
Command Reference

v Visualizar todas las variables globales definidas:
db2set -g
v Visualizar todas las variables definidas para la instancia actual:

db2set
v Visualizar todos los valores definidos para la instancia actual:

db2set -all
v Visualizar todos los valores definidos para DB2COMM para la instancia actual:
db2set -all DB2COMM
v Restablecer todas las variables definidas para la instancia INST en el nodo 3:

db2set -r -i INST 3
v Desestablecer la variable DB2CHKPTR en la instancia remota RMTINST mediante el nodo DAS RMTDAS utilizando el ID de usuario MIID y la contrasea MICONTRS:
db2set -i RMTINST -n RMTDAS -u MIID -p MICONTRS DB2CHKPTR=
v Establecer la variable DB2COMM para que sea TCPIP,IPXSPX,NETBIOS globalmente:

db2set -g DB2COMM=TCPIP,IPXSPX,NETBIOS
v Establecer la variable DB2COMM para que sea slo TCPIP para la instancia MIINST:
db2set -i MIINST DB2COMM=TCPIP
v Establecer la variable DB2COMM en nula en el nivel de instancia proporcionado:

db2set -null DB2COMM
Notas de uso: Si no se especifica ningn nombre de variable, se visualizan los valores de todas las variables definidas. Si se especifica un nombre de variable, slo se visualiza el valor de dicha variable. Para visualizar todos los valores definidos de una variable, especifique variable -all. Para visualizar todas las variables definidas en todos los registros, especifique -all. Para modificar el valor de una variable, especifique variable=, seguida del valor nuevo. Para establecer el valor de una variable en NULL, especifique variable -null. Nota: Los cambios efectuados en los valores entran en vigor despus de que se haya reiniciado la instancia.
155

Para suprimir una variable, especifique variable=, sin ningn valor a continuacin.
156
Command Reference
db2setup - Instalar DB2 db2setup -Mandato Instalar DB2

Instala los productos DB2. Este programa de utilidad est ubicado en el soporte de instalacin de DB2. Lanza el asistente de Configuracin de DB2 para definir la instalacin e instalar los productos DB2. Si se invoca con la opcin -r, realiza una instalacin sin entradas adicionales, obteniendo de un archivo de respuestas la informacin de configuracin de la instalacin. Para sistemas basados en UNIX
mandato db2setup
db2setup -i idioma -l archivo_anot -t archivo_rastreo
-r
archivo_respuestas
-? -h
donde: -i idioma Es el cdigo de idioma de dos letras del idioma en el que se realizar la instalacin. -l archivo_anot Es la va de acceso completa y el nombre de archivo del archivo de anotaciones cronolgicas que se va a utilizar. -t Genera un archivo con informacin de rastreo de la instalacin.
-r archivo_respuestas Es la va de acceso completa y el nombre de archivo del archivo de respuestas que se va a utilizar. -?, -h Genera informacin de uso.
Para sistemas basados en Windows

mandato db2setup
db2setup -f -i idioma -l archivo_anot -t archivo_rastreo
-r
archivo_respuestas
-v
-SMS -w
-? -h
donde:
157
db2setup - Instalar DB2

-f Fuerza a cualquier proceso de DB2 a detenerse antes de la instalacin.
-i:idioma Es el cdigo de idioma de dos letras del idioma en el que se realizar la instalacin. -l:archivo_anot Es la va de acceso completa y el nombre de archivo del archivo de anotaciones cronolgicas que se va a utilizar. -t Genera un archivo con informacin de rastreo de la instalacin.
-r:archivo_respuestas Es la va de acceso completa y el nombre de archivo del archivo de respuestas que se va a utilizar. -v Pasa argumentos de lnea de mandatos adicionales a msiexec.
-SMS, -w Mantiene activo el proceso padre hasta el fin de la instalacin. -?, -h Genera informacin de uso.
158
Command Reference
db2sql92 - Procesador de sentencias de SQL conforme con SQL92 db2sql92 -Mandato Procesador de sentencias de SQL conforme con SQL92
Lee sentencias de SQL de un archivo plano o de entrada estndar, describe y prepara dinmicamente las sentencias y devuelve un conjunto de respuestas. Soporta conexiones simultneas a mltiples bases de datos. Autorizacin: sysadm Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
db2sql92 -d nombrebd -f nombre_archivo
-a
idusuario/contrasea
-r
archivosalida ,archivosalida2
-c
on off
-i
short none long complete
-o
opciones -v
off on
-s
off on
-h
Parmetros del mandato: -d nombrebd Nombre de alias de la base de datos en la que deben aplicarse las sentencias de SQL. El valor por omisin es el valor de la variable de entorno DB2DBDFT. -f nombre_archivo Nombre de un archivo de entrada que contiene sentencias de SQL. El valor por omisin es la entrada estndar. El texto de comentario se identifica con dos guiones al principio de cada lnea, es decir, -- <comentario>. Si el comentario debe incluirse en la salida, mrquelo del modo siguiente: --#COMMENT <comentario>. Un bloque es un conjunto de sentencias de SQL que se trata como si fuera una sola sentencia, es decir, se rene informacin para todas esas sentencias a la vez, en lugar de una en una. El principio de un
159
db2sql92 - Procesador de sentencias de SQL conforme con SQL92

bloque de consultas se identifica del modo siguiente: --#BGBLK. El final de un bloque de consultas se identifica del modo siguiente: --#EOBLK. Especifique una o ms opciones de control del modo siguiente: --#SET <opcin de control> <valor>. Las opciones de control vlidas son: ROWS_FETCH Nmero de filas a captar del conjunto de respuestas. Los valores vlidos son -1 a n. El valor por omisin es -1 (se deben captar todas las filas). ROWS_OUT Nmero de filas captadas que se deben enviar a la salida. Los valores vlidos son -1 a n. El valor por omisin es -1 (deben enviarse a la salida todas las filas captadas). AUTOCOMMIT Especifica si se debe activar o desactivar el compromiso automtico. Los valores vlidos son ON (activar) u OFF (desactivar). El valor por omisin es ON. PAUSE Solicita al usuario que contine. TIMESTAMP Genera una indicacin de fecha y hora. -a idusuario/contrasea Nombre y contrasea que se utilizan para conectarse a la base de datos. -r archivosalida Archivo de salida que contendr los resultados de la consulta. Un archivosalida2 opcional contendr un resumen de resultados. El valor por omisin es la salida estndar. -c -i Compromete automticamente los cambios resultantes de cada sentencia de SQL. Intervalo de tiempo transcurrido (en segundos). none short long Especifica que no se debe reunir informacin de tiempo. Tiempo de ejecucin para una consulta. Tiempo transcurrido al iniciarse la siguiente consulta.
complete Tiempo para preparar, ejecutar y captar, expresado por separado.
160
Command Reference

-o opciones Opciones de control. Las opciones vlidas son: f rows_fetch Nmero de filas a captar del conjunto de respuestas. Los valores vlidos son -1 a n. El valor por omisin es -1 (se deben captar todas las filas). r rows_out Nmero de filas captadas que se deben enviar a la salida. Los valores vlidos son -1 a n. El valor por omisin es -1 (deben enviarse a la salida todas las filas captadas). -v -s Verboso. Enva informacin al error estndar durante el proceso de la consulta. El valor por omisin es off (desactivado). Tabla de resumen. Proporciona un resumen de tiempos transcurridos y tiempos de CPU, que contiene las medias aritmtica y geomtrica de todos los valores reunidos. Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
-h
Notas de uso: Desde el indicador de mandatos de db2sql92, se puede ejecutar lo siguiente: v Todas las opciones de control v Sentencias de SQL v Sentencias CONNECT v commit work v help v quit Esta herramienta soporta la conmutacin entre bases de datos diferentes durante una sola ejecucin del programa. Para ello, emita un CONNECT RESET y, a continuacin, uno de los mandatos siguientes en el indicador de mandatos de db2sql92 (entrada estndar):
connect to basedatos connect to basedatos USER idusuario USING contrasea
Las sentencias de SQL pueden tener una longitud mxima de 65.535 caracteres. Las sentencias deben terminar con un punto y coma. Las sentencias de SQL se ejecutan con el nivel de aislamiento de lectura repetible (RR).
161

Cuando se ejecutan consultas, no existe ningn soporte para que el conjunto de resultados incluya los LOB. Informacin relacionada: v db2batch -Mandato Herramienta de banco de pruebas en la pgina 20
162
Command Reference
db2start - Iniciar DB2 db2start -Mandato Iniciar DB2

Inicia los procesos de fondo de la instancia actual de gestor de bases de datos en una sola particin de base de datos o en todas las particiones de base de datos definidas en un entorno de base de datos particionado. Inicie DB2 en el servidor antes de conectarse a una base de datos, de precompilar una aplicacin o de vincular un paquete a una base de datos. db2start puede ejecutarse como mandato del sistema o como mandato CLP. Informacin relacionada: v Mandato START DATABASE MANAGER en la pgina 681
163
db2stop - Detener DB2 db2stop -Mandato Detener DB2

Detiene la instancia actual del gestor de bases de datos. db2stop puede ejecutarse como mandato del sistema o como mandato CLP. Informacin relacionada: v Mandato STOP DATABASE MANAGER en la pgina 687
164
Command Reference
db2support - Herramienta de anlisis de problemas y recoleccin del entorno db2support -Mandato Herramienta de anlisis de problemas y recoleccin del entorno
Rene datos del entorno sobre una mquina cliente o servidor y sita los archivos que contienen los datos del sistema en un archivador de archivos comprimido. Esta herramienta tambin puede obtener datos bsicos sobre la naturaleza de un problema mediante un proceso interactivo de preguntas y respuestas con el usuario. Autorizacin: Para obtener una salida ms completa, el propietario debe invocar este programa de utilidad. Los usuarios con privilegios ms limitados sobre el sistema pueden ejecutar esta herramienta, pero las acciones de obtencin de datos darn como resultado un informe reducido y una salida reducida. Conexin necesaria: Ninguna Sintaxis del mandato:
db2support va salida -f -a -r
-d
nombre basedatos -c -u idusuario -p contrasea
-g
-h
-l
-n
-q
-s
-v
-x
Parmetros del mandato: va salida Especifica la va de acceso en la que debe crearse la biblioteca archivada. Esta va de acceso es el directorio donde deben situarse los archivos creados por el usuario para incluirlos en el archivador. -f o -flow Pasa por alto las pausas cuando se realizan peticiones para que el usuario Pulse la tecla <Intro> para continuar. Esta opcin es til
165
db2support - Herramienta de anlisis de problemas y recoleccin del entorno

cuando se ejecuta o llama a la herramienta db2support mediante un script o mediante algn otro procedimiento automatizado donde se desea la ejecucin desatendida. -a o -all_core Especifica que deben capturarse todos los archivos de imagen de memoria. -r o -recent_core Especifica que deben capturarse los archivos de imagen de memoria ms recientes. Esta opcin se ignora si se ha especificado la opcin -a. -d nombre_basedatos o -database nombre_basedatos Especifica el nombre de la base de datos para la que se estn obteniendo datos. -c o -connect Especifica que se realiza un intento de conectarse a la base de datos especificada. -u idusuario o -user idusuario Especifica el ID de usuario que se conectar a la base de datos. -p contrasea o -password contrasea Especifica la contrasea para el ID de usuario. -g o -get_dump Especifica que deben capturarse todos los archivos en un directorio de vuelco, excluyendo los archivos de imagen de memoria. -h o -help Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda. -l o -logs Especifica que deben capturarse las anotaciones cronolgicas activas. -n o -number Especifica el nmero de informe de gestin de problema (PMR) o el identificador para el problema actual. -q o -question_response Especifica que debe utilizarse la modalidad de anlisis interactivo de problemas. -s o -system_detail Especifica que debe obtenerse informacin detallada sobre el hardware y el sistema operativo.
166
Command Reference
db2support - Herramienta de anlisis de problemas y recoleccin del entorno

-v o -verbose Especifica que debe utilizarse la salida detallada mientras se ejecuta esta herramienta. -x o -xml_generate Especifica que debe generarse un documento XML que contenga toda la lgica de rbol de decisiones utilizada durante la modalidad de anlisis interactivo de problemas (modalidad -q). Notas de uso: Para proteger la seguridad de los datos comerciales, esta herramienta no obtiene datos de tablas, esquemas (DDL) o anotaciones cronolgicas. Algunas de las opciones permiten la inclusin de algunos aspectos del esquema y datos (tales como anotaciones cronolgicas archivadas). Las opciones que exponen datos o esquemas de la base de datos deben utilizarse con cuidado. Cuando se invoca esta herramienta, se visualiza un mensaje que indica cmo deben tratarse los datos sensibles. Los datos recopilados de la herramienta db2support sern de la mquina donde se ejecuta la herramienta. En un entorno cliente-servidor, la informacin relacionada con la base de datos ser de la mquina donde se ubica la base de datos mediante una conexin de instancia o una conexin a la base de datos. Por ejemplo, la informacin del sistema operativo o del hardware (opcin -s) y los archivos del directorio de diagnstico (DIAGPATH) sern de la mquina local donde se est ejecutando la herramienta db2support. Los datos como, por ejemplo, la informacin de agrupacin de almacenacientos intermedios, la configuracin de la base de datos, y la informacin de espacio de tabla ser de la mquina donde se ubica fsicamente la base de datos.
167
db2sync - Iniciar el sincronizador de DB2 db2sync -Mandato Iniciar el sincronizador de DB2

Facilita la configuracin inicial de un satlite as como los cambios en la configuracin. Este mandato tambin se puede utilizar para iniciar, detener y supervisar el proceso de una sesin de sincronizacin y para subir la informacin de configuracin de un satlite (por ejemplo, parmetros de comunicaciones) al servidor de control. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2sync -t -s -g versin_aplicacin
Parmetros del mandato: -t Visualiza una interfaz grfica de usuario que permite a un administrador cambiar la versin de la aplicacin o las credenciales de sincronizacin para un satlite.
-s versin_aplicacin Establece la versin de la aplicacin en el satlite. -g Visualiza la versin de aplicacin establecida actualmente en el satlite.
168
Command Reference
db2tbst - Obtener estado de espacio de tabla db2tbst -Mandato Obtener estado de espacio de tabla
Acepta un valor de estado de espacio de tabla hexadecimal y devuelve el estado. El valor de estado forma parte de la salida de LIST TABLESPACES. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
db2tbst estado-espaciotabla
Parmetros del mandato: estado-espaciotabla Valor hexadecimal de estado de espacio de tabla. Ejemplos: La peticin db2tbst 0x0000 produce la salida siguiente:
Estado = Normal
Informacin relacionada: v Mandato LIST TABLESPACES en la pgina 475
169
db2trc - Rastrear db2trc -Mandato Rastrear

Controla el recurso de rastreo de una instancia de DB2 o el Servidor de administracin DB2. El recurso de rastreo registra informacin acerca de las operaciones y formatea esta informacin en un formato legible. La habilitacin del recurso de rastreo puede influir en el rendimiento del sistema. Como resultado de ello, utilice el recurso de rastreo slo cuando as se lo indique un representante de soporte tcnico del Soporte de DB2. Autorizacin: Para rastrear una instancia de DB2 en un sistema basado en UNIX, efecte una de las acciones siguientes: v sysadm v sysctrl v sysmaint DASADM para rastrear el Servidor de administracin DB2 en un sistema basado en UNIX. En el sistema operativo Windows, no se necesita ninguna autorizacin. Conexin necesaria: Ninguna Sintaxis del mandato:
db2 db2trc das on -f nombre-archivo , pid .tid -l tamao_almacint -i tamao_almacint off dmp flw fmt clr nombre-archivo archivo_vuelco archivo_vuelco
-p
archivo_salida archivo_salida
170
Command Reference
db2trc - Rastrear
Parmetros del mandato: db2 das on Especifica que todas las operaciones de rastreo se realizarn en la instancia de DB2. ste es el valor por omisin. Especifica que todas las operaciones de rastreo se realizarn en el Servidor de administracin DB2. Utilice este parmetro para iniciar el recurso de rastreo. -f nombre-archivo Especifica que la informacin de rastreo debe grabarse de manera continua en el archivo especificado, hasta que db2trc quede desactivado. Nota: Utilizar esta opcin puede generar un archivo de vuelco extremadamente grande. Slo debe utilizar esta opcin cuando el Soporte al cliente de DB2 se lo indique. -p pid.tid Slo habilita el recurso de rastreo para los ID de proceso (pid) y los ID de hebra (tid) especificados. El punto (.) debe incluirse si se especifica un tid. Se da soporte a un mximo de cinco combinaciones de pid.tid. Por ejemplo, para habilitar el rastreo para los procesos 10, 20 y 30, la sintaxis es:
db2trc on -p 10,20,30
Para habilitar el rastreo slo para la hebra 33 del proceso 100 y la hebra 66 del proceso 200, la sintaxis es:
db2trc on -p 100.33,200.66
-l [ tamao_almacint] | -i [tamao_almacint] Esta opcin especifica el tamao y el comportamiento del almacenamiento intermedio de rastreo. -l especifica que se retienen los ltimos registros de rastreo (es decir, se graba encima de los primeros registros cuando el almacenamiento intermedio est lleno). -i especifica que los registros de rastreo iniciales se retienen (es decir, no se graban ms registros en el almacenamiento intermedio una vez que ste est lleno). El tamao del almacenamiento intermedio puede especificarse en bytes de megabytes. Para especificar el tamao del almacenamiento intermedio en megabytes, aada el carcter m al tamao del almacenamiento intermedio. Por ejemplo, para iniciar db2trc con un almacenamiento intermedio de 4 megabytes:
db2trc on -l 4m
171
db2trc - Rastrear
Nota: El tamao del almacenamiento intermedio debe ser una potencia de 2. dmp Vuelca la informacin de rastreo en un archivo. El mandato siguiente pondr la informacin en el directorio actual, en un archivo denominado db2trc.dmp:
db2trc dmp db2trc.dmp
Especifique un nombre de archivo con este parmetro. El archivo se guarda en el directorio actual a no ser que se especifique explcitamente la va de acceso. off Despus de volcar el rastreo en un archivo, detenga el recurso de rastreo escribiendo lo siguiente:
db2trc off
flw | fmt Despus de volcar el rastreo en un archivo binario, confirme que se ha tomado formatendolo en un archivo de texto. Utilice la opcin flw (para formatear registros clasificados por proceso o por hebra) o fmt (para formatear registros cronolgicamente). Para cualquiera de las dos opciones, especifique el nombre del archivo de vuelco y el nombre del archivo de salida que se generarn. Por ejemplo:
db2trc flw db2trc.dmp db2trc.flw
clr
Borra el contenido del almacenamiento intermedio de rastreo. Esta opcin puede utilizarse para reducir la cantidad de informacin recogida. Esta opcin no tiene ningn efecto cuando el rastreo va a un archivo.
Notas de uso: El mandato db2trc debe emitirse varias veces para activar el rastreo, producir un archivo de vuelco, formatear el archivo de vuelco y desactivar el rastreo de nuevo. La lista de parmetros muestra el orden en el que deben utilizarse los parmetros. Los tamaos por omisin y mximo del almacenamiento intermedio de rastreo varan segn la plataforma. El tamao mnimo del almacenamiento intermedio es de 1 MB. Al rastrear el servidor de bases de datos, es recomendable que se active el recurso de rastreo antes de iniciar el gestor de bases de datos.
172
Command Reference
db2undgp - Revocar privilegio de ejecucin db2undgp -Mandato Revocar privilegio de ejecucin

Revoca el privilegio de ejecucin sobre procedimientos almacenados externos. Este mandato puede utilizarse para procedimientos almacenados externos. Durante la migracin de base de datos, aplique EXECUTE para todas las funciones existentes, mtodos y al procedimiento almacenado externo se le otorga PUBLIC. Esto causar una exposicin de seguridad de los procedimientos almacenados externos que contienen el acceso a datos SQL. Para evitar que los usuarios accedan a objetos SQL para los que es posible que el usuario no tenga privilegios, utilice el mandato db2undgp. Autorizacin: Conexin necesaria: Sintaxis del mandato:
db2undgp -d nombrebd -h -o archivosalida -r
Parmetros del mandato: -d nombrebd nombre de base de datos (8 caracteres como mximo) -h Visualiza ayuda para el mandato.
-o archivosalida efecta la salida de las sentencias de revocacin en el archivo especificado. Longitud de nombre de archivo <= 80 -r realiza la revocacin
Notas de uso: Notas: 1. Debe especificarse por lo menos una de estas opciones: -r u -o.
173
db2uiddl - Preparar conversin de ndices exclusivos a semntica de V5 db2uiddl -Mandato Preparar conversin de ndices exclusivos a semntica de V5
Facilita la gestin de una migracin por fases de ndices exclusivos en la propia planificacin de un usuario. Genera sentencias CREATE UNIQUE INDEX para ndices exclusivos en tablas de usuario. Autorizacin: sysadm Conexin necesaria: Base de datos. Este mandato establece automticamente una conexin a la base de datos especificada. Sintaxis del mandato:
db2uiddl -d nombre-base-datos -u esquema-tabla -t nombre-tabla
-o
nombre-archivo
-h
Parmetros del mandato: -d nombre-base-datos Nombre de la base de datos que se debe consultar. -u esquema-tabla Especifica el esquema (ID de usuario de creador) de las tablas que se deben procesar. La accin por omisin es procesar las tablas creadas por todos los ID de usuario. -t nombre-tabla El nombre de una tabla que se debe procesar. La accin por omisin es procesar todas las tablas. -o nombre-archivo Nombre de un archivo en el que debe grabarse la salida. La accin por omisin es grabar la salida en la salida estndar. -h Visualiza informacin de ayuda. Cuando se especifica esta opcin, se ignoran todas las dems opciones y slo se visualiza la informacin de ayuda.
174
Command Reference
db2uiddl - Preparar conversin de ndices exclusivos a semntica de V5

Notas de uso: No es necesario utilizar esta herramienta, a menos que haya ndices de la base de datos que se crearon en una base de datos que se ejecutaba en una versin de DB2 anterior a la Versin 5. Nota: Esta herramienta no ha sido diseada para manejar determinados tipos de nombres. Si un nombre de tabla o un esquema de tabla especfico es un identificador delimitado que contiene caracteres en minsculas, caracteres especiales o espacios en blanco, es preferible solicitar el proceso de todas las tablas o todos los esquemas. Se puede editar la salida resultante.
175
db2untag - Liberar identificador de contenedor db2untag -Mandato Liberar identificador de contenedor

Elimina el identificador de DB2 en un contenedor de espacio de tabla. El identificador se utiliza para evitar que DB2 vuelva a utilizar un contenedor en ms de un espacio de tabla. Visualiza informacin acerca del identificador de contenedor, identificando la base de datos con la que est asociado el contenedor. Es til cuando es necesario liberar un contenedor que ha sido utilizado por ltima vez por una base de datos que ahora ya se ha suprimido. Si se deja el identificador, se impide que DB2 utilice el recurso en el futuro. Atencin: Esta herramienta slo la debern utilizar los administradores del sistema informados. Autorizacin: El usuario necesita acceso de lectura/grabacin en el contenedor para un espacio de tabla que es propiedad del ID que ha creado la base de datos. Conexin necesaria: Ninguna Sintaxis del mandato:
db2untag -f nombre-archivo
Parmetros del mandato: -f nombre-archivo Especifica el nombre totalmente calificado del contenedor de espacio de tabla del que debe eliminarse el identificador de DB2. Notas de uso: A veces se devuelve un cdigo SQLCODE -294 (error de contenedor en uso) de las operaciones de creacin de base de datos o de creacin o modificacin de espacio de tabla, lo que indica generalmente un error de especificacin en el nombre de recurso de sistema operativo cuando el contenedor ya est siendo utilizado por otro espacio de tabla. Un contenedor slo puede ser utilizado por un espacio de tabla a la vez. Un administrador de sistema o de bases de datos, que encuentre que se ha eliminado la base de datos que ha utilizado por ltima vez el contenedor, puede utilizar la herramienta db2untag si no se ha eliminado el identificador del contenedor. Si se debe liberar el contenedor, realice una de las acciones siguientes:
176
Command Reference
db2untag - Liberar identificador de contenedor

v Para contenedores SMS, elimine el directorio y su contenido utilizando los mandatos de supresin apropiados. v Para contenedores DMS corrientes, suprima el archivo o dispositivo o deje que db2untag elimine el identificador de contenedor. De lo contrario, la herramienta dejar un contenedor DMS de este tipo sin modificarlo. Informacin relacionada: v Mandato CREATE DATABASE en la pgina 283
177
db2untag - Liberar identificador de contenedor
178
Command Reference
Captulo 2. Procesador de lnea de mandatos (CLP)

Esta seccin explica cmo invocar y utilizar el procesador de lnea de mandatos y describe las opciones del CLP. El mandato db2 inicia el procesador de lnea de mandatos (CLP). El CLP se utiliza para ejecutar programas de utilidad de base de datos, sentencias de SQL y ayuda en lnea. Ofrece diversas opciones de mandato y se puede iniciar en: v Modalidad de entrada interactiva, caracterizada por el indicador de entrada db2 => v Modalidad de mandatos, donde cada mandato debe llevar el prefijo db2 v Modalidad de proceso por lotes, que utiliza la opcin de entrada de archivo -f. Nota: En Windows, db2cmd abre la ventana de DB2 habilitada para CLP e inicializa el entorno de lnea de mandatos de DB2. La emisin de este mandato equivale a pulsar el icono Ventana de mandatos DB2. QUIT detiene el procesador de lnea de mandatos. TERMINATE tambin detiene el procesador de lnea de mandatos, pero elimina el proceso de fondo asociado y libera la memoria que se est utilizando. Es recomendable que se emita TERMINATE antes de cada mandato STOP DATABASE MANAGER (db2stop). Tambin puede que sea necesario emitir TERMINATE despus de haber cambiado los parmetros de configuracin de base de datos para que estos cambios entren en vigor. Nota: Antes de terminar el CLP se debern restablecer las conexiones existentes. El mandato de shell (!) permite que los mandatos del sistema operativo se ejecuten en la modalidad interactiva o por lotes en sistemas basados en UNIX y en sistemas operativos Windows (por ejemplo, !ls en UNIX y !dir en sistemas operativos Windows). Ninguna
179
Procesador de lnea de mandatos (CLP)

db2
distintivo-opcin
mandato-db2 sentencia-sql ? frase mensaje sqlstate cdigo-clase
--
comentario
distintivo-opcin Para ver un resumen de los distintivos de opciones de CLP vlidos, consulte la Tabla 1 en la pgina 181. mandato-db2 Especifica un mandato DB2. sentencia-sql Especifica una sentencia de SQL. ? Solicita ayuda general de CLP.
? frase Solicita el texto de ayuda asociado con un mandato o un tema especificado. Si el gestor de bases de datos no puede encontrar la informacin solicitada, visualiza la pantalla de ayuda general. ? options solicita una descripcin y los valores actuales de las opciones de CLP. ? help solicita informacin sobre la lectura de los diagramas de sintaxis de la ayuda en lnea. ? mensaje Solicita ayuda para un mensaje especificado por un SQLCODE vlido (por ejemplo ? sql10007n). ? sqlstate Solicita ayuda para un mensaje especificado por un mensaje SQLSTATE vlido. ? cdigo-clase Solicita ayuda para un mensaje especificado por un cdigo-clase vlido. -- comentario El procesador de lnea de mandatos trata como un comentario la entrada que empieza con los caracteres de comentario --Nota: En cada caso, un espacio en blanco debe separar el interrogante (?) del nombre de variable.
180
Command Reference
Opciones del procesador de lnea de mandatos Opciones del procesador de lnea de mandatos
Las opciones de mandatos de CLP pueden especificarse estableciendo la variable de entorno del procesador de lnea de mandatos DB2OPTIONS (que debe estar en maysculas), o con distintivos de lnea de mandatos. Los usuarios pueden establecer opciones para una sesin entera utilizando DB2OPTIONS. Vea los valores actuales para los distintivos de opcin y el valor de DB2OPTIONS utilizando LIST COMMAND OPTIONS. Cambie un valor de opcin de la modalidad de entrada interactiva o un archivo de mandato utilizando UPDATE COMMAND OPTIONS. El procesador de lnea de mandatos establece opciones en el orden siguiente: 1. Configura las opciones por omisin. 2. Lee DB2OPTIONS para alterar temporalmente los valores por omisin. 3. Lee la lnea de mandatos para alterar temporalmente DB2OPTIONS. 4. Acepta entrada de UPDATE COMMAND OPTIONS como una alteracin temporal final interactiva. La Tabla 1 resume los distintivos de opciones de CLP. Estas opciones pueden especificarse en cualquier secuencia y combinacin. Para activar una opcin, ponga un signo menos (-) delante de la letra de opcin correspondiente. Para desactivar una opcin, ponga un signo menos delante de la letra de opcin y otro signo menos despus de dicha letra o ponga como prefijo de la letra de opcin un signo ms (+). Por ejemplo, -c activa la opcin de compromiso automtico y -c- o +c la desactiva. Estas letras de opciones no son sensibles a las maysculas y minsculas, es decir, -a y -A son equivalentes.
Tabla 1. Opciones de mandatos de CLP Distintivo de Descripcin opcin -a -c Esta opcin indica al procesador de lnea de mandatos que visualice datos SQLCA. Esta opcin indica al procesador de lnea de mandatos que comprometa automticamente las sentencias de SQL. Esta opcin indica al procesador de lnea de mandatos que visualice SQLCODE o SQLSTATE. Estas opciones se excluyen mutuamente. Esta opcin indica al procesador de lnea de mandatos que lea entrada de mandato de un archivo en lugar de hacerlo de la entrada estndar. Valor por omisin OFF ON
-e{c|s}
OFF
-fnombrearchivo
OFF
181
Opciones del procesador de lnea de mandatos

Tabla 1. Opciones de mandatos de CLP (continuacin) Distintivo de Descripcin opcin -lnombrearchivo -n Esta opcin indica al procesador de lnea de mandatos que anote cronolgicamente los mandatos en un archivo histrico. Elimina el carcter de lnea nueva dentro de un solo smbolo delimitado. Si no se especifica esta opcin, el carcter de lnea nueva se sustituye por un espacio. Esta opcin debe utilizarse con la opcin -t. Esta opcin indica al procesador de lnea de mandatos que visualice los datos de salida y los mensajes en la salida estndar. Esta opcin indica al procesador de lnea de mandatos que visualice un indicador de procesador de lnea de mandatos cuando se est en modalidad de entrada interactiva. Esta opcin indica al procesador de lnea de mandatos que grabe el informe generado por un mandato en un archivo. Esta opcin indica al procesador de lnea de mandatos que detenga la ejecucin si se producen errores mientras se ejecutan mandatos en un archivo de proceso por lotes o en modalidad interactiva. Esta opcin indica al procesador de lnea de mandatos que utilice un punto y coma (;) como carcter de terminacin de sentencia. Esta opcin indica al procesador de lnea de mandatos que defina y utilice x como carcter de terminacin de sentencia. Esta opcin indica al procesador de lnea de mandatos que repita en eco el texto del mandato en la salida estndar. Esta opcin indica al procesador de lnea de mandatos que visualice mensajes de aviso de sentencia de SQL. Valor por omisin OFF
OFF
-o
ON
-p
ON
-rnombrearchivo -s
OFF
OFF
-t
OFF
-tdx
OFF
-v
OFF
-w -x
ON
Esta opcin indica al procesador de lnea de mandatos OFF que devuelva datos sin ninguna cabecera, incluidos los nombres de columna. Esta opcin indica al procesador de lnea de mandatos que redirija toda la salida a un archivo. Es similar a la opcin -r, pero incluye los mensajes o los cdigos de error con la salida. OFF
-znombrearchivo
182
Command Reference

Ejemplo El mandato de AIX:
export DB2OPTIONS=+a -c +ec -o -p
establece los valores por omisin siguientes para la sesin:

Visualizar SQLCA Comprometer automticamente Visualizar SQLCODE Visualizar salida Visualizar indicador off on off on on
A continuacin se proporciona una descripcin detallada de estas opciones: Opcin Mostrar datos SQLCA (-a): Visualiza datos SQLCA en la salida estndar despus de ejecutar un mandato DB2 o una sentencia de SQL. Se visualizan los datos SQLCA en lugar de un mensaje de error o de xito. El valor por omisin para esta opcin de mandato es OFF (+a o -a-). Las opciones -o y -r afectan a la opcin -a; consulte las descripciones de opciones para obtener detalles. Opcin Compromiso automtico (-c): Esta opcin especifica si cada mandato o sentencia debe tratarse de forma independiente. Si se establece en ON (-c), cada mandato o sentencia se compromete o se retrotrae automticamente. Si el mandato o la sentencia se ejecuta satisfactoriamente, se comprometen dicho mandato o dicha sentencia y todos los mandatos y las sentencias satisfactorios que se han emitido antes que stos con el compromiso automtico desactivado (OFF) (+c o -c-). Sin embargo, si el mandato o la sentencia falla, se retrotraen dicho mandato o dicha sentencia y todos los mandatos y todas las sentencias que se han emitido antes que stos con el compromiso automtico desactivado (OFF). Si se establece en OFF (+c o -c-), se deber emitir COMMIT o ROLLBACK explcitamente o se producir una de estas acciones cuando se emita el siguiente mandato con el compromiso automtico activado (ON) (-c). El valor por omisin para esta opcin de mandato es ON (activada). La opcin de compromiso automtico no afecta a ninguna otra opcin del procesador de lnea de mandatos. Ejemplo: Examine el escenario siguiente: 1. db2 create database test 2. db2 connect to test
183

3. db2 +c "create table a (c1 int)" 4. db2 select c2 from a La sentencia de SQL del paso 4 falla porque no hay ninguna columna llamada C2 en la tabla A. Dado que dicha sentencia se ha emitido con el compromiso automtico establecido en ON (valor por omisin), retrotrae no slo la sentencia del paso 4, sino tambin la del paso 3, porque la ltima se ha emitido con el compromiso automtico establecido en OFF. El mandato:
db2 list tables
devuelve entonces una lista vaca. Opcin Visualizar SQLCODE/SQLSTATE (-e): La opcin -e{c|s} indica al procesador de lnea de mandatos que visualice el mensaje SQLCODE (-ec) o SQLSTATE (-es) en la salida estndar. Las opciones -ec y -es no son vlidas en modalidad interactiva de CLP. El valor por omisin para esta opcin de mandato es OFF (+e o -e-). Las opciones -o y -r afectan a la opcin -e; consulte las descripciones de opciones para obtener detalles. La opcin de visualizacin de SQLCODE/SQLSTATE no afecta a ninguna otra opcin del procesador de lnea de mandatos. Ejemplo: Para recuperar SQLCODE del procesador de lnea de mandatos ejecutando en AIX, entre:
sqlcode=)db2 ec +o mandatodb2)
Opcin Leer de archivo de entrada (-f): La opcin -fnombre-archivo indica al procesador de lnea de mandatos que lea entrada de un archivo especificado, en lugar de hacerlo de la entrada estndar. Nombrearchivo es un nombre de archivo absoluto o relativo que puede incluir la va de acceso de directorio al archivo. Si no se especifica la va de acceso de directorio, se utiliza el directorio actual. Cuando se combinan otras opciones con la opcin -f, la opcin -f debe especificarse en ltimo lugar. Por ejemplo:
db2 -tvf nombre-archivo
Nota: Esta opcin no se puede cambiar desde la modalidad interactiva. El valor por omisin para esta opcin de mandato es OFF (+f o -f-).
184
Command Reference

Los mandatos se procesan hasta que se emite QUIT o TERMINATE, o se encuentra un cdigo de fin de archivo. Si se especifican esta opcin y un mandato de base de datos, el procesador de lnea de mandatos no procesa ningn mandato y se devuelve un mensaje de error. El procesador de lnea de mandatos trata como comentarios las lneas del archivo de entrada que empiezan con los caracteres de comentario --. Los caracteres de comentario deben ser los primeros caracteres distintos de espacios en blanco de una lnea. Si se especifica la opcin -fnombre-archivo, se ignora la opcin -p. La opcin de lectura del archivo de entrada no afecta a ninguna otra opcin del procesador de lnea de mandatos. Opcin Anotar cronolgicamente mandatos en archivo histrico (-l): La opcin -lnombre-archivo indica al procesador de lnea de mandatos que anote cronolgicamente los mandatos en un archivo especificado. Este archivo histrico contiene registros de los mandatos ejecutados y su estado de realizacin. Nombrearchivo es un nombre de archivo absoluto o relativo que puede incluir la va de acceso de directorio al archivo. Si no se especifica la va de acceso de directorio, se utiliza el directorio actual. Si el archivo especificado o el archivo por omisin ya existe, la nueva entrada de anotacin cronolgica se aade a dicho archivo. Cuando se combinan otras opciones con la opcin -l, la opcin -l debe especificarse en ltimo lugar. Por ejemplo:
db2 -tvl nombre-archivo
El valor por omisin para esta opcin de mandato es OFF (+l o -l-). La opcin de anotacin cronolgica de mandatos en archivo histrico no afecta a ninguna otra opcin del procesador de lnea de mandatos. Opcin Eliminar carcter de lnea nueva (-n): Elimina el carcter de lnea nueva dentro de un solo smbolo delimitado. Si no se especifica esta opcin, el carcter de lnea nueva se sustituye por un espacio. Nota: Esta opcin no se puede cambiar desde la modalidad interactiva. El valor por omisin para esta opcin de mandato es OFF (+n o -n-).
185

Esta opcin debe utilizarse con la opcin -t; consulte la descripcin de las opciones para obtener detalles. Opcin Visualizar salida (-o): La opcin -o indica al procesador de lnea de mandatos que enve los datos de salida y los mensajes a la salida estndar. El valor por omisin para esta opcin de mandato es ON (activada). Esta opcin no afecta a la informacin de arranque de modalidad interactiva. Los datos de salida constan de la salida de informe de la ejecucin del mandato especificado por el usuario y de datos SQLCA (si se solicitan). La opcin +o puede afectar a las opciones siguientes: v -rnombre-archivo: La informacin de arranque de modalidad interactiva no se guarda. v -e: Se visualiza SQLCODE o SQLSTATE en la salida estndar incluso si se especifica +o. v -a: Ningn efecto si se especifica +o. Si se especifican -a, +o y -rnombre-archivo, la informacin SQLCA se graba en un archivo. Si se especifican ambas opciones -o y -e, se visualizan en la pantalla los datos y el SQLCODE o el SQLSTATE. Si se especifican ambas opciones -o y -v, se visualizan los datos y el texto de cada mandato emitido se repite en eco en la pantalla. La opcin de visualizacin de salida no afecta a ninguna otra opcin del procesador de lnea de mandatos. Opcin Visualizar indicador interactivo de DB2 (-p): La opcin -p indica al procesador de lnea de mandatos que visualice el indicador del procesador de lnea de mandatos cuando el usuario est en modalidad interactiva. El valor por omisin para esta opcin de mandato es ON (activada). La desactivacin del indicador es til cuando los mandatos se dirigen por un rea de interconexin al procesador de lnea de mandatos. Por ejemplo, un archivo que contiene mandatos de CLP podra ejecutarse emitiendo:
db2 +p < miarchivo.clp
La opcin -p se ignora si se especifica la opcin -fnombre-archivo. La opcin de visualizacin de indicador interactivo de DB2 no afecta a ninguna otra opcin del procesador de lnea de mandatos.
186
Command Reference

Opcin Guardar en archivo de informe (-r): La opcin -rnombre-archivo hace que los datos de salida generados por un mandato se graben en un archivo especificado y es til para capturar un informe que, de lo contrario, se desplazara fuera de la pantalla. No se graban mensajes o cdigos de error en el archivo. Nombrearchivo es un nombre de archivo absoluto o relativo que puede incluir la va de acceso de directorio al archivo. Si no se especifica la va de acceso de directorio, se utiliza el directorio actual. Las entradas de informe nuevas se aaden al archivo. El valor por omisin para esta opcin de mandato es OFF (+r o -r-). Si se especifica la opcin -a, los datos SQLCA se graban en el archivo. La opcin -r no afecta a la opcin -e. Si se especifica la opcin -e, SQLCODE o SQLSTATE se graba en la salida estndar, no en un archivo. Si -rnombre-archivo se establece en DB2OPTIONS, el usuario puede establecer la opcin +r (o -r-) desde la lnea de mandatos para impedir que los datos de salida de una invocacin de mandato determinada se graban en el archivo. La opcin de guardar en archivo de informe no afecta a ninguna otra opcin procesador de lnea de mandatos. Opcin Detener ejecucin en error de mandato (-s): Cuando se emiten mandatos en modalidad interactiva o desde un archivo de entrada y se producen errores de sintaxis o de mandato, la opcin -s hace que el procesador de lnea de mandatos detenga la ejecucin y grabe mensajes de error en la salida estndar. El valor por omisin para esta opcin de mandato es OFF (+s o -s-). Este valor hace que el procesador de lnea de mandatos visualice mensajes de error, contine la ejecucin de los mandatos restantes y detenga la ejecucin slo si se produce un error del sistema (cdigo de retorno 8). La tabla siguiente resume este comportamiento:
Tabla 2. Cdigos de retorno de CLP y ejecucin de mandato Cdigo de retorno 0 (satisfactorio) 1 (0 filas seleccionadas) 2 (aviso) 4 (error de DB2 o SQL) 8 (Error del sistema) Opcin -s establecida contina la ejecucin contina la ejecucin contina la ejecucin se detiene la ejecucin se detiene la ejecucin Opcin +s establecida contina la ejecucin contina la ejecucin contina la ejecucin contina la ejecucin se detiene la ejecucin
187

Opcin Carcter de terminacin de sentencia (-t): La opcin -t indica al procesador de lnea de mandatos que utilice un punto y coma (;) como carcter de terminacin de sentencia e inhabilita el carcter de continuacin de lnea de barra inclinada invertida (\). Nota: Esta opcin no se puede cambiar desde la modalidad interactiva. El valor por omisin para esta opcin de mandato es OFF (+t o -t-). Para definir un carcter de terminacin, utilice -td seguido del carcter de terminacin elegido. Por ejemplo, -tdx establece x como carcter de terminacin de sentencia. El carcter de terminacin no se puede utilizar para concatenar mltiples sentencias desde la lnea de mandatos, dado que slo se comprueba el ltimo carcter distinto de un espacio en blanco en cada lnea de entrada como smbolo de terminacin. La opcin de carcter de terminacin de sentencia no afecta a ninguna otra opcin de procesador de lnea de mandatos. Opcin Salida verbosa (-v): La opcin -v hace que el procesador de lnea de mandatos repita en eco (en la salida estndar) el texto de mandato entrado por el usuario antes de visualizar la salida as como los mensajes de dicho mandato. ECHO est exento de esta opcin. El valor por omisin para esta opcin de mandato es OFF (+v o -v-). La opcin -v no tiene ningn efecto si se especifica +o (o bien -o-). La opcin de salida verbosa no afecta a ninguna opcin del procesador de lnea de mandatos. Opcin Mostrar mensajes de aviso (-w): La opcin -w indica al procesador de lnea de mandatos que muestre mensajes de aviso de sentencia de SQL. El valor por omisin para esta opcin de mandato es ON (activada). Opcin Suprimir impresin de cabeceras de columna (-x): La opcin -x indica al procesador de lnea de mandatos que devuelva datos sin ninguna cabecera, incluidos los nombres de columna. El valor por omisin para este mandato es OFF (desactivada). Opcin Guardar toda la salida en archivo (-z): La opcin -znombre-archivo hace que toda la salida generada por un
188
Command Reference

mandato se grabe en un archivo especificado y es til para capturar un informe que, de lo contrario, se desplazara fuera de la pantalla. Es similar a la opcin -r; sin embargo, en este caso tambin se graban en el archivo mensajes, cdigos de error y ms informacin de salida. Nombrearchivo es un nombre de archivo absoluto o relativo que puede incluir la va de acceso de directorio al archivo. Si no se especifica la va de acceso de directorio, se utiliza el directorio actual. Las entradas de informe nuevas se aaden al archivo. El valor por omisin para esta opcin de mandato es OFF (+z o -z-). Si se especifica la opcin -a, los datos SQLCA se graban en el archivo. La opcin -z no afecta a la opcin -e. Si se especifica la opcin -e, SQLCODE o SQLSTATE se graba en la salida estndar, no en un archivo. Si -znombre-archivo se establece en DB2OPTIONS, el usuario puede establecer la opcin +z (o -z-) desde la lnea de mandatos para impedir que los datos de salida de una invocacin de mandato determinada se graben en el archivo. La opcin de guardar toda la salida en archivo no afecta a ninguna otra opcin del procesador de lnea de mandatos.
Cdigos de retorno del procesador de lnea de mandatos

Cuando el procesador de lnea de mandatos termina de procesar un mandato o una sentencia de SQL, devuelve un cdigo de salida (o de retorno). Estos cdigos son transparentes para los usuarios que ejecutan funciones CLP desde la lnea de mandatos, pero se pueden recuperar cuando dichas funciones se ejecutan desde un script de shell. Por ejemplo, el siguiente script del shell Bourne ejecuta el mandato GET DATABASE MANAGER CONFIGURATION y, a continuacin, inspecciona el cdigo de retorno del CLP:
db2 get database manager configuration if [ "$?" = "0" ] then echo "OK!" fi
El cdigo de retorno puede ser uno de los siguientes: Cdigo Descripcin 0 1 El mandato DB2 o la sentencia de SQL se ha ejecutado satisfactoriamente La sentencia SELECT o FETCH no ha devuelto filas
189
Cdigos de retorno del procesador de lnea de mandatos

2 4 8 Aviso de mandato DB2 o de sentencia de SQL Error de mandato DB2 o de sentencia de SQL Error de sistema del Procesador de lnea de mandatos
El procesador de lnea de mandatos no proporciona ningn cdigo de retorno mientras un usuario est ejecutando sentencias desde la modalidad interactiva o mientras se est leyendo entrada en un archivo (utilizando la opcin -f). Un cdigo de retorno slo queda disponible despus de que el usuario haya salido de la modalidad interactiva o cuando ha finalizado el proceso de un archivo de entrada. En estos casos, el cdigo de retorno es el OR lgico de los cdigos de retorno diferenciados devueltos desde los mandatos o las sentencias individuales que se han ejecutado hasta ese momento. Por ejemplo, si un usuario en modalidad interactiva emite mandatos que producen cdigos de retorno de 0, 1 y 2, se devolver un cdigo de retorno de 3 despus de que el usuario haya salido de la modalidad interactiva. No se devuelven los cdigos individuales 0, 1 y 2. El cdigo de retorno 3 indica al usuario que durante el proceso en modalidad interactiva, uno o ms mandatos han devuelto un 1 y uno o ms mandatos han devuelto un 2. Un SQLCODE negativo devuelto por un mandato DB2 o una sentencia de SQL produce un cdigo de retorno de 4. Un cdigo de retorno de 8 slo se produce si el procesador de lnea de mandatos encuentra un error del sistema. Si se emiten mandatos desde un archivo de entrada o en modalidad interactiva y el procesador de lnea de mandatos experimenta un error del sistema (cdigo de retorno 8), se detiene inmediatamente la ejecucin de mandatos. Si uno o ms mandatos DB2 o sentencias de SQL terminan en error (cdigo de retorno 4), la ejecucin de mandatos se detiene si se ha establecido la opcin -s (Detener ejecucin en error de mandato); de lo contrario, la ejecucin contina.
Utilizacin del procesador de lnea de mandatos

El procesador de lnea de mandatos opera del modo siguiente: v El mandato de CLP (en cualquiera de los casos) se escribe en el indicador de mandatos. v El mandato se enva al shell de mandato pulsando la tecla INTRO. v La salida se dirige automticamente al dispositivo de salida estndar. v Se soportan las reas de interconexin y la redireccin. v Se informa al usuario acerca de la realizacin satisfactoria o no satisfactoria.
190
Command Reference
Utilizacin del procesador de lnea de mandatos

v A continuacin de la ejecucin del mandato, el control vuelve al indicador de mandatos del sistema operativo y el usuario puede entrar ms mandatos. Antes de acceder a una base de datos, el usuario debe realizar tareas preliminares como, por ejemplo, iniciar DB2 con el mandato START DATABASE MANAGER. El usuario tambin debe conectarse a una base de datos antes de que sta se pueda consultar. Conctese a una base de datos realizando una de las siguientes acciones: v Emita la sentencia SQL CONNECT TO basedatos v Establezca una conexin implcita a la base de datos por omisin definida por la variable de entorno DB2DBDFT. Si un mandato excede el lmite de caracteres permitido en el indicador de mandatos, se puede utilizar una barra inclinada invertida (\) como carcter de continuacin de lnea. Cuando el procesador de lnea de mandatos encuentra el carcter de continuacin de lnea, lee la lnea siguiente y concatena los caracteres contenidos en ambas lneas. Alternativamente, se puede utilizar la opcin -t para establecer un carcter de terminacin de lnea (consulte 188). En este caso, el carcter de continuacin de lnea no es vlido y todas las sentencias y los mandatos deben finalizar con el carcter de terminacin de lnea. El procesador de lnea de mandatos reconoce una serie llamada NULL como una serie nula. Los campos que se han establecido anteriormente a algn valor pueden establecerse en NULL posteriormente. Por ejemplo,
db2 update database manager configuration using tm_database NULL
establece el campo tm_database en NULL. Esta operacin es sensible a las maysculas y minsculas. Un null en minsculas no se interpreta como una serie nula, sino como una serie que contiene las letras null.
Utilizacin del procesador de lnea de mandatos en archivos de mandatos

Las peticiones de CLP al gestor de bases de datos pueden incluirse en un archivo de mandatos del script de shell. El ejemplo siguiente muestra cmo entrar la sentencia CREATE TABLE en un archivo de mandatos del script de shell:
db2 create table mitabla (name VARCHAR(20), color CHAR(10))
Para obtener ms informacin sobre mandatos y archivos de mandatos, consulte el manual del sistema operativo apropiado.
Diseo del procesador de lnea de mandatos

El procesador de lnea de mandatos consta de dos procesos: el proceso de componente frontal (el mandato DB2), que acta como interfaz de usuario, y el proceso de fondo (db2bp), que mantiene una conexin a la base de datos.
191

Mantenimiento de conexiones a la base de datos Cada vez que se invoca db2, se inicia un nuevo proceso de componente frontal. El proceso de fondo lo inicia la primera invocacin de db2 y puede terminarse explcitamente con el mandato TERMINATE. Todos los procesos de componente frontal con el mismo padre estn atendidos por un solo proceso de fondo y, por consiguiente, comparten una sola conexin a la base de datos. Por ejemplo, las llamadas db2 siguientes desde el mismo indicador de mandatos de sistema operativo producen procesos de componente frontal independientes que comparten un nico proceso de fondo, que mantiene una conexin a la base de datos durante: v v v v db2 'connect to sample, db2 'select * from org, . foo (donde foo es un script de shell que contiene mandatos DB2) y db2 -tf miarchivo.clp.
Las invocaciones siguientes desde el mismo indicador de sistema operativo producen conexiones a la base de datos independientes porque cada una tiene un proceso padre diferenciado y, por consiguiente, un proceso de fondo diferenciado: v v v v foo . foo & foo & sh foo
Comunicacin entre los procesos de componente frontal y de fondo El proceso de componente frontal y los procesos de fondo se comunican mediante tres colas de mensajes: una cola de peticiones, una cola de entrada y una cola de salida. Variables de entorno Las variables de entorno siguientes ofrecen un medio para configurar la comunicacin entre los dos procesos:
Tabla 3. Variables de entorno Variable DB2BQTIME DB2BQTRY DB2RQTIME Mnimo 1 segundo 0 intentos 1 segundo Mximo 5294967295 5294967295 5294967295 Valor por omisin 1 segundo 60 intentos 5 segundos
192
Command Reference

Tabla 3. Variables de entorno (continuacin) Variable DB2IQTIME Mnimo 1 segundo Mximo 5294967295 Valor por omisin 5 segundos
DB2BQTIME Cuando se invoca el procesador de lnea de mandatos, el proceso de componente frontal comprueba si el proceso de fondo ya est activo. Si est activo, el proceso de componente frontal restablece la conexin con el mismo. Si no est activo, el proceso de componente frontal lo activa. Entonces el proceso de componente frontal queda desocupado durante el periodo de tiempo especificado por la variable DB2BQTIME y realiza la comprobacin otra vez. El proceso de componente frontal contina realizando la comprobacin el nmero de veces especificado por la variable DB2BQTRY, despus de lo cual, si el proceso de fondo an no est activo, excede el tiempo de espera y devuelve un mensaje de error. DB2BQTRY Funciona junto con la variable DB2BQTIME y especifica el nmero de veces que el proceso de componente frontal intenta determinar si el proceso de fondo est activo. Los valores de DB2BQTIME y DB2BQTRY pueden aumentar durante periodos punta para optimizar el tiempo de consulta. DB2RQTIME El proceso de fondo, una vez iniciado, espera en la cola de peticiones una peticin del componente frontal. Tambin espera en la cola de peticiones durante el tiempo que transcurre entre las peticiones iniciadas desde el indicador de mandatos. La variable DB2RQTIME especifica el tiempo que espera el proceso de fondo a una peticin del proceso de componente frontal. Al final de este tiempo, si no hay ninguna peticin en la cola de peticiones, el proceso de fondo comprueba si an existe el padre del proceso de componente frontal y termina, si ste no existe. De lo contrario, contina esperando en la cola de peticiones. DB2IQTIME Cuando el proceso de fondo recibe una peticin del proceso de componente frontal, enva un acuse de recibo al proceso de componente frontal indicando que est preparado para recibir entrada a travs de la cola de entrada. Entonces el proceso de fondo espera en su cola de entrada. Tambin espera en la cola de entrada mientras se est ejecutando un archivo de proceso por lotes (especificado con la opcin -f) y mientras el usuario est en modalidad interactiva.
193

La variable DB2IQTIME especifica el tiempo que el proceso de fondo espera en la cola de entrada a que el proceso de componente frontal pase los mandatos. Cuando este tiempo ha transcurrido, el proceso de fondo comprueba si el proceso de componente frontal est activo y vuelve a esperar en la cola de peticiones si el proceso de componente frontal ya no existe. De lo contrario, el proceso de fondo contina esperando entrada del proceso de componente frontal. Para ver los valores de estas variables de entorno, utilice el mandato LIST COMMAND OPTIONS. Las variables de entorno del programa de fondo heredan los valores establecidos por el proceso de componente frontal en el momento en que se inicia el proceso de fondo. Sin embargo, si se cambian las variables de entorno del componente frontal, el proceso de fondo no heredar estos cambios. El proceso de fondo debe terminarse primero y, a continuacin, reiniciarse (emitiendo el mandato db2) para heredar los valores modificados. En el escenario siguiente se proporciona un ejemplo de cundo debe terminarse el proceso de fondo: 1. El usuario A se conecta, emite algunos mandatos de CLP y, a continuacin, se desconecta sin emitir TERMINATE. 2. El usuario B se conecta utilizando la misma ventana. 3. Cuando el usuario B emite determinados mandatos de CLP, stos fallan con el mensaje DB21016 (error del sistema). El proceso de fondo iniciado por el usuario A an est activo cuando el usuario B empieza a utilizar el CLP, porque el padre del proceso de componente frontal del usuario B (la ventana de sistema operativo desde la que se emiten los mandatos) est an activo. El proceso de fondo intenta atender los nuevos mandatos emitidos por el usuario B; sin embargo, el proceso de componente frontal del usuario B no tiene suficiente autorizacin para utilizar las colas de mensajes del proceso de fondo, porque necesita la autorizacin del usuario A, que ha creado dicho proceso de fondo. Una sesin CLP debe terminar con un mandato TERMINATE antes que un usuario inicie una nueva sesin CLP utilizando la misma ventana de sistema operativo. Esto crea un proceso de fondo nuevo para cada usuario nuevo, evitando problemas de autorizacin y estableciendo los valores correctos de las variables de entorno (por ejemplo DB2INSTANCE) en el proceso de fondo del nuevo usuario.
Notas sobre el uso del CLP

Los mandatos pueden entrarse en maysculas o en minsculas desde el indicador de mandatos. Sin embargo, los parmetros que son sensibles a las maysculas y minsculas en DB2 deben entrarse con las maysculas y minsculas exactas deseadas. Por ejemplo, la serie-comentario de la clusula
194
Command Reference

WITH del mandato CHANGE DATABASE COMMENT es un parmetro sensible a las maysculas y minsculas. Se permiten identificadores delimitados en las sentencias de SQL. Se permiten caracteres especiales o metacaracteres (por ejemplo $ & * ( ) ; < > ? \ ' ") dentro de los mandatos de CLP. Si se utilizan fuera de la modalidad interactiva del CLP o la modalidad de entrada de proceso por lotes de CLP, el shell del sistema operativo interpreta dichos caracteres. Es necesario utilizar comillas o un carcter de escape si el shell no debe realizar ninguna accin especial. Por ejemplo, cuando se ejecuta dentro del entorno del shell Korn de AIX,
db2 select * from org where division > 'Eastern'
se interpreta como select <los nombres de todos los archivos> from org where division. El resultado, un error de sintaxis de SQL, se redirige al archivo Eastern. La sintaxis siguiente produce la salida correcta:
db2 "select * from org where division > 'Eastern'"
Los caracteres especiales varan de una plataforma a otra. En el shell Korn de AIX, el ejemplo anterior puede volverse a escribir utilizando un carcter de escape (\), por ejemplo \*, \> o \'. La mayora de los entornos de sistema operativo permiten redirigir la entrada y la salida. Por ejemplo, si se ha realizado una conexin a la base de datos SAMPLE, la peticin siguiente consulta la tabla STAFF y enva la salida a un archivo llamado staflist.txt del directorio misdatos:
db2 "select * from staff" > misdatos/staflist.txt
Para entornos donde no est soportada la redireccin de la salida, se pueden utilizar opciones de CLP. Por ejemplo, la peticin puede escribirse como
db2 -r misdatos\staflist.txt "select * from staff" db2 -z misdatos\staflist.txt "select * from staff"
El procesador de lnea de mandatos no es un lenguaje de programacin. Por ejemplo, no soporta variables de sistema principal, y la sentencia
db2 connect to :HostVar in share mode
es sintcticamente incorrecta, porque :HostVar no es un nombre de base de datos vlido.
195

El procesador de lnea de mandatos representa los valores NULL de SQL como guiones (-). Si la columna es numrica, el guin se coloca a la derecha de la columna. si la columna no es numrica, el guin est a la izquierda. Para visualizar correctamente los caracteres nacionales para idiomas de nico byte (SBCS) desde la ventana del procesador de lnea de mandatos de DB2, debe seleccionarse un font True Type. Por ejemplo, en un entorno Windows, abra el cuaderno de propiedades de ventana de mandatos y seleccione un font como por ejemplo Lucinda Console.
196
Command Reference
Captulo 3. Mandatos de CLP

Esta seccin describe los mandatos DB2 en orden alfabtico. Estos mandatos se utilizan para controlar el sistema de forma interactiva. Nota: Las barras inclinadas (/) que aparecen en las vas de acceso de directorio son especficas de los sistemas basados en UNIX y son equivalentes a las barras inclinadas invertidas (\) de las vas de acceso de directorio de los sistemas operativos Windows.
Mandato ACTIVATE DATABASE

Activa la base de datos especificada y arranca todos los servicios de base de datos necesarios, de modo que la base de datos est disponible para que se conecte y la utilice cualquier aplicacin. mbito: Este mandato activa la base de datos especificada en todos los nodos del sistema. Si uno o varios de estos nodos encuentran un error durante la activacin de la base de datos, se devuelve un aviso. La base de datos permanece activada en todos los nodos en los que el mandato ha sido satisfactorio. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna Sintaxis del mandato:
ACTIVATE DATABASE DB alias-base-datos
197
ACTIVATE DATABASE
USER nombreusuario USING contrasea
Parmetros del mandato: alias-base-datos Especifica el alias de la base de datos que se debe iniciar. USER nombreusuario Especifica el usuario que inicia la base de datos. USING contrasea Especifica la contrasea para el nombre de usuario. Notas de uso: Si una base de datos no se ha iniciado y se emite un CONNECT TO (o una conexin implcita) en una aplicacin, la aplicacin deber esperar mientras el gestor de bases de datos inicia la base de datos necesaria, antes de poder realizar cualquier trabajo con dicha base de datos. Sin embargo, una vez que se ha iniciado la base de datos, otras aplicaciones pueden simplemente conectarse y utilizarla sin perder tiempo en el arranque. Los administradores de bases de datos pueden utilizar ACTIVATE DATABASE para arrancar bases de datos seleccionadas. Esto elimina el tiempo que la aplicacin emplea en la inicializacin de la base de datos. Las bases de datos inicializadas por ACTIVATE DATABASE pueden cerrarse mediante el mandato DEACTIVATE DATABASE o mediante el mandato db2stop. Si se ha iniciado una base de datos mediante un CONNECT TO (o una conexin implcita) y posteriormente se emite ACTIVATE DATABASE para esa misma base de datos, se deber utilizar DEACTIVATE DATABASE para cerrar dicha base de datos. Si no se ha utilizado ACTIVATE DATABASE para iniciar la base de datos, sta se cerrar cuando se desconecte la ltima aplicacin. ACTIVATE DATABASE se comporta de un modo similar a CONNECT TO (o una conexin implcita) cuando se utiliza con una base de datos que requiere un reinicio (por ejemplo, una base de datos en un estado incoherente). La base de datos se reiniciar antes de que ACTIVATE DATABASE pueda inicializarla. El reinicio slo se llevar a cabo si la base de datos se ha configurado para tener AUTORESTART ON. Nota: La aplicacin que emite el mandato ACTIVATE DATABASE no puede tener una conexin de base de datos activa a cualquier base de datos.
198
Command Reference
ACTIVATE DATABASE
Informacin relacionada: v Mandato STOP DATABASE MANAGER en la pgina 687 v Mandato DEACTIVATE DATABASE en la pgina 298
199
ADD CONTACT Mandato ADD CONTACT

El mandato aade un contacto a la lista de contactos que se puede definir localmente en el sistema o en una lista global. Los contactos son usuarios a los que los procesos, tales como el Planificador y el Supervisor de salud, envan mensajes. El valor del parmetro de configuracin contact_host del Servidor de administracin de bases de datos (DAS) determina si la lista es local o global. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Slo en ejecucin local: este mandato no se puede utilizar con una conexin remota. Sintaxis del mandato:
ADD CONTACT nombre TYPE EMAIL PAGE
MAXIMUM PAGE LENGTH MAX LEN
longitud-pg
ADDRESS direccin de destinatario
DESCRIPTION descripcin de contacto
Parmetros del mandato: CONTACT nombre Nombre del contacto que se aadir. Por omisin, el contacto se aadir al sistema local, a menos que el parmetro de configuracin contact_host del Servidor de administracin DB2 apunte a otro sistema. TYPE Mtodo de contacto, que debe ser uno de los dos siguientes: EMAIL Este contacto desea recibir las notificaciones por correo electrnico en (ADDRESS). PAGE Este contacto desea recibir las notificaciones mediante un mensaje de buscapersonas enviado a ADDRESS. MAXIMUM PAGE LENGTH longitud-pg Si el servicio de buscapersonas tiene restringida la longitud de los mensajes, se especifica aqu en caracteres. Nota: El sistema de notificacin utiliza el protocolo SMTP para enviar la notificacin al servidor de correo
200
Command Reference
ADD CONTACT
especificado por el parmetro de configuracin smtp_server del Servidor de administracin de DB2. Es responsabilidad del servidor SMTP enviar el correo electrnico o llamar al buscapersonas. ADDRESS direccin-destinatario Direccin del buzn de SMTP del destinatario. Por ejemplo, juan@unsitio.org. El parmetro de configuracin smtp_server de DAS debe establecerse como el nombre del servidor SMTP. DESCRIPTION descripcin contacto Texto descriptivo del contacto. Tiene una longitud mxima de 128 caracteres.
201
ADD CONTACTGROUP Mandato ADD CONTACTGROUP

Aade un nuevo grupo de contactos a la lista de los grupos definidos en el sistema local. Un grupo de contacto es una lista de usuarios y grupos a los que los procesos de supervisin, tales como el Planificador y el Supervisor de salud, pueden enviar mensajes. Autorizacin: Ninguna Conexin necesaria: Ninguna. Slo en ejecucin local: este mandato no se puede utilizar con una conexin remota. Sintaxis del mandato:
, ADD CONTACTGROUP nombre CONTACT GROUP nombre
DESCRIPTION
descripcin de grupo
Parmetros del mandato: CONTACTGROUP nombre Nombre del nuevo grupo de contacto, que debe ser exclusivo entre el conjunto de grupos del sistema. CONTACT nombre Nombre del contacto que es miembro del grupo. No es necesario que defina un contacto individual antes de incluir ese contacto en un grupo. GROUP nombre Nombre del grupo de contactos del que este grupo es miembro. DESCRIPTION descripcin grupo Opcional. Texto descriptivo del grupo de contacto.
202
Command Reference
ADD DATALINKS MANAGER Mandato ADD DATALINKS MANAGER

Aade un DB2 Data Links Manager a la lista de DB2 Data Links Manager registrados para una base de datos especificada. Autorizacin: Una de las siguientes v sysadm v sysctrl v sysmaint Sintaxis del mandato:
ADD DATALINKS MANAGER FOR DATABASE DB nombrebd USING
NODE CELL
nombresistpral PORT nmero-puerto nombreclula-DFS DLMINSTANCE nombre-instancia
Parmetros del mandato: DATABASE nombrebd Especifica un nombre de base de datos. USING NODE nombresistpral Especifica un nombre de sistema principal totalmente calificado o la direccin (pero no ambos valores) del servidor DB2 Data Links Manager. PORT nmero-puerto Especifica el nmero de puerto que se ha reservado para las comunicaciones del servidor DB2 al servidor DB2 Data Links Manager. CELL nombreclula-DFS Especifica el nombre totalmente calificado de la clula DFS. Por ejemplo, dln1.almaden.ibm.com. Nota: Este parmetro slo permite registrar una clula en una base de datos. DLMINSTANCE nombre-instancia Especifica el nombre de instancia que ejecuta el Data Links Manager en la clula.
203
ADD DATALINKS MANAGER

Notas de uso: Este mandato slo es efectivo despus de haber desconectado todas las aplicaciones de la base de datos. El DB2 Data Links Manager que est aadiendo debe estar completamente configurado y a punto para que este mandato sea satisfactorio. La base de datos tambin debe registrarse en el DB2 Data Links Manager utilizando el mandato dlfm add_db. El nmero mximo de DB2 Data Links Managers que se pueden aadir a la base de datos es 16. Se dice que un Data Links Manager que se ha aadido especificando USING NODE es de tipo Nativo, mientras que un Data Links Manager que se ha aadido especificando USING CELL es de tipo DFS. Todos los Data Links Manager registrados en una base de datos deben ser del mismo tipo y slo se puede registrar un Data Links Manager de tipo DFS en una base de datos. Cuando registre uno o ms DB2 Data Links Manager para una base de datos utilizando este mandato, asegrese de que el DB2 Data Links Manager no est registrado dos veces; de lo contrario, puede que se devuelva el error SQL20056N con el cdigo de razn 99 durante el proceso. El archivo db2diag.log para el servidor DB2 Data Links Manager que se registre dos veces tendr la entrada siguiente cuando se produzca una anomala de este tipo:
dfm_xnstate_cache_insert : Entrada txn duplicada. dfmBeginTxn : No se puede insertar transaccin ACTIVA \ en antememoria, cr = 41. DLFM501E : Ha fallado el servicio de gestin de transacciones.
Nota: El Procesador de lnea de mandatos detecta errores si se aaden Data Links Manager duplicados utilizando el mismo nombre o la misma direccin. Sin embargo, no se detectan los duplicados si se aade un Data Links Manager ms de una vez utilizando un nombre o una direccin IP diferente. Por ejemplo, si se ha aadido dos veces un Data Links Manager, una vez utilizando el nombre dln1.almaden.ibm.com y otra vez utilizando el nombre abreviado dln1, la anomala descrita anteriormente es posible. Informacin relacionada: v Mandato LIST DATALINKS MANAGERS en la pgina 447 v Mandato DROP DATALINKS MANAGER en la pgina 312
204
Command Reference
ADD DBPARTITIONNUM Mandato ADD DBPARTITIONNUM

Aade un nuevo servidor de particiones de base de datos al entorno de base de datos particionado. Este mandato crea tambin una particin de base de datos para todas las bases de datos del nuevo servidor de particiones de base de datos. El usuario puede especificar el servidor de particiones de base de datos fuente para cualquier espacio de tabla temporal del sistema que ha de crearse con la nueva particin de base de datos, o especifique que no ha de crearse ningn espacio de tabla temporal del sistema. El mandato debe emitirse desde el servidor de particiones de base de datos que se est aadiendo. mbito: Este mandato slo afecta a la mquina en la que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
ADD DBPARTITIONNUM LIKE DBPARTITIONNUM nmero-particin-bd WITHOUT TABLESPACES
Parmetros del mandato: LIKE DBPARTITIONNUM nmero-particin-bd Especifica que los contenedores para los nuevos espacios de tabla temporales del sistema sern los mismos que los contenedores de la base de datos en el servidor de particiones de base de datos especificado por nmero-particin-bd. El servidor de particiones de base de datos especificado debe estar ya definido en el archivo db2nodes.cfg. WITHOUT TABLESPACES Especifica que no se crean contenedores para los espacios de tabla temporales del sistema para ninguna de las particiones de base de datos. La sentencia ALTER TABLESPACE se debe utilizar para aadir
205
ADD DBPARTITIONNUM
contenedores de espacios de tablas temporales del sistema a cada particin de base de datos antes de que se pueda utilizar la base de datos. Nota: Si no se especifica ninguna opcin, los contenedores para los espacios de tabla temporales del sistema sern los mismos que los contenedores de la particin de catlogo para cada base de datos. La particin de catlogo puede ser una particin de base de datos diferente para cada base de datos del entorno particionado. Notas de uso: Antes de aadir un nuevo servidor de particiones de base de datos, asegrese de que haya almacenamiento suficiente para los contenedores que deben crearse para todas las bases de datos existentes en la instancia. La operacin de adicin de servidor de particiones de base de datos crea una particin de base de datos vaca para cada base de datos que existe en la instancia. Los parmetros de configuracin para las particiones de base de datos nuevas se establecen en los valores por omisin. Si una operacin de adicin de servidor de particiones de base de datos falla mientras se crea localmente una particin de base de datos, entra en fase de borrado, en la que elimina localmente todas las bases de datos que se han creado. Esto significa que las particiones de base de datos slo se eliminan del servidor de particiones de base de datos que se est aadiendo. Las particiones de base de datos existentes permanecen en todos los dems servidores de particiones de base de datos sin quedar afectadas. Si esta accin de borrado falla, no se realiza ningn borrado adicional y se devuelve un error. Las particiones de base de datos de la nueva particin de base de datos no pueden contener datos de usuario hasta despus de haber utilizado la sentencia ALTER DATABASE PARTITION GROUP para aadir la particin de base de datos a un grupo de particiones de base de datos. Este mandato fallar si est en proceso una operacin de creacin de base de datos o de eliminacin de base de datos. Se puede volver a emitir el mandato cuando la operacin se haya completdo. Si se deben crear espacios de tabla temporales del sistema con las particiones de base de datos, puede que ADD DBPARTITIONNUM tenga que comunicarse con otro servidor de particiones de base de datos a fin de recuperar las definiciones de espacio de tabla para las particiones de base de datos que se ubican en este servidor. Se utiliza el parmetro de configuracin
206
Command Reference
ADD DBPARTITIONNUM
start_stop_time gestor de bases de datos para especificar la hora, en minutos, por la cual el otro servidor de particiones de base de datos debe responder con las definiciones de espacio de tabla. Si se excede este tiempo, el mandato fallar. Si se produce esta situacin, aumente el valor de start_stop_time y vuelva a emitir el mandato. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato START DATABASE MANAGER en la pgina 681
207
ARCHIVE LOG Mandato ARCHIVE LOG

Cierra y trunca el archivo de anotaciones cronolgicas activo para una base de datos recuperable. Si est habilitada una salida de usuario, se emite una peticin de archivar. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos mientras dura el mandato. Sintaxis del mandato:
ARCHIVE LOG FOR DATABASE DB alias-basedatos
USER
nombreusuario USING contrasea
Clusula En nmero de particin de base de datos
Clusula En nmero de particin de base de datos:

ON Clusula Lista de nmeros de particin de base de datos ALL DBPARTITIONNUMS EXCEPT Clusula Lista de nmeros de particin de base de datos
Clusula Lista de nmeros de particin de base de datos:

, DBPARTITIONNUM DBPARTITIONNUMS ( nmero-particin-bd TO nmero-particin-bd )
208
Command Reference
ARCHIVE LOG
Parmetros del mandato: DATABASE alias-basedatos Especifica el alias de la base de datos cuya anotacin cronolgica activa debe archivarse. USER nombreusuario Identifica el nombre de usuario bajo el cual se intentar una conexin. USING contrasea Especifica la contrasea para autentificar el nombre de usuario. ON ALL DBPARTITIONNUMS Especifica que el mandato debe emitirse en todas las particiones de base de datos del archivo db2nodes.cfg. ste es el valor por omisin si no se especifica una clusula de nmero de particin de base de datos. EXCEPT Especifica que el mandato debe emitirse en todas las particiones de base de datos del archivo db2nodes.cfg, excepto las especificadas en la lista de nmeros de particin de base de datos. ON DBPARTITIONNUM/ON DBPARTITIONNUMS Especifica que las anotaciones cronolgicas deben archivarse para la base de datos especificada en un conjunto de particiones de base de datos. nmero-particin-bd Especifica un nmero de particin de base de datos en la lista de nmeros de particin de base de datos. TO nmero-particin-bd Se utiliza cuando se especifica un rango de particiones de base de datos para las que deben archivarse las anotaciones cronolgicas. En la lista de nmeros de particin de base de datos se incluyen todas las particiones de base de datos desde el primer nmero de particin de base de datos hasta el segundo nmero de particin de base de datos inclusive. Notas de uso: Este mandato puede utilizarse para obtener un conjunto completo de archivos de anotaciones cronolgicas hasta un punto conocido. A continuacin, los archivos de anotaciones cronolgicas pueden utilizarse para actualizar una base de datos de reserva. Este mandato slo se puede ejecutar cuando el shell o la aplicacin de invocacin no tiene una conexin de base de datos con la base de datos especificada. Esto evita que un usuario pueda ejecutar el mandato con
209
ARCHIVE LOG
transacciones no comprometidas. As, el mandato ARCHIVE LOG no comprometer de modo forzado las transacciones incompletas del usuario. Si el shell o la aplicacin de invocacin ya tiene una conexin de base de datos con la base de datos especificada, el mandato terminar y devolver un error. Si otra aplicacin tiene transacciones en proceso con la base de datos especificada cuando se ejecuta este mandato, se producir un ligero descenso del rendimiento puesto que el mandato vaca el almacenamiento intermedio de anotaciones cronolgicas en disco. Cualquier otra transaccin que intente grabar registros de anotaciones cronolgicas en el almacenamiento intermedio tendr que esperar a que la operacin de vaciar se haya completado. Si se utiliza en un entorno de base de datos particionado, puede especificarse un subconjunto de particiones de base de datos utilizando una clusula de nmero de particin de base de datos. Si no se especifica la clusula de nmero de particin de base de datos, el comportamiento por omisin para este mandato consiste en cerrar y archivar la anotacin cronolgica activa en todas las particiones de base de datos. El uso de este mandato utilizar una porcin del espacio de las anotaciones cronolgicas activas, debido al truncamiento del archivo de anotaciones cronolgicas activo. El espacio de anotaciones cronolgicas activas recuperar su tamao anterior cuando las anotaciones cronolgicas truncadas queden inactivas. El uso frecuente de este mandato puede reducir drsticamente la cantidad del espacio de anotaciones cronolgicas activas que est disponible para transacciones. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. v La palabra clave NODES puede sustituirse por DBPARTITIONNUMS.
210
Command Reference
ATTACH Mandato ATTACH

Permite a una aplicacin especificar la instancia en la que deben ejecutarse los mandatos a nivel de instancia (por ejemplo CREATE DATABASE y FORCE APPLICATION). Esta instancia puede ser la instancia actual, otra instancia de la misma estacin de trabajo o una instancia de una estacin de trabajo remota. Autorizacin: Ninguna Conexin necesaria: Ninguna. Este mandato establece una conexin de instancia. Sintaxis del mandato:
ATTACH TO USER nombrenodo
nombreusuario USING contrasea NEW CHANGE PASSWORD contrasea CONFIRM contrasea
Parmetros del mandato: TO nombrenodo Alias de la instancia a la que desea conectarse el usuario. Esta instancia puede tener una entrada que coincide en el directorio de nodo local. La nica excepcin a esto es la instancia local (especificada por la variable de entorno DB2INSTANCE) que puede especificarse como objeto de una conexin, pero que no se puede utilizar como nombre de nodo en el directorio de nodo. USER nombreusuario Especifica el identificador de autentificacin. USING contrasea Especifica la contrasea para el nombre de usuario. Si se especifica un nombre de usuario, pero no se especifica una contrasea, se solicita al usuario la contrasea actual. La contrasea no se visualiza al entrarse. NEW contrasea Especifica la contrasea nueva que se debe asignar al nombre de usuario. Las contraseas pueden tener hasta 18 caracteres de longitud. El sistema en el que se cambiar la contrasea depende del modo en que se haya configurado la autentificacin de usuario.
211
ATTACH
CONFIRM contrasea Serie que debe ser idntica a la contrasea nueva. Este parmetro se utiliza para detectar errores de entrada. CHANGE PASSWORD Si se especifica esta opcin, se solicita al usuario la contrasea actual, una contrasea nueva y la confirmacin de la contrasea nueva. Las contraseas no se visualizan al entrarse. Ejemplos: Catalogar dos nodos remotos:
db2 catalog tcpip node nodo1 remote freedom server servidor1 db2 catalog tcpip node nodo2 remote flash server servidor1
Conectarse al primer nodo, forzar todos los usuarios y, a continuacin, desconectarse:

db2 attach to nodo1 db2 force application all db2 detach
Conectarse al segundo nodo y ver qu est activo:

db2 attach to nodo2 db2 list applications
Despus de que el mandato devuelva los ID de agente 1, 2 y 3, forzar 1 y 3 y luego desconectarse:

db2 force application (1, 3) db2 detach
Conectarse a la instancia actual (no necesario, estar implcito), forzar todos los usuarios y, a continuacin, desconectarse (slo AIX):
db2 attach to $DB2INSTANCE db2 force application all db2 detach
Notas de uso: Si se omite nombrenodo en el mandato, se devuelve informacin acerca del estado actual de la conexin. Si se no ha ejecutado ATTACH, los mandatos a nivel de instancia se ejecutan en la instancia actual, especificada por la variable de entorno DB2INSTANCE. Informacin relacionada: v Mandato DETACH en la pgina 306
212
Command Reference
AUTOCONFIGURE Mandato AUTOCONFIGURE

Calcula y visualiza los valores ptimos para los parmetros del tamao de agrupacin de almacenamientos intermedios, de configuracin de base de datos y de configuracin de gestor de bases de datos, con la opcin de aplicar estos valores recomendados. Autorizacin: sysadm. Conexin necesaria: Base de datos. Sintaxis del mandato:
AUTOCONFIGURE
USING
palabraclave-entrada
valor-parm
APPLY
DB ONLY DB AND DBM NONE
Parmetros del mandato: USING palabraclave-entrada valor parm

Tabla 4. Palabras claves de entrada y valores de parmetro vlidos Palabra clave mem_percent Valores vlidos 1100 Valor por omisin 80 Explicacin Porcentaje de memoria que se va a dedicar. Si otras aplicaciones (aparte del sistema operativo) se estn ejecutando en este servidor, establezca este valor en menos de 100.
213
AUTOCONFIGURE
Tabla 4. Palabras claves de entrada y valores de parmetro vlidos (continuacin) Palabra clave workload_type Valores vlidos simple, mixed, complex Valor por omisin mixed Explicacin Las cargas de trabajo sencillas tienden a tener una actividad intensiva de E/S y principalmente de transacciones, mientras que las cargas de trabajo complejas tienden a tener una actividad intensiva de CPU y principalmente de consultas. Nmero de sentencias por unidad de trabajo Transacciones por minuto Optimizar para obtener un rendimiento mejor (ms transacciones por minuto) o un tiempo de recuperacin mejor Est la base de datos llena de datos? Nmero de aplicaciones locales conectadas Nmero de aplicaciones remotas conectadas
num_stmts
11 000 000
10
tpm admin_priority
150 000 performance, recovery, both
60 both
is_populated
yes, no
yes
num_local_apps
05 000
num_remote_apps
05 000
10
214
Command Reference
AUTOCONFIGURE
Tabla 4. Palabras claves de entrada y valores de parmetro vlidos (continuacin) Palabra clave isolation Valores vlidos RR, RS, CS, UR Valor por omisin RR Explicacin Nivel de aislamiento de aplicaciones que conectan con esta base de datos (RR: Lectura repetible; RS: Estabilidad de lectura; CS: Estabilidad de cursor; UR: Lectura no comprometida) Puede modificarse el tamao de las agrupaciones de almacenamientos intermedios?
bp_resizeable
yes, no
yes
APPLY DB ONLY Visualiza todos los cambios recomendados y slo aplica los cambios recomendados a los valores de configuracin de base de datos y de agrupacin de almacenamientos intermedios. ste es el valor por omisin si no se especifica la opcin APPLY. DB AND DBM Visualiza y aplica los cambios recomendados a los valores de configuracin de gestor de bases de datos, de configuracin de base de datos y de agrupacin de almacenamientos intermedios. NONE Visualiza los cambios recomendados, pero no los aplica. Notas de uso: Si no se especifica alguna de las palabras claves de entrada, se utilizar el valor por omisin para ese parmetro. En un entorno de base de datos particionado, este mandato slo aplica los cambios a la particin actual.
215
BACKUP DATABASE Mandato BACKUP DATABASE

Crea una copia de seguridad de una base de datos o de un espacio de tabla. mbito: Este mandato slo afecta a la particin de base de datos en la que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Base de datos. Este mandato establece automticamente una conexin a la base de datos especificada. Nota: Si ya existe una conexin a la base de datos especificada, esa conexin se terminar y se establecer una nueva conexin especficamente para la operacin de copia de seguridad. La conexin terminar cuando se haya realizado la operacin de copia de seguridad. Sintaxis del mandato:
BACKUP DATABASE DB alias-basedatos
USER
, TABLESPACE ( nombre-espaciotabla )
ONLINE
INCREMENTAL DELTA
216
Command Reference
BACKUP DATABASE
USE TSM XBSA ,
OPEN nm-sesiones
SESSIONS
TO LOAD
dir disp nombre-biblioteca OPEN nm-sesiones SESSIONS
WITH
nm-almacints
BUFFERS
BUFFER
tamao-almacint
PARALLELISM
WITHOUT PROMPTING
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos de la que se debe hacer la copia de seguridad. USER nombreusuario Identifica el nombre de usuario bajo el que debe efectuarse la copia de seguridad de la base de datos. USING contrasea Contrasea utilizada para autentificar el nombre de usuario. Si se omite la contrasea, se solicitar al usuario que la entre. TABLESPACE nombre-espaciotabla Lista de nombres utilizados para especificar los espacios de tabla de los que se debe hacer copia de seguridad. ONLINE Especifica copia de seguridad en lnea. El valor por omisin es copia de seguridad fuera de lnea. Las copias de seguridad en lnea slo estn disponibles para bases de datos configuradas con logretain o userexit habilitado. Nota: Una operacin de copia de seguridad en lnea puede exceder el tiempo de espera si existe un bloqueo IX en sysibm.systables, porque el programa de utilidad de copia de seguridad de DB2 necesita un bloqueo S en los objetos que contienen LOB. INCREMENTAL Especifica una imagen de copia de seguridad acumulativa (incremental). Una imagen de copia de seguridad incremental es una copia de todos los datos de la base de datos que se han modificado desde la operacin de copia de seguridad completa ms reciente que ha resultado satisfactoria.
217
BACKUP DATABASE
DELTA Especifica una imagen de copia de seguridad (delta) no acumulativa. Una imagen de copia de seguridad delta es una copia de todos los datos de la base de datos que se han modificado desde la operacin de copia de seguridad de cualquier tipo ms reciente que ha resultado satisfactoria. USE TSM Especifica que la copia de seguridad debe utilizar salida de Tivoli Storage Manager (anteriormente ADSM). OPEN nm-sesiones SESSIONS Nmero de sesiones de E/S que se deben crear entre DB2 y TSM u otro producto de proveedor de copia de seguridad. Nota: Este parmetro no tiene ningn efecto cuando se hace la copia de seguridad en cinta, en disco o en otro dispositivo local. USE XBSA Especifica que debe utilizarse la interfaz XBSA. Las API de servicios de copia de seguridad (XBSA) se encuentran en una interfaz de programacin de aplicaciones abierta para aplicaciones o recursos que necesitan gestin de almacenamiento de datos para finalidades de copia de seguridad o archivo. Legato NetWorker es un gestor de almacenamiento que actualmente soporta la interfaz XBSA. TO dir/disp Lista de nombres de directorio o dispositivo de cinta. Se debe especificar la va de acceso completa en la que reside el directorio. Si se omiten USE TSM, TO y LOAD, el directorio de destino por omisin para la imagen de copia de seguridad es el directorio de trabajo actual del sistema cliente. Este directorio o dispositivo de destino debe existir en el servidor de bases de datos. Este parmetro puede repetirse para especificar los directorios y los dispositivos de destino que fragmentar la imagen de copia de seguridad. Si se especifica ms de un destino (por ejemplo destino1, destino2 y destino3), se abrir primero destino1. La cabecera del soporte y los archivos especiales (incluidos el archivo de configuracin, la tabla de espacios de tabla y el archivo histrico) se colocarn en destino1. Todos los dems destinos se abren y, a continuacin, se utilizan en paralelo durante la operacin de copia de seguridad. Dado que no existe un soporte de cinta general en los sistemas operativos Windows, cada tipo de dispositivo de cinta requiere un controlador de dispositivo exclusivo. Para hacer una copia de seguridad del sistema de archivos FAT en los sistemas operativos Windows, los usuarios deben respetar la restriccin de denominacin 8.3.
218
Command Reference
BACKUP DATABASE
El uso de dispositivos de cinta o disquetes puede generar mensajes y solicitudes de entrada de usuario. Las opciones de respuesta vlidas son: c Continuar. Continuar utilizando el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando se ha montado una cinta nueva) Terminacin de dispositivo. Dejar de utilizar solamente el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando no hay ms cintas) Terminar. Terminar anormalmente la operacin de copia de seguridad.
Si el sistema de la cinta no soporta la capacidad de hacer referencia exclusivamente a una imagen de copia de seguridad, se recomienda no guardar varias copias de seguridad de la misma base de datos en la misma cinta. LOAD nombre-biblioteca Nombre de la biblioteca compartida (DLL en los sistemas operativos Windows) que contiene las funciones de E/S de copia de seguridad y restauracin de proveedor que hay que utilizar. Puede contener la va de acceso completa. Si no se proporciona la va de acceso completa, tomar por omisin la va de acceso en la que reside el programa de salida de usuario. WITH nm-almacints BUFFERS Nmero de almacenamientos intermedios a utilizar. El valor por omisin es 2. Sin embargo, cuando se crea una copia de seguridad en mltiples ubicaciones, se puede utilizar un nmero mayor de almacenamientos intermedios para mejorar el rendimiento. BUFFER tamao-almacint Tamao, en pginas de 4 KB, del almacenamiento intermedio utilizado al crear la imagen de copia de seguridad. El valor mnimo para este parmetro es 8 pginas; el valor por omisin es de 1024 pginas. Si utiliza una cinta con tamaos de bloque variables, reduzca el tamao de almacenamiento intermedio a un rango soportado por el dispositivo de cinta. De lo contrario, la operacin de copia de seguridad puede ser satisfactoria, pero la imagen resultante puede que no sea recuperable. Cuando utilice dispositivos de cinta en SCO UnixWare 7, especifique un almacenamiento intermedio de 16. En la mayora de versiones de Linux, la utilizacin del tamao de almacenamiento intermedio por omisin de DB2 para operaciones de
219
BACKUP DATABASE
copia de seguridad a un dispositivo de cinta SCSI produce el error SQL2025N, cdigo de razn 75. Para evitar el desbordamiento de almacenamientos intermedios SCSI internos de Linux, utilice la frmula siguiente:
bufferpages <= ST_MAX_BUFFERS * ST_BUFFER_BLOCKS / 4
donde bufferpages es el valor que desea utilizar con el parmetro BUFFER, y ST_MAX_BUFFERS y ST_BUFFER_BLOCKS estn definidos en el kernet de Linux bajo el directorio drivers/scsi. PARALLELISM n Determina el nmero de espacios de tabla que puede leer en paralelo el programa de utilidad de copia de seguridad. El valor por omisin es 1. WITHOUT PROMPTING Especifica que la copia de seguridad se ejecutar desatendida y que las acciones que normalmente requieren la intervencin del usuario devolvern un mensaje de error. Ejemplos: En el ejemplo siguiente, la base de datos WSDB est definida en las 4 particiones, numeradas de 0 a 3. La va de acceso /dev3/backup es accesible desde todas las particiones. La particin 0 es la particin de catlogo y se tiene que realizar la copia de seguridad por separado, ya que es una copia de seguridad fuera de lnea. Para realizar una copia de seguridad fuera de lnea de todas las particiones de base de datos de WSDB en /dev3/backup, emita los mandatos siguientes desde una de las particiones de base de datos:
db2_all <<+0< db2 BACKUP DATABASE wsdb TO /dev3/backup db2_all |<<-0< db2 BACKUP DATABASE wsdb TO /dev3/backup
En el segundo mandato, el programa de utilidad db2_all emitir por turnos el mismo mandato de copia de seguridad a cada una de las particiones de base de datos (excepto la particin 0). Las cuatro imgenes de copia de seguridad de particin de base de datos se almacenarn en el directorio /dev3/backup. En el ejemplo siguiente se realiza una copia de seguridad SAMPLE en un servidor TSM utilizando dos sesiones de cliente TSM simultneas. El programa de utilidad de copia de seguridad utilizar cuatro almacenamientos intermedios que son el tamao de almacenamiento intermedio por omisin (1024 x pginas 4 K).
db2 backup database sample use tsm open 2 sessions with 4 buffers
En el ejemplo siguiente, se realiza una copia de seguridad en cintas a nivel de espacio de tabla de los espacios de tabla (syscatspace, userspace1) de la base de datos payroll.
220
Command Reference
BACKUP DATABASE
db2 backup database payroll tablespace (syscatspace, userspace1) to /dev/rmt0, /dev/rmt1 with 8 buffers without prompting
A continuacin se proporciona un ejemplo de estrategia de copia de seguridad incremental semanal para una base de datos recuperable. Incluye una operacin de copia de seguridad de base de datos completa semanal, una operacin de copia de seguridad no acumulativa (delta) diaria y una operacin de copia de seguridad acumulativa (incremental) de mitad de semana:
(Dom) (Lun) (Mar) (Mi) (Jue) (Vie) (Sb) db2 db2 db2 db2 db2 db2 db2 backup backup backup backup backup backup backup db db db db db db db sample sample sample sample sample sample sample use tsm online incremental online incremental online incremental online incremental online incremental online incremental delta use delta use use tsm delta use delta use use tsm tsm tsm tsm tsm
Informacin relacionada: v Mandato RESTORE DATABASE en la pgina 636 v Mandato ROLLFORWARD DATABASE en la pgina 647
221
BIND Mandato BIND

Invoca el programa de utilidad de vinculacin, que prepara las sentencias de SQL almacenadas en el archivo de vinculacin generado por el precompilador y crea un paquete que se almacena en la base de datos. mbito: Este mandato puede emitirse desde cualquier particin de base de datos de db2nodes.cfg. Actualiza los catlogos de base de datos de la particin de base de datos de catlogo. Sus efectos son visibles en todas las particiones de base de datos. Autorizacin: Una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio BINDADD si no existe un paquete y una de las opciones siguientes: Autorizacin de IMPLICIT_SCHEMA en la base de datos si el nombre de esquema del paquete no existe Privilegio CREATEIN en el esquema si existe el nombre de esquema del paquete v Privilegio ALTERIN en el esquema si existe el paquete v Privilegio BIND en el paquete si ste existe. El usuario tambin necesita todos los privilegios necesarios para compilar las sentencias de SQL estticas en la aplicacin. Los privilegios otorgados a grupos no se utilizan para la comprobacin de autorizacin de las sentencias estticas. Si el usuario tiene autorizacin sysadm, pero no tiene privilegios explcitos para completar la vinculacin, el gestor de bases de datos otorga automticamente autorizacin dbadm explcita. Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato: Para DB2 para Windows y UNIX
BIND nombre-archivo
222
Command Reference
BIND
ACTION ADD REPLACE RETAIN NO YES REPLVER id-versin
BLOCKING
UNAMBIG ALL NO
CLIPKG
paquetes-cli
COLLECTION
nombre-esquema
DATETIME
DEF EUR ISO JIS LOC USA
DEGREE
1 grado-de-paralelismo ANY
DYNAMICRULES
RUN BIND INVOKERUN INVOKEBIND DEFINERUN DEFINEBIND
EXPLAIN
NO ALL YES
EXPLSNAP
NO ALL YES
FEDERATED
NO YES
, FUNCPATH nombre-esquema
GENERIC
serie
GRANT
idaut PUBLIC
GRANT_GROUP
nombre-grupo
GRANT_USER
nombre-usuario
INSERT
DEF BUF
ISOLATION
CS RR RS UR
MESSAGES
archivo-mensajes
OWNER
id-autorizacin
QUALIFIER
nombre-calificador
QUERYOPT
nivel-optimizacin
223
BIND
SQLERROR CHECK CONTINUE NOPACKAGE SQLWARN NO YES VALIDATE BIND RUN
TRANSFORM GROUP nombregrupo
Para DB2 en servidores que no sean Windows o UNIX

BIND nombre-archivo
ACTION
ADD REPLACE RETAIN NO YES REPLVER id-versin
BLOCKING
UNAMBIG ALL NO
CCSIDG
ccsid-doble
CCSIDM
ccsid-mixto
CCSIDS
ccsid-sbcs
CHARSUB
DEFAULT BIT MIXED SBCS
CLIPKG
paquetes-cli
CNULREQD
NO YES
COLLECTION
nombre-esquema
(1) DATETIME DEF EUR ISO JIS LOC USA
DBPROTOCOL
DRDA PRIVATE
DEC
15 31
DECDEL
COMMA PERIOD
(2) DEGREE 1 grado-de-paralelismo ANY
224
Command Reference
BIND
RUN BIND INVOKERUN INVOKEBIND DEFINERUN DEFINEBIND ENCODING ASCII EBCDIC UNICODE CCSID
DYNAMICRULES
(3) EXPLAIN NO YES
GENERIC
serie
GRANT
idaut PUBLIC
IMMEDWRITE
NO YES PH1
GRANT_GROUP
nombre-grupo
GRANT_USER
nombre-usuario
INSERT
BUF DEF
ISOLATION
CS NC RR RS UR
KEEPDYNAMIC
YES NO
MESSAGES
archivo-mensajes
OPTHINT
id-pista
OS400NAMING
SYSTEM SQL
OWNER
id-autorizacin
QUALIFIER
nombre-calificador
RELEASE
COMMIT DEALLOCATE
REOPT VARS
NOREOPT VARS
SORTSEQ
JOBRUN HEX
SQLERROR
CHECK CONTINUE NOPACKAGE
VALIDATE
BIND RUN
STRDEL
APOSTROPHE QUOTE
TEXT
etiqueta
225
BIND
Notas: 1 2 3 Si el servidor no da soporte a la opcin DATETIME DEF, se correlaciona con DATETIME ISO. La opcin DEGREE slo est soportada por servidores de aplicaciones DRDA Nivel 2. DRDA define la opcin EXPLAIN para que tenga el valor YES o NO. Si el servidor no da soporte a la opcin EXPLAIN YES, el valor se correlaciona con EXPLAIN ALL.
Parmetros del mandato: nombre-archivo Especifica el nombre del archivo de vinculacin que se ha generado al precompilar el programa de aplicacin o un archivo de lista que contiene los nombres de varios archivos de vinculacin. Los archivos de vinculacin tienen la extensin .bnd. Se puede especificar el nombre de va de acceso completo. Si se especifica un archivo de lista, el carcter @ debe ser el primer carcter del nombre de archivo de lista. El archivo de lista puede contener varias lneas de nombres de archivos de vinculacin. Los archivos de vinculacin listados en la misma lnea deben estar separados por el signo ms (+), pero un + no puede aparecer delante del primer archivo listado en cada lnea ni a continuacin del ltimo archivo de vinculacin listado. Por ejemplo,
/u/smith/sqllib/bnd/@all.lst
es un archivo de lista que contiene los archivos de vinculacin siguientes:

mybind1.bnd+mybind.bnd2+mybind3.bnd+ mybind4.bnd+mybind5.bnd+ mybind6.bnd+ mybind7.bnd
ACTION Indica si el paquete se puede aadir o sustituir. ADD Indica que el paquete mencionado no existe y que se debe crear un paquete nuevo. Si el paquete ya existe, se detiene la ejecucin y se devuelve un mensaje de error de diagnstico.
REPLACE Indica que el paquete existente ha de sustituirse por uno nuevo que tiene el mismo nombre de paquete y creador. Es el valor por omisin de la opcin ACTION. RETAIN Indica si se deben conservar las autorizaciones de
226
Command Reference
BIND
EXECUTE cuando se sustituye un paquete. Si cambia la propiedad del paquete, el nuevo propietario otorga la autorizacin BIND y EXECUTE al propietario anterior del paquete. NO No conserva las autorizaciones EXECUTE cuando se sustituye un paquete. Este valor no est soportado por DB2. Conserva las autorizaciones EXECUTE cuando se sustituye un paquete. Este es el valor por omisin.
YES
REPLVER id-versin Sustituye una versin especfica de un paquete. El identificador de versin especifica qu versin del paquete debe sustituirse. Si la versin especificada no existe, se devolver un error. Si no se especifica la opcin REPLVER de REPLACE y ya existe un paquete que coincide con el nombre de paquete, el creador y la versin del paquete que se est vinculando, dicho paquete debe ser sustituido; de lo contrario, se aadir un paquete nuevo. BLOCKING Para obtener informacin sobre el bloqueo de filas, consulte la publicacin Administration Guide o la publicacin Application Development Guide. ALL Especifica bloquear para: v Cursores de slo lectura v Cursores no especificados como FOR UPDATE OF Los cursores ambiguos se tratan como de slo lectura. NO Especifica no bloquear ningn cursor. Los cursores ambiguos se tratan como actualizables.
UNAMBIG Especifica bloquear para: v Cursores de slo lectura v Cursores no especificados como FOR UPDATE OF Los cursores ambiguos se tratan como actualizables. CCSIDG ccsid-doble Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de doble byte en las definiciones de columnas de caracteres (sin una clusula CCSID
227
BIND
especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CCSIDM ccsid-mixto Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de bytes mixtos en las definiciones de columnas de caracteres (sin una clusula CCSID especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CCSIDS ccsid-sbcs Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de un solo byte en las definiciones de columnas de caracteres (sin una clusula CCSID especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CHARSUB Designa el subtipo de carcter por omisin que se debe utilizar para las definiciones de columnas en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX. BIT Utiliza el subtipo de carcter FOR BIT DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito.
DEFAULT Utiliza el valor por omisin definido por el sistema de destino en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. MIXED Utiliza el subtipo de carcter FOR MIXED DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. SBCS Utiliza el subtipo de carcter FOR SBCS DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. CLIPKG paquetes-cli Un entero entre 3 y 30 que especifica el nmero de paquetes CLI grandes que se deben crear cuando se vinculen archivos de
228
Command Reference
BIND
vinculacin CLI con una base de datos. Para obtener ms informacin sobre los paquetes y los archivos de vinculacin CLI, consulte la publicacin CLI Guide and Reference. CNULREQD Esta opcin est relacionada con la opcin de precompilacin langlevel, que DRDA no soporta. Slo es vlida si el archivo de vinculacin se crea desde una aplicacin C o C++. DB2 no soporta esta opcin de vinculacin de DRDA para Windows y UNIX. NO La aplicacin se ha codificado en base a la opcin de precompilacin langlevel de SAA1 respecto al terminador nulo de las variables de sistema principal de serie C. La aplicacin se ha codificado en base a la opcin de precompilacin langlevel de MIA respecto al terminador nulo de las variables de sistema principal de serie C.
YES
COLLECTION nombre-esquema Especifica un identificador de coleccin de 30 caracteres para el paquete. Si no se especifica, se utilizar el identificador de autorizacin para el usuario que procesa el paquete. DATETIME Especifica el formato de fecha y hora que se debe utilizar. Para obtener ms informacin sobre los formatos de fecha y hora, consulte la publicacin Consulta de SQL. DEF EUR ISO Utiliza un formato de fecha y hora asociado al cdigo de territorio de la base de datos. Utiliza el estndar de IBM para el formato de fecha y hora europeo. Utiliza el formato de fecha y hora de la International Standards Organization (Organizacin internacional de estndares). Utiliza el formato de fecha y hora del Japanese Industrial Standard (Estndar industrial japons). Utiliza el formato de fecha y hora en la forma local asociada al cdigo de territorio de la base de datos. Utiliza el estndar de IBM para el formato de fecha y hora de EE.UU.
JIS LOC USA
DBPROTOCOL Especifica el protocolo que se va a utilizar al conectar con un sitio remoto identificado por una sentencia de nombre en tres partes. Slo
229
BIND
est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. DEC Especifica la precisin mxima que se debe utilizar en operaciones aritmticas decimales. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. 15 31 Se utiliza la precisin de 15 dgitos en las operaciones aritmticas decimales. Se utiliza la precisin de 31 dgitos en las operaciones aritmticas decimales.
DECDEL Indica si se utilizar un punto (.) o una coma (,) como indicador de coma decimal en los literales decimales y de coma flotante. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. COMMA Utilizar una coma (,) como indicador de coma decimal. PERIOD Utilizar un punto (.) como indicador de coma decimal. DEGREE Especifica el grado de paralelismo para la ejecucin de sentencias de SQL estticas en un sistema SMP. Esta opcin no afecta al paralelismo de CREATE INDEX. 1 La ejecucin de la sentencia no utilizar paralelismo.
grado-de-paralelismo Especifica el grado de paralelismo con el que se puede ejecutar la sentencia, un valor entre 2 y 32.767 (inclusive). ANY Especifica que la ejecucin de la sentencia puede incluir paralelismo utilizando un grado determinado por el gestor de bases de datos.
DYNAMICRULES Define qu normas se aplican al SQL dinmico en tiempo de ejecucin para el valor inicial de los valores utilizados para el ID de autorizacin y para la calificacin implcita de referencias de objetos no calificadas. RUN Especifica que se debe utilizar el ID de autorizacin del usuario que ejecuta el paquete para la comprobacin de
230
Command Reference
BIND
autorizacin de sentencias de SQL dinmico. El ID de autorizacin se utilizar tambin como calificador de paquetes por omisin para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico. Este es el valor por omisin. BIND Especifica que en tiempo de ejecucin deben utilizarse todas las normas que se aplican al SQL esttico para autorizacin y calificacin. Es decir, se debe utilizar el ID de autorizacin del propietario del paquete para la comprobacin de autorizacin de sentencias de SQL dinmicas y se debe utilizar el calificador de paquete por omisin para la calificacin implcita de referencias de objeto no calificadas dentro de las sentencias de SQL dinmicas. DEFINERUN Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin del definidor de rutina debe utilizarse para la comprobacin de autorizacin y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de la rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES RUN. DEFINEBIND Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin del definidor de rutina debe utilizarse para la comprobacin de autorizacin y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de la rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES BIND. INVOKERUN Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin de la sentencia actual en vigor al invocar la rutina debe utilizarse para la comprobacin de autorizacin de sentencias de SQL dinmico y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de esa rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES RUN.
231
BIND
INVOKEBIND Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin de la sentencia actual en vigor al invocar la rutina debe utilizarse para la comprobacin de autorizacin de sentencias de SQL dinmico y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de esa rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES BIND. Nota: Dado que las sentencias de SQL dinmico utilizarn el ID de autorizacin del propietario del paquete en un paquete que exhibe un comportamiento de vinculacin, no se debe otorgar al vinculador del paquete ninguna autorizacin que el usuario del paquete no deba recibir. De forma similar, al definir una rutina que exhiba un comportamiento de definicin, no se debe otorgar al definidor de la rutina ninguna autorizacin que el usuario del paquete no deba recibir, ya que una sentencia dinmica utilizar el ID de autorizacin del definidor de la rutina. Para obtener ms informacin acerca de los comportamientos de los paquetes, consulte la seccin relativa a cmo DYNAMICRULES afecta al comportamiento de las sentencias de SQL dinmico de la publicacin Application Development Guide. Las siguientes sentencias de SQL preparadas dinmicamente no se pueden utilizar dentro de un paquete que no se haya vinculado con DYNAMICRULES RUN: GRANT, REVOKE, ALTER, CREATE, DROP, COMMENT ON, RENAME, SET INTEGRITY y SET EVENT MONITOR STATE. ENCODING Especifica la codificacin para todas las variables de sistema principal en sentencias estticas del plan o del paquete. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. EXPLAIN Almacena informacin en las tablas de Explain acerca de los planes de acceso elegidos para cada sentencia de SQL del paquete. DRDA no soporta el valor ALL para esta opcin. NO YES La informacin de Explain no se capturar. Las tablas de Explain se llenarn con informacin acerca del plan de acceso elegido en tiempo de
232
Command Reference
BIND
precompilacin/vinculacin las sentencias estticas y en tiempo de ejecucin para las sentencias de vinculacin incremental. Si el paquete va a utilizarse para una rutina y el paquete contiene sentencias de vinculacin incremental, la rutina debe definirse como MODIFIES SQL DATA. Si esto no se hace as, las sentencias de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). ALL La informacin de Explain para cada sentencia de SQL esttica elegible se colocar en las tablas de Explain en tiempo de precompilacin/vinculacin. La informacin de Explain para cada sentencia de SQL de vinculacin incremental elegible se colocar en las tablas de Explain en tiempo de ejecucin. Adems, se reunir informacin de Explain para las sentencias de SQL dinmico elegibles en tiempo de ejecucin, auqneu el registro CURRENT EXPLAIN SNAPSHOT est establecido en NO. Para obtener ms informacin sobre los registros especiales, consulte el manual Consulta de SQL. Si el paquete ha de utilizarse para una rutina, sta debe definirse como MODIFIES SQL DATA, o las sentencias dinmicas y de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). Nota: DRDA no soporta este valor para EXPLAIN. EXPLSNAP Almacena informacin de Instantnea de Explain en las tablas de Explain. DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. NO YES No se capturar una Instantnea de Explain. Se colocar una Instantnea de Explain para cada sentencia de SQL esttica elegible en las tablas de Explain en tiempo de precompilacin/vinculacin para las sentencias estticas y en tiempo de ejecucin para las sentencias de vinculacin incremental. Si el paquete ha de utilizarse para una rutina y contiene sentencias de vinculacin incremental, la rutina debe definirse como MODIFIES SQL DATA, o las sentencias de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). ALL Se colocar una Instantnea de Explain para cada sentencia de SQL esttica elegible en las tablas de Explain en tiempo de precompilacin/vinculacin. La informacin de instantnea de
233
BIND
Explain para cada sentencia de SQL de vinculacin incremental elegible se colocar en las tablas de Explain en tiempo de ejecucin. Adems, se reunir informacin de Explain Snapshot para las sentencias de SQL dinmico elegibles en tiempo de ejecucin, aunque el registro CURRENT EXPLAIN SNAPSHOT est establecido en NO. Si el paquete ha de utilizarse para una rutina, sta debe definirse como MODIFIES SQL DATA, o las sentencias dinmicas y de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). Para obtener ms informacin acerca de los registros especiales, consulte la publicacin Consulta de SQL. FEDERATED Especifica si una sentencia de SQL esttica de un paquete hace referencia a un apodo o a una vista federada. Si no se especifica esta opcin y una sentencia de SQL esttica de un paquete hace referencia a un apodo o a una vista federada, se devuelve un aviso y se crea el paquete. Esta opcin no est soportada para DRDA. NO No se hace referencia a ningn apodo o vista federada en las sentencias de SQL estticas del paquete. Si se encuentra un apodo o una vista federada en una sentencia de SQL esttica durante la fase de preparacin o de vinculacin de este paquete, se devuelve un error y el paquete no se crea. Se puede hacer referencia a un apodo o a una vista federada en las sentencias de SQL estticas del paquete. Si no se encuentra ningn apodo ni ninguna vista federada en las sentencias de SQL estticas durante la preparacin o la vinculacin del paquete, no se devuelven errores ni avisos y el paquete se crea.
YES
FUNCPATH Especifica la va de acceso de funcin que se debe utilizar al resolver funciones y tipos diferenciados definidos por el usuario en SQL esttico. Si no se especifica esta opcin, la va de acceso de funcin por omisin es SYSIBM,SYSFUN,USER donde USER es el valor del registro especial USER. nombre-esquema Identificador de SQL, ordinario o delimitado, que identifica un esquema que existe en el servidor de aplicaciones. No se realiza ninguna validacin de que el esquema existe en el momento de la precompilacin o de la vinculacin. El mismo esquema no puede aparecer ms de una vez en la va de acceso de funcin. El nmero de esquemas que se puede
234
Command Reference
BIND
especificar est limitado por la longitud de la va de acceso de funcin resultante, que no puede exceder de 254 bytes. No es necesario especificar explcitamente el esquema SYSIBM; se supone implcitamente que es el primer esquema si no est incluido en la va de acceso de funcin. Para obtener ms informacin, consulte la publicacin Consulta de SQL. GENERIC serie Soporta la vinculacin de opciones nuevas que estn definidas en la base de datos de destino, pero que no estn soportadas por DRDA. No utilice esta opcin para pasar opciones de vinculaciones que estn definidas en BIND o PRECOMPILE. Esta opcin puede mejorar sustancialmente el rendimiento del SQL dinmico. La sintaxis es la siguiente:
generic "opcin1 valor1 opcin2 valor2 ..."
Cada opcin y valor debe estar separado por uno o ms espacios en blanco. Por ejemplo, si la base de datos DRDA de destino es DB2 Universal Database, Versin 8, se podra utilizar:
generic "explsnap all queryopt 3 federated yes"
para vincular cada una de las opciones EXPLSNAP, QUERYOPT y FEDERATED. La longitud mxima de la serie es de 1023 bytes. GRANT authid Otorga privilegios EXECUTE y BIND a un nombre de usuario o un ID de grupo especificado. PUBLIC Otorga privilegios EXECUTE y BIND a PUBLIC. GRANT_GROUP nombre-grupo Otorga privilegios EXECUTE y BIND a un ID de grupo especificado. GRANT_USER nombre-usuario Otorga privilegios EXECUTE y BIND a un nombre de usuario especificado. INSERT Permite a un programa que se est precompilando o vinculando en un servidor DB2 Enterprise - Extended Edition solicitar que las inserciones de datos se pongan en el almacenamiento intermedio para aumentar el rendimiento. Esta opcin no est soportada en DRDA. BUF Especifica que las inserciones de una aplicacin deben ponerse en el almacenamiento intermedio.
235
BIND
DEF Especifica que las inserciones de una aplicacin no deben ponerse en el almacenamiento intermedio.
ISOLATION Determina hasta qu punto un programa vinculado a este paquete puede aislarse del efecto de otros programas en ejecucin. Para obtener ms informacin acerca de los niveles de aislamiento, consulte la publicacin Consulta de SQL. CS NC Especifica estabilidad de cursor como nivel de aislamiento. Ningn compromiso. Especifica que no se debe utilizar el control de compromiso. Este nivel de aislamiento no est soportado por DB2 para Windows y UNIX. Especifica lectura repetible como nivel de aislamiento. Especifica estabilidad de lectura como nivel de aislamiento. La estabilidad de lectura asegura que la ejecucin de las sentencias de SQL del paquete est aislada de otros procesos de aplicacin para filas ledas y cambiadas por la aplicacin. Especifica lectura no comprometida como nivel de aislamiento.
RR RS
UR
IMMEDWRITE Indica si se realizarn grabaciones inmediatas para las actualizaciones efectuadas para agrupar conjuntos de pginas o particiones dependientes de agrupaciones de almacenamientos intermedios. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. KEEPDYNAMIC Especifica si las sentencias de SQL dinmico han de conservarse despus de los puntos de compromiso. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. MESSAGES archivo-mensajes Especifica el destino para los mensajes de aviso, de error y de estado de realizacin. Se crea un archivo de mensajes tanto si la vinculacin es satisfactoria como si no lo es. Si no se especifica un nombre de archivo de mensajes, los mensajes se graban en la salida estndar. Si no se especifica la va de acceso completa al archivo, se utiliza el directorio actual. Si se especifica el nombre de un archivo existente, se graba encima del contenido del archivo. OPTHINT Controla si se utilizan pistas de optimizacin de consultas para SQL
236
Command Reference
BIND
esttico. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. OS400NAMING Especifica cul es la opcin de denominacin que ha de utilizarse al acceder a datos de DB2 UDB para iSeries. Slo est soportado por DB2 UDB para iSeries. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para iSeries. Tenga en cuenta que, a causa de que las barras inclinadas se utilizan como separadores, un programa de utilidad DB2 puede informar de un error de sintaxis en tiempo de ejecucin para ciertas sentencias de SQL que utilizan el convenio de denominacin de iSeries, aunque el programa de utilidad se pueda haber precompilado o vinculado con la opcin OS400NAMING SYSTEM. Por ejemplo, el Procesador de lnea de mandatos informar de un error de sintaxis en una sentencia CALL de SQL si se utiliza el convenio de denominacin de iSeries, tanto si se ha precompilado o vinculado utilizando la opcin OS400NAMING SYSTEM como si no. OWNER id-autorizacin Designa un identificador de autorizacin de 30 caracteres para el propietario del paquete. El propietario debe tener los privilegios necesarios para ejecutar las sentencias de SQL contenidas en el paquete. Slo un usuario con autorizacin SYSADM o DBADM puede especificar un identificador de autorizacin distinto del ID de usuario. El valor por omisin es el ID de autorizacin primario del proceso de precompilacin/vinculacin. SYSIBM, SYSCAT y SYSSTAT no son valores vlidos para esta opcin. QUALIFIER nombre-calificador Proporciona un calificador implcito de 30 caracteres para los objetos no calificados contenidos en el paquete. El valor por omisin es el ID de autorizacin del propietario, tanto si se ha especificado explcitamente owner como si no se ha especificado. QUERYOPT nivel-optimizacin Indica el nivel deseado de optimizacin para todas las sentencias de SQL estticas contenidas en el paquete. El valor por omisin es 5. Para ver el rango completo de niveles de optimizacin disponibles, vea la sentencia SET CURRENT QUERY OPTIMIZATION en la publicacin Consulta de SQL. DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. RELEASE Indica si se liberan recursos en cada punto COMMIT o cuando termina la aplicacin. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX.
237
BIND
COMMIT Libera recursos en cada punto COMMIT. Se utiliza para sentencias de SQL dinmicas. DEALLOCATE Slo libera recursos cuando termina la aplicacin. SORTSEQ Especifica cul es la tabla de secuencias de clasificacin que se ha de utilizar en el sistema iSeries. Slo est soportado por DB2 UDB para iSeries. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para iSeries. SQLERROR Indica si se debe crear un paquete o un archivo de vinculacin en el caso de que se encuentre un error. CHECK Especifica que el sistema de destino realiza todas las comprobaciones de sintaxis y de semntica en las sentencias de SQL que se estn vinculando. No se crear un paquete como parte de este proceso. Si, mientras se est realizando la vinculacin, se encuentra un paquete existente con el mismo nombre y la misma versin, el paquete existente no se elimina ni se sustituye aunque se haya especificado action replace. CONTINUE Crea un paquete, incluso si se producen errores al vincular las sentencias de SQL. Aquellas sentencias que no se han podido vincular por razones de autorizacin o existencia pueden vincularse de forma incremental en el tiempo de ejecucin si se especifica tambin VALIDATE RUN. Cualquier intento de ejecutarlas en la ejecucin genera un error (SQLCODE -525, SQLSTATE 51015). NOPACKAGE No se crea un paquete o un archivo de vinculacin si se encuentra un error. REOPT / NOREOPT VARS Especifica si DB2 ha de determinar una va de acceso en tiempo de ejecucin utilizando valores para variables de sistema principal, marcadores de parmetro y registros especiales. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. SQLWARN Indica si se devolvern avisos de la compilacin de las sentencias de SQL dinmicas (a travs de PREPARE o EXECUTE IMMEDIATE) o del proceso de descripcin (a travs de PREPARE...INTO o
238
Command Reference
BIND
DESCRIBE). DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. NO YES No se devolvern avisos del compilador de SQL. Se devolvern avisos del compilador de SQL.
Nota: SQLCODE +238 es una excepcin. Se devuelve independientemente del valor de la opcin sqlwarn. STRDEL Indica si se utilizar un apstrofo () o comillas (") como delimitador de serie en las sentencias de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. APOSTROPHE Utilizar un apstrofo () como delimitador de serie. QUOTE Utilizar comillas (") como delimitador de serie. TEXT etiqueta Descripcin de un paquete. La longitud mxima es de 255 caracteres. El valor por omisin son espacios en blanco. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA para Windows y UNIX. TRANSFORM GROUP Especifica el nombre de grupo de transformaciones que debern utilizar las sentencias de SQL estticas para intercambiar valores de tipo estructurado definidos por el usuario con programas de sistema principal. Este grupo de transformaciones no se utiliza para las sentencias de SQL dinmicas o para el intercambio de parmetros y resultados con funciones o mtodos externos. DRDA no soporta esta opcin. nombregrupo Identificador de SQL de una longitud mxima de 18 caracteres. Un nombre de grupo no puede incluir un prefijo de calificador y no puede empezar con el prefijo SYS, dado que ste est reservado para uso de la base de datos. En una sentencia de SQL esttica que interacte con variables de sistema principal, el nombre de grupo de transformaciones a utilizar para intercambiar valores de un tipo estructurado es el siguiente: v El nombre de grupo de la opcin de vinculacin TRANSFORM GROUP, si existe
239
BIND
v El nombre de grupo de la opcin de precompilacin TRANSFORM GROUP que se ha especificado en el tiempo de precompilacin original, si existe v El grupo DB2_PROGRAM, si existe una transformacin para el tipo proporcionado cuyo nombre de grupo es DB2_PROGRAM v No se utiliza ningn grupo de transformaciones si no existe ninguna de las condiciones anteriores. Son posibles los errores siguientes durante la vinculacin de una sentencia de SQL esttica: v SQLCODE yyyyy, SQLSTATE xxxxx: se necesita una transformacin, pero no se ha seleccionado ningn grupo de transformacin esttico. v SQLCODE yyyyy, SQLSTATE xxxxx: el grupo de transformaciones seleccionado no incluye una transformacin necesaria (TO SQL para variables de entrada, FROM SQL para variables de salida) para el tipo de datos que se tiene que intercambiar. v SQLCODE yyyyy, SQLSTATE xxxxx: el tipo de resultado de la transformacin FROM SQL no es compatible con el tipo de la variable de salida o el tipo de parmetro de la transformacin TO SQL no es compatible con el tipo de la variable de entrada. En estos mensajes de error, yyyyy se sustituye por el cdigo de error de SQL y xxxxx por el cdigo de estado de SQL. VALIDATE Determina cundo el gestor de bases de datos comprueba los errores de autorizacin y los errores de objeto no encontrado. Se utiliza el ID de autorizacin del propietario del paquete para la comprobacin de validez. BIND La validacin se realiza en el tiempo de precompilacin/vinculacin. Si no existen todos los objetos o no se posee toda la autorizacin, se producen mensajes de error. Si se especifica sqlerror continue, se produce un archivo de vinculacin/paquete a pesar del mensaje de error, pero las sentencias errneas no son ejecutables. RUN Se intenta la validacin en el tiempo de vinculacin. Si existen todos los objetos y se posee toda la autorizacin, no se realiza ninguna comprobacin adicional en el tiempo de ejecucin. Si no existen todos los objetos o no se posee toda la autorizacin en el tiempo de precompilacin/vinculacin, se
240
Command Reference
BIND
producen mensajes de aviso y el paquete se vincula satisfactoriamente, independientemente del valor de la opcin sqlerror continue. Sin embargo, en el tiempo de ejecucin se puede volver a realizar la comprobacin de autorizacin y la comprobacin de existencia para las sentencias de SQL que han fallado dichas comprobaciones durante el proceso de precompilacin/vinculacin. Ejemplos: El ejemplo siguiente vincula miapl.bnd (el archivo de vinculacin generado al precompilar el programa miapl.sqc) con la base de datos con la que se ha establecido una conexin:
db2 bind miapl.bnd
Los mensajes resultantes del proceso de vinculacin se envan a la salida estndar. Notas de uso: La vinculacin puede realizarse como parte del proceso de precompilacin para un archivo fuente de programa de aplicacin o posteriormente como un paso independiente. Utilice BIND cuando la vinculacin se realice como un proceso independiente. El nombre utilizado para crear el paquete se almacena en el archivo de vinculacin y se basa en el nombre del archivo fuente a partir del cual se ha generado (se eliminan las vas de acceso o las extensiones existentes). Por ejemplo, un archivo fuente precompilado llamado miapl.sql genera un archivo de vinculacin por omisin llamado miapl.bnd y un nombre de paquete por omisin MIAPL. Sin embargo, el nombre de archivo de vinculacin y el nombre de paquete pueden alterarse temporalmente durante la precompilacin, utilizando las opciones bindfile y package. La vinculacin de un paquete con un nombre de esquema que an no existe produce la creacin implcita de dicho esquema. El propietario del esquema es SYSIBM. El privilegio CREATEIN del esquema se otorga a PUBLIC. BIND se ejecuta bajo la transaccin que se ha iniciado. Despus de efectuar la vinculacin, BIND emite un COMMIT o un ROLLBACK para terminar la transaccin actual e iniciar otra. La vinculacin se detiene si se produce un error muy grave o se producen ms de 100 errores. Si se produce un error muy grave, el programa de utilidad deja de vincular, intenta cerrar todos los archivos y elimina el paquete.
241
BIND
Cuando un paquete exhibe un comportamiento de vinculacin, lo siguiente puede ser verdadero: 1. El valor implcito o explcito de la opcin OWNER de BIND se utilizar para realizar la comprobacin de autorizacin de las sentencias de SQL dinmico. 2. El valor implcito o explcito de la opcin QUALIFIER de BIND se utilizar como calificador implcito para realizar la calificacin de objetos no calificados en las sentencias de SQL dinmico. 3. El valor del registro especial CURRENT SCHEMA no tiene ningn efecto sobre la calificacin. En caso de que se haga referencia a varios paquetes durante una sola conexin, todas las sentencias de SQL dinmico preparadas por esos paquetes exhibirn el comportamiento que aparece especificado en la opcin DYNAMICRULES para ese paquete especfico y el entorno en el que se utilicen. Los parmetros visualizados en el mensaje SQL0020W estn anotados correctamente como errores y se pasarn por alto tal como indica el mensaje. Los parmetros visualizados en el mensaje SQL0020W estn anotados correctamente como errores y se pasarn por alto tal como indica el mensaje. La vinculacin de programas de aplicacin tiene requisitos previos y restricciones que estn fuera del mbito de este manual. Para obtener informacin ms detallada acerca de la vinculacin de programas de aplicacin a bases de datos, consulte la publicacin Application Development Guide. Si se encuentra que una sentencia de SQL es errnea y se ha especificado la opcin SQLERROR CONTINUE de BIND, se marcar la sentencia como no vlida. Para cambiar el estado de la sentencia de SQL, se deber emitir otro BIND. La revinculacin implcita o explcita no cambiar el estado de una sentencia no vlida. En un paquete vinculado con VALIDATE RUN, una sentencia puede cambiar de esttica a vinculacin incremental o de vinculacin incremental a esttica a travs de revinculaciones implcitas y explcitas, en funcin de si existen o no problemas de autorizacin o de existencia de objeto durante la revinculacin.
242
Command Reference
BIND
Vea tambin: Mandato PRECOMPILE en la pgina 537. Conceptos relacionados: v Consideraciones sobre autorizacin para SQL dinmico del manual Gua de desarrollo de aplicaciones: Programacin de aplicaciones de cliente v Efectos de DYNAMICRULES en SQL dinmico del manual Gua de desarrollo de aplicaciones: Programacin de aplicaciones de cliente Informacin relacionada: v Mandato PRECOMPILE en la pgina 537
243
CATALOG APPC NODE Mandato CATALOG APPC NODE

Aade una entrada de nodo APPC al directorio de nodos. Para acceder al nodo remoto se utiliza el Advanced Program-to-Program Communications Protocol (APPC). Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG ADMIN PROGRAM NONE SAME APPC NODE nombrenodo REMOTE nombre-destino-simblico
SECURITY
REMOTE_INSTANCE nombre-instancia
SYSTEM nombre-sistema WITH serie-comentario
OSTYPE tipo-sistema-operativo
Parmetros del mandato: ADMIN Especifica nodos de servidor de administracin. NODE nombrenodo Alias local para el nodo que se debe catalogar. Es un nombre arbitrario en la estacin de trabajo del usuario, que se utiliza para identificar el nodo. Debe ser un nombre significativo para que sea fcil de recordar. El nombre debe adaptarse a los convenios de denominacin del gestor de bases de datos. REMOTE nombre-destino-simblico Especifica el nombre de destino simblico del nodo remoto asociado. El nombre corresponde a una entrada de la tabla de informacin complementaria de CPI Communications que contiene la informacin necesaria para que el cliente establezca una conexin APPC con el
244
Command Reference
CATALOG APPC NODE

servidor (nombre de LU asociada, nombre de modalidad, nombre de TP asociado). La longitud mxima es de 8 caracteres. SECURITY Especifica hasta qu punto se debe utilizar la informacin de seguridad en la peticin de asignacin enviada a la LU asociada. Los valores vlidos son: PROGRAM Especifica que se deben incluir un nombre de usuario y una contrasea en la peticin de asignacin enviada a la LU asociada. ste es el valor por omisin. NONE Especifica que no se debe incluir ninguna informacin de seguridad en la peticin de asignacin enviada a la LU asociada. SAME Especifica que se debe incluir un nombre de usuario en la peticin de asignacin enviada a la LU asociada, junto con un indicador de que el nombre de usuario ya se ha verificado. El asociado debe estar configurado para aceptar seguridad que ya se ha verificado. Nota: Para conexiones que utilizan APPC en un servidor DB2 para Windows NT Versin 7.1 (o posterior), slo se soporta un ID de usuario de ms de 8 bytes de longitud cuando se especifica NONE para SECURITY. REMOTE_INSTANCE nombre-instancia Especifica el nombre real de la instancia con la que se est realizando una conexin en la mquina servidor remota. SYSTEM nombre-sistema Especifica un nombre que se utiliza para identificar la mquina servidor. OSTYPE tipo-sistema-operativo Especifica el tipo de sistema operativo de la mquina servidor. Los valores vlidos son: AIX, WIN, HPUX, SUN, OS400, OS390, VM, VSE, SNI, SCO y LINUX. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles.
245
CATALOG APPC NODE

Ejemplos:
db2 catalog appc node db2appc1 remote db2inst1 security program with "Un nodo APPC remoto"
Notas de uso: El gestor de bases de datos crea el directorio de nodos cuando se cataloga el primer nodo (es decir, cuando se emite el primer mandato CATALOG...NODE). En un cliente Windows, almacena y mantiene el directorio de nodos en el subdirectorio de instancias donde est instalado el cliente. En un cliente AIX, crea el directorio de nodos en el directorio de instalacin de DB2. Liste el contenido del directorio de nodo local utilizando el mandato LIST NODE DIRECTORY. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST NODE DIRECTORY en la pgina 465 v Mandato TERMINATE en la pgina 691
246
Command Reference
CATALOG APPN NODE Mandato CATALOG APPN NODE

Graba en el directorio de nodos informacin acerca de una estacin de trabajo remota que utiliza APPN como protocolo de comunicaciones. DB2 utiliza esta informacin para establecer la conexin entre una aplicacin y una base de datos remota catalogada en este nodo. Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: sysadm Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG APPN NODE nombrenodo NETWORK id-red REMOTE lu-asociada
LOCAL
lu-local
TPNAME
nombre-tp
MODE
modalidad
SECURITY
PROGRAM NONE SAME
LANADDRESS
direccin-adaptador-lan
CHGPWDLU
lu_cambio_contrasea
WITH
serie-comentario
Parmetros del mandato: NODE nombrenodo Especifica el nombre de la estacin de trabajo remota a catalogar. Es el mismo nombre que se ha entrado para el parmetro de nombre de nodo al catalogar una base de datos que reside en dicha estacin de trabajo (utilizando el mandato CATALOG DATABASE). El nombre debe ajustarse a los convenios de denominacin de DB2. NETWORK id-red Especifica el ID de la red SNA donde reside la LU remota. Este ID de red es una serie de uno a ocho caracteres que sigue los convenios de denominacin de SNA. REMOTE lu-asociada Especifica la unidad lgica asociada SNA utilizada para la conexin. Entre el nombre de LU del nodo remoto. El nombre debe entrarse
247
CATALOG APPN NODE

exactamente como aparece (utilizando caracteres en maysculas y minsculas combinadas) en la definicin SNA correspondiente (de la configuracin del Communication Manager). El nombre debe adaptarse a los convenios de denominacin de SNA. LOCAL lu-local Especifica el alias de la unidad lgica local SNA utilizada para la conexin. Debe ser una serie que contenga de 1 a 8 caracteres que no sean espacios en blanco. El alias debe entrarse exactamente como aparece (utilizando caracteres en maysculas y minsculas combinadas) en la definicin SNA correspondiente (de la configuracin del Communication Manager). TPNAME nombre-tp Especifica el nombre de programa de transaccin APPC del servidor de bases de datos. El valor por omisin es DB2DRDA. MODE modalidad Especifica la modalidad de transmisin SNA utilizada para la conexin. El nombre debe ajustarse a los convenios de denominacin de SNA. Si no se entra un valor, DB2 almacena una serie de caracteres de ocho espacios en blanco como tipo de modalidad. SECURITY Especifica hasta qu punto se debe utilizar la informacin de seguridad en la peticin de asignacin enviada a la LU asociada. Los valores vlidos son: PROGRAM Especifica que se deben incluir un nombre de usuario y una contrasea en la peticin de asignacin enviada a la LU asociada. ste es el valor por omisin. NONE Especifica que no se debe incluir ninguna informacin de seguridad en la peticin de asignacin enviada a la LU asociada. SAME Especifica que se debe incluir un nombre de usuario en la peticin de asignacin enviada a la LU asociada, junto con un indicador de que el nombre de usuario ya se ha verificado. El asociado debe estar configurado para aceptar seguridad que ya se ha verificado. Nota: Para conexiones que utilizan APPN en un servidor DB2 para Windows NT Versin 7.1 (o posterior), slo se soporta un ID de usuario de ms de 8 bytes de longitud cuando se especifica NONE para SECURITY.
248
Command Reference
CATALOG APPN NODE

LANADDRESS direccin-adaptador-lan Direccin del adaptador de LAN del servidor DB2. CHGPWDLU lu_cambio_contrasea Especifica el nombre de la LU asociada que se debe utilizar al cambiar la contrasea para un servidor de bases de datos de sistema principal. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles. Ejemplos: El ejemplo siguiente cataloga un nodo APPN:
db2 catalog appn node nodorem remote rlu with "Catalogar APPN NODE"
Informacin relacionada: v Mandato CATALOG DATABASE en la pgina 250 v Mandato ATTACH en la pgina 211
249
CATALOG DATABASE Mandato CATALOG DATABASE

Almacena informacin de ubicacin de base de datos en el directorio de bases de datos del sistema. La base de datos puede estar ubicada en la estacin de trabajo local o en un nodo remoto. mbito: En un entorno de bases de datos particionado, cuando se cataloga una base de datos local en el directorio de bases de datos del sistema, este mandato debe emitirse desde una particin de base de datos del servidor donde reside la base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
CATALOG DATABASE DB nombre-base-datos AS alias
ON
vaacceso unidad AT NODE nombrenodo
AUTHENTICATION
SERVER CLIENT SERVER_ENCRYPT KERBEROS TARGET PRINCIPAL nombreprincipal
WITH
serie-comentario
Parmetros del mandato: DATABASE nombre-base-datos Especifica el nombre de la base de datos a catalogar. AS alias Especifica un alias como nombre alternativo para la base de datos que
250
Command Reference
CATALOG DATABASE
se est catalogando. Si no se especifica un alias, el gestor de bases de datos utiliza nombre-base-datos como alias. ON vaacceso/unidad En sistemas basados en UNIX, especifica la va de acceso en la que reside la base de datos que se est catalogando. En los sistemas operativos Windows, especifica la letra de la unidad en la que reside la base de datos que se est catalogando. AT NODE nombrenodo Especifica el nombre del nodo donde reside la base de datos que se est catalogando. Este nombre debe coincidir con el nombre de una entrada del directorio de nodos. Si el nombre de nodo especificado no existe en el directorio de nodos, se devuelve un aviso, pero la base de datos se cataloga en el directorio de bases de datos del sistema. El nombre de nodo debe estar catalogado en el directorio de nodos si se desea una conexin con la base de datos catalogada. AUTHENTICATION El valor de autentificacin se almacena para las bases de datos remotas (aparece en la salida del mandato LIST DATABASE DIRECTORY) pero no se almacena para las bases de datos locales. La especificacin de un tipo de autentificacin puede producir un beneficio en el rendimiento. SERVER Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino. CLIENT Especifica que la autentificacin tiene lugar en el nodo donde se invoca la aplicacin. SERVER_ENCRYPT Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino y que las contraseas se cifran en el origen. Las contraseas se descifran en el destino, como lo especifica el tipo de autentificacin catalogado en el origen. KERBEROS Especifica que la autentificacin tienen lugar utilizando el Kerberos Security Mechanism (mecanismo de seguridad Kerberos). Cuando la autentificacin es Kerberos y se utiliza una conexin APPC para el acceso, slo se soporta SECURITY=NONE. TARGET PRINCIPAL nombreprincipal Nombre principal Kerberos totalmente calificado para
251
CATALOG DATABASE
el servidor de destino; es decir, la cuenta de conexin del servicio de servidor DB2 con el formato de idusuario@xxx.xxx.xxx.com o dominio\idusuario. Nota: El tipo de autentificacin de Kerberos slo est soportado en clientes y servidores que se ejecuten en sistemas operativos Windows 2000, Windows XP y Windows .NET. Adems, tanto la mquina cliente como la mquina servidor deben pertenecer al mismo dominio de Windows o a dominios fiables. WITH serie-comentario Describe la base de datos o la entrada de base de datos del directorio de bases de datos del sistema. La longitud mxima de una serie de comentario es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. Ejemplos:
db2 catalog database sample on /databases/sample with "Base de datos de ejemplo"
Notas de uso: Utilice CATALOG DATABASE para catalogar bases de datos ubicadas en nodos locales o remotos, volver a catalogar bases de datos que se han descatalogado anteriormente o mantener mltiples alias para una base de datos (independientemente de la ubicacin de la base de datos). DB2 cataloga las bases de datos automticamente cuando stas se crean. Cataloga una entrada para la base de datos en el directorio de bases de datos locales y otra entrada en el directorio de bases de datos del sistema. Si la base de datos se crea desde un cliente remoto (o un cliente que se est ejecutando desde una instancia diferente en la misma mquina), tambin se realiza una entrada en el directorio de bases de datos del sistema en la instancia del cliente. Si no se especifica la va de acceso ni el nombre de nodo, se supone que la base de datos es local y se supone que la ubicacin de la base de datos es la especificada en el parmetro de configuracin dftdbpath del gestor de bases de datos. Las bases de datos del mismo nodo que la instancia del gestor de bases de datos se catalogan como entradas indirectas. Las bases de datos de otros nodos se catalogan como entradas remotas.
252
Command Reference
CATALOG DATABASE
CATALOG DATABASE crea automticamente un directorio de bases de datos del sistema si no existe ninguno. El directorio de bases de datos del sistema se almacena en la va de acceso que contiene la instancia de gestor de bases de datos que se est utilizando y se mantiene fuera de la base de datos. Liste el contenido del directorio de bases de datos del sistema utilizando el mandato LIST DATABASE DIRECTORY. Para listar el contenido del directorio de base de datos local, utilice LIST DATABASE DIRECTORY ON /VA_ACCESO, donde VA_ACCESO es donde se ha creado la base de datos. Nota: Si la colocacin en antememoria de directorios est habilitada, los archivos de directorios de bases de datos y nodos se almacenarn en la antememoria. La antememoria de directorios de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela.
253
CATALOG DATABASE
Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST DATABASE DIRECTORY en la pgina 440 v Mandato TERMINATE en la pgina 691 v Mandato UNCATALOG DATABASE en la pgina 692
254
Command Reference
CATALOG DCS DATABASE Mandato CATALOG DCS DATABASE

Almacena informacin acerca del sistema principal remoto o de las bases de datos de iSeries en el directorio de Servicios de conexin de bases de datos (DCS). A estas bases de datos se accede mediante un Peticionario de aplicaciones (AR), por ejemplo DB2 Connect. Al tener una entrada de directorio DCS con un nombre de base de datos que coincide con un nombre de base de datos del directorio de bases de datos del sistema, se invoca el AR especificado para reenviar las peticiones SQL al servidor remoto donde reside la base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG DCS DATABASE DB nombre-base-datos AS nombre-base-datos-destino
AR
nombre-biblioteca
PARMS
serie-parmetros
WITH
serie-comentario
Parmetros del mandato: DATABASE nombre-base-datos Especifica el alias de la base de datos de destino a catalogar. Este nombre debe coincidir con el nombre de una entrada del directorio de bases de datos que est asociado al nodo remoto. AS nombre-base-datos-destino Especifica el nombre del sistema principal de destino o de la base de datos de iSeries a catalogar. AR nombre-biblioteca Especifica el nombre de la biblioteca de Peticionario de aplicaciones que se carga y se utiliza para acceder a una base de datos remota listada en el directorio DCS.
255
CATALOG DCS DATABASE

Nota: Si utiliza el AR de DB2 Connect, no especifique un nombre de biblioteca. El valor por omisin har que se invoque DB2 Connect. Si no utiliza DB2 Connect, especifique el nombre de biblioteca del AR, y coloque dicha biblioteca en la misma va de acceso que las bibliotecas del gestor de bases de datos. En los sistemas operativos Windows, la va de acceso es unidad:\sqllib\bin. En sistemas basados en UNIX, la va de acceso es $HOME/sqllib/lib del propietario de la instancia. PARMS serie-parmetros Especifica una serie de parmetros que se debe pasar al AR cuando ste se invoca. La serie de parmetros debe escribirse entre comillas dobles. WITH serie-comentario Describe la entrada del directorio DCS. Se puede entrar cualquier comentario que ayude a describir la base de datos catalogada en este directorio. La longitud mxima es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. Ejemplos: El ejemplo siguiente cataloga informacin acerca de la base de datos DB1, que es una base de datos DB2 para z/OS, en el directorio DCS:
db2 catalog dcs database db1 as dsn_db_1 with "DB2/z/OS location name DSN_DB_1"
Notas de uso: El programa DB2 Connect proporciona conexiones a los Servidores de aplicaciones DRDA tales como: v Bases de datos DB2 para OS/390 o z/OS en sistemas principales de arquitectura System/370 y System/390. v Bases de datos DB2 para VM y VSE en sistemas principales de arquitectura System/370 y System/390. v Bases de datos iSeries en sistemas Application System/400 (AS/400) y iSeries. El gestor de bases de datos crea un directorio de Servicios de conexin de bases de datos si no existe ninguno. Este directorio se almacena en la va de acceso que contiene la instancia de gestor de bases de datos que se est utilizando. El directorio DCS se mantiene fuera de la base de datos.
256
Command Reference
CATALOG DCS DATABASE

La base de datos tambin debe catalogarse como una base de datos remota en el directorio de bases de datos del sistema. Liste el contenido del directorio de DCS utilizando el mandato LIST DCS DIRECTORY. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato TERMINATE en la pgina 691 v Mandato UNCATALOG DCS DATABASE en la pgina 694 v Mandato LIST DCS DIRECTORY en la pgina 453
257
CATALOG LDAP DATABASE Mandato CATALOG LDAP DATABASE

Se utiliza para registrar la base de datos en el LDAP (Lightweight Directory Access Protocol). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG LDAP DATABASE DB nombre-base-datos AS alias
AT NODE
nombrenodo
GWNODE
nodo-pasarela
PARMS
serie-parmetros
AR
nombre-biblioteca
AUTHENTICATION
CLIENT SERVER SERVER_ENCRYPT DCS_ENCRYPT DCS KERBEROS TARGET PRINCIPAL nombreprincipal
WITH
comentarios
USER
nombreusuario PASSWORD contrasea
Parmetros del mandato: DATABASE nombre-base-datos Especifica el nombre de la base de datos a catalogar. AS alias Especifica un alias como nombre alternativo para la base de datos que se est catalogando. Si no se especifica un alias, se utiliza el nombre de base de datos como alias. AT NODE nombrenodo Especifica el nombre de nodo LDAP para el servidor de bases de
258
Command Reference
CATALOG LDAP DATABASE

datos en el que reside la base de datos. Este parmetro debe especificarse al registrar una base de datos en un servidor remoto. GWNODE nodo-pasarela Especifica el nombre de nodo LDAP para el servidor de pasarela. PARMS serie-parmetros Especifica una serie de parmetros que se pasa al Peticionario de aplicaciones (AR) al acceder a bases de datos DCS. Nota: El nombre_dest_simb de cambio de contrasea no se deber especificar en la serie de parmetros. Utilice la palabra clave CHGPWDLU para especificar el nombre de LU de cambio de contrasea al registrar el servidor DB2 en LDAP. AR nombre-biblioteca Especifica el nombre de la biblioteca de Peticionario de aplicaciones que se carga y se utiliza para acceder a una base de datos remota listada en el directorio DCS. Nota: Si utiliza el AR de DB2 Connect, no especifique un nombre de biblioteca. El valor por omisin har que se invoque DB2 Connect. Si no utiliza DB2 Connect, especifique el nombre de biblioteca del AR, y coloque dicha biblioteca en la misma va de acceso que las bibliotecas del gestor de bases de datos. En los sistemas operativos Windows, la va de acceso es unidad:\sqllib\dll. En los sistemas basados en UNIX, la va de acceso es $HOME/sqllib/lib del propietario de la instancia. AUTHENTICATION Especifica el nivel de autentificacin. Los valores vlidos son: CLIENT Especifica que la autentificacin tiene lugar en el nodo desde el que se invoca la aplicacin. SERVER Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino. SERVER_ENCRYPT Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino y que las contraseas se cifran en el origen. Las contraseas se descifran en el destino, como lo especifica el tipo de autentificacin catalogado en el origen.
259

DCS_ENCRYPT Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino, excepto cuando se utiliza DB2 Connect; en ese caso, la autentificacin tiene lugar en el servidor de aplicaciones (AS) DRDA. Las contraseas se cifran en el origen y se descifran en el destino, como lo especifica el tipo de autentificacin catalogado en el origen. DCS Especifica que la autentificacin tiene lugar en el nodo que contiene la base de datos de destino, excepto cuando se utiliza DB2 Connect; en ese caso, la autentificacin tiene lugar en el servidor de aplicaciones (AS) DRDA.
KERBEROS Especifica que la autentificacin tienen lugar utilizando el Mecanismo de seguridad Kerberos. Cuando la autentificacin es Kerberos y se utiliza una conexin APPC para el acceso, slo se soporta SECURITY=NONE. TARGET PRINCIPAL nombreprincipal Nombre principal Kerberos totalmente calificado para el servidor de destino; es decir, la cuenta de conexin del servicio de servidor DB2 con el formato de idusuario@xxx.xxx.xxx.com o dominio\idusuario. Nota: Este parmetro slo es vlido en clientes Windows 2000. WITH comentarios Describe el servidor DB2. Se puede entrar cualquier comentario que ayude a describir el servidor registrado en el directorio de red. La longitud mxima es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. USER nombreusuario Especifica el nombre distinguido (DN) LDAP del usuario. El nombre DN LDAP de usuario debe tener suficiente autorizacin para crear el objeto en el directorio LDAP. Si no se especifica el nombre DN LDAP del usuario, se utilizarn las credenciales del usuario de conexin actual. Nota: Si el DN LDAP y la contrasea del usuario se han especificado utilizando db2ldcfg, no se tienen que especificar aqu el nombre de usuario y la contrasea. PASSWORD contrasea Contrasea de cuenta.
260
Command Reference

Nota: Si el DN LDAP y la contrasea del usuario se han especificado utilizando db2ldcfg, no se tienen que especificar aqu el nombre de usuario y la contrasea. Notas de uso: Si no se especifica el nombre de nodo, DB2 utilizar el primer nodo de LDAP que represente el servidor DB2 en la mquina actual. Puede que sea necesario registrar (catalogar) manualmente la base de datos en LDAP si: v El servidor de base de datos no soporta LDAP. El administrador debe registrar manualmente cada base de datos en LDAP para permitir a los clientes que soportan LDAP acceder a la base de datos sin tener que catalogarla localmente en cada mquina cliente. v La aplicacin quiere utilizar un nombre diferente para conectarse a la base de datos. En este caso, el administrador puede catalogar la base de datos utilizando un nombre de alias diferente. v La base de datos est ubicada en el sistema principal o en el servidor de bases de datos iSeries. En este caso, el administrador puede registrar la base de datos en LDAP y especificar el nodo de pasarela mediante el parmetro GWNODE. v Durante la operacin CREATE DATABASE IN LDAP, el nombre de base de datos ya existe en LDAP. La base de datos se crea de todos modos en la mquina local (y pueden acceder a ella las aplicaciones locales), pero la entrada existente en LDAP no se modificar para reflejar la nueva base de datos. En este caso, el administrador puede: Suprimir la entrada de base de datos existente en LDAP y registrar manualmente la nueva base de datos en LDAP. Registrar la nueva base de datos en LDAP utilizando un nombre de alias diferente. Informacin relacionada: v Mandato REGISTER en la pgina 598 v Mandato UNCATALOG LDAP DATABASE en la pgina 696 v Mandato CATALOG LDAP NODE en la pgina 262 v Mandato UNCATALOG LDAP NODE en la pgina 698 v db2ldcfg -Mandato Configurar entorno de LDAP en la pgina 97
261
CATALOG LDAP NODE Mandato CATALOG LDAP NODE

Cataloga una nueva entrada de nodo en LDAP (Lightweight Directory Access Protocol). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG LDAP NODE nombrenodo AS aliasnodo
USER
Parmetros del mandato: NODE nombrenodo Especifica el nombre de nodo LDAP del servidor DB2. AS aliasnodo Especifica un nombre de alias nuevo para la entrada de nodo LDAP. USER nombreusuario Especifica el nombre distinguido (DN) LDAP del usuario. El nombre DN LDAP de usuario debe tener suficiente autorizacin para crear el objeto en el directorio LDAP. Si no se especifica el nombre DN LDAP del usuario, se utilizarn las credenciales del usuario de la conexin actual. PASSWORD contrasea Contrasea de cuenta. Notas de uso: El mandato CATALOG LDAP NODE se utiliza para especificar un nombre de alias diferente para el nodo que representa el servidor DB2. Informacin relacionada: v Mandato CATALOG LDAP DATABASE en la pgina 258
262
Command Reference
CATALOG LDAP NODE

v Mandato UNCATALOG LDAP DATABASE en la pgina 696 v Mandato UNCATALOG LDAP NODE en la pgina 698
263
CATALOG LOCAL NODE Mandato CATALOG LOCAL NODE

Crea un alias local para una instancia que reside en la misma mquina. Se deber catalogar un nodo local cuando hay ms de una instancia en la misma estacin de trabajo a la que se debe acceder desde el cliente del usuario. Para acceder al nodo local se utiliza Interprocess Communications (IPC). Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG ADMIN LOCAL NODE nombrenodo INSTANCE nombreinstancia
SYSTEM
nombre-sistema
OSTYPE
tipo-sistema-operativo
WITH
serie-comentario
Parmetros del mandato: ADMIN Especifica que se debe catalogar un nodo de servidor de administracin local. NODE nombrenodo Alias local para el nodo que se debe catalogar. Es un nombre arbitrario en la estacin de trabajo del usuario, que se utiliza para identificar el nodo. Debe ser un nombre significativo para que sea fcil de recordar. El nombre debe adaptarse a los convenios de denominacin del gestor de bases de datos. INSTANCE nombreinstancia Nombre de la instancia local a la que se debe acceder. SYSTEM nombre-sistema Especifica el nombre de sistema DB2 que se utiliza para identificar la mquina servidor.
264
Command Reference
CATALOG LOCAL NODE

OSTYPE tipo-sistema-operativo Especifica el tipo de sistema operativo de la mquina servidor. Los valores vlidos son: AIX, WIN, HPUX, SUN, OS390, OS400, VM, VSE, SNI, SCO, LINUX y DYNIX. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles. Ejemplos: La estacin de trabajo A tiene dos instancias de servidor, inst1 e inst2. Para crear bases de datos en ambas instancias desde una sola sesin CLP, emita la secuencia siguiente de mandatos (suponiendo que la variable de entorno DB2INSTANCE est establecida en inst1): 1. Cree una base de datos local en inst1:
db2 create database mibd1
2. Catalogue otra instancia de servidor en esta estacin de trabajo:

db2 catalog local node minodo2 instance inst2
3. Cree una base de datos en minodo2:

db2 attach to minodo2 db2 create database mibd2
Notas de uso: Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorios de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada:
265
CATALOG LOCAL NODE

v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato TERMINATE en la pgina 691
266
Command Reference
CATALOG NAMED PIPE NODE Mandato CATALOG NAMED PIPE NODE

Aade una entrada de nodo de rea de interconexin con nombre al directorio de nodos. El rea de interconexin con nombre se utiliza para acceder al nodo remoto. Este mandato slo est disponible en Windows. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
CATALOG ADMIN INSTANCE nombreinstancia SYSTEM nombre-mquina NPIPE NODE nombrenodo REMOTE nombresistema
OSTYPE
WITH
serie-comentario
Parmetros del mandato: ADMIN Especifica que se debe catalogar un nodo de servidor de administracin NPIPE. NODE nombrenodo Alias local para el nodo que se debe catalogar. Es un nombre arbitrario en la estacin de trabajo del usuario, que se utiliza para identificar el nodo. Debe ser un nombre significativo para que sea fcil de recordar. El nombre debe adaptarse a los convenios de denominacin del gestor de bases de datos. REMOTE nombresistema Nombre de sistema del nodo en el que reside la base de datos de destino. La longitud mxima es de 15 caracteres. INSTANCE nombreinstancia Nombre de la instancia de servidor en la que reside la base de datos
267
CATALOG NAMED PIPE NODE

de destino. Es idntico al nombre del rea de interconexin con nombre remota, que se utiliza para comunicarse con el nodo remoto. SYSTEM nombre-mquina Especifica el nombre de sistema DB2 que se utiliza para identificar la mquina servidor. OSTYPE tipo-sistema-operativo Especifica el tipo de sistema operativo de la mquina servidor. Los valores vlidos son: AIX, WIN, HPUX, SUN, OS390, OS400, VM, VSE, SNI, SCO y LINUX. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles. Ejemplos:
db2 catalog npipe node db2np1 remote nphost instance db2inst1 with "Nodo rea interconexin con nombre remota."
Notas de uso: El gestor de bases de datos crea el directorio de nodos cuando se cataloga el primer nodo (es decir, cuando se emite el primer mandato CATALOG...NODE). En un cliente Windows, almacena y mantiene el directorio de nodos en el subdirectorio de instancias donde est instalado el cliente. En un cliente AIX, crea el directorio de nodos en el directorio de instalacin de DB2. Liste el contenido del directorio de nodo local utilizando el mandato LIST NODE DIRECTORY. Nota: Si la colocacin en antememoria de directorio est habilitada (vea el parmetro de configuracin dir_cache del mandato GET DATABASE MANAGER CONFIGURATION), los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la memoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga
268
Command Reference
CATALOG NAMED PIPE NODE

(db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST NODE DIRECTORY en la pgina 465 v Mandato TERMINATE en la pgina 691
269
CATALOG NETBIOS NODE Mandato CATALOG NETBIOS NODE

Aade una entrada de nodo NetBIOS al directorio de nodos. Para acceder al nodo remoto se utiliza el protocolo de comunicaciones NetBIOS. Este mandato slo est disponible en Windows. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
CATALOG ADMIN ADAPTER nmero-adaptador REMOTE_INSTANCE nombre-instancia NETBIOS NODE nombrenodo REMOTE nombre-n-servidor
SYSTEM
nombre-sistema
OSTYPE
WITH
serie-comentario
Parmetros del mandato: ADMIN Especifica la particin de base de datos del servidor de administracin. NODE nombrenodo Alias local para el nodo que se debe catalogar. Es un nombre arbitrario en la estacin de trabajo del usuario, que se utiliza para identificar el nodo. Debe ser un nombre significativo para que sea fcil de recordar. El nombre debe adaptarse a los convenios de denominacin del gestor de bases de datos. REMOTE nombre-n-servidor Nombre de la estacin de trabajo remota donde reside la base de datos de destino. Este nombre debe cumplir los convenios de denominacin del gestor de bases de datos. Es el nombre de estacin
270
Command Reference
CATALOG NETBIOS NODE

de trabajo (nombre-n) que se encuentra en el archivo de configuracin del gestor de bases de datos de la estacin de trabajo servidor. ADAPTER nmero-adaptador Especifica el nmero de adaptador de salida lgico local de la LAN. El valor por omisin es cero. REMOTE_INSTANCE nombre-instancia Especifica el nombre real de la instancia con la que se est realizando una conexin en la mquina servidor remota. SYSTEM nombre-sistema Especifica un nombre que se utiliza para identificar la mquina servidor. OSTYPE tipo-sistema-operativo Especifica el tipo de sistema operativo de la mquina servidor. El nico sistema operativo soportado que permite actualmente las conexiones NetBios es Windows, de modo que el nico valor permitido para OSTYPE es WIN. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles. Ejemplos:
db2 catalog netbios node db2netb1 remote db2inst1 adapter 0 with "Un nodo NetBIOS remoto"
Notas de uso: El gestor de bases de datos crea el directorio de nodos cuando se cataloga el primer nodo (es decir, cuando se emite el primer mandato CATALOG...NODE). En un cliente Windows, almacena y mantiene el directorio de nodos en el subdirectorio de instancias donde est instalado el cliente. En un cliente AIX, crea el directorio de nodos en el directorio de instalacin de DB2. Liste el contenido del directorio de nodo local utilizando el mandato LIST NODE DIRECTORY. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la
271
CATALOG NETBIOS NODE

antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST NODE DIRECTORY en la pgina 465 v Mandato TERMINATE en la pgina 691
272
Command Reference
CATALOG ODBC DATA SOURCE Mandato CATALOG ODBC DATA SOURCE

Cataloga una fuente de datos ODBC de usuario o de sistema. Una fuente de datos, en terminologa de ODBC (Open Database Connectivity Conectividad de bases de datos abiertas), es un nombre definido por el usuario para una base de datos o un sistema de archivos especfico. Dicho nombre se utiliza para acceder a la base de datos o al sistema de archivos mediante las API ODBC. Se pueden catalogar fuentes de datos del usuario o del sistema. Una fuente de datos de usuario slo est visible para el usuario que la ha catalogado, mientras que una fuente de datos de sistema est visible para todos los dems usuarios y todos ellos la pueden utilizar. Este mandato slo est disponible en las plataformas Windows. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
USER CATALOG SYSTEM ODBC DATA SOURCE nombre-fuente-datos
Parmetros del mandato: USER Cataloga una fuente de datos de usuario. Es el valor por omisin si no se especifica ninguna palabra clave. SYSTEM Cataloga una fuente de datos de sistema. ODBC DATA SOURCE nombre-fuente-datos Especifica el nombre de la fuente de datos que se debe catalogar. La longitud mxima es de 32 caracteres. Informacin relacionada: v Mandato LIST ODBC DATA SOURCES en la pgina 468 v Mandato UNCATALOG ODBC DATA SOURCE en la pgina 701
273
CATALOG TCP/IP NODE Mandato CATALOG TCP/IP NODE

Aade una entrada de nodo TCP/IP (Transmission Control Protocol/Internet Protocol) al directorio de nodos. Para acceder al nodo remoto se utiliza el protocolo de comunicaciones TCP/IP. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
CATALOG ADMIN TCPIP NODE nombrenodo REMOTE nombresistpral
(1) SERVER nombre-servicio SECURITY SOCKS
REMOTE_INSTANCE
nombre-instancia
SYSTEM
nombre-sistema
OSTYPE
WITH
serie-comentario
Notas: 1 SERVER no se debe especificar para los nodos ADMIN, pero es obligatorio para los nodos no ADMIN.
Parmetros del mandato: ADMIN Especifica que se debe catalogar un nodo de servidor de administracin TCP/IP. NODE nombrenodo Alias local para el nodo que se debe catalogar. Es un nombre arbitrario en la estacin de trabajo del usuario, que se utiliza para identificar el nodo. Debe ser un nombre significativo para que sea
274
Command Reference
CATALOG TCP/IP NODE

fcil de recordar. El nombre debe adaptarse a los convenios de denominacin del gestor de bases de datos. REMOTE nombresistpral Nombre de sistema principal del nodo donde reside la base de datos de destino. El nombre de sistema principal es el nombre del nodo que se conoce en la red TCP/IP. La longitud mxima es de 255 caracteres. SERVER nombre-servicio Especifica el nombre de servicio o el nmero de puerto de la instancia de gestor de bases de datos del servidor. El mandato CATALOG TCPIP NODE se ejecuta en un cliente. v Si se especifica un nombre de servicio, se utiliza el archivo services del cliente para correlacionar el nombre de servicio con un nmero de puerto. Se especifica un nombre de servicio en el archivo de configuracin de gestor de bases de datos del servidor y se utiliza el archivo services del servidor para correlacionar este nombre de servicio con un nmero de puerto. El nmero de puerto del cliente y del servidor deben coincidir. Nota: Se puede especificar un nmero de puerto, en lugar de un nombre de servicio, en el archivo de configuracin de gestor de bases de datos del servidor, pero no se recomienda. v Si se especifica un nmero de puerto, no es necesario especificar ningn nombre de servicio en el archivo services de TCP/IP local. La longitud mxima es de 14 caracteres. Este parmetro es sensible a las maysculas y minsculas. Nota: Este parmetro no debe especificarse para nodos ADMIN. El valor de los nodos ADMIN es siempre 523. SECURITY SOCKS Especifica que el nodo estar habilitado para SOCKS. Las variables de entorno siguientes son obligatorias y deben establecerse para habilitar SOCKS: SOCKS_NS Servidor de nombres de dominio para resolver la direccin de sistema principal del servidor SOCKS. Debe ser una direccin IP. SOCKS_SERVER El nombre de sistema principal totalmente calificado o la direccin IP del servidor SOCKS. Si el cliente DB2 de SOCKS
275
CATALOG TCP/IP NODE

no es capaz de resolver el nombre de sistema principal totalmente calificado, supone que se ha entrado una direccin IP. Debe ser verdadera una de las condiciones siguientes: v Se tiene que poder alcanzar al servidor SOCKS a travs del servidor de nombres de dominio v Deber estar listado en el archivo hosts. La ubicacin de este archivo se describe en la documentacin de TCP/IP. v Debe estar en formato de direccin IP. Si se emite este mandato despus de db2start, es necesario emitir un mandato TERMINATE para que el mandato entre en vigor. REMOTE_INSTANCE nombre-instancia Especifica el nombre de la instancia de servidor con la que se realiza una conexin. SYSTEM nombre-sistema Especifica el nombre de sistema DB2 que se utiliza para identificar la mquina servidor. OSTYPE tipo-sistema-operativo Especifica el tipo de sistema operativo de la mquina servidor. Los valores vlidos son: AIX, WIN, HPUX, SUN, OS390, OS400, VM, VSE, SNI, SCO y LINUX. WITH serie-de-comentario Describe la entrada del nodo en el directorio de nodos. Se puede entrar cualquier comentario que sirva de ayuda para describir el nodo. La longitud mxima es de 30 caracteres. No estn permitidos los retornos de carro ni los saltos de lnea. El texto de los comentarios debe encerrarse entre comillas simples o dobles. Ejemplos:
db2 catalog tcpip node db2tcp1 remote tcphost server db2inst1 with "Un nodo TCP/IP remoto" db2 catalog tcpip node db2tcp2 remote 9.21.15.235 server db2inst2 with "Nodo TCP/IP que utiliza direccin IP"
Notas de uso: El gestor de bases de datos crea el directorio de nodos cuando se cataloga el primer nodo (es decir, cuando se emite el primer mandato CATALOG...NODE). En un cliente Windows, almacena y mantiene el
276
Command Reference
CATALOG TCP/IP NODE

directorio de nodos en el subdirectorio de instancias donde est instalado el cliente. En un cliente AIX, crea el directorio de nodos en el directorio de instalacin de DB2. Liste el contenido del directorio de nodo local utilizando el mandato LIST NODE DIRECTORY. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) el gestor de bases de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST NODE DIRECTORY en la pgina 465 v Mandato TERMINATE en la pgina 691
277
CHANGE DATABASE COMMENT Mandato CHANGE DATABASE COMMENT

Cambia un comentario de base de datos en el directorio de bases de datos del sistema o en el directorio de bases de datos locales. El texto actualmente asociado con un comentario puede sustituirse por texto de comentario nuevo. mbito: Este mandato slo afecta a la particin de base de datos en la que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna Sintaxis del mandato:
CHANGE DATABASE DB alias-base-datos COMMENT ON vaacceso unidad
WITH
serie-comentario
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos cuyo comentario debe cambiarse. Para cambiar el comentario en el directorio de bases de datos del sistema, especifique el alias para la base de datos. Para cambiar el comentario en el directorio de bases de datos locales, especifique la va de acceso donde reside la base de datos (con el parmetro vaacceso) y entre el nombre (no el alias) de la base de datos. ON vaacceso/unidad En sistemas basados en UNIX, especifica la va de acceso en la que reside la base de datos y cambia el comentario en el directorio de bases de datos locales. Si no se especifica una va de acceso, se cambia el comentario de base de datos correspondiente a la entrada del directorio de bases de datos del sistema. En los sistemas operativos Windows, especifica la letra de la unidad en la que reside la base de datos.
278
Command Reference
CHANGE DATABASE COMMENT

WITH serie-comentario Describe la entrada del directorio de bases de datos del sistema o del directorio de bases de datos locales. Se puede entrar cualquier comentario que ayude a describir la base de datos catalogada. La longitud mxima de una serie de comentario es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. Ejemplos: El ejemplo siguiente cambia el texto del comentario del directorio de bases de datos del sistema de la base de datos SAMPLE de Test 2 - Holding a Test 2 - Add employee inf rows:
db2 change database sample comment with "Test 2 - Add employee inf rows"
Notas de uso: El texto de comentario nuevo sustituye al texto existente. Para aadir informacin, entre el texto de comentario antiguo, seguido del texto nuevo. Slo se modifica el comentario para una entrada asociada con el alias de base de datos. Otras entradas con el mismo nombre de base de datos, pero con alias diferentes, no se vern afectadas. Si se especifica la va de acceso, el alias de base de datos debe estar catalogado en el directorio de bases de datos locales. Si no se especifica la va de acceso, el alias de base de datos debe estar catalogado en el directorio de bases de datos del sistema. Informacin relacionada: v Mandato CREATE DATABASE en la pgina 283
279
CHANGE ISOLATION LEVEL Mandato CHANGE ISOLATION LEVEL

Cambia el modo en que DB2 asla los datos de otros procesos mientras se est accediendo a una base de datos. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
CHANGE SQLISL ISOLATION TO CS NC RR RS UR
Parmetros del mandato: TO CS NC RR RS UR Especifica estabilidad de cursor como nivel de aislamiento. Especifica que no hay ningn compromiso como nivel de aislamiento. DB2 no lo soporta. Especifica lectura repetible como nivel de aislamiento. Especifica estabilidad de lectura como nivel de aislamiento. Especifica lectura no comprometida como nivel de aislamiento.
Notas de uso: DB2 utiliza niveles de aislamiento para mantener la integridad de los datos de una base de datos. El nivel de aislamiento define el grado en el que se asla (apantalla) un proceso de aplicacin de los cambios efectuados por otros procesos de aplicacin que se ejecutan simultneamente. Si una base de datos no soporta un nivel de aislamiento seleccionado, dicho nivel se escala automticamente a un nivel soportado en el momento de efectuar la conexin.
280
Command Reference
CHANGE ISOLATION LEVEL

Los cambios de nivel de aislamiento no estn permitidos mientras se est conectado a una base de datos con una conexin de tipo 1. El proceso de fondo debe terminarse antes de poder cambiar el nivel de aislamiento:
db2 terminate db2 change isolation to ur db2 connect to sample
Los cambios estn permitidos si se utiliza una conexin de tipo 2, pero debern realizarse con precaucin porque se aplicarn a cada conexin efectuada desde el mismo proceso de fondo del procesador de lnea de mandatos. El usuario tiene la responsabilidad de recordar qu nivel de aislamiento se aplica a cada base de datos conectada. En el ejemplo siguiente, un usuario est en modalidad interactiva de DB2 despus de la creacin de la base de datos SAMPLE:
update command options using c off catalog db sample as sample2 set client connect 2 connect to sample connect to sample2 change isolation to cs set connection sample declare c1 cursor for select * from org open c1 fetch c1 for 3 rows change isolation to rr fetch c1 for 2 rows
Se produce un error SQL0514N porque c1 no est en un estado preparado para este nivel de aislamiento.
change isolation to cs set connection sample2 fetch c1 for 2 rows
Se produce un error SQL0514N porque c1 no est en un estado preparado para esta base de datos.
declare c1 cursor for select division from org
Se produce un error DB21029E porque el cursor c1 ya se ha declarado y se ha abierto.

set connection sample fetch c1 for 2 rows
281
CHANGE ISOLATION LEVEL

Esto funciona porque se ha utilizado la base de datos original (SAMPLE) con el nivel de aislamiento (CS) original. Conceptos relacionados: v Niveles de aislamiento del manual Consulta de SQL, Volumen 1 Informacin relacionada: v Mandato SET CLIENT en la pgina 669 v Mandato QUERY CLIENT en la pgina 572
282
Command Reference
CREATE DATABASE Mandato CREATE DATABASE

Inicializa una base de datos nueva con una secuencia de clasificacin opcional definida por el usuario, crea los tres espacios de tabla iniciales, crea las tablas del sistema y asigna la anotacin cronolgica de recuperacin. Al inicializar una nueva base de datos, puede especificar la opcin AUTOCONFIGURE para visualizar y, opcionalmente, aplicar los valores ptimos para los parmetros de tamao de la agrupacin de almacenamientos intermedios, de base de datos y de gestor de bases de datos. La opcin AUTOCONFIGURE no est disponible en un entorno de bases de datos particionado. Este mandato no es vlido en un cliente. mbito: En un entorno de bases de datos particionado, este mandato afecta a todas las particiones de base de datos que aparecen listadas en el archivo db2nodes.cfg. La particin de base de datos desde la que se emite este mandato se convierte en la particin de base de datos de catlogo para la nueva base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Instancia. Para crear una base de datos en otro nodo (remoto), es necesario conectarse primero a dicho nodo. Este mandato establece temporalmente una conexin de base de datos durante el proceso. Sintaxis del mandato:
CREATE DATABASE DB nombre-base-datos AT DBPARTITIONNUM Opciones de Create Database
Opciones de Create Database:

ON vaacceso unidad ALIAS alias-base-datos
283
CREATE DATABASE
USING CODESET conjuntocdigos TERRITORY territorio COLLATE USING SYSTEM COMPATIBILITY IDENTITY NLSCHAR
NUMSEGS nmseg CATALOG TABLESPACE TEMPORARY TABLESPACE AUTOCONFIGURE
DFT_EXTENT_SZ tamaoext_omisin defn-espaciotabla defn-espaciotabla USER TABLESPACE defn-espaciotabla
WITH serie-comentario
APPLY USING palabraclave-entrada valor-parm
DB ONLY DB AND DBM NONE
defn-espaciotabla:
MANAGED BY
, SYSTEM USING ( DATABASE USING ( serie-contenedor , FILE DEVICE ) nmero-de-pginas )
serie-contenedor
EXTENTSIZE nmero-de-pginas
PREFETCHSIZE nmero-de-pginas
OVERHEAD nmero-de-milisegundos
TRANSFERRATE nmero-de-milisegundos
Notas: 1. La combinacin de valores de conjunto de cdigos y territorio debe ser vlida. 2. Las definiciones de espacio de tabla especificadas en CREATE DATABASE se aplican a todas las particiones de base de datos en las que se est creando la base de datos. No se pueden especificar por separado para cada particin de base de datos. Si las definiciones de espacio de tabla han de crearse de forma diferente en particiones de base de datos determinadas, debe utilizarse la sentencia CREATE TABLESPACE. Cuando se definen contenedores para espacios de tabla, se puede utilizar $N. $N se sustituir por el nmero de particin de base de datos cuando
284
Command Reference
CREATE DATABASE
se cree realmente el contenedor. Esto es necesario si el usuario desea especificar contenedores en una base de datos de mltiples particiones lgicas. 3. En un entorno de bases de datos particionado, el uso de la opcin AUTOCONFIGURE causar una anomala del mandato CREATE DATABASE. Si desea utilizar la opcin AUTOCONFIGURE en un entorno de bases de datos particionado, cree primero la base de datos sin especificar la opcin AUTOCONFIGURE y, a continuacin, ejecute el mandato AUTOCONFIGURE en cada particin. 4. La opcin AUTOCONFIGURE requiere autorizacin sysadm. Parmetros del mandato: DATABASE nombre-base-datos Nombre que se debe asignar a la nueva base de datos. Debe ser un nombre exclusivo que distinga la base de datos de cualquier otra base de datos del directorio de bases de datos locales o del directorio de bases de datos del sistema. El nombre debe adaptarse a los convenios de denominacin para bases de datos. AT DBPARTITIONNUM Especifica que la base de datos slo se debe crear en la particin de base de datos que emite el mandato. No especifique esta opcin al crear una nueva base de datos. Puede utilizarla para volver a crear una particin de base de datos que se ha eliminado porque estaba daada. Despus de utilizar el mandato CREATE DATABASE con la opcin AT DBPARITIONNUM, la base de datos que est en esta particin estar en estado de pendiente de restauracin. Debe restaurar inmediatamente la base de datos en este nodo. Este parmetro no est destinado al uso general. Por ejemplo, debe utilizarse con el mandato RESTORE DATABASE si la particin de base de datos que est en un nodo estaba daada y se tiene que volver a crear. El uso incorrecto de este parmetro puede causar incoherencias en el sistema, de modo que slo se deber utilizar con precaucin. Nota: Si se utiliza este parmetro para volver a crear una particin de base de datos que se ha eliminado (porque se ha daado), la base de datos de este nodo estar en estado de pendiente de restauracin. Despus de volver a crear la particin de base de datos, se deber restaurar inmediatamente la base de datos en dicho nodo. ON vaacceso/unidad En sistemas basados en UNIX, especifica la va de acceso en la que se debe crear la base de datos. Si no se especifica una va de acceso, la base de datos se crea en la va de acceso de base de datos por omisin
285
CREATE DATABASE
especificada en el archivo de configuracin del gestor de bases de datos (parmetro dftdbpath). La longitud mxima es de 205 caracteres. En el sistema operativo Windows, especifica la letra de la unidad en la que se debe crear la base de datos. Nota: Para sistemas MPP, no se deber crear una base de datos en un directorio montado con NFS. Si no se especifica una va de acceso, asegrese de que el parmetro de configuracin dftdbpath del gestor de bases de datos no se establezca en una va de acceso montada con NFS (por ejemplo, en sistemas basados en UNIX, no deber especificar el directorio $HOME del propietario de la instancia). La va de acceso especificada para este mandato en un sistema MPP no puede ser una va de acceso relativa. ALIAS alias-basedatos Alias para la base de datos del directorio de bases de datos del sistema. Si no se proporciona ningn alias, se utiliza el nombre de base de datos especificado. USING CODESET conjuntocdigos Especifica el conjunto de cdigos que se debe utilizar para los datos entrados en esta base de datos. Despus de crear la base de datos, no se puede cambiar el conjunto de cdigos especificado. TERRITORY territorio Especifica el territorio que se debe utilizar para los datos entrados en esta base de datos. Despus de crear la base de datos, no se puede cambiar el territorio especificado. COLLATE USING Identifica el tipo secuencia de clasificacin que se debe utilizar para la base de datos. Una vez que se ha creado la base de datos, no se puede cambiar la secuencia de clasificacin. COMPATIBILITY Secuencia de clasificacin de DB2 Versin 2. Algunas tablas de clasificacin se han ampliado. Esta opcin especifica que se debe utilizar la versin anterior de estas tablas. IDENTITY Secuencia de clasificacin de identidad, en la que se comparan las series byte por byte. NLSCHAR Secuencia de clasificacin definida por el sistema que utiliza las normas de clasificacin exclusiva para el conjuntocdigo/territorio especfico.
286
Command Reference
CREATE DATABASE
Nota: Esta opcin slo se puede utilizar con la pgina de cdigos tailandesa (CP874). Si se especifica esta opcin en entornos que no sean el tailands, el mandato fallar y devolver el error SQL1083N con el Cdigo de Razn 4. SYSTEM Secuencia de clasificacin basada en el territorio actual. NUMSEGS nmseg Especifica el nmero de directorios de segmentos que se crearn y se utilizarn para almacenar archivos DAT, IDX, LF, LB y LBA para cualquier espacio de tabla SMS por omisin. Este parmetro no afecta a los espacios de tabla DMS, a cualquier espacio de tabla SMS con caractersticas de creacin explcitas (creadas al crear la base de datos) o a cualquier espacio de tabla SMS creado explcitamente despus de crear la base de datos. DFT_EXTENT_SZ tamaoext_omisin Especifica el tamao de extensin por omisin de los espacios de tabla de la base de datos. CATALOG TABLESPACE defn-espaciotabla Especifica la definicin del espacio de tabla que contendr las tablas de catlogos, SYSCATSPACE. Si no se especifica, SYSCATSPACE se crear como un espacio de tabla SMS (System Managed Space Espacio gestionado por el sistema) con el nmero nmseg de directorios como contenedores y con un tamao de extensin de tamaoext_omisin. Por ejemplo, se crearn los contenedores siguientes si se especifica que nmseg sea 5:
/u/smith/smith/NODE0000/SQL00001/SQLT0000.0 /u/smith/smith/NODE0000/SQL00001/SQLT0000.1 /u/smith/smith/NODE0000/SQL00001/SQLT0000.2 /u/smith/smith/NODE0000/SQL00001/SQLT0000.3 /u/smith/smith/NODE0000/SQL00001/SQLT0000.4
En un entorno de base de datos particionado, el espacio de tabla de catlogo slo se crea en la particin de base de datos de catlogo (la particin de base de datos en la que se emite el mandato CREATE DATABASE). USER TABLESPACE defn-espaciotabla Especifica la definicin del espacio de tabla de usuario inicial, USERSPACE1. Si no se especifica, USERSPACE1 se crear como un espacio de tabla SMS con el nmero nmseg de directorios como contenedores y con un tamao de extensin de tamaoext_omisin. Por ejemplo, se crearn los contenedores siguientes si se especifica que nmseg sea 5:
287
CREATE DATABASE
TEMPORARY TABLESPACE defn-espaciotabla Especifica la definicin del espacio de tabla temporal inicial de sistema, TEMPSPACE1. Si no se especifica, TEMPSPACE1 se crear como un espacio de tabla SMS con el nmero nmseg de directorios como contenedores y con un tamao de extensin de tamaoext_omisin. Por ejemplo, los siguientes contenedores se crearan si se especificara nmseg como 5:
WITH serie-comentario Describe la entrada de base de datos en el directorio de bases de datos. Se puede entrar cualquier comentario que ayude a describir la base de datos. La longitud mxima es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas simples o comillas dobles. AUTOCONFIGURE Basndose en la entrada de usuario, calcula los valores recomendados para el tamao de agrupacin de almacenamientos intermedios, la configuracin de base de datos y la configuracin de gestor de bases de datos y, opcionalmente, los aplica. USING palabraclave-entrada valor parm
Tabla 5. Palabras claves de entrada y valores de parmetro vlidos Palabra clave mem_percent Valores vlidos 1100 Valor por omisin 25 Explicacin Porcentaje de memoria que se va a dedicar. Si otras aplicaciones (aparte del sistema operativo) se estn ejecutando en este servidor, establezca este valor en menos de 100.
288
Command Reference
CREATE DATABASE
Tabla 5. Palabras claves de entrada y valores de parmetro vlidos (continuacin) Palabra clave workload_type Valores vlidos simple, mixed, complex Valor por omisin mixed Explicacin Las cargas de trabajo sencillas tienden a tener una actividad intensiva de E/S y principalmente de transacciones, mientras que las cargas de trabajo complejas tienden a tener una actividad intensiva de CPU y principalmente de consultas. Nmero de sentencias por unidad de trabajo Transacciones por minuto Optimizar para obtener un rendimiento mejor (ms transacciones por minuto) o un tiempo de recuperacin mejor Nmero de aplicaciones locales conectadas Nmero de aplicaciones remotas conectadas Nivel de aislamiento de aplicaciones que conectan con esta base de datos (RR: Lectura repetible; RS: Estabilidad de lectura; CS: Estabilidad de cursor; UR: Lectura no comprometida)
num_stmts
11 000 000
25
tpm admin_priority
150 000 performance, recovery, both
60 both
num_local_apps
05 000
num_remote_apps
05 000
100
isolation
RR, RS, CS, UR
RR
289
CREATE DATABASE
Tabla 5. Palabras claves de entrada y valores de parmetro vlidos (continuacin) Palabra clave bp_resizeable Valores vlidos yes, no Valor por omisin yes Explicacin Puede modificarse el tamao de las agrupaciones de almacenamientos intermedios?
APPLY DB ONLY Visualiza todos los cambios recomendados y slo aplica los cambios recomendados a los valores de configuracin de base de datos y de agrupacin de almacenamientos intermedios. DB AND DBM Visualiza y aplica los cambios recomendados a los valores de configuracin de gestor de bases de datos, de configuracin de base de datos y de agrupacin de almacenamientos intermedios. NONE Visualiza los cambios recomendados, pero no los aplica. Notas de uso: CREATE DATABASE: v Crea una base de datos en el subdirectorio especificado. En un entorno de base de datos particionado, crea la base de datos en todas las particiones de base de datos listadas en db2nodes.cfg y crea en cada particin de base de datos un directorio $DB2INSTANCE/NODExxxx bajo el subdirectorio especificado. En un entorno no particionado, crea un directorio $DB2INSTANCE/NODE0000 bajo el subdirectorio especificado. v Crea las tablas de catlogos del sistema y la anotacin cronolgica de recuperacin. v Cataloga la base de datos en los directorios de base de datos siguientes: directorio de bases de datos locales del servidor en la va de acceso indicada por vaacceso o, si no se especifica la va de acceso, la va de acceso de base de datos por omisin definida en el archivo de configuracin del sistema gestor de bases de datos por el parmetro dftdbpath. En cada sistema de archivos que contiene una base de datos reside un directorio de bases de datos local.
290
Command Reference
CREATE DATABASE
directorio de bases de datos del sistema del servidor para la instancia conectada. La entrada de directorio resultante contendr el nombre de base de datos y un alias de base de datos. Si el mandato se ha emitido desde un cliente remoto, el directorio de bases de datos del sistema del cliente tambin se actualiza con el nombre de base de datos y un alias. Crea un sistema o un directorio de bases de datos locales si no existe ninguno de los dos. Si se especifican, los valores de comentario y de conjunto de cdigos se colocan en ambos directorios. v Almacena el conjunto de cdigos, el territorio y la secuencia de clasificacin que se han especificado. Se establece un distintivo en el archivo de configuracin de base de datos si la secuencia de clasificacin consta de valores exclusivos o si es la secuencia de identidad. v Crea los esquemas denominados SYSCAT, SYSFUN, SYSIBM y SYSSTAT con SYSIBM como propietario. El servidor de particiones de base de datos en el que se emite este mandato se convierte en la particin de base de datos de catlogo para la nueva base de datos. Se crean automticamente dos grupos de particiones de base de datos: IBMDEFAULTGROUP e IBMCATGROUP. v Vincula los archivos de vinculacin del gestor de bases de datos definidos anteriormente a la base de datos (stos se listan en la lista de archivos de vinculacin de programas de utilidad, db2ubind.lst). Si uno o varios de estos archivos no se vinculan satisfactoriamente, CREATE DATABASE devuelve un aviso en SQLCA y proporciona informacin acerca de las vinculaciones que han fallado. Si falla una vinculacin, el usuario puede realizar la accin correctiva y vincular manualmente el archivo anmalo. De todos modos se crea la base de datos. Un esquema denominado NULLID se crea implcitamente al efectuar las vinculaciones con el privilegio CREATEIN otorgado a PUBLIC. Nota: La lista de archivos de vinculacin de programas de utilidad contiene dos archivos de vinculacin que no se pueden vincular en servidores de nivel inferior: db2ugtpi.bnd no se puede vincular en servidores DB2 Versin 2. db2dropv.bnd no se puede vincular en servidores DB2 Parallel Edition Versin 1. Si se vincula db2ubind.lst en un servidor de nivel inferior, se devuelven avisos que pertenecen a estos dos archivos y dichos avisos se pueden pasar por alto. v Crea los espacios de tabla SYSCATSPACE, TEMPSPACE1 y USERSPACE1. El espacio de tabla SYSCATSPACE slo se crea en la particin de base de datos de catlogo.
291
CREATE DATABASE
v Otorga lo siguiente: Privilegio EXECUTE WITH GRANT a PUBLIC sobre todas las funciones del esquema SYSFUN Privilegio EXECUTE a PUBLIC en todos los procedimientos del esquema SYSIBM Autorizacin DBADM y privilegios CONNECT, CREATETAB, BINDADD, CREATE_NOT_FENCED, IMPLICIT_SCHEMA y LOAD al creador de la base de datos Privilegios CONNECT, CREATETAB, BINDADD e IMPLICIT_SCHEMA a PUBLIC Privilegio USE en el espacio de tabla USERSPACE1 a PUBLIC Privilegio SELECT en cada catlogo de sistema a PUBLIC Privilegio BIND y EXECUTE a PUBLIC para cada programa de utilidad vinculado satisfactoriamente. Privilegio EXECUTE WITH GRANT a PUBLIC sobre todas las funciones del esquema SYSFUN. Privilegio EXECUTE a PUBLIC sobre todos los procedimientos del esquema SYSIBM. Con la autorizacin dbadm, se pueden otorgar estos privilegios (y revocarlos) a otros usuarios o a PUBLIC. Si otro administrador con autorizacin sysadm o dbadm sobre la base de datos revoca estos privilegios, el creador de la base de datos los retiene a pesar de todo. En un entorno MPP, el gestor de bases de datos crea un subdirectorio, $DB2INSTANCE/NODE xxxx, bajo la va de acceso especificada o por omisin en todas las particiones de base de datos. xxxx es el nmero de particin de base de datos tal como est definido en el archivo db2nodes.cfg (es decir, la particin de base de datos 0 se convierte en NODE0000). Los subdirectorios SQL00001 a SQLnnnnn residirn en esta va de acceso. Esto asegura que los objetos de base de datos asociados a particiones de base de datos diferentes se almacenen en directorios diferentes (incluso si todas las particiones de base de datos comparten el subdirectorio $DB2INSTANCE bajo la va de acceso especificada o por omisin). Si se habilita el soporte de LDAP (Lightweight Directory Access Protocol) en la mquina actual, la base de datos se registrar automticamente en el directorio LDAP. Si en el directorio LDAP ya existe un objeto de base de datos del mismo nombre, la base de datos se crear de todos modos en la mquina local, pero se devolver un mensaje de aviso, indicando que existe un conflicto de denominacin. En este caso, el usuario puede catalogar manualmente una entrada de base de datos LDAP utilizando el mandato CATALOG LDAP DATABASE.
292
Command Reference
CREATE DATABASE
CREATE DATABASE fallar si la aplicacin ya est conectada a una base de datos. Utilice CATALOG DATABASE para definir nombres de alias diferentes para la nueva base de datos. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM.
293
CREATE DATABASE
Conceptos relacionados: v Niveles de aislamiento del manual Consulta de SQL, Volumen 1 Informacin relacionada: v CREATE TABLESPACE sentencia del manual Consulta de SQL, Volumen 2 v Mandato BIND en la pgina 222 v Mandato CATALOG DATABASE en la pgina 250 v Mandato DROP DATABASE en la pgina 309 v Mandato RESTORE DATABASE en la pgina 636 v Mandato CATALOG LDAP DATABASE en la pgina 258 v Mandato AUTOCONFIGURE en la pgina 213
294
Command Reference
CREATE TOOLS CATALOG Mandato CREATE TOOLS CATALOG

Crea las tablas de catlogo de herramientas de DB2 en una base de datos nueva o existente. La base de datos debe ser local. El catlogo de herramientas contiene informacin acerca de las tareas administrativas que se configuran con herramientas tales como el Centro de tareas y el Centro de control. Nota: Opcionalmente, este mandato forzar todas las aplicaciones a detener y reiniciar el gestor de bases de datos si se crean nuevos espacios de tabla para el catlogo de herramientas. Tambin actualizar la configuracin del Servidor de administracin DB2 (DAS) y activar el planificador. Este mandato no es vlido en un cliente DB2. mbito: El nodo desde el que se emite este mandato se convierte en el nodo de catlogo para la nueva base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl El usuario debe tener tambin autorizacin DASADM para actualizar los parmetros de configuracin del servidor de administracin DB2. Conexin necesaria: Este mandato establece temporalmente una conexin de base de datos durante el proceso. Opcionalmente, este mandato detendr y reiniciar el gestor de bases de datos si se crean nuevos espacios de tabla. Sintaxis del mandato:
CREATE TOOLS CATALOG nombre-catlogo DATABASE nombre-base-datos
CREATE NEW DATABASE nombre-base-datos USE EXISTING TABLESPACE nombre-espaciotabla IN FORCE KEEP INACTIVE
295
CREATE TOOLS CATALOG

Parmetros del mandato: CATALOG nombre-catlogo Nombre que se ha de utilizar para identificar exclusivamente el catlogo de herramientas de DB2. Las tablas de catlogo se crean bajo este nombre de esquema. NEW DATABASE nombre-basedatos Nombre que se debe asignar a la nueva base de datos. Debe ser un nombre exclusivo que distinga la base de datos de cualquier otra base de datos en el directorio de bases de datos local o en el directorio de bases de datos del sistema. El nombre debe adaptarse a los convenios de denominacin para bases de datos. EXISTING DATABASE nombre-basedatos Nombre de una base de datos existente que ha de albergar el catlogo de herramientas. Debe ser una base de datos local. EXISTING TABLESPACE nombre-espaciotabla Nombre a utilizar para especificar el espacio de tabla de pginas de 32 K existente para crear las tablas de catlogo de herramientas de DB2. Para que las tablas se creen satisfactoriamente, tambin debe existir un espacio de tabla temporal con un tamao de pgina de 32 K. FORCE Al crear un catlogo de herramientas en un nuevo espacio de tabla, es preciso reiniciar el gestor de bases de datos, lo que requiere que no se conecte ninguna aplicacin. Utilice la opcin FORCE para asegurar que no se conecte ninguna aplicacin a la base de datos. Si se conectan aplicaciones, la creacin del catlogo de herramientas fallar, a menos que se especifique un espacio de tabla existente. KEEP INACTIVE Esta opcin no actualizar los parmetros de configuracin del servidor de administracin DB2 ni habilitar el planificador. Ejemplos:
db2 create tools catalog cc create new database toolsdb db2 create tools catalog use existing database toolsdb force db2 create tools catalog foobar use existing tablespace user32Ksp in database toolsdb db2 create tools catalog toolscat use existing database toolsdb keep inactive
Notas de uso: v Las tablas de catlogo de herramientas requieren dos espacios de tabla de tamao de pgina de 32 K (regular y temporal). Adems, a menos que especifique espacios de tabla existentes, se crear una nueva agrupacin de almacenamientos intermedios de 32 K para el espacio de tabla. Esto
296
Command Reference
CREATE TOOLS CATALOG

requiere que se reinicie el gestor de bases de datos. Si se debe reiniciar el gestor de bases de datos, hay que forzar la desactivacin de todas las aplicaciones existentes. Los nuevos espacios de tabla se crean con un solo contenedor cada uno en la va de acceso del directorio de base de datos por omisin. Si existe un catlogo activo con este nombre antes de ejecutar este mandato, se desactiva y el nuevo catlogo se convierte en el catlogo activo. Pueden crearse mltiples catlogos de herramientas de DB2 en la misma base de datos y se identifican de forma exclusiva por el nombre de catlogo. El parmetro JDK_PATH debe establecerse en la configuracin del Servidor de administracin DB2 (DAS) en el nivel mnimo soportado de JDK. Actualizar los parmetros de configuracin de DAS requiere la autorizacin DASADM sobre el servidor de administracin DB2. A menos que se especifique la opcin KEEP INACTIVE, este mandato actualiza los parmetros de configuracin de DAS locales relativos a la configuracin de base de datos de catlogo de herramientas de DB2 y habilita el planificador en el servidor DAS local. Para obtener ms detalles, consulte la publicacin Administration Guide.
v v
v v v
297
DEACTIVATE DATABASE Mandato DEACTIVATE DATABASE

Detiene la base de datos especificada. mbito: En un sistema MPP, este mandato desactiva la base de datos especificada en todas las particiones de base de datos del sistema. Si uno o varios de estas particiones de base de datos encuentran un error, se devuelve un aviso. La base de datos se desactivar satisfactoriamente en algunas particiones de base de datos, pero puede permanecer activa en los nodos que encuentran el error. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna Sintaxis del mandato:
DEACTIVATE DATABASE DB alias-base-datos
USER
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos que se debe detener. USER nombreusuario Especifica el usuario que detiene la base de datos. USING contrasea Especifica la contrasea para el ID de usuario. Notas de uso: Las bases de datos inicializadas por ACTIVATE DATABASE pueden cerrarse mediante DEACTIVATE DATABASE o mediante db2stop. Si ACTIVATE DATABASE ha inicializado una base de datos, la ltima aplicacin que se
298
Command Reference
DEACTIVATE DATABASE
desconecte de la base de datos no cerrar la base de datos y se deber utilizar DEACTIVATE DATABASE. (En este caso, db2stop tambin cerrar la base de datos). Nota: La aplicacin que utiliza el mandato DEACTIVATE DATABASE no puede tener una conexin de base de datos activa en ninguna base de datos. Informacin relacionada: v Mandato STOP DATABASE MANAGER en la pgina 687 v Mandato ACTIVATE DATABASE en la pgina 197
299
DEREGISTER Mandato DEREGISTER

Borra el registro del servidor DB2 del servidor de directorios de red. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
DEREGISTER DB2 SERVER LDAP NODE nombrenodo USER nombreusuario PASSWORD contrasea IN
Parmetros del mandato: IN Especifica el servidor de directorios de red del que se debe borrar el registro del servidor DB2. El valor vlido es LDAP para un servidor de directorios LDAP (Lightweight Directory Access Protocol).
USER nombreusuario ste es el nombre distinguido LDAP del usuario (DN). El DN LDAP de usuario debe tener suficiente autorizacin para suprimir el objeto del directorio LDAP. El nombre de usuario es opcional al borrar el registro en LDAP. Si no se especifica el DN LDAP del usuario, se utilizarn las credenciales del usuario de conexin actual. PASSWORD contrasea Contrasea de cuenta. NODE nombrenodo El nombre de nodo es el valor que se ha especificado cuando se ha registrado el servidor DB2 en LDAP. Notas de uso: Este mandato slo se puede emitir para una mquina remota cuando se est en el entorno LDAP. Cuando se emite para una mquina remota, se debe especificar el nombre de nodo del servidor remoto. Se elimina automticamente el registro del servidor DB2 cuando se elimina la instancia.
300
Command Reference
DEREGISTER
Informacin relacionada: v Mandato REGISTER en la pgina 598 v Mandato UPDATE LDAP NODE en la pgina 727
301
DESCRIBE Mandato DESCRIBE

Este mandato: v Visualiza la informacin de SQLDA de salida acerca de una sentencia SELECT o CALL v Visualiza columnas de una tabla o una vista v Visualiza ndices de una tabla o una vista Autorizacin: Para visualizar la informacin de SQLDA de salida acerca de una sentencia SELECT, se necesita uno de los privilegios o una de las autorizaciones que se listan ms abajo para cada tabla o vista a la que se hace referencia en la sentencia SELECT. Para visualizar las columnas o los ndices de una tabla o una vista, se necesita uno de los privilegios o una de las autorizaciones que se listan a continuacin para los catlogos del sistema SYSCAT.COLUMNS (DESCRIBE TABLE) y SYSCAT.INDEXES (DESCRIBE INDEXES FOR TABLE): v Privilegio SELECT v Privilegio CONTROL v Autorizacin sysadm o dbadm Dado que PUBLIC tiene todos los privilegios sobre tablas temporales globales declaradas, un usuario puede utilizar el mandato para visualizar informacin acerca de cualquier tabla temporal global declarada que exista en su conexin. Para visualizar la informacin de SQLDA de salida acerca de una sentencia CALL, se necesita uno de los privilegios o una de las autorizaciones que se listan ms abajo: v Privilegio EXECUTE para el procedimiento almacenado v Autorizacin sysadm o dbadm Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin.
302
Command Reference
DESCRIBE
Sintaxis del mandato:
OUTPUT DESCRIBE sentencia-select sentencia-call TABLE nombre-tabla INDEXES FOR TABLE nombre-tabla
SHOW DETAIL
Parmetros del mandato: OUTPUT Indica que debe describirse la salida de la sentencia. Esta palabra clave es opcional. sentencia-select o sentencia-call Identifica la sentencia sobre la que se desea informacin. CLP prepara automticamente la sentencia. TABLE nombre-tabla Especifica la tabla o vista que se debe describir. Se debe utilizar el nombre totalmente calificado con el formato esquema.nombre-tabla. No se puede utilizar un alias para la tabla en lugar de la tabla misma. El esquema es el nombre de usuario bajo el que se ha creado la tabla o la vista. El mandato DESCRIBE TABLE lista la informacin siguiente acerca de cada columna: v Nombre de columna v Tipo de esquema v Tipo de nombre v Longitud v Escala v Nulos (s/no) INDEXES FOR TABLE nombre-tabla Especifica la tabla o la vista para la que es necesario describir ndices. Se debe utilizar el nombre totalmente calificado con el formato esquema.nombre-tabla. No se puede utilizar un alias para la tabla en lugar de la tabla misma. El esquema es el nombre de usuario bajo el que se ha creado la tabla o la vista. El mandato DESCRIBE INDEXES FOR TABLE lista la informacin siguiente acerca de cada ndice de la tabla o vista: v v v v Esquema de ndice Nombre de ndice Norma exclusiva Cuenta de columnas
303
DESCRIBE
SHOW DETAIL Para el mandato DESCRIBE TABLE, especifica que la salida incluya la informacin adicional siguiente: v Si se ha definido una columna CHARACTER, VARCHAR o LONG VARCHAR como FOR BIT DATA v Nmero de columna v Secuencia de claves de particionamiento v Pgina de cdigos v Valor por omisin Para el mandato DESCRIBE INDEXES FOR TABLE, especifica que la salida incluya la informacin adicional siguiente: v Nombres de columna Ejemplos: Descripcin de la salida de una sentencia SELECT El ejemplo siguiente muestra cmo describir una sentencia SELECT:
db2 "describe output select * from staff"
Informacin SQLDA sqldaid : SQLDA Informacin columna sqltype sqllen -------------------- -----500 SMALLINT 2 449 VARCHAR 9 501 SMALLINT 2 453 CHARACTER 5 501 SMALLINT 2 485 DECIMAL 7,2 485 DECIMAL 7,2 sqlname.data -----------------------------ID NAME DEPT JOB YEARS SALARY COMM sqlname.length -------------2 4 4 3 5 6 4 sqldabc: 896 sqln: 20 sqld: 7
Descripcin de la salida de una sentencia CALL Dado un procedimiento almacenado que se ha creado con la sentencia:
CREATE PROCEDURE GIVE_BONUS (IN EMPNO INTEGER, IN DEPTNO INTEGER, OUT CHEQUE INTEGER, INOUT BONUS DEC(6,0))
...
304
Command Reference
DESCRIBE
El ejemplo siguiente muestra cmo describir la salida de una sentencia CALL:
db2 "describe output call give_bonus(123456, 987, ?, 15000.)" Informacin SQLDA sqldaid :SQLDA sqldabc:896 sqln:20 sqld:2 Informacin columna sqltype sqllen sqlname.data -------------------- ------ -----------------------------497 INTEGER 4 485 DECIMAL 6,0 sqlname.length --------------
Descripcin de una tabla El ejemplo siguiente muestra cmo describir una tabla:
db2 describe table user1.department
Tabla: USER1.DEPARTMENT Nombre columna -----------------AREA DEPT DEPTNAME Esquema tipo ----------SYSIBM SYSIBM SYSIBM Nombre tipo Longit. Esc. ------------------ -------- -------SMALLINT 2 0 CHARACTER 3 0 CHARACTER 20 0 Nulos -------No No S
Descripcin de un ndice de tabla El ejemplo siguiente muestra cmo describir un ndice de tabla:
db2 describe indexes for table user1.department
Tabla: USER1.DEPARTMENT Esquema Nombre Norma Nmero de ndice ndice exclusiva columnas -------------- ------------------ -------------- -------------USER1 IDX1 U 2
305
DETACH Mandato DETACH

Elimina la conexin de instancia DBMS lgica y termina la conexin de comunicacin fsica si no hay otras conexiones lgicas que utilicen esta capa. Autorizacin: Ninguna Conexin necesaria: Ninguna. Elimina una conexin de instancia existente. Sintaxis del mandato:
DETACH
Parmetros del mandato: Ninguno Informacin relacionada: v Mandato ATTACH en la pgina 211
306
Command Reference
DROP CONTACT Mandato DROP CONTACT

Elimina un contacto de la lista de contactos definidos en el sistema local. Un contacto es un usuario al que el Planificador y el Supervisor de salud envan mensajes. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
DROP CONTACT nombre
Parmetros del mandato: CONTACT nombre Nombre del contacto que se eliminar del sistema local.
307
DROP CONTACTGROUP Mandato DROP CONTACTGROUP

Elimina un grupo de contactos de la lista de contactos definidos en el sistema local. Un grupo de contactos contiene una lista de usuarios a los que el Planificador y el Supervisor de salud envan mensajes. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
DROP CONTACTGROUP nombre
Parmetros del mandato: CONTACTGROUP nombre Nombre del grupo de contactos que se eliminar del sistema local.
308
Command Reference
DROP DATABASE Mandato DROP DATABASE

Suprime el contenido de la base de datos y todos los archivos de anotaciones cronolgicas para la base de datos, descataloga la base de datos y suprime el subdirectorio de base de datos. mbito: Por omisin, este mandato afecta a todas las particiones de base de datos que se listan en el archivo db2nodes.cfg. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Instancia. No se necesita una conexin explcita. Si la base de datos est listada como remota, se establece una conexin de instancia al nodo remoto durante el tiempo que dura el mandato. Sintaxis del mandato:
DROP DATABASE DB alias-base-datos AT DBPARTITIONNUM
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos que se debe eliminar. La base de datos debe estar catalogada en el directorio de bases de datos del sistema. AT DBPARTITIONNUM Especifica que la base de datos debe suprimirse slo en la particin de base de datos que ha emitido el mandato DROP DATABASE. Este parmetro lo utilizan los programas de utilidad proporcionados con DB2 ESE y no est destinado al uso general. El uso incorrecto de este parmetro puede causar incoherencias en el sistema, de modo que slo se deber utilizar con precaucin. Ejemplos: El ejemplo siguiente suprime la base de datos a la que hace referencia el alias de base de datos SAMPLE:
309
DROP DATABASE
db2 drop database sample
Notas de uso: DROP DATABASE suprime todos los datos del usuario y los archivos de anotaciones cronolgicas, as como cualquier histrico de copia de seguridad/restauracin correspondiente a la base de datos. Si se necesitan los archivos de anotaciones cronolgicas para una recuperacin en avance despus de una operacin de restauracin, o se necesita el histrico de copia de seguridad para restaurar la base de datos, se debern guardar dichos archivos antes de emitir este mandato. La base de datos no se debe estar utilizando; todos los usuarios deben estar desconectados de la base de datos antes de que sta se pueda eliminar. Para eliminarse, una base de datos debe estar catalogada en el directorio de bases de datos del sistema. Slo se elimina del directorio de bases de datos del sistema el alias de base de datos especificado. Si existen otros alias con el mismo nombre de base de datos, sus entradas permanecern. Si la base de datos que se est eliminando es la ltima entrada del directorio de bases de datos locales, dicho directorio se suprimir automticamente. Si se emite DROP DATABASE desde un cliente remoto (o desde una instancia diferente en la misma mquina), se elimina el alias especificado del directorio de bases de datos del sistema del cliente. Se elimina el nombre de base de datos correspondiente del directorio de bases de datos del sistema del servidor. Este mandato desenlaza todos los archivos que estn enlazados mediante columnas DATALINK. Dado que la operacin de desenlace se realiza de forma asncrona en el DB2 Data Links Manager, puede que sus efectos no se vean inmediatamente en el DB2 Data Links Manager y los archivos desenlazados pueden no estar inmediatamente disponibles para otras operaciones. Cuando se emite el mandato, todos los DB2 Data Links Manager configurados en esa base de datos deben estar disponibles; de lo contrario, fallar la operacin de eliminacin de base de datos. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato CATALOG DATABASE en la pgina 250 v Mandato CREATE DATABASE en la pgina 283
310
Command Reference
DROP DATABASE
v Mandato UNCATALOG DATABASE en la pgina 692
311
DROP DATALINKS MANAGER Mandato DROP DATALINKS MANAGER

Elimina un DB2 Data Links Manager de la lista de DB2 Data Links Managers registrados para una base de datos especificada. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Sintaxis del mandato:
DROP DATALINKS MANAGER FOR DATABASE DB nombrebd USING nombre
Parmetros del mandato: DATABASE nombrebd Especifica el nombre de base de datos. USING nombre Especifica el nombre del servidor de DB2 Data Links Manager tal como muestra el mandato LIST DATALINKS MANAGER. Ejemplos: Ejemplo 1 Para eliminar el DB2 Data Links Manager micky.almaden.ibm.com de la base de datos TEST bajo la instancia VALIDATE que reside e el sistema principal bramha.almaden.ibm.com cuando algunas tablas de la base de datos tienen enlaces con micky.almaden.ibm.com, haga lo siguiente: 1. Realice una copia de seguridad de base de datos par la base de datos TEST. 2. Si existe algn enlace con micky.almaden.ibm.com, elimine dicho enlace realizando las acciones siguientes: a. Inicie la sesin con un ID de usuario que pertenezca a SYSADM_GROUP y obtenga una conexin de modalidad exclusiva para la base de datos TEST emitiendo el mandato siguiente:
connect to test in exclusive mode
Asegrese de que sea la nica conexin con TEST utilizando el ID de usuario. Esto impedir que se creen nuevos enlaces.
312
Command Reference
DROP DATALINKS MANAGER

b. Obtenga una lista de todas las columnas FILE LINK CONTROL DATALINK y las tablas que las contienen en la base de datos emitiendo el mandato siguiente:
select tabname, colname from syscat.columns where substr(dl_features, 2, 1) = F
c. Para cada columna FILE LINK CONTROL DATALINK de la lista, emita SQL SELECT para determinar si existen enlaces con micky.almaden.ibm.com. Por ejemplo, para la columna DATALINK c en la tabla t, la sentencia SELECT debera ser:
select count(*) from t where dlurlserver(t.c) = \ MICKY.ALMADEN.IBM.COM
d. Para cada columna FILE LINK CONTROL DATALINK que contiene enlaces, emita SQL UPDATE para eliminar el enlace de los valores que son enlaces con micky.almaden.ibm.com. Por ejemplo, para la columna DATALINK c en la tabla t, la sentencia UPDATE debera ser:
update t set t.c = null where dlurlserver(t.c) = \ MICKY.ALMADEN.IBM.COM
Si t.c no se puede anular, se puede utilizar lo siguiente:

update t set t.c = dlvalue() where dlurlserver(t.c) = MICKY.ALMADEN.IBM.COM
e. Comprometa SQL UPDATE:

commit
3. Emita el mandato DROP DATALINKS MANAGER:

drop datalinks manager for db test using micky.almaden.ibm.com
4. Finalice la conexin de modalidad exclusiva para hacer que los cambios sean efectivos y permitir otras conexiones con la base de datos:
terminate
5. Inicie el proceso de eliminacin de enlace y la recoleccin de basura de la informacin de copia de seguridad para TEST en micky.almaden.ibm.com. Como administrador de DB2 Data Links Manager, emita el mandato siguiente en micky.almaden.ibm.com:
dlfm drop_dlm test validate bramha.almaden.ibm.com
Esto eliminar el enlace de los archivos que todava estn enlazados a la base de datos TEST si el usuario no ha eliminado su enlace antes de invocar el paso 3. Si micky.almaden.ibm.com tiene informacin de copia de seguridad (por ejemplo, archivos archivadores, metadatos) para los archivos previamente enlazados a la base de datos TEST, este mandato
313

iniciar la recoleccin de basura de dicha informacin. Las operaciones de eliminacin de enlace y de recoleccin de basura reales se llevarn a cabo asncronamente. Ejemplo 2 Un DB2 Data Links Manager se puede desregistrar despus de haberse eliminado y se tratar como un DB2 Data Links Manager completamente nuevo. Si se siguen los pasos del Ejemplo 1 para eliminar micky.almaden.ibm.com, los enlaces con la versin antigua no existirn. De lo contrario, el usuario no recibir el error SQL0368 tal como se muestra en el paso 7 siguiente. Los pasos para desregistrar el DB2 Data Links Manager son los siguientes: 1. Registre micky.almaden.ibm.com en la base de datos TEST:
add datalinks manager for db test using node micky.almaden.ibm.com port 14578
2. Cree enlaces con los archivos en micky.almaden.ibm.com:

connect to test create table t(c1 int, c2 datalink linktype url file link control mode db2options) insert into t values(1, dlvalue(file://micky.almaden.ibm.com/pictures/yosemite.jpg)) commit terminate
3. Elimine micky.almaden.ibm.com de la base de datos TEST:

drop datalinks manager for db test using micky.almaden.ibm.com
4. Seleccione valores DATALINK:

connect to test select * from t terminate
El usuario ver:
SQL0368 The DB2 Data Links Manager "MICKY.ALMADEN.IBM.COM" no est registrado en la base de datos. SQLSTATE=55022.
5. Vuelva a registrar micky.almaden.ibm.com en la base de datos TEST:

add datalinks manager for db test using node micky.almaden.ibm.com port 14578
6. Inserte ms valores DATALINK:

connect to test insert into t values(2, dlvalue(file://micky.almaden.ibm.com/pictures/tahoe.jpg)) commit
7. Seleccione valores DATALINK:

select c2 from t where c1 = 2
314
Command Reference

Este mandato ser satisfactorio porque el valor seleccionado es un enlace con la versin registrada actualmente de micky.almaden.ibm.com. Notas de uso: Los efectos del mandato DROP DATALINKS MANAGER no se pueden retrotraer. Es importante seguir los pasos indicados en el Ejemplo 1 cuando se utiliza el mandato DROP DATALINKS MANAGER. Este mandato slo es efectivo despus de haber desconectado todas las aplicaciones de la base de datos. Cuando este mandato se completa satisfactoriamente, el mensaje DB210201I indica que no se ha realizado ningn proceso en el DB2 Data Links Manager. Antes de eliminar un DB2 Data Links Manager, asegrese de que la base de datos no tenga enlaces con archivos en dicho DB2 Data Links Manager. Si existen enlaces despus de eliminar un DB2 Data Links Manager, ejecute el programa de utilidad reconcile para eliminarlos. Esto establecer los enlaces que se pueden nulificar en NULL y los enlaces que no se pueden nulificar en un valor DATALINK de longitud cero. Cualquier fila que contenga estos valores se insertarn en la tabla de excepciones. El valor DATALINK no incluir el nombre de prefijo original, que ya no est disponible despus de eliminar el Data Link Manager. Los archivos que corresponden a enlaces entre una base de datos y un DB2 Data Links Manager eliminado permanecern en estado enlazado y sern inaccesibles para operaciones como lectura, grabacin, redenominacin, supresin, cambio de permisos o cambio de propiedad. El mandato no recoger basura de las copias archivadas de los archivos con enlaces eliminados en el DB2 Data Links Manager. Los usuarios pueden iniciar explcitamente el proceso de eliminacin de enlace y la recoleccin de basura utilizando el mandato dlfm drop_dlm en el DB2 Data Links Manager. Se recomienda realizar una copia de seguridad de base de datos antes de eliminar un DB2 Data Links Manager. Adems, asegrese de que todas las subscripciones de duplicacin hayan duplicado todos los cambios que impliquen este DB2 Data Links Manager. Si se ha realizado una copia de seguridad antes de eliminar el DB2 Data Links Manager de una base de datos y dicha imagen de copia de seguridad se utiliza para la restauracin despus de haber eliminado el DB2 Data Links Manager, el proceso de restauracin o avance puede dejar algunas tablas en estado de pendiente de reconciliacin de enlace de datos (DRP). Esto requerir la ejecucin de RECONCILE o el programa de utilidad db2_recon_aid para
315

identificar y reparar incoherencias entre la base de datos DB2 y los archivos almacenados en el Data Links Manager. Informacin relacionada: v Mandato LIST DATALINKS MANAGERS en la pgina 447 v Mandato ADD DATALINKS MANAGER en la pgina 203
316
Command Reference
DROP DBPARTITIONNUM VERIFY Mandato DROP DBPARTITIONNUM VERIFY

Verifica si existe una particin de base de datos en los grupos de particiones de base de datos de cualquier base de datos y si se ha definido un supervisor de sucesos en la particin de base de datos. Este mandato deber utilizarse antes de eliminar una particin de un sistema de base de datos particionado. mbito: Este mandato slo afecta a la particin de base de datos en la que se emite. Autorizacin: sysadm Sintaxis del mandato:
DROP DBPARTITIONNUM VERIFY
Parmetros del mandato: Ninguno Notas de uso: Si se devuelve un mensaje, indicando que la particin de base de datos no se est utilizando, use el mandato STOP DATABASE MANAGER con DROP DBPARTITIONNUM para eliminar la entrada de la particin de base de datos del archivo db2nodes.cfg, lo que elimina la particin de base de datos del sistema base de datos. Si se devuelve un mensaje, indicando que la particin de base de datos se est utilizando, se debern realizar las acciones siguientes: 1. Si la particin de base de datos contiene datos, redistribuya los datos para eliminarlos de la particin de base de datos mediante REDISTRIBUTE DATABASE PARTITION GROUP. Utilice la opcin DROP DBPARTITIONNUM en el mandato REDISTRIBUTE DATABASE PARTITION GROUP o en la sentencia ALTER DATABASE PARTITION GROUP para eliminar la particin de base de datos de cualquier grupo de particiones de base de datos para la base de datos. Esta accin debe realizarse para cada base de datos que contiene la particin de base de datos en un grupo de particiones de base de datos. 2. Elimine cualquier supervisor de sucesos que est definido en la particin de base de datos. 3. Vuelva a ejecutar DROP DBPARTITIONNUM VERIFY para asegurarse de que la base de datos ya no se est utilizando.
317
DROP DBPARTITIONNUM VERIFY

Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato STOP DATABASE MANAGER en la pgina 687 v Mandato REDISTRIBUTE DATABASE PARTITION GROUP en la pgina 591
318
Command Reference
DROP TOOLS CATALOG Mandato DROP TOOLS CATALOG

Elimina las tablas de catlogo de herramientas de DB2 para el catlogo especificado en la base de datos proporcionada. Este mandato no es vlido en un cliente db2. Aviso: Si elimina el catlogo de herramientas activo, ya no puede planificar tareas y no se ejecutan las tareas planificadas. Para activar el planificador, debe activar un catlogo de herramientas anterior o crear uno nuevo. mbito: Este mandato afecta a la base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl El usuario debe tener tambin autorizacin DASADM para actualizar los parmetros de configuracin del servidor de administracin DB2. Conexin necesaria: Este mandato establece temporalmente una conexin de base de datos durante el proceso. Sintaxis del mandato:
DROP TOOLS CATALOG nombre-catlogo IN DATABASE nombre-base-datos FORCE
Parmetros del mandato: CATALOG nombre-catlogo Nombre que se ha de utilizar para identificar exclusivamente el catlogo de herramientas de DB2. Las tablas de catlogo se eliminan de este esquema. DATABASE nombre-basedatos Nombre que se ha de utilizar para conectarse a la base de datos local que contiene las tablas de catlogo. FORCE La opcin force se utiliza para forzar la detencin del planificador del
319
DROP TOOLS CATALOG

servidor de administracin DB2. Si no se especifica, el catlogo de herramientas no se elimina si el planificador no se puede detener. Ejemplos:
db2 drop tools catalog cc in database toolsdb db2 drop tools catalog in database toolsdb force
Notas de uso: v El parmetro JDK_PATH debe establecerse en la configuracin del servidor de administracin DB2 en el nivel mnimo soportado de JDK. v Actualizar los parmetros de configuracin de admin requiere la autorizacin DASADM sobre el servidor de administracin DB2. v Este mandato inhabilitar el planificador en el servidor de administracin DB2 local y restablecer los parmetros de configuracin del servidor de administracin DB2 relativos a la configuracin de base de datos de catlogo de herramientas DB2. Para obtener ms informacin sobre el planificador, consulte el manual Administration Guide.
320
Command Reference
ECHO Mandato ECHO

Permite al usuario grabar series de caracteres en la salida estndar. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
ECHO serie-caracteres
Parmetros del mandato: serie-caracteres Cualquier serie de caracteres. Notas de uso: Si se utiliza un archivo de entrada como entrada estndar o se tienen que imprimir comentarios sin que el shell de mandato los interprete, el mandato ECHO imprimir series de caracteres directamente en la salida estndar. Se imprime una lnea cada vez que se emite ECHO. El mandato ECHO no se ve afectado por la opcin verbosa (-v).
321
EXPORT Mandato EXPORT

Exporta datos de una base de datos a uno de varios formatos de archivo externos. El usuario especifica los datos que se deben exportar proporcionando una sentencia SQL SELECT o proporcionando informacin jerrquica para tablas de tipo. Autorizacin: Una de las siguientes: v sysadm v dbadm o privilegio CONTROL o SELECT en cada tabla o vista participante. Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
EXPORT TO nombre-archivo OF tipoarchivo , LOBS TO vaacceso-lob
, LOBFILE nombre-archivo MODIFIED BY mod-tipoarchivo
, METHOD N ( nombre-columna )
MESSAGES
archivo-mensajes
sentencia-seleccin HIERARCHY STARTING nombre-subtabla lista-orden-transversal
clusula-where
lista-orden-transversal:
, ( nombre-subtabla )
322
Command Reference
EXPORT
Parmetros del mandato: HIERARCHY lista-orden-transversal Exporta una subjerarqua utilizando el orden transversal especificado. Todas las subtablas deben listarse de modo PRE-ORDER. El primer nombre de subtabla se utiliza como nombre de tabla de destino para la sentencia SELECT. HIERARCHY STARTING nombre-subtabla Mediante el uso del orden transversal por omisin (orden OUTER para archivos ASC, DEL o WSF o el orden almacenado en los archivos de datos PC/IXF), exporta una subjerarqua empezando desde nombre-subtabla. LOBFILE nombre-archivo Especifica uno o ms nombres de archivo base para los archivos LOB. Cuando se ha agotado el espacio de nombres para el primer nombre, se utiliza el segundo nombre y as sucesivamente. Cuando se crean archivos LOB durante una operacin de exportacin, los nombres de archivo se construyen aadiendo el nombre base actual de esta lista a la va de acceso actual (desde vaacceso-lob) y, a continuacin, aadiendo un nmero de secuencia de 3 dgitos. Por ejemplo, si la va de acceso LOB actual es el directorio /u/foo/lob/vaacceso y el nombre de archivo LOB actual es bar, los archivos LOB creados sern /u/foo/lob/vaacceso/bar.001, /u/foo/lob/vaacceso/bar.002, etc. LOBS TO vaacceso-lob Especifica una o ms vas de acceso a los directorios en los que deben almacenarse los archivos LOB. Habr por lo menos un archivo por va de acceso de LOB y cada archivo contendr por lo menos un LOB. MESSAGES archivo-mensajes Especifica el destino para los mensajes de aviso y error que se producen durante una operacin de exportacin. Si el archivo ya existe, el programa de utilidad de exportacin aade la informacin. Si se omite archivo-mensajes, los mensajes se graban en la salida estndar. METHOD N nombre-columna Especifica uno o ms nombres de columna que se deben utilizar en el archivo de salida. Si no se especifica este parmetro, se utilizan los nombres de columna de la tabla. Este parmetro slo es vlido para archivos WSF e IXF, pero no es vlido al exportar datos jerrquicos. MODIFIED BY mod-tipoarchivo Especifica opciones adicionales (consulte la Tabla 6 en la pgina 328).
323
EXPORT
OF tipoarchivo Especifica el formato de los datos del archivo de salida: v DEL (formato ASCII delimitado), utilizado por diversos programas gestores de bases de datos y gestores de archivos. v WSF (formato de hoja de trabajo), utilizado por programas tales como: Lotus 1-2-3 Lotus Symphony Nota: Al exportar datos BIGINT o DECIMAL, slo se pueden exportar de forma precisa los valores que estn en el rango de tipo DOUBLE. Aunque los valores que no estn en este rango tambin se exportan, si se vuelven a importar o a cargar de dichos valores, los datos resultantes pueden ser incorrectos en funcin del sistema operativo. v IXF (formato de intercambio integrado, versin PC), en el que la mayora de los atributos de tabla, as como cualquier ndice existente, se guardan en el archivo IXF, excepto cuando se especifican columnas en la sentencia SELECT. Con este formato, se puede volver a crear la tabla, mientras que con los dems formatos de archivo, la tabla ya tiene que existir para que se puedan importar datos a la misma. sentencia-seleccin Especifica la sentencia SELECT que devolver los datos que se deben exportar. Si la sentencia SELECT causa un error, se grabar un mensaje en el archivo de mensajes (o en la salida estndar). Si el cdigo de error es uno de SQL0012W, SQL0347W, SQL0360W, SQL0437W o SQL1824W, la operacin de exportacin continuar; de lo contrario, se detendr. TO nombre-archivo Especifica el nombre del archivo al que deben exportarse datos. Si no se especifica la va de acceso completa al archivo, el programa de utilidad de exportacin utilizar el directorio actual y la unidad por omisin como destino. Si se especifica el nombre de un archivo que ya existe, el programa de utilidad de exportacin grabar encima del contenido del archivo; no aadir la informacin. Ejemplos: El siguiente ejemplo muestra cmo exportar informacin de la tabla STAFF de la base de datos SAMPLE al archivo myfile.ixf. La salida estar en formato IXF. Tenga en cuenta que debe estar conectado a la base de datos SAMPLE
324
Command Reference
EXPORT
antes de emitir el mandato. Las definiciones de ndice (si las hay) se almacenarn en el archivo de salida, salvo cuando la conexin a la base de datos se realice mediante DB2 Connect.
db2 export to myfile.ixf of ixf messages msgs.txt select * from staff
El siguiente ejemplo muestra cmo exportar la informacin acerca de los empleados del Departamento 20 de la tabla STAFF de la base de datos SAMPLE. La salida estar en formato IXF e ir al archivo awards.ixf. Tenga en cuenta que debe conectarse primero a la base de datos SAMPLE antes de emitir el mandato. Tenga asimismo en cuenta que el nombre de columna real en la tabla es dept en lugar de departamento.
db2 export to awards.ixf of ixf messages msgs.txt select * from staff where dept = 20
El ejemplo siguiente muestra cmo exportar los LOB a un archivo DEL:

db2 export to myfile.del of del lobs to mylobs lobfile lobs1, lobs2 modified by lobsinfile select * from emp_photo
El ejemplo siguiente muestra cmo exportar los LOB a un archivo DEL, especificando un segundo directorio para los archivos que no quepan en el primer directorio:
db2 export to myfile.del of del lobs to /db2exp1, /db2exp2 modified by lobsinfile select * from emp_photo
El ejemplo siguiente muestra cmo exportar datos a un archivo DEL, utilizando comillas simples como delimitador de serie, un punto y coma como delimitador de columna y una coma como coma decimal. Se deber utilizar el mismo convenio al volver a importar los datos a la base de datos:
db2 export to myfile.del of del modified by chardel coldel; decpt, select * from staff
Notas de uso: Asegrese de completar todas las operaciones de tabla y de liberar todos los bloqueos antes de iniciar una operacin de exportacin. Esto puede realizarse emitiendo un COMMIT despus de cerrar todos los cursores abiertos WITH HOLD o emitiendo un ROLLBACK. Se pueden utilizar alias de tabla en la sentencia SELECT. Los mensajes colocados en el archivo de mensajes incluyen la informacin devuelta del servicio de recuperacin de mensajes. Cada mensaje empieza en una lnea nueva.
325
EXPORT
El programa de utilidad de exportacin produce un mensaje de aviso siempre que se selecciona una columna de caracteres con una longitud de ms de 254 para la exportacin a archivos de formato DEL. Se deber utilizar la importacin PC/IXF para mover datos entre bases de datos. Si los datos de tipo carcter que contienen separadores de filas se exportan a un archivo ASCII delimitado (DEL) y se procesan con un programa de transferencia de texto, los campos que contienen los separadores de filas se reducirn o se expandirn. El paso de copia de archivo no es necesario si se puede acceder a las bases de datos de origen y destino desde el mismo cliente. Se puede utilizar DB2 Connect para exportar tablas de servidores DRDA, por ejemplo DB2 para OS/390, DB2 para VM y VSE y DB2 para OS/400. Slo se soporta la exportacin PC/IXF. El programa de utilidad de exportacin no crear archivos PC/IXF de mltiples partes cuando se invoque desde un sistema AIX. El programa de utilidad de exportacin almacenar el atributo NOT NULL WITH DEFAULT de la tabla en un archivo IXF si la sentencia SELECT proporcionada est en el formato SELECT * FROM nombretabla. Cuando se exportan tablas de tipo, slo se pueden expresar sentencias de subseleccin especificando el nombre de tabla de destino y la clusula WHERE. La seleccin completa y la sentencia-seleccin no se pueden especificar cuando se exporta una jerarqua. Para formatos de archivos distintos de IXF, se recomienda especificar la lista de orden transversal porque indica a DB2 cmo atravesar la jerarqua y qu subtablas se deben exportar. Si no se especifica dicha lista, se exportan todas las tablas de la jerarqua y el orden por omisin es el orden de OUTER. La alternativa consiste en utilizar el orden por omisin, que es el orden proporcionado por la funcin OUTER. Nota: Utilice el mismo orden transversal durante una operacin de importacin. El programa de utilidad de carga no soporta la carga de jerarquas o de subjerarquas. Consideraciones acerca de DB2 Data Links Manager Para asegurarse de que se copian para la exportacin una copia coherente de la tabla y los archivos correspondientes a los que hacen referencia las columnas DATALINK, efecte lo siguiente:
326
Command Reference
EXPORT
1. Emita el mandato: QUIESCE TABLESPACES FOR TABLE nombretabla SHARE. Esto asegura que no hay ninguna transaccin de actualizacin en proceso cuando se ejecuta EXPORT. 2. Emita el mandato EXPORT. 3. Ejecute el programa de utilidad dlfm_export en cada servidor Data Links. La entrada en el programa de utilidad dlfm_export es el nombre de archivo de control, que genera el programa de utilidad de exportacin. Esto produce un archivador tar (o equivalente) de los archivos listados dentro del archivo de control. Para Distributed File Systems (DFS), el programa de utilidad dlfm_export obtendr las credenciales raz de red DCE antes de archivar los archivos listados en el archivo de control. dlfm_export no captura la informacin de ACL de los archivos que se han archivado. 4. Emita el mandato: QUIESCE TABLESPACES FOR TABLE nombretabla RESET. Esto deja la tabla disponible para las actualizaciones. EXPORT se ejecuta como una aplicacin SQL. Las filas y columnas que satisfacen las condiciones de la sentencia SELECT se extraen de la base de datos. Para las columnas DATALINK, la sentencia SELECT no deber especificar ninguna funcin escalar. La ejecucin satisfactoria de EXPORT hace que se generen los archivos siguientes: v Un archivo de datos de exportacin como se ha especificado en el mandato EXPORT. Un valor de la columna DATALINK de este archivo tiene el mismo formato que el que utilizan los programas de utilidad IMPORT y LOAD. Cuando el valor de columna DATALINK es el valor SQL NULL, el manejo es el mismo que para otros tipos de datos. v Archivos de control nombre_servidor, generados para cada servidor de Data Links. En los sistemas operativos Windows, todos los servidores de Data Links utilizan un solo archivo de control, ctrlfile.lst. Para DFS, existe un archivo de control para cada clula. Estos archivos de control se colocan en el directorio <va acceso archivo-datos>/dlfm/AAAAMMDD/HHMMSS (en el sistema operativo Windows NT, ctrlfile.lst se coloca en el directorio <va acceso archivo-datos>\dlfm\AAAAMMDD\HHMMSS). AAAAMMDD representa la fecha (ao mes da) y HHMMSS representa la hora (hora minutos segundos). El programa de utilidad dlfm_export se proporciona para exportar archivos desde un servidor Data Links. Este programa de utilidad genera un archivo archivador, que se puede utilizar para restaurar archivos en el servidor Data Links de destino.
327
EXPORT
Tabla 6. Modificadores de tipo de archivo vlidos (Exportacin) Modificador Descripcin Todos los formatos de archivo lobsinfile vaacceso-lob especifica la va de acceso a los archivos que contienen datos de LOB. Cada va de acceso contiene por lo menos un archivo que contiene por lo menos un LOB al que apunta un Especificador de ubicacin de LOB (LLS) en el archivo de datos. El LLS es una representacin de serie de la ubicacin de un LOB en un archivo almacenado en la va de acceso del archivo LOB. El formato de un LLS es nombarch.ext.nnn.mmm/, donde nombarch.ext es el nombre del archivo que contiene el LOB, nnn es el desplazamiento en bytes del LOB dentro del archivo y mmm es la longitud del LOB en bytes. Por ejemplo, si la serie db2exp.001.123.456/ est almacenada en el archivo de datos, el LOB est ubicado en el desplazamiento 123 del archivo db2exp.001 y tiene una longitud de 456 bytes. Para indicar un LOB nulo, entre el tamao como -1. Si el tamao se especifica como 0, se trata como un LOB de longitud 0. Para los LOB nulos de longitud -1, se pasan por alto el desplazamiento y el nombre de archivo. Por ejemplo, el LLS de un LOB nulo puede ser db2exp.001.7.-1/. Formato de archivo DEL (ASCII delimitado) chardelx x es un delimitador de serie de un solo carcter. El valor por omisin son las comillas dobles ("). El carcter especificado se utiliza en lugar de las comillas para encerrar una serie de caracteres.a Si desea especificar explcitamente las comillas como delimitador de serie de caracteres, debe especificarse de la manera siguiente: modified by chardel"" Tambin se pueden especificar las comillas simples (') como delimitador de serie de caracteres del modo siguiente: modified by chardel''
328
Command Reference
EXPORT
Tabla 6. Modificadores de tipo de archivo vlidos (Exportacin) (continuacin) Modificador codepage=x Descripcin x es una serie de caracteres ASCII. El valor se interpreta como la pgina de cdigos de los datos del archivo de salida. Convierte los datos de tipo carcter a esta pgina de cdigos desde la pgina de cdigos de la aplicacin durante la operacin de exportacin. Para DBCS (grfico) puro, DBCS mixto y EUC, los delimitadores estn restringidos al rango de x00 a x3F, inclusive. Nota: El modificador CODEPAGE no se puede utilizar con el modificador LOBSINFILE. coldelx x es un delimitador de columna de un solo carcter. El valor por omisin es una coma (,). Se utiliza el carcter especificado en lugar de una coma para indicar el final de una columna.a En el ejemplo siguiente, coldel; hace que el programa de utilidad de exportacin interprete cualquier punto y coma (;) que encuentra como un delimitador de columna: db2 "export to temp of del modified by coldel; select * from staff where dept = 20" datesiso decplusblank Formato de fecha. Hace que todos los valores de datos de fecha se exporten en formato ISO (AAAA-MM-DD).b Carcter de signo ms. Hace que a los valores decimales positivos se les ponga un espacio en blanco como prefijo en lugar de un signo ms (+). La accin por omisin es poner a los valores decimales positivos un signo ms como prefijo. x es un sustituto de un solo carcter del punto como carcter de coma decimal. El valor por omisin es un punto (.). Se utiliza el carcter especificado en lugar de un punto como carcter de coma decimal.a x es un delimitador DATALINK de un solo carcter. El valor por omisin es un punto y coma (;). Se utiliza el carcter especificado en lugar de un punto y coma como separador entre campos para un valor DATALINK. Es necesario porque un valor DATALINK puede tener ms de un subvalor. a Nota: x no debe ser el mismo carcter especificado como delimitador de serie de caracteres, de columna o de fila. Suprime el reconocimiento de los delimitadores de caracteres dobles. Para obtener ms informacin, consulte el apartado Restricciones de los delimitadores en la pgina 330.
decptx
dldelx
nodoubledel
329
EXPORT
Tabla 6. Modificadores de tipo de archivo vlidos (Exportacin) (continuacin) Modificador Descripcin Formato de archivo WSF 1 Crea un archivo WSF que es compatible con Lotus 1-2-3 Release 1 o Lotus 1-2-3 Release 1a.c ste es el valor por omisin. Crea un archivo WSF que es compatible con Lotus Symphony Release 1.0.c Crea un archivo WSF que es compatible con Lotus 1-2-3 Versin 2 o Lotus Symphony Release 1.1.c Crea un archivo WSF que contiene caracteres DBCS.
2 3 4 Notas:
1. El programa de utilidad de exportacin no emite ningn aviso si se intentan utilizar tipos de archivo no soportados con la opcin MODIFIED BY. Si se intenta realizar dicha accin, la operacin de exportacin falla y se devuelve un cdigo de error. 2. El apartado Restricciones de los delimitadores lista las restricciones que se aplican a los caracteres que se pueden utilizar como caracteres de alteracin temporal de los delimitadores.
b a
3.
El programa de utilidad de exportacin graba normalmente los
v datos de fecha en formato AAAAMMDD v datos char(fecha) en formato AAAA-MM-DD v datos de hora en formato HH.MM.SS v datos de indicacin de fecha y hora en formato AAAA-MM-DDHH.MM.SS.uuuuuu Los datos contenidos en cualquier columna de fecha y hora especificada en la sentencia SELECT para la operacin de exportacin tambin tendrn estos formatos. 4. Estos archivos tambin pueden dirigirse a un producto determinado especificando una L para Lotus 1-2-3 o una S para Symphony en la serie de parmetros mod-tipoarchivo. Slo se puede especificar un valor o indicador de producto.
c
Restricciones de los delimitadores

Es responsabilidad del usuario asegurarse de que el carcter delimitador elegido no forma parte de los datos que se deben mover. En el caso de formar parte de dichos datos, se pueden producir errores inesperados. Se aplican las restricciones siguientes a los delimitadores de columna, serie, DATALINK y coma decimal al mover datos: v Los delimitadores se excluyen mutuamente.
330
Command Reference
EXPORT
v Un delimitador no puede ser cero binario, un carcter de salto de lnea, un retorno de carro o un espacio en blanco. v El punto (.), que es la coma decimal por omisin, no puede ser un delimitador de serie. v Una pgina de cdigos de la familia ASCII y una pgina de cdigos de la familia EBCDIC especifican de forma diferente los caracteres siguientes: El carcter de desplazamiento a teclado estndar (0x0F) y el carcter de desplazamiento a teclado ideogrfico (0x0E) no pueden ser delimitadores para un archivo de datos EBCDIC MBCS. Los delimitadores para las pginas de cdigos MBCS, EUC o DBCS no pueden ser mayores que 0x40, excepto la coma decimal por omisin para datos EBCDIC MBCS, que es el punto, 0x4b. Los delimitadores por omisin para archivos de datos de las pginas de cdigos ASCII o de las pginas de cdigos EBCDIC MBCS son:
" (0x22, comillas dobles; delimitador de serie) , (0x2c, coma; delimitador de columna)
Los delimitadores por omisin para archivos de datos de las pginas de cdigos EBCDIC SBCS son:
" (0x7F, comillas dobles; delimitador de serie) , (0x6B, coma; delimitador de columna)
La coma decimal por omisin para archivos de datos ASCII es 0x2e (punto). La coma decimal por omisin para archivos de datos EBCDIC es 0x4B (punto). Si la pgina de cdigos del servidor es diferente de la pgina de cdigos del cliente, se recomienda especificar la representacin hex de delimitadores que no sean valores por omisin. Por ejemplo,
db2 load from ... modified by chardel0x0C coldelX1e ...
La informacin siguiente acerca del soporte para el reconocimiento de delimitadores de caracteres dobles en los archivos DEL se aplica a los programas de utilidad de exportacin, importacin y carga: v Se permiten delimitadores de caracteres dentro de los campos basados en caracteres de un archivo DEL. Esto se aplica a campos de tipo CHAR, VARCHAR, LONG VARCHAR o CLOB (excepto cuando se especifica lobsinfile). Cualquier par de delimitadores de caracteres que se encuentre entre los delimitadores de caracteres que los encierran se importa o se carga en la base de datos. Por ejemplo,
"Es un ""hermoso"" da"
se importar como:
Es un "hermoso" da
331
EXPORT
En el caso de la exportacin, la norma se aplica a la inversa. Por ejemplo,
Mide 6" de altura.
se exportar a un archivo DEL como:

"Mide 6"" de altura."
v En un entorno DBCS, no se soporta el delimitador de carcter de rea de interconexin (|). Conceptos relacionados: v Export Overview del manual Data Movement Utilities Guide and Reference
332
Command Reference
FORCE APPLICATION Mandato FORCE APPLICATION

Fuerza a las aplicaciones o los usuarios locales o remotos a salir del sistema para permitir el mantenimiento en un servidor. Atencin: Si se fuerza una operacin que no se puede interrumpir (por ejemplo RESTORE DATABASE), se deber volver a ejecutar satisfactoriamente la operacin para que la base de datos quede disponible. mbito: Este mandato afecta a todas las particiones de base de datos que se listan en el archivo $HOME/sqllib/db2nodes.cfg. En un entorno de bases de datos particionado, este mandato no tiene que emitirse desde la particin de base de datos coordinadora de la aplicacin que se est forzando. Puede emitirse desde cualquier nodo (servidor de particiones de base de datos) del entorno de bases de datos particionado. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Instancia. Para forzar a los usuarios a salir de un servidor remoto, primero es necesario conectarse a dicho servidor. Si no existe ninguna conexin, este mandato se ejecuta localmente. Sintaxis del mandato:
FORCE APPLICATION ALL , ( manejador-aplicaciones ) MODE ASYNC
Parmetros del mandato: APPLICATION ALL Se desconectarn todas las aplicaciones de la base de datos.
manejador-aplicaciones Especifica el agente que se debe terminar. Liste los valores mediante el mandato LIST APPLICATIONS.
333
FORCE APPLICATION
MODE ASYNC El mandato no espera a que todos los usuarios especificados terminen para volver; vuelve tan pronto como se ha emitido satisfactoriamente la funcin o se ha descubierto un error (por ejemplo sintaxis no vlida). sta es la nica modalidad que se soporta actualmente. Ejemplos: El ejemplo siguiente fuerza a dos usuarios, con valores de manejador-aplicaciones de 41408 y 55458, a desconectarse de la base de datos:
db2 force application ( 41408, 55458 )
Notas de uso: No se puede ejecutar db2stop durante una operacin de forzar. El gestor de bases de datos permanece activo para que las operaciones de gestor de bases de datos subsiguientes puedan manejarse sin necesidad de ejecutar db2start. Para conservar la integridad de la base de datos, slo se pueden interrumpir los usuarios que estn desocupados o que estn ejecutando operaciones de base de datos que se pueden interrumpir. No se puede forzar a salir a los usuarios que estn creando una base de datos. Despus de haber emitido un FORCE, la base de datos seguir aceptando peticiones de conexin. Pueden ser necesarias operaciones de forzar adicionales para forzar a salir completamente a todos los usuarios. Informacin relacionada: v Mandato LIST APPLICATIONS en la pgina 435 v Mandato ATTACH en la pgina 211
334
Command Reference
GET ADMIN CONFIGURATION Mandato GET ADMIN CONFIGURATION

Devuelve los valores de los parmetros de configuracin individuales del Servidor de administracin DB2 (DAS) en el nodo administrativo del sistema. El DAS es una herramienta administrativa especial que permite la administracin remota de servidores DB2. Para obtener una lista de los parmetros de configuracin de DAS, vea la descripcin del mandato UPDATE ADMIN CONFIGURATION. mbito: Este mandato devuelve informacin acerca de los parmetros de configuracin de DAS en el nodo administrativo del sistema al que est conectado o que se especifica en la opcin FOR NODE. Autorizacin: Ninguna Conexin necesaria: Nodo. Para visualizar la configuracin de DAS para un sistema remoto, conctese primero a ese sistema o utilice la opcin FOR NODE para especificar el nodo administrativo del sistema. Sintaxis del mandato:
GET ADMIN CONFIGURATION CONFIG CFG
FOR NODE
nombre-nodo USER nombreusuario USING contrasea
Parmetros del mandato: FOR NODE Entre el nombre del nodo administrativo para ver los parmetros de configuracin de DAS en el mismo. USER nombreusuario USING contrasea Si la conexin al nodo requiere un nombre de usuario y una contrasea, entre esta informacin.
335
GET ADMIN CONFIGURATION

Ejemplos: A continuacin se muestra un ejemplo de salida de GET ADMIN CONFIGURATION:
Configuracin servidor administracin DAS de tipo de autentificacin Nombre grupo autorizacin admin. DAS Modalidad de Discovery de DAS Nombre del sistema servidor DB2 Va instalacin Java Development Kit DAS Pgina de cdigos de DAS Territorio de DAS (AUTHENTICATION) = SERVER_ENCRYPT (DASADM_GROUP) = ADMINISTRATORS (DISCOVER) = SEARCH (DB2SYSTEM) = swalkty (JDK_PATH) = e:\sqllib\java\jdk
(DAS_CODEPAGE) = 0 (DAS_TERRITORY) = 0 hostA.ibm.ca NO ON smtp1.ibm.ca CCMD DB2 TOOLSCAT db2admin
Ubicacin de lista de contactos (CONTACT_HOST) = Ejecutar tareas caducadas (EXEC_EXP_TASK) = Modalidad de planificador (SCHED_ENABLE) = Servidor SMTP (SMTP_SERVER) = Base datos catlogo herramientas (TOOLSCAT_DB) = Instancia base datos catlogo herram. (TOOLSCAT_INST) = Esquema base datos catlogo herram. (TOOLSCAT_SCHEMA) = ID de usuario de planificador =
Notas de uso: Si se produce un error, la informacin devuelva no es vlida. Si el archivo de configuracin no es vlido, se devuelve un mensaje de error. El usuario debe instalar otra vez el DAS para recuperarse. Para establecer los parmetros de configuracin en los valores por omisin enviados con el DAS, utilice el mandato RESET ADMIN CONFIGURATION. Informacin relacionada: v Mandato RESET ADMIN CONFIGURATION en la pgina 623 v Mandato UPDATE ADMIN CONFIGURATION en la pgina 704
336
Command Reference
GET ALERT CONFIGURATION Mandato GET ALERT CONFIGURATION

Devuelve los valores de configuracin de alerta para los indicadores de salud correspondientes a una instancia determinada. Autorizacin: Ninguna. Conexin necesaria: Instancia. No se necesita una conexin explcita. Sintaxis del mandato:
GET ALERT CONFIGURATION CONFIG CFG FOR
DATABASE MANAGER DB MANAGER DBM DATABASES CONTAINERS TABLESPACES DATABASE TABLESPACE nombre CONTAINER nombre FOR
DEFAULT
ON alias basedatos id-espaciotabla
, USING nombre indicador salud
Parmetros del mandato: DATABASE MANAGER Recupera valores de alerta para el gestor de bases de datos. DATABASES Recupera valores de alerta para todas las bases de datos gestionadas por el gestor de bases de datos. stos son los valores que se aplican a todas las bases de datos que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula DATABASE ON alias basedatos. CONTAINERS Recupera valores de alerta para todos los contenedores de espacio de tabla gestionados por el gestor de bases de datos. stos son los valores que se aplican a todos los contenedores de espacio de tabla
337
GET ALERT CONFIGURATION

que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula CONTAINER nombre ON alias basedatos. TABLESPACES Recupera valores de alerta para todos los espacios de tabla gestionados por el gestor de bases de datos. stos son los valores que se aplican a todos los espacios de tabla que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula TABLESPACE nombre ON alias basedatos. DEFAULT Especifica que se deben recuperar los valores por omisin de instalacin. DATABASE ON alias basedatos Recupera los valores de alerta para la base de datos especificada utilizando la clusula ON alias basedatos. Si esta base de datos no tiene valores personalizados, se devolvern los valores para todas las bases de datos para la instancia, lo que es equivalente al uso del parmetro DATABASES. CONTAINER nombre FOR ID-espaciotabla ON alias basedatos Recupera los valores de alerta para el contenedor de espacio de tabla denominado nombre, para el espacio de tabla especificado utilizando la clusula FOR ID espaciotabla, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este contenedor de espacio de tabla no tiene valores personalizados, se devolvern los valores para todos los contenedores de espacio de tabla para la base de datos, que equivale a utilizar el parmetro CONTAINERS. TABLESPACE nombre ON alias basedatos Recupera los valores de alerta para el espacio de tabla denominado nombre, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este espacio de tabla no tiene valores personalizados, se devolvern los valores para todos los espacios de tabla, lo que equivale a utilizar el parmetro TABLESPACES. USING nombre indicador salud Especifica el conjunto de indicadores de salud para los que se devolver la configuracin de alerta. Los nombres de indicador de salud se componen de un identificador de objeto de dos letras, seguido de un nombre que describe lo que mide el indicador. Por ejemplo: db.sort_privmem_util. sta es una clusula opcional, lo que quiere decir que si no se utiliza, se devolvern todos los indicadores de salud para el objeto o el tipo de objeto especificado. Ejemplos:
338
Command Reference
GET ALERT CONFIGURATION

GET ALERT CFG FOR DBM
Nombre de indicador Aviso Alarma Confidencialidad Frmula Acciones Comprobacin umbral o estado Nombre de va de script Tipo Directorio de trabajo Carcter de terminacin ID de usuario Nombre de indicador Aviso Alarma Confidencialidad Frmula Acciones Comprobacin umbral o estado Nombre de tarea Nombre de va de script Tipo Directorio de trabajo Carcter de terminacin ID de usuario Nombre de va de script Tipo Directorio de trabajo Parmetros lnea de mandatos ID de usuario = = = = = = = = = = = = = = = = = = = db2.db2_op_status 0 0 0 db2.db2_status Habilitado Habilitado /home/henryc/backup DB2 /home/henryc/new/ @ henryc db2.sort_privmem_util 90 10 5 (db2.sort_heap_allocated / sheapthres) * 100 Habilitado Inhabilitado
= /home/richardp/cleanup = = = = = = = = = = /home/bob/reorg1 DB2 /home/bob/ ; bobp /home/alan/cleanup OS /home/alan/tasks/ -c cache -p 80 -z /tmp/output johnh
339
GET AUTHORIZATIONS Mandato GET AUTHORIZATIONS

Informa sobre las autorizaciones del usuario actual a partir de los valores encontrados en el archivo de configuracin de base de datos y la vista de catlogo del sistema de autorizacin (SYSCAT.DBAUTH). Autorizacin: Ninguna Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin a la base de datos por omisin. Sintaxis del mandato:
GET AUTHORIZATIONS
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida de GET AUTHORIZATIONS:
Autorizaciones de administracin para el usuario actual Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin Autorizacin SYSADM directa SYSCTRL directa SYSMAINT directa DBADM directa CREATETAB directa BINDADD directa CONNECT directa CREATE_NOT_FENC directa IMPLICIT_SCHEMA directa LOAD directa SYSADM indirecta SYSCTRL indirecta SYSMAINT indirecta DBADM indirecta CREATETAB indirecta BINDADD indirecta CONNECT indirecta CREATE_NOT_FENC indirecta IMPLICIT_SCHEMA indirecta LOAD indirecta = = = = = = = = = = = = = = = = = = = = NO NO NO YES YES YES YES YES YES YES YES NO NO NO YES YES YES NO YES NO
340
Command Reference
GET AUTHORIZATIONS
Notas de uso: Las autorizaciones directas las adquieren los mandatos explcitos que otorgan las autorizaciones a un ID de usuario. Las autorizaciones indirectas se basan en autorizaciones adquiridas por los grupos a los que pertenece un usuario. Nota: PUBLIC es un grupo especial al que pertenecen todos los usuarios.
341
GET CLI CONFIGURATION Mandato GET CLI CONFIGURATION

Lista el contenido del archivo db2cli.ini. Este mandato puede listar el archivo entero o una seccin especificada. El archivo db2cli.ini se utiliza como archivo de configuracin de interfaz de nivel de llamada (CLI) de DB2. Contiene varias palabras clave y valores que se pueden utilizar para modificar el comportamiento de la CLI de DB2 y de las aplicaciones que la utilizan. El archivo est dividido en secciones, cada una de las cuales corresponde a un nombre de alias de base de datos. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
GET CLI CONFIGURATION CONFIG CFG AT GLOBAL LEVEL
FOR SECTION nombre-seccin
Parmetros del mandato: AT GLOBAL LEVEL Visualiza los parmetros de configuracin de CLI por omisin en el directorio LDAP. Nota: Este parmetro slo es vlido en los sistemas operativos Windows. FOR SECTION nombre-seccin Nombre de la seccin cuyas palabras clave deben listarse. Si no se especifica, se listan todas las secciones. Ejemplos: La salida de ejemplo siguiente representa el contenido de un archivo db2cli.ini que tiene dos secciones:
342
Command Reference
GET CLI CONFIGURATION

[tstcli1x] uid=idusuario pwd=contrasea autocommit=0 TableType="TABLE,VIEW,SYSTEM TABLE" [tstcli2x] SchemaList="OWNER1,OWNER2,CURRENT SQLID"
Notas de uso: El nombre de seccin especificado en este mandato no es sensible a las maysculas y minsculas. Por ejemplo, si el nombre de seccin del archivo db2cli.ini (delimitado por corchetes) est en minsculas y el nombre de seccin especificado en el mandato est en maysculas, se listar la seccin correcta. El valor de la palabra clave PWD (contrasea) no se lista nunca; en su lugar, aparecen cinco asteriscos (*****). Cuando se habilita el LDAP (Lightweight Directory Access Protocol), los parmetros de configuracin de CLI pueden establecerse a nivel de usuario, adems del nivel de mquina. La configuracin de CLI a nivel de usuario se mantiene en el directorio LDAP. Si la seccin especificada existe a nivel de usuario, se devuelve la configuracin de CLI para dicha seccin a nivel de usuario; de lo contrario, se devuelve la configuracin de CLI a nivel de mquina. La configuracin de CLI a nivel de usuario se mantiene en el directorio LDAP y se almacena en la antememoria de la mquina local. Al leer la configuracin de CLI a nivel de usuario, DB2 lee siempre en la antememoria. La antememoria se renueva cuando: v El usuario actualiza la configuracin de CLI. v El usuario fuerza explcitamente una renovacin de la configuracin de CLI utilizando el mandato REFRESH LDAP. En un entorno de LDAP, los usuarios pueden configurar un conjunto de valores CLI por omisin para una base de datos catalogada en el directorio LDAP. Cuando se aade una base de datos LDAP catalogada como Nombre de fuente de datos (Data Source Name - DSN), utilizando el Asistente de configuracin de cliente (Client Configuration Assistant - CCA) o el programa de utilidad de configuracin CLI/ODBC, se configurarn los valores CLI por omisin, si existen en el directorio LDAP, para dicho DSN en la mquina local. Se deber especificar la clusula AT GLOBAL LEVEL para visualizar los valores CLI por omisin.
343
GET CLI CONFIGURATION

Informacin relacionada: v Mandato UPDATE CLI CONFIGURATION en la pgina 712 v Mandato REFRESH LDAP en la pgina 596
344
Command Reference
GET CONNECTION STATE Mandato GET CONNECTION STATE

Visualiza el estado de la conexin. Los estados posibles son: v Conectable y conectado. v Conectable y no conectado. v No conectable y conectado. v Conectable implcitamente (si la conexin implcita se encuentra disponible). Este mandato tambin devuelve informacin acerca de la modalidad de conexin de la base de datos (SHARE o EXCLUSIVE) as como el alias y el nombre de la base de datos con la que existe una conexin (si existe alguna). Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
GET CONNECTION STATE
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra una salida de ejemplo de GET CONNECTION STATE:
Estado de conexin con base de datos Estado conexin Modalidad de conexin Alias base datos local Nombre de base de datos = = = = Conectable y conectado SHARE SAMPLE SAMPLE
Notas de uso: Este mandato no se aplica a conexiones de tipo 2. Informacin relacionada: v Mandato SET CLIENT en la pgina 669
345
GET CONTACTGROUP Mandato GET CONTACTGROUP

Devuelve los contactos incluidos en un solo grupo de contactos definido en el sistema local. Un contacto es un usuario al que el Planificador y el Supervisor de salud envan mensajes. Se crean grupos con nombre de los contactos con el mandato ADD CONTACTGROUP. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Slo en ejecucin local: este mandato no se puede utilizar con una conexin remota. Sintaxis del mandato:
GET CONTACTGROUP nombre
Parmetros del mandato: CONTACTGROUP nombre Nombre del grupo para el que desea recuperar los contactos. Ejemplos: GET CONTACTGROUP soporte
Descripcin ------------Unidad de soporte broadloom Foo Widgets Nombre ------------joe soporte joline Tipo -------------contacto grupo contactos contacto
346
Command Reference
GET CONTACTGROUPS Mandato GET CONTACTGROUPS

El mandato proporciona una lista de grupos de contactos, que pueden estar definidos localmente en el sistema o en una lista global. Un grupo de contacto es una lista de direcciones a los que los procesos de supervisin, tales como el Planificador y el Supervisor de salud, pueden enviar mensajes. El valor del parmetro de configuracin contact_host del Servidor de administracin de bases de datos (DAS) determina si la lista es local o global. Se crean grupos con nombre de los contactos con el mandato ADD CONTACTGROUP. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
GET CONTACTGROUPS
Parmetros del mandato: Ninguno Ejemplos: En el ejemplo siguiente, se emite el mandato GET CONTACTGROUPS. El resultado es el siguiente:
Nombre --------soporte service Descripcin -------------Unidad de soporte broadloom Foo Widgets Unidad de servicio y soporte Foo Widgets
347
GET CONTACTS Mandato GET CONTACTS

Devuelve la lista de contactos definida en el sistema local. Los contactos son usuarios a los que procesos de supervisin tales como el Planificador y el Supervisor de salud envan notificaciones o mensajes. Para crear un contacto, utilice el mandato ADD CONTACT. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
GET CONTACTS
Ejemplos: GET CONTACTS

Nombre --------jos julieta juan Tipo ----------correo-e correo-e buscap Direccin ---------juan@algunsitio.com julieta@otrositio.com juan@transmit.org Long. pg. mx. --------------50
Descripcin -----------------------Soporte 24x7
348
Command Reference
GET DATABASE CONFIGURATION Mandato GET DATABASE CONFIGURATION

Devuelve los valores de entradas individuales de un archivo de configuracin de base de datos especfico. mbito: Este mandato slo devuelve informacin para la particin en la que se ejecuta. Autorizacin: Ninguna Conexin necesaria: Instancia. Una conexin explcita no es necesaria, pero se necesita una conexin con la base de datos al utilizar la clusula SHOW DETAIL. Si la base de datos est listada como remota, se establece una conexin de instancia al nodo remoto durante el tiempo que dura el mandato. Sintaxis del mandato:
GET DATABASE DB CONFIGURATION CONFIG CFG FOR alias-base-datos
SHOW DETAIL
Parmetros del mandato: FOR alias-base-datos Especifica el alias de la base de datos cuya configuracin debe visualizarse. No es necesario que especifique el alias si ya existe una conexin con la base de datos. SHOW DETAIL Visualiza informacin detallada que muestre el valor actual de los parmetros de configuracin de base de datos, as como el valor de los parmetros la prxima vez que se active la base de datos. Esta opcin permite ver el resultado de cambios dinmicos en los parmetros de configuracin.
349
GET DATABASE CONFIGURATION

Ejemplos: Notas: 1. La salida en plataformas diferentes puede mostrar pequeas variaciones que reflejan los parmetros especficos de plataforma. 2. Los parmetros con palabras clave entre parntesis pueden cambiarse utilizando el mandato UPDATE DATABASE CONFIGURATION. 3. Los campos que no contienen palabras clave los mantiene el gestor de bases de datos y no se pueden actualizar. A continuacin se muestra un ejemplo de salida de GET DATABASE CONFIGURATION (emitido en AIX):
Configuracin base de datos para base de datos mickv7 Nivel de release de configuracin de base de datos Nivel release de base de datos Territorio de base de datos Pgina de cdigos de la base de datos Conjunto de cdigos de base de datos Cdigo de territorio de base de datos Gestin de consultas SQL dinmicas = 0x0a00 = 0x0a00 = US = 819 = ISO8859-1 = 1 (DYN_QUERY_MGMT) = DISABLE
Nombre de objeto del directorio (DIR_OBJ_NAME) = Soporte de Discovery para esta base de datos (DISCOVER_DB) = ENABLE Clase optimizacin consulta por omisin (DFT_QUERYOPT) = Grado de paralelismo (DFT_DEGREE) = Continuar en excepciones aritmticas (DFT_SQLMATHWARN) = Edad de renovacin por omisin (DFT_REFRESH_AGE) = 0 Nmero de valores frecuentes retenidos (NUM_FREQVALUES) = Nmero de cantidades retenidas (NUM_QUANTILES) = Pendiente de copia de seguridad La base de datos es coherente Recuperacin pendiente Pendiente de restauracin Asignacin de archivos mltiples pgs. habilitada Retencin reg. cronolgico de recuperacin Salida de usuario para estado de reg. cron. Intervalo caduc. seal Data Links (seg) Int. caduc. inic. seal grab. Data Links Nmero de copias de Data Links Tiempo de Data Links tras desact.(das) Seal de Data Links en maysculas Algoritmo de seal de Data Links = (DL_EXPINT) (DL_WT_IEXPINT) (DL_NUM_COPIES) (DL_TIME_DROP) (DL_UPPER) (DL_TOKEN) 5 1 NO 10 20
= NO = YES = NO = NO = NO = NO = = = = = = 60 60 1 1 NO MAC0
350
Command Reference

Pila de base de datos (4KB) (DBHEAP) = 1200 Tamao mem. compart. base datos (MB) (DATABASE_MEMORY) = AUTOMATIC Tam. antememoria catlogo (4KB) (CATALOGCACHE_SZ) = (MAXAPPLS*4) Tamao del almac. int. del reg. cron. (4KB) (LOGBUFSZ) = 8 Tamao pila de progs. de utilidad (4KB) (UTIL_HEAP_SZ) = 5000 Tamao agrupacin de almac. int. (pginas) (BUFFPAGE) = 1000 Tamao segmentos almac. extend. (4KB) (ESTORE_SEG_SZ) = 16000 Nmero de segmentos almac. extendido (NUM_ESTORE_SEGS) = 0 Almacenam. mx. para lista de bloqueos (4KB) (LOCKLIST) = 100 Tam. mx. conj. mem. grupo apl. (4KB) (APPGROUP_MEM_SZ) = 20000 Porcentaje mem. para pila grupo apl. (GROUPHEAP_RATIO) = 70 Tamao mx. pila control apl. (4KB) (APP_CTL_HEAP_SZ) = 128 Umbral pila clas. para clas. comp.(4KB) (SHEAPTHRES_SHR) = Pila de lista de clasificacin (4KB) (SORTHEAP) Pila de sentencias de SQL (4KB) (STMTHEAP) Pila de aplicaciones por omisin (4KB) (APPLHEAPSZ) Tamao de la antememoria de paquete (4KB) (PCKCACHESZ) Tamao de la pila de estadsticas (4KB) (STAT_HEAP_SZ) (SHEAPTHRES) = 256 = 2048 = 256 = (MAXAPPLS*8) = 4384
Intervalo (ms) comprobacin puntos muertos (DLCHKTIME) = 10000 Porcent. de listas de bloqueo por aplicacin (MAXLOCKS) = 10 Tiempo de espera del bloqueo (seg) (LOCKTIMEOUT) = -1 Umbral de pginas cambiadas Nmero de limpiadores de pgina asnc. Nmero de servidores E/S Distintivo de clasificacin del ndice Distintivo de deteccin secuencial Tamao captac. previa omisin (pginas) Rastrear pginas modificadas (CHNGPGS_THRESH) (NUM_IOCLEANERS) (NUM_IOSERVERS) (INDEXSORT) (SEQDETECT) (DFT_PREFETCH_SZ) = = = = = = 60 1 3 YES YES 32
(TRACKMOD) = OFF
Nmero por omisin de contenedores = 1 Tam. extens. espacio tablas omisin (pg.) (DFT_EXTENT_SZ) = 32 Nmero mx. de aplicaciones activas Promedio de aplicaciones activas Mx. de archivos de BD abiertos por aplic. (MAXAPPLS) = AUTOMATIC (AVG_APPLS) = 1 (MAXFILOP) = 64
Tamao del archivo del reg. cronol. (4KB) (LOGFILSIZ) = 1000 Nmero de archivos de registro ppales. (LOGPRIMARY) = 3 Nmero de archivos de reg. secundarios (LOGSECOND) = 2 Va acceso modificado archivos anot. cron. (NEWLOGPATH) = Va de acceso a archivos de anotaciones cronolgicas = /home/mlegare/SQLOGDIR/ Va acceso anot. cron. desbordamiento (OVERFLOWLOGPATH) = Va acceso anot. cron. duplicada (MIRRORLOGPATH) = Primer archivo activo de anotaciones cronolgicas = Anot. cron. de bloque en disco llenas (BLK_LOG_DSK_FUL) = YES Porcent. espacio anot. activ. mx. por trans. (MAX_LOG) = 0 Nm. arch. anot. cron. act. 1 UOW activa (NUM_LOG_SPAN) = 0 Nmero aplic. para agrupar confirmaciones (MINCOMMIT) = 1 Regis. porcent. reclamado antes de chckpt soft (SOFTMAX) = 100
351

Retencin reg. cron. de recup. habilitado Salida usuario para reg. cron. habilitada Reinicio automtica habilitado Tiempo de recreacin de ndices Nmero por omis. de sesiones loadrec Nmero de copias seguridad a retener Retencin historial de recup. (das) Clase de gestin TSM Nombre de nodo TSM Propietario TSM Contrasea TSM (LOGRETAIN) = OFF (USEREXIT) = OFF (AUTORESTART) (INDEXREC) (DFT_LOADREC_SES) (NUM_DB_BACKUPS) (REC_HIS_RETENTN) (TSM_MGMTCLASS) (TSM_NODENAME) (TSM_OWNER) (TSM_PASSWORD) = = = = = = = = = ON SYSTEM (RESTART) 1 12 366
El ejemplo siguiente muestra una parte de la salida del mandato al especificar la opcin SHOW DETAIL. El valor de la columna Valor retrasado es el valor que se aplicar la prxima vez que se inicie la instancia.
Descripcin Configuracin base de datos para base de datos optimize Parmetro Valor actual Valor retrasado = 0x0a00 = 0x0a00 = US = 819 = ISO8859-1 = 1 = DISABLE = = ENABLE = 7 = 1 = NO = 0 = 10 = 20 = NO = YES = NO = NO = NO = NO = = 60 = 60 = AUTOMATIC(8416) = (MAXAPPLS*4) = 8 = 5000 = 1000 = 16000 = 0 = 100 = 20000 = 70 = 128 = (SHEAPTHRES) = 256
Nivel de release de configuracin de base de datos Nivel release de base de datos Territorio de base de datos Pgina de cdigos de la base de datos Conjunto de cdigos de base de datos Cdigo de pas/regin de base de datos Gestin de consultas SQL dinmicas (DYN_QUERY_MGMT) Nombre de objeto del directorio (DIR_OBJ_NAME) Soporte de Discovery para esta base datos (DISCOVER_DB) Clase optimizacin consulta por omisin (DFT_QUERYOPT) Grado de paralelismo (DFT_DEGREE) Continuar en excepciones aritmticas (DFT_SQLMATHWARN) Edad de renovacin por omisin (DFT_REFRESH_AGE) Nmero de valores frecuentes retenidos (NUM_FREQVALUES) Nmero de cuantiles retenidos (NUM_QUANTILES) Pendiente de copia de seguridad La base de datos es coherente Recuperacin pendiente Pendiente de restauracin Asignacin de archivos mltiples pgs. habilitada Retencin reg. cronolgico de recuperacin Salida de usuario para estado de reg. cron. Intervalo caduc. seal Data Links (seg) (DL_EXPINT) Int. caduc. inic. seal grab. Data Links(DL_WT_IEXPINT) Tamao mem. compart. base datos (4KB) (DATABASE_MEMORY) Tam. antememoria catlogo (4KB) (CATALOGCACHE_SZ) Tamao del almac. int. del reg. cron. (4KB) (LOGBUFSZ) Tamao pila de progs. de utilidad (4KB) (UTIL_HEAP_SZ) Tamao agrupacin de almac. int. (pginas) (BUFFPAGE) Tamao segmentos almac. extend. (4KB) (ESTORE_SEG_SZ) Nmero de segmentos almac. extendido (NUM_ESTORE_SEGS) Almacenam. mx. para lista de bloqueos (4KB) (LOCKLIST) Tam. mx. conj. mem. grupo apl. (4KB) (APPGROUP_MEM_SZ) Porcentaje mem. para pila grupo apl. (GROUPHEAP_RATIO) Tamao mx. pila control apl. (4KB) (APP_CTL_HEAP_SZ) Umbral pila clas. para clas. comp.(4KB)(SHEAPTHRES_SHR) Pila de lista de clasificacin (4KB) (SORTHEAP)
DISABLE ENABLE 7 1 NO 0 10 20
60 60 AUTOMATIC(8416) (MAXAPPLS*4) 8 5000 1000 16000 0 100 20000 70 128 (SHEAPTHRES) 256
352
Command Reference

Pila de sentencias de SQL (4KB) (STMTHEAP) Pila de aplicaciones por omisin (4KB) (APPLHEAPSZ) Tamao de la antememoria de paquete (4KB) (PCKCACHESZ) Tamao de la pila de estadsticas (4KB) (STAT_HEAP_SZ) Intervalo (ms) comprob. puntos muertos (DLCHKTIME) Porcent. de listas de bloqueo por aplicacin (MAXLOCKS) Tiempo de espera del bloqueo (seg) (LOCKTIMEOUT) Umbral de pginas cambiadas (CHNGPGS_THRESH) Nmero de limpiadores de pgina asinc. (NUM_IOCLEANERS) Nmero de servidores E/S (NUM_IOSERVERS) Distintivo de clasificacin del ndice (INDEXSORT) Distintivo de deteccin secuencial (SEQDETECT) Tamao captac. previa omisin (pg.) (DFT_PREFETCH_SZ) Rastrear pginas modificadas (TRACKMOD) Nmero por omisin de contenedores Tam. extens. espacio tablas omis. (pg.)(DFT_EXTENT_SZ) Nmero mx. de aplicaciones activas (MAXAPPLS) = = = = = = = = = = = = = = = = = 2048 256 (MAXAPPLS*8) 4384 10000 10 -1 60 1 3 YES YES 32 NO 1 32 AUTOMATIC(40) 2048 256 (MAXAPPLS*8) 4384 10000 10 -1 60 1 3 YES YES 32 NO 1 32 AUTOMATIC(40)
Notas de uso: Si se produce un error, la informacin devuelta no es vlida. Si el archivo de configuracin no es vlido, se devuelve un mensaje de error. La base de datos deber restaurarse de una versin de copia de seguridad. Para establecer los parmetros de configuracin de base de datos en los valores por omisin del gestor de bases de datos, utilice el mandato RESET DATABASE CONFIGURATION. Informacin relacionada: v Mandato RESET DATABASE CONFIGURATION en la pgina 627 v Mandato UPDATE DATABASE CONFIGURATION en la pgina 718
353
GET DATABASE MANAGER CONFIGURATION Mandato GET DATABASE MANAGER CONFIGURATION

Devuelve los valores de entradas individuales del archivo de configuracin del gestor de bases de datos. Autorizacin: Ninguna Conexin necesaria: Ninguna o instancia. Para efectuar operaciones de configuracin DBM locales no se necesita una conexin de instancia, pero dicha conexin es necesaria para efectuar operaciones de configuracin DBM remotas. Para visualizar la configuracin del gestor de bases de datos para una instancia remota, es necesario conectarse primero a dicha instancia. La clusula SHOW DETAIL requiere una conexin a una instancia. Sintaxis del mandato:
SHOW DETAIL GET DATABASE MANAGER DB MANAGER DBM CONFIGURATION CONFIG CFG
Parmetros del mandato: SHOW DETAIL Visualiza informacin detallada que muestra el valor actual de los parmetros de configuracin del gestor de bases de datos, as como el valor de los parmetros la prxima vez que se inicie el gestor de bases de datos. Esta opcin permite ver el resultado de cambios dinmicos en los parmetros de configuracin. Ejemplos: Nota: El tipo de nodo y la plataforma determinan qu parmetros de configuracin se listan. A continuacin se muestra un ejemplo de salida de GET DATABASE MANAGER CONFIGURATION (emitido en AIX):
Configuracin del Gestor de bases de datos Tipo nodo = Servidor de bases de datos con clientes locales Nivel de release configuracin gestor bases de datos Velocidad CPU (miliseg./instruccin) = 0x0a00
(CPUSPEED) = 4.000000e-05
354
Command Reference
GET DATABASE MANAGER CONFIGURATION

Nm. mx. de bases de datos activas simultneas (NUMDB) Soporte para Data Links (DATALINKS) Soporte de Sistema federado de bases de datos (FEDERATED) Nombre de superv. del proces. transac. (TP_MON_NAME) Cuenta de retrotraccin por omisin Va de instalacin de Java Development Kit = 8 = NO = NO =
(DFT_ACCOUNT_STR) = (JDK_PATH) = /wsdb/v81/bldsupp/AIX/jdk1.3.0
Nivel de captura de error de diagnstico (DIAGLEVEL) = 3 Nivel de notificacin (NOTIFYLEVEL) = 3 Va de acceso al direc. de datos diagnst. (DIAGPATH) = Conmutadores supervisor base datos por omisin Agrupacin de almac. intermedios (DFT_MON_BUFPOOL) = OFF Bloqueo (DFT_MON_LOCK) = OFF Clasificacin (DFT_MON_SORT) = OFF Sentencia (DFT_MON_STMT) = OFF Tabla (DFT_MON_TABLE) = OFF Indicacin de la hora (DFT_MON_TIMESTAMP) = ON Unidad de trabajo (DFT_MON_UOW) = OFF Supervisar salud instancia y bases datos (HEALTH_MON) = OFF Nombre de grupo SYSADM Nombre de grupo SYSCTRL Nombre de grupo SYSMAINT Autentificacin del Gestor de BD. Catalogacin permitida sin autorizac. Confiar todos los clientes Autentificacin cliente confiado Utilizar autentificacin SNA Ajustar temp. autentificacin federada Va de acceso base de datos por omisin (SYSADM_GROUP) = BUILD (SYSCTRL_GROUP) = (SYSMAINT_GROUP) = (AUTHENTICATION) (CATALOG_NOAUTH) (TRUST_ALLCLNTS) (TRUST_CLNTAUTH) (USE_SNA_AUTH) (FED_NOAUTH) = = = = = = SERVER YES YES CLIENT NO NO
(DFTDBPATH) = /home/kalih = = = = = = 56 512 0 AUTOMATIC 1024 1024
Tamao de pila de supervisor de BD (4KB) (MON_HEAP_SZ) Tamao pila de Mq. Virtual Java (4KB) (JAVA_HEAP_SZ) Tamao alm. int. de comprobacin (4KB) (AUDIT_BUF_SZ) Tam. mem. compart. base datos (MB) (INSTANCE_MEMORY) Tamao omis. almac. interm. copia seg.(4KB) (BACKBUFSZ) Tamao omis. almac. int. de restaurar (4KB) (RESTBUFSZ) Umbral de pila de clasificacin (4KB) Soporte antememoria de directorio Tamao Tamao Tamao Tamao
(SHEAPTHRES) = 20000 (DIR_CACHE) = YES = = = = = = = = = = 15 32767 1000 128 SYSTEM 200 100(calculated) 0 MAXAGENTS MAX_COORDAGENTS
pila capa soporte aplicaciones (4KB) (ASLHEAPSZ) mx (bytes) de bloque de E/S petic. (RQRIOBLK) de la pila de consultas (4KB) (QUERY_HEAP_SZ) de pila de servicios DRDA (4KB) (DRDA_HEAP_SZ)
Prioridad de agentes (AGENTPRI) Nmero mximo de agentes existentes (MAXAGENTS) Tamao agrupacin de agentes (NUM_POOLAGENTS) Nmero inicial agentes en agrupacin (NUM_INITAGENTS) Nmero mximo agentes coordinacin (MAX_COORDAGENTS) Nm. mx. agentes coordinacin simultneos (MAXCAGENTS)
355

Nmero mx. de conexiones cliente (MAX_CONNECTIONS) = -1
Mantener proceso delimitado (KEEPFENCED) = YES Nmero de procesos delimitados agrupados (FENCED_POOL) = MAX_COORDAGENTS Nmero inicial de procesos delimitados (NUM_INITFENCED) = 0 Tiempo de recreacin de ndices (INDEXREC) = RESTART
Nombre de BD del gestor de transacciones (TM_DATABASE) = 1ST_CONN Intervalo resinc. de transac. (seg) (RESYNC_INTERVAL) = 180 Nombre Tamao Lmite Va de Nombre Nombre Nombre Nombre Nmero de SPM de registro SPM agente resincronismo SPM registro SPM de servicio de TCP/IP de programa de transaccin APPC de servidor de archivos IPX/SPX objeto servidor IPX/SPX DB2 de socket IPX/SPX (SPM_NAME) (SPM_LOG_FILE_SZ) (SPM_MAX_RESYNC) (SPM_LOG_PATH) (SVCENAME) (TPNAME) (FILESERVER) (OBJECTNAME) (IPX_SOCKET) = = 256 = 20 = = = = = = 879E
Modalidad de Discovery Protocolos de comunicacin Discovery Instancia de servidor Discover
(DISCOVER) = SEARCH (DISCOVER_COMM) = (DISCOVER_INST) = ENABLE
Grado mximo de consulta paralelismo (MAX_QUERYDEGREE) = ANY Habilitar paralelismo entre partic. (INTRA_PARALLEL) = NO Nm. almac. interm. comun. int. (4KB)(FCM_NUM_BUFFERS) = 512
El siguiente ejemplo de salida muestra la informacin que se visualiza al especificar la opcin WITH DETAIL. El valor que aparece en Valor retrasado es el valor que estar en vigor la prxima vez que se inicie la instancia del gestor de bases de datos.
Configuracin del Gestor de bases de datos Tipo nodo = Servidor de bases de datos con clientes locales Descripcin Parmetro Valor actual Nivel release config. gestor bases datos = 0x0a00 Velocidad CPU (miliseg./instruccin) (CPUSPEED) = 4.000000e-05 Nm. mx. de bases datos activas simultneamente (NUMDB) = 8 Soporte para Data Links (DATALINKS) = NO Soporte Sistema federado de bases de datos (FEDERATED) = NO Nombre de superv. del proces. transac. (TP_MON_NAME) = Va de acceso base de datos por omisin (DFTDBPATH) = /home/valent1 Tamao pila supervisor base datos (4KB) (MON_HEAP_SZ) = 56 Tamao conj. de mem. compartida UDF (4KB) (UDF_MEM_SZ) = 256 Tamao pila de Mquina Virtual Java (4KB) (JAVA_HEAP_SZ) = 512 Tamao alm. int. de comprobacin (4KB) (AUDIT_BUF_SZ) = 0 Tamao memoria compart. instancia (MB) (INSTANCE_MEMORY) = AUTOMATIC(1008) Tamao omis. almac. interm. copia seg. (4KB) (BACKBUFSZ) = 1024 Tamao omis. almac. int. de restaurar (4KB) (RESTBUFSZ) = 1024 Umbral de pila de clasificacin (4KB) (SHEAPTHRES) = 20000 Valor retrasado 4.000000e-05 8 NO NO /home/valent1 56 256 512 0 AUTOMATIC(1008) 1024 1024 20000
356
Command Reference

Notas de uso: Si existe una conexin a una instancia remota o a una instancia local diferente, se devuelven los parmetros de configuracin del gestor de bases de datos para el servidor conectado; de lo contrario, se devuelven los parmetros de configuracin locales del gestor de bases de datos. Si se produce un error, la informacin devuelta no es vlida. Si el archivo de configuracin no es vlido, se devuelve un mensaje de error. El usuario debe instalar otra vez el gestor de bases de datos para recuperarse. Para establecer los parmetros de configuracin en los valores por omisin enviados con el gestor de bases de datos, utilice el mandato RESET DATABASE MANAGER CONFIGURATION. Informacin relacionada: v Mandato RESET DATABASE MANAGER CONFIGURATION en la pgina 629 v Mandato UPDATE DATABASE MANAGER CONFIGURATION en la pgina 721
357
GET DATABASE MANAGER MONITOR SWITCHES Mandato GET DATABASE MANAGER MONITOR SWITCHES
Visualiza el estado de los conmutadores de supervisor de sistema de bases de datos. Los conmutadores de supervisor indican al gestor del sistema de bases de datos que rena informacin de actividad de la base de datos. Cada aplicacin que utiliza la interfaz de supervisor de sistema de base de datos tiene su propio conjunto de conmutadores de supervisor. Un conmutador a nivel de gestor de bases de datos est activado cuando cualquiera de las aplicaciones de supervisin lo ha activado. Este mandato se utiliza para determinar si el supervisor de sistema de bases de datos est actualmente reuniendo datos para alguna aplicacin de supervisin. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia o base de datos: v Si no existe ninguna conexin a una instancia ni ninguna conexin a una base de datos, se crear una conexin de instancia por omisin. v Si existe una conexin a una instancia y una conexin a una base de datos, se utilizar la conexin a la instancia. Para visualizar los valores de una instancia remota o de una instancia local diferente, es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
GET DATABASE MANAGER DB MANAGER DBM MONITOR SWITCHES
AT DBPARTITIONNUM nmero-particin-bd GLOBAL
Parmetros del mandato: AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor del gestor de bases de datos.
358
Command Reference
GET DATABASE MANAGER MONITOR SWITCHES

GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado. Ejemplos: A continuacin se muestra un ejemplo de salida de GET DATABASE MANAGER MONITOR SWITCHES:
Informacin recogida del supervisor del sistema DBM Lista conmutadores para nmero particin bd 1 Infor. activ. agrup. almac. int. (BUFFERPOOL) Informacin de bloqueo (LOCK) Informacin de clasificacin (SORT) Informacin de sentencia de SQL (STATEMENT) Informacin actividades tabla (TABLE) Informacin indic. hora toma (TIMESTAMP) Informacin unidad de trabajo (UOW) = = = = = = = ON 06-11-1997 10:11:01.738377 OFF ON 06-11-1997 10:11:01.738400 OFF OFF ON 06-11-1997 10:11:01.738525 ON 06-11-1997 10:11:01.738353
Notas de uso: Los conmutadores de registro BUFFERPOOL, LOCK, SORT, STATEMENT, TABLE y UOW estn desactivados por omisin, pero se pueden activar utilizando el mandato UPDATE MONITOR SWITCHES. Si cualquiera de estos conmutadores est activado, este mandato visualiza tambin la indicacin de la hora en la que se ha activado el conmutador. El conmutador de registro TIMESTAMP est activado por omisin, pero puede desactivarse mediante UPDATE MONITOR SWITCHES. Cuando este conmutador est en el sistema emite llamadas de indicacin de la hora al recoger informacin para los elementos de supervisor de indicacin de la hora. He aqu unos ejemplos de estos elementos: v agent_sys_cpu_time v agent_usr_cpu_time v appl_con_time v con_elapsed_time v v v v v v v v con_response_time conn_complete_time db_conn_time elapsed_exec_time gw_comm_error_time gw_con_time gw_exec_time host_response_time
359
GET DATABASE MANAGER MONITOR SWITCHES

v v v v v v v v v v v last_backup last_reset lock_wait_start_time network_time_bottom network_time_top prev_uow_stop_time rf_timestamp ss_sys_cpu_time ss_usr_cpu_time status_change_time stmt_elapsed_time
v stmt_start v stmt_stop v v v v v stmt_sys_cpu_time stmt_usr_cpu_time uow_elapsed_time uow_start_time uow_stop_time
Si el conmutador TIMESTAMP est desactivado, no se emiten llamadas del sistema operativo de indicacin de la hora para determinar estos elementos, los cuales contendrn un cero. Tenga en cuenta que poner este conmutador en desactivado es ms importante a medida que la utilizacin de la CPU se aproxima al 100%; cuando ocurre esto, el tiempo de la CPU necesario para emitir indicaciones de la hora aumenta espectacularmente. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato GET SNAPSHOT en la pgina 374 v Mandato GET MONITOR SWITCHES en la pgina 367 v Mandato RESET MONITOR en la pgina 631 v Mandato UPDATE MONITOR SWITCHES en la pgina 730
360
Command Reference
GET DESCRIPTION FOR HEALTH INDICATOR Mandato GET DESCRIPTION FOR HEALTH INDICATOR
Devuelve una descripcin para el indicador de salud especificado. Un Indicador de salud mide la salud de un estado, capacidad o comportamiento determinado del sistema de bases de datos. El estado define si el objeto o recurso de base de datos est funcionando normalmente o no. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
GET DESCRIPTION FOR HEALTH INDICATOR nombrecorto
Parmetros del mandato: HEALTH INDICATOR nombrecorto Nombre del indicador de salud para el que desea recuperar la descripcin. Los nombres de indicador de salud se componen de un identificador de objeto de dos o tres letras, seguido de un nombre que describe lo que mide el indicador. Por ejemplo:
db.sort_privmem_util
Ejemplos: A continuacin se muestra un ejemplo de salida del mandato GET DESCRIPTION FOR HEALTH INDICATOR.
GET DESCRIPTION FOR HEALTH INDICATOR db2.sort_privmem_util DESCRIPTION FOR db2.sort_privmem_util Clasificar se considera saludable si hay suficiente espacio de pila en el que realizar la clasificacin y las clasificaciones no se desbordan innecesariamente. Este indicador rastrea la utilizacin de la memoria de clasificacin privada. Si db2.sort_heap_allocated (elemento de datos de supervisor de sistema) >= SHEAPTHRES (parmetro de configuracin de DBM), es posible que las clasificaciones no obtengan una pila de clasificacin completa como se ha definido mediante el parmetro SORTHEAP y es posible que se genere una alerta. El indicador se calcula utilizando la frmula: (db2.sort_heap_allocated / SHEAPTHRES) * 100. El elemento del supervisor de instantneas de Capturas posteriores a un umbral mide el nmero de clasificaciones que han solicitado pilas despus de haber excedido el umbral de pila de clasificaciones. El valor de este indicador, que se muestra en Detalles adicional, indica el grado de gravedad del problema
361
GET DESCRIPTION FOR HEALTH INDICATOR

para este indicador de salud. El elemento del supervisor de instantneas Mximo de memoria de clasificacin privada utilizada mantiene una marca de lmite de memoria de clasificacin para la instancia. El valor de este indicador, mostrado en la Informacin adicional, indica la cantidad mxima de memoria de clasificacin privada que se ha estado utilizando en cualquier punto horario desde que se recicl la instancia por ltima vez. Este valor puede utilizarse para ayudar a determinar un valor adecuado para SHEAPTHRES.
Informacin relacionada: v Health Indicators del manual System Monitor Guide and Reference
362
Command Reference
GET HEALTH NOTIFICATION CONTACT LIST Mandato GET HEALTH NOTIFICATION CONTACT LIST
Devuelve la lista de contactos y/o de grupos de contactos a los que se notifica acerca de la salud de una instancia. Una lista de contactos se compone de direcciones de correo electrnico y de direcciones de Internet de buscapersonas de individuos a los que hay que notificar cuando se cumplan determinadas condiciones de salud que no sean normales para una instancia o para cualquiera de sus objetos de base de datos. Autorizacin: Ninguna. Conexin necesaria: Instancia. No se necesita una conexin explcita. Sintaxis del mandato:
GET HEALTH NOTIFICATION CONTACT NOTIFICATION LIST
Parmetros del mandato: Ninguna. Ejemplos: Emitir el mandato GET NOTIFICATION LIST produce como resultado un informe similar al siguiente:
Nombre -----------------------------Juan Prez Soporte Tipo ------------Contacto Grupo contactos
363
GET HEALTH SNAPSHOT Mandato GET HEALTH SNAPSHOT

Recupera la informacin de estado de salud para el gestor de bases de datos y sus bases de datos. La informacin devuelta representa una instantnea del estado de salud en el momento en que se ha emitido el mandato. mbito: En un entorno de base de datos particionado, este mandato puede invocarse desde cualquier particin de base de datos definida en el archivo db2nodes.cfg. Por omisin, acta sobre la particin desde la que se ha invocado. Si se utiliza la opcin GLOBAL, extraer informacin consolidada de todas las particiones. Autorizacin: Ninguna. Conexin necesaria: Instancia. Si no existe ninguna conexin de instancia, se crear una conexin de instancia por omisin. Para obtener una instantnea de una instancia remota, es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
GET HEALTH SNAPSHOT FOR DATABASE MANAGER DB MANAGER DBM ALL DATABASES ALL TABLESPACES ALL ON DATABASE DB TABLESPACES
alias basedatos
AT DBPARTITIONNUM nmero particin bd GLOBAL
SHOW DETAIL
Parmetros del mandato: DATABASE MANAGER Proporciona estadsticas para la instancia de gestor de bases de datos activa.
364
Command Reference
GET HEALTH SNAPSHOT

ALL DATABASES Proporciona estados de salud para todas las bases de datos activas en la particin de base de datos actual. ALL ON alias-basedatos Proporciona estados de salud e informacin acerca de todos los espacios de tabla y las agrupaciones de almacenamientos intermedios para una base de datos especificada. DATABASE ON alias-basedatos TABLESPACES ON alias-basedatos Proporciona informacin acerca de los espacios de tabla para una base de datos especificada. BUFFERPOOLS ON alias-basedatos Proporciona informacin acerca de la actividad de las agrupaciones de almacenamientos intermedios para la base de datos especificada. AT DBPARTITIONNUM nmero-particin-bd Devuelve resultados correspondientes a la particin de base de datos especificada. GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado. SHOW DETAIL Especifica que la salida debe incluir los datos histricos para cada elemento de datos de supervisor de salud en forma de {(Timestamp, Value, Formula)}, donde los parmetros entre parntesis (Timestamp, Value, Formula) se repetirn para cada registro histrico que se devuelva. Por ejemplo,
(03-19-2002 13:40:24.138865,50,((1-(4/8))*100)), (03-19-2002 13:40:13.1386300,50,((1-(4/8))*100)), (03-19-2002 13:40:03.1988858,0,((1-(3/3))*100))
SHOW DETAIL tambin proporciona informacin de contexto adicional que puede ser til para comprender el valor y el estado de alerta del Indicador de salud asociado. Por ejemplo, si el Indicador de salud de utilizacin de almacenamiento de espacio de tabla se est utilizando para determinar la ocupacin del espacio de tabla, SHOW DETAIL tambin proporcionar la cadencia a la que est creciendo el espacio de tabla.
365
GET INSTANCE Mandato GET INSTANCE

Devuelve el valor de la variable de entorno DB2INSTANCE. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
GET INSTANCE
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida de GET INSTANCE:
La instancia del gestor de base de datos actual es: smith
366
Command Reference
GET MONITOR SWITCHES Mandato GET MONITOR SWITCHES

Visualiza el estado de los conmutadores de supervisor de sistema de bases de datos para la sesin actual. Los conmutadores de supervisor indican al gestor del sistema de bases de datos que rena informacin de actividad de la base de datos. Cada aplicacin que utiliza la interfaz de supervisor de sistema de base de datos tiene su propio conjunto de conmutadores de supervisor. Este mandato los visualiza. Para visualizar los conmutadores de nivel de gestor de bases de datos, utilice el mandato GET DBM MONITOR SWITCHES. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Si no existe ninguna conexin de instancia, se crear una conexin de instancia por omisin. Para visualizar los valores de una instancia remota o de una instancia local diferente, es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
GET MONITOR SWITCHES AT DBPARTITIONNUM GLOBAL nmero-particin-bd
Parmetros del mandato: AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor. GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado.
367
GET MONITOR SWITCHES

Ejemplos: A continuacin se muestra un ejemplo de salida de GET MONITOR SWITCHES:
Conmutadores de registro del supervisor Lista conmutadores para nmero particin bd 1 Infor. activ. agrup. almac. int. (BUFFERPOOL) Informacin de bloqueo (LOCK) Informacin de clasificacin (SORT) Informacin de sentencia de SQL (STATEMENT) Informacin actividades tabla (TABLE) Informacin indic. hora toma (TIMESTAMP) Informacin unidad de trabajo (UOW) = = = = = = = ON OFF OFF ON OFF ON ON 02-20-1997 16:04:30.070073 02-20-1997 16:04:30.070073 02-20-1997 16:04:30.070073 02-20-1997 16:04:30.070073
Notas de uso: El conmutador de registro TIMESTAMP est activado por omisin, pero puede desactivarse mediante UPDATE MONITOR SWITCHES. Cuando este conmutador est en el sistema emite llamadas de indicacin de la hora al recoger informacin para los elementos de supervisor de indicacin de la hora. El conmutador de registro TIMESTAMP est activado por omisin, pero puede desactivarse mediante UPDATE MONITOR SWITCHES. Si este conmutador est desactivado, este mandato tambin visualiza la indicacin de la hora en que se ha desactivado el conmutador. Cuando este conmutador est en el sistema emite llamadas de indicacin de la hora al recoger informacin para los elementos de supervisor de indicacin de la hora. He aqu unos ejemplos de estos elementos: v agent_sys_cpu_time v v v v agent_usr_cpu_time appl_con_time con_elapsed_time con_response_time
v conn_complete_time v db_conn_time v elapsed_exec_time v gw_comm_error_time v gw_con_time v gw_exec_time v host_response_time v last_backup
368
Command Reference
GET MONITOR SWITCHES

v v v v v v v v v v v last_reset lock_wait_start_time network_time_bottom network_time_top prev_uow_stop_time rf_timestamp ss_sys_cpu_time ss_usr_cpu_time status_change_time stmt_elapsed_time stmt_start
v stmt_stop v stmt_sys_cpu_time v v v v stmt_usr_cpu_time uow_elapsed_time uow_start_time uow_stop_time
Si el conmutador TIMESTAMP est desactivado, no se emiten llamadas del sistema operativo de indicacin de la hora para determinar estos elementos, los cuales contendrn un cero. Tenga en cuenta que poner este conmutador en desactivado es ms importante a medida que la utilizacin de la CPU se aproxima al 100%; cuando ocurre esto, el tiempo de la CPU necesario para emitir indicaciones de la hora aumenta espectacularmente. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato GET SNAPSHOT en la pgina 374 v Mandato GET DATABASE MANAGER MONITOR SWITCHES en la pgina 358 v Mandato RESET MONITOR en la pgina 631 v Mandato UPDATE MONITOR SWITCHES en la pgina 730
369
GET RECOMMENDATIONS Mandato GET RECOMMENDATIONS

Devuelve las descripciones de las recomendaciones para mejorar la salud del aspecto del sistema de bases de datos supervisado por el indicador de salud especificado. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
GET RECOMMENDATIONS FOR HEALTH INDICATOR nombrecorto
Parmetros del mandato: HEALTH INDICATOR nombrecorto Nombre del indicador de salud para el que desea recuperar las recomendaciones. Los nombres de indicador de salud se componen de un identificador de objeto de dos o tres letras, seguido de un nombre que describe lo que mide el indicador. Ejemplos:
GET RECOMMENDATIONS FOR HEALTH INDICATOR db2.sort_privmem_util RECOMMENDATIONS FOR db2.sort_privmem_util
Aumente el umbral de pila de clasificacin Si hay disponible memoria privada, aumente el parmetro de configuracin del gestor de bases de datos SHEAPTHRES para permitir una pila de clasificacin ms grande. Establezca el nuevo valor de SHEAPTHRES para que sea el 100% del elemento de datos del supervisor del sistema db2.max_priv_sort_mem. Ajuste la carga de trabajo Puede ejecutar el Asistente de diseo para ajustar el rendimiento de la base de datos para la carga de trabajo aadiendo ndices y tablas de consultas materializadas. Esto puede ayudar a disminuir la necesidad de clasificacin. Necesitar proporcionar la carga de trabajo de consulta y el nombre de la base de datos. Este asistente evaluar los ndices y las tablas de consultas materializadas existentes en trminos de la carga de trabajo y recomendar los nuevos objetos necesarios. Aumente la simultaneidad de clasificaciones Si el parmetro de configuracin de base de datos SORTHEAP es mayor de lo necesario,
370
Command Reference
GET RECOMMENDATIONS
disminuya su valor para obtener ms clasificaciones simultneas bajo los umbrales. Actualice el valor de SORTHEAP al 100% del valor actual del elemento de datos del supervisor del sistema db2.max_priv_sort_mem. La estadstica de frecuencia de utilizacin de memoria de SORTHEAP, incluida en la informacin adicional para este indicador de salud, proporciona una indicacin de comportamiento para el uso de SORTHEAP. Desea disminuir el valor de SORTHEAP a un punto donde sea posible una carga de trabajo normal sin exceder SHEAPTHRES, pero no hasta el punto de que el rendimiento se vea seriamente afectado.
Informacin relacionada: v Health Indicators del manual System Monitor Guide and Reference
371
GET ROUTINE Mandato GET ROUTINE

Recupera un archivo SQL Archive (SAR) de rutina para una rutina SQL especificada. Autorizacin: dbadm Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
GET ROUTINE INTO nombre_archivo FROM SPECIFIC PROCEDURE nombre_rutina
HIDE BODY
Parmetros del mandato: INTO nombre_archivo Denomina el archivo en el que se almacena SQL Archive (SAR) de rutina. FROM Indica el inicio de la especificacin de la rutina que debe recuperarse. SPECIFIC El nombre de rutina especificado se proporciona como un nombre especfico. PROCEDURE La rutina es un procedimiento SQL. nombre_rutina Nombre del procedimiento. Si se ha especificado SPECIFIC, es el nombre especfico del procedimiento. Si el nombre no est calificado con un nombre de esquema, se utiliza CURRENT SCHEMA como nombre de esquema de la rutina. El nombre-rutina debe ser un procedimiento existente que est definido como procedimiento SQL. HIDE BODY Especifica que el cuerpo de la rutina debe sustituirse por un cuerpo vaco cuando el texto de la rutina se extraiga de los catlogos. Esto no afecta al cdigo compilado; slo afecta al texto.
372
Command Reference
GET ROUTINE
Ejemplos:
GET ROUTINE INTO procs/proc1.sar FROM PROCEDURE myappl.proc1;
Notas de uso: Si una operacin GET ROUTINE o PUT ROUTINE (o su procedimiento correspondiente) no se ejecuta satisfactoriamente, siempre devolver un error (SQLSTATE 38000), acompaado de un texto de diagnstico que proporcionar informacin acerca de la causa de la anomala. Por ejemplo, si el nombre de procedimiento proporcionado en GET ROUTINE no identifica un procedimiento de SQL, se devolver el diagnstico -204, 42704, donde -204 y 42704 son el SQLCODE y el SQLSTATE, respectivamente, que identifican la causa del problema. El SQLCODE y el SQLSTATE de este ejemplo indican que el nombre de procedimiento proporcionado en el mandato GET ROUTINE no est definido.
373
GET SNAPSHOT Mandato GET SNAPSHOT

Rene informacin de estado y formatea la salida para el usuario. La informacin devuelta representa una instantnea del estado de operacin del gestor de bases de datos en el momento en que se ha emitido el mandato. mbito: En un entorno de base de datos particionado, este mandato puede invocarse desde cualquier particin de base de datos definida en el archivo db2nodes.cfg. Slo acta en esa particin. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Si no existe ninguna conexin de instancia, se crear una conexin de instancia por omisin. Para obtener una instantnea de una instancia remota, es necesario conectarse primero a dicha instancia.
374
Command Reference
GET SNAPSHOT
GET SNAPSHOT FOR DATABASE MANAGER WRITE TO FILE DB MANAGER DBM ALL DATABASES DCS ALL APPLICATIONS DCS ALL BUFFERPOOLS APPLICATION APPLID id-apl DCS AGENTID manejador-apl FCM FOR ALL DBPARTITIONNUMS LOCKS FOR APPLICATION APPLID id-apl AGENTID manejador-apl ALL REMOTE_DATABASES ALL REMOTE_APPLICATIONS ALL ON alias-basedatos DATABASE DCS DB APPLICATIONS DCS TABLES TABLESPACES LOCKS BUFFERPOOLS REMOTE_DATABASES REMOTE_APPLICATIONS DYNAMIC SQL
Notas: 1. Esta opcin slo se puede utilizar con el parmetro DYNAMIC SQL. 2. Los conmutadores de supervisor deben estar activados para obtener algunas estadsticas. Parmetros del mandato: DATABASE MANAGER Proporciona estadsticas para la instancia de gestor de bases de datos activa. ALL DATABASES Proporciona estadsticas generales para todas las bases de datos activas de la particin de base de datos actual.
375
GET SNAPSHOT
ALL APPLICATIONS Proporciona informacin acerca de todas las aplicaciones activas que estn conectadas a una base de datos en la particin de base de datos actual. ALL BUFFERPOOLS Proporciona informacin acerca de la actividad de las agrupaciones de almacenamientos intermedios para todas las bases de datos activas. APPLICATION APPLID id-apl Slo proporciona informacin acerca de la aplicacin cuyo ID se ha especificado. Para obtener un ID de aplicacin especfico, utilice el mandato LIST APPLICATIONS. APPLICATION AGENTID manejador-apl Slo proporciona informacin acerca de la aplicacin cuyo manejador de aplicacin se ha especificado. El manejador de aplicacin es un nmero de 32 bits que identifica de forma exclusiva una aplicacin que se est ejecutando actualmente. Utilice el mandato LIST APPLICATIONS para obtener un manejador de aplicacin especfico. FCM FOR ALL DBPARTITIONNUMS Proporciona estadsticas de Fast Communication Manager (FCM) entre la particin de base de datos para la que se emiti el mandato GET SNAPSHOT y las otras particiones de base de datos del entorno de base de datos particionado. LOCKS FOR APPLICATION APPLID id-apl Proporciona informacin acerca de todos los bloqueos mantenidos por la aplicacin especificada, identificada por el ID de aplicacin. LOCKS FOR APPLICATION AGENTID manejador-apl Proporciona informacin acerca de todos los bloqueos mantenidos por la aplicacin especificada, identificada por el manejador de aplicacin. ALL REMOTE_DATABASES Proporciona estadsticas generales acerca de todas las bases de datos remotas activas en la particin de base de datos actual. ALL REMOTE_APPLICATIONS Proporciona informacin sobre todas las aplicaciones remotas activas que estn conectadas a la particin de base de datos actual. ALL ON alias-basedatos Proporciona estadsticas generales e informacin acerca de todas las aplicaciones, las tablas, los espacios de tabla, las agrupaciones de almacenamientos intermedios y los bloqueos para una base de datos especificada.
376
Command Reference
GET SNAPSHOT
DATABASE ON alias-basedatos Proporciona estadsticas generales para una base de datos especificada. APPLICATIONS ON alias-basedatos Proporciona informacin acerca de todas las aplicaciones conectadas a una base de datos especificada. TABLES ON alias-basedatos Proporciona informacin acerca de las tablas de una base de datos especificada. Esto slo incluir las tablas a las que se ha accedido desde que se activ el conmutador de registro TABLE. TABLESPACES ON alias-basedatos Proporciona informacin acerca de los espacios de tabla para una base de datos especificada. LOCKS ON alias-basedatos Proporciona informacin acerca de cada bloqueo mantenido por cada aplicacin conectada a una base de datos especificada. BUFFERPOOLS ON alias-basedatos Proporciona informacin acerca de la actividad de las agrupaciones de almacenamientos intermedios para la base de datos especificada. REMOTE_DATABASES ON alias-basedatos Proporciona estadsticas generales sobre todas las bases de datos remotas activas correspondientes a una base de datos especfica. REMOTE_APPLICATIONS ON alias-basedatos Proporciona informacin sobre las aplicaciones remotas correspondientes a una base de datos especfica. DYNAMIC SQL ON alias-basedatos Devuelve una imagen de indicacin de fecha y hora del contenido de la antememoria de sentencia de SQL para la base de datos. WRITE TO FILE Especifica que los resultados de la instantnea deben almacenarse en un archivo en el servidor as como volverse a pasar al cliente. Este mandato slo es vlido a travs de una conexin de base de datos. Entonces se pueden consultar los datos de la instantnea mediante la funcin de tabla SYSFUN.SQLCACHE_SNAPSHOT a travs de la misma conexin en la que se ha efectuado la llamada. DCS En funcin de la clusula que se especifique, esta palabra clave solicita estadsticas acerca de: v Una aplicacin DCS especfica que se ejecute actualmente en la Pasarela DB2 Connect v Todas las aplicaciones DCS
377
GET SNAPSHOT
v Todas las aplicaciones DCS actualmente conectadas a una base de datos DCS especfica v Una base de datos DCS especfica v Todas las bases de datos DCS. AT DBPARTITIONNUM nmero-particin-bd Devuelve resultados correspondientes a la particin de base de datos especificada. GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado. Ejemplos: En los siguientes listados de salida de ejemplo, parte de la informacin puede no estar disponible, en funcin de si se ha activado o no el conmutador de registro de supervisor de sistema de bases de datos apropiado. Si la informacin no est disponible, aparecer No recogido en la salida. A continuacin se muestra salida tpica resultante de una peticin de informacin del gestor de bases de datos:
Instantnea de gestor de bases de datos Nombre nodo = Tipo nodo = Nombre instancia = Nmero particiones base datos en instancia DB2 = Estado de gestor de base de datos = Nombre de producto Identificacin de producto Nivel de servicio Pila de clasificacin asignada Clasificaciones umbral posteriores Clasificaciones en rea interconexin pedidas Clasificaciones en rea interconexin aceptad. Indicacin hora Gestor bases de datos Indic. hora ltimo restablecimiento Indicacin hora instantnea = Servidor BD con clientes locales y remotos DB2 1 Activo
= DB2 v8.1.0 = = n020211 = = = = 0 No recogido 0 0
= 03-07-2002 15:40:25.000042 = 03-07-2002 15:40:33.556495
Conexiones remotas al gestor de bases de datos = 0 Conex. remotas en ejecuc. en gestor base datos = 0 Conexiones locales = 0 Conex. locales en ejecuc. en gestor base datos = 0 Bases de datos locales activas = 0 Marca de lmite de agentes registrados = 1 Marca del lmite de agentes en espera de seal = 0 Agentes registrados = 1 Agentes en espera de una seal = 0
378
Command Reference
GET SNAPSHOT
Agentes desocupados Memoria privada comprometida (Bytes) = 0 = 2064384
Lista conmutadores para nmero particin bd 0 Inform. actividad agrup. alm. int.(BUFFERPOOL) = OFF Informacin de bloqueo (LOCK) = OFF Informacin de clasificacin (SORT) = OFF Informacin de sentencia de SQL (STATEMENT) = OFF Informacin actividades tabla (TABLE) = OFF Informacin indic. hora toma (TIMESTAMP) = ON 03-07-2002 15:40:25.000042 Informacin unidad de trabajo (UOW) = OFF Agentes asignados desde agrupacin Agentes creados desde agrupacin vaca Agentes robados de otra aplicacin Marca de lmite para agentes coordinacin Desbordamiento nmero mximo agentes Uniones hash excedidas tras umbral de pila Nmero total de conexiones de pasarela = 0 Nmero actual de conexiones de pasarela Conexiones pasarela esperando resp. sis. prin. Conexiones pasarela esperando petic. cliente Agentes agrupacin conexin inactiva pasarela Agentes robados agrupacin conexin pasarela Uso de memoria para gestor de bases de datos: Tipo de agrupacin de memoria Tamao actual (bytes) Marca de lmite (bytes) Tamao mximo permitido (bytes) = = = = Otra memoria 1296772 1409024 4294967295 = = = = = = = = = = = 0 1 0 1 0 0 0 0 0 0 0
A continuacin se muestra salida tpica resultante de una peticin de informacin de base de datos:
Instantnea de base de datos Nombre de base de datos Va de base de datos = SAMPLE = /home/andrewkm/andrewkm/NODE0000/ SQL00001/ Alias base de datos de entrada = SAMPLE Estado de base de datos = Activo Nmero particin base datos catlogo = 0 Nombre particin base datos red catlogo = Sist. oper. ejecut. en servidor base datos = AIX Ubicacin de la base de datos = Local Indic. hora primera conexin base datos = 06-12-2001 16:02:30.347681 Indic. hora ltimo restablecimiento = Indicacin hora ltima copia de seguridad = Indicacin hora instantnea = 06-12-2001 16:48:08.080999 Marca del lmite de conexiones Conexiones de aplicaciones Total conexiones secundarias Aplicaciones conectadas actualmente = = = = 1 1 0 1
379
GET SNAPSHOT
Apls. ejecutndose en gestor bd actualmente= Agentes asociados con aplicaciones = Nm mx. agentes asociados con aplicaciones= Nmero mximo de agentes de coordinacin = 0 1 1 1
Bloqueos retenidos actualmente = 0 Esperas de bloqueo = 0 Tiempo base datos espera bloqueos (ms) = 0 Memoria lista bloqueos utilizada (Bytes) = 560 Puntos muertos detectados = 0 Escalas de bloqueo = 0 Escalas de bloqueo exclusivas = 0 Agentes en espera de bloqueos actualmente = 0 Tiempos de espera de bloqueos = 0 Pila de clasificacin total asignada Nmero total de clasificaciones Tiempo total de clasificacin (ms) Desbordamientos de clasificacin Clasificaciones activas = = = = = 0 0 0 0 0 34 15 0 0 0 59 33 0 0 0 100 0 0 0 0 0 0 0 0 30 0 2 0 0 0 0 0 0 0 0 0.000275
Lecturas lgicas datos agrup. almac. int. = Lecturas fsicas datos agrup. almac. int. = Lecturas pgina datos agrupac. asncrona = Grabaciones datos agrup. almac. inter. = Grabaciones pginas datos agrupac. asnc. = Lecturas lg. ndice agrup. almac. inter. = Lect. fsicas ndice agrup. almac. inter. = Lecturas pginas ndice agrup. asnc. = Grabaciones ndices agrup. almac. inter. = Grabaciones pginas ndice agrup. asnc. = Tiempo total (ms) lectura agr. alm. int. = Tiempo total (ms) grab. agrup. alm. int. = Tiempo total transcurrido lectura asnc. = Tiempo total transcurrido grabac. asnc. = Peticiones lectura asncronas = Activadores limpiadores holgura LSN = Activadores limpiadores pginas sucias = Activadores limpiadores umbral pg. sucias = Tiempo espera captacin previa (ms) = Lecturas directas = Grabaciones directas = Peticiones de lectura directas = Peticiones de grabacin directas = Tiempo transcurrido lect. directas (ms) = Tiempo transcurrido grab. directas (ms) = Archivos de base de datos cerrados = Pginas datos copiadas en almacenam. exten.= Pginas ndice copiadas almac. extendido = Pgs. datos copiadas del almac. extend. = Pgs. ndice copiadas del almac. extend. = Tiempo transcurrido ejec. de sist. pral. = Sentencias de comprometer intentadas Sentencias de retrotraer intentadas
= 2 = 0
380
Command Reference
GET SNAPSHOT
Sentencias dinmicas intentadas Sentencias estticas intentadas Operaciones de sentencia fallidas Sentencias Select SQL ejecutadas Sentencias Update/Insert/Delete ejecutadas Sentencias DDL ejecutadas Repeticiones enlace automticas internas Filas internas suprimidas Filas internas insertadas Filas internas actualizadas Operaciones de comprometer internas Operaciones de retrotraer internas Retrotracciones internas por punto muerto Filas suprimidas Filas insertadas Filas actualizadas Filas seleccionadas Filas ledas Bind/precompilaciones intentadas Espacio Espacio Espacio Espacio Anotac. Pginas Pginas Id apl. = = = = = = = = = = = = = = = = = = = 4 2 0 1 0 0 0 0 0 0 1 0 0 0 0 0 32 43 0 20400000 0 0 0 0 0 0 0 1 1 0 156752 4 1 1 1 0 20484 0 0 0 0
anot. disponible base datos (Bytes)= anot. usado por base datos (Bytes) = mximo anot. secund. usado (Bytes) = mximo total anotac. usado (Bytes) = secundarias asignadas actualmente = anotaciones cronol. ledas = anotaciones cronol. grabadas = con la transaccin ms antigua = = = = = = = = = = = = = = =
Bsquedas antememoria de paquete Inserciones antememoria de paquete Desbordamientos de antememoria del paquete Marca lmite antem. paquete (Bytes) Bsquedas seccin aplicacin Inserciones seccin aplicacin Bsquedas antememoria del catlogo Inserciones antememoria del catlogo Desbordamientos antememoria del catlogo Marca lmite antememoria catlogo (Bytes) Nmero Nmero Nmero Nmero de de de de uniones hash bucles hash desbordamientos de uniones hash pequeos desbordam. uniones hash
A continuacin se muestra salida tpica resultante de una peticin de informacin de base de datos DCS:
Instantnea de base de datos DCS Nombre de base de datos DCS = SAMPLE
381
GET SNAPSHOT
Nombre de base de datos de sist. pral. = Ind. hora primera conexin base datos = Tiempo transc. ms reciente para conectar = Duracin conex. transcurrida ms reciente = Tiempo respuesta sist. principal (seg.ms) = Indic. hora ltimo restablecimiento = Nmero de sentencias de SQL intentadas = Sentencias de comprometer intentadas = Sentencias de retrotraer intentadas = Operaciones de sentencia fallidas = Nmero total de conexiones de pasarela = Nmero actual de conexiones de pasarela = Conex. pasarela esperando resp. sist. pral.= Conex. pasarela esperando respuesta cliente= Errores comunicaciones pasarela a sist. pr.= Indicacin hora ltimo error comunicacin = Marca del lmite de conexiones de pasarela = Filas seleccionadas = Bytes de salida enviados = Bytes de salida recibidos = Tiempo transcurrido ejec. de sist. pral. = SAMPLE 06-13-2001 16:08:44.142656 0.569354 0.000000 0.271230 1 1 0 0 1 1 0 1 0 Ninguno 1 0 10 32 0.000000
A continuacin se muestra salida tpica resultante de una peticin de informacin de aplicacin (especificando un ID de aplicacin, un manejador de aplicaciones, todas las aplicaciones o todas las aplicaciones de una base de datos):
Instantnea de aplicacin Manejador de aplicaciones = 0 Estado de la aplicacin = UOW en espera Hora de cambio de estado = 06-12-2001 16:03:07.061174 Pgina de cdigos de la aplicacin = 850 Cdigo de territorio de aplicacin = 1 Seal de correlacin DUOW = *LOCAL.andrewkm.010612195822 Nombre de la aplicacin = db2bp ID de aplicacin = *LOCAL.andrewkm.010612200230 ID de usuario cliente de TP Monitor = Nombre est. trabajo cliente de TP Monitor = Nombre aplicac. cliente de TP Monitor = Serie contabilidad cliente de TP Monitor = Nmero de secuencia Indicacin hora inicio peticin conexin Indicacin hora finalizacin petic. conex. Tiempo de desocupacin de la aplicacin ID de autorizacin ID de inicio de sesin de cliente NNAME de configuracin del cliente ID producto gestor base de datos cliente ID de proceso de aplicacin cliente Plataforma de la aplicacin cliente Protocolo de comunicacin de cliente Direccin de comunicaciones de entrada = = = = = = = = = = = 0001 06-12-2001 16:02:30.347681 06-12-2001 16:02:30.576003 49 minutos y 13 segundos ANDREWKM andrewkm SQL07021 94898 AIX Local Client
= *LOCAL.andrewkm
382
Command Reference
GET SNAPSHOT
Nombre de base de datos Va de base de datos = SAMPLE = /home/andrewkm/andrewkm/NODE0000/ SQL00001/ Alias de base de datos del cliente = sample Alias base de datos de entrada = SAMPLE Indic. hora ltimo restablecimiento = Indicacin hora instantnea = 06-12-2001 16:52:20.389068 El nivel de autorizacin ms alto otorgado = Autorizacin DBADM directa Autorizacin CREATETAB directa Autorizacin BINDADD directa Autorizacin CONNECT directa Autorizacin CREATE_NOT_FENC directa Autorizacin LOAD directa Autorizacin IMPLICIT_SCHEMA directa Autorizacin SYSADM indirecta Autorizacin CREATETAB indirecta Autorizacin BINDADD indirecta Autorizacin CONNECT indirecta Autorizacin IMPLICIT_SCHEMA indirecta Nmero particin base datos coordinacin = 0 Nmero particin base datos actual = 0 Proceso agente coordinador o ID hebra = 33744 Agentes robados = 0 Agentes en espera de bloqueos = 0 Nmero mximo de agentes asociados = 1 Prioridad en que trabajan agentes aplic. = 0 Tipo de prioridad = Dinmico Bloqueos retenidos por la aplicacin Esperas de bloqueos desde la conexin Tiempo aplicacin espera bloqueos (ms) Puntos muertos detectados Escalas de bloqueo Escalas de bloqueo exclusivas Nmero tiempo excedidos desde conexin Tiempo total UOW espera bloqueos (ms) Nmero total de clasificaciones Tiempo total de clasificacin (ms) Nmero total de desbordamientos clasif. = = = = = = = = 0 0 0 0 0 0 0 0
= 0 = 0 = 0 0 0 0 0 34 15 0 59 33 0 100 0
Pginas datos copiadas en almacenam. exten.= Pginas ndice copiadas almac. extendido = Pgs. datos copiadas del almac. extend. = Pgs. ndice copiadas del almac. extend. = Lecturas lgicas datos agrup. almac. int. = Lecturas fsicas datos agrup. almac. int. = Grabaciones datos agrup. almac. inter. = Lecturas lg. ndice agrup. almac. inter. = Lect. fsicas ndice agrup. almac. inter. = Grabaciones ndices agrup. almac. inter. = Tiempo total (ms) lectura agr. alm. int. = Tiempo total (ms) grab. agrup. alm. int. =
383
GET SNAPSHOT
Tiempo espera captacin previa (ms) Lecturas directas Grabaciones directas Peticiones de lectura directas Peticiones de grabacin directas Tiempo transcurrido lect. directas (ms) Tiempo transcurrido grab. directas (ms) Nmero petic. SQL desde ltimo compromiso Sentencias de comprometer Sentencias de retrotraer Sentencias de SQL dinmicas intentadas Sentencias de SQL estticas intentadas Operaciones de sentencia fallidas Sentencias Select SQL ejecutadas Sentencias Update/Insert/Delete ejecutadas Sentencias DDL ejecutadas Repeticiones enlace automticas internas Filas internas suprimidas Filas internas insertadas Filas internas actualizadas Operaciones de comprometer internas Operaciones de retrotraer internas Retrotracciones internas por punto muerto Bind/precompilaciones intentadas Filas suprimidas Filas insertadas Filas actualizadas Filas seleccionadas Filas ledas Filas grabadas Espacio anotaciones UOW utilizado (Bytes) Indicacin hora finalizacin UOW anterior Tiempo transc. ltima udt compl. seg.ms) Indicacin hora inicio UOW Indicacin hora fin UOW Estado finalizacin Abrir cursores remotos Abrir cursores remotos con bloqueo Peticiones Bloqueos cursor remoto rechaz. Peticiones Bloqueos cursor remoto acept. Cursores locales abiertos Cursores locales abiertos con bloqueo Tiempo total CPU usuario usado agente (s) Tiempo total CPU sistema usado agente (s) Tiempo transcurrido ejec. de sist. pral. Bsquedas antememoria de paquete Inserciones antememoria de paquete Bsquedas seccin aplicacin Inserciones seccin aplicacin Bsquedas antememoria del catlogo Inserciones antememoria del catlogo = 0 = 30 = 0 = 2 = 0 = 0 = 0 = 0 = 2 = 0 = 4 = 2 = 0 = 1 = 0 = 0 = 0 = 0 = 0 = 0 = 1 = 0 = 0 = 0 = 0 = 0 = 0 = 32 = 43 = 0 = 0 = 06-12-2001 16:02:30.577841 = 0.153904 = 06-12-2001 16:03:06.907297 = 06-12-2001 16:03:07.061201 = Comprometida - Sentencia Commit = 0 = 0 = 0 = 1 = 0 = 0 = = = = = = = = = 0.010000 0.090000 0.000275 1 1 4 1 1 1
Operacin ms reciente = Comprometer esttico Indic. hora inicio operacin ms reciente = 06-12-2001 16:03:07.060919
384
Command Reference
GET SNAPSHOT
Indic. hora detencin operac. ms reciente = 06-12-2001 16:03:07.061194 Agentes asociados con la aplicacin = 1 Nmero Nmero Nmero Nmero de de de de uniones hash bucles hash desbordamientos de uniones hash pequeos desbordam. uniones hash = = = = 0 0 0 0 Sentencia de SQL esttica Comprometer esttico 0 NULLID SQLC2D02 0 06-12-2001 16:03:07.060919 06-12-2001 16:03:07.061194 0.000275 0.000000 0.000000 0 0 1 0 1 0 0 0 0 0 0 0 0 0 NO
Tipo de sentencia = Sentencia = Nmero de seccin = Creador de la aplicacin = Nombre del paquete = Nombre del cursor = Nmero particin base datos sentencia = Indic. hora inicio de sentencia = Indic. hora detencin de sentencia = Tiempo transc. ltima sent. compl. (seg.ms)= Tiempo de CPU de usuario total = Tiempo de CPU de sistema total = Estimacin coste compilador SQL en timerons= Estimacin de cardinalidad compilador SQL = Grado de paralelismo solicitado = Nmero de agentes trabajando en sentencia = Nmero de subagentes creados para sentencia= Clasificaciones de sentencia = Tiempo total de clasificacin = Desbordamientos de clasificacin = Filas ledas = Filas grabadas = Filas suprimidas = Filas actualizadas = Filas insertadas = Filas captadas = Bloqueo de cursor = Proceso agente/ID hebra
= 33744
A continuacin se muestra salida tpica resultante de una peticin de informacin de aplicacin DCS (especificando un ID de aplicacin DCS, un manejador de aplicaciones DCS, todas las aplicaciones DCS o todas las aplicaciones DCS de una base de datos):
Instantnea de aplicacin DCS ID de aplicacin cliente Nmero de secuencia ID de autorizacin Nombre de la aplicacin Manejador de aplicaciones Estado de la aplicacin Hora de cambio de estado Nodo de cliente Nivel de release de cliente Plataforma de cliente = = = = = = = = = = *LOCAL.andrewkm.010613200844 0001 AMURCHIS db2bp 5 en espera de peticin 12-31-1969 19:00:00.000000 SQL07021 AIX
385
GET SNAPSHOT
Protocolo de cliente Pgina de cdigos de cliente ID de proceso de aplicacin cliente ID de inicio de sesin de cliente ID de aplicacin de sistema principal Nmero de secuencia Alias de base de datos en la pasarela Nombre de base de datos DCS Nombre de base de datos de sist. pral. Nivel de release de sistema principal CCSID de sistema principal = = = = = = = = = = = Cliente local 850 36034 andrewkm G9158067.CDF2.010613200845 0000 GSAMPLE SAMPLE SAMPLE SQL07021 850
Direccin de comunicaciones de salida = 9.21.115.179 17336 Protocolo de comunicaciones de salida = TCP/IP Direccin de comunicaciones de entrada = *LOCAL.andrewkm Ind. hora primera conexin base datos = 06-13-2001 16:08:44.142656 Tiempo respuesta sist. principal (seg.ms) = 0.271230 Tiempo transcurrido en proceso pasarela = 0.000119 Indic. hora ltimo restablecimiento = Filas seleccionadas = 0 Nmero de sentencias de SQL intentadas = 1 Operaciones de sentencia fallidas = 0 Sentencias de comprometer = 1 Sentencias de retrotraer = 0 Bytes de entrada recibidos = 184 Bytes de salida enviados = 10 Bytes de salida recibidos = 32 Bytes de entrada enviados = 0 Nmero de cursores abiertos = 0 Tiempo de desocupacin de la aplicacin = 1 minuto y 33 segundos Estado finalizacin = Comprometida - Sentencia Commit Indicacin hora finalizacin UOW anterior = Indicacin hora inicio UOW = 06-13-2001 16:08:44.716911 Indicacin hora detencin UOW = 06-13-2001 16:08:44.852730 Tiempo transc. ltima udt compl. (seg.ms) = 0.135819 Operacin ms reciente = Indic. hora inicio operacin ms reciente = Indic. hora detencin operac. ms reciente = Tiempo transcurrido ejec. de sist. pral. = Sentencia = Nmero de seccin = Creador de la aplicacin = Nombre del paquete = Estimacin coste compilador SQL en timerons= Estimacin de cardinalidad compilador SQL = Indic. hora inicio de sentencia = Indic. hora detencin de sentencia = Tiempo respuesta sist. principal (seg.ms) = Tiempo transc. ltima sent. compl.(seg.ms)= Filas captadas = Tiempo transcurrido en proceso pasarela = Bytes de entrada recibidos para sentencia = Bytes de salida enviados para sentencia = Comprometer esttico 06-13-2001 16:08:44.716911 06-13-2001 16:08:44.852730 0.000000 Comprometer esttico 0 NULLID SQLC2D02 0 0 06-13-2001 16:08:44.716911 06-13-2001 16:08:44.852730 0.271230 0.135819 0 0.000119 184 10
386
Command Reference
GET SNAPSHOT
Bytes de salida recibidos para sentencia Bytes de entrada enviados para sentencia Bloqueo de cursor Salida de bloqueo de cursor Tiempo transcurrido ejec. de sist. pral. = = = = = 32 0 NO NO 0.000000
A continuacin se muestra salida tpica resultante de una peticin de informacin de agrupacin de almacenamientos intermedios:
Instantnea agrupacin almacenam. intermedio Nombre agrupacin almacenam. intermedio = IBMDEFAULTBP Nombre de base de datos = SAMPLE Va de base de datos = /home/andrewkm/andrewkm/NODE0000/ SQL00001/ Alias base de datos de entrada = SAMPLE Lecturas lgicas datos agrup. almac. int. = 34 Lecturas fsicas datos agrup. almac. int. = 15 Grabaciones datos agrup. almac. inter. = 0 Lecturas lg. ndice agrup. almac. inter. = 59 Lect. fsicas ndice agrup. almac. inter. = 33 Tiempo total (ms) lectura agr. alm. int. = 100 Tiempo total (ms) grab. agrup. alm. int. = 0 Lecturas pgina datos agrupac. asncrona = 0 Grabaciones pginas datos agrupac. asnc. = 0 Grabaciones ndices agrup. almac. inter. = 0 Lecturas pginas ndice agrup. asnc. = 0 Grabaciones pginas ndice agrup. asnc. = 0 Tiempo total transcurrido lectura asnc. = 0 Tiempo total transcurrido grabac. asnc. = 0 Peticiones lectura asncronas = 0 Lecturas directas = 30 Grabaciones directas = 0 Peticiones de lectura directas = 2 Peticiones de grabacin directas = 0 Tiempo transcurrido lect. directas (ms) = 0 Tiempo transcurrido grab. directas (ms) = 0 Archivos de base de datos cerrados = 0 Pginas datos copiadas en almacenam. exten.= 0 Pginas ndice copiadas almac. extendido = 0 Pgs. datos copiadas del almac. extend. = 0 Pgs. ndice copiadas del almac. extend. = 0
A continuacin se muestra salida tpica resultante de una peticin de informacin de tabla:

Instantnea de tabla Indic. hora primera conexin base datos = 06-12-2001 16:02:30.347681
Indic. hora ltimo restablecimiento = Indicacin hora instantnea = 06-12-2001 16:55:40.809472 Nombre de base de datos = SAMPLE Va de base de datos = /home/andrewkm/andrewkm/NODE0000/ SQL00001/
387
GET SNAPSHOT
Alias base de datos de entrada Nmero de tablas accedidas Lista de tablas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla = = = = = = = ANDREWKM EMPLOYEE Usuario 32 0 0 0 = SYSIBM = SYSTABLES Catlogo 1 0 0 0 = SYSIBM SYSPLAN Catlogo 1 0 0 0 = SYSIBM SYSDBAUTH Catlogo 3 0 0 0 = SYSIBM SYSBUFFERPOOLS Catlogo 1 0 0 0 = SYSIBM SYSPLAN Catlogo 1 0 0 0 = 7 = SAMPLE
= = = = = = = = = = = = = = = = = = = = = = = = = = = = =
= SYSIBM = SYSDBAUTH = Catlogo
388
Command Reference
GET SNAPSHOT
Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas Esquema de tabla Nombre de tabla Tipo de tabla Filas ledas Filas grabadas Desbordamientos Reorg. de pginas = = = = = = = = = = = = = = = = = = = = = = 3 0 0 0 = SYSIBM SYSBUFFERPOOLS Catlogo 1 0 0 0 = SYSIBM SYSTABLESPACES Catlogo 3 0 0 0 = SYSIBM SYSVERSIONS Catlogo 1 0 0 0
A continuacin se muestra salida tpica resultante de una peticin de informacin de espacio de tabla:
Instantnea de espacio de tabla Indic. hora primera conexin base datos = 06-12-2001 16:02:30.347681 Indic. hora ltimo restablecimiento = Indicacin hora instantnea = 06-12-2001 16:56:55.963889 Nombre de base de datos = SAMPLE Va de base de datos = /home/andrewkm/andrewkm/NODE0000/ SQL00001/ Alias base de datos de entrada = SAMPLE Nmero de espacios de tabla accedidos = 3 Nombre de espacio de tabla = Lecturas lgicas datos agrup. almac. int.= Lecturas fsicas datos agrup. almac. int.= Lecturas pgina datos agrupac. asncrona = Grabaciones datos agrup. almac. inter. = Grabaciones pginas datos agrupac. asnc.= Lecturas lg. ndice agrup. almac. inter.= Lect. fsicas ndice agrup. almac. inter.= Lecturas pginas ndice agrup. asnc. = Grabaciones ndices agrup. alma. inter. = Grabaciones pginas ndice agrup. asnc. = Tiempo total (ms) lectura agr. alm. int. = SYSCATSPACE 30 13 0 0 0 59 33 0 0 0 99
389
GET SNAPSHOT
Tiempo total (ms) grab. agrup. alm. int. Tiempo total transcurrido lectura asnc. Tiempo total transcurrido grabac. asnc. Peticiones lectura asncronas Lecturas directas Grabaciones directas Peticiones de lectura directas Peticiones de grabacin directas Tiempo transcurrido lect. directas (ms) Tiempo transcurrido grab. directas (ms) Nmero de archivos cerrados Pgs datos copiadas en almacenam. exten. Pginas ndice copiadas almac. extendido Pgs. datos copiadas del almac. extend. Pgs. ndice copiadas del almac. extend. = = = = = = = = = = = = = = = 0 0 0 0 30 0 2 0 0 0 0 0 0 0 0 TEMPSPACE1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 USERSPACE1 4 2 0 0 0 0 0 0 0 0
Nombre de espacio de tabla = Lecturas lgicas datos agrup. almac. int.= Lecturas fsicas datos agrup. almac. int.= Lecturas pgina datos agrupac. asncrona = Grabaciones datos agrup. almac. inter. = Grabaciones pginas datos agrupac. asnc.= Lecturas lg. ndice agrup. almac. inter.= Lect. fsicas ndice agrup. almac. int. = Lecturas pginas ndice agrup. asnc. = Grabaciones ndices agrup. alma. inter. = Grabaciones pginas ndice agrup. asnc. = Tiempo total (ms) lectura agr. alm. int. = Tiempo total (ms) grab. agrup. alm. int. = Tiempo total transcurrido lectura asnc. = Tiempo total transcurrido grabac. asnc. = Peticiones lectura asncronas = Lecturas directas = Grabaciones directas = Peticiones de lectura directas = Peticiones de grabacin directas = Tiempo transcurrido lect. directas (ms) = Tiempo transcurrido grab. directas (ms) = Nmero de archivos cerrados = Pgs datos copiadas en almacenam. exten. = Pginas ndice copiadas almac. extendido = Pgs. datos copiadas del almac. extend. = Pgs. ndice copiadas del almac. extend. = Nombre de espacio de tabla = Lecturas lgicas datos agrup. almac. int.= Lecturas fsicas datos agrup. almac. int.= Lecturas pgina datos agrupac. asncrona = Grabaciones datos agrup. almac. inter. = Grabaciones pginas datos agrupac. asnc.= Lecturas lg. ndice agrup. almac. inter.= Lect. fsicas ndice agrup. almac. int. = Lecturas pginas ndice agrup. asnc. = Grabaciones ndices agrup. alma. inter. = Grabaciones pginas ndice agrup. asnc. =
390
Command Reference
GET SNAPSHOT
Tiempo total (ms) lectura agr. alm. int. Tiempo total (ms) grab. agrup. alm. int. Tiempo total transcurrido lectura asnc. Tiempo total transcurrido grabac. asnc. Peticiones lectura asncronas Lecturas directas Grabaciones directas Peticiones de lectura directas Peticiones de grabacin directas Tiempo transcurrido lect. directas (ms) Tiempo transcurrido grab. directas (ms) Nmero de archivos cerrados Pgs datos copiadas en almacenam. exten. Pginas ndice copiadas almac. extendido Pgs. datos copiadas del almac. extend. Pgs. ndice copiadas del almac. extend. = = = = = = = = = = = = = = = = 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
El siguiente ejemplo muestra la salida que se produce a partir de una peticin de informacin de bloqueo. Los puntos suspensivos (...) sustituye la informacin de bloqueo interno que se ha eliminado para mayor claridad. Permanece la informacin para un bloqueo interno.
Instantnea de bloqueo de base de datos Nombre de base de datos Va de acceso de base de datos Alias base de datos de entrada Bloqueos retenidos Aplicaciones conectadas actualmente Agentes actualmente en espera de bloqueos Indicacin hora instantnea Manejador de aplicaciones ID de aplicacin Nmero de secuencia Nombre de la aplicacin ID de autorizacin Estado de la aplicacin Hora de cambio de estado Pgina de cdigos de la aplicacin Bloqueos retenidos Tiempo de espera total (ms) Lista de bloqueos Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Recuento de bloqueos Recuento de retenciones Nombre de objeto de bloqueo Tipo de objeto Nombre de espacio de tabla Esquema de tabla Nombre de tabla Modalidad = = = = = = = = = = = = = = = = = = = = = = = = SNAPSHOT /home/mikew/mikew/NODE0000/SQL00001/ SNAPSHOT 13 2 1 03-22-2002 11:23:49.959485 3 *LOCAL.mikew.016A92161122 0001 db2bp MIKEW UOW en espera No recogido 819 4 No recogido
0x00020002000000060000000052 0x20 0x00000001 1 0 6 Fila = USERSPACE1 = MIKEW = SNAPSHOT = X

391
GET SNAPSHOT
Estado Escalado de bloqueos Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Recuento de bloqueos Recuento de retenciones Nombre objeto bloqueo Tipo de objeto Nombre de espacio de tabla Esquema de tabla Nombre de tabla Modalidad Estado Escalado de bloqueos ... Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Recuento de bloqueos Recuento de retenciones Nombre de objeto de bloqueo Tipo de objeto Modalidad Estado Escalado de bloqueos = Otorgado = NO = = = = = = = = = = = = = = = = = = = = = = 0x00020002000000000000000054 0x00 0x00000001 1 0 2 Tabla = USERSPACE1 MIKEW SNAPSHOT IX Otorgado NO 0x41414141414A48520000000041 0x00 0x40000000 1 0 0 Bloqueo P interno S Otorgado NO = = = = = = = = = = 2 *LOCAL.mikew.07B492160951 0001 db2bp MIKEW Lock-wait No recogido 819 9 No recogido
Manejador de aplicaciones ID de aplicacin Nmero de secuencia Nombre de la aplicacin ID de autorizacin Estado de la aplicacin Hora de cambio de estado Pgina de cdigos de la aplicacin Bloqueos retenidos Tiempo de espera total (ms) Lista de bloqueos ... Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Recuento de bloqueos Recuento de retenciones Nombre de objeto de bloqueo Tipo de objeto Nombre de espacio de tabla Esquema de tabla Nombre de tabla Modalidad Estado Escalado de bloqueos
= = = = = = = = = = = =
0x00020002000000040000000052 0x00 0x00000001 1 0 4 Fila = USERSPACE1 MIKEW SNAPSHOT U Otorgado NO
392
Command Reference
GET SNAPSHOT
Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Recuento de bloqueos Recuento de retenciones Nombre objeto bloqueo Tipo de objeto Nombre de espacio de tabla Esquema de tabla Nombre de tabla Modalidad Estado Modalidad actual Escalado de bloqueos = = = = = = = = = = = = = 0x00020002000000000000000054 0x00 0x40000001 1 0 2 Tabla = USERSPACE1 MIKEW SNAPSHOT X Convirtiendo IX NO
La informacin de aplicacin adicional aparece cuando el conmutador LOCK est activado, como se muestra en el siguiente fragmento de ejemplo:
... Manejador de aplicaciones ID de aplicacin Nmero de secuencia Nombre de la aplicacin ID de autorizacin Estado de la aplicacin Hora de cambio de estado Pgina de cdigos de la aplicacin Bloqueos retenidos Tiempo de espera total (ms) Subseccin en espera para bloqueo ID de agente que retiene el bloqueo ID de aplicacin que retiene el bloqueo Nombre de bloqueo Atributos de bloqueo Distintivos de liberacin Tipo de objeto de bloqueo Modalidad de bloqueo Modalidad de bloqueo retenida Modalidad de bloqueo solicitada Nombre espacio tabla que retiene bloqueo Esquema de tabla que retiene bloqueo Nombre de tabla que retiene bloqueo Indic. hora inicio espera bloqueo Bloqueo es resultado de escalado ... = = = = = = = = = = = = = = = = = = = = = = = = = 2 *LOCAL.mikew.07B492160951 0001 db2bp MIKEW Lock-wait No recogido 819 9 0 0 3 *LOCAL.mikew.016A92161122 0x00020002000000000000000054 0x00 0x40000001 Tabla Bloqueo exclusivo de intencin (IX) Bloqueo exclusivo de intencin (IX) Bloqueo exclusivo (X) USERSPACE1 MIKEW SNAPSHOT No recogido NO
A continuacin se muestra salida tpica resultante de una peticin de informacin de SQL dinmico:
Resultado instantnea SQL dinmico Nombre de base de datos Va de base de datos = SAMPLE = /home/andrewkm/andrewkm/NODE0000/
393
GET SNAPSHOT
SQL00001/ Nmero de ejecuciones Nmero de compilaciones Peor tiempo de preparacin (ms) Mejor tiempo de preparacin (ms) Filas suprimidas Filas insertadas Filas ledas Filas actualizadas Filas grabadas Clasificaciones de sentencia Tiempo de ejecucin total (seg.ms) Tiempo cpu usuario total (seg.ms) Tiempo cpu sistema total (seg.ms) Texto de la sentencia = = = = = = = = = = = = = = 1 1 83 83 0 0 32 0 0 0 0.029043 0.000000 0.010000 select * from employee
Notas de uso: Para obtener una instantnea de una instancia remota (o una instancia local diferente), es necesario conectarse primero a dicha instancia. Si se especifica un alias de una base de datos que reside en una instancia diferente, se devuelve un mensaje de error. Para obtener algunas estadsticas, es necesario que los conmutadores de supervisor de sistema de bases de datos estn activados. Si el conmutador de registro TIMESTAMP se ha establecido como desactivado, los elementos relativos a la indicacin de la hora informarn No recogido. No se devuelven datos tras una peticin de informacin de tabla si se cumple cualquiera de las condiciones siguientes: v El conmutador de registro TABLE est desactivado. v No se ha accedido a ninguna tabla desde que se activ el conmutador. v No se ha accedido a ninguna tabla desde que se emiti el ltimo mandato RESET MONITOR. No obstante, si se est realizando REORG TABLE o se ha realizado durante este perodo, se devuelve parte de la informacin aunque algunos campos no se visualizan. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. v La palabra clave NODES puede sustituirse por DBPARTITIONNUMS. Informacin relacionada: v Mandato GET MONITOR SWITCHES en la pgina 367
394
Command Reference
GET SNAPSHOT
v Mandato LIST APPLICATIONS en la pgina 435 v Mandato RESET MONITOR en la pgina 631 v Mandato UPDATE MONITOR SWITCHES en la pgina 730
395
HELP Mandato HELP

Permite al usuario invocar ayuda desde el Centro de informacin. Este mandato no est disponible en sistemas basados en UNIX. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
HELP serie-caracteres
Parmetros del mandato: HELP serie-caracteres Cualquier mandato de SQL o DB2 o cualquier otro elemento listado en el Centro de informacin. Ejemplos: A continuacin se muestran ejemplos del mandato HELP: v db2 help Este mandato abre el Centro de informacin de DB2, que contiene informacin acerca de DB2 dividida en categoras, por ejemplo tareas, consulta, manuales, etc. Es equivalente a invocar el mandato db2ic sin parmetros. v db2 help drop Este mandato abre el navegador Web y visualiza informacin acerca de la sentencia DROP de SQL. Es equivalente a invocar el mandato siguiente: db2ic -j drop. El mandato db2ic busca primero la publicacin SQL Reference y luego Command Reference, para una sentencia o un mandato denominado DROP y, a continuacin, visualiza el primero que se encuentra. v db2 help drop database Este mandato inicia una bsqueda ms refinada y hace que se visualice informacin acerca del mandato DROP DATABASE.
396
Command Reference
HELP
Notas de uso: El Centro de informacin debe estar instalado en el sistema del usuario. Los manuales HTML de la biblioteca de DB2 deben estar ubicados en el subdirectorio \sqllib\doc\html. El procesador de lnea de mandatos no sabr si el mandato se ejecuta satisfactoriamente o no y no podr informar sobre condiciones de error.
397
IMPORT Mandato IMPORT

Inserta datos de un archivo externo con un formato de archivo soportado en una tabla, una jerarqua o una vista. LOAD es una alternativa ms rpida, pero el programa de utilidad de carga no da soporte a la carga de datos a nivel de la jerarqua. Autorizacin: v IMPORT, utilizando la opcin INSERT, necesita una de las siguientes: sysadm dbadm Privilegio CONTROL en cada tabla o vista participante Privilegio INSERT y SELECT en cada tabla o vista participante. v IMPORT en una tabla existente, utilizando la opcin INSERT_UPDATE, REPLACE o REPLACE_CREATE, necesita una de las siguientes: sysadm dbadm Privilegio CONTROL en la tabla o vista. v IMPORT en una tabla o una jerarqua que no existe, utilizando la opcin CREATE o REPLACE_CREATE, necesita una de las siguientes: sysadm dbadm Autorizacin CREATETAB en la base de datos y una de las siguientes: - Autorizacin IMPLICIT_SCHEMA en la base de datos, si no existe el nombre de esquema de la tabla - Privilegio CREATEIN en el esquema, si existe el esquema de la tabla. - Privilegio CONTROL en cada subtabla de la jerarqua, si se utiliza la opcin REPLACE_CREATE en la jerarqua entera. v IMPORT en una jerarqua existente, utilizando la opcin REPLACE, necesita una de las siguientes: sysadm dbadm Privilegio CONTROL en cada subtabla de la jerarqua. Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin a la base de datos por omisin.
398
Command Reference
IMPORT
IMPORT FROM nombre-archivo OF tipoarchivo , LOBS FROM , METHOD L ( inicio-columna fin-columna ) , NULL INDICATORS ( , N P ( ( nombre-columna , posicin-columna RESTARTCOUNT n INTO nombre-tabla , ( columna-insercin descripcin jerarqua , ( columna-insercin ) descripcin jerarqua AS ROOT TABLE UNDER nombre-subtabla DATALINK SPECIFICATION espec-datalink ) especs-espaciotabla ) ) MESSAGES archivo-mensajes lista-indicadores-nulos ) vaacceso-lob MODIFIED BY mod-tipoarchivo
COMMITCOUNT n INSERT INSERT_UPDATE REPLACE REPLACE_CREATE CREATE INTO
nombre-tabla
descripcin jerarqua:
ALL TABLES lista-subtablas IN HIERARCHY STARTING nombre-subtabla lista-orden-transversal
lista-subtablas:
, ( nombre-subtabla , ( columna-insercin ) )
lista-orden-transversal:
, ( nombre-subtabla )
especs-espaciotabla:
IN nombre-espaciotabla INDEX IN nombre-espaciotabla LONG IN nombre-espaciotabla
399
IMPORT
espec-datalink:
, ( DL_LINKTYPE URL DL_URL_REPLACE_PREFIX prefijo DL_URL_DEFAULT_PREFIX prefijo DL_URL_SUFFIX sufijo )
Parmetros del mandato: ALL TABLES Palabra clave implcita slo para jerarqua. Cuando se importa una jerarqua, el valor por omisin es importar todas las tablas especificadas en el orden transversal. AS ROOT TABLE Crea una o ms subtablas como jerarqua de tablas autnoma. COMMITCOUNT n Realiza un COMMIT despus de que se hayan importado cada n registros. CREATE Crea la definicin de tabla y el contenido de filas. Si los datos se han exportado de una tabla, una subtabla o una jerarqua DB2, se crean ndices. Si esta opcin opera en un jerarqua y se han exportado datos de DB2, tambin se crear una jerarqua de tipos. Esta opcin slo se puede utilizar con archivos IXF. Nota: Si los datos se han exportado de una base de datos de sistema principal MVS y contienen campos LONGVAR cuyas longitudes, calculadas en el tamao de pgina, son inferiores a 254, puede que CREATE falle porque las filas son demasiado largas. En este caso, se deber crear manualmente la tabla y se deber invocar IMPORT con INSERT o, alternativamente, se deber utilizar el mandato LOAD. DATALINK SPECIFICATION Para cada columna DATALINK, puede haber una especificacin de columna escrita entre parntesis. Cada especificacin de columna consta de uno o ms prefijos DL_LINKTYPE y una especificacin DL_URL_SUFFIX. La especificacin de prefijo puede ser DL_URL_REPLACE_PREFIX o DL_URL_DEFAULT_PREFIX. Pueden existir tantas especificaciones de columna DATALINK como el nmero de columnas DATALINK definidas en la tabla. El orden de las especificaciones sigue el orden de las columnas DATALINK encontradas en la lista de columna-insercin o en la definicin de tabla (si no se especifica una lista de columna-insercin). DL_LINKTYPE Si se especifica, debe coincidir con el LINKTYPE de la definicin de
400
Command Reference
IMPORT
columna. De este modo, DL_LINKTYPE URL es aceptable si la definicin de columna especifica LINKTYPE URL. DL_URL_DEFAULT_PREFIX prefijo Si se especifica, deber actuar como prefijo por omisin para todos los valores DATALINK de la misma columna. En este contexto, prefijo hace referencia a la parte puerta de sistema principal de esquema de la especificacin URL. (Para Distributed File System (Sistema de archivos distribuidos) o DFS, prefijo hace referencia a la parte unin de espacio de archivos de nombre de clula de esquema de la especificacin URL). Son ejemplos de prefijo:
"http://servidor" "file://servidor" "file:" "http://servidor:80" "dfs://.../nombreclula/fs"
Si no se encuentra ningn prefijo en los datos de una columna y se especifica un prefijo por omisin con DL_URL_DEFAULT_PREFIX, el prefijo por omisin se pone como prefijo del valor de columna (si no es NULL). Por ejemplo, si DL_URL_DEFAULT_PREFIX especifica el prefijo por omisin "http://toronto": v El valor de entrada de columna /x/y/z se almacena como http://toronto/x/y/z. v El valor de entrada de columna http://coyote/a/b/c se almacena como http://coyote/a/b/c. v El valor de entrada de columna NULL se almacena como NULL. DL_URL_REPLACE_PREFIX prefijo Esta clusula es til para cargar o importar datos generados anteriormente por el programa de utilidad de exportacin, cuando el usuario desea sustituir de forma global en los datos el nombre de sistema principal por otro nombre de sistema principal. Si se especifica, se convierte en el prefijo para todos los valores de columna no NULL. Si un valor de columna tiene un prefijo, ste lo sustituir. Si un valor de columna no tiene ningn prefijo, se colocar como prefijo del valor de columna el prefijo especificado por DL_URL_REPLACE_PREFIX. Para DFS (Distributed File System), prefijo hace referencia a la parte unin de espacio de archivos de nombre de clula de esquema de la especificacin URL. Por ejemplo, si DL_URL_REPLACE_PREFIX especifica el prefijo "http://toronto":
401
IMPORT
v El valor de entrada de columna /x/y/z se almacena como http://toronto/x/y/z. v El valor de entrada de columna http://coyote/a/b/c se almacena como http://toronto/a/b/c. Observe que toronto sustituye a coyote. v El valor de entrada de columna NULL se almacena como NULL. DL_URL_SUFFIX sufijo Si se especifica, se aade a cada valor de columna no NULL de la columna. De hecho, se aade al componente va de acceso de la parte URL del valor DATALINK. FROM nombre-archivo Especifica el archivo que contiene los datos que se deben importar. Si se omite la va de acceso, se utiliza el directorio de trabajo actual. HIERARCHY Especifica que deben importarse datos jerrquicos. IN nombre-espaciotabla Identifica el espacio de tabla en el que se va a crear la tabla. El espacio de tabla debe existir y debe ser un espacio de tabla REGULAR. Si no se especifica ningn otro espacio de tabla, todas las partes de tabla se almacenan en este espacio de tabla. Si no se especifica esta clusula, la tabla se crea en un espacio de tabla creado por el ID de autorizacin. Si no se encuentra ninguno, se coloca la tabla en el espacio de tabla por omisin USERSPACE1. Si se ha eliminado USERSPACE1, fallar la creacin de tabla. INDEX IN nombre-espaciotabla Identifica el espacio de tabla donde se crearn todos los ndices de la tabla. Esta opcin slo est permitida cuando el espacio de tabla primario que se especifica en la clusula IN es un espacio de tabla DMS. El espacio de tabla especificado debe existir y debe ser un espacio de tabla REGULAR o LARGE DMS. Nota: La especificacin de qu espacio de tabla contendr un ndice slo puede utilizarse al crear la tabla. columna-insercin Especifica el nombre de una columna de la tabla o la vista en la que deben insertarse datos. INSERT Aade los datos importados a la tabla sin cambiar los datos de tabla existentes.
402
Command Reference
IMPORT
INSERT_UPDATE Aade filas de datos importados a la tabla de destino o actualiza las filas existentes (de la tabla de destino) con las claves primarias que coinciden. INTO nombre-tabla Especifica la tabla de base de datos a la que se debern importar los datos. Esta tabla no puede ser una tabla de sistema, una tabla declarada temporal o una tabla de resumen. Se puede utilizar un alias para INSERT, INSERT_UPDATE o REPLACE, excepto en el caso de un servidor de nivel inferior, en que debe utilizarse el nombre de tabla totalmente calificado o no calificado. Un nombre de tabla calificado tiene el formato: esquema.nombretabla. El esquema es el nombre de usuario bajo el que se ha creado la tabla. LOBS FROM vaacceso-lob Especifica una o ms vas de acceso que almacenan archivos LOB. Los nombres de los archivos de datos LOB se almacenan en el archivo de datos principal (ASC, DEL o IXF), en la columna que se cargar en la columna LOB. Esta opcin se ignora si no se especifica el modificador lobsinfile. LONG IN nombre-espaciotabla Identifica el espacio de tabla en el que se almacenarn los valores de todas las columnas largas (tipos de datos LONG VARCHAR, LONG VARGRAPHIC, LOB o los tipos diferenciados con alguno de stos como tipos de fuente). Esta opcin slo est permitida si el espacio de tabla primario especificado en la clusula IN es un espacio de tabla DMS. El espacio de tabla debe existir y debe ser un espacio de tabla LARGE DMS. MESSAGES archivo-mensajes Especifica el destino de los mensajes de aviso y de error que se producen durante una operacin de importacin. Si el archivo ya existe, el programa de utilidad aade la informacin. Si no se especifica la va de acceso completa al archivo, el programa de utilidad utiliza como destino el directorio actual y la unidad por omisin. Si se omite archivo-mensajes, los mensajes se graban en la salida estndar. METHOD L Especifica los nmeros de columna inicial y final de los que se deben importar datos. Un nmero de columna es un desplazamiento de bytes respecto al principio de una fila de datos. Se numera empezando por 1.
403
IMPORT
Nota: Este mtodo slo se puede utilizar con archivos ASC y es la nica opcin vlida para dicho tipo de archivo. N Especifica los nombres de las columnas que se deben importar. Nota: Este mtodo slo se puede utilizar con archivos IXF. P Especifica los ndices (numerados a partir de 1) de los campos de datos de entrada que se deben importar. Nota: Este mtodo slo se puede utilizar con archivos IXF o DEL y es la nica opcin vlida para el tipo de archivo DEL. MODIFIED BY mod-tipoarchivo Especifica opciones adicionales (consulte la Tabla 7 en la pgina 413). NULL INDICATORS lista-indicadores-nulos Esta opcin slo se puede utilizar cuando se especifica el parmetro METHOD L. Es decir, el archivo de entrada es un archivo ASC. Una lista de indicadores nulos es una lista de enteros positivos separados por comas que especifican el nmero de columna de cada campo de indicador nulo. El nmero de columna es el desplazamiento de bytes del campo de indicador nulo respecto al principio de una fila de datos. Tiene que haber una entrada en la lista de indicadores nulos para cada campo de datos definido en el parmetro METHOD L. Un nmero de columna de cero indica que el campo de datos correspondiente siempre contiene datos. Un valor de Y en la columna de indicador NULL especifica que los datos de la columna son NULL. Cualquier carcter distinto de Y en la columna de indicador NULL especifica que los datos de columna no son NULL y que se importarn los datos de columna especificados por la opcin METHOD L. El carcter de indicador NULL puede cambiarse utilizando la opcin MODIFIED BY (consulte la descripcin del modificador nullindchar en la Tabla 7 en la pgina 413). OF tipoarchivo Especifica el formato de los datos del archivo de entrada: v ASC (formato ASCII no delimitado) v DEL (formato ASCII delimitado), utilizado por diversos programas gestores de bases de datos y gestores de archivos v WSF (formato de hoja de trabajo), utilizado por programas tales como: Lotus 1-2-3
404
Command Reference
IMPORT
Lotus Symphony v IXF (formato de intercambio integrado, versin PC), que significa que se ha exportado de la misma o de otra tabla de DB2. Un archivo IXF tambin contiene la definicin de tabla y las definiciones de los ndices existentes, excepto cuando se especifican columnas en la sentencia SELECT. REPLACE Suprime todos los datos existentes de la tabla truncando el objeto de datos e inserta los datos importados. La definicin de tabla y las definiciones de ndice no se modifican. Esta opcin slo se puede utilizar si existe la tabla. No es vlida para tablas con columnas DATALINK. Si se utiliza esta opcin al mover datos entre jerarquas, slo se pueden sustituir los datos de una jerarqua entera, no de subtablas individuales. REPLACE_CREATE Si la tabla existe, suprime todos los datos existentes de la tabla truncando el objeto de datos e inserta los datos importados sin cambiar la definicin de tabla o las definiciones de ndice. Si la tabla no existe, crea las definiciones de tabla y de ndice, as como el contenido de filas. Esta opcin slo se puede utilizar con archivos IXF. No es vlida para tablas con columnas DATALINK. Si se utiliza esta opcin al mover datos entre jerarquas, slo se pueden sustituir los datos de una jerarqua entera, no de subtablas individuales. RESTARTCOUNT n Especifica que se debe iniciar una operacin de importacin en el registro n + 1. Los primeros n registros se saltan. STARTING nombre-subtabla Palabra clave para jerarqua solamente, que solicita el orden por omisin, empezando a partir de nombre-subtabla. Para los archivos PC/IXF, el orden por omisin es el orden almacenado en el archivo de entrada. El orden por omisin es el nico orden vlido para el formato de archivos PC/IXF. lista-subtablas Para tablas de tipo con la opcin INSERT o INSERT_UPDATE, se utiliza una lista de nombres de subtabla para indicar las subtablas a las que deben importarse datos. lista-orden-transversal Para tablas de tipo con la opcin INSERT, INSERT_UPDATE o REPLACE, se utiliza una lista de nombres de subtabla para indicar el orden transversal de las subtablas de importacin de la jerarqua.
405
IMPORT
UNDER nombre-subtabla Especifica una tabla padre para crear una o ms subtablas. Ejemplos: Ejemplo 1 El ejemplo siguiente muestra cmo importar informacin de miarchivo.ixf a la tabla STAFF:
db2 import from miarchivo.ixf of ixf messages msg.txt insert into staff SQL3150N El registro H del archivo PC/IXF tiene el producto "DB2 fecha "19970220" y hora "140848". 01.00",
SQL3153N El registro T del archivo PC/IXF tiene el nombre "miarchivo", calificador " " y fuente " ". SQL3109N El programa de utilidad est iniciando la carga de datos del archivo "miarchivo". SQL3110N El programa de utilidad ha completado el proceso. Se han ledo "58" filas del archivo de entrada. SQL3221W ...Inicie COMMIT WORK. Cuenta de registros de entrada = "58".
SQL3222W ...COMMIT de cualquier cambio de la base de datos ha resultado satisfactorio. SQL3149N Se han procesado "58" filas del archivo de entrada. Se han insertado satisfactoriamente "58" filas en la tabla. Se han rechazado "0" filas.
Ejemplo 2 El ejemplo siguiente muestra cmo importar la tabla MOVIETABLE del archivo de entrada delfile1, que tiene datos en formato DEL:
db2 import from delfile1 of del modified by dldel| insert into movietable (actorname, description, url_making_of, url_movie) datalink specification (dl_url_default_prefix "http://narang"), (dl_url_replace_prefix "http://bomdel" dl_url_suffix ".mpeg")
Notas: 1. La tabla tiene cuatro columnas:

actorname description url_making_of url_movie VARCHAR(n) VARCHAR(m) DATALINK (con LINKTYPE URL) DATALINK (con LINKTYPE URL)
2. Los datos DATALINK del archivo de entrada tienen el carcter de barra vertical (|) como delimitador de subcampo.
406
Command Reference
IMPORT
3. Si ningn valor de columna para url_making_of tiene la secuencia de caracteres de prefijo, se utiliza http://narang. 4. Cada valor de columna no NULL para url_movie obtendr http://bomdel como prefijo. Los valores existentes se sustituyen. 5. A cada valor de columna no NULL para url_movie se le aadir .mpeg a la va de acceso. Por ejemplo, si un valor de columna de url_movie es http://server1/x/y/z, se almacenar como http://bomdel/x/y/z.mpeg; si el valor es /x/y/z, se almacenar como http://bomdel/x/y/z.mpeg. Ejemplo 3 (Importacin a una tabla con una columna de identidad (Identity)) TABLE1 tiene 4 columnas: v C1 VARCHAR(30) v C2 INT GENERATED BY DEFAULT AS IDENTITY v C3 DECIMAL(7,2) v C4 CHAR(1) TABLE2 es igual que TABLE1, excepto que C2 es una columna de identidad que se genera siempre (GENERATED ALWAYS). Registros de datos en DATAFILE1 (formato DEL):
"Liszt" "Hummel",,187.43, H "Grieg",100, 66.34, G "Satie",101, 818.23, I
Registros de datos en DATAFILE2 (formato DEL):

"Liszt", 74.49, A "Hummel", 0.01, H "Grieg", 66.34, G "Satie", 818.23, I
El mandato siguiente genera valores de identidad para las filas 1 y 2, dado que no se proporcionan valores de identidad en DATAFILE1 para dichas filas. Sin embargo, a las filas 3 y 4 se les asignan los valores de identidad proporcionados por el usuario de 100 y 101, respectivamente.
db2 import from datafile1.del of del replace into table1
Para importar DATAFILE1 a TABLE1 de modo que se generen valores de identidad para todas las filas, emita uno de los mandatos siguientes:
407
IMPORT
db2 import replace db2 import replace from into from into datafile1.del of del method P(1, 3, 4) table1 (c1, c3, c4) datafile1.del of del modified by identityignore table1
Para importar DATAFILE2 a TABLE1 de modo que se generen valores de identidad para cada fila, emita uno de los mandatos siguientes:
db2 import from datafile2.del of del replace into table1 (c1, c3, c4) db2 import from datafile2.del of del modified by identitymissing replace into table1
Si se importa DATAFILE1 a TABLE2 sin utilizar ninguno de los modificadores de tipo de archivo relacionados con la identidad, se insertarn las filas 1 y 2, pero se rechazarn las filas 3 y 4 porque proporcionan sus propios valores no NULL y la columna de identidad que se genera siempre (GENERATED ALWAYS). Notas de uso: Asegrese de completar todas las operaciones de tabla y de liberar todos los bloqueos antes de iniciar una operacin de importacin. Esto puede realizarse emitiendo un COMMIT despus de cerrar todos los cursores abiertos WITH HOLD o emitiendo un ROLLBACK. El programa de utilidad de importacin aade filas a la tabla de destino utilizando la sentencia INSERT de SQL. El programa de utilidad emite una sentencia INSERT para cada fila de datos del archivo de entrada. Si falla una sentencia INSERT, se produce una de dos acciones: v Si es probable que las sentencias INSERT subsiguientes puedan ser satisfactorias, se graba un mensaje de aviso en el archivo de mensajes y el proceso contina. v Si es probable que las sentencias INSERT subsiguientes fallen y existen posibilidades de que se dae la base de datos, se graba un mensaje de error en el archivo de mensajes y el proceso se detiene. El programa de utilidad realiza un COMMIT automtico despus de que se hayan suprimido las filas antiguas durante una operacin REPLACE o REPLACE_CREATE. Por consiguiente, si el sistema falla o la aplicacin interrumpe el gestor de bases de datos despus de que se trunque el objeto de tabla, se perdern todos los datos anteriores. Antes de utilizar estas opciones, asegrese de que los datos anteriores ya no son necesarios. Si la anotacin cronolgica se llena durante una operacin CREATE, REPLACE o REPLACE_CREATE, el programa de utilidad realiza un COMMIT automtico en los registros insertados. Si el sistema falla o la aplicacin interrumpe el gestor de bases de datos despus de un COMMIT automtico,
408
Command Reference
IMPORT
permanece en la base de datos una tabla con datos parciales. Utilice la opcin REPLACE o REPLACE_CREATE para volver a ejecutar toda la operacin de importacin, o utilice INSERT con el parmetro RESTARTCOUNT establecido en el nmero de filas importadas satisfactoriamente. Por omisin, los COMMIT automticos no se realizan para la opcin INSERT o INSERT_UPDATE. No obsatnte, se realizan si el parmetro COMMITCOUNT es distinto de cero. Una anotacin cronolgica llena produce un ROLLBACK. Siempre que el programa de utilidad de importacin realiza un COMMIT, se graban dos mensajes en el archivo de mensajes: uno indica el nmero de registros que se deben comprometer y el otro se graba despus de un COMMIT satisfactorio. Cuando reinicie la operacin de importacin despus de una anomala, especifique el nmero de registros que se deben saltar, tal como se determine en el ltimo COMMIT satisfactorio. El programa de utilidad de importacin acepta datos de entrada con problemas de incompatibilidad menores (por ejemplo, se pueden importar datos de tipo carcter utilizando relleno o truncamiento y se pueden importar datos numricos con un tipo de datos numricos diferente), pero no se aceptan datos con problemas de incompatibilidad ms importantes. No se puede utilizar REPLACE o REPLACE_CREATE con una tabla de objetos si sta tiene otros dependientes distintos de ella misma o con una vista de objeto si la tabla base tiene dependientes (incluida ella misma). Para sustituir una tabla o una vista de este tipo, realice lo siguiente: 1. Elimine todas las claves externas en las que la tabla es padre. 2. Ejecute el programa de utilidad de importacin. 3. Modifique la tabla para volver a crear las claves externas. Si se produce un error al volver a crear las claves externas, modifique los datos para mantener la integridad referencial. Las restricciones de referencias y las definiciones de claves externas no se conservan al crear tablas a partir de los archivos PC/IXF. (Las definiciones de claves primarias se conservan si se han exportado anteriormente los datos utilizando SELECT *). La importacin a una base de datos remota requiere suficiente espacio de disco en el servidor para una copia del archivo de datos de entrada, para el archivo de mensajes de salida y para el aumento potencial de tamao de la base de datos.
409
IMPORT
Si se ejecuta una operacin de importacin en una base de datos remota y el archivo de mensajes de salida es muy largo (ms de 60 KB), puede que el archivo de mensajes devuelto al usuario del cliente no incluya los mensajes que se hayan producido durante la operacin de importacin. Los primeros 30 KB de informacin de mensajes y los ltimos 30 KB de informacin de mensajes siempre se retienen. La importacin de archivos PC/IXF a una base de datos remota es mucho ms rpida si el archivo PC/IXF est en una unidad de disco duro en lugar de estar en disquetes. La tabla o la jerarqua de base de datos debe existir antes de poder importar datos en los formatos de archivo ASC, DEL o WSF; sin embargo, si la tabla an no existe, IMPORT CREATE o IMPORT REPLACE_CREATE crear la tabla al importar datos de un archivo PC/IXF. Para las tablas de tipo, IMPORT CREATE tambin puede crear la jerarqua de tipos y la jerarqua de tablas. La importacin PC/IXF deber utilizarse para mover datos (incluidos datos jerrquicos) entre bases de datos. Si los datos de tipo carcter que contienen separadores de filas se exportan a un archivo ASCII delimitado (DEL) y se procesan con un programa de transferencia de texto, los campos que contienen los separadores de filas se reducirn o se expandirn. El paso de copia de archivo no es necesario si se puede acceder a las bases de datos de origen y destino desde el mismo cliente. Se supone que los datos de los archivos ASC y DEL estn en la pgina de cdigos de la aplicacin cliente que realiza la importacin. Se recomiendan los archivos PC/IXF, que permiten diferentes pginas de cdigos, al importar datos de pginas de cdigos diferentes. Si el archivo PC/IXF y el programa de utilidad de importacin estn en la misma pgina de cdigos, el proceso se produce como para una aplicacin normal. Si las dos pginas de cdigos difieren y se especifica la opcin FORCEIN, el programa de utilidad de importacin supone que los datos del archivo PC/IXF tienen la misma pgina de cdigos que la aplicacin que realiza la importacin. Esto se produce incluso si existe una tabla de conversin para las dos pginas de cdigos. Si las dos difieren, no se especifica la opcin FORCEIN y existe una tabla de conversin, todos los datos del archivo PC/IXF se convertirn de la pgina de cdigos del archivo a la pgina de cdigos de la aplicacin. Si las dos difieren, no se especifica la opcin FORCEIN y no existe ninguna tabla de conversin, la operacin de importacin fallar. Esto slo se aplica a archivos PC/IXF de clientes DB2 para AIX. Para objetos de tabla de una pgina de 8 KB que estn cerca del lmite de 1012 columnas, la importacin de archivos de datos PC/IXF puede hacer que DB2 devuelva un error, porque se ha excedido el tamao mximo de una
410
Command Reference
IMPORT
sentencia de SQL. Esta situacin slo se puede producir si las columnas son de tipo CHAR, VARCHAR o CLOB. La restriccin no se aplica a la importacin de archivos DEL o ASC. Si se estn utilizando archivos PC/IXF para crear una nueva tabla, una alternativa consiste en utilizar db2look para volcar la sentencia DDL que cre la tabla y, a continuacin, emitir esa sentencia a travs del CLP. Se puede utilizar DB2 Connect para importar datos a servidores DRDA como, por ejemplo, DB2 para OS/390, DB2 para VM y VSE y DB2 para OS/400. Slo se soporta la importacin PC/IXF (opcin INSERT). El parmetro RESTARTCOUNT tambin est soportado, pero no as el parmetro COMMITCOUNT. Cuando utilice la opcin CREATE con tablas de tipo, cree cada subtabla definida en el archivo PC/IXF; las definiciones de subtabla no se pueden modificar. Cuando utilice opciones distintas de CREATE con tablas de tipo, la lista de orden transversal permite especificar el orden transversal; por consiguiente, la lista de orden transversal debe coincidir con la que se ha utilizado durante la operacin de exportacin. Para el formato de archivo PC/IXF, slo es necesario especificar el nombre de subtabla de destino y utilizar el orden transversal almacenado en el archivo. El programa de utilidad de importacin se puede utilizar para recuperar una tabla exportada anteriormente a un archivo PC/IXF. La tabla vuelve al estado en el que estaba al exportarse. No se pueden importar datos a una tabla de sistema, a una tabla declarada temporal o a una tabla de resumen. No se pueden crear vistas mediante el programa de utilidad de importacin. En el sistema operativo Windows NT: v No se soporta la importacin de archivos PC/IXF subdivididos de forma lgica. v No se soporta la importacin de archivos PC/IXF o WSF de formato incorrecto. Consideraciones acerca de DB2 Data Links Manager Antes de ejecutar el programa de utilidad de importacin de DB2, realice lo siguiente: 1. Copie los archivos a los que se har referencia en los servidores Data Links apropiados. Se puede utilizar el programa de utilidad dlfm_import para extraer archivos de un archivador generado por el programa de utilidad dlfm_export.
411
IMPORT
2. Registre los nombres de prefijo necesarios en los DB2 Data Links Manager. Puede haber otras tareas administrativas, por ejemplo registrar la base de datos, si es necesario. 3. Actualice la informacin de servidor Data Links en los URL (de las columnas DATALINK) a partir de los datos exportados para la tabla SQL, si es necesario. (Si los servidores Data Links de la configuracin original son los mismos en la ubicacin de destino, no es necesario actualizar los nombres de servidores Data Links). Para Distributed File Systems (DFS), actualice la informacin de nombre de clula en los URL (de las columnas DATALINK) a partir de los datos exportados para la tabla SQL, si es necesario. 4. Defina los servidores Data Links de la configuracin de destino en el archivo de configuracin de DB2 Data Links Manager. Para DFS, defina las clulas en la configuracin de destino en el archivo de configuracin de DB2 Data Links Manager. Cuando se ejecuta el programa de utilidad de importacin en la base de datos de destino, los archivos referidos en los datos de la columna DATALINK se enlazan en los servidores de Data Links adecuados. Durante la operacin de insercin, el proceso de columnas DATALINK enlaza los archivos de los servidores Data Links apropiados de acuerdo con las especificaciones de columna de la base de datos de destino.
412
Command Reference
IMPORT
Representacin de la informacin de DATALINK en un archivo de entrada
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) Modificador Descripcin Todos los formatos de archivo compound=x x es un nmero entre 1 y 100 inclusive. Utiliza SQL compuesto no atmico para insertar los datos y se intentarn cada vez x sentencias. Si se especifica este modificador y la anotacin cronolgica de transacciones no es suficientemente grande, la operacin de importacin fallar. La anotacin cronolgica de transacciones debe ser suficientemente grande para dar cabida al nmero de filas especificadas por COMMITCOUNT o al nmero de filas del archivo de datos, si no se especifica COMMITCOUNT. Por lo tanto se recomienda especificar la opcin COMMITCOUNT para evitar el desbordamiento de la anotacin cronolgica de transacciones. Este modificador es incompatible con la modalidad INSERT_UPDATE, las tablas jerrquicas y los modificadores siguientes: usedefaults, identitymissing, identityignore, generatedmissing y generatedignore. generatedignore Este modificador informa al programa de utilidad que los datos para todas las columnas generadas existen en el archivo de datos pero que se debern ignorar. Esto hace que el programa de utilidad genere todos los valores para las columnas generadas. Este modificador no se puede utilizar con el modificador generatedmissing. Si se especifica este modificador, el programa de utilidad supone que el archivo de datos de entrada no contiene datos para las columnas generadas (ni siquiera ningn NULL) y, por consiguiente, generar un valor para cada fila. Este modificador no se puede utilizar con el modificador generatedignore. Este modificador informa al programa de utilidad que los datos para la columna de identidad existen en el archivo de datos pero que se debern ignorar. Esto hace que el programa de utilidad genere todos los valores de identidad. El comportamiento ser el mismo para las columnas de identidad GENERATED ALWAYS y GENERATED BY DEFAULT. Esto significa que, para las columnas GENERATED ALWAYS, no se rechazar ninguna fila. Este modificador no se puede utilizar con el modificador identitymissing.
generatedmissing
identityignore
413
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador identitymissing Descripcin Si se especifica este modificador, el programa de utilidad supone que el archivo de datos de entrada no contiene datos para la columna de identidad (ni siquiera ningn NULL) y, por consiguiente, generar un valor para cada fila. El comportamiento ser el mismo para las columnas de identidad GENERATED ALWAYS y GENERATED BY DEFAULT. Este modificador no se puede utilizar con el modificador identityignore. vaacceso-lob especifica la va de acceso a los archivos que contienen datos de LOB. Cada va de acceso contiene por lo menos un archivo que contiene por lo menos un LOB al que apunta un Especificador de ubicacin de LOB (LLS) en el archivo de datos. El LLS es una representacin de serie de la ubicacin de un LOB en un archivo almacenado en la va de acceso del archivo LOB. El formato de un LLS es nombarch.ext.nnn.mmm/, donde nombarch.ext es el nombre del archivo que contiene el LOB, nnn es el desplazamiento en bytes del LOB dentro del archivo y mmm es la longitud del LOB en bytes. Por ejemplo, si la serie db2exp.001.123.456/ est almacenada en el archivo de datos, el LOB est ubicado en el desplazamiento 123 del archivo db2exp.001 y tiene una longitud de 456 bytes. Para indicar un LOB nulo, entre el tamao como -1. Si el tamao se especifica como 0, se trata como un LOB de longitud 0. Para los LOB nulos de longitud -1, se pasan por alto el desplazamiento y el nombre de archivo. Por ejemplo, el LLS de un LOB nulo puede ser db2exp.001.7.-1/. no_type_id Slo es vlido cuando se est realizando la importacin a una sola subtabla. El uso tpico consiste en exportar datos de una tabla normal y luego invocar una operacin de importacin (utilizando este modificador) para convertir los datos en una sola subtabla.
lobsinfile
414
Command Reference
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador nodefaults Descripcin Si no se especifica explcitamente una columna de origen para una columna de tabla de destino y la columna de tabla no es anulable, no se cargan los valores por omisin. Sin esta opcin, si no se especifica explcitamente una columna de origen para una de las columnas de tabla de destino, se produce una de las siguientes acciones: v Si se puede especificar un valor por omisin para una columna, se carga el valor por omisin v Si la columna es anulable y no se puede especificar un valor por omisin para dicha columna, se carga un NULL v Si la columna no es anulable y no se puede especificar un valor por omisin, se devuelve un error y el programa de utilidad deja de procesarse. usedefaults Si se ha especificado una columna de origen para una columna de tabla de destino, pero dicha columna de origen no contiene datos para una o ms instancias de fila, se cargan los valores por omisin. He aqu unos ejemplos de datos que faltan: v Para archivos DEL: se especifica ",," para la columna v Para archivos ASC: El indicador NULL se establece en yes para la columna v Para archivos DEL/ASC/WSF: Una fila que no tiene suficientes columnas o que no es suficientemente larga para la especificacin original. Sin esta opcin, si la columna de origen no contiene datos para una instancia de fila, se produce una de las acciones siguientes: v Si la columna es anulable, se carga un NULL v Si la columna no es anulable, el programa de utilidad rechaza la fila.
415
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador Descripcin Formatos de archivo ASCII (ASC/DEL) codepage=x x es una serie de caracteres ASCII. El valor se interpreta como la pgina de cdigos de los datos del archivo de salida. Convierte los datos de tipo carcter a esta pgina de cdigos desde la pgina de cdigos de la aplicacin durante la operacin de importacin. Se aplican las siguientes normas: v Para DBCS (grfico) puro, DBCS mixto y EUC, los delimitadores estn restringidos al rango de x00 a x3F, inclusive. v nullindchar debe especificar smbolos incluidos en el conjunto ASCII estndar entre los elementos de cdigo x20 y x7F, inclusive. Esto hace referencia a smbolos y elementos de cdigo ASCII. Notas: 1. El modificador CODEPAGE no se puede utilizar con el modificador LOBSINFILE. 2. Si se produce expansin de datos cuando la pgina de cdigos se convierte desde la pgina de cdigos de la aplicacin a la pgina de cdigos de la base de datos, los datos pueden truncarse y se puede producir una prdida de datos. dateformat=x x es el formato de la fecha en el archivo fuente.a Los elementos de fecha vlidos son: AAAA - Ao (cuatro dgitos entre 0000 y 9999) M - Mes (uno o dos dgitos entre 1 y 12) MM - Mes (dos dgitos en el rango de 1 a 12; se excluyen mutuamente con M) D - Da (uno o dos dgitos entre 1 y 31) DD - Da (dos dgitos en el rango de 1 a 31; se excluyen mutuamente con D) DDD - Da del ao (tres dgitos en el rango de 001 y 366; se excluyen mutuamente con otros elementos de da o mes) Se asigna un valor por omisin de 1 para cada elemento que no se haya especificado. He aqu unos ejemplos de formatos de fecha: "D-M-AAAA" "MM.DD.AAAA" "AAAADDD"
416
Command Reference
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador implieddecimal Descripcin La ubicacin de una coma decimal implcita la determina la definicin de columna; ya no se supone que est al final del valor. Por ejemplo, el valor 12345 se carga en una columna DECIMAL(8,2) como 123,45, no 12345,00. El carcter opcional de fin de archivo x1A no se reconoce como el fin de archivo. El proceso contina como si fuera un carcter normal. x es el formato de la hora en el archivo fuente.a Los elementos de hora vlidos son: - Hora (uno o dos dgitos en el rango de 0 a 12 para un sistema de 12 horas y de 0 a 24 para un sistema de 24 horas) HH - Hora (dos dgitos en el rango de 0 a 12 para un sistema de 12 horas y de 0 a 24 para un sistema de 24 horas; se excluyen mutuamente con H) M - Minuto (uno o dos dgitos en el rango de 0 a 59) MM - Minuto (dos dgitos en el rango de 0 a 59; se excluyen mutuamente con M) S - Segundo (uno o dos dgitos en el rango de 0 a 59) SS - Segundo (dos dgitos en el rango de 0 a 59; se excluyen mutuamente con S) SSSSS - Segundo del da despus de medianoche (5 dgitos entre 00000 y 86399; se excluyen mutuamente con otros elementos de hora) TT - Indicador de meridiano (AM o PM) Se asigna un valor por omisin de 0 para cada elemento que no se ha especificado. He aqu unos ejemplos de formatos de hora: "HH:MM:SS" "HH.MM TT" "SSSSS" H
noeofchar
timeformat=x
417
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador timestampformat=x Descripcin x es el formato de la indicacin de fecha y hora en el archivo fuente.a Los elementos de indicacin de fecha y hora vlidos son: - Ao (cuatro dgitos entre 0000 y 9999) - Mes (uno o dos dgitos en el rango de 1 a 12) MM - Mes (dos dgitos en el rango de 1 a 12; se excluyen mutuamente con M, mes) D - Da (uno o dos dgitos entre 1 y 31) DD - Da (dos dgitos en el rango de 1 a 31; se excluyen mutuamente con D) DDD - Da del ao (tres dgitos en el rango de de 001 a 366; se excluyen mutuamente con otros elementos de da o mes) H - Hora (uno o dos dgitos en el rango de 0 a 12 para un sistema de 12 horas y de 0 a 24 para un sistema de 24 horas) HH - Hora (dos dgitos en el rango de 0 a 12 para un sistema de 12 horas y de 0 a 24 para un sistema de 24 horas; se excluyen mutuamente con H) M - Minuto (uno o dos dgitos en el rango de 0 a 59) MM - Minuto (dos dgitos en el rango de 0 a 59; se excluyen mutuamente con M, minuto) S - Segundo (uno o dos dgitos en el rango de 0 a 59) SS - Segundo (dos dgitos en el rango de 0 a 59; se excluyen mutuamente con S) SSSSS - Segundo del da despus de medianoche (5 dgitos entre 00000 y 86399; se excluyen mutuamente con otros elementos de hora) UUUUUU - Microsegundo (6 dgitos en el rango de 000000 a 999999) TT - Indicador de meridiano (AM o PM) Se asigna un valor por omisin de 1 para los elementos AAAA, M, MM, D, DD o DDD no especificados. Se asigna un valor por omisin de 0 para todos los dems elementos no especificados. A continuacin se muestra un ejemplo de un formato de indicacin de fecha y hora: "AAAA/MM/DD HH:MM:SS.UUUUUU" El ejemplo siguiente ilustra cmo importar datos que contienen formatos de fecha y hora definidos por el usuario a una tabla llamada schedule: db2 import from delfile2 of del modified by timestampformat="aaaa.mm.dd hh:mm tt" insert into schedule AAAA M
418
Command Reference
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador Descripcin Formato de archivo ASC (ASCII no delimitado) nochecklengths Si se especifica nochecklengths, se intenta importar cada fila, incluso si los datos de origen tienen una definicin de columna que excede el tamao de la columna de tabla de destino. Dichas filas pueden importarse satisfactoriamente si la conversin de pgina de cdigos hace que los datos de origen se acorten; por ejemplo, datos EUC de 4 bytes en el origen pueden acortarse a datos DBCS de 2 bytes en el destino y necesitar la mitad del espacio. Esta opcin es especialmente til si se sabe que los datos de origen cabrn en todos los casos a pesar de las discrepancias de las definiciones de columna. x es un carcter individual. Cambia el carcter que indica un valor nulo por el carcter x. El valor por omisin de x es Y.b Este modificador es sensible a las maysculas y minsculas para archivos de datos EBCDIC, excepto cuando el carcter es una letra inglesa. Por ejemplo, si se especifica que el carcter indicador de nulo sea la letra N, se reconoce tambin n como un indicador de nulo. reclen=x x es un entero con un valor mximo de 32.767. Se leen x caracteres para cada fila y no se utiliza un carcter de nueva lnea para indicar el final de la fila. Trunca los espacios en blanco de cola al cargar datos en un campo de longitud variable. Si no se especifica esta opcin, se conservan los espacios en blanco. En el ejemplo siguiente, striptblanks hace que el programa de utilidad de importacin trunque los espacios en blanco de cola: db2 import from miarchivo.asc of asc modified by striptblanks method l (1 10, 12 15) messages msgs.txt insert into staff Esta opcin no se puede especificar junto con striptnulls. Son opciones que se excluyen mutuamente. Nota: Esta opcin sustituye la opcin t obsoleta, que slo se soporta por compatibilidad con niveles anteriores.
nullindchar=x
striptblanks
419
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador striptnulls Descripcin Trunca los NULL de cola (caracteres 0x00) al cargar datos en un campo de longitud variable. Si no se especifica esta opcin, se conservan los NULL. Esta opcin no se puede especificar junto con striptblanks. Son opciones que se excluyen mutuamente. Nota: Esta opcin sustituye la opcin padwithzero obsoleta, que slo se soporta por compatibilidad con niveles anteriores. Formato de archivo DEL (ASCII delimitado) chardelx x es un delimitador de serie de un solo carcter. El valor por omisin son las comillas dobles ("). El carcter especificado se utiliza en lugar de las comillas para encerrar una serie de caracteres.bc Si desea especificar explcitamente las comillas como delimitador de serie de caracteres, debe especificarse de la manera siguiente: modified by chardel"" Tambin se pueden especificar las comillas simples (') como delimitador de serie de caracteres. En el ejemplo siguiente, chardel'' hace que el programa de utilidad de importacin interprete cualquier comilla simple (') que encuentre como un delimitador de serie de caracteres: db2 "import from miarchivo.del of del modified by chardel'' method p (1, 4) insert into staff (id, years)" coldelx x es un delimitador de columna de un solo carcter. El valor por omisin es una coma (,). Se utiliza el carcter especificado en lugar de una coma para indicar el final de una columna.bc En el ejemplo siguiente, coldel; hace que el programa de utilidad de importacin interprete cualquier punto y coma (;) que encuentre como un delimitador de columna: db2 import from miarchivo.del of del modified by coldel; messages msgs.txt insert into staff datesiso decplusblank Formato de fecha. Hace que todos los valores de datos de fecha se importen en formato ISO. Carcter de signo ms. Hace que a los valores decimales positivos se les ponga un espacio en blanco como prefijo en lugar de un signo ms (+). La accin por omisin es poner a los valores decimales positivos un signo ms como prefijo.
420
Command Reference
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador decptx Descripcin x es un sustituto de un solo carcter del punto como carcter de coma decimal. El valor por omisin es un punto (.). Se utiliza el carcter especificado como carcter de coma decimal en lugar de un punto.bc En el ejemplo siguiente, decpt; hace que el programa de utilidad de importacin interprete cualquier punto y coma (;) que encuentre como una coma decimal: db2 "import from miarchivo.del of del modified by chardel' decpt; messages msgs.txt insert into staff" delprioritychar La prioridad por omisin actual para los delimitadores es: delimitador de registro, delimitador de carcter, delimitador de columna. Este modificador protege a las aplicaciones existentes que dependen de la prioridad ms antigua invirtiendo las prioridades de los delimitadores del modo siguiente: delimitador de carcter, delimitador de registro, delimitador de columna. Sintaxis: db2 import ... modified by delprioritychar ... Por ejemplo, dado el archivo de datos DEL siguiente: "Smith, Joshua",4000,34.98<delimitador de fila> "Vincent,<delimitador de fila>, is a manager", ... ... 4005,44.37<delimitador de fila> Si se especifica el modificador delprioritychar, slo habr dos filas en este archivo de datos. El segundo <delimitador de fila> se interpretar como parte de la primera columna de datos de la segunda fila, mientras que el primer y tercer <delimitador de fila> se interpretan como delimitadores de registro reales. Si no se especifica este modificador, habr tres filas en este archivo de datos, cada una de las cuales estar delimitada por un <delimitador de fila>. dldelx x es un delimitador DATALINK de un solo carcter. El valor por omisin es un punto y coma (;). Se utiliza el carcter especificado en lugar de un punto y coma como separador entre campos para un valor DATALINK. Es necesario porque un valor DATALINK puede tener ms de un subvalor. bc Nota: x no debe ser el mismo carcter especificado como delimitador de serie de caracteres, de columna o de fila.
421
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador keepblanks Descripcin Conserva los blancos iniciales y de cola en cada campo de tipo CHAR, VARCHAR, LONG VARCHAR o CLOB. Sin esta opcin, se eliminan todos los espacios en blanco iniciales y de cola que no estn incluidos entre los delimitadores de caracteres y se inserta un NULL en la tabla para todos los campos en blanco. Suprime el reconocimiento de los delimitadores de caracteres dobles. Formato de archivo IXF forcein Indica al programa de utilidad que acepte datos a pesar de las discrepancias de pgina de cdigos y que suprima la conversin entre pginas de cdigos. Se comprueban los campos de destino de longitud fija para verificar que son suficientemente grandes para los datos. Si se especifica nochecklengths, no se realiza ninguna comprobacin y se realiza un intento de importacin de cada fila. indexixf Indica al programa de utilidad que elimine todos los ndices definidos actualmente en la tabla existente y que cree otros nuevos a partir de las definiciones de ndice del archivo PC/IXF. Esta opcin slo se puede utilizar cuando se est sustituyendo el contenido de una tabla. No se puede utilizar con una vista o cuando se especifica una columna-insercin. Utiliza el esquema especificado para el nombre de ndice durante la creacin de ndices. Si no se especifica esquema (pero la palabra clave indexschema s se especifica), se utiliza el ID de usuario de conexin. Si no se especifica la palabra clave, se utiliza el esquema del archivo IXF. Si se especifica nochecklengths, se intenta importar cada fila, incluso si los datos de origen tienen una definicin de columna que excede el tamao de la columna de tabla de destino. Dichas filas pueden importarse satisfactoriamente si la conversin de pgina de cdigos hace que los datos de origen se acorten; por ejemplo, datos EUC de 4 bytes en el origen pueden acortarse a datos DBCS de 2 bytes en el destino y necesitar la mitad del espacio. Esta opcin es especialmente til si se sabe que los datos de origen cabrn en todos los casos a pesar de las discrepancias de las definiciones de columna.
nodoubledel
indexschema=esquema
nochecklengths
422
Command Reference
IMPORT
Tabla 7. Modificadores de tipo de archivo vlidos (Importacin) (continuacin) Modificador Notas: 1. La utilidad de importacin no emite ningn aviso si se intentan utilizar tipos de archivo no soportados con la opcin MODIFIED BY. Si se realiza dicho intento, la operacin de importacin fallar y se devolver un cdigo de error. 2.
a Es obligatorio escribir la serie de formato de fecha entre comillas dobles. Los separadores de campo no pueden contener ninguno de los caracteres siguientes: a-z, A-Z y 0-9. El separador de campo no debe ser igual que el delimitador de carcter o el delimitador de campo en el formato de archivo DEL. Un separador de campo es opcional si las posiciones inicial y final de un elemento no son ambiguas. La ambigedad puede existir si (en funcin del modificador) se usan elementos tales como D, H, M o S, debido a la longitud variable de las entradas.
Descripcin
Para formatos de indicacin de fecha y hora, hay que tener cuidado de evitar la ambigedad entre los descriptores de mes y de minuto, dado que ambos utilizan la letra M. Un campo de mes debe ser adyacente a otros campos de fecha. Un campo de minuto debe ser adyacente a otros campos de hora. He aqu unos formatos ambiguos de indicacin de fecha y hora: "M" (puede ser mes o minuto) "M:M" (Qu es cada uno?) "M:AAAA:M" (Ambos se interpretan como mes). "S:M:AAAA" (adyacente a un valor de hora y un valor de fecha) En los casos ambiguos, el programa de utilidad informar con un mensaje de error y la operacin fallar. He aqu unos formatos no ambiguos de indicacin de fecha y hora: "M:AAAA" (Mes) "S:M" (Minuto) "M:AAAA:S:M" (Mes....Minuto) "M:H:AAAA:M:D" (Minuto....Mes) Nota: Algunos caracteres, como las comillas dobles y las barras inclinadas invertidas, deben ir precedidos de un carcter de escape (por ejemplo \). 3.
b
El carcter debe especificarse en la pgina de cdigos de los datos de origen.
Se puede especificar el elemento de cdigo de carcter (en lugar del smbolo de carcter), utilizando la sintaxis xJJ o 0xJJ, donde JJ es la representacin hexadecimal del elemento de cdigo. Por ejemplo, puede especificar el carcter # como delimitador de columna de una de las maneras siguientes: ... modified by coldel# ... ... modified by coldel0x23 ... ... modified by coldelX23 ... 4.
c Restricciones del delimitador lista las restricciones que se aplican a los caracteres que se pueden utilizar como alteracin temporal de los delimitadores.
423
IMPORT
Informacin relacionada: v db2look -Mandato Herramienta de extraccin de DDL y de estadsticas de DB2 en la pgina 103 v Mandato LOAD en la pgina 481
424
Command Reference
INITIALIZE TAPE Mandato INITIALIZE TAPE

Al ejecutarse en sistemas operativos basados en Windows NT, DB2 da soporte a las operaciones de copia de seguridad y restauracin en dispositivos de cinta de modalidad continua. Utilice este mandato para la inicializacin de cinta. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
INITIALIZE TAPE ON dispositivo USING tamao-bloque
Parmetros del mandato: ON dispositivo Especifica un nombre de dispositivo de cinta vlido. El valor por omisin es \\.\TAPE0. USING tamao-bloque Especifica el tamao de bloque para el dispositivo, en bytes. El dispositivo se inicializa para utilizar el tamao de bloque especificado, si el valor est dentro del rango soportado de tamaos de bloque para el dispositivo. Nota: El tamao de almacenamiento intermedio especificado para el mandato BACKUP DATABASE y para RESTORE DATABASE debe ser divisible por el tamao de bloque especificado aqu. Si no se especifica un valor para este parmetro, el dispositivo se inicializa para utilizar el tamao de bloque por omisin. Si se especifica un valor de cero, el dispositivo se inicializa para utilizar un tamao de bloque de longitud variable; si el dispositivo no soporta la modalidad de bloque de longitud variable, se devuelve un error. Informacin relacionada: v Mandato BACKUP DATABASE en la pgina 216 v Mandato RESTORE DATABASE en la pgina 636 v Mandato REWIND TAPE en la pgina 646
425
INITIALIZE TAPE
v Mandato SET TAPE POSITION en la pgina 678
426
Command Reference
INSPECT Mandato INSPECT

Inspeccione la integridad arquitectnica de la base de datos, comprobando si hay coherencia de pginas en las pginas de la base de datos. La inspeccin comprueba que las estructuras de los objetos de tabla y las estructuras de los espacios de tabla sean vlidas. mbito: En un sistema de una sola particin, el mbito es el de una sola particin. En un sistema de bases de datos particionado, es la coleccin de todas las particiones lgicas definidas en db2nodes.cfg. Autorizacin: Para INSPECT CHECK, es una de los siguientes: v sysadm v dbadm v sysctrl v sysmaint v Privilegio CONTROL si es una sola tabla. Conexin necesaria: Base de datos Sintaxis del mandato:
INSPECT CHECK DATABASE BEGIN TBSPACEID n TABLESPACE TABLE OBJECTID n NAME nombre-espaciotabla TBSPACEID n BEGIN OBJECTID n NAME nombre-tabla SCHEMA nombre-esquema TBSPACEID n OBJECTID n LIMIT ERROR TO DEFAULT RESULTS FOR ERROR STATE ALL LIMIT ERROR TO n ALL Clusula de nivel KEEP nombre-archivo CATALOG TO TABLESPACE CONSISTENCY
Clusula En particin de base de datos
Clusula de nivel:
427
INSPECT
EXTENTMAP NORMAL EXTENTMAP NONE LOW DATA NORMAL DATA NONE LOW BLOCKMAP NORMAL BLOCKMAP NONE LOW
INDEX NORMAL INDEX NONE LOW
LONG NORMAL LONG NONE LOW
LOB NORMAL LOB NONE LOW
Clusula En particin de base de datos:

ON Clusula Lista de particiones de base de datos ALL DBPARTITIONNUMS EXCEPT Clusula Lista de particiones de base de datos
Clusula Lista de particiones de base de datos:

DBPARTITIONNUM DBPARTITIONNUMS
, ( nmero1-particin-bd TO nmero2-particin-bd )
Parmetros del mandato: CHECK Especifica el proceso de comprobacin. DATABASE Especifica toda la base de datos. BEGIN TBSPACEID n Especifica que comience el proceso del espacio de tabla con el nmero de ID de espacio de tabla dado. BEGIN TBSPACEID n OBJECTID n Especifica que comience el proceso de la tabla con el nmero de ID de espacio de tabla dado. TABLESPACE NAME nombre-espaciotabla Especifica un solo espacio de tabla con el nombre de espacio de tabla dado. TBSPACEID n Especifica un solo espacio de tabla con el nmero de ID de espacio de tabla dado.
428
Command Reference
INSPECT
BEGIN OBJECTID n Especifica que comience el proceso de la tabla con el nmero de ID de objeto dado. TABLE NAME nombre-tabla Especifica la tabla con el nombre de tabla dado. SCHEMA nombre-esquema Especifica el nombre de esquema para el nombre de tabla especificado para una operacin de una sola tabla. TBSPACEID n OBJECTID n Especifica la tabla con el nmero de ID de espacio de tabla y el nmero de ID de objeto dados. CATALOG TO TABLESPACE CONSISTENCY Especifica el proceso para incluir la comprobacin de la coherencia de tablas fsicas del espacio de tabla en las tablas listadas en el catlogo. FOR ERROR STATE ALL Para un objeto de tabla con un estado interno que ya indique el estado del error, la comprobacin slo informar de este estado y no explorar el objeto. Especificar esta opcin tendr la exploracin de proceso a travs del objeto aunque el estado interno ya liste el estado del error. LIMIT ERROR TO n Nmero de pginas errneas para un objeto con el fin de limitar el informe. Cuando se alcanza este lmite del nmero de pginas errneas para un objeto, el proceso no continuar la comprobacin del resto del objeto. LIMIT ERROR TO DEFAULT Nmero de pginas errneas por omisin para un objeto con el fin de limitar el informe. Este valor es el tamao de extensin del objeto. Este parmetro es el valor por omisin. LIMIT ERROR TO ALL No hay lmite al nmero de pginas errneas informadas. EXTENTMAP NORMAL Especifica que el nivel de proceso es normal para la correlacin de extensin. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para la correlacin de extensin.
429
INSPECT
LOW DATA NORMAL Especifica que el nivel de proceso es normal para el objeto de datos. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para el objeto de datos. LOW BLOCKMAP NORMAL Especifica que el nivel de proceso es normal para el objeto de correlacin de bloques. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para el objeto de correlacin de bloques. LOW INDEX NORMAL Especifica que el nivel de proceso es normal para el objeto de ndice. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para el objeto de ndice. LOW LONG NORMAL Especifica que el nivel de proceso es normal para el objeto largo. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para el objeto largo. LOW Especifica que el nivel de proceso es bajo para el objeto largo. Especifica que el nivel de proceso es bajo para el objeto de ndice. Especifica que el nivel de proceso es bajo para el objeto de correlacin de bloques. Especifica que el nivel de proceso es bajo para el objeto de datos. Especifica que el nivel de proceso es bajo para la correlacin de extensin.
430
Command Reference
INSPECT
LOB NORMAL Especifica que el nivel de proceso es normal para el objeto LOB. Valor por omisin. NONE Especifica que el nivel de proceso es ninguno para el objeto LOB. LOW Especifica que el nivel de proceso es bajo para el objeto LOB.
RESULTS Especifica el archivo de salida de resultados. El archivo se grabar en la va de acceso del directorio de datos de diagnstico. Si el proceso de comprobacin no encuentra ningn error, este archivo de salida de resultados se borrar al final de la operacin INSPECT. Si el proceso de comprobacin encuentra errores, este archivo de salida de resultados no se borrar al final de la operacin INSPECT. KEEP Especifica mantener siempre el archivo de salida de resultados. nombre-archivo Especifica el nombre del archivo de salida de resultados. ALL DBPARTITIONNUMS Especifica que la operacin ha de realizarse en todas las particiones de base de datos especificadas en el archivo db2nodes.cfg. ste es el valor por omisin si no se especifica una clusula de nodo. EXCEPT Especifica que la operacin ha de realizarse en todas las particiones de base de datos especificadas en el archivo db2nodes.cfg, salvo las especificadas en la lista de nodos. ON DBPARTITIONNUM / ON DBPARTITIONNUMS Realiza la operacin en un conjunto de particiones de base de datos. nmero1-particin-bd Especifica un nmero de particin de base de datos en la lista de particiones de base de datos. nmero2-particin-bd Especifica el segundo nmero de particin de base de datos, de manera que todas las particiones de base de datos desde nmero1-particin-bd hasta nmero2-particin-bd inclusive se incluyen en la lista de particiones de base de datos.
431
INSPECT
Notas de uso: 1. Para las operaciones de comprobacin en objetos de tabla, puede especificarse el nivel de proceso para los objetos. El valor por omisin es el nivel NORMAL, especificando NONE para un objeto que lo excluye. Especificar LOW crear un subconjunto de comprobaciones que se efectan para NORMAL. 2. Puede especificarse la base de datos de comprobacin para empezar desde un espacio de tabla especfico o desde una tabla especfica, indicando el valor de ID para identificar el espacio de tabla o la tabla. 3. Puede especificarse el espacio de tabla de comprobacin para empezar desde una tabla especfica, indicando el valor de ID para identificar la tabla. 4. El proceso de espacios de tabla slo afectar a los objetos que residan en el espacio de tabla. 5. El proceso de inspeccin en lnea acceder a objetos de base de datos utilizando la lectura no comprometida a nivel de aislamiento. El proceso COMMIT se realizar durante el proceso INSPECT. Es aconsejable finalizar la unidad de trabajo emitiendo COMMIT o ROLLBACK antes de invocar INSPECT. 6. El proceso de comprobacin de inspeccin en lnea grabar los resultados de datos de inspeccin no formateados en el archivo de resultados indicado. El archivo se grabar en la va de acceso del directorio de datos de diagnstico. Si el proceso de comprobacin no encuentra ningn error, este archivo de salida de resultados se borrar al final de la operacin INSPECT. Si el proceso de comprobacin encuentra errores, este archivo de salida de resultados no se borrar al final de la operacin INSPECT. Despus de completar el proceso de comprobacin, para ver los detalles de inspeccin, los datos del resultado de la inspeccin se tendrn que formatear con el programa de utilidad db2inspf. El archivo de resultados tendr la extensin de archivo del nmero de particin de base de datos. En un entorno de base de datos particionado, cada particin de base de datos generar su propio archivo de salida de resultados con la extensin correspondiente a su nmero de particin de base de datos. La ubicacin de salida para el archivo de salida de resultados ser la va de acceso de directorio de datos de diagnstico del gestor de bases de datos. Si se especifica el nombre de un archivo que ya existe, la operacin no se procesar y el archivo se tendr que eliminar antes de poder especificar ese nombre de archivo.
432
Command Reference
LIST ACTIVE DATABASES Mandato LIST ACTIVE DATABASES

Visualiza un subconjunto de la informacin listada por el mandato GET SNAPSHOT FOR ALL DATABASES. Una base de datos activa est disponible para que se conecte y la utilice cualquier aplicacin. Para cada base de datos activa, este mandato visualiza lo siguiente: v Nombre de base de datos v Nmero de aplicaciones actualmente conectadas a la base de datos v Va de acceso de base de datos. mbito: Este mandato puede emitirse desde cualquier particin de base de datos que se liste en $HOME/sqllib/db2nodes.cfg. Devuelve la misma informacin desde cualquiera de estas particiones de base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Sintaxis del mandato:
LIST ACTIVE DATABASES AT DBPARTITIONNUM GLOBAL nmero-particin-bd
Parmetros del mandato: AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor. GLOBAL Devuelve un resultado total para todos los nodos de un sistema de bases de datos particionado. Ejemplos: A continuacin se muestra un ejemplo de salida del mandato LIST ACTIVE DATABASES:
433
LIST ACTIVE DATABASES

Bases de datos activas Nombre de base de datos Aplicaciones conectadas actualmente Va de base de datos Nombre de base de datos Aplicaciones conectadas actualmente Va de base de datos = TEST = 0 = /home/smith/smith/NODE0000/SQL00002/ = SAMPLE = 1 = /home/smith/smith/NODE0000/SQL00001/
Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato GET SNAPSHOT en la pgina 374 v Mandato ACTIVATE DATABASE en la pgina 197 v Mandato DEACTIVATE DATABASE en la pgina 298
434
Command Reference
LIST APPLICATIONS Mandato LIST APPLICATIONS

Visualiza en la salida estndar el nombre de programa de aplicacin, el ID de autorizacin (nombre de usuario), el manejador de aplicaciones, el ID de aplicacin y el nombre de base de datos de toda las aplicaciones de base de datos activas. Este mandato tambin puede visualizar opcionalmente el nmero de secuencia, el estado, la hora de cambio de estado y la va de acceso de base de datos de una aplicacin. mbito: Este mandato slo devuelve informacin para la particin de base de datos en la que se emite. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Para listar las aplicaciones para una instancia remota, es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
LIST APPLICATIONS FOR DATABASE DB alias-base-datos
SHOW DETAIL
Parmetros del mandato: FOR DATABASE alias-base-datos Se debe visualizar informacin para cada aplicacin que est conectada con la base de datos especificada. No se visualiza informacin de nombre de base de datos. Si no se especifica esta opcin, el mandato visualiza la informacin para cada aplicacin que est actualmente conectada con cualquier base de datos de la particin de base de datos a la que est actualmente conectado el usuario.
435
LIST APPLICATIONS
La informacin de aplicacin por omisin est compuesta por lo siguiente: v ID de autorizacin v Nombre de programa de aplicacin v Manejador de aplicaciones v ID de aplicacin v Nombre de base de datos. AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor. GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado. SHOW DETAIL La salida incluir la informacin adicional siguiente: v Nm. de secuencia v Estado de la aplicacin v Hora de cambio de estado v Va de acceso de base de datos. Nota: Si se especifica esta opcin, se recomienda que la salida se redirija a un archivo y que el informe se vea con la ayuda de un editor. Puede que las lneas de salida se acomoden cuando se visualizan en la pantalla. Ejemplos: A continuacin se muestra un ejemplo de salida de LIST APPLICATIONS:
Id aut Nombre aplicacin -------- -------------smith db2bp_32 smith db2bp_32 Manejador aplic. ---------12 11 Nombre Nmero de BD agentes ------------------------------ -------- ----*LOCAL.smith.970220191502 TEST 1 *LOCAL.smith.970220191453 SAMPLE 1 Id aplicacin
Notas de uso: El administrador de bases de datos puede utilizar la salida de este mandato como ayuda para la determinacin de problemas. Adems, esta informacin es necesaria si el administrador de bases de datos desea utilizar los mandatos GET SNAPSHOT o FORCE APPLICATION en una aplicacin. Para listar las aplicaciones de una instancia remota (o de una instancia local diferente), es necesario conectarse primero a dicha instancia. Si se especifica
436
Command Reference
LIST APPLICATIONS
FOR DATABASE cuando existe una conexin y la base de datos reside en una instancia que difiere de la instancia de la conexin actual, el mandato fallar. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato GET SNAPSHOT en la pgina 374 v Mandato FORCE APPLICATION en la pgina 333
437
LIST COMMAND OPTIONS Mandato LIST COMMAND OPTIONS

Lista los valores actuales para las variables de entorno: v DB2BQTIME v DB2DQTRY v DB2RQTIME v DB2IQTIME v DB2OPTIONS. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
LIST COMMAND OPTIONS
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida de LIST COMMAND OPTIONS:
Valores de opciones de procesador de lnea de mandatos Tiempo espera proceso fondo (segundos) (DB2BQTIME) Nm. reintentos de conexin en fondo (DB2BQTRY) Tiempo de espera (seg.) en cola peticiones (DB2RQTIME) Tiempo de espera (seg.) en cola de entrada (DB2IQTIME) Opciones de mandatos (DB2OPTIONS) Opcin ------a -c -e -f -l -n -o -p -r -s -t Descripcin ---------------------------------------Visualizar SQLCA Comprometer automticamente Visualizar SQLCODE/SQLSTATE Leer archivo de entrada Registrar mandatos en archivo histrico Eliminar carcter de lnea nueva Visualizar salida Visualizar indicador entrada interactivo Guardar salida en archivo informe Detener ejecucin ante error de mandato Establ. carcter terminacin sentencia = = = = = 1 60 5 5
Valor actual --------------OFF ON OFF OFF OFF OFF ON ON OFF OFF OFF
438
Command Reference
LIST COMMAND OPTIONS

-v -w -z Operacin echo de mandato actual Visualizar mensajes aviso FETCH/SELECT Guardar todas salidas en archivo salida OFF ON OFF
Informacin relacionada: v Mandato UPDATE COMMAND OPTIONS en la pgina 714
439
LIST DATABASE DIRECTORY Mandato LIST DATABASE DIRECTORY

Lista el contenido del directorio de bases de datos del sistema. Si se especifica una va de acceso, se listar el contenido del directorio de bases de datos locales. mbito: Si se emite este mandato sin el parmetro ON vaacceso, se devolver el directorio de bases de datos del sistema. Esta informacin es la misma en todas las particiones de base de datos. Si se especifica el parmetro ON vaacceso, se devolver el directorio de bases de datos locales de dicha va de acceso. Esta informacin no es la misma en todas las particiones de base de datos. Autorizacin: Ninguna Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
LIST DATABASE DB DIRECTORY ON vaacceso unidad
Parmetros del mandato: ON vaacceso/unidad Especifica el directorio de bases de datos locales del que se debe listar informacin. Si no se especifica, se listar el contenido del directorio de bases de datos del sistema. Ejemplos: A continuacin se muestra un ejemplo de salida para un directorio de bases de datos del sistema:
Directorio de bases de datos del sistema Nmero de entradas en directorio = 2 Entrada 1 de base de datos: Alias de base de datos Nombre de base de datos = SAMPLE = SAMPLE
440
Command Reference
LIST DATABASE DIRECTORY

Unidad base de datos = Nivel release base de datos = Comentario = Tipo de entrada del directorio = Nmero particin base datos /home/smith 8.00 Indirecta catlogo = 0
Entrada 2 de base de datos: Alias de base de datos = GDB1 Nombre global de base de datos = /.../cell_name/dir_name/gdb1 Nivel release base de datos = 8.00 Comentario = Base de datos DCE Tipo de entrada del directorio = DCE Nmero particin base datos catlogo = -1 Nmero particin base de datos = 0
A continuacin se muestra un ejemplo de salida para un directorio de bases de datos locales:

Directorio de la base de datos local en /u/smith Nmero de entradas en directorio = 1 Entrada 1 de base de datos: Alias de base de datos = SAMPLE Nombre de base de datos = SAMPLE Directorio base de datos = SQL00001 Nivel release base de datos = 8.00 Comentario = Tipo de entrada del directorio = Inicial Nmero particin base datos catlogo = 0 Nmero particin base de datos = 0
Estos campos se identifican del modo siguiente: Alias de base de datos Valor del parmetro alias al crear o catalogar la base de datos. Si no se ha entrado un alias al catalogar la base de datos, el gestor de bases de datos utiliza el valor del parmetro nombre-base-datos especificado al catalogar la base de datos. Nombre global de base de datos Nombre totalmente calificado que identifica de forma exclusiva la base de datos en el espacio de nombres DCE. Nombre de base de datos Valor del parmetro nombre-base-datos al catalogar la base de datos. Este nombre es generalmente el nombre bajo el que se ha creado la base de datos. Directorio de bases de datos locales Va de acceso en la que reside la base de datos. Este campo slo se rellena si se ha explorado el directorio de bases de datos del sistema.
441

Directorio de base de datos/Unidad de base de datos Nombre del directorio o de la unidad donde reside la base de datos. Este campo slo se rellena si se ha explorado el directorio de bases de datos locales. Nombre de nodo Nombre del nodo remoto. Este nombre corresponde al valor entrado para el parmetro nombrenodo al catalogar la base de datos y el nodo. Nivel release base de datos Nivel de release del gestor de bases de datos que puede operar en la base de datos. Comentario Comentarios asociados con la base de datos que se han entrado al catalogarse sta. Tipo de entrada del directorio Ubicacin de la base de datos: v Una entrada remota describe una base de datos que reside en otro nodo. v Una entrada indirecta describe una base de datos que es local. Se opina que las bases de datos que residen en el mismo nodo que el directorio de bases de datos del sistema hacen referencia de forma indirecta a la entrada inicial (en un directorio de bases de datos locales) y se consideran entradas indirectas. v Una entrada inicial indica que el directorio de base de datos est en la misma va de acceso que el directorio de bases de datos locales. v Una entrada LDAP indica que la informacin de ubicacin de la base de datos est almacenada en un servidor LDAP. Todas las entradas del directorio de bases de datos del sistema son remotas o indirectas. Todas las entradas de los directorios de bases de datos locales se identifican en el directorio de bases de datos del sistema como entradas indirectas. Autentificacin Se utiliza el tipo de autentificacin catalogado en el cliente para determinar si la conexin se est realizando con seguridad de sistema o Kerberos. Nombre principal Especifica un nombre de principal de Kerberos totalmente calificado. Nmero de particin de base de datos Especifica qu nodo es la particin de base de datos del catlogo. sta es la particin de base de datos en la que se ha emitido el mandato CREATE DATABASE.
442
Command Reference

Nmero de particin de base de datos Especifica el nmero que se ha asignado en db2nodes.cfg al nodo donde se ha emitido el mandato. Notas de uso: Puede haber un mximo de ocho exploraciones de directorio de base de datos abiertas por proceso. Para superar esta restriccin para un archivo de proceso por lotes que emite ms de ocho mandatos LIST DATABASE DIRECTORY dentro de una sola sesin de DB2, convierta el archivo de proceso por lotes en un script de shell. El prefijo db2 genera una sesin DB2 nueva para cada mandato. Informacin relacionada: v Mandato CHANGE DATABASE COMMENT en la pgina 278 v Mandato CREATE DATABASE en la pgina 283
443
LIST DATABASE PARTITION GROUPS Mandato LIST DATABASE PARTITION GROUPS

Lista todos los grupos de particiones de base de datos asociados a la base de datos actual. mbito: Este mandato puede emitirse desde cualquier particin de base de datos que se liste en $HOME/sqllib/db2nodes.cfg. Devuelve la misma informacin desde cualquiera de estas particiones de base de datos. Autorizacin: Para los catlogos de sistema SYSCAT.DBPARTITIONGROUPS y SYSCAT.DBPARTITIONGROUPDEF, se necesita una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio CONTROL v Privilegio SELECT. Conexin necesaria: Base de datos Sintaxis del mandato:
LIST DATABASE PARTITION GROUPS SHOW DETAIL
Parmetros del mandato: SHOW DETAIL Especifica que la salida debe incluir la informacin siguiente: v ID de mapa de particionamiento v Nmero de particin de base de datos v Distintivo en uso Ejemplos: A continuacin se muestra un ejemplo de salida del mandato LIST DATABASE PARTITION GROUPS:
DATABASE PARTITION GROUP NAME ----------------------------IBMCATGROUP IBMDEFAULTGROUP 2 registro(s) seleccionado(s).
444
Command Reference
LIST DATABASE PARTITION GROUPS

A continuacin se muestra un ejemplo de salida del mandato LIST DATABASE PARTITION GROUPS SHOW DETAIL:
DATABASE PARTITION GROUP NAME PMAP_ID DATABASE PARTITION NUMBER IN_USE ------------------------------ ------- ------------------------- -----IBMCATGROUP 0 0 Y IBMDEFAULTGROUP 1 0 Y 2 registro(s) seleccionado(s).
Los campos se identifican del modo siguiente: DATABASE PARTITION GROUP NAME Nombre del grupo de particiones de base de datos. El nombre se repite para cada particin de base de datos en el grupo de particiones de base de datos. PMAP_ID ID del mapa de particionamiento. El ID se repite para cada particin de base de datos del grupo de particiones de base de datos. DATABASE PARTITION NUMBER Nmero de la particin de base de datos. IN_USE Uno de cuatro valores: Y D El grupo de particiones de base de datos est utilizando la particin de base de datos. La particin de base de datos se va a eliminar del grupo de particiones de base de datos como resultado de una operacin REDISTRIBUTE DATABASE PARTITION GROUP. Cuando se complete la operacin, la particin de base de datos no se incluir en los informes de LIST DATABASE PARTITION GROUPS. La particin de base de datos se ha aadido al grupo de particiones de base de datos pero no se aade todava a la correlacin de particionamiento. Los contenedores para los espacios de tabla del grupo de particiones de base de datos se han aadido en esta particin de base de datos. El valor se cambia a Y cuando la operacin REDISTRIBUTE DATABASE PARTITION GROUP se completa satisfactoriamente. La particin de base de datos se ha aadido al grupo de particiones de base de datos, pero no se aade todava a la correlacin de particionamiento. Los contenedores para los espacios de tabla del grupo de particiones de base de datos no se han aadido en esta particin de base de datos. Los contenedores de espacios de tabla deben aadirse en la nueva particin de base de datos para cada espacio de tabla del
445
LIST DATABASE PARTITION GROUPS

grupo de particiones de base de datos. El valor cambia a A cuando se han aadido satisfactoriamente los contenedores. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODEGROUPS puede sustituirse por DATABASE PARTITION GROUPS. Informacin relacionada: v Mandato REDISTRIBUTE DATABASE PARTITION GROUP en la pgina 591
446
Command Reference
LIST DATALINKS MANAGERS Mandato LIST DATALINKS MANAGERS

Lista los DB2 Data Links Manager que estn registrados en una base de datos especificada. Autorizacin: Ninguna Sintaxis del mandato:
LIST DATALINKS MANAGERS FOR DATABASE DB nombrebd
Parmetros del mandato: DATABASE nombrebd Especifica un nombre de base de datos. Informacin relacionada: v Mandato ADD DATALINKS MANAGER en la pgina 203 v Mandato DROP DATALINKS MANAGER en la pgina 312
447
LIST DBPARTITIONNUMS Mandato LIST DBPARTITIONNUMS

Lista todas las particiones de base de datos asociadas a la base de datos actual. mbito: Este mandato puede emitirse desde cualquier particin de base de datos que se liste en $HOME/sqllib/db2nodes.cfg. Devuelve la misma informacin desde cualquiera de estas particiones de base de datos. Autorizacin: Ninguna Conexin necesaria: Base de datos Sintaxis del mandato:
LIST DBPARTITIONNUMS
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida del mandato LIST DBPARTITIONNUMS:
DATABASE PARTITION NUMBER ------------------------0 2 5 7 9 5 registro(s) seleccionado(s).
Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODES puede sustituirse por DBPARTITIONNUMS. Informacin relacionada: v Mandato REDISTRIBUTE DATABASE PARTITION GROUP en la pgina 591
448
Command Reference
LIST DCS APPLICATIONS Mandato LIST DCS APPLICATIONS

Visualiza en la salida estndar informacin sobre aplicaciones que estn conectadas con bases de datos de sistema principal a travs de DB2 Connect Enterprise Edition. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Para listar las aplicaciones DCS de una instancia remota, es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
LIST DCS APPLICATIONS SHOW DETAIL EXTENDED
Parmetros del mandato: LIST DCS APPLICATIONS La informacin de aplicacin por omisin incluye: v ID de autorizacin de sistema principal (nombreusuario) v Nombre de programa de aplicacin v Manejador de aplicaciones v ID de aplicacin de salida (luwid). SHOW DETAIL Especifica que la salida debe incluir la informacin adicional siguiente: v ID de aplicacin cliente v Nmero de secuencia de cliente v Alias de base de datos de cliente v v v v v Nombre de nodo de cliente (nombre-n) Nivel de release de cliente Pgina de cdigos de cliente Nmero de secuencia de salida Nombre de base de datos de sistema principal
449
LIST DCS APPLICATIONS

v Nivel de release de sistema principal. EXTENDED Genera un informe ampliado. Este informe incluye todos los campos que se listan al especificar la opcin SHOW DETAIL ms los campos adicionales siguientes: v Estado de aplicacin DCS v Hora de cambio de estado v Plataforma de cliente v Protocolo de cliente v Pgina de cdigos de cliente v ID de proceso de la aplicacin cliente v ID de juego de caracteres codificado (CCSID) de sistema principal. Ejemplos: A continuacin se muestra un ejemplo de salida de LIST DCS APPLICATIONS:
Id aut Manejador Id aplicacin salida aplicac. -------- -------------------- ---------- -------------------------------DDCSUS1 db2bp_s 2 0915155C.139D.971205184245 Nombre aplicacin
A continuacin se muestra un ejemplo de salida de LIST DCS APPLICATIONS EXTENDED:
450
Command Reference

Lista de aplicaciones DCS - Informe ampliado ID aplicacin cliente = 09151251.0AD1.980529194106 Nmero de secuencia = 0001 ID autorizacin = SMITH Nombre de la aplicacin = db2bp Manejador de aplicaciones = 0 Estado de la aplicacin = en espera de respuesta Hora de cambio de estado = No recogido Alias de base de datos de cliente = MVSDB Nodo de cliente = antman Nivel de release de cliente = SQL05020 Plataforma de cliente = AIX Protocolo de cliente = TCP/IP Pgina de cdigos de cliente = 819 ID de proceso de una aplicacin cliente = 38340 ID de inicio de sesin de cliente = user1 ID de aplicacin de sistema principal = G9151251.GAD2.980529194108 Nmero de secuencia = 0000 Nombre base de datos sistema principal = GILROY Nivel de release de sistema principal = DSN05011 CCSID de sistema principal = 500
Notas: 1. El campo de estado de la aplicacin contiene uno de los valores siguientes: conexin pendiente - de salida Indica que se ha emitido la peticin de conexin con una base de datos de sistema principal y que DB2 Connect est esperando a que se establezca la conexin. en espera de peticin Indica que se ha establecido la conexin con la base de datos de sistema principal y que DB2 Connect est esperando una sentencia de SQL de la aplicacin cliente. en espera de respuesta Indica que la sentencia de SQL se ha enviado a la base de datos de sistema principal. 2. La hora de cambio de estado slo se muestra si se ha activado el conmutador UOW del Supervisor del sistema durante el proceso. De lo contrario, aparece No recogido. Notas de uso: El administrador de bases de datos puede utilizar este mandato para comparar las conexiones de aplicacin cliente a la pasarela con las conexiones de sistema principal correspondientes de la pasarela.
451

El administrador de bases de datos tambin puede utilizar la informacin de ID de agente para forzar a aplicaciones especificadas a salir de un servidor DB2 Connect. Informacin relacionada: v Mandato FORCE APPLICATION en la pgina 333
452
Command Reference
LIST DCS DIRECTORY Mandato LIST DCS DIRECTORY

Lista el contenido del directorio DCS (Database Connection Services Servicios de conexin de bases de datos). Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
LIST DCS DIRECTORY
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida de LIST DCS DIRECTORY:
Directorio de los Servicios de conexin de bases de datos (DCS) Nmero de entradas en directorio = 1 Entrada 1 DCS: Nombre de base de datos local Nombre de base de datos destino Nombre peticionario aplicacin Parmetros DCS Comentario Nivel release directorio DCS = = = = = = DB2 DSN_DB_1 Nombre de ubicacin DB2/MVS DSN_DB_1 0x0100
Estos campos se identifican del modo siguiente: Nombre de base de datos local Especifica el alias local de la base de datos de sistema principal de destino. Corresponde al parmetro nombre-base-datos entrado al catalogar la base de datos de sistema principal en el directorio DCS. Nombre de base de datos destino Especifica el nombre de la base de datos de sistema principal a la que se puede acceder. Corresponde al parmetro nombre-base-datos-destino entrado al catalogar la base de datos de sistema principal en el directorio DCS.
453
LIST DCS DIRECTORY

Nombre peticionario aplicacin Especifica el nombre del programa que reside en el peticionario o servidor de aplicaciones. Parmetros DCS Serie que contiene los parmetros de conexin y de entorno operativo a utilizar con el peticionario de la aplicacin. Corresponde a la serie de parmetros entrada al catalogar la base de datos de sistema principal. La serie debe escribirse entre comillas dobles y los parmetros deben estar separados por comas. Comentario Describe la entrada de base de datos. Nivel release directorio DCS Especifica el nmero de versin del programa Distributed Database Connection Services bajo el que se ha creado la base de datos. Notas de uso: El directorio DCS se crea la primera vez que se invoca el mandato CATALOG DCS DATABASE. Se mantiene en la va de acceso/unidad donde se ha instalado DB2 y proporciona informacin acerca de las bases de datos de sistema principal a las que puede acceder la estacin de trabajo si se ha instalado el programa DB2 Connect. Las bases de datos de sistema principal pueden ser: v Bases de datos DB2 UDB en un sistema principal OS/390 y z/OS v Bases de datos DB2 UDB en sistemas principales iSeries v Bases de datos DB2 en sistemas principales VSE & VM Informacin relacionada: v Mandato CATALOG DCS DATABASE en la pgina 255
454
Command Reference
LIST DRDA INDOUBT TRANSACTIONS Mandato LIST DRDA INDOUBT TRANSACTIONS

Proporciona una lista de transacciones que son dudosas entre los peticionarios DRDA y los servidores DRDA. Si se estn utilizando protocolos de compromiso APPC, lista las transacciones dudosas entre las LU asociadas. Si se estn utilizando protocolos de compromiso DRDA, lista las transacciones dudosas entre los gestores de puntos de sincronismo DRDA. Autorizacin: sysadm Conexin necesaria: Instancia Sintaxis del mandato:
LIST DRDA INDOUBT TRANSACTIONS WITH PROMPTING
Parmetros del mandato: WITH PROMPTING Indica que se deben procesar las transacciones dudosas. Si se especifica este parmetro, se inicia una modalidad de dilogo interactiva, que permite al usuario comprometer o retrotraer las transacciones dudosas. Si no se especifica este parmetro, las transacciones dudosas se graban en el dispositivo de salida estndar y no se inicia la modalidad de dilogo interactiva. Nota: No se soporta una opcin de olvidar. Una vez que la transaccin dudosa se ha comprometido o retrotrado, se olvida automticamente la transaccin. La modalidad de dilogo interactiva permite al usuario: v Listar todas las transacciones dudosas (entre l) v Listar el nmero de transaccin dudosa x (entre l, seguido de un nmero de transaccin vlido) v Salir (entre q) v Comprometer el nmero de transaccin x (entre c, seguido de un nmero de transaccin vlido) v Retrotraer el nmero de transaccin x (entre r, seguido de un nmero de transaccin vlido).
455
LIST DRDA INDOUBT TRANSACTIONS

Nota: La letra de mandato debe separarse de su argumento mediante un espacio en blanco. Antes de que se comprometa o retrotraiga una transaccin, se visualizan los datos de la transaccin y se le solicita al usuario que confirme la accin. Notas de uso: Las transacciones dudosas DRDA se producen cuando se pierde la comunicacin entre los coordinadores y los participantes en unidades de trabajo distribuidas. Una unidad de trabajo distribuida permite a un usuario o una aplicacin leer y actualizar datos en mltiples ubicaciones dentro de una sola unidad de trabajo. Dicho trabajo requiere un compromiso ene dos fases. La primera fase solicita a todos los participantes que se preparen para un compromiso. La segunda fase compromete o retrotrae las transacciones. Si un coordinador o un participante queda no disponible despus de la primera fase, las transacciones distribuidas son dudosas. Antes de emitir el mandato LIST DRDA INDOUBT TRANSACTIONS, se debe conectar el proceso de aplicacin a la instancia de SPM (Gestor de puntos de sincronismo) de DB2. Utilice el parmetro de configuracin de gestor de bases de datos nombre_spm como aliasbd en la sentencia CONNECT. Las conexiones TCP/IP, que usan el SPM para coordinar los compromisos, utilizan protocolos de compromiso DRDA en dos fases. Las conexiones APPC utilizan protocolos de compromiso LU6.2 ene dos fases.
456
Command Reference
LIST HISTORY Mandato LIST HISTORY

Lista entradas del archivo histrico. El archivo histrico contiene un registro de sucesos de recuperacin y administrativos. Los sucesos de recuperacin incluyen operaciones de copia de seguridad, de copia de seguridad incremental, de restauracin y de avance completas a nivel de espacios de tabla y bases de datos. Los sucesos adicionales anotados cronolgicamente incluyen la creacin, la modificacin, la eliminacin o la redenominacin de espacio de tabla, la reorganizacin de tabla, la eliminacin de tabla y la carga. Autorizacin: Ninguna Conexin necesaria: Instancia. Debe conectarse a cualquier base de datos remota para ejecutar este mandato en ella. Para una base de datos local, no se necesita una conexin explcita. Sintaxis del mandato:
LIST HISTORY BACKUP ROLLFORWARD DROPPED TABLE LOAD CREATE TABLESPACE ALTER TABLESPACE RENAME TABLESPACE REORG FOR DATABASE DB alias-base-datos ALL SINCE indicfechahora CONTAINING esquema.nombre_objeto nombre_objeto
Parmetros del mandato: HISTORY Lista todos los sucesos que estn actualmente anotados cronolgicamente en el archivo histrico. BACKUP Lista las operaciones de copia de seguridad y restauracin. ROLLFORWARD Lista las operaciones de avance. DROPPED TABLE Lista los registros eliminados.
457
LIST HISTORY
LOAD Lista las operaciones de carga. CREATE TABLESPACE Lista las operaciones de crear y eliminar espacio de tabla. RENAME TABLESPACE Lista las operaciones de redenominacin de espacio de tabla. REORG Lista las operaciones de reorganizacin. ALTER TABLESPACE Lista las operaciones de modificar espacio de tabla. ALL Lista todas las entradas del tipo especificado del archivo histrico.
SINCE indicfechahora Se puede especificar una indicacin de fecha y hora completa (formato aaaammddhhnnss) o un prefijo inicial (mnimo aaaa). Se listan todas las entradas con indicaciones de fecha y hora iguales o mayores a la indicacin de fecha y hora proporcionada. CONTAINING esquema.nombre_objeto Este nombre calificado identifica de forma exclusiva una tabla. CONTAINING nombre_objeto Este nombre no calificado identifica de forma exclusiva un espacio de tabla. FOR DATABASE alias-base-datos Se utiliza para identificar la base de datos cuyo archivo histrico de recuperacin debe listarse. Ejemplos:
db2 list history since 19980201 for sample db2 list history backup containing userspace1 for sample db2 list history dropped table all for db sample
Notas de uso: El informe generado por este mandato contiene los smbolos siguientes:
Operacin A B C D F G L N Crear espacio de tabla Hacer copia de seguridad Cargar copia Tabla eliminada Recuperar en avance Reorganizar tabla Cargar Redenominar espacio de tabla
458
Command Reference
LIST HISTORY
O Q R T U Tipo Tipo de copia de seguridad: F N I O D E Fuera de lnea En lnea Incremental fuera de lnea Incremental en lnea Delta fuera de lnea Delta en lnea Eliminar espacio de tabla Inmovilizar Restaurar Modificar espacio de tabla Descargar
Tipos de avance: E - Fin de anotaciones cronolgicas P - Punto horario Tipos de carga: I - Insertar R - Sustituir Tipos de modificacin de espacio de tabla: C - Aadir contenedores R - Volver a equilibrar Tipos de inmovilizacin: S U X Z Compartimiento de inmovilizacin Actualizacin de inmovilizacin Exclusivo de inmovilizacin Restablecimiento de inmovilizacin
459
LIST INDOUBT TRANSACTIONS Mandato LIST INDOUBT TRANSACTIONS

Proporciona una lista de transacciones que son dudosas. El usuario puede comprometer, retrotraer u olvidar las transacciones dudosas de forma interactiva. El protocolo de compromiso de las dos fases incluye: 1. La fase PREPARE, en la que el gestor de recursos graba las pginas de anotacin cronolgica en disco, para poder responder a una operacin bsica COMMIT o ROLLBACK 2. La fase COMMIT (o ROLLBACK), en la que la transaccin se compromete o se retrotrae realmente. Una transaccin dudosa es aquella que se ha preparado, pero que an no se ha comprometido o retrotrado. mbito: Este mandato devuelve una lista de las transacciones dudosas del nodo ejecutado. Autorizacin: dbadm Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
LIST INDOUBT TRANSACTIONS WITH PROMPTING
Parmetros del mandato: WITH PROMPTING Indica que se deben procesar las transacciones dudosas. Si se especifica este parmetro, se inicia una modalidad de dilogo interactivo, que permite al usuario comprometer, retrotraer u olvidar las transacciones dudosas. Si no se especifica este parmetro, las transacciones dudosas se graban en el dispositivo de salida estndar y no se inicia la modalidad de dilogo interactivo. La modalidad de dilogo interactivo permite al usuario:
460
Command Reference
LIST INDOUBT TRANSACTIONS

v Listar todas las transacciones dudosas (entre l) v Listar el nmero de transaccin dudosa x (entre l, seguido de un nmero de transaccin vlido) v Salir (entre q) v Comprometer el nmero de transaccin x (entre c, seguido de un nmero de transaccin vlido) v Retrotraer el nmero de transaccin x (entre r, seguido de un nmero de transaccin vlido) v Olvidar el nmero de transaccin x (entre f, seguido de un nmero de transaccin vlido). Nota: La letra de mandato debe separarse de su argumento mediante un espacio en blanco. Antes de que se comprometa, se retrotraiga o se olvide una transaccin, se visualizan los datos de la transaccin y se le solicita al usuario que confirme la accin. Ejemplos: A continuacin se muestra un ejemplo de dilogo generado por LIST INDOUBT TRANSACTIONS:
Transacciones dudosas para la base de datos SAMPLE 1. originator: XA appl_id: *LOCAL.DB2.95051815165159 sequence_no: 0001 status: i timestamp: 05-18-1997 16:51:59 auth_id: SMITH log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F93DD A92F8C4FF3000000 0000BD 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: i timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 . . . Escriba el mandato de transaccin dudosa o q para salir. p.e. c 1 compromete heursticamente la transaccin 1. c/r/f/l/q: c 1 1. originator: XA appl_id: *LOCAL.DB2.95051815165159 sequence_no: 0001 status: i timestamp: 05-18-1997 16:51:59 auth_id: SMITH log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F93DD A92F8C4FF3000000
461

0000BD Desea comprometer (COMMIT) heursticamente esta transaccin dudosa? (s/n) s DB20000I El mandato "COMMIT INDOUBT TRANSACTION" ha finalizado satisfactoriamente c/r/f/l/q: c 5 DB20030E "5" no es un nmero de transaccin dudosa vlido. c/r/f/l/q: l Transacciones dudosas para la base de datos SAMPLE 1. originator: XA appl_id: *LOCAL.DB2.95051815165159 sequence_no: 0001 status: c timestamp: 05-18-1997 16:51:59 auth_id: SMITH log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F93DD A92F8C4FF3000000 0000BD 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: i timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 . . . c/r/f/l/q: r 2 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: i timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 Desea retrotraer (ROLLBACK) heursticamente esta transaccin dudosa? (s/n) s DB20000I El mandato "ROLLBACK INDOUBT TRANSACTION" ha finalizado satisfactoriamente c/r/f/l/q: l 2 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: r timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 c/r/f/l/q: f 2 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: r timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM
462
Command Reference

xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 Desea olvidar (FORGET) esta transaccin dudosa? (s/n) s DB20000I El mandato "FORGET INDOUBT TRANSACTION" ha finalizado satisfactoriamente c/r/f/l/q: l 2 2. originator: XA appl_id: *LOCAL.DATABASE.950407161043 sequence_no: 0002 status: f timestamp: 04-07-1997 16:10:43 auth_id: JONES log_full: n type: RM xid: 53514C2000000017 00000000544D4442 00000000002F95FE B62F8C4FF3000000 0000C1 c/r/f/l/q: q
Nota: El mandato LIST INDOUBT TRANSACTIONS devuelve informacin de tipo para mostrar el rol de la base de datos en cada transaccin dudosa: TM RM Indica que la transaccin dudosa est utilizando la base de datos como base de datos de gestor de transacciones. Indica que la transaccin dudosa est utilizando la base de datos como gestor de recursos, lo que significa que es una de las bases de datos que participa en la transaccin, pero no es la base de datos del gestor de transacciones.
Notas de uso: Una transaccin dudosa es una transaccin global que se ha dejado en un estado dudoso. Esto se produce cuando el Gestor de transacciones (TM) o al menos un Gestor de recursos (RM) no queda disponible despus de completar satisfactoriamente la primera fase (es decir, la fase PREPARE) del protocolo de compromiso de dos fases. Los RM no saben si deben comprometer o retrotraer su bifurcacin de la transaccin hasta que el TM pueda consolidar su propia anotacin cronolgica con la informacin de estado dudoso de los RM cuando stos queden disponibles otra vez. Una transaccin dudosa tambin puede existir en un entorno MPP. Si se emite LIST INDOUBT TRANSACTIONS para la base de datos conectada actualmente, el mandato devuelve la informacin sobre las transacciones dudosas de dicha base de datos. Slo se pueden comprometer las transacciones que estn en estado dudoso (i) o que falte acuse de recibo de compomiso (m). Slo se pueden retrotraer las transacciones cuyo estado sea dudoso (i) o finalizado (e).
463

Slo se pueden olvidar las transacciones cuyo estado sea comprometido (c) o retrotrado (r). Nota: En la fase de compromiso de un compromiso de dos fases, el nodo coordinador espera acuses de recibo de compromiso. Si uno o ms nodos no responden (por ejemplo, debido a una anomala del nodo), la transaccin se coloca en estado de falto de acuse de recibo de compromiso. La informacin de la transaccin dudosa slo es vlida en el momento de emitir el mandato. Una vez que se est en modalidad de dilogo interactivo, el estado de la transaccin puede cambiar debido a las actividades externas. Si sucede esto y se intenta procesar una transaccin dudosa que ya no est en un estado apropiado, se visualizar un mensaje de error. Despus de que se produzca este tipo de error, el usuario deber salir (q) del dilogo interactivo y volver a emitir el mandato LIST INDOUBT TRANSACTIONS WITH PROMPTING para renovar la informacin mostrada. Conceptos relacionados: v Configuration considerations for XA transaction managers del manual Administration Guide: Planning
464
Command Reference
LIST NODE DIRECTORY Mandato LIST NODE DIRECTORY

Lista el contenido del directorio de nodos. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
LIST ADMIN NODE DIRECTORY SHOW DETAIL
Parmetros del mandato: ADMIN Especifica nodos de servidor de administracin. SHOW DETAIL Especifica que la salida debe incluir la informacin siguiente: v Nombre de instancia remota v Sistema v Tipo de sistema operativo Ejemplos: A continuacin se muestra un ejemplo de salida de LIST NODE DIRECTORY:
Directorio de nodos Nmero de entradas en directorio = 2 Entrada 1 nodo: Nombre nodo = LANNODE Comentario = Tipo de entrada de directorio = LDAP Protocolo = TCPIP Nombre de sistema principal = LAN.db2ntd3.torolab.ibm.com Nombre de servicio = 50000 Entrada 2 nodo: Nombre nodo Comentario = TLBA10ME =
465
LIST NODE DIRECTORY

Tipo de entrada del directorio = LOCAL Protocolo = TCPIP Nombre del sistema principal = tlba10me Nombre de servicio = 447
A continuacin se muestra un ejemplo de salida de LIST ADMIN NODE DIRECTORY:

Directorio de nodos Nmero de entradas en directorio = 2 Entrada 1 nodo: Nombre nodo Comentario Tipo de entrada del directorio Protocolo Nombre del sistema principal Nombre de servicio Entrada 2 nodo: Nombre nodo = MYDB2DAS Comentario = Tipo de entrada de directorio = LDAP Protocolo = TCPIP Nombre de sistema principal = peng.torolab.ibm.com Nombre de servicio = 523 = LOCALADM = = LOCAL = TCPIP = jaguar = 523
Los campos comunes se identifican del modo siguiente: Nombre nodo Nombre del nodo remoto. Corresponde al nombre entrado para el parmetro nombrenodo al catalogar el nodo. Comentario Comentario asociado con el nodo, entrado al catalogar el nodo. Para cambiar un comentario del directorio de nodos, descatalogue el nodo y luego catalguelo otra vez con el comentario nuevo. Tipo de entrada del directorio LOCAL significa que la entrada se encuentra en el archivo de directorio de nodo local. LDAP significa que la entrada se encuentra en el servidor LDAP o en la antememoria LDAP. Protocolo Protocolo de comunicaciones catalogado para el nodo. Nota: Para obtener informacin sobre los campos asociados con un tipo de nodo especfico, consulte el mandato CATALOG...NODE aplicable.
466
Command Reference
LIST NODE DIRECTORY

Notas de uso: En cada cliente de base de datos se crea y se mantiene un directorio de nodos. ste contiene una entrada para cada estacin de trabajo remota que tiene bases de datos a las que el cliente puede acceder. El cliente DB2 utiliza la informacin de punto final de comunicaciones del directorio de nodos siempre que se solicita una conexin de base de datos o una conexin de instancia. El gestor de bases de datos crea una entrada de nodo y la aade al directorio de nodos cada vez que procesa un mandato CATALOG...NODE. Las entradas pueden variar, en funcin del protocolo de comunicaciones que est utilizando el nodo. El directorio de nodos puede contener entradas para los tipos siguientes de nodos: v APPC v APPCLU v v v v v APPN LDAP Local rea de interconexin con nombre NetBIOS
v TCP/IP. Informacin relacionada: v Mandato CATALOG APPC NODE en la pgina 244 v Mandato CATALOG TCP/IP NODE en la pgina 274 v v v v Mandato Mandato Mandato Mandato CATALOG NETBIOS NODE en la pgina 270 CATALOG LOCAL NODE en la pgina 264 CATALOG APPN NODE en la pgina 247 CATALOG NAMED PIPE NODE en la pgina 267
v Mandato CATALOG LDAP NODE en la pgina 262
467
LIST ODBC DATA SOURCES Mandato LIST ODBC DATA SOURCES

Lista todas las fuentes de datos ODBC de sistema o de usuario disponibles. Una fuente de datos, en terminologa de ODBC (Open Database Connectivity Conectividad de bases de datos abiertas), es un nombre definido por el usuario para una base de datos especfica. Dicho nombre se utiliza para acceder a la base de datos o al sistema de archivos mediante las API ODBC. En Windows, se pueden catalogar fuentes de datos de usuario o de sistema. Una fuente de datos de usuario slo est visible para el usuario que la ha catalogado, mientras que una fuente de datos de sistema est visible para todos los dems usuarios y todos ellos la pueden utilizar. Este mandato slo est disponible en Windows. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
USER LIST SYSTEM ODBC DATA SOURCES
Parmetros del mandato: USER Lista solamente las fuentes de datos ODBC de usuario. Es el valor por omisin si no se especifica ninguna palabra clave. SYSTEM Lista solamente las fuentes de datos ODBC de sistema. Ejemplos: A continuacin se muestra un ejemplo de salida del mandato LIST ODBC DATA SOURCES:
Fuentes de datos ODBC de usuario Nombre de fuente de datos Descripcin -------------------------------- ---------------------------------------SAMPLE IBM DB2 ODBC DRIVER
468
Command Reference
LIST ODBC DATA SOURCES

Informacin relacionada: v Mandato CATALOG ODBC DATA SOURCE en la pgina 273 v Mandato UNCATALOG ODBC DATA SOURCE en la pgina 701
469
LIST PACKAGES/TABLES Mandato LIST PACKAGES/TABLES

Lista los paquetes o las tablas que estn asociados con la base de datos actual. Autorizacin: Para el catlogo de sistema SYSCAT.PACKAGES (LIST PACKAGES) y SYSCAT.TABLES (LIST TABLES), se necesita una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio CONTROL v Privilegio SELECT. Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
LIST PACKAGES TABLES FOR USER ALL SCHEMA SYSTEM SHOW DETAIL nombre-esquema
Parmetros del mandato: FOR Si no se especifica la clusula FOR, se listan los paquetes o las tablas para USER. ALL Lista todos los paquetes o todas las tablas de la base de datos.
SCHEMA Lista todos los paquetes o todas las tablas de la base de datos solamente para el esquema especificado. SYSTEM Lista todos los paquetes o todas las tablas de sistema de la base de datos. USER Lista todos los paquetes o todas las tablas de usuario de la base de datos para el usuario actual. SHOW DETAIL Si se elige esta opcin con el mandato LIST TABLES, se visualizan el nombre de tabla y el nombre de esquema completos. Si no se especifica esta opcin, el nombre de tabla se trunca a 30 caracteres y el smbolo > de la trigsimo primera columna representa la parte truncada del nombre de tabla y el nombre de esquema se trunca a 14
470
Command Reference
LIST PACKAGES/TABLES
caracteres y el smbolo > de la decimoquinta columna representa la parte truncada del nombre de esquema. Si se elige esta opcin con el mandato LIST PACKAGES, se visualizan el esquema de paquete completo (creador), la versin y el authid vinculado, y el unique_id de paquete (la seal de coherencia se muestra en formato hexadecimal). Si no se especifica esta opcin, el nombre de esquema e ID vinculado se truncan a 8 caracteres y el smbolo > de la novena columna representa la parte truncada del esquema o ID vinculado; la versin se trunca a 10 caracteres y el smbolo > de la undcima columna representa la parte truncada de la versin. Ejemplos: A continuacin se muestra un ejemplo de salida de LIST PACKAGES:
Paquete ---------F4INS F4INS F4INS F4INS PKG12 PKG15 SALARY Esquema --------USERA USERA USERA USERA USERA USERA USERT Versin ---------VER1 VER2.0 VER2.3 VER2.5 YEAR2000 Enlazado Total de por secciones --------- -----------SNOWBELL 221 SNOWBELL 201 SNOWBELL 201 SNOWBELL 201 USERA 12 USERA 42 USERT 15 Vlido -----Y Y N Y Y Y Y Formato ------0 0 3 0 3 3 3 Nivel de aislam. --------CS RS CS CS RR RR CS Bloqueo -------U U U U B B N
Lo siguiente es un ejemplo de salida de LIST TABLES:

Tabla/Vista -----------------DEPARTMENT EMP_ACT EMP_PHOTO EMP_RESUME EMPLOYEE ORG PROJECT SALES STAFF Esquema ---------------SMITH SMITH SMITH SMITH SMITH SMITH SMITH SMITH SMITH Tipo ---------T T T T T T T T T Hora de creacin ---------------------------1997-02-19-13.32.25.971890 1997-02-19-13.32.27.851115 1997-02-19-13.32.29.953624 1997-02-19-13.32.37.837433 1997-02-19-13.32.26.348245 1997-02-19-13.32.24.478021 1997-02-19-13.32.29.300304 1997-02-19-13.32.42.973739 1997-02-19-13.32.25.156337
9 registro(s) seleccionado(s).
Notas de uso: Los mandatos LIST PACKAGES y LIST TABLES estn disponibles para proporcionar una interfaz rpida para las tablas del sistema. Las sentencias SELECT siguientes devuelven informacin encontrada en las tablas del sistema. Se pueden expandir para seleccionar la informacin adicional que proporcionan las tablas del sistema.
471
LIST PACKAGES/TABLES
select tabname, tabschema, type, create_time from syscat.tables order by tabschema, tabname; select pkgname, pkgschema, pkgversion, unique_id, boundby, total_sect, valid, format, isolation, blocking from syscat.packages order by pkgschema, pkgname, pkgversion; select tabname, tabschema, type, create_time from syscat.tables where tabschema = SYSCAT order by tabschema, tabname; select pkgname, pkgschema, pkgversion, unique_id, boundby, total_sect, valid, format, isolation, blocking from syscat.packages where pkgschema = NULLID order by pkgschema, pkgname, pkgversion; select tabname, tabschema, type, create_time from syscat.tables where tabschema = USER order by tabschema, tabname; select pkgname, pkgschema, pkgversion, unique_id, boundby, total_sect, valid, format, isolation, blocking from syscat.packages where pkgschema = USER order by pkgschema, pkgname, pkgversion;
Conceptos relacionados: v Vistas de catlogo del manual Consulta de SQL, Volumen 1 v Efficient SELECT statements del manual Administration Guide: Performance
472
Command Reference
LIST TABLESPACE CONTAINERS Mandato LIST TABLESPACE CONTAINERS

Lista contenedores para el espacio de tabla especificado. Nota: La instantnea de espacio de tabla contiene toda la informacin visualizada por el mandato LIST TABLESPACE CONTAINERS. mbito: Este mandato slo devuelve informacin para el nodo en el que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Base de datos Sintaxis del mandato:
LIST TABLESPACE CONTAINERS FOR id-espaciotabla SHOW DETAIL
Parmetros del mandato: FOR id-espaciotabla Entero que representa de forma exclusiva un espacio de tabla utilizado por la base de datos actual. Para obtener una lista de todos los espacios de tabla utilizados por la base de datos actual, utilice el mandato LIST TABLESPACES. SHOW DETAIL Si no se especifica esta opcin, slo se proporciona la informacin bsica siguiente acerca de cada contenedor: v ID de contenedor v Nombre v Tipo (archivo, disco o va de acceso). Si se especifica esta opcin, se proporciona la informacin adicional siguiente acerca de cada contenedor:
473
LIST TABLESPACE CONTAINERS

v Nmero total de pginas v Nmero de pginas utilizables v Accesible (s o no). Ejemplos: A continuacin se muestra un ejemplo de salida de LIST TABLESPACE CONTAINERS:
Contenedores de espacio tabla para espacio tabla 0 ID de contenedor Nombre Tipo = 0 = /home/smith/smith/NODE0000/ SQL00001/SQLT0000.0 = Va
A continuacin se muestra un ejemplo de salida de LIST TABLESPACE CONTAINERS con SHOW DETAIL especificado:
Contenedores de espacio tabla para espacio tabla 0 ID de contenedor Nombre Tipo Pginas totales Pginas utilizables Accesible = 0 = /home/smith/smith/NODE0000/ SQL00001/SQLT0000.0 = Va = 895 = 895 = S
Conceptos relacionados: v Snapshot monitor del manual System Monitor Guide and Reference Informacin relacionada: v Mandato LIST TABLESPACES en la pgina 475
474
Command Reference
LIST TABLESPACES Mandato LIST TABLESPACES

Lista espacios de tabla para la base de datos actual. Nota: La informacin visualizada por este mandato tambin est disponible en la instantnea de espacio de tabla. mbito: Este mandato slo devuelve informacin para el nodo en el que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm v load Conexin necesaria: Base de datos Sintaxis del mandato:
LIST TABLESPACES SHOW DETAIL
Parmetros del mandato: SHOW DETAIL Si no se especifica esta opcin, slo se proporcionar la informacin bsica siguiente acerca de cada espacio de tabla: v ID de espacio de tabla v Nombre v Tipo (espacio gestionado por el sistema o espacio gestionado por la base de datos) v Contenido (datos cualesquiera, datos largos o de ndice o datos temporales) v Estado, valor hexadecimal que indica el estado actual del espacio de tabla. El estado visible externamente de un espacio de tabla se compone de la suma hexadecimal de determinados valores de estado. Por ejemplo, si el estado es inmovilizada: EXCLUSIVE y
475
LIST TABLESPACES
Carga pendiente, el valor es 0x0004 + 0x0008, que es 0x000c. Se puede utilizar el mandato db2tbst (Obtener estado de espacio de tabla) para obtener el estado de espacio de tabla asociado con un valor hexadecimal determinado. He aqu las definiciones de bit listadas en sqlutil.h:
0x0 0x1 0x2 0x4 0x8 0x10 0x20 0x40 0x80 0x100 0x100 0x200 0x400 0x800 0x1000 0x2000 0x4000 0x8000 0x2000000 0x4000000 0x8000000 0x10000000 0x20000000 0x40000000 0x8 Normal Inmovilizada: SHARE Inmovilizada: UPDATE Inmovilizada: EXCLUSIVE Carga pendiente Supresin pendiente Copia de seguridad pendiente Recuperacin en proceso Recuperacin (en avance) pendiente Restauracin pendiente Recuperacin (recovery) pendiente (no se utiliza) Inhabilitacin pendiente Reorganizacin en proceso Copia de seguridad en proceso El almacenamiento debe estar definido Restauracin en proceso Fuera de lnea y no accesible Eliminacin pendiente Puede que el almacenamiento est definido Definicin de almacenamiento en estado final Defin. de almacen. cambiada antes de recup. en avan. Reequilibrador DMS activo Supresin de espacio de tabla en curso Creacin de espacio de tabla en curso Para uso de servicio solamente
Si se especifica esta opcin, se proporciona la informacin adicional siguiente acerca de cada espacio de tabla: v Nmero total de pginas v Nmero de pginas utilizables v Nmero de pginas utilizadas v v v v v v Nmero de pginas libres Marca de lmite (en pginas) Tamao de pgina (en bytes) Tamao de extensin (en pginas) Tamao captacin previa (en pginas) Nmero de contenedores
v Tiempo mnimo de recuperacin (slo se visualiza si no es cero) v ID de espacio de tabla de cambio de estado (slo se visualiza si el estado del espacio de tabla es carga pendiente o supresin pendiente)
476
Command Reference
LIST TABLESPACES
v ID de objeto de cambio de estado (slo se visualiza si el estado del espacio de tabla es carga pendiente o supresin pendiente) v Nmero de inmovilizadores (slo se visualiza si el estado del espacio de tabla es inmovilizada: SHARE, inmovilizada: UPDATE o inmovilizada: EXCLUSIVE) v ID de espacio de tabla e ID de objeto para cada inmovilizador (slo se visualiza si el nmero de inmovilizadores es mayor que cero). Ejemplos: A continuacin se muestran dos ejemplos de salida de LIST TABLESPACES SHOW DETAIL.
Espacios de tabla para base de datos actual ID de espacio de tabla = 0 Nombre = SYSCATSPACE Tipo = Espacio gestionado por el sistema Contenido = Cualquier dato Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 895 Pginas utilizables = 895 Pginas utilizadas = 895 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID de espacio de tabla = 1 Nombre = TEMPSPACE1 Tipo = Espacio gestionado por el sistema Contenido = Datos temporales Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 1 Pginas utilizables = 1 Pginas utilizadas = 1 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID de espacio de tabla = 2 Nombre = USERSPACE1 Tipo = Espacio gestionado por el sistema Contenido = Cualquier dato Estado = 0x000c Explicacin detallada:
477
LIST TABLESPACES
Inmovilizada: EXCLUSIVE Carga pendiente Pginas totales = 337 Pginas utilizables = 337 Pginas utilizadas = 337 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID espacio de tabla cambio de estado = 2 ID objeto de cambio de estado = 3 Nmero de inmovilizadores = 1 Inmovilizador 1: ID de espacio de tabla = 2 ID de objeto = 3 DB21011I En un entorno de servidor de base de datos particionada, slo se listan los espacios de tabla del nodo actual. Espacios de tabla para base de datos actual ID de espacio de tabla = 0 Nombre = SYSCATSPACE Tipo = Espacio gestionado por el sistema Contenido = Cualquier dato Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 1200 Pginas utilizables = 1200 Pginas utilizadas = 1200 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID de espacio de tabla = 1 Nombre = TEMPSPACE1 Tipo = Espacio gestionado por el sistema Contenido = Datos temporales Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 1 Pginas utilizables = 1 Pginas utilizadas = 1 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID de espacio de tabla = 2 Nombre = USERSPACE1
478
Command Reference
LIST TABLESPACES
Tipo = Espacio gestionado por el sistema Contenido = Cualquier dato Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 1 Pginas utilizables = 1 Pginas utilizadas = 1 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 4096 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 ID de espacio de tabla = 3 Nombre = DMS8K Tipo = Espacio gestionado por la base de datos Contenido = Cualquier dato Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 2000 Pginas utilizables = 1952 Pginas utilizadas = 96 Pginas libres = 1856 Marca de lmite (pginas) = 96 Tamao pgina (bytes) = 8192 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 2 ID de espacio de tabla = 4 Nombre = TEMP8K Tipo = Espacio gestionado por el sistema Contenido = Datos temporales Estado = 0x0000 Explicacin detallada: Normal Pginas totales = 1 Pginas utilizables = 1 Pginas utilizadas = 1 Pginas libres = No aplicable Marca de lmite (pginas) = No aplicable Tamao pgina (bytes) = 8192 Tamao extensin (pginas) = 32 Tamao captacin previa (pginas) = 32 Nmero de contenedores = 1 DB21011I En un entorno de servidor de base de datos particionada, slo se listan los espacios de tabla del nodo actual.
Notas de uso: En un entorno de bases de datos particionado, este mandato no devuelve todos los espacios de tabla en la base de datos. Para obtener una lista de todos los espacios de tabla, consulte SYSCAT.SYSTABLESPACES.
479
LIST TABLESPACES
Durante un reequilibrado de espacio de tabla, el nmero de pginas utilizables incluir pginas para el contenedor recin aadido, pero estas pginas nuevas no se reflejarn en el nmero de pginas libres hasta que el reequilibrado se haya completado. Cuando no haya un reequilibrado de espacio de tabla en proceso, el nmero de pginas utilizadas ms el nmero de pginas libres ser igual al nmero de pginas utilizables. Informacin relacionada: v Mandato LIST TABLESPACE CONTAINERS en la pgina 473 v db2tbst -Mandato Obtener estado de espacio de tabla en la pgina 169
480
Command Reference
LOAD Mandato LOAD

Carga datos en una tabla DB2. Los datos que residen en el servidor pueden estar en forma de archivo, cinta o rea de interconexin con nombre. Los datos que residen en un cliente conectado remotamente pueden estar en forma archivo totalmente calificado o rea de interconexin con nombre. Los datos pueden cargarse tambin desde un cursor definido por el usuario. El programa de utilidad de carga no soporta la carga de datos a nivel de jerarqua. mbito: Este mandato puede emitirse para varias particiones de base de datos en una sola peticin. Autorizacin: Una de las siguientes: v sysadm v dbadm v Autorizacin de carga en la base de datos y privilegio INSERT en la tabla cuando se invoca el programa de utilidad de carga en modalidad INSERT, en modalidad TERMINATE (para terminar una operacin de insercin de carga anterior) o en modalidad RESTART (para reiniciar una operacin de insercin de carga anterior) privilegio INSERT y DELETE en la tabla cuando el programa de utilidad de carga se invoca en modalidad REPLACE, en modalidad TERMINATE (para terminar una operacin de sustitucin de carga anterior) o en modalidad RESTART (para reiniciar una operacin de sustitucin de carga anterior) privilegio INSERT en la tabla de excepcin, si dicha tabla se utiliza como parte de la operacin de carga. Nota: Dado que todos los procesos de carga (y todos los procesos de servidor DB2, en general) son propiedad del propietario de instancia y todos estos procesos utilizan la identificacin del propietario de instancia para acceder a los archivos necesarios, el propietario de instancia debe tener acceso de lectura a los archivos de datos de entrada. El propietario de instancia debe poder leer estos archivos de datos de entrada, independientemente de quin invoque el mandato.
481
LOAD
Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Instancia. No se necesita una conexin explcita. Si se ha establecido una conexin a la base de datos, se intenta una conexin implcita a la instancia local. Sintaxis del mandato:
, LOAD CLIENT FROM nombre-archivo nombreainterc dispositivo nombrecursor OF tipoarchivo , LOBS FROM vaacceso-lob
MODIFIED BY
mod-tipoarchivo
, METHOD L ( inicio-columna fin-columna ) , NULL INDICATORS ( , N P ( ( nombre-columna , posicin-columna ) ) lista-indicadores-nulos )
SAVECOUNT n
ROWCOUNT n
WARNINGCOUNT n
MESSAGES archivo-mensajes
TEMPFILES PATH nombvaacceso-temp
INSERT REPLACE RESTART TERMINATE
INTO nombre-tabla , ( columna-insercin )
DATALINK SPECIFICATION
espec-datalink
FOR EXCEPTION nombre-tabla
YES STATISTICS WITH DISTRIBUTION AND DETAILED AND FOR NO INDEXES ALL DETAILED INDEXES ALL
482
Command Reference
LOAD
NO YES
COPY
USE TSM OPEN nm-ses SESSIONS , TO dispositivo/directorio LOAD nombre-bibl OPEN nm-ses SESSIONS
NONRECOVERABLE
WITHOUT PROMPTING
DATA BUFFER tamao-almacint
CPU_PARALLELISM n
DISK_PARALLELISM n
INDEXING MODE
AUTOSELECT REBUILD INCREMENTAL DEFERRED
ALLOW NO ACCESS ALLOW READ ACCESS USE nombre-espaciotabla CHECK PENDING CASCADE IMMEDIATE DEFERRED LOCK WITH FORCE
PARTITIONED DB CONFIG opcin-bd-particionada opcin-bd-particionada
espec-datalink:
, ( DL_LINKTYPE URL DL_URL_REPLACE_PREFIX prefijo DL_URL_DEFAULT_PREFIX prefijo DL_URL_SUFFIX sufijo )
Parmetros del mandato: ALLOW NO ACCESS La carga bloquear la tabla de destino para su acceso exclusivo durante la carga. El estado de tabla se establecer en LOAD IN PROGRESS durante la carga. ALLOW NO ACCESS es el comportamiento por omisin. Es la nica opcin vlida para LOAD REPLACE. Cuando hay restricciones en la tabla, el estado de tabla se establecer en CHECK PENDING as como en LOAD IN PROGRESS. Debe utilizarse el mandato SET INTEGRITY para sacar la tabla de CHECK PENDING.
483
LOAD
ALLOW READ ACCESS La carga bloquear la tabla de destino en modalidad de comparticin. El estado de la tabla se establecer en LOAD IN PROGRESS y READ ACCESS. Los lectores pueden acceder a la parte no delta de los datos mientras se carga la tabla. En otras palabras, los lectores de la tabla podrn acceder a los datos que existan antes del inicio de la carga y los datos que se estn cargando no estarn disponibles hasta que se haya completado la carga. LOAD TERMINATE o LOAD RESTART de una carga ALLOW READ ACCESS pueden utilizar esta opcin; LOAD TERMINATE o LOAD RESTART de la carga ALLOW NO ACCESS no puede utilizar esta opcin. Adems, esta opcin no es vlida si los ndices de la tabla de destino estn marcados como que necesitan reconstruccin. Cuando hay restricciones en la tabla, el estado de la tabla se establecer en CHECK PENDING as como LOAD IN PROGRESS, y READ ACCESS. Al final de la carga, el estado de tabla LOAD IN PROGRESS se eliminar, pero los estados de tabla CHECK PENDING y READ ACCESS permanecern. Debe utilizarse el mandato SET INTEGRITY para sacar la tabla de CHECK PENDING. Mientras la tabla est en los estados CHECK PENDING y READ ACCESS, la porcin no delta de los datos sigue siendo accesible para los lectores y la nueva porcin (delta) de los datos seguir siendo inaccesible hasta que se haya completado el mandato SET INTEGRITY. Un usuario puede realizar varias cargas de la misma tabla sin emitir un mandato SET INTEGRITY. Sin embargo, slo los datos originales (comprobados) seguirn visibles hasta que se emita el mandato SET INTEGRITY. ALLOW READ ACCESS tambin soporta los siguientes modificadores: USE nombre-espaciotabla Si se estn reconstruyendo los ndices, se construye una copia duplicada del ndice en el espacio de tabla nombre-espaciotabla y se copia al espacio de tabla original al final de la carga durante INDEX COPY PHASE. Con esta opcin slo se pueden utilizar espacios de tabla temporales del sistema. Si entonces no se especifica, el ndice duplicado se crear en el mismo espacio de tabla que el objeto de ndice. Si la copia duplicada se crea en el espacio de tabla como objeto de ndice, la copia del objeto de ndice duplicado sobre el antiguo objeto de ndice es instantnea. Si la copia duplicada est en un espacio de tabla diferente del objeto de ndice, se realiza una copia fsica. Esto podra implicar una E/S y tiempo considerables. La copia se produce mientras la tabla est fuera de lnea al final de una carga durante INDEX COPY PHASE.
484
Command Reference
LOAD
Sin esta opcin, el ndice duplicado se construye en el mismo espacio de tabla que el original. Dado que tanto el ndice original como el duplicado por omisin residen simultneamente en el mismo espacio de tabla, es posible que no haya espacio suficiente para mantener ambos ndices en un mismo espacio de tabla. El uso de esta opcin asegura que se retiene suficiente espacio de tabla para los ndices. Esta opcin se pasa por alto si el usuario no especifica INDEXING MODE REBUILD o INDEXING MODE AUTOSELECT. Esta opcin tambin se pasar por alto si se elige INDEXING MODE AUTOSELECT y la carga elige actualizar el ndice de forma incremental. CHECK PENDING CASCADE Si LOAD pone la tabla en un estado de pendiente de comprobacin, la opcin CHECK PENDING CASCADE permite al usuario especificar si el estado de pendiente de comprobacin de la tabla cargada se transmite inmediatamente en cascada a todos los descendientes (incluidas las tablas de clave fornea descendientes, las tablas de consulta materializadas inmediatas descendientes y las tablas por fases inmediatas descendientes). IMMEDIATE Indica que el estado de pendiente de comprobacin (modalidad de lectura o sin acceso) para las restricciones de claves forneas se extiende inmediatamente a todas las tablas de clave fornea descendientes. Si la tabla tiene tablas de consulta materializadas inmediatas descendientes o tablas por fases inmediatas descendientes, el estado de pendiente de comprobacin se extiende inmediatamente a las tablas de consulta materializadas y las tablas por fases. Tenga en cuenta que, para una operacin LOAD INSERT, el estado de pendiente de comprobacin no se extiende a las tablas de clave fornea descendientes aunque se especifique la opcin IMMEDIATE. Cuando, posteriormente, se comprueba si hay violaciones de restricciones en la tabla cargada (utilizando la opcin IMMEDIATE CHECKED de la sentencia SET INTEGRITY), las tablas de clave fornea descendientes que se pusieron en estado de lectura pendiente de comprobacin se pondrn en estado de pendiente de comprobacin sin acceso. DEFERRED Indica que slo la tabla cargada se pondr en el estado de pendiente de comprobacin (modalidad de lectura o de sin acceso). Los estados de las tablas de clave fornea
485
LOAD
descendientes, las tablas de consulta materializadas inmediatas descendientes y las tablas por fases inmediatas descendientes seguirn sin cambios. Las tablas de clave fornea descendientes pueden ponerse ms tarde implcitamente en estado de pendiente de comprobacin sin acceso cuando se comprueba si hay violaciones de restricciones en las tablas padres (utilizando la opcin IMMEDIATE CHECKED de la sentencia SET INTEGRITY). Las tablas de consulta materializadas inmediatas y las tablas por fases inmediatas descendientes se colocarn implcitamente en el estado de pendiente de comprobacin sin acceso cuando se comprueba si hay violaciones de integridad en una de sus tablas subyacentes. Se emitir un aviso (SQLSTATE 01586) para indicar que se han colocado tablas dependientes en el estado de pendiente de comprobacin. Vea la seccin de Notas de la sentencia SET INTEGRITY en la publicacin SQL Reference para averiguar cundo se pondrn las tablas descendientes en el estado de pendiente de comprobacin. Si no se especifica la opcin CHECK PENDING CASCADE: v Slo la tabla cargada se pondr en el estado de pendiente de comprobacin. El estado de las tablas de clave fornea descendientes, las tablas de consulta materializadas inmediatas descendientes y las tablas por fases inmediatas descendientes permanecern sin cambios y, posteriormente, se pueden poner implcitamente en el estado de pendiente de comprobacin cuando se comprueba si hay violaciones de restricciones en la tabla cargada. Si LOAD no pone la tabla de destino en el estado de pendiente de comprobacin, se pasa por alto la opcin CHECK PENDING CASCADE. CLIENT Especifica que los datos que se deben cargar residen en un cliente conectado de forma remota. Esta opcin se ignora si la operacin de carga no se est invocando desde un cliente remoto. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR. Notas: 1. Los modificadores DUMPFILE y LOBSINFILE hacen referencia a los archivos del servidor, incluso cuando se especifica la palabra clave CLIENT. 2. La conversin de pgina de cdigos no se realiza durante una operacin de carga remota. Si la pgina de cdigos de los datos es
486
Command Reference
LOAD
diferente de la del servidor, se deber especificar la pgina de cdigos de datos utilizando el modificador CODEPAGE. En el ejemplo siguiente, un archivo de datos (/u/user/data.del) que reside en un cliente conectado de forma remota se debe cargar en MITABLA en la base de datos del servidor:
db2 load client from /u/user/data.del of del modified by codepage=850 insert into mitabla
COPY NO Especifica que el espacio de tabla en el que reside la tabla se colocar en estado de pendiente de copia de seguridad si se habilita la recuperacin en avance (es decir, est activado logretain o userexit). COPY NO pondr tambin el estado del espacio de tabla en estado de espacio de tabla Carga en proceso. ste es un estado transitorio que desaparecer cuando la carga se complete o termine anormalmente. Los datos de cualquier tabla del espacio de tabla no se pueden actualizar o suprimir hasta que se realice una copia de seguridad del espacio de tabla o una copia de seguridad de la base de datos completa. Sin embargo, es posible acceder a los datos de cualquier tabla utilizando la sentencia SELECT. COPY YES Especifica que se guardar una copia de los datos cargados. Esta opcin no es vlida si se inhabilita la recuperacin en avance (logretain y userexit estn desactivados). Esta opcin no se soporta para tablas con columnas DATALINK. USE TSM Especifica que la copia se almacenar utilizando Tivoli Storage Manager (TSM). OPEN nm-ses SESSIONS Nmero de sesiones de E/S que deben utilizarse con TSM o el producto del proveedor. El valor por omisin es 1. TO dispositivo/directorio Especifica el dispositivo o el directorio en el que se crear la imagen de copia. LOAD nombre-bibl Nombre de la biblioteca compartida (DLL en los sistemas operativos Windows) que contiene las funciones de E/S de copia de seguridad y restauracin de proveedor que hay que utilizar. Puede contener la va de acceso completa. Si no se proporciona la va de acceso completa, se tomar por omisin la va de acceso donde residen los programas de salida de usuario.
487
LOAD
CPU_PARALLELISM n Especifica el nmero de procesos o hebras que el programa de utilidad de carga generar para analizar, convertir y formatear registros al crear objetos de tabla. Este parmetro est diseado para aprovechar el paralelismo entre particiones. Es especialmente til al cargar datos clasificados previamente, porque se conserva el orden de registro de los datos de origen. Si el valor de este parmetro es cero o no se ha especificado, el programa de utilidad de carga utiliza un valor inteligente por omisin (generalmente basado en el nmero de CPU disponibles) en la ejecucin. Notas: 1. Si se utiliza este parmetro con tablas que contienen campos LOB o LONG VARCHAR, su valor se convierte en uno, independientemente del nmero de CPU de sistema o del valor especificado por el usuario. 2. Si se especifica un valor pequeo para el parmetro SAVECOUNT, el cargador realiza muchas ms operaciones de E/S para desechar datos y metadatos de tabla. Cuando CPU_PARALLELISM es mayor que uno, las operaciones de desecho son asncronas, permitiendo al cargador aprovechar la CPU. Cuando CPU_PARALLELISM se establece en uno, el cargador atiende la E/S durante los puntos de coherencia. Una operacin de carga con CPU_PARALLELISM establecido en dos y SAVECOUNT establecido en 10.000 se realiza ms rpidamente que la misma operacin con CPU_PARALLELISM establecido en uno, aunque slo haya una CPU. DATA BUFFER tamao-almacint Especifica el nmero de pginas de 4 KB (independientemente del grado de paralelismo) que se deben utilizar como espacio de almacenamiento intermedio para transferir datos dentro del programa de utilidad. Si el valor especificado es menor que el mnimo algortmico, se utilizar el recurso mnimo necesario y no se devolver ningn aviso. Esta memoria se asigna directamente desde la pila del programa de utilidad, cuyo tamao puede modificarse mediante el parmetro de configuracin de base de datos util_heap_sz. Si no se especifica un valor, el programa de utilidad calcula un valor por omisin inteligente en la ejecucin. El valor por omisin se basa en un porcentaje del espacio libre disponible en la pila del programa de utilidad en el tiempo de creacin de instancias del cargador, as como en algunas caractersticas de la tabla. DATALINK SPECIFICATION Para cada columna DATALINK, puede haber una especificacin de
488
Command Reference
LOAD
columna escrita entre parntesis. Cada especificacin de columna consta de uno o ms prefijos DL_LINKTYPE y una especificacin DL_URL_SUFFIX. La especificacin de prefijo puede ser DL_URL_REPLACE_PREFIX o DL_URL_DEFAULT_PREFIX. Pueden existir tantas especificaciones de columna DATALINK como el nmero de columnas DATALINK definidas en la tabla. El orden de las especificaciones sigue el orden de las columnas DATALINK encontradas en la lista de columna-insercin o en la definicin de tabla (si no se especifica una lista de columna-insercin). DISK_PARALLELISM n Especifica el nmero de procesos o hebras que el programa de utilidad de carga generar para grabar datos en los contenedores de espacio de tabla. Si no se especifica un valor, el programa de utilidad selecciona un valor por omisin inteligente basndose en el nmero de contenedores de espacio de tabla y en las caractersticas de la tabla. DL_LINKTYPE Si se especifica, debe coincidir con el LINKTYPE de la definicin de columna. De este modo, DL_LINKTYPE URL es aceptable si la definicin de columna especifica LINKTYPE URL. DL_URL_DEFAULT_PREFIX prefijo Si se especifica, deber actuar como prefijo por omisin para todos los valores DATALINK de la misma columna. En este contexto, prefijo hace referencia a la parte puerta de sistema principal de esquema de la especificacin URL. (Para Distributed File System (Sistema de archivos distribuidos) o DFS, prefijo hace referencia a la parte unin de espacio de archivos de nombre de clula de esquema de la especificacin URL). Son ejemplos de prefijo:
"http://servidor" "file://servidor" "file:" "http://servidor:80" "dfs://.../nombreclula/fs"
Si no se encuentra ningn prefijo en los datos de columna y se especifica un prefijo por omisin con DL_URL_DEFAULT_PREFIX, el prefijo por omisin se pone como prefijo del valor de columna (si no es NULL). Por ejemplo, si DL_URL_DEFAULT_PREFIX especifica el prefijo por omisin "http://toronto": v El valor de entrada de columna /x/y/z se almacena como http://toronto/x/y/z.
489
LOAD
v El valor de entrada de columna http://coyote/a/b/c se almacena como http://coyote/a/b/c. v El valor de entrada de columna NULL se almacena como NULL. DL_URL_REPLACE_PREFIX prefijo Esta clusula es til al cargar o importar datos generados anteriormente por el programa de utilidad de exportacin, si el usuario desea sustituir de forma global en los datos el nombre de sistema principal por otro nombre de sistema principal. Si se especifica, se convierte en el prefijo para todos los valores de columna no NULL. Si un valor de columna tiene un prefijo, ste lo sustituir. Si un valor de columna no tiene ningn prefijo, se colocar como prefijo del valor de columna el prefijo especificado por DL_URL_REPLACE_PREFIX. Para DFS (Distributed File System), prefijo hace referencia a la parte unin de espacio de archivos de nombre de clula de esquema de la especificacin URL. Por ejemplo, si DL_URL_REPLACE_PREFIX especifica el prefijo "http://toronto": v El valor de entrada de columna /x/y/z se almacena como http://toronto/x/y/z. v El valor de entrada de columna http://coyote/a/b/c se almacena como http://toronto/a/b/c. Observe que toronto sustituye a coyote. v El valor de entrada de columna NULL se almacena como NULL. DL_URL_SUFFIX sufijo Si se especifica, se aade a cada valor de columna no NULL de la columna. De hecho, se aade al componente va de acceso de la parte de ubicacin de datos del valor DATALINK. FOR EXCEPTION nombre-tabla Especifica la tabla de excepcin en la que se copiarn las filas errneas. Se copiar cualquier fila que est violando un ndice exclusivo o un ndice de claves primarias. En la tabla de excepcin tambin se capturan las excepciones DATALINK. Si se especifica un nombre de tabla no calificado, la tabla se calificar con CURRENT SCHEMA. La informacin que se graba en la tabla de excepcin no se graba en el archivo de vuelco. En un entorno de bases de datos particionado, se debe definir una tabla de excepcin para las particiones en las que se ha definido la tabla de carga. Por otra parte, el archivo de vuelcos contiene filas que no se pueden cargar porque no son vlidas o tienen errores de sintaxis. FROM nombrearchivo/nombrereainterc/dispositivo/nombrecursor Especifica el archivo, el rea de interconexin de memoria, el
490
Command Reference
LOAD
dispositivo o el cursor que hace referencia a una sentencia SQL que contiene los datos que se estn cargando. Si el origen de la entrada es un archivo, un rea de interconexin de memoria o un dispositivo, debe residir en la particin de base de datos donde reside la base de datos, a menos que se especifique la opcin CLIENT. Si se especifican varios nombres, stos se procesarn en secuencia. Si el ltimo elemento especificado es un dispositivo de cinta, se le solicitar al usuario otra cinta. Las opciones de respuesta vlidas son: c Continuar. Continuar utilizando el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando se ha montado una cinta nueva). Terminacin de dispositivo. Dejar de utilizar el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando no hay ms cintas). Terminar. Terminar todos los dispositivos.
Notas: 1. Se recomienda utilizar el nombre de archivo totalmente calificado. Si el servidor es remoto, se deber utilizar el nombre de archivo totalmente calificado. Si la base de datos reside en la misma particin de base de datos que el llamante, se pueden utilizar vas de acceso relativas. 2. Se soporta la carga de datos de mltiples archivos IXF si los archivos estn fsicamente separados pero lgicamente forman un solo archivo. No se soporta si los archivos estn fsica y lgicamente separados. (Mltiples archivos fsicos se consideraran uno slo lgicamente si se hubiesen creado todos con una sola invocacin del mandato EXPORT.) 3. Si se cargan datos que residen en una mquina cliente, los datos deben estar en forma de archivo totalmente calificado o de rea de interconexin con nombre. INDEXING MODE Especifica si el programa de utilidad de carga debe volver a crear ndices o si debe ampliarlos de forma incremental. Los valores vlidos son: AUTOSELECT El programa de utilidad de carga decidir automticamente entre la modalidad REBUILD o INCREMENTAL. REBUILD Se volvern a crear todos los ndices. El programa de utilidad debe tener suficientes recursos para clasificar todas las partes de claves de ndice para los datos de tabla antiguos y aadidos.
491
LOAD
INCREMENTAL Se ampliarn los ndices con datos nuevos. Esta propuesta consume espacio libre de ndice. Slo necesita suficiente espacio de clasificacin para aadir claves de ndice para los registros insertados. Este mtodo slo se soporta en casos en los que el objeto de ndice es vlido y est accesible al principio de una operacin de carga (por ejemplo, no es vlido inmediatamente despus de una operacin de carga en la que se ha especificado la modalidad DEFERRED). Si se especifica esta modalidad pero no se soporta debido al estado del ndice, se devuelve un aviso y la operacin de carga contina en modalidad REBUILD. De forma similar, si se empieza una operacin de reinicio de carga en la fase de creacin de carga, no se soporta la modalidad INCREMENTAL. La creacin de ndices incremental no se soporta cuando se cumplen todas las condiciones siguientes: v Se especifica la opcin LOAD COPY (se ha habilitado logretain o userexit). v La tabla reside en un espacio de tabla DMS. v El objeto de ndice reside en un espacio de tabla que est compartido por otros objetos de tabla que pertenecen a la tabla que se est cargando. Para ignorar esta restriccin, se recomienda colocar los ndices en un espacio de tabla independiente. DEFERRED El programa de utilidad de carga no intentar la creacin de ndices si se especifica esta modalidad. Los ndices se marcarn como que necesitan una renovacin. El primer acceso a tales ndices que no est relacionado con una operacin de carga puede forzar una reconstruccin o puede que se vuelvan a construir los ndices cuando se reinicie la base de datos. Este planteamiento necesita suficiente espacio de clasificacin para todas las partes clave del ndice ms grande. El tiempo total tomado subsiguientemente para la construccin de ndices es mayor que el necesario en la modalidad REBUILD. Por consiguiente, al efectuar mltiples operaciones de carga con creacin de ndices diferida, es aconsejable (desde un punto de vista de rendimiento) dejar que la ltima operacin de carga de la secuencia realice una reconstruccin de ndices, en lugar de dejar que los ndices se vuelvan a crear en el primero acceso que no sea de carga.
492
Command Reference
LOAD
La creacin de ndices diferida slo se soporta para tablas con ndices no exclusivos, de modo que las claves duplicadas insertadas durante la fase de carga no son permanentes despus de la operacin de carga. Nota: La creacin de ndices diferida no se soporta para tablas que tienen columnas DATALINK. INSERT Una de cuatro modalidades bajo las que se puede ejecutar el programa de utilidad de carga. Aade los datos cargados a la tabla sin cambiar los datos de tabla existentes. columna-insercin Especifica la columna de tabla en la que deben insertarse los datos. El programa de utilidad de carga no puede analizar columnas cuyos nombres contienen uno o ms espacios. Por ejemplo,
db2 load from delfile1 of del modified by noeofchar noheader method P (1, 2, 3, 4, 5, 6, 7, 8, 9) insert into table1 (BLOB1, S2, I3, Int 4, I5, I6, DT7, I8, TM9)
fallar debido a la columna Int 4. La solucin consiste en escribir entre comillas dobles dichos nombres de columna:
db2 load from delfile1 of del modified by noeofchar noheader method P (1, 2, 3, 4, 5, 6, 7, 8, 9) insert into table1 (BLOB1, S2, I3, "Int 4", I5, I6, DT7, I8, TM9)
INTO nombre-tabla Especifica la tabla de base de datos en la que deben cargarse los datos. Esta tabla no puede ser una tabla de sistema o una tabla declarada temporal. Se puede especificar un alias o el nombre de tabla totalmente calificado o no calificado. Un nombre de tabla calificado tiene el formatoesquema.nombretabla. Si se especifica un nombre de tabla no calificado, la tabla se calificar con CURRENT SCHEMA. LOBS FROM vaacceso-lob Va de acceso a los archivos de datos que contienen los valores LOB que se deben cargar. La va de acceso debe finalizar con una barra inclinada (/). Si se especifica la opcin CLIENT, la va de acceso debe estar totalmente calificada. Los nombres de los archivos de datos LOB se almacenan en el archivo de datos principal (ASC, DEL o IXF), en la columna que se cargar en la columna LOB. Esta opcin se pasa por alto si no se especifica lobsinfile en la serie mod-tipoarchivo. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR. LOCK WITH FORCE El programa de utilidad adquiere varios bloqueos, incluidos los
493
LOAD
bloqueos de tabla en proceso de carga. En lugar de esperar, y posiblemente exceder el tiempo de espera, al adquirir un bloqueo, esta opcin permite que la carga fuerce otras aplicaciones que retienen bloqueos que estn en conflicto. Las aplicaciones forzadas se retrotraern y se liberarn los bloqueos que necesita el programa de utilidad de carga. Entonces, el programa de utilidad de carga podr continuar. Esta opcin requiere la misma autorizacin que el mandato FORCE APPLICATIONS (SYSADM o SYSCTRL). Las cargas ALLOW NO ACCESS pueden forzar las aplicaciones que contienen bloqueos en conflicto al comienzo de la operacin de carga. Al inicio de la carga, el programa de utilidad puede forzar aplicaciones que intentan consultar o modificar la tabla. Las cargas ALLOW READ ACCESS pueden forzar las aplicaciones que contienen bloqueos en conflicto al comienzo o al final de la operacin de carga. Al inicio de la carga, el programa de utilidad de carga puede forzar aplicaciones que intentan modificar la tabla. Al final de la carga, el programa de utilidad de carga puede forzar aplicaciones que intentan consultar o modificar la tabla. MESSAGES archivo-mensajes Especifica el destino para los mensajes de aviso y error que se producen durante la operacin de carga. Si no se especifica un archivo de mensajes, los mensajes se graban en la salida estndar. Si no se especifica la va de acceso completa al archivo, el programa de utilidad de carga utiliza el directorio actual y la unidad por omisin como destino. Si se especifica el nombre de un archivo que ya existe, el programa de utilidad aade la informacin. El archivo de mensajes se llena generalmente de mensajes al final de la operacin de carga y, por este motivo, no es adecuado para supervisar el proceso de la operacin. METHOD L Especifica los nmeros de columna inicial y final de los que se deben cargar datos. Un nmero de columna es un desplazamiento de bytes respecto al principio de una fila de datos. Se numera empezando por 1. Nota: Este mtodo slo se puede utilizar con archivos ASC y es el nico mtodo vlido para dicho tipo de archivo. N Especifica los nombres de las columnas del archivo de datos que se deben cargar. Las maysculas y minsculas de estos nombres de columna deben coincidir con las maysculas y minsculas de los nombres correspondientes en los catlogos del sistema. Cada columna de tabla que no sea anulable debe
494
Command Reference
LOAD
tener una entrada correspondiente en la lista METHOD N. Por ejemplo, dados los campos de datos F1, F2, F3, F4, F5 y F6 y las columnas de tabla C1 INT, C2 INT NOT NULL, C3 INT NOT NULL y C4 INT, el mtodo N (F2, F1, F4, F3) es una peticin vlida, mientras que el mtodo N (F2, F1) no es vlido. Nota: Este mtodo slo se puede utilizar con archivos de tipo IXF o CURSOR. P Especifica los nmeros de campo (numerados a partir de 1) de los campos de datos de entrada que se van a cargar. Cada columna de tabla que no sea anulable debe tener una entrada correspondiente en la lista METHOD P. Por ejemplo, dados los campos de datos F1, F2, F3, F4, F5 y F6 y las columnas de tabla C1 INT, C2 INT NOT NULL, C3 INT NOT NULL y C4 INT, el mtodo P (2, 1, 4, 3) es una peticin vlida, mientras que el mtodo P (2, 1) no es vlido. Nota: Este mtodo slo se puede utilizar con los tipos de archivo IXF, DEL o CURSOR, y es el nico mtodo vlido para el tipo de archivo DEL. MODIFIED BY mod-tipoarchivo Especifica opciones adicionales. Consulte la Tabla 8 en la pgina 512. NONRECOVERABLE Especifica que la transaccin de carga debe marcarse como no recuperable y que no ser posible recuperarla mediante una accin subsiguiente de recuperacin en avance. El programa de utilidad de recuperacin en avance saltar la transaccin y marcar la tabla en la que se estaban cargando datos como "no vlida". El programa de utilidad tambin ignorar las transacciones subsiguientes para la tabla. Despus de que se haya completado la operacin de recuperacin en avance, una tabla de este tipo slo se puede eliminar o restaurar desde una copia de seguridad (completa o de espacio de tabla) realizada despus de un punto de compromiso a continuacin de la realizacin de la operacin de carga no recuperable. Con esta opcin, los espacios de tabla no se ponen en estado de pendiente de copia de seguridad a continuacin de la operacin de carga y durante la operacin de carga no se tiene que realizar una copia de los datos cargados. Esta opcin no se deber utilizar cuando existen o se estn aadiendo en la tabla columnas DATALINK con el atributo FILE LINK CONTROL.
495
LOAD
NULL INDICATORS lista-indicadores-nulos Esta opcin slo se puede utilizar cuando se especifica el parmetro METHOD L; es decir, el archivo de entrada es un archivo ASC). Una lista de indicadores nulos es una lista de enteros positivos separados por comas que especifican el nmero de columna de cada campo de indicador nulo. El nmero de columna es el desplazamiento de bytes del campo de indicador nulo respecto al principio de una fila de datos. Tiene que haber una entrada en la lista de indicadores nulos para cada campo de datos definido en el parmetro METHOD L. Un nmero de columna de cero indica que el campo de datos correspondiente siempre contiene datos. Un valor de Y en la columna de indicador NULL especifica que los datos de la columna son NULL. Cualquier carcter distinto de Y en la columna de indicador NULL especifica que los datos de la columna no son NULL y que se cargarn los datos de columna especificados por la opcin METHOD L. El carcter de indicador NULL puede cambiarse utilizando la opcin MODIFIED BY. OF tipoarchivo Especifica el formato de los datos: v ASC (formato ASCII no delimitado) v DEL (formato ASCII delimitado) v IXF (formato de intercambio integrado, versin de PC), exportado de la misma tabla o de otra tabla de DB2. v CURSOR (cursor declarado para una sentencia SELECT o VALUES). PARTITIONED DB CONFIG Permite ejecutar una carga en una tabla particionada. El parmetro PARTITIONED DB CONFIG permite especificar opciones de configuracin especficas de base de datos particionada. Los valores de opcin-bd-particionada pueden ser cualquiera de los siguientes:
HOSTNAME x FILE_TRANSFER_CMD x PART_FILE_LOCATION x OUTPUT_DBPARTNUMS x PARTITIONING_DBPARTNUMS x MODE x MAX_NUM_PART_AGENTS x ISOLATE_PART_ERRS x STATUS_INTERVAL x PORT_RANGE x CHECK_TRUNCATION MAP_FILE_INPUT x MAP_FILE_OUTPUT x
496
Command Reference
LOAD
TRACE x NEWLINE DISTFILE x OMIT_HEADER
v Si se ejecuta la carga desde el interior de un entorno no particionado, tendr el comportamiento habitual. Si se especifica una opcin de configuracin de base de datos particionada, dar como resultado el Error de SQL 27959, cdigo de razn 1. v Sin calificacin adicional, en un entorno de base de datos particionada, la opcin MODE ser por omisin PARTITION_AND_LOAD excepto cuando la variable de registro DB2_PARTITIONEDLOAD_DEFAULT est establecida en NO. En este caso, se aplicarn los siguientes valores por omisin: MODE ser LOAD_ONLY, OUTPUT_DBPARTNUMS ser una lista que contendr la nica particin de base de datos a la que el usuario est conectado actualmente, y PART_FILE_LOCATION ser la va de acceso de trabajo actual del cliente, si el nombre del archivo de entrada de carga no est totalmente calificado y el cliente y el servidor estn en la misma mquina fsica, o el prefijo de la va de acceso del archivo de entrada de carga si ese nombre de archivo est totalmente calificado. La finalidad de esta variable de registro es preservar el comportamiento anterior a la Versin 8 del programa de utilidad de carga en un entorno de bases de datos particionado. v En un entorno de bases de datos particionado, si se utiliza el programa de utilidad de carga con la opcin MODE establecida en PARTITION_ONLY, el archivo de entrada se particionar, lo que producir la creacin de un archivo en cada particin de salida que contiene una cabecera y datos de correlacin de particin slo para esa particin. Para todos los tipos de archivo excepto CURSOR, el nombre del archivo que se crea en cada particin de salida es < nombrearchivo >.< xxx >, donde < nombrearchivo > es el nombre del archivo de entrada especificado en el mandato de carga y < xxx > es el nmero de la particin donde reside el archivo. Adems, la ubicacin del archivo en cada particin de salida se indica con la opcin PART_FILE_LOCATION, si se especifica. Si no se especifica esta opcin, se utiliza el directorio de trabajo actual como ubicacin del archivo de entrada. Si el tipo de archivo es CURSOR, la opcin PART_FILE_LOCATION es necesaria y debe especificar un nombre de base totalmente calificado. En este caso, el nombre del archivo creado en cada particin ser este nombre de base con la adicin del nmero de particin adecuado. v En un entorno de bases de datos particionado, si se utiliza el programa de utilidad de carga con la opcin MODE establecida en LOAD_ONLY, se supone que los archivos a cargar existen en cada particin de salida y se supone que contienen una cabecera de
497
LOAD
correlacin de particin vlida. Para todos los tipos de archivo excepto CURSOR, se espera que el nombre del archivo en cada particin sea < nombrearchivo > . < xxx >, donde < nombrearchivo > es el nombre del archivo de entrada especificado en el mandato de carga y < xxx > es el nmero de la particin donde reside el archivo. Adems, la ubicacin del archivo en cada particin se indica con la opcin PART_FILE_LOCATION, si se especifica. Si no se especifica esta opcin, los archivos se leern desde la ubicacin indicada por el prefijo de va de acceso del nombre de archivo de entrada, si ese nombre est totalmente calificado, o el directorio de trabajo actual, si el nombre de archivo de entrada no est totalmente calificado. Si el tipo de archivo es CURSOR, la opcin PART_FILE_LOCATION es necesaria y debe especificar un nombre de base totalmente calificado. En este caso, se espera que el nombre del archivo en cada particin sea este nombre de base con la adicin del nmero de particin adecuado. v En un entorno de bases de datos particionado, si se utiliza el programa de utilidad de carga con la opcin MODE establecida en LOAD_ONLY_VERIFY_PART, se supone que los archivos a cargar existen en cada particin de salida y tambin se supone que no contienen ninguna cabecera de correlacin de particin. La carga verificar que los datos de cada archivo estn en la particin adecuada. Las filas que no estn en la particin correcta se rechazarn y se enviarn a un archivo de vuelco, si se ha especificado uno. El nombre y la ubicacin del archivo en cada particin de salida sigue las mismas reglas que el nombre de archivo para la modalidad LOAD_ONLY. Nota: La modalidad LOAD_ONLY_VERIFY_PART no est soportada cuando el tipo de archivo es CURSOR. v Si se especifica la palabra clave CLIENT de Carga, se permitir una Carga remota. Slo estn soportadas las modalidades PARTITION_AND_LOAD y PARTITION_ONLY para las cargas en que se especifica CLIENT. REPLACE Una de cuatro modalidades bajo las que se puede ejecutar el programa de utilidad de carga. Suprime todos los datos existentes de la tabla e inserta los datos cargados. La definicin de tabla y las definiciones de ndice no cambian. Si se utiliza esta opcin al mover datos entre jerarquas, slo se pueden sustituir los datos de una jerarqua entera, no de subtablas individuales. Esta opcin no se soporta para tablas con columnas DATALINK. RESTART Una de cuatro modalidades bajo las que se puede ejecutar el
498
Command Reference
LOAD
programa de utilidad de carga. Reinicia una operacin de carga interrumpida anteriormente. La operacin de carga continuar automticamente desde el ltimo punto de coherencia de la fase de carga, creacin o supresin. RESTARTCOUNT Reservado. ROWCOUNT n Especifica el nmero de n registros fsicos del archivo que se deben cargar. Permite a un usuario cargar solamente las primeras n filas de un archivo. SAVECOUNT n Especifica que el programa de utilidad de carga debe establecer puntos de coherencia despus de cada n filas. Este valor se convierte en una cuenta de pginas y se redondea por exceso a los intervalos del tamao de extensin. Dado que se emite un mensaje en cada punto de coherencia, se deber seleccionar esta opcin si la operacin de carga se supervisar utilizando LOAD QUERY. Si el valor de n no es suficientemente alto, la sincronizacin de las actividades realizadas en cada punto de coherencia influir en el rendimiento. El valor por omisin es cero, que significa que no se establecern puntos de coherencia, a menos que sean necesarios. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR. SORT BUFFER tamao-almacint Esta opcin especifica un valor que prevalece sobre el parmetro de configuracin de base de datos SORTHEAP durante una operacin de carga. Slo es relevante al cargar tablas con ndices y slo cuando el parmetro INDEXING MODE no se especifica como DEFERRED. El valor especificado no puede exceder el valor de SORTHEAP. Este parmetro es til para acelerar la memoria de clasificacin que se utiliza al cargar tablas con muchos ndices sin cambiar el valor de SORTHEAP, que afectara al proceso general de consulta. STATISTICS NO Especifica que no se deben reunir estadsticas y que las estadsticas de los catlogos no se deben modificar. ste es el valor por omisin. STATISTICS YES Especifica que se deben reunir estadsticas para la tabla y para los ndices existentes. Esta opcin slo se soporta si la operacin de carga est en modalidad REPLACE. WITH DISTRIBUTION Especifica que se deben reunir estadsticas de distribucin.
499
LOAD
AND INDEXES ALL Especifica que se deben reunir estadsticas de tablas y de ndices. FOR INDEXES ALL Especifica que slo se deben reunir estadsticas de ndices. DETAILED Especifica que se deben reunir estadsticas de ndices ampliadas. TEMPFILES PATH nombreva-temp Especifica el nombre de la va de acceso a utilizar al crear archivos temporales durante una operacin de carga y debe estar totalmente calificada de acuerdo a la particin de base de datos del servidor. Los archivos temporales ocupan espacio del sistema de archivos. A veces, este requisito de espacio es bastante importante. A continuacin se proporciona una estimacin de la cantidad de espacio del sistema de archivos que se deber asignar para todos los archivos temporales: v 4 bytes para cada fila duplicada o rechazada que contenga valores DATALINK v 136 bytes para cada mensaje que genere el programa de utilidad de carga v 15 KB de actividad general si el archivo de datos contiene datos de campo largo o LOB. Esta cantidad puede aumentar significativamente si se especifica la opcin INSERT y ya hay en la tabla una gran cantidad de datos LOB o de campo largo. TERMINATE Una de cuatro modalidades bajo las que se puede ejecutar el programa de utilidad de carga. Termina una operacin de carga interrumpida anteriormente y retrotrae la operacin hasta el momento en que se empez, incluso si se haban pasado puntos de coherencia. Los estados de los espacios de tabla implicados en la operacin vuelven a ser normales y todos los objetos de tabla pasan a estar coherentes (puede que los objetos de ndice se marquen como no vlidos, en cuyo caso tendr lugar automticamente una reconstruccin de ndice en el siguiente acceso). Si la operacin de carga que se est terminando es una carga REPLACE, la tabla se truncar a una tabla vaca despus de la operacin de carga TERMINATE. Si la operacin de carga que se est terminando es una carga INSERT, la tabla retendr todos sus registros originales despus de la operacin de carga TERMINATE. La opcin de terminacin de carga no eliminar un estado de pendiente de copia de seguridad de los espacios de tabla.
500
Command Reference
LOAD
Nota: Esta opcin no se soporta para tablas con columnas DATALINK. USING directorio Reservado. WARNINGCOUNT n Detiene la operacin de carga despus de n avisos. Establezca este parmetro si no se esperan avisos, pero se desea que se verifique si se estn utilizando el archivo y la tabla correctos. Si n es cero o no se especifica esta opcin, la operacin de carga continuar independientemente del nmero de avisos emitidos. Si la operacin de carga se detiene porque se ha alcanzado el umbral de avisos, se puede iniciar otra operacin de carga en modalidad RESTART. La operacin de carga continuar automticamente desde el ltimo punto de coherencia. Alternativamente, se puede iniciar otra operacin de carga en modalidad REPLACE, empezando al principio del archivo de entrada. WITHOUT PROMPTING Especifica que la lista de archivos de datos contiene todos los archivos que se deben cargar y que los dispositivos o directorios listados son suficientes para la operacin de carga entera. Si no se encuentra un archivo de entrada de continuacin o los destinos de copia se llenan antes de que finalice la operacin de carga, la operacin de carga fallar y la tabla permanecer en estado de pendiente de carga. Si no se especifica esta opcin y el dispositivo de cinta encuentra un fin de cinta para la imagen de copia o el ltimo elemento listado es un dispositivo de cinta, se le solicitar al usuario una cinta nueva en dicho dispositivo. Ejemplos: Ejemplo 1 TABLE1 tiene 5 columnas: v v v v COL1 COL2 COL3 COL4 VARCHAR 20 NOT NULL WITH DEFAULT SMALLINT CHAR 4 CHAR 2 NOT NULL WITH DEFAULT
v COL5 CHAR 2 NOT NULL ASCFILE1 tiene 6 elementos: v ELE1 posiciones 01 a 20 v ELE2 posiciones 21 a 22
501
LOAD
v v v v ELE5 ELE3 ELE4 ELE6 posiciones posiciones posiciones posiciones 23 24 28 32 a a a a 23 27 31 32
v ELE6 posiciones 33 a 40 Registros de datos:

1...5....10...15...20...25...30...35...40 Datos de prueba 1 XXN 123abcdN Datos de prueba 2 y 3 QQY wxyzN Datos de prueba 4,5 y 6 WWN6789 Y
El mandato siguiente carga la tabla del archivo:

db2 load from ascfile1 of asc modified by striptblanks reclen=40 method L (1 20, 21 22, 24 27, 28 31) null indicators (0,0,23,32) insert into table1 (col1, col5, col2, col3)
Notas: 1. La especificacin de striptblanks en el parmetro MODIFIED BY fuerza el truncamiento de los espacios en blanco en las columnas VARCHAR (por ejemplo COL1, que tiene 11, 17 y 19 bytes de longitud, en las filas 1, 2 y 3, respectivamente). 2. La especificacin de reclen=40 en el parmetro MODIFIED BY indica que no hay ningn carcter de lnea nueva al final de cada registro de entrada y que cada registro tiene 40 bytes de longitud. Los ltimos 8 bytes no se utilizan para cargar la tabla. 3. Dado que COL4 no se proporciona en el archivo de entrada, se insertar en TABLE1 con su valor por omisin (se ha definido NOT NULL WITH DEFAULT). 4. Las posiciones 23 y 32 se utilizan para indicar si COL2 y COL3 de TABLE1 se cargarn como NULL para una fila determinada. Si hay una Y en la posicin de indicador nulo de la columna para un registro determinado, la columna ser NULL. Si hay una N, los valores de datos de las posiciones de datos de la columna del registro de entrada (como se define as en L(........)) se utilizarn como la fuente de datos de columna para la fila. En este ejemplo, ninguna de las columnas de la fila 1 es NULL, COL2 en la fila 2 es NULL y COL3 en la fila 3 es NULL. 5. En este ejemplo, NULL INDICATORS para COL1 y COL5 se especifican como 0 (cero), indicando que los datos no son anulables. 6. NULL INDICATOR para una columna determinada puede estar en cualquier parte del registro de entrada, pero se debe especificar la posicin y se deben proporcionar los valores Y o N.
502
Command Reference
LOAD
Ejemplo 2 (Carga de LOB de archivos) TABLE1 tiene 3 columnas: v COL1 CHAR 4 NOT NULL WITH DEFAULT v LOB1 LOB v LOB2 LOB ASCFILE1 tiene 3 elementos: v ELE1 posiciones 01 a 04 v ELE2 posiciones 06 a 13 v ELE3 posiciones 15 a 22 Los archivos siguientes residen en /u/user1 o /u/user1/bin: v ASCFILE2 tiene datos LOB v ASCFILE3 tiene datos LOB v ASCFILE4 tiene datos LOB v ASCFILE5 tiene datos LOB v ASCFILE6 tiene datos LOB v ASCFILE7 tiene datos LOB Registros de datos de ASCFILE1:
1...5....10...15...20...25...30. REC1 ASCFILE2 ASCFILE3 REC2 ASCFILE4 ASCFILE5 REC3 ASCFILE6 ASCFILE7
El mandato siguiente carga la tabla del archivo:

db2 load from ascfile1 of asc lobs from /u/user1, /u/user1/bin modified by lobsinfile reclen=22 method L (1 4, 6 13, 15 22) insert into table1
Notas: 1. La especificacin de lobsinfile en el parmetro MODIFIED BY indica al cargador que todos los datos LOB deben cargarse de los archivos. 2. La especificacin de reclen=22 en el parmetro MODIFIED BY indica que no hay ningn carcter de lnea nueva al final de cada registro de entrada y que cada registro tiene 22 bytes de longitud. 3. Los datos LOB estn contenidos en 6 archivos, ASCFILE2 a ASCFILE7. Cada archivo contiene los datos que se utilizarn para cargar una columna LOB para una fila especfica. La relacin entre los LOB y otros datos se especifica en ASCFILE1. El primer registro de este archivo indica al cargador que coloque REC1 en COL1 de la fila 1. El contenido de
503
LOAD
ASCFILE2 se utilizar para cargar LOB1 de la fila 1 y el contenido de ASCFILE3 se utilizar para cargar LOB2 de la fila 1. De forma similar, se utilizarn ASCFILE4 y ASCFILE5 para cargar LOB1 y LOB2 de la fila 2 y se utilizarn ASCFILE6 y ASCFILE7 para cargar los LOB de la fila 3. 4. El parmetro LOBS FROM contiene 2 vas de acceso en las que se buscarn los archivos LOB nombrados cuando el cargador necesite dichos archivos. 5. Para cargar los LOB directamente de ASCFILE1 (un archivo ASCII no delimitado), sin el modificador lobsinfile, se deben observar las normas siguientes: v La longitud total de cualquier registro, incluidos los LOB, no puede exceder de 32 KB. v Los campos LOB de los registros de entrada deben ser de longitud fija y los datos LOB deben rellenarse con los espacios en blanco que sean necesarios. v Se debe especificar el modificador striptblanks, de modo que los blancos de cola utilizados para rellenar los LOB puedan eliminarse a medida que se insertan los LOB en la base de datos. Ejemplo 3 (Utilizacin de archivos de vuelcos) La tabla FRIENDS se define como:
table friends "( c1 INT NOT NULL, c2 INT, c3 CHAR(8) )"
Si se intentan cargar los registros de datos siguientes en esta tabla,

23, 24, bobby , 45, john 4,, mary
se rechaza la segunda fila porque el primer INT es NULL y la definicin de columna especifica NOT NULL. Las columnas que contienen caracteres iniciales que no sean coherentes con el formato DEL generarn un error y se rechazar el registro. Dichos registros se pueden grabar en un archivo de vuelco. Los datos DEL que aparecen en una columna fuera de los delimitadores de caracteres se ignoran, pero no generan un aviso. Por ejemplo:
22,34,"bob" 24,55,"sam" sdf
El programa de utilidad cargar sam en la tercera columna de la tabla y se sealarn los caracteres sdf en un aviso. El registro no se rechazar. Otro ejemplo:
22 3, 34,"bob"
504
Command Reference
LOAD
El programa de utilidad cargar 22,34,"bob" y generar un aviso indicando que se han ignorado unos datos de la columna uno a continuacin de 22. El registro no se rechazar. Ejemplo 4 (Carga de datos de DATALINK) El mandato siguiente carga la tabla MOVIETABLE del archivo de entrada delfile1, que tiene datos en formato DEL:
db2 load from delfile1 of del modified by dldel| insert into movietable (actorname, description, url_making_of, url_movie) datalink specification (dl_url_default_prefix "http://narang"), (dl_url_replace_prefix "http://bomdel" dl_url_suffix ".mpeg") for exception excptab
Notas: 1. La tabla tiene cuatro columnas:

actorname description url_making_of url_movie VARCHAR(n) VARCHAR(m) DATALINK (with LINKTYPE URL) DATALINK (with LINKTYPE URL)
2. Los datos DATALINK del archivo de entrada tienen el carcter de barra vertical (|) como delimitador de subcampo. 3. Si ningn valor de columna para url_making_of tiene la secuencia de caracteres de prefijo, se utilizar http://narang. 4. Cada valor de columna no NULL para url_movie obtendr http://bomdel como prefijo. Los valores existentes se sustituirn. 5. A cada valor de columna no NULL para url_movie se le aadir .mpeg a la va de acceso. Por ejemplo, si un valor de columna de url_movie es http://server1/x/y/z, se almacenar como http://bomdel/x/y/z.mpeg; si el valor es /x/y/z, se almacenar como http://bomdel/x/y/z.mpeg. 6. Si se produce algn ndice exclusivo o alguna excepcin DATALINK al cargar la tabla, los registros afectados se suprimirn de la tabla y se pondrn en la tabla de excepcin excptab. Ejemplo 5 (Carga de una tabla con una columna de identidad) TABLE1 tiene 4 columnas: v C1 VARCHAR(30) v C2 INT GENERATED BY DEFAULT AS IDENTITY v C3 DECIMAL(7,2) v C4 CHAR(1)
505
LOAD
TABLE2 es igual que TABLE1, excepto que C2 es una columna de identidad que se genera siempre (GENERATED ALWAYS). Registros de datos en DATAFILE1 (formato DEL):
"Liszt" "Hummel",,187.43, H "Grieg",100, 66.34, G "Satie",101, 818.23, I
Registros de datos en DATAFILE2 (formato DEL):

"Liszt", 74.49, A "Hummel", 0.01, H "Grieg", 66.34, G "Satie", 818.23, I
Notas: 1. El mandato siguiente genera valores de identidad para las filas 1 y 2, dado que no se proporcionan valores de identidad en DATAFILE1 para dichas filas. Sin embargo, a las filas 3 y 4 se les asignan los valores de identidad proporcionados por el usuario de 100 y 101, respectivamente.
db2 load from datafile1.del of del replace into table1
2. Para cargar DATAFILE1 en TABLE1 de modo que se generen valores de identidad para todas las filas, emita uno de los mandatos siguientes:
db2 load from datafile1.del of del method P(1, 3, 4) replace into table1 (c1, c3, c4) db2load from datafile1.del of del modified by identityignore replace into table1
3. Para cargar DATAFILE2 en TABLE1 de modo que se generen valores de identidad para cada fila, emita uno de los mandatos siguientes:
db2 load from datafile2.del of del replace into table1 (c1, c3, c4) db2 load from datafile2.del of del modified by identitymissing replace into table1
4. Para cargar DATAFILE1 en TABLE2 de modo que se asignen valores de identidad de 100 y 101 a las filas 3 y 4, emita el mandato siguiente:
db2 load from datafile1.del of del modified by identityoverride replace into table2
En este caso, las filas 1 y 2 se rechazarn, porque se le ha indicado al programa de utilidad que altere temporalmente los valores de identidad generados por el sistema en favor de los valores proporcionados por el usuario. Sin embargo, si no existen valores proporcionados por el usuario, se deber rechazar la fila porque las columnas de identidad son implcitamente no NULL. 5. Si se carga DATAFILE1 en TABLE2 sin utilizar ninguno de los modificadores de tipo de archivo relacionados con la identidad, se
506
Command Reference
LOAD
cargarn las filas 1 y 2, pero se rechazarn las filas 3 y 4, porque proporcionan sus propios valores no NULL y la columna de identidad es GENERATED ALWAYS. Ejemplo 6 (Carga utilizando el tipo de archivo CURSOR) La tabla ABC.TABLE1 tiene 3 columnas:
ONE INT TWO CHAR(10) THREE DATE
La tabla ABC.TABLE2 tiene 3 columnas:

ONE VARCHAR TWO INT THREE DATE
Al ejecutar los siguientes mandatos se cargarn todos los datos de ABC.TABLE1 en ABC.TABLE2:
db2 declare mycurs cursor for select two,one,three from abc.table1 db2 load from mycurs of cursor insert into abc.table2
Notas de uso: Los datos se cargan en la secuencia que aparecen en el archivo de entrada. Si se desea una secuencia determinada, se debern clasificar los datos antes de intentar una carga. El programa de utilidad de carga crea ndices basndose en las definiciones existentes. Las tablas de excepcin se utilizan para manejar duplicados en claves exclusivas. El programa de utilidad no fuerza la integridad de referencia, no realiza ninguna comprobacin de restricciones ni actualiza las tablas de resumen que son dependientes de las tablas que se estn cargando. Las tablas que incluyen restricciones de referencia o comprobacin se colocan en estado de pendiente de comprobacin. Las tablas de resumen que se definen con REFRESH IMMEDIATE y que son dependientes de tablas que se estn cargando, tambin se colocan en estado de pendiente de comprobacin. Emita la sentencia SET INTEGRITY para sacar las tablas del estado de pendiente de comprobacin. Las operaciones de carga no se pueden llevar a cabo en tablas de resumen reproducidas. Si se necesita un ndice de clster en la tabla, los datos deben clasificarse en el ndice de clster antes de la carga. Sin embargo, no es necesario clasificar los datos antes de cargarlos en una tabla de clster multidimensional (MDC).
507
LOAD
Consideraciones acerca de DB2 Data Links Manager Para cada columna DATALINK, puede haber una especificacin de columna entre parntesis. Cada especificacin de columna consta de uno o varios de estos elementos: DL_LINKTYPE, prefijo y una especificacin DL_URL_SUFFIX. La informacin de prefijo puede ser DL_URL_REPLACE_PREFIX o la especificacin DL_URL_DEFAULT_PREFIX. Pueden existir tantas especificaciones de columna DATALINK como el nmero de columnas DATALINK definidas en la tabla. El orden de las especificaciones sigue el orden de las columnas DATALINK que se encuentra en la lista columna-insercin (si se ha especificado mediante INSERT INTO (columna-insercin, ...)) o en la definicin de tabla (si no se ha especificado columna-insercin). Por ejemplo, si una tabla tiene las columnas C1, C2, C3, C4 y C5 y entre ellas slo las columnas C2 y C5 son de tipo DATALINK y la lista columna-insercin es (C1, C5, C3, C2), tendrn que haber dos especificaciones de columna DATALINK. La primera especificacin de columna ser para C5 y la segunda especificacin de columna ser para C2. Si no se especifica una lista de columna-insercin, la primera especificacin de columna ser para C2 y la segunda especificacin de columna ser para C5. Si hay mltiples columnas DATALINK y algunas columnas no necesitan ninguna especificacin determinada, la especificacin de columna deber tener al menos el parntesis para identificar de forma no ambigua el orden de las especificaciones. Si no hay especificaciones para ninguna de las columnas, se puede eliminar la lista entera de parntesis vacos. De este modo, en los casos en los que los valores por omisin sean satisfactorios, no ser necesario que haya ninguna especificacin DATALINK. Si se estn cargando datos en una tabla con una columna DATALINK que se ha definido con FILE LINK CONTROL, realice los pasos siguientes antes de invocar el programa de utilidad de carga. (Si todas las columnas DATALINK estn definidas con NO LINK CONTROL, estos pasos no son necesarios). 1. Asegrese de que el DB2 Data Links Manager est instalado en los servidores Data Links a los que harn referencia los valores de columna DATALINK. Para Distributed File Systems (DFS), asegrese de que estn registrados los DB2 Data Links Managers dentro de la clula de destino. 2. Asegrese de que la base de datos est registrada en el DB2 Data Links Manager. 3. Copie en los servidores Data Links apropiados todos los archivos que se insertarn como valores DATALINK. 4. Defina el nombre (o nombres) de prefijo en los DB2 Data Links Manager de los servidores Data Links.
508
Command Reference
LOAD
5. Registre los servidores Data Links a los que hacen referencia los datos DATALINK (que se deben cargar) del archivo de configuracin de DB2 Data Links Manager. Para DFS, registre las clulas en la configuracin de destino a la que hacen referencia los datos de DATALINK (que deben cargarse) en el archivo de configuracin de DB2 Data Links Manager. La conexin entre DB2 y el servidor Data Links puede fallar mientras se ejecuta el programa de utilidad de carga, lo cual har que falle la operacin de carga. Si esto se produce: 1. Inicie el servidor Data Links y el DB2 Data Links Manager. 2. Invoque una operacin de reinicio de carga. Los enlaces que fallan durante la operacin de carga se consideran violaciones de la integridad de los datos y se manejan de forma muy parecida a cmo se manejan las violaciones de ndices exclusivos. En consecuencia, se ha definido una excepcin especial para cargar tablas que tienen una o ms columnas DATALINK. Representacin de la informacin de DATALINK en un archivo de entrada LINKTYPE (actualmente slo se soporta el URL) no se especifica como parte de la informacin DATALINK. LINKTYPE se especifica en el mandato LOAD o IMPORT, y para los archivos de entrada del tipo PC/IXF, en los registros de descriptor de columna adecuados. La sintaxis de la informacin DATALINK para un URL LINKTYPE es la siguiente:
nombreurl delimitador_dl comentario
Tenga en cuenta que nombreurl y comentario son opcionales. Si no se proporciona ninguno de los dos, se asigna el valor NULL. nombreurl El nombre de URL debe adaptarse a la sintaxis de URL vlida. Notas: 1. Actualmente se permiten http, file, unc y dfs como nombre de esquema. 2. El prefijo (esquema, sistema principal y puerto) del nombre de URL es opcional. Para DFS, el prefijo hace referencia a la parte esquema nombreclula espacioarchivo-unin. Si no existe un prefijo, ste se toma de la especificacin DL_URL_DEFAULT_PREFIX o DL_URL_REPLACE_PREFIX del programa de utilidad de carga o de importacin. Si no se
509
LOAD
especifica ninguno de stos, el prefijo toma por omisin file://sistemaprincipallocal. De este modo, en el caso de archivos locales, se puede entrar el nombre de archivo con el nombre de va de acceso completo como nombre de URL, sin necesidad de ninguna especificacin de columna DATALINK con el mandato LOAD o IMPORT. 3. Los prefijos, incluso si existen en los nombres de URL, quedan alterados temporalmente por un nombre de prefijo diferente en la especificacin DL_URL_REPLACE_PREFIX durante una operacin de carga o importacin. 4. La va de acceso (despus de aadir DL_URL_SUFFIX, si se especifica) es el nombre de va de acceso completo del archivo remoto del servidor remoto. No se permiten nombres de va de acceso relativos. No se tiene en cuenta el prefijo de va de acceso por omisin del servidor http. delimitador_dl Para el formato de archivo ASCII delimitado (DEL), carcter especificado a travs del modificador dldel o tomado por omisin en el mandato LOAD o IMPORT. Para el formato de archivo ASCII no delimitado (ASC), debe corresponder a la secuencia de caracteres \; (una barra inclinada seguida de un punto y coma). Se permiten caracteres de espacio en blanco (espacios en blanco, tabuladores, etc.) antes y despus del valor especificado para este parmetro. comentario Parte de comentario de un valor DATALINK. Si se especifica para el formato de archivo ASCII delimitado (DEL), el texto de comentario debe escribirse entre los delimitadores de serie de caracteres, que son las comillas dobles () por omisin. Este delimitador de serie de caracteres se puede alterar temporalmente mediante la especificacin MODIFIED BY mod-tipoarchivo del mandato LOAD o IMPORT. Si no se especifica ningn comentario, este parmetro toma por omisin una serie de longitud cero. A continuacin se muestran ejemplos de datos DATALINK para el formato de archivo ASCII delimitado (DEL): v http://www.almaden.ibm.com:80/mrep/intro.mpeg; "Intro Movie" Esto se almacena con las partes siguientes: esquema = http servidor = www.almaden.ibm.com va de acceso = /mrep/intro.mpeg comentario = Intro Movie v file://narang/u/narang; "Pgina de presentacin de InderPal"
510
Command Reference
LOAD
Esto se almacena con las partes siguientes: esquema = file servidor = narang va de acceso = /u/narang comentario = Pgina de presentacin de InderPal A continuacin se muestran ejemplos de datos DATALINK para el formato de archivo ASCII no delimitado (ASC): v http://www.almaden.ibm.com:80/mrep/intro.mpeg\;Intro Movie Esto se almacena con las partes siguientes: esquema = http servidor = www.almaden.ibm.com va de acceso = /mrep/intro.mpeg comentario = Intro Movie v file://narang/u/narang\; Pgina de presentacin de InderPal Esto se almacena con las partes siguientes: esquema = file servidor = narang va de acceso = /u/narang comentario = Pgina de presentacin de InderPal A continuacin se muestran ejemplos de datos DATALINK en los que se supone que la especificacin de carga o especificacin para la columna es DL_URL_REPLACE_PREFIX (http://qso): v http://www.almaden.ibm.com/mrep/intro.mpeg Esto se almacena con las partes siguientes: esquema = http servidor = qso va de acceso = /mrep/intro.mpeg comentario = serie NULL
v /u/me/miarchivo.ps Esto se almacena con las partes siguientes: esquema = http servidor = qso va de acceso = /u/me/miarchivo.ps comentario = serie NULL
511
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) Modificador Descripcin Todos los formatos de archivo anyorder Este modificador se utiliza junto con el parmetro cpu_parallelism. Especifica que la conservacin del orden de los datos de origen no es necesaria, produciendo una ventaja significativa de rendimiento adicional en los sistemas SMP. Si el valor de cpu_parallelism es 1, se ignora esta opcin. Esta opcin no se soporta si SAVECOUNT > 0, dado que la recuperacin de anomalas despus de un punto de coherencia requiere que los datos se carguen en secuencia. Se realiza una comprobacin reducida de la sintaxis en los valores de columna proporcionados por el usuario y mejora el rendimiento. Se garantiza que las tablas cargadas bajo esta opcin son arquitectnicamente correctas y se garantiza que el programa de utilidad realiza suficiente comprobacin de datos para evitar una trampa o una violacin de segmentacin. Los datos que estn en formato correcto se cargarn correctamente. Por ejemplo, si se tuviera que encontrar un valor de 123qwr4 como entrada de campo para una columna de entero de un archivo ASC, el programa de utilidad de carga sealara normalmente un error de sintaxis, ya que el valor no representa un nmero vlido. Con fastparse, no se detecta un error de sintaxis y se carga un nmero arbitrario en el campo de entero. Se deber tener cuidado de utilizar este modificador slo con datos limpios. Las mejoras de rendimiento al utilizar esta opcin con datos ASCII pueden ser bastante importantes, pero fastparse no mejora significativamente el rendimiento con datos PC/IXF, dado que IXF es un formato binario y fastparse afecta al anlisis y conversin de ASCII a formatos internos. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR. generatedignore Este modificador informa al programa de utilidad de carga que en el archivo de datos existen datos para todas las columnas generadas pero que stos se debern ignorar. Esto hace que el programa de utilidad genere todos los valores para las columnas generadas. Este modificador no se puede utilizar con el modificador generatedmissing o el modificador generatedoverride.
fastparse
512
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador generatedmissing Descripcin Si se especifica este modificador, el programa de utilidad supone que el archivo de datos de entrada no contiene datos para la columna generada (ni siquiera NULL) y, por consiguiente, cargar NULL en la columna. Esto hace que el programa de utilidad genere todos los valores para las columnas generadas. Este modificador no se puede utilizar con el modificador generatedignore o el modificador generatedoverride. Este modificador indica al programa de utilidad de carga que acepte datos proporcionados por el usuario para todas las columnas generadas de la tabla (lo contrario a las reglas normales para estos tipos de columnas). Esto es til al migrar datos desde otro sistema de bases de datos o al cargar una tabla de datos que se ha recuperado utilizando la opcin RECOVER DROPPED TABLE en el mandato ROLLFORWARD DATABASE. Cuando se utilice este modificador, se rechazarn las filas sin datos o con datos NULL para una columna no anulable generada (SQL3116W). Nota: Cuando se utiliza este modificador, la tabla se pondr en estado CHECK PENDING. Para sacar la tabla del estado CHECK PENDING sin verificar los valores proporcionados por el usuario, emita el siguiente mandato despus de la operacin de carga: SET INTEGRITY FOR < nombre-tabla > GENERATED COLUMN IMMEDIATED UNCHECKED Para sacar la tabla del estado CHECK PENDING y forzar la verificacin de los valores proporcionados por el usuario, emita el siguiente mandato despus de la operacin de carga: SET INTEGRITY FOR < nombre-tabla > IMMEDIATE CHECKED. Este modificador no se puede utilizar con el modificador generatedmissing o generatedignore. identityignore Este modificador informa al programa de utilidad que existen datos para la columna de identidad en el archivo de datos pero que stos se debern ignorar. Esto hace que el programa de utilidad genere todos los valores de identidad. El comportamiento ser el mismo para las columnas de identidad GENERATED ALWAYS y GENERATED BY DEFAULT. Esto significa que, para las columnas GENERATED ALWAYS, no se rechazar ninguna fila. Este modificador no se puede utilizar con el modificador identitymissing o identityoverride.
generatedoverride
513
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador identitymissing Descripcin Si se especifica este modificador, el programa de utilidad supone que el archivo de datos de entrada no contiene datos para la columna de identidad (ni siquiera ningn NULL) y, por consiguiente, generar un valor para cada fila. El comportamiento ser el mismo para las columnas de identidad GENERATED ALWAYS y GENERATED BY DEFAULT. Este modificador no se puede utilizar con el modificador identityignore o identityoverride. Este modificador slo se deber utilizar cuando exista una columna de identidad definida como GENERATED ALWAYS en la tabla que se debe cargar. Indica al programa de utilidad que acepte datos explcitos no NULL para dicha columna (lo contrario a las normas habituales para estos tipos de columnas de identidad). Esto es til al migrar datos desde otro sistema de bases de datos cuando la tabla debe definirse como GENERATED ALWAYS o cuando se carga una tabla desde datos que se han recuperado utilizando la opcin DROPPED TABLE RECOVERY en el mandato ROLLFORWARD DATABASE. Cuando se utilice este modificador, se rechazarn las filas sin datos o con datos NULL para la columna de identidad (SQL3116W). Este modificador no se puede utilizar con el modificador identitymissing o identityignore. Nota: El programa de utilidad no intentar mantener o verificar la exclusividad de los valores de la columna de identidad de la tabla cuando se utilice esta opcin. x es un entero entre 0 y 99 inclusive. El valor se interpreta como el porcentaje de cada pgina de ndice que se debe dejar como espacio libre cuando la carga reconstruye el ndice. La carga con INDEXING MODE INCREMENTAL pasa por alto esta opcin. La primera entrada de una pgina se aade sin restricciones; las entradas subsiguientes se aaden si se puede mantener el porcentaje de umbral de espacio libre. El valor por omisin es el utilizado cuando se ejecuta CREATE INDEX. Este valor tiene preferencia sobre el valor PCTFREE especificado en la sentencia CREATE INDEX; la variable de registro DB2 INDEX FREE tiene preferencia sobre indexfreespace. La opcin indexfreespace afecta slo a las pginas hojas de ndice.
identityoverride
indexfreespace=x
514
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador lobsinfile Descripcin vaacceso-lob especifica la va de acceso a los archivos que contienen datos de LOB. Los archivos de entrada de carga ASC, DEL o IXF contienen los nombres de los archivos que tienen datos LOB en la columna LOB. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR. Cada va de acceso contiene por lo menos un archivo que contiene por lo menos un LOB al que apunta un Especificador de ubicacin de LOB (LLS) en el archivo de datos. El LLS es una representacin de serie de la ubicacin de un LOB en un archivo almacenado en la va de acceso del archivo LOB. El formato de un LLS es nombarch.ext.nnn.mmm/, donde nombarch.ext es el nombre del archivo que contiene el LOB, nnn es el desplazamiento en bytes del LOB dentro del archivo y mmm es la longitud del LOB en bytes. Por ejemplo, si la serie db2exp.001.123.456/ est almacenada en el archivo de datos, el LOB est ubicado en el desplazamiento 123 del archivo db2exp.001 y tiene una longitud de 456 bytes. Para indicar un LOB nulo, entre el tamao como -1. Si el tamao se especifica como 0, se trata como un LOB de longitud 0. Para los LOB nulos de longitud -1, se pasan por alto el desplazamiento y el nombre de archivo. Por ejemplo, el LLS de un LOB nulo puede ser db2exp.001.7.-1/. noheader Salta el cdigo de verificacin de cabecera (slo aplicable a operaciones de carga en tablas que residen en un grupo de nodos de una particin de base de datos de una sola particin). El programa de utilidad AutoLoader graba una cabecera en cada archivo que aporta datos a una tabla en un grupo de particiones de base de datos de mltiples particiones. Si se utiliza la carga MPP por omisin (modalidad PARTITION_AND_LOAD) para una tabla que reside en un grupo de nodos de un solo nodo, no se espera que el archivo tenga una cabecera. Por tanto, no es necesario el modificador noheader. Si se utiliza la modalidad LOAD_ONLY, se espera que el archivo tenga una cabecera. La nica circunstancia en la que se deber necesitar la utilizacin del modificador noheader si desea realizar la operacin LOAD_ONLY utilizando un archivo que no tenga una cabecera. norowwarnings Suprime todos los avisos sobre filas rechazadas.
515
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador pagefreespace=x Descripcin x es un entero entre 0 y 100 inclusive. El valor se interpreta como el porcentaje de cada pgina de datos que se debe dejar como espacio libre. Si el valor especificado no es vlido debido al tamao mnimo de fila, (por ejemplo, una fina que tenga como mnimo 3000 bytes de longitud y un valor x de 50), la fila se colocar en una pgina nueva. Si se especifica un valor de 100, cada fila residir en una pgina nueva. Nota: El valor PCTFREE de una tabla determina la cantidad de espacio libre designado por pgina. Si no se ha establecido un valor pagefreespace en la operacin de carga o un valor PCTFREE en una tabla, el programa de utilidad llenar tanto espacio como sea posible en cada pgina. El valor establecido por pagefreespace alterar temporalmente el valor PCTFREE especificado para la tabla. Slo es vlido cuando se carga en una sola subtabla. El uso tpico consiste en exportar datos de una tabla normal y luego invocar una operacin de carga (utilizando este modificador) para convertir los datos en una sola subtabla. x es un entero mayor o igual que 0. El valor se interpreta como el porcentaje de las pginas totales de la tabla que debe aadirse al final de tabla como espacio libre. Por ejemplo, si x es 20 y la tabla tiene 100 pginas de datos despus de que se hayan cargado los datos, se aadirn 20 pginas vacas adicionales. El nmero total de pginas de datos para la tabla ser de 120. El total de pginas de datos no es un factor en el nmero de pginas de ndice de la tabla. Esta opcin no afecta al objeto de ndice. Nota: Si se realizan dos cargas especificando esta opcin, la segunda carga no volver a utilizar el espacio extra aadido al final por la primera carga.
subtableconvert
totalfreespace=x
516
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador usedefaults Descripcin Si se ha especificado una columna de origen para una columna de tabla de destino, pero dicha columna de origen no contiene datos para una o ms instancias de fila, se cargan los valores por omisin. He aqu unos ejemplos de datos que faltan: v Para archivos DEL: se especifica ",," para la columna v Para archivos DEL/ASC/WSF: Una fila que no tiene suficientes columnas o que no es suficientemente larga para la especificacin original. Sin esta opcin, si la columna de origen no contiene datos para una instancia de fila, se produce una de las acciones siguientes: v Si la columna es anulable, se carga un NULL v Si la columna no es anulable, el programa de utilidad rechaza la fila. Formatos de archivo ASCII (ASC/DEL) codepage=x x es una serie de caracteres ASCII.El valor se interpreta como la pgina de cdigos de los datos del archivo de entrada. Convierte datos de tipo carcter (y datos numricos especificados en caracteres) de esta pgina de cdigos a la pgina de cdigos de la base de datos durante la operacin de carga. Se aplican las normas siguientes: v Para DBCS (grfico) puro, DBCS mixto y EUC, los delimitadores estn restringidos al rango de x00 a x3F, inclusive. v Para datos DEL especificados en una pgina de cdigos EBCDIC, los delimitadores pueden no coincidir con los caracteres DBCS de desplazamiento a teclado estndar y de desplazamiento a teclado ideogrfico. v nullindchar debe especificar smbolos incluidos en el conjunto ASCII estndar entre los elementos de cdigo x20 t x7F, inclusive. Esto hace referencia a smbolos y elementos de cdigo ASCII. Los datos EBCDIC pueden utilizar los smbolos correspondientes, aunque los elementos de cdigo sern diferentes. Esta opcin no est soportada conjuntamente con el tipo de archivo CURSOR.
517
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador dateformat=x Descripcin x es el formato de la fecha en el archivo fuente.a Los elementos de fecha vlidos son: AAAA - Ao (cuatro dgitos entre 0000 y 9999) M - Mes (uno o dos dgitos entre 1 y 12) MM - Mes (dos dgitos en el rango de 1 a 12; se excluyen mutuamente con M) D - Da (uno o dos dgitos entre 1 y 31) DD - Da (dos dgitos entre 1 y 31; se excluyen mutuamente con D) DDD - Da del ao (tres dgitos entre 001 y 366; se excluyen mutuamente con otros elementos de da o mes) Se asigna un valor por omisin de 1 para cada elemento que no se haya especificado. He aqu unos ejemplos de formatos de fecha: "D-M-AAAA" "MM.DD.AAAA" "AAAADDD"
518
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador dumpfile = x Descripcin x es el nombre totalmente calificado (de acuerdo con la particin de base de datos de servidor) de un archivo de excepcin en el que se graban las filas rechazadas. Se graba un mximo de 32 KB de datos por registro. He aqu un ejemplo que muestra cmo especificar un archivo de vuelcos: db2 load from data of del modified by dumpfile = /u/user/nombre-archivo insert into nombre_tabla Notas: 1. En un entorno de bases de datos particionado, la va de acceso debe ser local en la particin de base de datos de carga, para que las operaciones de carga que se ejecuten simultneamente no intenten grabar en el mismo archivo. 2. El contenido del archivo se graba en disco en una modalidad asncrona de almacenamiento intermedio. En el caso de una operacin de carga anmala o interrumpida, el nmero de registros comprometidos en disco no se puede saber con certeza y no se puede garantizar la coherencia despus de un LOAD RESTART. Slo se puede suponer que el archivo est completo para una operacin de carga que se inicia y se completa en un solo paso. 3. Este modificador no soporta nombres de archivo con varias extensiones de archivo. Por ejemplo, dumpfile = /home/svtdbm6/DUMP.FILE es aceptable en el programa de utilidad de carga pero dumpfile = /home/svtdbm6/DUMP.LOAD.FILE no lo es. implieddecimal La ubicacin de una coma decimal implcita la determina la definicin de columna; ya no se supone que est al final del valor. Por ejemplo, el valor 12345 se carga en una columna DECIMAL(8,2) como 123,45, no como 12345,00. Este modificador no se puede utilizar con el modificador packeddecimal.
519
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador timeformat=x Descripcin x es el formato de la hora en el archivo fuente.a Los elementos de hora vlidos son: - Hora (uno o dos dgitos entre 0 y 12 para un sistema de 12 horas y entre 0 y 24 para un sistema de 24 horas) HH - Hora (dos dgitos entre 0 y 12 para un sistema de 12 horas y entre 0 y 24 para un sistema de 24 horas; se excluyen mutuamente con H) M - Minuto (uno o dos dgitos entre 0 y 59) MM - Minuto (dos dgitos entre 0 y 59; se excluyen mutuamente con M) S - Segundo (uno o dos dgitos entre 0 y 59) SS - Segundo (dos dgitos entre 0 y 59; se excluyen mutuamente con S) SSSSS - Segundo del da despus de medianoche (5 dgitos entre 00000 y 86399; se excluyen mutuamente con otros elementos de hora) TT - Indicador de meridiano (AM o PM) Se asigna un valor por omisin de 0 para cada elemento que no se ha especificado. He aqu unos ejemplos de formatos de hora: "HH:MM:SS" "HH.MM TT" "SSSSS" H
520
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador timestampformat=x Descripcin x es el formato de la indicacin de fecha y hora en el archivo fuente.a Los elementos de indicacin de fecha y hora vlidos son: - Ao (cuatro dgitos entre 0000 y 9999) - Mes (uno o dos dgitos entre 1 y 12) MM - Mes (dos dgitos entre 1 y 12; se excluyen mutuamente con M, mes) D - Da (uno o dos dgitos entre 1 y 31) DD - Da (dos dgitos entre 1 y 31; se excluyen mutuamente con D) DDD - Da del ao (tres dgitos entre 001 y 366; se excluyen mutuamente con otros elementos de da o mes) H - Hora (uno o dos dgitos entre 0 y 12 para un sistema de 12 horas y entre 0 y 24 para un sistema de 24 horas) HH - Hora (dos dgitos entre 0 y 12 para un sistema de 12 horas y entre 0 y 24 para un sistema de 24 horas; se excluyen mutuamente con H) M - Minuto (uno o dos dgitos entre 0 y 59) MM - Minuto (dos dgitos entre 0 y 59; se excluyen mutuamente con M, minuto) S - Segundo (uno o dos dgitos entre 0 y 59) SS - Segundo (dos dgitos entre 0 y 59; se excluyen mutuamente con S) SSSSS - Segundo del da despus de medianoche (5 dgitos entre 00000 y 86399; se excluyen mutuamente con otros elementos de hora) UUUUUU - Microsegundo (6 dgitos en el rango de 000000 a 999999) TT - Indicador de meridiano (AM o PM) Se asigna un valor por omisin de 1 para los elementos AAAA, M, MM, D, DD o DDD no especificados. Se asigna un valor por omisin de 0 para todos los dems elementos no especificados. A continuacin se muestra un ejemplo de un formato de indicacin de fecha y hora: "AAAA/MM/DD HH:MM:SS.UUUUUU" El ejemplo siguiente ilustra cmo importar datos que contienen formatos de fecha y hora definidos por el usuario a una tabla llamada schedule: db2 import from delfile2 of del modified by timestampformat="aaaa.mm.dd hh:mm tt" insert into schedule
AAAA M
521
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador noeofchar Descripcin El carcter opcional de fin de archivo x1A no se reconoce como el fin de archivo. El proceso contina como si fuera un carcter normal. Formato de archivo ASC (ASCII no delimitado) binarynumerics Los datos numricos (pero no DECIMAL) deben estar en formato binario, no en la representacin de caracteres. Esto evita conversiones costosas. Esta opcin slo se soporta con ASC posicional, utilizando los registros de longitud fija especificados por la opcin reclen. Se supone la opcin noeofchar. Se aplican las siguientes normas: v No se realiza ninguna conversin entre tipos de datos, a excepcin de BIGINT, INTEGER y SMALLINT. v Las longitudes de datos debe coincidir con las definiciones de columnas de destino. v Los FLOAT deben estar en formato de Coma flotante IEEE. v Se supone que los datos binarios del archivo fuente de carga son endian grandes, independientemente de la plataforma en la que se est ejecutando la operacin de carga. Nota: No pueden existir NULL en los datos para las columnas afectadas por este modificador. Los espacios en blanco (normalmente interpretados como NULL) se interpretan como un valor binario cuando se utiliza este modificador. nochecklengths Si se especifica nochecklengths, se intenta cargar cada fila, incluso si los datos de origen tienen una definicin de columna que excede el tamao de la columna de tabla de destino. Dichas filas se pueden cargar satisfactoriamente si la conversin de pgina de cdigos hace que los datos de origen se acorten; por ejemplo, datos EUC de 4 bytes en el origen pueden acortarse a datos DBCS de 2 bytes en el destino y necesitar la mitad del espacio. Esta opcin es especialmente til si se sabe que los datos de origen se adaptarn en todos los casos a pesar de las discrepancias de las definiciones de columna.
522
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador nullindchar=x Descripcin x es un carcter individual. Cambia el carcter que indica un valor NULL a x. El valor por omisin de x es Y.b Este modificador es sensible a las maysculas y minsculas para archivos de datos EBCDIC, excepto cuando el carcter es una letra inglesa. Por ejemplo, si se especifica que el carcter indicador de NULL sea la letra N, n se reconoce tambin como indicador NULL. packeddecimal Carga directamente datos decimales empaquetados, dado que el modificador binarynumerics no incluye el tipo de campo DECIMAL. Esta opcin slo se soporta con ASC posicional, utilizando los registros de longitud fija especificados por la opcin reclen. Se supone la opcin noeofchar. Los valores soportados para la porcin de signo son: + = 0xC 0xA 0xE 0xF - = 0xD 0xB No pueden existir NULL en los datos para las columnas afectadas por este modificador. Los espacios en blanco (normalmente interpretados como NULL) se interpretan como un valor binario cuando se utiliza este modificador. Independientemente de la plataforma de servidor, se supone que el orden de bytes de los datos binarios del archivo fuente de carga es endian grande; es decir, cuando se utiliza este modificador en los sistemas operativos Windows, no se debe invertir el orden de los bytes. Este modificador no se puede utilizar con el modificador implieddecimal. reclen=x x es un entero con un valor mximo de 32.767. Se leen x caracteres para cada fila y no se utiliza un carcter de nueva lnea para indicar el final de la fila. Trunca los espacios en blanco de cola al cargar datos en un campo de longitud variable. Si no se especifica esta opcin, se conservan los espacios en blanco. Esta opcin no se puede especificar junto con striptnulls. Son opciones que se excluyen mutuamente. Nota: Esta opcin sustituye la opcin t obsoleta, que slo se soporta por compatibilidad con niveles anteriores.
striptblanks
523
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador striptnulls Descripcin Trunca los NULL de cola (caracteres 0x00) al cargar datos en un campo de longitud variable. Si no se especifica esta opcin, se conservan los NULL. Esta opcin no se puede especificar junto con striptblanks. Son opciones que se excluyen mutuamente. Nota: Esta opcin sustituye la opcin padwithzero obsoleta, que slo se soporta por compatibilidad con niveles anteriores. zoneddecimal Carga datos decimales con zona, puesto que el modificador BINARYNUMERICS no incluye el tipo de campo DECIMAL. Esta opcin slo se soporta con ASC posicional, utilizando los registros de longitud fija especificados por la opcin RECLEN. Se supone la opcin NOEOFCHAR. Los valores de signo de medio byte pueden ser uno de los siguientes: + = 0xC 0xA 0xE 0xF - = 0xD 0xB Los valores soportados para dgitos son de 0x0 a 0x9. Los valores soportados para zonas son de 0x3 a 0xF. Formato de archivo DEL (ASCII delimitado) chardelx x es un delimitador de serie de un solo carcter.El valor por omisin son las comillas dobles ("). El carcter especificado se utiliza en lugar de las comillas para encerrar una serie de caracteres.bc Si desea especificar explcitamente las comillas () como delimitador de serie de caracteres, debe especificarse de la manera siguiente: modified by chardel"" Tambin se pueden especificar las comillas simples (') como delimitador de serie de caracteres del modo siguiente: modified by chardel'' coldelx x es un delimitador de columna de un solo carcter.El valor por omisin es una coma (,). Se utiliza el carcter especificado en lugar de una coma para indicar el final de una columna.bc Formato de fecha. Hace que todos los valores de datos de fecha se carguen en formato ISO.
datesiso
524
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador decplusblank Descripcin Carcter de signo ms. Hace que a los valores decimales positivos se les ponga un espacio en blanco como prefijo en lugar de un signo ms (+). La accin por omisin es poner a los valores decimales positivos un signo ms como prefijo. x es un sustituto de un solo carcter del punto como carcter de coma decimal. El valor por omisin es un punto (.). Se utiliza el carcter especificado como carcter de coma decimal en lugar de un punto.bc La prioridad por omisin actual para los delimitadores es: delimitador de registro, delimitador de carcter, delimitador de columna. Este modificador protege a las aplicaciones existentes que dependen de la prioridad ms antigua invirtiendo las prioridades de los delimitadores del modo siguiente: delimitador de carcter, delimitador de registro, delimitador de columna. Sintaxis: db2 load ... modified by delprioritychar ... Por ejemplo, dado el archivo de datos DEL siguiente: "Smith, Joshua",4000,34.98<delimitador de fila> "Vincent,<delimitador de fila>, is a manager", ... ... 4005,44.37<delimitador de fila> Si se especifica el modificador delprioritychar, slo habr dos filas en este archivo de datos. El segundo <delimitador de fila> se interpretar como parte de la primera columna de datos de la segunda fila, mientras que el primer y el tercer <delimitador de fila> se interpretarn como delimitadores de registro reales. Si no se especifica este modificador, habr tres filas en este archivo de datos, cada una de las cuales estar delimitada por un <delimitador de fila>. dldelx x es un delimitador DATALINK de un solo carcter. El valor por omisin es un punto y coma (;). Se utiliza el carcter especificado en lugar de un punto y coma como separador entre campos para un valor DATALINK. Es necesario porque un valor DATALINK puede tener ms de un subvalor. bcd Nota: x no debe ser el mismo carcter especificado como delimitador de serie de caracteres, de columna o de fila.
decptx
delprioritychar
525
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador keepblanks Descripcin Conserva los blancos iniciales y de cola en cada campo de tipo CHAR, VARCHAR, LONG VARCHAR o CLOB. Sin esta opcin, se eliminan todos los espacios en blanco iniciales y de cola que no estn incluidos entre los delimitadores de caracteres y se inserta un NULL en la tabla para todos los campos en blanco. El ejemplo siguiente ilustra cmo cargar datos en una tabla denominada TABLE1, al mismo tiempo que se conservan todos los espacios iniciales y de cola del archivo de datos: db2 load from delfile3 of del modified by keepblanks insert into table1 nodoubledel Suprime el reconocimiento de los delimitadores de caracteres dobles. Formato de archivo IXF forcein Indica al programa de utilidad que acepte datos a pesar de las discrepancias de pgina de cdigos y que suprima la conversin entre pginas de cdigos. Se comprueban los campos de destino de longitud fija para verificar que son suficientemente grandes para los datos. Si se especifica nochecklengths, no se realiza ninguna comprobacin y se realiza un intento de cargar cada fila. nochecklengths Si se especifica nochecklengths, se intenta cargar cada fila, incluso si los datos de origen tienen una definicin de columna que excede el tamao de la columna de tabla de destino. Dichas filas se pueden cargar satisfactoriamente si la conversin de pgina de cdigos hace que los datos de origen se acorten; por ejemplo, datos EUC de 4 bytes en el origen pueden acortarse a datos DBCS de 2 bytes en el destino y necesitar la mitad del espacio. Esta opcin es especialmente til si se sabe que los datos de origen se adaptarn en todos los casos a pesar de las discrepancias de las definiciones de columna.
526
Command Reference
LOAD
Tabla 8. Modificadores de tipo de archivo vlidos (LOAD) (continuacin) Modificador Notas:
a
Descripcin
Es obligatorio escribir la serie de formato de fecha entre comillas dobles. Los separadores de campo no pueden contener ninguno de los caracteres siguientes: a-z, A-Z y 0-9. El separador de campo no debe ser igual que el delimitador de carcter o de campo en el formato de archivo DEL. Un separador de campo es opcional si las posiciones inicial y final de un elemento no son ambiguas. La ambigedad puede existir si (segn el modificador) se utilizan elementos tales como D, H, M o S, debido a la longitud variable de las entradas. Para formatos de indicacin de fecha y hora, hay que tener cuidado de evitar la ambigedad entre los descriptores de mes y de minuto, dado que ambos utilizan la letra M. Un campo de mes debe estar junto a otros campos de fecha. Un campo de minuto debe ser adyacente a otros campos de hora. He aqu unos formatos ambiguos de indicacin de fecha y hora: "M" (puede ser mes o minuto) "M:M" (Cul es cada uno?) "M:AAAA:M" (Ambos se interpretan como mes). "S:M:AAAA" (adyacente a un valor de hora y un valor de fecha) En los casos ambiguos, el programa de utilidad informar con un mensaje de error y la operacin fallar. He aqu unos formatos no ambiguos de indicacin de fecha y hora: "M:AAAA" (Mes) "S:M" (Minuto) "M:AAAA:S:M" (Mes....Minuto) "M:H:AAAA:M:D" (Minuto....Mes) Nota: Algunos caracteres, como las comillas dobles y las barras inclinadas invertidas, deben ir precedidos de un carcter de escape (por ejemplo \).
El carcter debe especificarse en la pgina de cdigos de los datos de origen.
Se puede especificar el elemento de cdigo de carcter (en lugar del smbolo de carcter), utilizando la sintaxis xJJ o 0xJJ, donde JJ es la representacin hexadecimal del elemento de cdigo. Por ejemplo, para especificar el carcter # como delimitador de columna, utilice uno de los siguientes: ... modified by coldel# ... ... modified by coldel0x23 ... ... modified by coldelX23 ...
c Restricciones del delimitador lista las restricciones que se aplican a los caracteres que se pueden utilizar como alteracin temporal de los delimitadores. d
Incluso si el carcter delimitador DATALINK es vlido dentro de la sintaxis URL, perder su significado especial dentro del mbito de la operacin de carga.
La utilidad de carga no emite un aviso si se intentan usar tipos de archivos no soportados con la opcin MODIFIED BY. Si se intenta esto, la operacin de carga falla
527
LOAD
y se devuelve un cdigo de error.
Informacin relacionada: v Mandato QUIESCE TABLESPACES FOR TABLE en la pgina 576 v Partitioned Database Load Configuration Options del manual Data Movement Utilities Guide and Reference
528
Command Reference
LOAD QUERY Mandato LOAD QUERY

Comprueba el estado de una operacin de carga durante el proceso y devuelve el estado de tabla. Si una carga no se est procesando, slo se devuelve el estado de tabla. Para invocar satisfactoriamente este mandato tambin se necesitan una conexin a la misma base de datos y una conexin CLP independiente. Lo pueden utilizar usuarios locales o remotos. Autorizacin: Ninguna Conexin necesaria: Base de datos Sintaxis del mandato:
LOAD QUERY TABLE nombre-tabla TO archivo-mensajes-local
NOSUMMARY SUMMARYONLY
SHOWDELTA
Parmetros del mandato: NOSUMMARY Especifica que no se debe proporcionar informacin de resumen de carga (filas ledas, filas saltadas, filas cargadas, filas rechazadas, filas suprimidas, filas comprometidas y diversos avisos). SHOWDELTA Especifica que slo se debe proporcionar informacin nueva (perteneciente a sucesos de carga que se han producido desde la ltima invocacin del mandato LOAD QUERY). SUMMARYONLY Especifica que slo se debe proporcionar informacin de resumen de carga. TABLE nombre-tabla Especifica el nombre de la tabla en la que se estn cargando datos actualmente. Si se especifica un nombre de tabla no calificado, se calificar la tabla con CURRENT SCHEMA. TO archivo-mensajes-local Especifica el destino para los mensajes de aviso y error que se producen durante la operacin de carga. Este archivo no puede ser el
529
LOAD QUERY
archivo-mensajes especificado para el mandato LOAD. Si el archivo ya existe, todos los mensajes que ha generado el programa de utilidad de carga se aadirn al mismo. Ejemplos: Un usuario que carga una gran cantidad de datos en la tabla STAFF desea comprobar el estado de la operacin de carga. El usuario puede especificar:
db2 connect to <basedatos> db2 load query table staff to /u/midir/staff.tempmsg
El archivo de salida /u/midir/staff.tempmsg puede tener un aspecto similar al siguiente:

SQL3501W El (Los) espacio(s) de tabla en el que reside la tabla no se colocar en estado de pendiente de copia de seguridad dado que la recuperacin en avance est inhabilitada para la base de datos. SQL3109N El programa de utilidad est iniciando la carga de datos del archivo "/u/midir/data/staffbig.del" SQL3500W El programa de utilidad comienza la fase "LOAD" a la hora "03-21-2002 11:31:16.597045". SQL3519W Inicio de la carga del punto de coherencia. Cuenta de registros de entrada = "0". SQL3520W SQL3519W SQL3520W SQL3519W SQL3520W SQL3519W SQL3520W SQL3519W SQL3520W SQL3532I Se ha cargado satisfactoriamente el punto de coherencia. Inicio de la carga del punto de coherencia. Cuenta de registro de entrada = "104416". Se ha cargado satisfactoriamente el punto de coherencia. Inicio de la carga del punto de coherencia. Cuenta de registro de entrada = "205757". Se ha cargado satisfactoriamente el punto de coherencia. Inicio de la carga del punto de coherencia. Cuenta de registros de entrada = "307098". Se ha cargado satisfactoriamente el punto de coherencia. Inicio de la carga del punto de coherencia. Cuenta de registros de entrada = "408439". Se ha cargado satisfactoriamente el punto de coherencia. El programa de utilidad Load est actualmente en la fase "LOAD". = 453376
Nmero de filas ledas
530
Command Reference
LOAD QUERY
Nmero Nmero Nmero Nmero Nmero Nmero de de de de de de filas saltadas filas cargadas filas rechazadas filas suprimidas filas comprom. avisos = = = = = = 0 453376 0 0 408439 0
Estado de tabla: Carga en proceso
Notas de uso: Adems de los bloqueos, el programa de utilidad de carga utiliza estados de tabla para controlar el acceso a la tabla. El mandato LOAD QUERY puede utilizarse para determinar el estado de tabla; puede utilizarse LOAD QUERY en las tablas que no se estn cargando actualmente. Los estados de tabla descritos por LOAD QUERY son los siguientes: Normal Ningn estado de tabla afecta a la tabla. Pendiente de comprobacin La tabla tiene restricciones y stas todava tienen que verificarse. Utilice el mandato SET INTEGRITY para sacar la tabla del estado de pendiente de comprobacin. El programa de utilidad de carga pone una tabla en estado de pendiente de comprobacin cuando empieza una carga en una tabla con restricciones. Carga en proceso Hay una carga activamente en proceso en esta tabla. Pendiente de carga Una carga ha estado activa en esta tabla pero ha terminado anormalmente antes de que la carga se pudiera comprometer. Emita LOAD TERMINATE, LOAD RESTART o LOAD REPLACE para sacar la tabla del estado de pendiente de carga. Slo acceso de lectura Los datos de la tabla estn disponibles para consultas de acceso de lectura. Las cargas que utilizan la opcin ALLOW READ ACCESS ponen la tabla en estado de Slo acceso de lectura. No disponible La tabla no est disponible. La tabla slo se puede eliminar o se puede restaurar de una copia de seguridad. Un avance a travs de una carga no recuperable pondr una tabla en estado no disponible. No reiniciable de carga La tabla est en un estado parcialmente cargado que no permitir un reinicio de carga. La tabla tambin estar en estado de pendiente de carga. Emita LOAD TERMINATE o LOAD REPLACE para sacar la
531
LOAD QUERY
tabla del estado No reiniciable de carga. La tabla puede colocarse en estado de tabla no reiniciable de carga durante una operacin de avance. Esto se puede producir si se avanza hasta un punto en el tiempo anterior al final de una operacin de carga, o si se avanza a travs de una operacin de carga terminada anormalmente pero no se avanza hasta el final de la operacin LOAD TERMINATE o LOAD RESTART. Desconocido La consulta de carga no puede determinar un estado de tabla. Informacin relacionada: v Mandato LOAD en la pgina 481
532
Command Reference
MIGRATE DATABASE Mandato MIGRATE DATABASE

Convierte versiones anteriores de bases de datos DB2 a formatos actuales. Atencin: La herramienta de premigracin de bases de datos debe ejecutarse antes de la instalacin de DB2 Versin 8 (en los sistemas operativos Windows) o antes de la migracin de instancia (en los sistemas basados en UNIX), porque no se puede ejecutar en DB2 Versin 8. En Windows, la herramienta de premigracin es db2ckmig. En los sistemas UNIX, db2imigr realiza tareas similares. Haga una copia de seguridad de todas las bases de datos antes de la migracin y antes de la instalacin de DB2 Versin 8 en los sistemas operativos Windows. Autorizacin: sysadm Conexin necesaria: Este mandato establece una conexin de base de datos. Sintaxis del mandato:
MIGRATE DATABASE DB alias-base-datos
USER
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos que se debe migrar a la versin del gestor de bases de datos instalada actualmente. USER nombreusuario Identifica el nombre de usuario bajo el que debe migrarse la base de datos. USING contrasea Contrasea utilizada para autentificar el nombre de usuario. Si se omite la contrasea, pero se ha especificado un nombre de usuario, se le solicitar al usuario que la entre. Ejemplos:
533
MIGRATE DATABASE
El ejemplo siguiente migra la base de datos catalogada bajo el alias de base de datos sales:
db2 migrate database sales
Notas de uso: Este mandato slo migrar una base de datos a una versin ms nueva y no se puede utilizar para convertir una base de datos migrada a su versin anterior. La base de datos debe catalogarse antes de la migracin. Si se produce un error durante la migracin, puede que sea necesario emitir el mandato TERMINATE antes de intentar la respuesta de usuario sugerida. Por ejemplo, si se produce un error de anotacin cronolgica llena durante la migracin (SQL1704: Ha fallado la migracin a la base de datos. Cdigo de razn 3.), ser necesario emitir el mandato TERMINATE antes de aumentar los valores de los parmetros de configuracin de base de datos LOGPRIMARY y LOGFILSIZ. El CLP debe renovar la antememoria de directorio de base de datos si la anomala de migracin se produce despus de que ya se haya reubicado la base de datos (lo cual es probable que suceda cuando se devuelve un error de anotacin cronolgica llena). Informacin relacionada: v Mandato TERMINATE en la pgina 691
534
Command Reference
PING Mandato PING

Prueba el tiempo de respuesta de red de la conectividad subyacente entre un cliente y un servidor de bases de datos conectado. Autorizacin: Ninguna Conexin necesaria: Base de datos Sintaxis del mandato:
TIME 1 PING db_alias nmero_de_veces TIMES TIME
Parmetros del mandato: db_alias Especifica el alias de base de datos para la base de datos en un servidor DRDA al que se enva el sondeo. Nota: Este parmetro, aunque es obligatorio, no se utiliza actualmente. Se reserva para utilizarlo en el futuro. Se puede especificar cualquier nombre de alias de base de datos vlido. nmero de veces Especifica el nmero de repeticiones para esta prueba. El valor debe estar entre 1 y 32767 inclusive. El valor por omisin es 1. Se devolver un tiempo para cada repeticin. Ejemplos: Para probar una vez el tiempo de respuesta de red para la conexin con el servidor de bases de datos de sistema principal hostdb:
db2 ping hostdb 1 o: db2 ping hostdb
El mandato visualizar una salida similar a la siguiente:

535
PING
Tiempo transcurrido: 7221 microsegundos
Para probar 5 veces el tiempo de respuesta de red para la conexin con el servidor de bases de datos de sistema principal hostdb:
o: db2 ping hostdb 5 db2 ping hostdb 5 times
El mandato visualizar una salida similar a la siguiente:

Tiempo Tiempo Tiempo Tiempo Tiempo transcurrido: transcurrido: transcurrido: transcurrido: transcurrido: 8412 microsegundos 11876 microsegundos 7789 microsegundos 10124 microsegundos 10988 microsegundos
Notas de uso: Debe existir una conexin de base de datos antes de emitir este mandato o de lo contrario se producir un error. El tiempo transcurrido que se devuelve es para la conexin entre el cliente DB2 y el servidor DB2.
536
Command Reference
PRECOMPILE Mandato PRECOMPILE

Procesa un archivo fuente de programa de aplicacin que contiene sentencias de SQL incorporadas. Se produce un archivo fuente modificado, que contiene llamadas de lenguaje de sistema principal para las sentencias de SQL y, por omisin, se crea un paquete en la base de datos. mbito: Este mandato puede emitirse desde cualquier particin de base de datos de db2nodes.cfg. En un entorno de bases de datos particionado, puede emitirse desde cualquier servidor de particiones de base de datos definido en el archivo db2nodes.cfg. Actualiza los catlogos de base de datos de la particin de base de datos de catlogo. Sus efectos son visibles en todas las particiones de base de datos. Autorizacin: Una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio BINDADD si no existe un paquete y una de las opciones siguientes: Autorizacin IMPLICIT_SCHEMA en la base de datos si el nombre de esquema del paquete no existe Privilegio CREATEIN en el esquema si existe el nombre de esquema del paquete v Privilegio ALTERIN en el esquema si existe el paquete v Privilegio BIND en el paquete si ste existe. El usuario tambin necesita todos los privilegios necesarios para compilar las sentencias de SQL estticas en la aplicacin. Los privilegios otorgados a grupos no se utilizan para la comprobacin de autorizacin de las sentencias estticas. Si el usuario tiene autorizacin sysadm, pero no tiene privilegios explcitos para completar la vinculacin, el gestor de bases de datos otorga automticamente autorizacin dbadm explcita. Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
537
PRECOMPILE
Para DB2 para Windows y UNIX
PRECOMPILE PREP nombre-archivo
ACTION
ADD REPLACE RETAIN NO YES REPLVER id-versin
BINDFILE USING archivo-vinculacin
BLOCKING
UNAMBIG ALL NO
COLLECTION
nombre-esquema
CALL_RESOLUTION
IMMEDIATE DEFERRED
CONNECT
1 2
DATETIME
DEF EUR ISO JIS LOC USA
DEFERRED_PREPARE
NO ALL YES
DEGREE
DISCONNECT
EXPLICIT AUTOMATIC CONDITIONAL
DYNAMICRULES
RUN BIND INVOKERUN INVOKEBIND DEFINERUN DEFINEBIND
EXPLAIN
NO ALL YES
EXPLSNAP
NO ALL YES
FEDERATED
NO YES FUNCPATH
, nombre-esquema
GENERIC
serie
INSERT
DEF BUF
ISOLATION
CS RR RS UR
LANGLEVEL
SAA1 MIA SQL92E
538
Command Reference
PRECOMPILE
LEVEL seal de coherencia (1) LONGERROR NO YES
MESSAGES
archivo-mensajes
NOLINEMACRO
OPTLEVEL
0 1
OUTPUT
nombre-archivo
OWNER
id-autorizacin
PACKAGE USING nombre-paquete
PREPROCESSOR
mandato-preprocesador mandato-preprocesador
QUALIFIER
nombre-calificador
QUERYOPT
nivel-optimizacin
SQLCA
NONE SAA
(2) SQLERROR NOPACKAGE CHECK CONTINUE
SQLFLAG
SQL92E MVSDB2V23 MVSDB2V31 MVSDB2V41
SYNTAX
SQLRULES
DB2 STD
SQLWARN
NO YES
SYNCPOINT
ONEPHASE NONE TWOPHASE
SYNTAX
TARGET
IBMCOB MFCOB ANSI_COBOL C CPLUSPLUS FORTRAN
TRANSFORM GROUP nombregrupo
VALIDATE
BIND RUN
WCHARTYPE
NOCONVERT CONVERT
VERSION
id-versin AUTO
Notas: 1 NO es el valor por omisin para sistemas de 32 bits y para sistemas NT

539
PRECOMPILE
de 64 bits donde pueden utilizarse variables de sistema principal largas como declaraciones para columnas INTEGER. YES es el valor por omisin para sistemas UNIX de 64 bits. 2 SYNTAX es un sinnimo de SQLERROR(CHECK).
Para DB2 en servidores que no sean Windows o UNIX

PRECOMPILE PREP nombre-archivo
ACTION
ADD REPLACE YES NO REPLVER id-versin
RETAIN
BINDFILE USING archivo-vinculacin BLOCKING
UNAMBIG ALL NO
CALL_RESOLUTION
IMMEDIATE DEFERRED
CCSIDG
ccsid-doble
CCSIDM
ccsid-mixto
CCSIDS
ccsid-sbcs CHARSUB
DEFAULT BIT MIXED SBCS
CNULREQD
YES NO
COLLECTION
nombre-esquema
COMPILE PRECOMPILE
CONNECT
1 2
(1) DATETIME DEF EUR ISO JIS LOC USA
DBPROTOCOL
DRDA PRIVATE
DEC
15 31
DECDEL
PERIOD COMMA
DEFERRED_PREPARE
NO ALL YES
(2) DEGREE
540
Command Reference
PRECOMPILE
EXPLICIT AUTOMATIC CONDITIONAL RUN BIND INVOKERUN INVOKEBIND DEFINERUN DEFINEBIND
DISCONNECT
DYNAMICRULES
ENCODING
ASCII EBCDIC UNICODE CCSID
EXPLAIN
NO YES
FEDERATED
NO YES
GENERIC
serie
IMMEDWRITE
NO YES PH1
ISOLATION
CS NC RR RS UR
KEEPDYNAMIC
YES NO
LEVEL
seal-coherencia
(3) LONGERROR
NO YES
MESSAGES
archivo-mensajes
NOLINEMACRO
OPTHINT
id-pista OPTLEVEL
0 1
OS400NAMING
SYSTEM SQL
OWNER
id-autorizacin
PREPROCESSOR
mandato-preprocesador mandato-preprocesador
QUALIFIER
nombre-calificador RELEASE
COMMIT DEALLOCATE
REOPT VARS
NOREOPT VARS
SQLFLAG
SQL92E MVSDB2V23 MVSDB2V31 MVSDB2V41
SYNTAX
SORTSEQ
JOBRUN HEX
SQLRULES
DB2 STD
SQLERROR
NOPACKAGE CHECK CONTINUE
541
PRECOMPILE
APOSTROPHE QUOTE ONEPHASE NONE TWOPHASE SYNTAX
STRDEL
SYNCPOINT
TARGET
IBMCOB MFCOB ANSI_COBOL C CPLUSPLUS FORTRAN BORLAND_C BORLAND_CPLUSPLUS
TEXT
etiqueta
VERSION
id-versin AUTO
VALIDATE
BIND RUN
WCHARTYPE
NOCONVERT CONVERT
Notas: 1 2 3 Si el servidor no da soporte a la opcin DATETIME DEF, se correlaciona con DATETIME ISO. La opcin DEGREE slo est soportada por Servidores de aplicaciones DRDA Nivel 2. NO es el valor por omisin para sistemas de 32 bits y para sistemas NT de 64 bits donde pueden utilizarse variables de sistema principal largas como declaraciones para columnas INTEGER. YES es el valor por omisin para sistemas UNIX de 64 bits.
Parmetros del mandato: nombre-archivo Especifica el archivo fuente que se debe precompilar. Se debe especificar una extensin de: v .sqc para aplicaciones C (genera un archivo .c) v Debe especificarse .sqx (para sistemas operativos Windows) o .sqC (sistemas basados en UNIX) para las aplicaciones C++ (genera un archivo .cxx en los sistemas operativos Windows o un archivo .C en los sistemas basados en UNIX) v .sqb para aplicaciones COBOL (genera un archivo .cbl) v Debe especificarse .sqf para las aplicaciones FORTRAN (genera un archivo .for en los sistemas operativos Windows o un archivo .f en los sistemas basados en UNIX). La extensin preferida para aplicaciones C++ que contienen SQL incorporado en sistemas basados en UNIX es sqC; sin embargo, los
542
Command Reference
PRECOMPILE
sistemas basados en UNIX toleran el convenio sqx, que se invent para sistemas que no son sensibles a las maysculas y minsculas. ACTION Indica si el paquete se puede aadir o sustituir. ADD Indica que el paquete mencionado no existe y que se debe crear un paquete nuevo. Si el paquete ya existe, se detiene la ejecucin y se devuelve un mensaje de error de diagnstico.
REPLACE Indica que el paquete existente ha de sustituirse por uno nuevo que tiene el mismo nombre de paquete y creador. Es el valor por omisin de la opcin ACTION. RETAIN Indica si se deben conservar las autorizaciones de EXECUTE cuando se sustituye un paquete. Si cambia la propiedad del paquete, el nuevo propietario otorga la autorizacin BIND y EXECUTE al propietario anterior del paquete. NO No conserva las autorizaciones EXECUTE cuando se sustituye un paquete. Este valor no est soportado por DB2. Conserva las autorizaciones EXECUTE cuando se sustituye un paquete. Este es el valor por omisin.
YES
REPLVER id-versin Sustituye una versin especfica de un paquete. El identificador de versin especifica qu versin del paquete debe sustituirse. Si la versin especificada no existe, se devolver un error. Si no se especifica la opcin REPLVER de REPLACE y ya existe un paquete que coincide con el nombre de paquete y la versin del paquete que se est precompilando, dicho paquete ser sustituido; de lo contrario, se aadir un paquete nuevo. BINDFILE Produce la creacin de un archivo de vinculacin. No se crea un paquete a no ser que tambin se especifique la opcin package. Si se solicita un archivo de vinculacin, pero no se debe crear ningn paquete, como en el ejemplo siguiente:
db2 prep sample.sqc bindfile
Los SQLCODE de autentificacin y existencia de objeto se tratarn como avisos en lugar de errores. Esto permitir crear un archivo de
543
PRECOMPILE
vinculacin satisfactoriamente, incluso si la base de datos que se est utilizando para la precompilacin no tiene todos los objetos a los que se hace referencia en las sentencias de SQL estticas dentro de la aplicacin. El archivo de vinculacin puede vincularse satisfactoriamente, creando un paquete, una vez que se han creado los objetos necesarios. USING archivo-vinculacin Nombre del archivo de vinculacin que debe generar el precompilador. El nombre de archivo debe tener una extensin de .bnd. Si no se entra un nombre de archivo, el precompilador utilizar el nombre del programa (entrado como el parmetro nombre-archivo) y aadir la extensin .bnd. Si no se proporciona una va de acceso, el archivo de vinculacin se crea en el directorio actual. BLOCKING Para obtener informacin acerca del bloqueo de filas, consulte la publicacin Administration Guide. ALL Especifica bloquear para: v Cursores de slo lectura v Cursores no especificados como FOR UPDATE OF Los cursores ambiguos se tratan como de slo lectura. NO Especifica no bloquear ningn cursor. Los cursores ambiguos se tratan como actualizables.
UNAMBIG Especifica bloquear para: v Cursores de slo lectura v Cursores no especificados como FOR UPDATE OF Los cursores ambiguos se tratan como actualizables. CALL_RESOLUTION Si se establece, la opcin CALL_RESOLUTION DEFERRED indica que se ejecutar la sentencia CALL como invocacin de la API sqleproc() desaprobada. Si no se establece, o si se establece IMMEDIATE, la sentencia CALL se ejecutar como una sentencia normal de SQL. Tenga en cuenta que se emitir SQL0204 si el precompilador no resuelve el procedimiento en una sentencia CALL con CALL_RESOLUTION IMMEDIATE. CCSIDG ccsid-doble Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de doble byte en las
544
Command Reference
PRECOMPILE
definiciones de columnas de caracteres (sin una clusula CCSID especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CCSIDM ccsid-mixto Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de bytes mixtos en las definiciones de columnas de caracteres (sin una clusula CCSID especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CCSIDS ccsid-sbcs Entero que especifica el identificador de juego de caracteres codificado (CCSID) que se debe utilizar para caracteres de un solo byte en las definiciones de columnas de caracteres (sin una clusula CCSID especfica) en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. CHARSUB Designa el subtipo de carcter por omisin que se debe utilizar para las definiciones de columnas en las sentencias CREATE y ALTER TABLE de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. BIT Utiliza el subtipo de carcter FOR BIT DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito.
DEFAULT Utiliza el valor por omisin definido por el sistema de destino en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. MIXED Utiliza el subtipo de carcter FOR MIXED DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. SBCS Utiliza el subtipo de carcter FOR SBCS DATA SQL en todas las columnas de caracteres nuevas para las que no se ha especificado un subtipo explcito. CNULREQD Esta opcin est relacionada con la opcin de precompilacin
545
PRECOMPILE
langlevel, que DRDA no soporta. Slo es vlida si el archivo de vinculacin se crea desde una aplicacin C o C++. DB2 no soporta esta opcin de vinculacin de DRDA. NO La aplicacin se ha codificado en base a la opcin de precompilacin langlevel de SAA1 respecto al terminador nulo de las variables de sistema principal de serie C. La aplicacin se ha codificado en base a la opcin de precompilacin langlevel de MIA respecto al terminador nulo de las variables de sistema principal de serie C.
YES
COLLECTION nombre-esquema Especifica un identificador de coleccin de 30 caracteres para el paquete. Si no se especifica, se utilizar el identificador de autorizacin para el usuario que procesa el paquete. CONNECT 1 2 Especifica que una sentencia CONNECT debe procesarse como CONNECT de tipo 1. Especifica que una sentencia CONNECT debe procesarse como CONNECT de tipo 2.
DATETIME Especifica el formato de fecha y hora que se debe utilizar. DEF EUR ISO Utiliza un formato de fecha y hora asociado al cdigo de territorio de la base de datos. Utiliza el estndar de IBM para el formato de fecha y hora europeo. Utiliza el formato de fecha y hora de la International Standards Organization (Organizacin internacional de estndares). Utiliza el formato de fecha y hora del Japanese Industrial Standard (Estndar industrial japons). Utiliza el formato de fecha y hora en la forma local asociada al cdigo de territorio de la base de datos. Utiliza el estndar de IBM para el formato de fecha y hora de EE.UU.
JIS LOC USA
DBPROTOCOL Especifica el protocolo que se va a utilizar al conectar con un sitio remoto identificado por una sentencia de nombre en tres partes. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390.
546
Command Reference
PRECOMPILE
DEC Especifica la precisin mxima que se debe utilizar en operaciones aritmticas decimales. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. 15 31 Se utiliza la precisin de 15 dgitos en las operaciones aritmticas decimales. Se utiliza la precisin de 31 dgitos en las operaciones aritmticas decimales.
DECDEL Indica si se utilizar un punto (.) o una coma (,) como indicador de coma decimal en los literales decimales y de coma flotante. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. COMMA Utilizar una coma (,) como indicador de coma decimal. PERIOD Utilizar un punto (.) como indicador de coma decimal. DEFERRED_PREPARE Proporciona una mejora de rendimiento cuando se accede a bases de datos de servidor comunes DB2 o a bases de datos DRDA. Esta opcin combina el flujo de sentencias PREPARE de SQL con el flujo de sentencias OPEN, DESCRIBE o EXECUTE asociado para minimizar el flujo entre procesos o de red. NO YES La sentencia PREPARE se ejecutar en el momento de emitirse. La ejecucin de la sentencia PREPARE se diferir hasta que se emita la sentencia OPEN, DESCRIBE o EXECUTE correspondiente. La sentencia PREPARE no se diferir si utiliza la clusula INTO, que requiere que se devuelva un SQLDA inmediatamente. Sin embargo, si se emite la sentencia PREPARE INTO para un cursor que no utiliza ningn marcador de parmetro, el proceso se optimizar al ejecutar previamente OPEN en el cursor cuando se ejecute PREPARE. ALL Igual que YES, excepto que tambin se difiere una sentencia PREPARE INTO. Si la sentencia PREPARE utiliza la clusula INTO para devolver un SQLDA, la aplicacin no debe hacer referencia al contenido de este SQLDA hasta que se emita y se devuelva la sentencia OPEN, DESCRIBE o EXECUTE.
547
PRECOMPILE
DEGREE Especifica el grado de paralelismo para la ejecucin de sentencias de SQL estticas en un sistema SMP. Esta opcin no afecta al paralelismo de CREATE INDEX. 1 La ejecucin de la sentencia no utilizar paralelismo.
grado-de-paralelismo Especifica el grado de paralelismo con el que se puede ejecutar la sentencia, un valor entre 2 y 32.767 (inclusive). ANY Especifica que la ejecucin de la sentencia puede incluir paralelismo utilizando un grado determinado por el gestor de bases de datos.
DISCONNECT AUTOMATIC Especifica que todas las conexiones a la base de datos deben desconectarse al comprometerse. CONDITIONAL Especifica que las conexiones a la base de datos que se han marcado RELEASE o que no tienen cursores WITH HOLD abiertos deben desconectarse al comprometerse. EXPLICIT Especifica que slo las conexiones a la base de datos que la sentencia RELEASE ha marcado explcitamente para liberarse deben desconectarse al comprometerse. DYNAMICRULES Define qu normas se aplican al SQL dinmico en tiempo de ejecucin para el valor inicial de los valores utilizados para el ID de autorizacin y para la calificacin implcita de referencias de objetos no calificadas. RUN Especifica que se debe utilizar el ID de autorizacin del usuario que ejecuta el paquete para la comprobacin de autorizacin de sentencias de SQL dinmico. El ID de autorizacin se utilizar tambin como calificador de paquetes por omisin para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico. Este es el valor por omisin.
BIND Especifica que en tiempo de ejecucin deben utilizarse todas las normas que se aplican al SQL esttico para autorizacin y calificacin. Es decir, se debe utilizar el ID de autorizacin del propietario del paquete para la comprobacin de autorizacin de sentencias de SQL dinmicas y se debe utilizar el
548
Command Reference
PRECOMPILE
calificador de paquete por omisin para la calificacin implcita de referencias de objeto no calificadas dentro de las sentencias de SQL dinmicas. DEFINERUN Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin del definidor de rutina debe utilizarse para la comprobacin de autorizacin y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de la rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES RUN. DEFINEBIND Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin del definidor de rutina debe utilizarse para la comprobacin de autorizacin y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de la rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES BIND. INVOKERUN Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin de la sentencia actual en vigor al invocar la rutina debe utilizarse para la comprobacin de autorizacin de sentencias de SQL dinmico y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de esa rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES RUN. INVOKEBIND Si el paquete se utiliza en el contexto de una rutina, el ID de autorizacin de la sentencia actual en vigor al invocar la rutina debe utilizarse para la comprobacin de autorizacin de sentencias de SQL dinmico y para la calificacin implcita de referencias de objeto no calificadas en sentencias de SQL dinmico dentro de esa rutina. Si el paquete se utiliza como una aplicacin autnoma, las sentencias de SQL dinmico se procesan como si el paquete estuviera vinculado a DYNAMICRULES BIND.
549
PRECOMPILE
Nota: Dado que las sentencias de SQL dinmico utilizarn el ID de autorizacin del propietario del paquete en un paquete que exhibe un comportamiento de vinculacin, no se debe otorgar al vinculador del paquete ninguna autorizacin que el usuario del paquete no deba recibir. De forma similar, al definir una rutina que exhiba un comportamiento de definicin, no se debe otorgar al definidor de la rutina ninguna autorizacin que el usuario del paquete no deba recibir, ya que una sentencia dinmica utilizar el ID de autorizacin del definidor de la rutina. Para obtener ms informacin acerca de los comportamientos de los paquetes, consulte la seccin relativa a cmo DYNAMICRULES afecta al comportamiento de las sentencias de SQL dinmico de la publicacin Application Development Guide. Las siguientes sentencias de SQL preparadas dinmicamente no se pueden utilizar dentro de un paquete que no se haya vinculado con DYNAMICRULES RUN: GRANT, REVOKE, ALTER, CREATE, DROP, COMMENT ON, RENAME, SET INTEGRITY y SET EVENT MONITOR STATE. ENCODING Especifica la codificacin para todas las variables de sistema principal en sentencias estticas del plan o del paquete. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. EXPLAIN Almacena informacin en las tablas de Explain acerca de los planes de acceso elegidos para cada sentencia de SQL del paquete. DRDA no soporta el valor ALL para esta opcin. NO YES La informacin de Explain no se capturar. Las tablas de Explain se llenarn con informacin acerca del plan de acceso elegido en tiempo de precompilacin/vinculacin las sentencias estticas y en tiempo de ejecucin para las sentencias de vinculacin incremental. Si el paquete va a utilizarse para una rutina y el paquete contiene sentencias de vinculacin incremental, la rutina debe definirse como MODIFIES SQL DATA. Si esto no se hace as, las sentencias de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). ALL La informacin de Explain para cada sentencia de SQL esttica elegible se colocar en las tablas de Explain en tiempo de precompilacin/vinculacin. La informacin de Explain
550
Command Reference
PRECOMPILE
para cada sentencia de SQL de vinculacin incremental elegible se colocar en las tablas de Explain en tiempo de ejecucin. Adems, se reunir informacin de Explain para las sentencias de SQL dinmico elegibles en tiempo de ejecucin, aunque el registro CURRENT EXPLAIN SNAPSHOT est establecido en NO. Si el paquete ha de utilizarse para una rutina, sta debe definirse como MODIFIES SQL DATA, o las sentencias dinmicas y de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). Nota: DRDA no soporta este valor para EXPLAIN. EXPLSNAP Almacena informacin de Instantnea de Explain en las tablas de Explain. DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. NO YES No se capturar una Instantnea de Explain. Se colocar una Instantnea de Explain para cada sentencia de SQL esttica elegible en las tablas de Explain en tiempo de precompilacin/vinculacin para las sentencias estticas y en tiempo de ejecucin para las sentencias de vinculacin incremental. Si el paquete ha de utilizarse para una rutina y contiene sentencias de vinculacin incremental, la rutina debe definirse como MODIFIES SQL DATA, o las sentencias de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). ALL Se colocar una Instantnea de Explain para cada sentencia de SQL esttica elegible en las tablas de Explain en tiempo de precompilacin/vinculacin. La informacin de instantnea de Explain para cada sentencia de SQL de vinculacin incremental elegible se colocar en las tablas de Explain en tiempo de ejecucin. Adems, se reunir informacin de Explain Snapshot para las sentencias de SQL dinmico elegibles en tiempo de ejecucin, aunque el registro CURRENT EXPLAIN SNAPSHOT est establecido en NO. Si el paquete ha de utilizarse para una rutina, sta debe definirse como MODIFIES SQL DATA, o las sentencias dinmicas y de vinculacin incremental del paquete causarn un error de tiempo de ejecucin (SQLSTATE 42985). FEDERATED Especifica si una sentencia de SQL esttica de un paquete hace
551
PRECOMPILE
referencia a un apodo o a una vista federada. Si no se especifica esta opcin y una sentencia de SQL esttica de un paquete hace referencia a un apodo o a una vista federada, se devuelve un aviso y se crea el paquete. Nota: Esta opcin no est soportada por los servidores DRDA. NO No se hace referencia a ningn apodo ni vista federada en las sentencias de SQL estticas del paquete. Si se encuentra un apodo o una vista federada en una sentencia de SQL esttica durante la fase de preparacin o de vinculacin de este paquete, se devuelve un error y el paquete no se crea. Se puede hacer referencia a un apodo o a una vista federada en las sentencias de SQL estticas del paquete. Si no se encuentra ningn apodo ni ninguna vista federada en las sentencias de SQL estticas durante la preparacin o la vinculacin del paquete, no se devuelven errores ni avisos y el paquete se crea.
YES
FUNCPATH Especifica la va de acceso de funcin que se debe utilizar al resolver funciones y tipos diferenciados definidos por el usuario en SQL esttico. Si no se especifica esta opcin, la va de acceso de funcin por omisin es SYSIBM,SYSFUN,USER donde USER es el valor del registro especial USER. DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. nombre-esquema Identificador de SQL, ordinario o delimitado, que identifica un esquema que existe en el servidor de aplicaciones. No se realiza ninguna validacin de que el esquema existe en el momento de la precompilacin o de la vinculacin. El mismo esquema no puede aparecer ms de una vez en la va de acceso de funcin. El nmero de esquemas que se puede especificar est limitado por la longitud de la va de acceso de funcin resultante, que no puede exceder de 254 bytes. No es necesario especificar explcitamente el esquema SYSIBM; se supone implcitamente que es el primer esquema si no est incluido en la va de acceso de funcin. INSERT Permite a un programa que se est precompilando o vinculando en un servidor DB2 Enterprise - Extended Edition solicitar que las inserciones de datos se pongan en el almacenamiento intermedio para aumentar el rendimiento. Nota: Esta opcin no est soportada por los servidores DRDA.
552
Command Reference
PRECOMPILE
BUF DEF Especifica que las inserciones de una aplicacin deben ponerse en el almacenamiento intermedio. Especifica que las inserciones de una aplicacin no deben ponerse en el almacenamiento intermedio.
GENERIC serie Soporta la vinculacin de opciones nuevas que estn definidas en la base de datos de destino, pero que no estn soportadas por DRDA. No utilice esta opcin para pasar opciones de vinculacin que estn definidas en BIND o PRECOMPILE. Esta opcin puede mejorar sustancialmente el rendimiento del SQL dinmico. La sintaxis es la siguiente:
generic "opcin1 valor1 opcin2 valor2 ..."
Cada opcin y valor debe estar separado por uno o ms espacios en blanco. Por ejemplo, si la base de datos DRDA de destino es DB2 Universal Database, Versin 8, se podra utilizar:
generic "explsnap all queryopt 3 federated yes"
para vincular cada una de las opciones EXPLSNAP, QUERYOPT y FEDERATED. La longitud mxima de la serie es de 1023 bytes. IMMEDWRITE Indica si se realizarn grabaciones inmediatas para las actualizaciones efectuadas para agrupar conjuntos de pginas o particiones dependientes de agrupaciones de almacenamientos intermedios. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. ISOLATION Determina hasta qu punto un programa vinculado a este paquete puede aislarse del efecto de otros programas en ejecucin. CS NC Especifica estabilidad de cursor como nivel de aislamiento. Ningn compromiso. Especifica que no se debe utilizar el control de compromiso. DB2 no soporta este nivel de aislamiento. Especifica lectura repetible como nivel de aislamiento. Especifica estabilidad de lectura como nivel de aislamiento. La estabilidad de lectura asegura que la ejecucin de las sentencias de SQL del paquete est aislada de otros procesos de aplicacin para filas ledas y cambiadas por la aplicacin.
RR RS
553
PRECOMPILE
UR Especifica lectura no comprometida como nivel de aislamiento.
LANGLEVEL Especifica las normas de SQL que se aplican a la sintaxis y la semntica para el SQL esttico y dinmico en la aplicacin. Esta opcin no est soportada por los servidores DRDA. MIA Seleccione las normas ISO/ANS SQL92 que se indican a continuacin: v Para soportar la comprobacin de errores SQLCODE o SQLSTATE, se debe declarar un SQLCA en el cdigo de aplicacin. v Las series C terminadas en nulo se rellenan con espacios en blanco e incluyen siempre un carcter terminado en nulo, incluso si se produce truncamiento. v La clusula FOR UPDATE es opcional para todas las columnas que se deben actualizar en un UPDATE colocado. v Un UPDATE o DELETE buscado necesita privilegio SELECT en la tabla de objetos de la sentencia UPDATE o DELETE si se hace referencia a una columna de la tabla de objetos en la condicin de bsqueda o en el lado derecho de la clusula de asignacin. v Una funcin de columna que puede resolverse utilizando un ndice (por ejemplo MIN o MAX) tambin comprobar los nulos y devolver el aviso SQLSTATE 01003 si haba algn nulo. v Se devuelve un error cuando se incluye una restriccin de unicidad duplicada en una sentencia CREATE o ALTER TABLE. v Se devuelve un error cuando no se otorga ningn privilegio y el otorgante no tiene privilegios en el objeto (de lo contrario se devuelve un aviso). SAA1 Seleccione las normas comunes de DB2 de IBM siguientes: v Para soportar la comprobacin de errores SQLCODE o SQLSTATE, se debe declarar un SQLCA en el cdigo de aplicacin. v Las series C terminadas en nulo no terminan con un carcter nulo si se produce truncamiento. v La clusula FOR UPDATE es necesaria para todas las columnas que se deben actualizar en un UPDATE colocado. v Un UPDATE o DELETE buscado no necesitar privilegio SELECT en la tabla de objetos de la sentencia UPDATE o
554
Command Reference
PRECOMPILE
DELETE a no ser que una seleccin completa (fullselect) de la sentencia haga referencia a la tabla de objetos. v Una funcin de columna que se puede resolver utilizando un ndice (por ejemplo MIN o MAX) no comprobar los nulos y no se devolver el aviso SQLSTATE 01003. v Se devuelve un aviso y se ignora la restriccin de unicidad duplicada. v Se devuelve un error cuando no se otorga ningn privilegio. SQL92E Define las normas ISO/ANS SQL92 que se indican a continuacin: v Para soportar la comprobacin de valores SQLCODE o SQLSTATE, se pueden declarar las variables con este nombre en la seccin de declaracin de variables del sistema principal (si no se declara ninguna, se supone SQLCODE durante la precompilacin). v Las series C terminadas en nulo se rellenan con espacios en blanco e incluyen siempre un carcter terminado en nulo, incluso si se produce truncamiento. v La clusula FOR UPDATE es opcional para todas las columnas que se deben actualizar en un UPDATE colocado. v Un UPDATE o DELETE buscado necesita privilegio SELECT en la tabla de objetos de la sentencia UPDATE o DELETE si se hace referencia a una columna de la tabla de objetos en la condicin de bsqueda o en el lado derecho de la clusula de asignacin. v Una funcin de columna que puede resolverse utilizando un ndice (por ejemplo MIN o MAX) tambin comprobar los nulos y devolver el aviso SQLSTATE 01003 si haba algn nulo. v Se devuelve un error cuando se incluye una restriccin de unicidad duplicada en una sentencia CREATE o ALTER TABLE. v Se devuelve un error cuando no se otorga ningn privilegio y el otorgante no tiene privilegios en el objeto (de lo contrario se devuelve un aviso). KEEPDYNAMIC Especifica si las sentencias de SQL dinmico han de conservarse despus de los puntos de compromiso. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390.
555
PRECOMPILE
LEVEL seal-coherencia Define el nivel de un mdulo utilizando la seal de coherencia. La seal de coherencia es cualquier valor alfanumrico de una longitud mxima de 8 caracteres. La seal de coherencia del paquete RDB verifica que la aplicacin del peticionario y el paquete de base de datos relacional estn sincronizados. Nota: Esta opcin no se recomienda para el uso general. LONGERROR Indica si las declaraciones de variables de sistema principal largas se tratarn como un error. Por portabilidad, sqlint32 puede utilizarse como una declaracin para una columna INTEGER en cdigo C y C++ precompilado. NO No genera errores para el uso de declaraciones de variables de sistema principal largas. ste es el valor por omisin para sistemas de 32 bits y para sistemas NT de 64 bits donde se pueden utilizar variables de sistema principal largas como declaraciones para las columnas INTEGER. La utilizacin de esta opcin en plataformas UNIX de 64 bits permitir utilizar variables de sistema principal largas como declaraciones para las columnas BIGINT. Genera errores para el uso de declaraciones de variables de sistema principal largas. ste es el valor por omisin para sistemas UNIX de 64 bits.
YES
MESSAGES archivo-mensajes Especifica el destino para los mensajes de aviso, de error y de estado de realizacin. Se crea un archivo de mensajes tanto si la vinculacin es satisfactoria como si no lo es. Si no se especifica un nombre de archivo de mensajes, los mensajes se graban en la salida estndar. Si no se especifica la va de acceso completa al archivo, se utiliza el directorio actual. Si se especifica el nombre de un archivo existente, se graba encima del contenido del archivo. NOLINEMACRO Suprime la generacin de las macros #line en el archivo de salida .c.Es til cuando se utiliza el archivo con herramientas de desarrollo que necesitan informacin de lneas de origen, por ejemplo perfiles, programas de utilidad de referencia cruzada y depuradores. Nota: Esta opcin de precompilacin slo se utiliza para los lenguajes de programacin C/C++. OPTHINT Controla si se utilizan pistas de optimizacin de consultas para SQL
556
Command Reference
PRECOMPILE
esttico. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390. OPTLEVEL Indica si el precompilador C/C++ debe optimizar la inicializacin de los SQLDA internos cuando se utilizan variables de sistema principal en las sentencias de SQL. Dicha optimizacin puede aumentar el rendimiento cuando se utiliza una sola sentencia de SQL (por ejemplo FETCH) en un bucle estrecho. 0 1 Indica al precompilador que no optimice la inicializacin de SQLDA. Indica al precompilador que optimice la inicializacin de SQLDA. Este valor no se deber especificar si la aplicacin utiliza: v variables de sistema principal de puntero, como en el ejemplo siguiente:
exec sql begin declare section; char (*name)[20]; short *id; exec sql end declare section;
v miembros de datos C++ directamente en sentencias de SQL. OUTPUT nombre-archivo Altera temporalmente el nombre por omisin del archivo fuente modificado producido por el compilador. Puede incluir una va de acceso. OS400NAMING Especifica cul es la opcin de denominacin que ha de utilizarse al acceder a datos de DB2 UDB para iSeries. Slo est soportado por DB2 UDB para iSeries. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para iSeries. Tenga en cuenta que, a causa de que las barras inclinadas se utilizan como separadores, un programa de utilidad DB2 puede informar de un error de sintaxis en tiempo de ejecucin para ciertas sentencias de SQL que utilizan el convenio de denominacin de iSeries, aunque el programa de utilidad se pueda haber precompilado o vinculado con la opcin OS400NAMING SYSTEM. Por ejemplo, el Procesador de lnea de mandatos informar de un error de sintaxis en una sentencia CALL de SQL si se utiliza el convenio de denominacin de iSeries, tanto si se ha precompilado o vinculado utilizando la opcin OS400NAMING SYSTEM como si no. OWNER id-autorizacin Designa un identificador de autorizacin de 30 caracteres para el
557
PRECOMPILE
propietario del paquete. El propietario debe tener los privilegios necesarios para ejecutar las sentencias de SQL contenidas en el paquete. Slo un usuario con autorizacin SYSADM o DBADM puede especificar un identificador de autorizacin distinto del ID de usuario. El valor por omisin es el ID de autorizacin primario del proceso de precompilacin/vinculacin. SYSIBM, SYSCAT y SYSSTAT no son valores vlidos para esta opcin. PACKAGE Crea un paquete. Si no se especifica package, bindfile ni syntax, por omisin se crea un paquete en la base de datos. USING nombre-paquete Nombre del paquete que el precompilador debe generar. Si no se entra un nombre, se utiliza el nombre del archivo fuente del programa de aplicacin (menos la extensin y convertido a maysculas). La longitud mxima es de 8 caracteres. PREPROCESSOR mandato-preprocesador Especifica el mandato de preprocesador que el precompilador puede ejecutar antes de procesar sentencias de SQL incorporadas. La serie del mandato de preprocesador (de una longitud mxima de 1024 bytes) debe escribirse entre comillas dobles o simples. Esta opcin permite el uso de macros dentro de la seccin de declaracin. Un mandato de preprocesador vlido es aquel mandato que se puede emitir desde la lnea de mandatos para invocar el preprocesador sin especificar un archivo fuente. Por ejemplo,
xlc -P -DMYMACRO=0
QUALIFIER nombre-calificador Proporciona un calificador implcito de 30 caracteres para los objetos no calificados contenidos en el paquete. El valor por omisin es el ID de autorizacin del propietario, tanto si se ha especificado explcitamente owner como si no se ha especificado. QUERYOPT nivel-optimizacin Indica el nivel deseado de optimizacin para todas las sentencias de SQL estticas contenidas en el paquete. El valor por omisin es 5. Para ver el rango completo de niveles de optimizacin disponibles, vea la sentencia SET CURRENT QUERY OPTIMIZATION en la publicacin SQL Reference. DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. RELEASE Indica si se liberan recursos en cada punto COMMIT o cuando termina la aplicacin. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA.
558
Command Reference
PRECOMPILE
COMMIT Libera recursos en cada punto COMMIT. Se utiliza para sentencias de SQL dinmicas. DEALLOCATE Slo libera recursos cuando termina la aplicacin. SQLCA Slo para aplicaciones FORTRAN. Esta opcin se ignora si se utiliza con otros lenguajes. NONE Especifica que el cdigo fuente modificado no es coherente con la definicin SAA. SAA Especifica que el cdigo fuente modificado es coherente con la definicin SAA.
SQLERROR Indica si se debe crear un paquete o un archivo de vinculacin en el caso de que se encuentre un error. CHECK Especifica que el sistema de destino realiza todas las comprobaciones de sintaxis y de semntica en las sentencias de SQL que se estn vinculando. No se crear un paquete como parte de este proceso. Si, mientras se est realizando la vinculacin, se encuentra un paquete existente con el mismo nombre y la misma versin, el paquete existente no se elimina ni se sustituye aunque se haya especificado action replace. CONTINUE Crea un paquete, incluso si se producen errores al vincular las sentencias de SQL. Aquellas sentencias que no se han podido vincular por razones de autorizacin o existencia pueden vincularse de forma incremental en el tiempo de ejecucin si se especifica tambin VALIDATE RUN. Cualquier intento de ejecutarlas en la ejecucin genera un error (SQLCODE -525, SQLSTATE 51015). NOPACKAGE No se crea un paquete o un archivo de vinculacin si se encuentra un error. REOPT / NOREOPT VARS Especifica si DB2 ha de determinar una va de acceso en tiempo de ejecucin utilizando valores para variables de sistema principal, marcadores de parmetro y registros especiales. Slo est soportado por DB2 para OS/390. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para OS/390.
559
PRECOMPILE
SQLFLAG Identifica e indica las desviaciones de la sintaxis de lenguaje SQL especificadas en esta opcin. Slo se crea un archivo de vinculacin o un paquete si se especifica la opcin bindfile o package, adems de la opcin sqlflag. La comprobacin de sintaxis local slo se realiza si se especifica una de las opciones siguientes: v bindfile v package v sqlerror check v syntax Si no se especifica sqlflag, no se invoca la funcin de sealizacin y el archivo de vinculacin o el paquete no se ve afectado. SQL92E SYNTAX Se comprobarn las sentencias de SQL con la sintaxis y el formato de lenguaje SQL a nivel de entrada ANSI o ISO SQL92 a excepcin de las normas de sintaxis que necesitaran acceso al catlogo de base de datos. Se informar sobre cualquier desviacin en el listado del precompilador. MVSDB2V23 SYNTAX Se comprobarn las sentencias de SQL con la sintaxis de lenguaje SQL de MVS DB2 Versin 2.3. Se informar sobre cualquier desviacin de la sintaxis en el listado del precompilador. MVSDB2V31 SYNTAX Se comprobarn las sentencias de SQL con la sintaxis de lenguaje SQL de MVS DB2 Versin 3.1. Se informar sobre cualquier desviacin de la sintaxis en el listado del precompilador. MVSDB2V41 SYNTAX Se comprobarn las sentencias de SQL con la sintaxis de lenguaje SQL de MVS DB2 Versin 4.1. Se informar sobre cualquier desviacin de la sintaxis en el listado del precompilador. SORTSEQ Especifica cul es la tabla de secuencias de clasificacin que se ha de utilizar en el sistema iSeries. Slo est soportado por DB2 UDB para iSeries. Para ver una lista de los valores de opcin soportados, consulte la documentacin de DB2 para iSeries.
560
Command Reference
PRECOMPILE
SQLRULES Especifica: v Si se deben procesar los CONNECT de tipo 2 de acuerdo con las normas de DB2 o las normas Estndares (STD) basadas en ISO/ANS SQL92. v Cmo puede especificar un usuario o una aplicacin el formato de las columnas de conjuntos de respuestas LOB. DB2 v Permite a la sentencia CONNECT de SQL conmutar la conexin actual a otra conexin (latente) establecida. v El usuario o la aplicacin slo puede especificar el formato de una columna LOB durante la primera peticin de bsqueda. STD v Permite a la sentencia CONNECT de SQL establecer solamente una conexin nueva. Se deber utilizar la sentencia SET CONNECTION de SQL para conmutar a una conexin latente. v El usuario o la aplicacin puede cambiar el formato de una columna LOB con cada peticin de bsqueda. SQLWARN Indica si se devolvern avisos de la compilacin de las sentencias de SQL dinmicas (a travs de PREPARE o EXECUTE IMMEDIATE) o del proceso de descripcin (a travs de PREPARE...INTO o DESCRIBE). DRDA no soporta esta opcin de precompilacin/vinculacin de DB2. NO YES No se devolvern avisos del compilador de SQL. Se devolvern avisos del compilador de SQL.
Nota: SQLCODE +238 es una excepcin. Se devuelve independientemente del valor de la opcin sqlwarn. STRDEL Indica si se utilizar un apstrofo () o comillas dobles (") como delimitador de serie en las sentencias de SQL. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. El servidor DRDA utilizar un valor por omisin definido por el sistema si no se especifica esta opcin. APOSTROPHE Utilizar un apstrofo () como delimitador de serie.
561
PRECOMPILE
QUOTE Utilizar comillas dobles (") como delimitador de serie. SYNCPOINT Especifica el modo en que se van a coordinar las operaciones de compromiso o retrotraccin entre mltiples conexiones de bases de datos. NONE Especifica que no se debe utilizar ningn Gestor de transacciones (TM) para realizar un compromiso de dos fases y no impone ningn actualizador nico, lector mltiple. Se enva un COMMIT a cada base de datos participante. La aplicacin es responsable de la recuperacin si falla alguno de los compromisos. ONEPHASE Especifica que no se debe utilizar ningn TM para realizar un compromiso de dos fases. Se deber utilizar un compromiso de una fase para comprometer el trabajo efectuado por cada base de datos en mltiples transacciones de bases de datos. TWOPHASE Especifica que se necesita el TM para coordinar los compromisos de dos fases entre las bases de datos que soportan este protocolo. SYNTAX Suprime la creacin de un paquete o un archivo de vinculacin durante la precompilacin. Esta opcin puede utilizarse para comprobar la validez del archivo fuente sin modificar o alterar paquetes o archivos de vinculacin existentes. Syntax es sinnimo de sqlerror check. Si se utiliza syntax junto con la opcin package, se ignorar package. TARGET Indica al precompilador que produzca cdigo modificado adaptado a uno de los compiladores soportados de la plataforma actual. IBMCOB En AIX, se genera cdigo para el compilador IBM COBOL Set para AIX. MFCOB Se genera cdigo para el compilador Micro Focus COBOL. ste es el valor por omisin si no se especifica un valor target con el precompilador COBOL en todas las plataformas UNIX y en Windows NT.
562
Command Reference
PRECOMPILE
ANSI_COBOL Se genera cdigo compatible con el estndar ANS X3.23-1985. C Se genera cdigo compatible con los compiladores C soportados por DB2 en la plataforma actual.
CPLUSPLUS Se genera cdigo compatible con los compiladores C++ soportados por DB2 en la plataforma actual. FORTRAN Se genera cdigo compatible con los compiladores FORTRAN soportados por DB2 en la plataforma actual. TEXT etiqueta Descripcin de un paquete. La longitud mxima es de 255 caracteres. El valor por omisin son espacios en blanco. DB2 no soporta esta opcin de precompilacin/vinculacin de DRDA. TRANSFORM GROUP Especifica el nombre de grupo de transformaciones que debern utilizar las sentencias de SQL estticas para intercambiar valores de tipo estructurado definidos por el usuario con programas de sistema principal. Este grupo de transformaciones no se utiliza para las sentencias de SQL dinmicas o para el intercambio de parmetros y resultados con funciones o mtodos externos. Esta opcin no est soportada por los servidores DRDA. nombregrupo Identificador de SQL de una longitud mxima de 18 caracteres. Un nombre de grupo no puede incluir un prefijo de calificador y no puede empezar con el prefijo SYS dado que ste est reservado para uso de la base de datos. En una sentencia de SQL esttica que interacte con variables de sistema principal, el nombre de grupo de transformaciones a utilizar para intercambiar valores de un tipo estructurado es el siguiente: v El nombre de grupo de la opcin de vinculacin TRANSFORM GROUP, si existe v El nombre de grupo de la opcin de precompilacin TRANSFORM GROUP que se ha especificado en el tiempo de precompilacin original, si existe v El grupo DB2_PROGRAM, si existe una transformacin para el tipo proporcionado cuyo nombre de grupo es DB2_PROGRAM v No se utiliza ningn grupo de transformaciones si no existe ninguna de las condiciones anteriores.
563
PRECOMPILE
Son posibles los errores siguientes durante la vinculacin de una sentencia de SQL esttica: v SQLCODE yyy, SQLSTATE xxxxx: Se necesita una transformacin, pero no se ha seleccionado ningn grupo de transformaciones esttico. v SQLCODE yyy, SQLSTATE xxxxx: El grupo de transformaciones seleccionado no incluye una transformacin necesaria (TO SQL para variables de entrada, FROM SQL para variables de salida) para el tipo de datos que se necesita intercambiar. v SQLCODE yyy, SQLSTATE xxxxx: El tipo de resultado de la transformacin FROM SQL no es compatible con el tipo de la variable de salida o el tipo de parmetro de la transformacin TO SQL no es compatible con el tipo de la variable de entrada. En estos mensajes de error, yyyyy se sustituye por el cdigo de error de SQL y xxxxx por el cdigo de estado de SQL. VALIDATE Determina cundo el gestor de bases de datos comprueba los errores de autorizacin y los errores de objeto no encontrado. Se utiliza el ID de autorizacin del propietario del paquete para la comprobacin de validez. BIND La validacin se realiza en el tiempo de precompilacin/vinculacin. Si no existen todos los objetos o no se posee toda la autorizacin, se producen mensajes de error. Si se especifica sqlerror continue, se produce un archivo de vinculacin/paquete a pesar del mensaje de error, pero las sentencias errneas no son ejecutables. RUN Se intenta la validacin en el tiempo de vinculacin. Si existen todos los objetos y se posee toda la autorizacin, no se realiza ninguna comprobacin adicional en el tiempo de ejecucin. Si no existen todos los objetos o no se posee toda la autorizacin en el tiempo de precompilacin/vinculacin, se producen mensajes de aviso y el paquete se vincula satisfactoriamente, independientemente del valor de la opcin sqlerror continue. Sin embargo, en el tiempo de ejecucin se puede volver a realizar la comprobacin de autorizacin y la comprobacin de existencia para las sentencias de SQL que han fallado dichas comprobaciones durante el proceso de precompilacin/vinculacin.
564
Command Reference
PRECOMPILE
VERSION Define el identificador de versin para un paquete. Si no se especifica esta opcin, la versin del paquete ser (serie vaca). id-versin Especifica un identificador de versin que es cualquier valor alfanumrico, $, #, @, _, -, o ., de una longitud mxima de 64 caracteres. AUTO El identificador de versin se generar a partir de la seal de coherencia. Si la seal de coherencia es una indicacin de la hora (lo ser si no se especifica la opcin LEVEL), la indicacin de la hora se convertir a formato de caracteres ISO y se utilizar como identificador de versin. WCHARTYPE Para obtener detalles y conocer las restricciones sobre el uso y la aplicabilidad de wchartype, consulte la publicacin Application Programming Guide. CONVERT Las variables de sistema principal que se declaran que utilizan el tipo base wchar_t se tratarn como si contuvieran datos en formato wchar_t. Puesto que este formato no es directamente compatible con el formato de los datos grficos almacenados en la base de datos (formato DBCS), los datos de entrada de las variables de sistema principal wchar_t se convierten implcitamente a formato DBCS en nombre de la aplicacin, utilizando la funcin ANSI C wcstombs(). De forma similar, los datos DBCS de salida se convierten implcitamente a formato wchar_t, utilizando mbstowcs(), antes de almacenarse en variables de sistema principal. NOCONVERT Las variables de sistema principal que se declaran que utilizan el tipo base wchar_t se tratarn como si contuvieran datos en formato DBCS. ste es el formato utilizado dentro de la base de datos para los datos grficos; sin embargo, es diferente del formato wchar_t nativo implementado en el lenguaje C. La utilizacin de noconvert significa que los datos grficos no sufrirn ninguna conversin entre la aplicacin y la base de datos, lo cual puede mejorar la eficiencia.Sin embargo, la aplicacin es responsable de asegurar que los datos en formato wchar_t no se pasan al gestor de bases de datos. Cuando se utiliza esta opcin, las variables de sistema principal wchar_t no se debern manipular con las funciones
565
PRECOMPILE
de series de caracteres anchos C y no se debern inicializar con literales de caracteres anchos (literales L). Notas de uso: Se produce un archivo fuente modificador, que contiene equivalentes de lenguaje de sistema principal a las sentencias de SQL. Por omisin, se crea un paquete en la base de datos con la que se ha establecido una conexin. El nombre del paquete es el mismo que el nombre de archivo (menos la extensin y convertido a maysculas), hasta un mximo de 8 caracteres. A continuacin de la conexin a una base de datos, PREP se ejecuta bajo la transaccin que se ha iniciado. Entonces PREP emite un COMMIT o un ROLLBACK para terminar la transaccin actual e iniciar otra. La creacin de un paquete con un nombre de esquema que an no existe da como resultado la creacin implcita de dicho esquema. El propietario del esquema es SYSIBM. El privilegio CREATEIN en el esquema se otorga a PUBLIC. Durante la precompilacin, no se toma ninguna instantnea de Explain a no ser que se cree un paquete y se haya especificado explsnap. La instantnea se pone en las tablas Explain del usuario que crea el paquete. De forma similar, la informacin de tablas Explain slo se captura cuando se especifica explain y se crea un paquete. La precompilacin se detiene si se produce un error muy grave o se producen ms de 100 errores. Si se produce un error muy grave, el programa de utilidad deja de precompilar, intenta cerrar todos los archivos y elimina el paquete. Cuando un paquete exhibe un comportamiento de vinculacin, lo siguiente puede ser verdadero: 1. El valor implcito o explcito de la opcin OWNER de BIND se utilizar para realizar la comprobacin de autorizacin de las sentencias de SQL dinmico. 2. El valor implcito o explcito de la opcin QUALIFIER de BIND se utilizar como calificador implcito para realizar la calificacin de objetos no calificados en las sentencias de SQL dinmico. 3. El valor del registro especial CURRENT SCHEMA no tiene ningn efecto sobre la calificacin. En caso de que se haga referencia a varios paquetes durante una sola conexin, todas las sentencias de SQL dinmico preparadas por esos paquetes
566
Command Reference
PRECOMPILE
exhibirn el comportamiento que aparece especificado en la opcin DYNAMICRULES para ese paquete especfico y el entorno en el que se utilicen. Si se ha encontrado que una sentencia de SQL era errnea y se ha especificado la opcin de PRECOMPILE SQLERROR CONTINUE, la sentencia se marcar como no vlida y se deber emitir otro PRECOMPILE a fin de cambiar el estado de la sentencia de SQL. La revinculacin implcita o explcita no cambiar el estado de una sentencia no vlida en un paquete vinculado con VALIDATE RUN. Una sentencia puede cambiar de esttica a vinculacin incremental o de vinculacin incremental a esttica a travs de revinculaciones implcitas y explcitas, en funcin de si existen o no problemas de autorizacin o de existencia de objeto durante la revinculacin. Conceptos relacionados: v Consideraciones sobre autorizacin para SQL dinmico del manual Gua de desarrollo de aplicaciones: Programacin de aplicaciones de cliente v Efectos de DYNAMICRULES en SQL dinmico del manual Gua de desarrollo de aplicaciones: Programacin de aplicaciones de cliente Informacin relacionada: v Mandato BIND en la pgina 222
567
PRUNE HISTORY/LOGFILE Mandato PRUNE HISTORY/LOGFILE

Se utiliza para suprimir entradas del archivo histrico de recuperacin o para suprimir archivos de anotaciones cronolgicas de la va de acceso de archivo de anotaciones cronolgicas activa. La supresin de entradas del archivo histrico de recuperacin puede ser necesaria si el archivo crece excesivamente y el perodo de retencin es largo. La supresin de archivos de anotaciones cronolgicas de la va de acceso del archivo de anotaciones cronolgicas activo puede ser necesaria si se estn archivando manualmente anotaciones cronolgicas (en lugar de mediante un programa de salida de usuario). Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Base de datos Sintaxis del mandato:
PRUNE HISTORY indicfechahora WITH FORCE OPTION LOGFILE PRIOR TO nombre-archivo-anotcron
Parmetros del mandato: HISTORY indicfechahora Identifica un rango de entradas del archivo histrico de recuperacin que se suprimirn. Se puede especificar una indicacin de fecha y hora completa (en el formato aaaammddhhmmss) o un prefijo inicial (mnimo aaaa). Todas las entradas con indicaciones de fecha y hora iguales o menores que la indicacin de fecha y hora proporcionada se suprimirn del archivo histrico de recuperacin. WITH FORCE OPTION Especifica que se podarn las entradas de acuerdo con la indicacin de fecha y hora especificada, incluso si se suprimen del archivo algunas entradas del conjunto de restauracin ms reciente. Un conjunto de restauracin es la copia de seguridad de base de datos completa ms reciente que incluye las restauraciones de dicha imagen
568
Command Reference
PRUNE HISTORY/LOGFILE
de copia de seguridad. Si no se especifica este parmetro, se mantendrn en el histrico todas las entradas realizadas desde la imagen de copia de seguridad en adelante. LOGFILE PRIOR TO nombre-archivo-anotcron Especifica una serie para un nombre de archivo de anotaciones cronolgicas, por ejemplo S0000100.LOG. Se suprimirn todos los archivos de anotaciones cronolgicas anteriores al archivo de anotaciones cronolgicas especificado (sin incluirlo). El parmetro de configuracin de base de datos LOGRETAIN deber establecerse en RECOVERY o CAPTURE. Ejemplos: Para eliminar del archivo histrico de recuperacin todas las entradas para todas las restauraciones, cargas, copias de seguridad de espacios de tabla y copias de seguridad de base de datos completa realizadas antes del 1 de diciembre de 1994 inclusive, entre:
db2 prune history 199412
Nota: 199412 se interpreta como 19941201000000. Notas de uso: La poda de entradas de copia de seguridad del archivo histrico hace que se supriman las copias de seguridad de archivos relacionadas de los servidores DB2 Data Links Manager.
569
PUT ROUTINE Mandato PUT ROUTINE

Utiliza el archivo SQL Archive (SAR) de rutina especificado para definir una rutina en la base de datos. Autorizacin: dbadm Conexin necesaria: Base de datos. Si se ha habilitado la conexin implcita, se establece una conexin con la base de datos por omisin. Sintaxis del mandato:
PUT ROUTINE FROM nombre-archivo
OWNER
nuevo-propietario USE REGISTERS
Parmetros del mandato: FROM nombre-archivo Denomina el archivo en el que se almacena SQL Archive (SAR) de rutina. OWNER nuevo-propietario Especifica un nuevo nombre de autorizacin que se utilizar para la comprobacin de autorizacin de la rutina. El nuevo propietario debe tener los privilegios necesarios para la rutina a definir. Si no se especifica la clusula OWNER, se utiliza el nombre de autorizacin que se ha definido originalmente para la rutina. USE REGISTERS Indica que se utilizan los registros especiales CURRENT SCHEMA y CURRENT PATH para definir la rutina. Si no se especifica esta clusula, los valores para el esquema por omisin y la va de acceso de SQL son los valores que se utilizan cuando se define la rutina. Nota: CURRENT SCHEMA se utiliza como nombre de esquema para los nombres de objeto no calificados de la definicin de rutina (incluido el nombre de la rutina) y CURRENT PATH se utiliza para resolver rutinas no calificadas y tipos de datos en la definicin de rutina.
570
Command Reference
PUT ROUTINE
Ejemplos:
PUT ROUTINE FROM procs/proc1.sar;
Notas de uso: En un esquema determinado slo se puede instalar un procedimiento a la vez. Si una operacin GET ROUTINE o PUT ROUTINE (o su procedimiento correspondiente) no se ejecuta satisfactoriamente, siempre devolver un error (SQLSTATE 38000), acompaado de un texto de diagnstico que proporcionar informacin acerca de la causa de la anomala. Por ejemplo, si el nombre de procedimiento proporcionado en GET ROUTINE no identifica un procedimiento de SQL, se devolver el diagnstico -204, 42704, donde -204 y 42704 son el SQLCODE y el SQLSTATE, respectivamente, que identifican la causa del problema. El SQLCODE y el SQLSTATE de este ejemplo indican que el nombre de procedimiento proporcionado en el mandato GET ROUTINE no est definido.
571
QUERY CLIENT Mandato QUERY CLIENT

Devuelve valores de conexin actuales para un proceso de aplicacin. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
QUERY CLIENT
Parmetros del mandato: Ninguno Ejemplos: A continuacin se muestra un ejemplo de salida de QUERY CLIENT:
Los valores de conexin actuales del proceso de aplicacin son: CONNECT = 1 DISCONNECT = EXPLICIT MAX_NETBIOS_CONNECTIONS = 1 SQLRULES = DB2 SYNCPOINT = ONEPHASE CONNECT_DBPARTITIONNUM = CATALOG_DBPARTITIONNUM ATTACH_DBPARTITIONNUM = -1
Si CONNECT_DBPARTITIONNUM y ATTACH_DBPARTITIONNUM no se establecen utilizando el mandato SET CLIENT, estos parmetros tienen valores idnticos a los de la variable de entorno DB2NODE. Si el valor visualizado del parmetro CONNECT_DBPARTITIONNUM o ATTACH_DBPARTITIONNUM es -1, no se ha establecido el parmetro; es decir, no se ha establecido la variable de entorno DB2NODE o no se ha especificado el parmetro en un mandato SET CLIENT emitido anteriormente. Notas de uso: Los valores de conexin para un proceso de aplicacin pueden consultarse en cualquier momento durante la ejecucin. Informacin relacionada: v Mandato SET CLIENT en la pgina 669
572
Command Reference
QUIESCE Mandato QUIESCE

Fuerza a todos los usuarios a salir de la instancia y la base de datos especificadas y los pone en la modalidad inmovilizada. En la modalidad inmovilizada, los usuarios no pueden conectarse desde fuera del motor de base de datos. Mientras la instancia de base de datos o la base de datos est en la modalidad inmovilizada, puede realizar tareas administrativas en ella. Despus de completar las tareas administrativas, utilice el mandato UNQUIESCE para activar la instancia y la base de datos y permitir que otros usuarios se conecten a la base de datos sin tener que concluir e iniciar de nuevo la base de datos. En esta modalidad, slo los usuarios con autorizacin en esta modalidad restringida tienen permiso para conectarse a la instancia/base de datos. Los usuarios con autorizacin sysadm, sysmaint y sysctrl siempre tienen acceso a una instancia mientras est inmovilizada, y los usuarios con autorizacin sysadm siempre tienen acceso a una base de datos mientras est inmovilizada. mbito: QUIESCE DATABASE nombre-basedatos da como resultado que los objetos de la base de datos nombre-basedatos estn en modalidad inmovilizada. Slo el usuario/grupo permitido y sysadm, sysmaint, dbadm o sysctrl podrn acceder a la base de datos o sus objetos. QUIESCE INSTANCE nombre-instancia quiere decir que la instancia y las bases de datos de la instancia nombre-instancia estarn en modalidad inmovilizada. La instancia ser accesible slo para sysadm, sysmaint y sysctrl y el usuario/grupo permitido. Si una instancia est en modalidad inmovilizada, una base de datos de la instancia no se puede poner en modalidad inmovilizada. Autorizacin: Una de las siguientes: Para inmovilizacin a nivel de base de datos: v sysadm v dbadm Para inmovilizacin a nivel de instancia: v sysadm v sysctrl
573
QUIESCE
FORCE CONNECTIONS QUIESCE DATABASE DB nombre-base-datos IMMEDIATE DEFER
FORCE CONNECTIONS QUIESCE INSTANCE nombre-instancia FOR USER id-usuario FOR GROUP nombre-grupo IMMEDIATE DEFER
Conexin necesaria: Base de datos (La conexin de base de datos no es necesaria para una inmovilizacin de instancia.) Parmetros del mandato: DEFER Espera a las aplicaciones hasta que comprometen la unidad de trabajo actual. Este parmetro no est en funcionamiento en la actualidad. IMMEDIATE No espera a que se comprometan las transacciones, retrotrae las transacciones inmediatamente. FORCE CONNECTIONS Fuerza la desconexin de las conexiones. DATABASEnombre-base-datos Inmoviliza la base de datos nombre-base-datos. Todos los objetos de la base de datos se pondrn en la modalidad inmovilizada. Slo los usuarios especificados de grupos especificados y los usuarios con autorizacin sysadm, sysmaint y sysctrl podrn acceder a la base de datos o a sus objetos. INSTANCE nombre-instancia La instancia nombre-instancia y las bases de datos de la instancia se pondrn en la modalidad inmovilizada. La instancia slo ser accesible para los usuarios con autorizacin sysadm, sysmaint y sysctrl, y para los usuarios especificados en grupos especificados. FOR USER id-usuario Especifica el nombre de un usuario al que se permitir el acceso a la instancia mientras est inmovilizada. FOR GROUP id-grupo Especifica el nombre de un grupo al que se permitir el acceso a la instancia mientras est inmovilizada.
574
Command Reference
QUIESCE
Ejemplos: En el ejemplo siguiente, el comportamiento por omisin es forzar conexiones, de forma que no se necesita indicar explcitamente y se puede eliminar de este ejemplo.
db2 quiesce instance crankarm immediate force connections for user frank
El siguiente ejemplo no requiere que se conecte a la base de datos antes de ejecutar el mandato. El mandato se ejecuta en la modalidad IMMEDIATE.
db2 quiesce db employees force connections
v El primer ejemplo inmovilizar la instancia crankarm, al tiempo que permitir que el usuario frank siga utilizando la base de datos. El segundo ejemplo inmovilizar la base de datos especificada, employees, evitando el acceso a todos los usuarios excepto sysadm, sysmaint y sysctrl. v Este mandato forzar a todos los usuarios a desconectarse de la base de datos o de la instancia si se proporciona la opcin FORCE CONNECTION. FORCE CONNECTION es el comportamiento por omisin; el parmetro est permitido en el mandato por motivos de compatibilidad. v El mandato se sincronizar con FORCE y slo se completar una vez que FORCE se haya completado. Notas de uso: v Si la base de datos est en modalidad de suspensin de E/S, no se permitir ni la inmovilizacin ni la eliminacin de la inmovilizacin. v Despus de QUIESCE INSTANCE, slo los usuarios con autorizacin sysadm, sysmaint y sysctrl o un ID de usuario y un nombre de grupo proporcionados como parmetros del mandato podrn conectarse a la instancia. v Despus de QUIESCE DATABASE, los usuarios con autorizacin sysadm, sysmaint, sysctrl, dbadm y GRANT/REVOKE DataControlLang podrn designar quin se podr conectar. Esta informacin se almacenar de forma permanente en las tablas de catlogo de la base de datos.
575
QUIESCE TABLESPACES FOR TABLE Mandato QUIESCE TABLESPACES FOR TABLE

Inmoviliza espacios de tabla para una tabla. Existen tres modalidades de inmovilizacin vlidas: compartimiento, intencin de actualizacin y exclusiva. Hay tres estados posibles resultantes de la funcin de inmovilizacin: QUIESCED SHARE, QUIESCED UPDATE y QUIESCED EXCLUSIVE. mbito: En un entorno de una sola particin, este mandato inmoviliza todos los espacios de tabla implicados en una operacin de carga en modalidad exclusiva durante el tiempo que dura la operacin de carga. En un entorno de bases de datos particionado, este mandato acta localmente en un nodo. Slo inmoviliza la parte de espacios de tabla que pertenecen al nodo en el que se realiza la operacin de carga. Autorizacin: Una de las siguientes: v v v v v sysadm sysctrl sysmaint dbadm load
Conexin necesaria: Base de datos Sintaxis del mandato:

QUIESCE TABLESPACES FOR TABLE nombretabla esquema.nombretabla SHARE INTENT TO UPDATE EXCLUSIVE RESET
Parmetros del mandato: TABLE nombretabla Especifica el nombre de tabla no calificado. La tabla no puede ser una tabla de catlogos del sistema. esquema.nombretabla Especifica el nombre de tabla calificado. Si no se proporciona
576
Command Reference
QUIESCE TABLESPACES FOR TABLE

esquema, se utilizar CURRENT SCHEMA. La tabla no puede ser una tabla de catlogos del sistema. SHARE Especifica que la inmovilizacin debe ser en modalidad de compartimiento. Cuando se realiza una peticin de compartimiento de inmovilizacin, la transaccin solicita intentar bloqueos de compartimiento para los espacios de tabla y un bloqueo de compartimiento para la tabla. Cuando la transaccin obtiene los bloqueos, el estado de los espacios de tabla cambia a QUIESCED SHARE. El estado slo se otorga al inmovilizador si no hay ningn estado en conflicto mantenido por otros usuarios. El estado de los espacios de tabla, junto con el ID de autorizacin y el ID de agente de base de datos del inmovilizador, se registran en la tabla de espacios de tabla, para que el estado sea permanente. No se puede cambiar la tabla mientras los espacios de tabla para la tabla estn en estado QUIESCED SHARE. Se permiten otras peticiones de modalidad de compartimiento en la tabla y los espacios de tabla. Cuando la transaccin se compromete o se retrotrae, se liberan los bloqueos, pero los espacios de tabla para la tabla permanecen en estado QUIESCED SHARE hasta que se restablece explcitamente el estado. INTENT TO UPDATE Especifica que la inmovilizacin debe ser en modalidad de intento de actualizacin. Cuando se realiza una peticin intento de actualizacin de inmovilizacin, los espacios de tabla se bloquean en modalidad de intento exclusivo (IX) y la tabla se bloquea en modalidad de actualizacin (U). El estado de los espacios de tabla se registra en la tabla de espacios de tabla. EXCLUSIVE Especifica que la inmovilizacin debe estar en modalidad exclusiva. Cuando se realiza una peticin de inmovilizacin exclusiva, la transaccin solicita bloqueos superexclusivos en los espacios de tabla y un bloqueo superexclusivo en la tabla. Cuando la transaccin obtiene los bloqueos, el estado de los espacios de tabla cambia a QUIESCED EXCLUSIVE. El estado de los espacios de tabla, junto con el ID de autorizacin y el ID de agente de base de datos del inmovilizador, se registran en la tabla de espacios de tabla. Dado que los espacios de tabla se mantienen en modalidad superexclusiva, no se permite ningn otro acceso a los espacios de tabla. El usuario que invoca la funcin de inmovilizacin (el inmovilizador) tiene acceso exclusivo a la tabla y a los espacios de tabla.
577

RESET Especifica que el estado de los espacios de tabla debe restablecerse a normal. Ejemplos:
db2 quiesce tablespaces for table staff share db2 quiesce tablespaces for table boss.org intent to update
Notas de uso: Este mandato no se soporta para tablas declaradas temporales. Una inmovilizacin es un bloqueo permanente. Su ventaja consiste en que perdura las anomalas de las transacciones, las anomalas de conexin e incluso las anomalas del sistema (por ejemplo anomala de alimentacin o rearranque). Una inmovilizacin es propiedad de una conexin. Si se pierde la conexin, la inmovilizacin permanece, pero no tiene propietario y se denomina inmovilizacin ficticia. Una inmovilizacin ficticia pasa a ser propiedad de la siguiente conexin que emite el mandato QUIESCE TABLESPACES FOR TABLE para los mismos espacios de tabla o la misma tabla. Por ejemplo, si un paro de alimentacin ha hecho que se interrumpiera una operacin de carga durante la fase de supresin, los espacios de tabla para la tabla cargada quedarn en estado de inmovilizacin exclusiva pendiente de supresin. Al reiniciarse la base de datos, esta inmovilizacin ser una inmovilizacin sin propietario (o ficticia). Para eliminar una inmovilizacin ficticia: 1. Conctese a la base de datos. 2. Utilice el mandato LIST TABLESPACES para determinar qu espacio de tabla est inmovilizado. 3. Vuelva a inmovilizar el espacio de tabla utilizando el estado de inmovilizacin actual. Por ejemplo:
db2 quiesce tablespaces for table mitabla exclusive
Una vez realizada, la nueva conexin es propietaria de la inmovilizacin y se puede reiniciar la operacin de carga. Existe un lmite de cinco inmovilizadores en un espacio de tabla en un momento determinado. Un inmovilizador puede actualizar el estado de un espacio de tabla de un estado menos restrictivo a otro ms restrictivo (por ejemplo, S a U o U a X). Si
578
Command Reference

un usuario solicita un estado ms bajo que uno que ya se mantiene, se vuelve al estado original. Los estados no pueden disminuir de nivel. Informacin relacionada: v Mandato LOAD en la pgina 481
579
QUIT Mandato QUIT

Sale de la modalidad de entrada interactiva del procesador de lnea de mandatos y vuelve al indicador de mandatos del sistema operativo. Si se est utilizando un archivo de proceso por lotes para entrar mandatos en el procesador de lnea de mandatos, se procesan mandatos hasta que se encuentra QUIT, TERMINATE o el fin de archivo. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
QUIT
Parmetros del mandato: Ninguno Notas de uso: QUIT no termina el proceso de fondo del procesador de lnea de mandatos ni interrumpe una conexin de base de datos. CONNECT RESET interrumpe una conexin, pero no termina el proceso de fondo. El mandato TERMINATE realiza ambas acciones. Informacin relacionada: v Mandato TERMINATE en la pgina 691
580
Command Reference
REBIND Mandato REBIND

Permite al usuario volver a crear un paquete almacenado en la base de datos sin necesidad de un archivo de vinculacin. Autorizacin: Una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio ALTERIN en el esquema v Privilegio BIND en el paquete. El ID de autorizacin conectado a la columna BOUNDBY de la tabla de catlogos del sistema SYSCAT.PACKAGES, que es el ID del vinculador ms reciente del paquete, se utiliza como ID de autorizacin de vinculador para la revinculacin y para el esquema por omisin de las referencias de tabla del paquete. Tenga en cuenta que este calificador por omisin puede ser diferente del ID de autorizacin del usuario que ejecuta la peticin de revinculacin. REBIND utilizar las mismas opciones de vinculacin que se han especificado al crear el paquete. Conexin necesaria: Base de datos. Si no existe ninguna conexin de base de datos y si se ha habilitado la conexin implcita, se realiza una conexin a la base de datos por omisin. Sintaxis del mandato:
REBIND PACKAGE RESOLVE ANY CONSERVATIVE nombre-paquete VERSION nombre-versin
Parmetros del mandato: PACKAGE nombre-paquete Nombre calificado o no calificado que indica el paquete que se debe volver a vincular. VERSION nombre-versin La versin especfica del paquete que se va a volver a vincular. Cuando no se especifica la versin, se toma (serie vaca). RESOLVE Especifica si se debe volver a vincular el paquete con o sin semntica
581
REBIND
de vinculacin conservadora. Esto afecta al hecho de que se tengan en cuenta las funciones y los tipos de datos nuevos durante la resolucin de funcin y la resolucin de tipo en las sentencias DML estticas del paquete. DRDA no soporta esta opcin. Los valores vlidos son: ANY Para la resolucin de funciones y tipos se tiene en cuenta cualquiera de las funciones y de los tipos de la va de acceso de SQL. No se utiliza semntica de vinculacin conservadora. ste es el valor por omisin.
CONSERVATIVE Para la resolucin de funciones y tipos slo se tienen en cuenta las funciones y los tipos de la va de acceso de SQL que se han definido antes de la ltima indicacin de fecha y hora explcita de vinculacin. Se utiliza semntica de vinculacin conservadora. Esta opcin no est soportada para un paquete no operativo. Notas de uso: REBIND no compromete automticamente la transaccin a continuacin de un revinculacin satisfactoria. El usuario debe comprometer la transaccin explcitamente. Esto permite realizar un anlisis que ocurrira si, en el que el usuario actualiza determinadas estadsticas y entonces intenta volver a vincular el paquete para ver qu cambios se han producido. Tambin permite mltiples revinculaciones dentro de una unidad de trabajo. Nota: El mandato REBIND comprometer la transaccin si se ha habilitado el compromiso automtico. Este mandato: v Proporciona un modo rpido para volver a crear un paquete. Esto permite al usuario aprovechar un cambio en el sistema sin necesidad del archivo de vinculacin original. Por ejemplo, si es probable que una sentencia de SQL determinada pueda aprovechar un ndice recin creado, se puede utilizar el mandato REBIND para volver a crear el paquete. REBIND tambin se puede utilizar para volver a crear paquetes despus de haber ejecutado el mandato RUNSTATS, aprovechando as las nuevas estadsticas. v Proporciona un mtodo para volver a crear paquetes no operativos. Los paquetes no operativos deben volverse a vincular explcitamente invocando el programa de utilidad de vinculacin o el programa de utilidad de revinculacin. Un paquete se marcar como no operativo (la columna VALID del catlogo de sistema SYSCAT.PACKAGES se establecer en X) si se elimina una instancia de funcin de la que depende el paquete. v Proporciona a los usuarios control sobre la revinculacin de paquetes no vlidos. El gestor de bases de datos volver a vincular automticamente (o
582
Command Reference
REBIND
implcitamente) los paquetes no vlidos cuando stos se ejecuten. Esto puede producir un retardo considerable en la ejecucin de la primera peticin SQL del paquete no vlido. Puede ser deseable volver a vincular explcitamente los paquetes no vlidos, en lugar de dejar que el sistema los los vuelva a vincular automticamente, a fin de eliminar el retardo inicial y de evitar mensajes de error de SQL inesperados que pueden devolverse en el caso de que falle la revinculacin implcita. Por ejemplo, despus de la migracin, el proceso de migracin de DB2 Versin 8 invalidar todos los paquetes almacenados en la base de datos. Dado que esto puede incluir un gran nmero de paquetes, puede ser deseable volver a vincular explcitamente todos los paquetes no vlidos a la vez. Esta revinculacin explcita puede llevarse a cabo utilizando BIND, REBIND o la herramienta db2rbind. Si hay varias versiones de un paquete (muchas versiones con el mismo nombre de paquete y creador), slo se puede volver a vincular una versin al mismo tiempo. Si no se especifica en la opcin VERSION, la versin de paquete toma por omisin . Aunque haya slo un paquete con un nombre que coincida, no se volver a vincular a menos que su versin coincida con la especificada o el valor por omisin. La eleccin de utilizar BIND o REBIND para volver a vincular explcitamente un paquete depender de las circunstancias. Se recomienda utilizar REBIND siempre que la situacin no requiera especficamente el uso de BIND, porque el rendimiento de REBIND es significativamente mejor que el de BIND. Sin embargo, BIND debe utilizarse: v Cuando se hayan producido modificaciones en el programa (por ejemplo, cuando se hayan aadido o suprimido sentencias de SQL o cuando el paquete no coincida con el ejecutable para el programa). v Cuando el usuario desee modificar cualquiera de las opciones de vinculacin como parte de la revinculacin. REBIND no soporta ninguna opcin de vinculacin. Por ejemplo, si el usuario desea que se le otorguen privilegios en el paquete como parte del proceso de vinculacin, se deber utilizar BIND, dado que tiene una opcin grant. v Cuando el paquete no existe actualmente en la base de datos. v Cuando se desee la deteccin de todos los errores de vinculacin.REBIND slo devuelve el primer error que detecta, mientras que el mandato BIND devuelve los 100 primeros errores que se producen durante la vinculacin. DB2 Connect soporta REBIND. Si se ejecuta REBIND en un paquete que est utilizando otro usuario, la revinculacin no se producir hasta que finalice la unidad de trabajo lgica
583
REBIND
del otro usuario, porque durante la revinculacin se mantiene un bloqueo exclusivo en el registro del paquete de la tabla de catlogos del sistema SYSCAT.PACKAGES. Cuando se ejecuta REBIND, el gestor de bases de datos vuelve a crear el paquete a partir de las sentencias de SQL almacenadas en la tabla de catlogos del sistema SYSCAT.STATEMENTS. Si REBIND encuentra un error, el proceso se detiene y se devuelve un mensaje de error. REBIND volver a explicar paquetes que se han creado con la opcin de vinculacin explsnap establecida en YES o ALL (indicado en la columna EXPLAIN_SNAPSHOT de la entrada de tabla de catlogo SYSCAT.PACKAGES para el paquete) o con la opcin de vinculacin explain establecida en YES o ALL (indicado en la columna EXPLAIN_MODE de la entrada de tabla de catlogo SYSCAT.PACKAGES para el paquete). Las tablas Explain utilizadas son las del solicitante de REBIND, no del vinculador original. Si se ha encontrado que una sentencia de SQL era errnea y se ha especificado la opcin SQLERROR CONTINUE de BIND, se marcar la sentencia como no vlida aunque se haya corregido el problema. REBIND no cambiar el estado de una sentencia no vlida. En un paquete vinculado con VALIDATE RUN, una sentencia puede cambiar de vinculacin esttica a incremental o de vinculacin incremental a esttica a travs de un REBIND, en funcin de si existen o no problemas de autorizacin o de existencia de objetos durante la operacin REBIND. Informacin relacionada: v Mandato BIND en la pgina 222 v Mandato RUNSTATS en la pgina 659 v db2rbind -Mandato Volver a vincular todos los paquetes en la pgina 144
584
Command Reference
RECONCILE Mandato RECONCILE

Valida las referencias a archivos para los datos DATALINK de una tabla. Las filas para las que no se pueden establecer las referencias a archivos se copian en la tabla de excepciones (si se ha especificado) y se modifican en la tabla de entrada. Reconcile produce un archivo de mensajes (reconcil.msg) en la va de acceso de instancia en los sistemas basados en UNIX y en la va de acceso de instalacin en las plataformas Windows. Este archivo contendr los mensajes de aviso y de error que se generen durante la validacin de la tabla de excepciones. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm v Privilegio CONTROL en la tabla. Conexin necesaria: Base de datos Sintaxis del mandato:
RECONCILE nombre-tabla DLREPORT nombre-archivo
FOR EXCEPTION nombre-tabla
Parmetros del mandato: RECONCILE nombre-tabla Especifica la tabla en la que debe efectuarse la reconciliacin. Se puede especificar un alias o el nombre de tabla totalmente calificado o no calificado. Un nombre de tabla calificado tiene el formato esquema.nombretabla. Si se especifica un nombre de tabla no calificado, se calificar la tabla con el ID de autorizacin actual. DLREPORT nombre-archivo Especifica el archivo que contendr informacin acerca de los archivos desenlazados durante la reconciliacin. El nombre debe estar totalmente calificado (por ejemplo, /u/johnh/report). El programa de
585
RECONCILE
utilidad de reconciliacin aade una extensin .ulk al nombre de archivo especificado (por ejemplo, report.ulk). Cuando no se proporciona ninguna tabla con la clusula FOR EXCEPTION, se aade una extensin de archivo .exp al archivo de informe de excepciones. FOR EXCEPTION nombre-tabla Especifica la tabla de excepciones en la que deben copiarse las filas que encuentran anomalas de enlace para los valores DATALINK. Si no se especifica ningn tabla, se genera un archivo de informe de excepciones en el directorio especificado en la opcin DLREPORT. Ejemplos: El mandato siguiente reconcilia la tabla DEPT y graba excepciones en la tabla de excepciones EXCPTAB, creada por el usuario. La informacin sobre los archivos que se han desenlazado durante la reconciliacin se graba en el archivo report.ulk, que se crea en el directorio /u/johnh. Si no se hubiera especificado FOR EXCEPTION excptab, la informacin de excepciones se hubiera grabado en el archivo report.exp, creado en el directorio /u/johnh.
db2 reconcile dept dlreport /u/johnh/report for exception excptab
Notas de uso: Durante la reconciliacin, se realizan intentos de enlazar archivos que existen de acuerdo con los datos de la tabla, pero que no existen de acuerdo con los metadatos del gestor de archivos Data Links, si no existe ningn otro conflicto. Un DB2 Data Links Manager necesario es el que tiene un valor DATALINK en la tabla. Reconcile tolera la no disponibilidad de un DB2 Data Links Manager necesario as como otros DB2 Data Links Managers configurados para la base de datos pero que no forman parte de los datos de la tabla. La reconciliacin se realiza con respecto a todos los datos DATALINK de la tabla. Si no se pueden volver a establecer referencias de archivo, se insertan las filas anmalas en la tabla de excepciones (si se ha especificado). Estas filas no se suprimen de la tabla de entrada. Para asegurar la integridad de referencia de archivos, los valores DATALINK anmalos se anulan. Si la columna est definida como no anulable, los valores DATALINK se sustituyen por un URL de longitud cero. Si un archivo se enlaza bajo una columna DATALINK definida con WRITE PERMISSION ADMIN y modificada pero todava no comprometida (es decir, el archivo est todava en estado de actualizacin en proceso), el proceso de reconciliacin renombra el archivo modificado como un nombre de archivo de
586
Command Reference
RECONCILE
sufijo .mod. Tambin elimina el archivo del estado de actualizacin en proceso. Si la columna DATALINK se define con RECOVERY YES, se restaura la versin de archivado anterior. Si no se especifica una tabla de excepciones, el nombre de sistema principal, el nombre de archivo, el ID de columna y el cdigo de razn para cada valor de la columna DATALINK para el que no se han podido volver a establecer referencias de archivo se copian a un archivo de informe de excepciones (<nombrearchivo>.exp). Si la referencia de archivo no se ha podido volver a establecer debido a que DB2 Data Links Manager no est disponible o se ha eliminado de la base de datos mediante el mandato DROP DATALINKS MANAGER, el nombre de archivo del que se informa en el archivo de informe de excepciones no es el nombre de archivo completo. Faltar el prefijo. Por ejemplo, si el valor DATALINK original era http://host.com/dlfs/x/y/a.b, el valor del que se informa en la tabla de excepciones ser http://host.com/x/y/a.b. El nombre de prefijo dlfs no se incluir. Si la columna DATALINK se define con RECOVERY YES, se restaura la versin de archivado anterior. Al final del proceso de reconciliacin, la tabla sale del estado de pendiente de reconciliacin de datalink (DRP) slo si el proceso de reconciliacin se ha completado en todos los DB2 Data Links Managers necesarios. Si el proceso de reconciliacin est pendiente en cualquiera de los DB2 Data Links Managers necesarios (porque no estaban disponibles), la tabla permanecer, o se situar, en estado DRP. Si, por alguna razn, se ha producido una excepcin en uno de los Data Links Managers afectados de tal manera que la reconciliacin no se haya podido completar satisfactoriamente, la tabla tambin se puede poner en estado DRNP, para el que se necesitar una intervencin manual antes de que se pueda restaurar la integridad referencial completa para esa tabla. La tabla de excepciones, si se especifica, se deber crear antes de que se ejecute el programa de utilidad de reconciliacin. La tabla de excepciones utilizada con el programa de utilidad de reconciliacin es idntica a la tabla de excepciones utilizada por el programa de utilidad de carga. La tabla de excepciones imita la definicin de la tabla que se est reconciliando. Puede tener una o dos columnas opcionales a continuacin de las columnas de datos. La primera columna opcional es la columna TIMESTAMP. sta contendr la indicacin de fecha y hora del inicio de la operacin de reconciliacin. La segunda columna opcional deber ser de tipo CLOB (32 KB o mayor). sta contendr los ID de las columnas con errores de enlace as como las razones de dichas anomalas. Las columnas DATALINK de la tabla de excepciones debern especificar NO LINK CONTROL. Esto
587
RECONCILE
asegura que no se enlace un archivo cuando se inserta una fila (con una columna DATALINK) y que no se genere una seal de acceso cuando se seleccionan filas de la tabla de excepciones. La informacin de la columna MESSAGE se organiza de acuerdo con la estructura siguiente:
588
Command Reference
RECONCILE
----------------------------------------------------------------Nmero campo Contenido Tamao Comentarios ----------------------------------------------------------------1 Nmero de violaciones 5 caracteres Justificado por la rellenado con 0 ----------------------------------------------------------------2 Tipo de violacin 1 carcter L - violacin de DATALINK ----------------------------------------------------------------3 Long. de violacin 5 caracteres Justificado por la rellenado con 0 ----------------------------------------------------------------4 Nmero de columnas 4 caracteres Justificado por la DATALINK anmalas rellenado con 0 ----------------------------------------------------------------5 Nm. columna DATALINK 4 caracteres Justificado por la de la primera columna rellenado con 0 anmala ----------------------------------------------------------------6 Razn de la violacin 5 caracteres Justificado por la rellenado con 0 ----------------------------------------------------------------Repetir campos 5 y 6 para cada columna anmala -----------------------------------------------------------------
derecha
derecha derecha derecha
derecha
A continuacin se proporciona una lista de posibles violaciones:

00001-DB2 Data Links Manager no ha podido encontrar el archivo. 00002-El archivo ya est enlazado. 00003-Archivo en estado modificado. 00004-Nombre de prefijo no registrado. 00005-No se ha podido recuperar el archivo. 00006-Falta entrada de archivo. Esto suceder para RECOVERY NO, READ PERMISSION FS, WRITE PERMISSION FS DATALINK Utilice "update" para volver a enlazar el archivo. 00007-El archivo est en estado desenlazado. 00008-Archivo restaurado pero el archivo modificado se ha copiado en <nombrearchivo>.MOD 00009-El archivo ya est enlazado a otra tabla. 00010-DB2 Data Links Manager referido por el valor DATALINK se ha eliminado de la base de datos utilizando el mandato DROP DATALINKS MANAGER. 00999-No se ha podido enlazar el archivo. Ejemplo: 00001L000220002000400002000500001 00001 - Especifica que el nmero de violaciones es 1. L - Especifica que el tipo de violacin es violacin de DATALINK. 00022 - Especifica que la longitud de la violacin es de 12 bytes.
589
RECONCILE
0002 - Especifica que hay 2 columnas en la fila que han encontrado anomalas de enlace. 0004,00002 0005,00001 - Especifica el ID de columna y la razn de la violacin.
Si existe la columna de mensaje, la columna de indicacin de fecha y hora tambin tiene que existir. Conceptos relacionados: v Failure and recovery overview del manual DB2 Data Links Manager Administration Guide and Reference
590
Command Reference
REDISTRIBUTE DATABASE PARTITION GROUP Mandato REDISTRIBUTE DATABASE PARTITION GROUP

Redistribuye datos en las particiones de base de datos de un grupo de particiones de base de datos. Se puede especificar la distribucin actual de datos, tanto si es uniforme como si est desviada. El algoritmo de redistribucin selecciona las particiones que se deben mover basndose en la distribucin actual de datos. Este mandato slo se puede emitir desde la particin de base de datos de catlogo. Utilice el mandato LIST DATABASE DIRECTORY para determinar qu particin de base de datos es la particin de base de datos de catlogo para cada base de datos. mbito: Este mandato afecta a todas las particiones de base de datos del grupo de particiones de base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl v dbadm Sintaxis del mandato:
REDISTRIBUTE DATABASE PARTITION GROUP grupo de particiones de base de datos UNIFORM USING DISTFILE archivodist USING TARGETMAP mapadestino CONTINUE ROLLBACK
Parmetros del mandato: DATABASE PARTITION GROUP grupo de particiones de base de datos Nombre del grupo de particiones de base de datos. Este nombre de una sola parte identifica un grupo de particiones de base de datos descrito en la tabla de catlogo SYSCAT.DBPARTITIONGROUPS. El grupo de particiones de base de datos no puede estar sometido actualmente a una redistribucin. Nota: Las tablas de los grupos de particiones de base de datos IBMCATGROUP y IBMTEMPGROUP no se pueden redistribuir.
591
REDISTRIBUTE DATABASE PARTITION GROUP

UNIFORM Especifica que los datos se distribuyen uniformemente entre las particiones hash (es decir, se supone que cada particin hash tiene el mismo nmero de filas), pero no se correlaciona el mismo nmero de particiones hash con cada particin de base de datos. Despus de la redistribucin, todas las particiones de base de datos del grupo de particiones de base de datos tienen aproximadamente el mismo nmero de particiones hash. USING DISTFILE archivodist Si se desva la distribucin de los valores clave de particionamiento, utilice esta opcin para obtener una redistribucin uniforme de los datos entre las particiones de base de datos de un grupo de particiones de base de datos. Utilice el archivodist para indicar la distribucin actual de los datos entre las 4.096 particiones hash. Utilice cuentas de filas, volmenes de bytes o cualquier otra medida para indicar la cantidad de datos representados por cada particin hash. El programa de utilidad lee el valor entero asociado con una particin como el valor relativo de dicha particin. Cuando se especifica un archivodist, el programa de utilidad genera una correlacin de particionamiento de destino que utiliza para redistribuir los datos entre las particiones de base de datos del grupo de particiones de base de datos tan uniformemente como sea posible. Despus de la redistribucin, el valor relativo de cada particin de base de datos del grupo de particiones de base de datos es aproximadamente el mismo (el valor relativo de una particin de base de datos es la suma de los valores relativos de todas las particiones que se correlacionan con dicha particin de base de datos). Por ejemplo, el archivo de distribucin de entrada puede contener entradas como las siguientes:
10223 1345 112000 0 100 ...
En el ejemplo, la particin hash 2 tiene un valor relativo de 112.000 y la particin 3 (con un valor relativo de 0) no tiene correlacin de datos con ella en absoluto. El archivodist debe contener 4.096 valores enteros positivos en formato de carcter. La suma de los valores debe ser menor que o igual a 4.294.967.295.
592
Command Reference

Si no se especifica la va de acceso para archivodist, se utilizar el directorio actual. USING TARGETMAP mapadestino El archivo especificado en mapadestino se utiliza como mapa de particionamiento de destino. La redistribucin de datos se realiza de acuerdo con este archivo. Si no se especifica la va de acceso, se utiliza el directorio actual. Si una particin de base de datos incluida en la correlacin de destino no est en el grupo de particiones de base de datos, se devolver un error. Emita ALTER DATABASE PARTITION GROUP ADD DBPARTITIONNUM antes de ejecutar REDISTRIBUTE DATABASE PARTITION GROUP. Si una particin de base de datos excluida de la correlacin de destino est en el grupo de particiones de base de datos, esa particin de base de datos no se incluir en el particionamiento. Una particin de base de datos semejante se puede eliminar utilizando ALTER DATABASE PARTITION GROUP DROP DBPARTITIONNUM antes o despus de REDISTRIBUTE DATABASE PARTITION GROUP. CONTINUE Contina una operacin REDISTRIBUTE DATABASE PARTITION GROUP que ha fallado anteriormente. Si no se ha producido ninguna, se devuelve un error. ROLLBACK Retrotrae una operacin REDISTRIBUTE DATABASE PARTITION GROUP que ha fallado anteriormente. Si no se ha producido ninguna, se devuelve un error. Notas de uso: Cuando se realiza una operacin de redistribucin, se graba un archivo de mensajes en: v El directorio /sqllib/redist en los sistemas basados en UNIX, utilizando el formato siguiente para los subdirectorios y el nombre de archivo: nombre-basedatos.nombre-grupo-particiones-basedatos.indicacinhora. v El directorio \sqllib\redist\ en los sistemas operativos Windows, utilizando el siguiente formato para los subdirectorios y el nombre de archivo: nombre-basedatos\ocho-primeros-caracteres-de-nombre-grupo-particionesbasedatos\fecha\hora. El valor de indicacin de fecha y hora es la hora en la que se ha emitido el mandato.
593

Este programa de utilidad realiza operaciones COMMIT intermitentes durante el proceso. Utilice la sentencia ALTER DATABASE PARTITION GROUP para aadir particiones de base de datos a un grupo de particiones de base de datos. Esta sentencia permite que se definan los contenedores para los espacios de tabla asociados al grupo de particiones de base de datos. Nota: La sintaxis de DB2 Parallel Edition para AIX Versin 1, con las opciones ADD DBPARTITIONNUM y DROP DBPARITITIONNUM, est soportada para usuarios con autorizacin sysadm o sysctrl. Para ADD DBPARTITIONNUM, se crean contenedores iguales que los contenedores del nmero de nodo ms bajo de los nodos existentes dentro del grupo de particiones de base de datos. Todos los paquetes que tienen una dependencia en una tabla que ha sido sometida a una redistribucin se invalidan. Se recomienda volver a vincular explcitamente dichos paquetes despus de que se haya completado la operacin de redistribucin de grupo de particiones de base de datos. La revinculacin explcita elimina el retardo inicial en la ejecucin de la primera peticin SQL para el paquete no vlido. El archivo de mensajes de redistribucin contiene una lista de todas las tablas que han sido sometidas a redistribucin. Tambin se recomienda actualizar las estadsticas emitiendo RUNSTATS despus de que se haya completado la operacin de redistribuir el grupo de particiones de base de datos. Los grupos de particiones de base de datos que contienen tablas de resumen reproducidas o tablas definidas con DATA CAPTURE CHANGES no se pueden redistribuir. La redistribucin no est permitida si existen espacios de tabla temporales de usuarios con tablas temporales declaradas existentes en el grupo de particiones de base de datos. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODEGROUP puede sustituirse por DATABASE PARTITION GROUP. Informacin relacionada: v Mandato LIST DATABASE DIRECTORY en la pgina 440 v Mandato RUNSTATS en la pgina 659
594
Command Reference

v Mandato REBIND en la pgina 581
595
REFRESH LDAP Mandato REFRESH LDAP

Renueva la antememoria en una mquina local con informacin actualizada cuando se ha cambiado la informacin en LDAP (Lightweight Directory Access Protocol). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
REFRESH LDAP CLI CFG DB DIR NODE DIR
Parmetros del mandato: CLI CFG Especifica que se debe renovar la configuracin de CLI. Nota: Este parmetro no se soporta en AIX y Solaris. DB DIR Especifica que se debe renovar el directorio de bases de datos. NODE DIR Especifica que se debe renovar el directorio de nodos. Notas de uso: Si el objeto en LDAP se elimina durante la renovacin, tambin se eliminar la entrada de LDAP correspondiente de la mquina local. Si se cambia la informacin de LDAP, la entrada de LDAP correspondiente se modificar como corresponda. Si se actualiza manualmente el archivo DB2CLI.INI, se deber ejecutar el mandato REFRESH LDAP CLI CFG para actualizar la antememoria para el usuario actual. Los mandatos REFRESH LDAP DB DIR y REFRESH LDAP NODE DIR eliminan las entradas de nodo o de base de datos LDAP encontradas en los directorios de nodos o de bases de datos locales. Las entradas de nodos o de base de datos se aadirn otra vez a los directorios de nodos o bases de datos
596
Command Reference
REFRESH LDAP
locales cuando el usuario se conecte a una base de datos o se conecte a una instancia encontrada en LDAP y DB2LDAPCACHE no se haya establecido o se haya establecido en YES.
597
REGISTER Mandato REGISTER

Registra el servidor DB2 en el servidor de directorios de red. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
REGISTER DB2 SERVER IN LDAP vaacceso
LDAP vaacceso:
LDAP AS PROTOCOL nombrenodo TCPIP HOSTNAME NETBIOS NNAME APPN vaacceso REMOTE sistema nombre-n nombresistpral SVCENAME nombservicio SECURITY SOCKS NPIPE
INSTANCE
instancia NODETYPE
SERVER MPP DCS
OSTYPE
tiposistop
WITH
comentarios
USER
APPN vaacceso:
APPN NETWORK id_red PARTNERLU lu_asociada MODE modalidad
TPNAME
nombre_pt
SECURITY
NONE SAME PROGRAM
LANADDRESS
direcc_lan
CHGPWDLU
lu_cambio_contrasea
Parmetros del mandato: IN Especifica el servidor de directorios de red en el que se debe registrar el servidor DB2. El valor vlido es: LDAP para un servidor de directorios LDAP (Lightweight Directory Access Protocol).
598
Command Reference
REGISTER
AS nombrenodo Especifique un nombre corto para representar el servidor DB2 en LDAP. Se catalogar una entrada de nodo en LDAP utilizando este nombre de nodo. El cliente puede conectarse al servidor utilizando este nombre de nodo. El protocolo asociado con esta entrada de nodo LDAP se especifica mediante el parmetro PROTOCOL. PROTOCOL Especifica el tipo de protocolo asociado con la entrada de nodo LDAP. Dado que el servidor de bases de datos puede soportar ms de un tipo de protocolo, este valor especifica el tipo de protocolo utilizado por las aplicaciones cliente. El servidor DB2 debe registrarse una vez por cada protocolo. Los valores vlidos son: TCPIP, NETBIOS, APPN y NPIPE. Especifique el ltimo para utilizar el rea de interconexin con nombre de Windows. Este tipo de protocolo slo lo soportan los servidores DB2 que se ejecutan en los sistemas operativos Windows. Nota: NETBIOS y NPIPE no se soportan en los sistemas operativos AIX y Solaris, sin embargo se pueden registrar estos protocolos para un servidor remoto utilizando un sistema operativo como Windows NT. HOSTNAME nombresistpral Especifica el nombre de sistema principal TCP/IP (o la direccin IP). SVCENAME nombservicio Especifica el nombre de servicio o el nmero de puerto TCP/IP. SECURITY SOCKS Especifica que se debe utilizar la seguridad de socket TCP/IP. NNAME nombre-n Especifica el nombre de estacin de trabajo NetBIOS. NETWORK id_red Especifica el ID de red APPN. PARTNERLU lu_asociada Especifica el nombre de LU APPN asociada para la mquina servidor DB2. MODE modalidad Especifica el nombre de modalidad APPN. TPNAME nombrept Especifica el nombre de programa de transacciones APPN. El valor por omisin es DB2DRDA. SECURITY Especifica el nivel de seguridad APPN. Los valores vlidos son:
599
REGISTER
NONE Especifica que no se debe incluir ninguna informacin de seguridad en la peticin de asignacin enviada al servidor. ste es el tipo de seguridad por omisin para el servidor DB2 UDB. SAME Especifica que se debe incluir un nombre de usuario en la peticin de asignacin enviada al servidor, junto con un indicador de que el nombre del usuario ya se ha verificado. El servidor debe estar configurado para aceptar seguridad que ya se ha verificado. PROGRAM Especifica que se deben incluir un nombre de usuario y una contrasea en la peticin de asignacin enviada al servidor. ste es el tipo de seguridad por omisin para servidores de bases de datos de sistema principal como DB2 para OS/390 o z/OS, o DB2 para iSeries. LANADDRESS direccin_lan Especifica la direccin de adaptador de red APPN. CHGPWDLU lu_cambio_contrasea Especifica el nombre de la LU asociada que se debe utilizar al cambiar la contrasea para un servidor de bases de datos de sistema principal. REMOTE sistema Especifica el nombre de sistema de la mquina en la que reside el servidor DB2. Especifique este parmetro slo si est registrando un servidor DB2 remoto en LDAP. El valor debe ser el mismo que el especificado al aadir la mquina servidor a LDAP. Para los sistemas operativos Windows, ste es el nombre de sistema. Para sistemas basados en UNIX, ste es el nombre de sistema principal TCP/IP. INSTANCE instancia Especifica el nombre de instancia del servidor DB2. Se debe especificar el nombre de instancia para una instancia remota (es decir, cuando se ha especificado un valor para el parmetro REMOTE). NODETYPE Especifica el tipo de nodo para el servidor de bases de datos. Los valores vlidos son: SERVER Especifique el tipo de nodo SERVER para un servidor DB2 UDB Enterprise Edition. ste es el valor por omisin. MPP DCS Especifique el tipo de nodo MPP para un servidor DB2 UDB Enterprise Edition - Extended (base de datos particionada). Especifique el tipo de nodo DCS al registrar un servidor de
600
Command Reference
REGISTER
base de datos de sistema principal; esto indica al cliente o a la pasarela que utilice DRDA como protocolo de base de datos. OSTYPE tiposistop Especifica el tipo de sistema operativo de la mquina servidor. Los valores vlidos son: AIX, NT, HPUX, SUN, MVS, OS400, VM, VSE, SNI, SCO y LINUX. Si no se especifica un tipo de sistema operativo, se utilizar el tipo de sistema operativo local para un servidor local y no se utilizar ningn tipo de sistema operativo para un servidor remoto. WITH comentarios Describe el servidor DB2. Se puede entrar cualquier comentario que ayude a describir el servidor registrado en el directorio de red. La longitud mxima es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. Notas de uso: Registre el servidor DB2 una vez para cada protocolo que el servidor soporte. Por ejemplo, si el servidor DB2 soporta NeBIOS y TCP/IP, se deber invocar el mandato REGISTER dos veces:
db2 register db2 server in ldap as tcpnode protocol tcpip db2 register db2 server in ldap as nbnode protocol netbios
El mandato REGISTER deber emitirse una vez para cada instancia de servidor DB2 para publicar el servidor en el servidor de directorios. Si se reconfiguran los campos de parmetros de comunicaciones o se modifica la direccin de red del servidor, actualice el servidor DB2 en el servidor de directorios de red. Para actualizar el servidor DB2 en LDAP, utilice el mandato UPDATE LDAP NODE despus de que se hayan efectuado los cambios. Si se especifica cualquier parmetro de configuracin de protocolo al registrar un servidor DB2 localmente, dicho parmetro prevalecer sobre el valor especificado en el archivo de configuracin de gestor de bases de datos. Para APPN, slo se encuentra el TPNAME en el archivo de configuracin del gestor de bases de datos. Para registrar APPN correctamente, se deben especificar valores para los parmetros obligatorios siguientes: NETWORK, PARTNERLU, MODE, TPNAME y SECURITY. Tambin se pueden especificar valores para los parmetros opcionales siguientes: LANADDRESS y CHGPWDLU.
601
REGISTER
Si se utiliza el mandato REGISTER para registrar una instancia DB2 local en LDAP y se especifica NODETYPE y/o OSTYPE, stos se sustituirn por los valores recuperados del sistema local. Si se utiliza el mandato REGISTER para registrar una instancia DB2 remota en LDAP y no se especifica NODETYPE ni/o OSTYPE, se utilizar el valor por omisin de SERVER y Unknown, respectivamente. Si se utiliza el mandato REGISTER para registrar un servidor DB2 remoto en LDAP, se debern especificar el nombre de sistema y el nombre de instancia del servidor remoto junto con el protocolo de comunicaciones para el servidor remoto. Al registrar un servidor de bases de datos de sistema principal, se deber especificar un valor de DCS para el parmetro NODETYPE. Informacin relacionada: v Mandato DEREGISTER en la pgina 300 v Mandato UPDATE LDAP NODE en la pgina 727
602
Command Reference
REORG INDEXES/TABLE Mandato REORG INDEXES/TABLE

Reorganiza un ndice o una tabla. La opcin de ndice reorganiza todos los ndices definidos en una tabla reconstruyendo los datos de ndice en pginas no fragmentadas y fsicamente continuas. Si especifica la opcin CLEANUP ONLY de la opcin de ndice, la limpieza se realizar sin reconstruir los ndices. Este mandato no se puede utilizar para los ndices en tablas temporales declaradas (SQLSTATE 42995). La opcin de tabla reorganiza una tabla reconstruyendo las filas para eliminar los datos fragmentados y compactando la informacin. mbito: Este mandato afecta a todas las particiones de base de datos del grupo de particiones de base de datos. Autorizacin: Una de las siguientes: v v v v v sysadm sysctrl sysmaint dbadm Privilegio CONTROL en la tabla.
Conexin necesaria: Base de datos Sintaxis del mandato:

REORG TABLE nombre-tabla Clusula de tabla INDEXES ALL FOR TABLE nombre-tabla Clusula de ndice
Clusula de particin de base de datos
Clusula de tabla:
INDEX nombre-ndice
603
REORG INDEXES/TABLE
ALLOW READ ACCESS ALLOW NO ACCESS USE espaciotb INDEXSCAN ALLOW WRITE ACCESS INPLACE ALLOW READ ACCESS NOTRUNCATE TABLE STOP PAUSE LONGLOBDATA START RESUME
Clusula de ndice:
ALLOW READ ACCESS ALLOW NO WRITE ACCESS CLEANUP ONLY PAGES CONVERT ALL
Clusula de particin de base de datos:

, ON DBPARTITIONNUM ( DBPARTITIONNUMS ALL DBPARTITIONNUMS nmero1-particin-bd TO nmero2-particin-bd , EXCEPT DBPARTITIONNUM DBPARTITIONNUMS ( nmero1-particin-bd TO nmero2-particin-bd ) )
Parmetros del mandato: INDEXES ALL FOR TABLE nombre-tabla Especifica la tabla cuyos ndices se han de reorganizar. La tabla puede estar en una base de datos local o remota. ALLOW NO ACCESS Especifica que ningn otro usuario puede acceder a la tabla mientras los ndices se estn reorganizando. ste es el valor por omisin. ALLOW READ ACCESS Especifica que otros usuarios pueden tener acceso de slo lectura a la tabla mientras se estn reorganizando los ndices. ALLOW WRITE ACCESS Especifica que otros usuarios pueden leer y grabar en la tabla mientras se estn reorganizando los ndices. CLEANUP ONLY Cuando se solicite CLEANUP ONLY, se realizar una limpieza en vez de una reorganizacin completa. Los ndices no se reconstruirn y las pginas liberadas estarn disponibles para que los ndices definidos puedan volver a utilizarlas slo en esta tabla.
604
Command Reference
REORG INDEXES/TABLE
La opcin CLEANUP ONLY PAGES buscar y liberar pginas pseudovacas comprometidas. Una pgina pseudovaca comprometida es aqulla en que todas las claves de la pgina estn marcadas como suprimidas y se sabe que todas estas supresiones estn comprometidas. El nmero de pginas pseudovacas en un ndice puede determinarse ejecutando runstats y consultando la columna NUM EMPTY LEAFS de SYSCAT.INDEXES. La opcin PAGES limpiar NUM EMPTY LEAFS si stas estn determinadas para el compromiso. La opcin CLEANUP ONLY ALL liberar las pginas pseudovacas comprometidas y eliminar claves pseudosuprimidas comprometidas de las pginas que no estn pseudovacas. Esta opcin intentar asimismo fusionar pginas hojas adyacentes si al hacerlo se producir una pgina hoja fusionada que dispondr de al menos un espacio libre igual a PCTFREE en dicha pgina hoja fusionada, donde PCTFREE es el porcentaje de espacio libre definido para el ndice durante su creacin. El valor por omisin de PCTFREE es del diez por ciento. Si pueden fusionarse dos pginas, se liberar una de ellas. El nmero de claves pseudosuprimidas en un ndice, excluidas las que estn en pginas pseudovacas, puede determinarse ejecutando runstats y, a continuacin, seleccionando NUMRIDS DELETED de SYSCAT.INDEXES. La opcin ALL limpiar NUMRIDS DELETED y NUM EMPTY LEAFS si stas estn determinadas para el compromiso. ALL Especifica que los ndices deben limpiarse eliminando las claves pseudosuprimidas comprometidas y las pginas pseudovacas comprometidas. Especifica que las pginas pseudovacas comprometidas deben eliminarse del rbol del ndice. Esta accin no limpiar las claves pseudosuprimidas en las pginas que no estn pseudovacas. Dado que slo se comprueban las pginas hojas pseudovacas, en la mayor parte de los casos es un mtodo considerablemente ms rpido que utilizar la opcin ALL. CONVERT Si no est seguro de si la tabla en la que est operando tiene un ndice de tipo 1 o 2, pero desea ndices de tipo 2, puede utilizar la opcin CONVERT. Si el ndice es de tipo 1, esta opcin lo convertir en tipo 2. Si el ndice ya es de tipo 2, esta opcin no tiene ningn efecto.
PAGES
605
REORG INDEXES/TABLE
Todos los ndices creados por DB2 antes de la Versin 8 son ndices de tipo 1. Todos los ndices creados por la Versin 8 son ndices de tipo 2, salvo cuando se crea un ndice en una tabla que ya tiene un ndice de tipo 1. En este caso, el nuevo ndice tambin ser de tipo 1. REORG INDEXES siempre convertir los ndices de tipo 1 en ndices de tipo 2, a menos que se utilice la opcin CLEANUP. Utilizar el mandato INSPECT para determinar el tipo de ndice puede ser un mtodo lento. CONVERT le permite asegurarse de que el nuevo ndice ser de tipo 2, sin que sea necesario determinar su tipo original. Utilice la opcin ALLOW READ ACCESS o ALLOW WRITE ACCESS para permitir que otras transacciones tengan acceso de slo lectura o de lectura-grabacin a la tabla mientras se reorganizan los ndices. Tenga en cuenta que, aunque ALLOW READ ACCESS y ALLOW WRITE ACCESS permiten el acceso a la tabla, durante el perodo en que las copias reorganizadas de los ndices quedan disponibles, no se permite el acceso a la tabla. TABLE nombre-tabla Especifica la tabla que se debe reorganizar. La tabla puede estar en una base de datos local o remota. Se puede utilizar el nombre o el alias con el formato: esquema.nombre-tabla. El esquema es el nombre de usuario bajo el que se ha creado la tabla. Si se omite el nombre de esquema, se supone que se trata del esquema por omisin. Nota: Para las tablas de tipo, el nombre de tabla especificado debe ser el nombre de la tabla raz de la jerarqua. No se puede especificar un ndice para la reorganizacin de una tabla de clster multidimensional (MDC). Asimismo, tenga en cuenta que no se puede utilizar la reorganizacin de tablas en el lugar para las tablas MDC. INDEX nombre-ndice Especifica el ndice a utilizar al reorganizar la tabla. Si no se especifica el nombre totalmente calificado con el formato: esquema.nombre-ndice, se supone que se trata del esquema por omisin. El esquema es el nombre de usuario bajo el cual se ha creado el ndice.El gestor de bases de datos utiliza el ndice para volver a ordenar fsicamente los registros de la tabla que est reorganizando. En el caso de una reorganizacin de la tabla en el lugar, si se define un ndice de clster en la tabla y se especifica un ndice, tiene que ser un ndice de clster. Si no se especifica la
606
Command Reference
REORG INDEXES/TABLE
opcin INPLACE (en el lugar), se utilizar cualquier ndice especificado. Si no se especifica el nombre de un ndice, los registros se reorganizan sin importar el orden. No obstante, si la tabla tiene definido un ndice de clster y no se especifica ningn ndice, se utiliza el ndice de clster para crear el clster de la tabla. No se puede especificar un ndice si se est reorganizando una tabla MDC. INPLACE Reorganiza la tabla al tiempo que permite el acceso de los usuarios. La reorganizacin de tabla en el lugar slo est permitida en tablas con ndices de tipo 2 y sin ndices ampliados. ALLOW READ ACCESS Permite slo el acceso de lectura a la tabla durante la reorganizacin. ALLOW WRITE ACCESS Permite el acceso de grabacin a la tabla durante la reorganizacin. ste es el comportamiento por omisin. NOTRUNCATE TABLE No se trunca la tabla despus de la reorganizacin en el lugar. Durante el truncamiento, la tabla tiene un bloqueo S. START Inicia el proceso de REORG en el lugar. Dado que es el valor por omisin, esta palabra clave es opcional. STOP Detiene el proceso de REORG en el lugar en el punto actual. PAUSE Suspende o hace una pausa momentnea de REORG en el lugar. RESUME Contina o reanuda una reorganizacin de tabla en el lugar tras una pausa previa. USE nombre-espaciotabla Especifica el nombre de un espacio de tabla temporal del sistema donde se puede almacenar una copia temporal de la tabla que se est reorganizando. Si no se proporciona un nombre de espacio de tabla, el gestor de bases de datos almacena una copia de trabajo de la tabla en los espacios de tabla que contienen la tabla que se est reorganizando.
607
REORG INDEXES/TABLE
Para un objeto de tabla de 8, 16 32 KB, el tamao de pgina de cualquier espacio de tabla temporal de sistema que se especifique debe coincidir con el tamao de pgina de los espacios de tabla en los que residen los datos de tabla, incluyendo los datos de columna LONG o LOB. INDEXSCAN Para un REORG de clster, se utilizar una exploracin de ndice para reordenar los registros de tabla. Para reorganizar las filas de la tabla, acceda a la tabla mediante un ndice. El mtodo por omisin es explorar la tabla y clasificar el resultado para reorganizar la tabla, utilizando los espacios de tabla temporales como sea necesario. Aunque las claves de ndice estn dispuestas en el orden de clasificacin, la exploracin y la clasificacin suelen ser ms rpidas que captar filas leyendo primero el identificador de fila desde un ndice. LONGLOBDATA Los datos de campo largo y LOB se han de reorganizar. Esto no es obligatorio, aunque la tabla contenga columnas largas o LOB. El valor por omisin es evitar la reorganizacin de estos objetos porque consume tiempo y no mejora el clster. Ejemplos: Para ejecutar REORG TABLE de clase como el valor por omisin de DB2, Versin 7, entre el mandato siguiente:
db2 reorg table employee index empid allow no access indexscan longlobdata
Tenga en cuenta que los valores por omisin son diferentes en DB2, Versin 8. Para reorganizar una tabla con el fin de reclamar espacio y utilizar el espacio de tabla temporal mitemp1, entre el siguiente mandato:
db2 reorg table homer.employee use mitemp1
Para reorganizar las tablas de un grupo de particiones consistente en los nodos 1, 2, 3 y 4 de un sistema de cuatro nodos, puede entrar uno cualquiera de los mandatos siguientes:
db2 reorg table employee index empid on dbpartitionnum (1,3,4) db2 reorg table homer.employee index homer.empid on all dbpartitionnums except dbpartitionnum (2)
608
Command Reference
REORG INDEXES/TABLE
Para limpiar las teclas pseudosuprimidas y las pginas pseudovacas de todos los ndices de la tabla EMPLOYEE, al tiempo que se permite que otras transacciones lean y actualicen la tabla, entre:
db2 reorg indexes all for table homer.employee allow write access cleanup only
Para limpiar las pginas pseudovacas de todos los ndices de la tabla EMPLOYEE, al tiempo que se permite que otras transacciones lean y actualicen la tabla, entre:
db2 reorg indexes all for table homer.employee allow write access cleanup only pages
Para reorganizar la tabla EMPLOYEE utilizando el espacio de tabla temporal de sistema TEMPSPACE1 como rea de trabajo, entre:
db2 reorg table homer.employee using tempspace1
Para iniciar, hacer una pausa y reanudar una reorganizacin en el lugar de la tabla EMPLOYEE con el esquema por omisin HOMER, que se ha especificado explcitamente en los ejemplos anteriores, entre los mandatos siguientes:
db2 reorg table employee index empid inplace start db2 reorg table employee inplace pause db2 reorg table homer.employee inplace allow read access notruncate table resume
Tenga en cuenta que el mandato para reanudar la reorganizacin contiene palabras clave adicionales para especificar el acceso de slo lectura y saltar el paso de truncamiento, que establece un bloqueo compartido de la tabla. Notas de uso: La informacin acerca del progreso actual de la reorganizacin de la tabla se graba en el archivo histrico para la actividad de la base de datos. El archivo histrico contiene un registro para cada suceso de reorganizacin. Si desea ver este archivo, ejecute el mandato db2 list history para la base de datos que contiene la tabla que se est reorganizando. Tambin puede utilizar instantneas de tabla para supervisar el progreso de la reorganizacin de la tabla. Los datos de supervisin de reorganizacin de tabla se registran independientemente del valor del Conmutador de tabla de supervisor de base de datos. Si se produce un error, se grabar un vuelco SQLCA en el archivo histrico. Para una reorganizacin de tabla en el lugar, el estado se registrar como PAUSED. Cuando una tabla indexada se ha modificado muchas veces, los datos de los ndices pueden quedar fragmentados. Si la tabla tiene un clster respecto a un ndice, la tabla y el ndice pueden salir del orden del clster. Ambos factores
609
REORG INDEXES/TABLE
pueden afectar negativamente al rendimiento de las exploraciones que utilizan el ndice y pueden influir en la eficacia de la captacin previa de pginas de ndice. Puede utilizarse REORG INDEXES para reorganizar todos los ndices de una tabla, con el fin de eliminar la fragmentacin y restaurar el clster fsico en las pginas hojas. Utilice REORGCHK como ayuda para determinar si un ndice necesita una reorganizacin. Asegrese de completar todas las operaciones de base de datos y de liberar todos los bloqueos antes de invocar REORG INDEXES. Esto puede realizarse emitiendo COMMIT despus de cerrar todos los cursores abiertos WITH HOLD o emitiendo ROLLBACK. El mandato REORG TABLE no est soportado para las tablas temporales declaradas. Es posible que los ndices no sean ptimos tras una operacin REORG TABLE en el lugar, dado que slo se reorganiza el objeto de datos y no los ndices. Se recomienda que se ejecute REORG INDEXES despus de una operacin REORG TABLE en el lugar. No obstante, los ndices se reconstruyen por completo durante la ltima fase de un REORG TABLE clsico, en cuyo caso no es necesario reorganizar ndices. Las tablas que se han modificado tantas veces que los datos estn fragmentados y el rendimiento de acceso es notablemente lento, son candidatas para ejecutar el mandato REORG TABLE. Tambin se debe invocar este programa de utilidad despus de modificar la longitud en lnea de una columna de tipo estructurado con el fin de aprovechar la longitud en lnea modificada. Utilice REORGCHK para determinar si una tabla se tiene que reorganizar. Asegrese de completar todas las operaciones de base de datos y liberar todos los bloqueos antes de invocar REORG TABLE. Esto puede realizarse emitiendo COMMIT despus de cerrar todos los cursores abiertos WITH HOLD o emitiendo ROLLBACK. Despus de reorganizar una tabla, utilice RUNSTATS para actualizar las estadsticas de tabla y REBIND para volver a vincular los paquetes que utilizan esta tabla. El programa de utilidad de reorganizacin cerrar implcitamente todos los cursores. Si la tabla contiene un formato de filas mixto porque se ha activado o desactivado la compresin de valores de tabla, una reorganizacin de tabla fuera de lnea puede convertir todas las filas existentes al formato de fila de destino. Si la tabla est particionada en varias particiones de base de datos y la reorganizacin de la tabla falla en cualquiera de las particiones de base de datos afectadas, slo se retrotraer la reorganizacin de la tabla en las particiones de base de datos anmalas.
610
Command Reference
REORG INDEXES/TABLE
Nota: Si la reorganizacin no es satisfactoria, no se debern suprimir los archivos temporales. El gestor de bases de datos utiliza dichos archivos para recuperar la base de datos. Si se especifica el nombre de un ndice, el gestor de bases de datos reorganiza los datos de acuerdo con el orden del ndice. Para maximizar el rendimiento, especifique un ndice que se utilice con frecuencia en consultas de SQL. Si no se especifica el nombre de un ndice y existe un ndice de clster, los datos se ordenarn de acuerdo al ndice de clster. El valor PCTFREE de una tabla determina la cantidad de espacio libre designado por pgina. Si no se ha establecido el valor, el programa de utilidad llenar tanto espacio como sea posible en cada pgina. Este programa de utilidad no soporta el uso de apodos. REORG TABLE no puede utilizarse en vistas. REORG TABLE no puede utilizarse en una tabla DMS mientras se est realizando una copia de seguridad en lnea de un espacio de tabla en el que resida la tabla. Para realizar una recuperacin en avance del espacio de tabla a continuacin de una reorganizacin de tabla, los datos y los espacios de tabla LONG se debern habilitar para el avance. Si la tabla contiene columnas LOB que no utilizan la opcin COMPACT, el objeto de almacenamiento LOB DATA puede ser significativamente mayor despus de la reorganizacin de la tabla. Esto puede ser el resultado del orden en el que se han reorganizado las filas y se han utilizado los tipos de espacios de tabla (SMS/DMS). REORG TABLE no puede utilizar un ndice que se base en una extensin de ndice. Informacin relacionada: v v v v Mandato Mandato Mandato Mandato GET SNAPSHOT en la pgina 374 REORGCHK en la pgina 612 RUNSTATS en la pgina 659 REBIND en la pgina 581
611
REORGCHK Mandato REORGCHK

Calcula estadsticas en la base de datos para determinar si es necesario reorganizar o limpiar las tablas y/o los ndices. mbito: Este mandato puede emitirse desde cualquier particin de base de datos del archivo db2nodes.cfg. Puede utilizarse para actualizar estadsticas de tablas e ndices en los catlogos. Autorizacin: Una de las siguientes: v Autorizacin sysadm o dbadm v Privilegio CONTROL en la tabla. Conexin necesaria: Base de datos Sintaxis del mandato:
UPDATE STATISTICS REORGCHK CURRENT STATISTICS ON SCHEMA TABLE nombre-esquema USER SYSTEM ALL nombre-tabla ON TABLE USER
Parmetros del mandato: UPDATE STATISTICS Llama a la rutina RUNSTATS para actualizar estadsticas de tabla y entonces utiliza las estadsticas actualizadas para determinar si es necesaria la reorganizacin de la tabla. Si existe una particin de tabla en el nodo donde se ha emitido REORGCHK, RUNSTATS se ejecuta en dicho nodo. Si no existe una particin de tabla en dicho nodo, se enva la peticin al primer nodo del grupo de particiones de base de datos que contiene una particin para la tabla. Entonces se ejecuta RUNSTATS en dicho nodo. CURRENT STATISTICS Utiliza las estadsticas de tabla actuales para determinar si es necesaria la reorganizacin de la tabla.
612
Command Reference
REORGCHK
ON SCHEMA nombre-esquema Comprueba todas las tablas creadas bajo el esquema especificado. ON TABLE USER Comprueba las tablas que son propiedad del ID de autorizacin de tiempo de ejecucin. SYSTEM Comprueba las tablas de sistema. ALL Comprueba todas las tablas de usuario y de sistema.
nombre-tabla Especifica la tabla que se debe comprobar. Se deber utilizar el nombre totalmente calificado o el alias con el formato: esquema.nombre-tabla. El esquema es el nombre de usuario bajo el que se ha creado la tabla. Si la tabla especificada es una tabla de catlogo del sistema, el esquema es SYSIBM. Nota: Para las tablas de tipo, el nombre de tabla especificado debe ser el nombre de la tabla raz de la jerarqua. Ejemplos: A continuacin se muestra un ejemplo de salida del mandato. Slo se muestra una parte de la salida de Estadsticas de ndice.
db2 reorgchk update statistics on table system
se ejecuta para la base de datos SAMPLE:

Efectuando RUNSTATS .... Estadsticas de tabla: F1: 100 * OVERFLOW / CARD < 5 F2: 100 * (Effective Space Utilization of Data Pages) > 68 F3: 100 * (Pginas necesarias / Pginas totales) > 80 SCHEMA NAME CARD OV NP FP TSIZE F1 F2 F3 REORG -------------------------------------------------------------------------------SYSIBM SYSATTRIBUTES - --SYSIBM SYSBUFFERPOOLNODES - --SYSIBM SYSBUFFERPOOLS 1 0 1 1 52 0 - 100 --SYSIBM SYSCHECKS - --SYSIBM SYSCODEPROPERTIES - --SYSIBM SYSCOLAUTH - --SYSIBM SYSCOLCHECKS - --SYSIBM SYSCOLDIST - --SYSIBM SYSCOLGROUPDIST - --SYSIBM SYSCOLGROUPDISTCO> - --Captulo 3. Mandatos de CLP
613
REORGCHK
SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSIBM SYSCOLGROUPS SYSCOLGROUPSCOLS SYSCOLOPTIONS SYSCOLPROPERTIES SYSCOLUMNS SYSCOLUSE SYSCOMMENTS SYSCONSTDEP SYSDATATYPES SYSDBAUTH SYSDEPENDENCIES SYSEVENTMONITORS SYSEVENTS SYSEVENTTABLES SYSFUNCMAPOPTIONS SYSFUNCMAPPARMOPT> SYSFUNCMAPPINGS SYSHIERARCHIES SYSINDEXAUTH SYSINDEXCOLUSE SYSINDEXES SYSINDEXEXPLOITRU> SYSINDEXEXTENSION> SYSINDEXEXTENSION> SYSINDEXEXTENSIONS SYSINDEXOPTIONS SYSJARCONTENTS SYSJAROBJECTS SYSKEYCOLUSE SYSLIBRARIES SYSLIBRARYAUTH SYSLIBRARYBINDFIL> SYSLIBRARYVERSIONS SYSNAMEMAPPINGS SYSNODEGROUPDEF SYSNODEGROUPS SYSPARTITIONMAPS SYSPASSTHRUAUTH SYSPLAN SYSPLANAUTH SYSPLANDEP SYSPREDICATESPECS SYSPROCOPTIONS SYSPROCPARMOPTIONS SYSRELS SYSROUTINEAUTH SYSROUTINEPARMS SYSROUTINEPROPERT> SYSROUTINES SYSSCHEMAAUTH SYSSCHEMATA SYSSECTION SYSSEQUENCEAUTH SYSSEQUENCES SYSSERVEROPTIONS 2861 2 17 3 9 2 503 184 4 3 3 3 2 3 4 84 163 42 66 1297 203 2 7 12405 3 0 0 0 0 0 0 27 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 143 1 3 1 1 1 7 16 1 1 1 1 1 1 1 8 3 2 2 50 22 1 1 172 144 557895 1 186 3 14399 1 138 1 720 1 140 7 23641 21 124752 1 292 1 180 1 750 1 756 1 60 1 174 1 160 8 69888 3 10106 2 7812 2 5808 50 194550 22 139867 1 100 1 427 172 5148075 0 0 0 0 0 0 0 14 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 95 100 96 100 100 100 100 100 97 100 100 - --- --- --- --99 --- --- --100 --100 --100 --100 --- --- --- --- --- --- --- --100 --100 --76 *-* - --- --- --- --- --- --- --100 --100 --- --100 --100 --- --100 --100 --100 --- --100 --100 --100 --- --- --- --- --100 --100 --- --100 --100 --100 --100 --- --- --- ---
614
Command Reference
REORGCHK
SYSIBM SYSSERVERS - --SYSIBM SYSSTMT 12405 0 366 366 4775925 0 100 100 --SYSIBM SYSTABAUTH 248 0 5 5 18104 0 100 100 --SYSIBM SYSTABCONST 2 0 1 1 158 0 - 100 --SYSIBM SYSTABLES 249 0 27 27 397902 0 100 100 --SYSIBM SYSTABLESPACES 3 0 1 1 321 0 - 100 --SYSIBM SYSTABOPTIONS - --SYSIBM SYSTBSPACEAUTH 1 0 1 1 54 0 - 100 --SYSIBM SYSTRANSFORMS - --SYSIBM SYSTRIGGERS - --SYSIBM SYSTYPEMAPPINGS - --SYSIBM SYSUSERAUTH 248 0 8 8 54312 0 100 100 --SYSIBM SYSUSEROPTIONS - --SYSIBM SYSVERSIONS 1 0 1 1 36 0 - 100 --SYSIBM SYSVIEWDEP 214 0 5 5 18404 0 100 100 --SYSIBM SYSVIEWS 144 0 7 7 37872 0 100 100 --SYSIBM SYSWRAPOPTIONS - --SYSIBM SYSWRAPPERS - --SYSIBM SYSXMLOBJECTAUTH - --SYSIBM SYSXMLOBJECTAUTHP> - --SYSIBM SYSXMLOBJECTPROPE> - --SYSIBM SYSXMLOBJECTRELDEP - --SYSIBM SYSXMLOBJECTS - --SYSIBM SYSXMLOBJECTXMLDEP - --SYSIBM SYSXMLPHYSICALCOL> - --SYSIBM SYSXMLQUERIES - --SYSIBM SYSXMLRELATIONSHI> - --SYSIBM SYSXMLRSPROPERTIES - --SYSIBM SYSXMLSTATS - ---------------------------------------------------------------------------------Estadsticas de ndice: F4: CLUSTERRATIO o CLUSTERFACTOR normalizado > 80 F5: 100*(KEYS*(ISIZE+9)+(CARD-KEYS)*5) / ((NLEAF-NUM_EMPTY_LEAFS)*INDEXPAGESIZE) > 50 F6: (100-PCTFREE)*((INDEXPAGESIZE-96)/(ISIZE+12))**(NLEVELS-2)*(INDEXPAGESIZE-96)/ (KEYS*(ISIZE+9)+(CARD-KEYS)*5) < 100 F7: 100 * (NUMRIDS DELETED / (NUMRIDS DELETED + CARD)) < 20 F8: 100 * (NUM EMPTY LEAFS / NLEAF) < 20
615
REORGCHK
SCHEMA NAME CARD LEAF ELEAF LVLS ISIZE NDEL KEYS F4 F5 F6 F7 F8 REORG ----------------------------------------------------------------------------------------Tabla: SYSIBM.SYSATTRIBUTES SYSIBM IBM83 - - - - - - ----SYSIBM IBM84 - - - - - - ----SYSIBM IBM85 - - - - - - ----Tabla: SYSIBM.SYSBUFFERPOOLNODES SYSIBM IBM69 - - - - - - ----Tabla: SYSIBM.SYSBUFFERPOOLS SYSIBM IBM67 1 1 0 1 22 0 1 100 - - 0 0 ----SYSIBM IBM68 1 1 0 1 10 0 1 100 - - 0 0 ----Tabla: SYSIBM.SYSCHECKS SYSIBM IBM37 - - - - - - ----Tabla: SYSIBM.SYSCODEPROPERTIES SYSIBM IBM161 - - - - - - ----Tabla: SYSIBM.SYSCOLAUTH SYSIBM IBM42 - - - - - - ----SYSIBM IBM43 - - - - - - ----SYSIBM IBM64 - - - - - - ----Tabla: SYSIBM.SYSCOLCHECKS SYSIBM IBM38 - - - - - - ----SYSIBM IBM39 - - - - - - ----Tabla: SYSIBM.SYSCOLDIST SYSIBM IBM46 - - - - - - ----Tabla: SYSIBM.SYSCOLGROUPDIST SYSIBM IBM157 - - - - - - ----Tabla: SYSIBM.SYSCOLGROUPDISTCOUNTS SYSIBM IBM158 - - - - - - ----Tabla: SYSIBM.SYSCOLGROUPS SYSIBM IBM154 - - - - - - ----SYSIBM IBM155 - - - - - - ----Tabla: SYSIBM.SYSCOLGROUPSCOLS SYSIBM IBM156 - - - - - - ----Tabla: SYSIBM.SYSCOLOPTIONS SYSIBM IBM89 - - - - - - ----Tabla: SYSIBM.SYSCOLPROPERTIES SYSIBM IBM79 - - - - - - ----SYSIBM IBM80 - - - - - - ----SYSIBM IBM82 - - - - - - ----Tabla: SYSIBM.SYSCOLUMNS SYSIBM IBM01 2861 60 0 2 41 0 2861 95 58 2 0 0 ----SYSIBM IBM24 2861 7 0 2 23 0 13 82 51 24 0 0 ----Tabla: SYSIBM.SYSCOLUSE SYSIBM IBM146 - - - - - - ----SYSIBM IBM147 - - - - - - ----Tabla: SYSIBM.SYSCOMMENTS SYSIBM IBM73 - - - - - - ----Tabla: SYSIBM.SYSCONSTDEP SYSIBM IBM44 2 1 0 1 83 0 2 100 - - 0 0 ----SYSIBM IBM45 2 1 0 1 49 0 2 100 - - 0 0 ----Tabla: SYSIBM.SYSDATATYPES SYSIBM IBM40 17 1 0 1 23 0 17 100 - - 0 0 ----SYSIBM IBM41 17 1 0 1 2 0 17 100 - - 0 0 ----SYSIBM IBM56 17 1 0 1 23 0 17 100 - - 0 0 ----Tabla: SYSIBM.SYSDBAUTH SYSIBM IBM12 3 1 0 1 25 0 3 100 - - 0 0 ----...
616
Command Reference
REORGCHK
CLUSTERRATIO o CLUSTERFACTOR normalizado (F4) indica que REORG es necesario para los ndices que no estn en la misma secuencia que la tabla base. Cuando se definen varios ndices en una tabla, es posible que uno o ms de uno de ellos tenga el distintivo conforme necesita REORG. Especifique el ndice ms importante para las secuencias de REORG. Las tablas definidas mediante la clusula ORGANIZE y los ndices de dimensin correspondientes tienen el sufijo * aadido a sus nombres. La cardinalidad de un ndice de dimensin es igual a la estadstica de bloques activos de la tabla.
Los trminos para las estadsticas de tabla (frmulas 1-3) significan: CARD Nmero de filas de la tabla base. OV NP FP (OVERFLOW) Nmero de filas de desbordamiento. (NPAGES) Nmero de pginas que contienen datos. (FPAGES) Nmero total de pginas.
TSIZE Tamao de tabla en bytes. Se calcula como el producto del nmero de filas de la tabla (CARD) y el promedio de longitud de las filas. El promedio de longitud de las filas se calcula como la suma del promedio de las longitudes de columna (AVGCOLLEN en SYSCOLUMNS) ms 10 bytes de espacio adicional de fila. Para los campos largos y los LOB slo se utiliza la longitud aproximada del descriptor. Los datos reales de campo largo o de LOB no se cuentan en TSIZE. TABLEPAGESIZE Tamao de pgina del espacio de tabla en el que residen los datos de tabla. F1 F2 F3 Resultados de la Frmula 1. Resultados de la Frmula 2. Resultados de la Frmula 3.
REORG Cada guin (-) visualizado en esta columna indica que los resultados calculados estaban dentro de los lmites establecidos de la frmula correspondiente y cada asterisco (*) indica que los resultados calculados excedan los lmites establecidos de la frmula correspondiente. v - o * en el lado izquierdo de la columna corresponde a F1 (Frmula 1) v - o * en medio de la columna corresponde a F2 (Frmula 2) v - o * en el lado derecho de la columna corresponde a F3 (Frmula 3).
617
REORGCHK
Se sugiere la reorganizacin de tabla cuando los resultados de los clculos exceden los lmites establecidos por la frmula. Por ejemplo, --- indica que, dado que los resultados de frmula de F1, F2 y F3 estn dentro de los lmites establecidos de la frmula, no se sugiere la reorganizacin de tabla.La anotacin *-* indica que los resultados de F1 y F3 sugieren la reorganizacin de tabla, incluso aunque F2 est todava dentro de los lmites establecidos.La anotacin *-- indica que F1 es la nica frmula que excede los lmites. Nota: El nombre de tabla se trunca a 30 caracteres y el smbolo > en la trigsima primera columna representa la parte truncada del nombre de tabla. Los trminos para las estadsticas de ndice (frmulas 4-8) significan: CARD Nmero de filas de la tabla base. LEAF ELEAF Nmero de pginas hojas de ndice pseudovacas (NUM_EMPTY_LEAFS) Una pgina hoja de ndice pseudovaca es una pgina en la que todos los RID estn marcados como suprimidos, pero no se han eliminado fsicamente. NDEL Nmero de RID pseudosuprimidos (NUMRIDS_DELETED) Un RID pseudosuprimido es un RID marcado como suprimido. Esta estadstica informa de unos RID pseudosuprimidos en pginas hojas que no estn pseudovacas. No incluye los RID marcados como suprimidos en pginas hojas en las que todos los RID estn marcados como suprimidos. LVLS Nmero de niveles de ndice (NLEVELS) Nmero total de pginas hojas de ndice (NLEAF).
ISIZE Tamao de ndice, calculado a partir del promedio de longitud de columna de todas las columnas que participan en el ndice. KEYS Nmero de entradas de ndice exclusivas que no estn marcadas como suprimidas (FULLKEYCARD) INDEXPAGESIZE Tamao de pgina del espacio de tabla en el que residen los ndices de tabla, especificado en el momento de crear la tabla. Si no se especifica, INDEXPAGESIZE tiene el mismo valor que TABLEPAGESIZE.
618
Command Reference
REORGCHK
PCTFREE Especifica el porcentaje de cada pgina de ndice que se debe dejar como espacio libre, un valor que se asigna al definir el ndice. Los valores pueden estar en un rango de 0 a 99. El valor por omisin es 10. F4 F5 Resultados de la Frmula 4. Resultados de la Frmula 5. La anotacin +++ indica que el resultado excede de 999 y no es vlido. Vuelva a ejecutar REORGCHK con la opcin UPDATE STATISTICS, o emita RUNSTATS seguido del mandato REORGCHK. Resultados de la Frmula 6. La anotacin +++ indica que el resultado excede 9999 y no es vlido. Vuelva a ejecutar REORGCHK con la opcin UPDATE STATISTICS, o emita RUNSTATS seguido del mandato REORGCHK. Si las estadsticas son actuales y vlidas, debe reorganizar. Resultados de la Frmula 7. Resultados de la Frmula 8.
F6
F7 F8
REORG Cada guin (-) visualizado en esta columna indica que los resultados calculados estaban dentro de los lmites establecidos de la frmula correspondiente y cada asterisco (*) indica que el resultado calculado exceda los lmites establecidos de la frmula correspondiente. v - o * en la columna ms a la izquierda corresponde a F4 (Frmula 4) v - o * en la segunda columna desde la izquierda corresponde a F5 (Frmula 5) v - o * en la columna central corresponde a F6 (Frmula 6). v - o * en la segunda columna desde la derecha corresponde a F7 (Frmula 7) v - o * en la columna ms a la derecha corresponde a F8 (Frmula 8). El consejo de reorganizacin del ndice es tal como se indica a continuacin: v Si los resultados de los clculos de Frmula 1, 2 y 3 no sobrepasan los lmites establecidos por la frmula y los resultados de los clculos de Frmula 4, 5 o 6 sobrepasan los lmites establecidos, se recomienda la reorganizacin del ndice. v Si slo los resultados de los clculos de Frmula 7 sobrepasan los lmites establecidos, pero los resultados de Frmula 1, 2, 3, 4, 5 y 6
619
REORGCHK
permanecen dentro de los lmites establecidos, se recomienda la limpieza de los ndices utilizando la opcin CLEANUP ONLY de REORG INDEXES. v Si el nico resultado de los clculos que sobrepasa los lmites establecidos es el de Frmula 8, se recomienda una limpieza de las pginas pseudovacas de los ndices utilizando la opcin CLEANUP ONLY PAGES de REORG INDEXES. Notas de uso: Este mandato no visualiza informacin estadstica de tablas declaradas temporales. Este programa de utilidad no soporta el uso de apodos. A menos que especifique la opcin CURRENT STATISTICS, REORGCHK reunir estadsticas de todas las columnas utilizando slo las opciones por omisin. Especficamente, el grupo de columnas no se recoge y si se han reunido estadsticas de LIKE anteriormente, REORGCHK no las recoger. Las estadsticas reunidas dependern de la clase de estadsticas almacenadas actualmente en las tablas de catlogo: v Si hay estadsticas de ndice detalladas en el catlogo para cualquier ndice, se reunirn estadsticas de tabla y estadsticas de ndice detalladas (sin muestreo) para todos los ndices. v Si no se han detectado estadsticas de ndice detalladas, se reunirn estadsticas de tabla as como estadsticas de ndice regulares para cada ndice. v Si se detectan estadsticas de distribucin, stas se reunirn en la tabla. Si se renen estadsticas de distribucin, el nmero de valores frecuentes y cuantiles se basar en los valores de parmetro de configuracin de base de datos. REORGCHK calcula las estadsticas obtenidas de ocho frmulas diferentes para determinar si el rendimiento se ha deteriorado o si se puede mejorar reorganizando una tabla o sus ndices. Atencin: Estas estadsticas no se debern utilizar para determinar si las tablas vacas (TSIZE=0) necesitan una reorganizacin. Si TSIZE=0 y FPAGE>0, la tabla necesita reorganizarse. Si TSIZE=0 y FPAGE=0, no es necesaria ninguna reorganizacin. REORGCHK utiliza las frmulas siguientes para analizar la ubicacin fsica de las filas y el tamao de la tabla: v Frmula F1:
620
Command Reference
REORGCHK
100*OVERFLOW/CARD < 5
El nmero total de filas de desbordamiento de la tabla debe ser menor que el 5 por ciento del nmero total de filas. Se pueden crear filas de desbordamiento cuando se actualizan filas y las filas nuevas contienen ms bytes que las anteriores (campos VARCHAR) o cuando se aaden columnas a tablas existentes. v Frmula F2:
100*TSIZE / ((FPAGES-1) * (TABLEPAGESIZE-76)) > 68
El tamao de tabla en bytes (TSIZE) debe ser mayor que el 68 por ciento del espacio total asignado para la tabla. (Tiene que haber menos del 32% de espacio libre.) El espacio total asignado para la tabla depende del tamao de pgina del espacio de tabla en el que reside la tabla (menos 76 bytes de actividad general). Dado que la ltima pgina asignada generalmente no se llena, se resta 1 de FPAGES. v Frmula F3:
100*NPAGES/FPAGES > 80
El nmero de pginas que no contienen filas en absoluto debe ser menor que el 20 por ciento del nmero total de pginas. (Las pginas pueden quedar vacas despus de suprimir filas). REORGCHK utiliza las frmulas siguientes para analizar los ndices y su relacin con los datos de tabla: v Frmula F4:
CLUSTERRATIO o CLUSTERFACTOR normalizado > 80
La proporcin de clusters en un ndice debe ser mayor que el 80 por ciento. Cuando se definen mltiples ndices en una tabla, algunos de estos ndices tienen una proporcin de clusters baja. (La secuencia de ndices no es la misma que la secuencia de tablas). Esto no se puede evitar. Asegrese de especificar el ndice ms importante al reorganizar la tabla. La proporcin de clusters no suele ser ptima para los ndices que contienen muchas claves duplicadas y muchas entradas. v Frmula F5:
100*(KEYS*(ISIZE+9)+(CARD-KEYS)*5) / ((NLEAF-NUM_EMPTY_LEAFS)*INDEXPAGESIZE) > 50
Menos del 50 por ciento del espacio reservado para las entradas de ndice deber estar vaco (slo se comprueba cuando NLEAF>1). v Frmula F6:
(100-PCTFREE)*((INDEXPAGESIZE-96)/(ISIZE+12))**(NLEVELS-2)*(INDEXPAGESIZE-96) / (KEYS*(ISIZE+9)+(CARD-KEYS)*5) < 100
621
REORGCHK
Para determinar si la recreacin del ndice dar como resultado un rbol que tenga menos niveles. Esta frmula comprueba la proporcin entre la cantidad de espacio en un rbol de ndice que tiene un nivel menos que el rbol actual, y la cantidad de espacio necesario. Si se puede crear un rbol con un nivel menos y continuar dejando disponible PCTFREE, se recomienda una reorganizacin. El nmero real de entradas de ndice debe ser mayor que el 90% (o 100-PCTFREE) del nmero de entradas que puede manejar un rbol de ndices NLEVELS-1 (slo se comprueba si NLEVELS>1). v Frmula F7:
100 * (NUMRIDS_DELETED / (NUMRIDS_DELETED + CARD)) < 20
El nmero de los RID pseudosuprimidos en pginas no pseudovacas debe ser menor que el 20 por ciento. v Frmula F8:
100 * (NUM_EMPTY_LEAFS/NLEAF) < 20
El nmero de pginas hojas pseudovacas debe ser menor que el 20 por ciento del nmero total de pginas hojas. Nota: La ejecucin de estadsticas en muchas tablas puede ser una operacin larga, especialmente si las tablas son grandes. Informacin relacionada: v Mandato REORG INDEXES/TABLE en la pgina 603 v Mandato RUNSTATS en la pgina 659
622
Command Reference
RESET ADMIN CONFIGURATION Mandato RESET ADMIN CONFIGURATION

Restablece las entradas en el archivo de configuracin del Servidor de administracin DB2 (DAS) en el nodo al que est conectado. El DAS es una herramienta administrativa especial que permite la administracin remota de servidores DB2. Los valores se restablecen por tipo de nodo, que es siempre un servidor con clientes remotos. Para obtener una lista de parmetros de DAS, vea la descripcin del mandato UPDATE ADMINISTRATION CONFIGURATION. mbito: Este mandato restablece el archivo de configuracin de DAS en el nodo administrativo del sistema al que est conectado. Autorizacin: dasadm Conexin necesaria: Particin. Para restablecer la configuracin de DAS para un sistema remoto, especifique el sistema utilizando la opcin FOR NODE con el nombre del nodo administrativo. Sintaxis del mandato:
RESET ADMIN CONFIGURATION CONFIG CFG
FOR NODE
Parmetros del mandato: FOR NODE Entre el nombre del nodo administrativo para restablecer los parmetros de configuracin de DAS en el mismo. USER nombreusuario USING contrasea Si la conexin al sistema remoto requiere un nombre de usuario y una contrasea, entre esta informacin.
623
RESET ADMIN CONFIGURATION

Notas de uso: Para restablecer los parmetros de configuracin de DAS en un sistema remoto, especifique el sistema utilizando el nombre del nodo administrador como argumento para la opcin FOR NODE y especifique el nombre de usuario y la contrasea si la conexin a ese nodo requiere la autorizacin de nombre de usuario y contrasea. Para ver o imprimir una lista de los parmetros de configuracin del DAS, utilice el mandato GET ADMIN CONFIGURATION. Para cambiar el valor de un parmetro de administracin, utilice el mandato UPDATE ADMIN CONFIGURATION. Los cambios en los parmetros de configuracin de DAS que pueden actualizarse en lnea se realizan de inmediato. Otros cambios slo entran en vigor despus de cargarse en la memoria al reiniciar el DAS con el mandato db2admin. Si se produce un error, el archivo de configuracin del DAS no se modifica. El archivo de configuracin del DAS no se puede restablecer si la suma de comprobacin no es vlida. Esto puede producirse si se edita manualmente el archivo de configuracin del DAS y no se utiliza el mandato adecuado. Si la suma de comprobacin no es vlida, debe eliminar y volver a crear el DAS para restablecer su archivo de configuracin. Informacin relacionada: v Mandato GET ADMIN CONFIGURATION en la pgina 335 v Mandato UPDATE ADMIN CONFIGURATION en la pgina 704
624
Command Reference
RESET ALERT CONFIGURATION Mandato RESET ALERT CONFIGURATION

Restablece los valores del indicador de salud para objetos especficos a los valores por omisin actuales para ese tipo de objeto o restablece los valores por omisin del indicador de salud para un tipo de objeto a los valores de instalacin. Autorizacin: Una de las siguientes: v sysadm v sysmaint v sysctrl Conexin necesaria: Instancia. No se necesita una conexin explcita. Sintaxis del mandato:
RESET ALERT CONFIGURATION CONFIG CFG FOR
DATABASE MANAGER DB MANAGER DBM DATABASES TABLESPACES CONTAINERS DATABASE TABLESPACE nombre CONTAINER nombre FOR
ON alias basedatos id-espaciotabla
Parmetros del mandato: DATABASE MANAGER Restablece los valores de alerta para el gestor de bases de datos. DATABASES Restablece valores de alerta para todas las bases de datos gestionadas por el gestor de bases de datos. stos son los valores que se aplican a todas las bases de datos que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula DATABASE ON alias basedatos. CONTAINERS Restablece los valores de alerta para todos los contenedores de espacio de tabla gestionados por el gestor de bases de datos a los valores por
625
RESET ALERT CONFIGURATION

omisin de instalacin. stos son los valores que se aplican a todos los contenedores de espacio de tabla que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula CONTAINER nombre ON alias basedatos. CONTAINER nombre FOR ID espaciotabla FOR ID espaciotabla ON alias basedatos Restablece los valores de alerta para el contenedor de espacio de tabla denominado nombre, para el espacio de tabla especificado utilizando la clusula FOR ID espaciotabla, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este contenedor de espacio de tabla tiene valores personalizados, stos se eliminan y se utilizan los valores por omisin de los contenedores de espacio de tabla actuales. TABLESPACES Restablece los valores de alerta por omisin para todos los espacios de tabla gestionados por el gestor de bases de datos a los valores por omisin de instalacin. stos son los valores que se aplican a todos los espacios de tabla que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula TABLESPACE nombre ON alias basedatos. DATABASE ON alias basedatos Restablece los valores de alerta para la base de datos especificada utilizando la clusula ON alias basedatos. Si esta base de datos tiene valores personalizados, se eliminan estos valores y se utilizan los valores por omisin de instalacin. BUFFERPOOL nombre ON alias basedatos Restablece los valores de alerta para la agrupacin de almacenamientos intermedios denominada nombre, en la base de datos especificada utilizando la clusula ON alias basedatos. Si esta agrupacin de almacenamientos intermedios tiene valores personalizados, se eliminan estos valores y se utilizan los valores por omisin de instalacin. TABLESPACE nombre ON alias basedatos Restablece los valores de alerta para el espacio de tabla denominado nombre, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este espacio de tabla tiene valores personalizados, se eliminan estos valores y se utilizan los valores por omisin de instalacin.
626
Command Reference
RESET DATABASE CONFIGURATION Mandato RESET DATABASE CONFIGURATION

Restablece la configuracin de una base de datos especfica a los valores por omisin del sistema. mbito: Este mandato slo afecta al nodo en el que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. No se necesita una conexin explcita. Si la base de datos est listada como remota, se establece una conexin de instancia al nodo remoto durante el tiempo que dura el mandato. Sintaxis del mandato:
RESET DATABASE DB CONFIGURATION CONFIG CFG FOR alias-base-datos
Parmetros del mandato: FOR alias-base-datos Especifica el alias de la base de datos cuya configuracin debe restablecerse a los valores por omisin del sistema. Notas de uso: Para ver o imprimir una lista de los parmetros de configuracin de base de datos, utilice el mandato GET DATABASE CONFIGURATION. Para cambiar el valor de un parmetro configurable, utilice el mandato UPDATE DATABASE CONFIGURATIN. Los cambios efectuados en el archivo de configuracin de base de datos slo entran en vigor despus de cargarse en la memoria. Para que esto pueda producirse, todas las aplicaciones deben desconectarse de la base de datos.
627
RESET DATABASE CONFIGURATION

Si se produce un error, el archivo de configuracin de base de datos no se modifica. El archivo de configuracin de base de datos no se puede restablecer si la suma de comprobacin no es vlida. Esto puede producirse si se modifica el archivo de configuracin de base de datos sin utilizar el mandato apropiado. Si sucede esto, se deber restaurar la base de datos para restablecer el archivo de configuracin de la misma. Tareas relacionadas: v Configuring DB2 with configuration parameters del manual Administration Guide: Performance Informacin relacionada: v Mandato GET DATABASE CONFIGURATION en la pgina 349 v Mandato UPDATE DATABASE CONFIGURATION en la pgina 718 v Configuration parameters summary del manual Administration Guide: Performance
628
Command Reference
RESET DATABASE MANAGER CONFIGURATION Mandato RESET DATABASE MANAGER CONFIGURATION

Restablece los parmetros del archivo de configuracin del gestor de bases de datos en los valores por omisin del sistema. Los valores se restablecen por el tipo de nodo. Autorizacin: sysadm Conexin necesaria: Ninguna o instancia. Para efectuar operaciones de configuracin locales de gestor de bases de datos, no es necesaria una conexin de instancia, pero s es necesaria para realizar operaciones de configuracin remotas de gestor de bases de datos. Para actualizar la configuracin del gestor de bases de datos, en primer lugar es necesario conectarse a esa instancia. Para actualizar en lnea un parmetro de configuracin, tambin es necesario conectarse primero a la instancia. Sintaxis del mandato:
RESET DATABASE MANAGER DB MANAGER DBM CONFIGURATION CONFIG CFG
Parmetros del mandato: Ninguno Notas de uso: Es importante tener en cuenta que este mandato restablece todos los parmetros establecidos por el programa de instalacin. Esto podra hacer que se devolvieran mensajes de error al reiniciar DB2. Por ejemplo, si se restablece el parmetro SVCENAME, el usuario recibir el mensaje de error SQL5043N cuando intente reiniciar DB2. Antes de ejecutar este mandato, guarde la salida del mandato GET DATABASE MANAGER CONFIGURATION en un archivo a fin de que se puedan consultar los valores existentes. Los valores individuales se pueden actualizar a continuacin utilizando el mandato UPDATE DATABASE MANAGER CONFIGURATION. Nota: No se recomienda que el usuario modifique el parmetro SVCENAME, establecido por el programa de instalacin. El nombre de servicio de servidor de administracin est establecido para utilizar el puerto TCP/IP registrado de DB2 (523).
629
RESET DATABASE MANAGER CONFIGURATION

Para ver o imprimir una lista de los parmetros de configuracin de gestor de bases de datos, utilice el mandato GET DATABASE MANAGER CONFIGURATION. Para cambiar el valor de un parmetro configurable, utilice el mandato UPDATE DATABASE MANAGER CONFIGURATION. Para obtener ms informacin acerca de estos parmetros, consulte la lista de resumen de parmetros de configuracin y los parmetros individuales. Algunos cambios efectuados en el archivo de configuracin del gestor de bases de datos slo entran en vigor despus de haberse cargado en la memoria. Para obtener ms informacin sobre qu parmetros son configurables en lnea y cules no lo son, vea el resumen de parmetros de configuracin. Los parmetros de configuracin de servidor que no se restablecen inmediatamente, se restablecen durante la ejecucin de db2start. Para un parmetro de configuracin de cliente, los parmetros se restablecen la vez siguiente que se reinicia la aplicacin. Si el cliente es el procesador de lnea de mandatos, es necesario invocar TERMINATE. Si se produce un error, el archivo de configuracin del gestor de bases de datos no se modifica. El archivo de configuracin del gestor de bases de datos no puede restablecerse si la suma de comprobacin no es vlida. Esto puede producirse en el gestor de bases de datos si edita manualmente el archivo de configuracin y no utiliza el mandato adecuado. Si la suma de comprobacin no es vlida, debe volver a instalar el gestor de bases de datos para restablecer el archivo de configuracin del gestor de bases de datos. Tareas relacionadas: v Configuring DB2 with configuration parameters del manual Administration Guide: Performance Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato TERMINATE en la pgina 691 v Mandato UPDATE DATABASE MANAGER CONFIGURATION en la pgina 721 v Configuration parameters summary del manual Administration Guide: Performance
630
Command Reference
RESET MONITOR Mandato RESET MONITOR

Restablece a cero las reas de datos internas del supervisor del sistema de bases de datos de una base de datos especificada o de todas las bases de datos activas. Las reas de datos internas del supervisor del sistema de bases de datos incluyen las reas de datos para todas las aplicaciones conectadas a la base de datos, as como las reas de datos para la propia base de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Si no existe ninguna conexin de instancia, se crear una conexin de instancia por omisin. Para restablecer los conmutadores de supervisor para una instancia remota (o una instancia local diferente), es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
RESET MONITOR ALL DCS FOR DCS DATABASE DB alias-base-datos
Parmetros del mandato: ALL Esta opcin indica que se deben restablecer los contadores internos para todas las bases de datos.
FOR DATABASE alias-base-datos Esta opcin indica que slo se deben restablecer los contadores internos de la base de datos con el alias alias-base-datos. DCS En funcin de la clusula que se especifique, esta palabra clave restablece los contadores internos de: v Todas las bases de datos DCS
631
RESET MONITOR
v Una base de datos DCS especfica. AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor. GLOBAL Devuelve un resultado agregado para todas las particiones de base de datos de un sistema de base de datos particionado. Notas de uso: Cada proceso (conexin) tiene su propia vista privada de los datos de supervisor. Si un usuario restablece o desactiva un conmutador de supervisor, los dems usuarios no se ven afectados. Cambie el valor de los parmetros de configuracin de conmutador de supervisor para realizar cambios globales en los conmutadores de supervisor. Si se especifica ALL, tambin se restablece parte de la informacin del gestor de bases de datos para mantener la coherencia de los datos devueltos y se restablecen algunos contadores a nivel de particin. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato GET SNAPSHOT en la pgina 374 v Mandato GET MONITOR SWITCHES en la pgina 367 v Mandato UPDATE DATABASE MANAGER CONFIGURATION en la pgina 721
632
Command Reference
RESTART DATABASE Mandato RESTART DATABASE

Reinicia una base de datos que ha terminado anormalmente y que se ha dejado en un estado incoherente. Cuando RESTART DATABASE se ha completado satisfactoriamente, la aplicacin permanece conectada a la base de datos si el usuario tiene privilegio CONNECT. mbito: Este mandato slo afecta al nodo en el que se ejecuta. Autorizacin: Ninguna Conexin necesaria: Este mandato establece una conexin de base de datos. Sintaxis del mandato:
RESTART DATABASE DB alias-base-datos
USER
WRITE RESUME DROP PENDING TABLESPACES ( nombre-espaciotabla )
Parmetros del mandato: DATABASE alias-base-datos Identifica la base de datos que se debe reiniciar. USER nombreusuario Identifica el nombre de usuario bajo el que debe reiniciarse la base de datos. USING contrasea Contrasea utilizada para autentificar el nombreusuario. Si se omite la contrasea, se solicitar al usuario que la entre. DROP PENDING TABLESPACES nombre-espaciotabla Especifica que la operacin de reinicio de la base de datos debe realizarse satisfactoriamente incluso si se encuentran problemas de contenedor de espacio de tabla.
633
RESTART DATABASE
Si se produce un problema con un contenedor para un espacio de tabla especificado durante el proceso de reinicio, el espacio de tabla correspondiente no estar disponible (estar en estado de pendiente de eliminacin) despus de la operacin de reinicio. Si un espacio de tabla est en estado de pendiente de eliminacin, la nica accin posible es la de eliminar el espacio de tabla. En el caso de un registro cronolgico circular, un espacio de tabla anmalo producir una anomala de reinicio. Se puede encontrar una lista de los nombres de espacios de tabla anmalos en db2diag.log si falla una operacin de reinicio de base de datos debido a problemas de contenedor. Si slo hay un espacio de tabla temporal de sistema en la base de datos y ste est en estado de pendiente de eliminacin, se deber crear un espacio de tabla temporal de sistema nuevo inmediatamente despus de una operacin de reinicio de base de datos satisfactoria. WRITE RESUME Permite forzar un reinicio de base de datos en las bases de datos que se hayan puesto en estado SUSPEND_WRITE. Esta opcin eliminar el estado SUSPEND_WRITE de la base de datos en cuestin. Esta opcin es til en escenarios de recuperacin de sistemas bloqueados en que DB2 ha fallado mientras ciertas bases de datos estaban en estado SUSPEND_WRITE. Nota: El parmetro WRITE RESUME slo se puede aplicar a la base de datos primaria, no a bases de datos duplicadas. Notas de uso: Ejecute este mandato si un intento de conexin a una base de datos devuelve un mensaje de error, que indica que se debe reiniciar la base de datos. Esta accin slo se produce si la sesin anterior con esta base de datos ha terminado anormalmente (por ejemplo debido a una anomala de alimentacin). Cuando RESTART DATABASE se ha completado, se mantiene una conexin compartida a la base de datos si el usuario tiene privilegio CONNECT y se emite un aviso de SQL si existe alguna transaccin dudosa. En este caso, la base de datos sigue siendo utilizable pero si no se resuelven las transacciones dudosas antes de que se desactive la ltima conexin a la base de datos, se deber emitir otro RESTART DATABASE para poder utilizar la base de datos otra vez. Utilice el mandato LIST INDOUBT TRANSACTIONS para generar una lista de transacciones dudosas. Si la base de datos se reinicia nicamente en un solo nodo dentro de un sistema MPP, puede que en una consulta de base de datos subsiguiente se
634
Command Reference
RESTART DATABASE
devuelva un mensaje indicando que es necesario reiniciar la base de datos. Esto se produce porque tambin se debe reiniciar la particin de base de datos de un nodo del que depende la consulta. Si se reinicia la base de datos en todos los nodos, el problema se soluciona. Tareas relacionadas: v Manually resolving indoubt transactions del manual Administration Guide: Planning Informacin relacionada: v Mandato LIST INDOUBT TRANSACTIONS en la pgina 460
635
RESTORE DATABASE Mandato RESTORE DATABASE

Reconstruye una base de datos daada o corrupta de la que se ha hecho una copia de seguridad utilizando el programa de utilidad backup de DB2. La base de datos restaurada est en el mismo estado que estaba cuando se hizo la copia de seguridad. Este programa de utilidad tambin puede restaurar a una base de datos con un nombre diferente del de la base de datos de la imagen de copia de seguridad (adems de poder restaurar a una base de datos nueva). Este programa de utilidad tambin se puede utilizar para restaurar imgenes de copia de seguridad producidas por las dos versiones anteriores de DB2. Si es necesaria una migracin, sta se invocar automticamente al final de la operacin de restauracin. Si, en el momento de la operacin de copia de seguridad se ha habilitado la base de datos para la recuperacin en avance, la base de datos puede dejarse en el estado que estaba antes de que se produjera del dao o la corrupcin emitiendo el programa de utilidad de avance (rollforward) despus de la ejecucin satisfactoria de una operacin de restauracin. Este programa de utilidad tambin puede restaurar de una copia de seguridad a nivel de espacio de tabla. Para restaurar una base de datos de la que se ha hecho una copia de seguridad en una plataforma de estacin de trabajo diferente, utilice el programa de utilidad db2move. Se pueden restaurar bases de datos creadas en una versin de Windows desde otra versin. Las bases de datos creadas en plataformas AIX, HP y Sun tambin se pueden restaurar desde cada uno de estos sistemas. mbito: Este mandato slo afecta al nodo en el que se ejecuta. Autorizacin: Para restaurar a una base de datos existente, una de las siguientes: v sysadm v sysctrl v sysmaint Para restaurar a una base de datos nueva, una de las siguientes: v sysadm
636
Command Reference
RESTORE DATABASE
v sysctrl Conexin necesaria: Base de datos, para restaurar a una base de datos existente. Este mandato establece automticamente una conexin a la base de datos especificada. Instancia y base de datos, para restaurar a una base de datos nueva. La conexin de instancia es necesaria para crear la base de datos. Para restaurar a una base de datos nueva en una instancia diferente de la instancia actual (tal como se define en el valor de la variable de entorno DB2INSTANCE), es necesario conectarse primero a la instancia donde residir la nueva base de datos. Para restaurar a una nueva base de datos remota, es necesario conectarse a la instancia donde residir la nueva base de datos. Sintaxis del mandato:
RESTORE DATABASE DB alias-base-datos-origen opciones-restauracin CONTINUE ABORT
opciones-restauracin:
USER nombreusuario USING contrasea
TABLESPACE ONLINE , TABLESPACE HISTORY FILE ONLINE ( nombre-espaciotabla ) ONLINE
INCREMENTAL AUTO AUTOMATIC ABORT
637
RESTORE DATABASE
USE TSM XBSA ,
OPEN nm-sesiones
SESSIONS
FROM LOAD
directorio dispositivo biblioteca-compartida OPEN nm-sesiones SESSIONS
TAKEN AT fecha-hora
TO
directorio-destino
INTO
alias-base-datos-destino
NEWLOGPATH
directorio
WITH
nm-almacints
BUFFERS
BUFFER
tamao-almacint
DLREPORT
nombre-archivo
REPLACE EXISTING
REDIRECT
PARALLELISM
WITHOUT ROLLING FORWARD
WITHOUT DATALINK
WITHOUT PROMPTING
Parmetros del mandato: DATABASE alias-base-datos-origen Alias de la base de datos de origen de la que se ha realizado la copia de seguridad. CONTINUE Especifica que se han vuelto a definir los contenedores y que se deber realizar el paso final en la restauracin redirigida. ABORT Este parmetro: v Detiene una operacin de restauracin redirigida. Es til cuando se ha producido un error que necesita que se repitan uno o ms pasos. Despus de haber emitido RESTORE DATABASE con la opcin ABORT, se debe repetir cada paso de una operacin de restauracin redirigida, incluida la opcin RESTORE DATABASE. v Termina una operacin de restauracin incremental antes de su finalizacin. USER nombreusuario Identifica el nombre de usuario bajo el cual debe restaurarse la base de datos.
638
Command Reference
RESTORE DATABASE
USING contrasea Contrasea utilizada para autentificar el nombre de usuario. Si se omite la contrasea, se solicitar al usuario que la entre. TABLESPACE nombre-espaciotabla Lista de nombres utilizados para especificar los espacios de tabla que se deben restaurar. ONLINE Esta palabra clave, aplicable slo al realizar una operacin de restauracin de nivel de espacio de tabla, se especifica para permitir que una imagen de copia de seguridad se restaure en lnea. Esto significa que otros agentes pueden conectarse a la base de datos mientras se est restaurando la imagen de copia de seguridad y que los datos de otros espacios de tabla estarn disponibles mientras se estn restaurando los espacios de tabla especificados. HISTORY FILE Esta palabra clave se especifica para restaurar nicamente el archivo histrico de la imagen de copia de seguridad. INCREMENTAL Sin parmetros adicionales, INCREMENTAL especifica una operacin de restauracin acumulativa manual. Durante la restauracin manual, el usuario debe emitir manualmente cada mandato de restauracin para cada imagen implicada en la restauracin. Hgalo siguiendo este orden: ltima, primera, segunda, tercera y as sucesivamente, hasta la ltima imagen inclusive. INCREMENTAL AUTOMATIC/AUTO Especifica una operacin de restauracin acumulativa automtica. INCREMENTAL ABORT Especifica una terminacin anmala de una operacin de restauracin acumulativa manual que estaba en proceso. USE TSM Especifica que la base de datos debe restaurarse desde la salida gestionada por TSM. OPEN nm-sesiones SESSIONS Especifica el nmero de sesiones de E/S que deben utilizarse con TSM o el producto del proveedor. USE XBSA Especifica que debe utilizarse la interfaz XBSA. Las API de servicios de copia de seguridad (XBSA) se encuentran en una interfaz de programacin de aplicaciones abierta para aplicaciones o recursos que necesitan gestin de almacenamiento de datos para finalidades de
639
RESTORE DATABASE
copia de seguridad o archivo. Legato NetWorker es un gestor de almacenamiento que actualmente soporta la interfaz XBSA. FROM directorio/dispositivo Nombre de va de acceso totalmente calificada del directorio o dispositivo en el que se ubica la imagen de copia de seguridad. Si se omiten USE TSM, FROM y LOAD, el valor por omisin es el directorio de trabajo actual de la mquina cliente. Este directorio o dispositivo de destino debe existir en el servidor de bases de datos. En los sistemas operativos Windows, el directorio especificado no debe ser un directorio generado por DB2. Por ejemplo, dados los mandatos siguientes:
db2 backup database sample to c:\backup db2 restore database sample from c:\backup
DB2 genera subdirectorios bajo el directorio c:\backup que se debern ignorar. Para especificar de forma precisa qu imagen de copia de seguridad se debe restaurar, utilice el parmetro TAKEN AT. Pueden haber varias imgenes de copia de seguridad almacenadas en la misma va de acceso. Si se especifican varios elementos y el ltimo elemento es un dispositivo de cinta, se solicitar al usuario otra cinta. Las opciones de respuesta vlidas son: c Continuar. Contina utilizando el dispositivo que ha generado el mensaje de aviso (por ejemplo, contina cuando se ha montado una cinta nueva). Terminacin de dispositivo. Dejar de utilizar slo el dispositivo que ha generado el mensaje de aviso (por ejemplo, finalizar cuando no hay ms cintas). Terminar. Termina anormalmente una operacin de restauracin despus de que el usuario no haya conseguido llevar a cabo una accin solicitada por el programa de utilidad.
LOAD biblioteca-compartida Nombre de la biblioteca compartida (DLL en los sistemas operativos Windows) que contiene las funciones de E/S de copia de seguridad y restauracin de proveedor que hay que utilizar. El nombre puede contener una va de acceso completa. Si no se proporciona la va de acceso completa, se utiliza como valor por omisin la va de acceso en la que reside el programa de salida de usuario. TAKEN AT fecha-hora Indicacin de fecha y hora de la imagen de copia de seguridad de
640
Command Reference
RESTORE DATABASE
base de datos. La indicacin de fecha y hora se visualiza despus de una finalizacin satisfactoria de una operacin de copia de seguridad y forma parte del nombre de va de acceso para la imagen de copia de seguridad. Se especifica con el formato aaaammddhhmmss. Tambin puede especificarse una indicacin de fecha y hora parcial. Por ejemplo, si existen dos imgenes de copia de seguridad diferentes con las indicaciones de la hora 19971001010101 y 19971002010101, la especificacin de 19971002 hace que se utilice la indicacin de fecha y hora 19971002010101. Si no se especifica ningn valor para este parmetro, slo puede existir una imagen de copia de seguridad en el soporte de almacenamiento de origen. TO directorio-destino Directorio de base de datos de destino. Este parmetro se ignora si el programa de utilidad est restaurando a una base de datos existente. La unidad y el directorio que se especifiquen deben ser locales. Nota: En los sistemas operativos Windows, al utilizar este parmetro, especifique la letra de la unidad. Por ejemplo, puede especificar x:\nombre_va para restaurar en una va de acceso especfica, o x: si no es necesario especificar una va de acceso. Si el nombre de la va de acceso es demasiado largo, se devolver un error. INTO alias-base-datos-destino Alias de la base de datos de destino. Si la base de datos de destino no existe, se crear. Al restaurar una copia de seguridad de base de datos a una base de datos existente, la base de datos restaurada hereda el alias y el nombre de base de datos de la base de datos existente. Al restaurar una copia de seguridad de base de datos a una base de datos no existente, la nueva base de datos se crea con el alias y el nombre de base de datos que se especifique. Este nuevo nombre de la base de datos debe ser exclusivo en el sistema en que la restaure. NEWLOGPATH directorio Nombre absoluto de va de acceso de un directorio que se utilizar para los archivos de anotaciones cronolgicas activos despus de la operacin de restauracin. Este parmetro tiene la misma funcin que el parmetro de configuracin de base de datos newlogpath, salvo que en efecto est limitado a la operacin de restauracin en la que se especifica. Este parmetro se puede utilizar cuando la va de acceso de anotacin cronolgica en la imagen de copia de seguridad no es adecuada para utilizarla despus de la operacin de restauracin; por ejemplo, cuando la va de acceso ya no es vlida o la est utilizando otra base de datos distinta.
641
RESTORE DATABASE
WITH nm-almacints BUFFERS Nmero de almacenamientos intermedios a utilizar. El valor por omisin es 2. Sin embargo, se puede utilizar un gran nmero de almacenamientos intermedios para mejorar el rendimiento cuando le lee de varias fuentes o si se ha aumentado el valor de PARALLELISM. BUFFER tamao-almacint Tamao, en pginas, del almacenamiento intermedio utilizado para la operacin de restauracin. El valor mnimo para este parmetro es 8 pginas; el valor por omisin es de 1024 pginas. El tamao de almacenamiento intermedio de restauracin debe ser un entero positivo mltiplo del tamao de almacenamiento intermedio de copia de seguridad especificado durante la operacin de copia de seguridad. Si se especifica un tamao de almacenamiento intermedio incorrecto, los almacenamientos intermedios se asignan con el tamao ms pequeo aceptable. Cuando utilice dispositivos de cinta en SCO UnixWare 7, especifique un almacenamiento intermedio de 16. DLREPORT nombre-archivo El nombre de archivo, si se especifica, debe especificarse como una va de acceso absoluta. Informa de los archivos que quedan desenlazados, como resultado de una reconciliacin rpida, durante una operacin de restauracin. Esta opcin slo debe utilizarse si la tabla que se est restaurando tiene un tipo de columna DATALINK y archivos enlazados. REPLACE EXISTING Si ya existe una base de datos con el mismo alias que el alias de base de datos de destino, este parmetro especifica que el programa de utilidad restore debe sustituir la base de datos existente por la base de datos restaurada. Esto es til para scripts que invocan al programa de utilidad restore, puesto que el procesador de lnea de mandatos no solicitar al usuario que verifique la supresin de una base de datos existente. Si se especifica el parmetro WITHOUT PROMPTING, no es necesario especificar REPLACE EXISTING, pero en este caso, la operacin fallar si se producen sucesos que normalmente requieren la intervencin del usuario. REDIRECT Especifica una operacin de restauracin redirigida. Para completar una operacin de restauracin redirigida, este mandato debe ir seguido de uno o ms mandatos SET TABLESPACE CONTAINERS y, a continuacin, un mandato RESTORE DATABASE con la opcin CONTINUE.
642
Command Reference
RESTORE DATABASE
Nota: Todos los mandatos asociados con una operacin de restauracin redirigida individual deben invocarse desde la misma ventana o sesin CLP. WITHOUT ROLLING FORWARD Especifica que la base de datos no debe pasarse a estado de pendiente de avance despus de haberse restaurado satisfactoriamente. Si, despus de una operacin de restauracin satisfactoria, la base de datos est en estado de pendiente de avance, debe invocarse el mandato ROLLFORWARD antes de que la base de datos pueda utilizarse de nuevo. WITHOUT DATALINK Especifica que las tablas con columnas DATALINK deben pasarse a estado DRP (DataLink_Reconcile_Pending) y que no debe efectuarse ninguna reconciliacin de archivos enlazados. PARALLELISM n Especifica el nmero de manipuladores de almacenamiento intermedio que deben generarse durante la operacin de restauracin. El valor por omisin es 1. WITHOUT PROMPTING Especifica que la operacin de restauracin no ser una operacin atendida. Las acciones que normalmente requieren la intervencin del usuario devolvern un mensaje de error. Cuando se utilice un dispositivo de soporte de almacenamiento extrable, como por ejemplo cinta o disquete, se enviar una solicitud al usuario al final del dispositivo, aunque se especifique esta opcin. Ejemplos: En el ejemplo siguiente, la base de datos WSDB est definida en las 4 particiones, numeradas de 0 a 3. La va de acceso /dev3/backup es accesible desde todas las particiones. Las siguientes imgenes de copia de seguridad fuera de lnea estn disponibles desde /dev3/backup:
wsdb.0.db2inst1.NODE0000.CATN0000.20020331234149.001 wsdb.0.db2inst1.NODE0001.CATN0000.20020331234427.001 wsdb.0.db2inst1.NODE0002.CATN0000.20020331234828.001 wsdb.0.db2inst1.NODE0003.CATN0000.20020331235235.001
Para restaurar primero la particin de catlogo, todas las dems particiones de base de datos de la base de datos WSDB del directorio /dev3/backup, emita los siguientes mandatos desde una de las particiones de base de datos:
db2_all <<+0< db2 RESTORE DATABASE wsdb FROM /dev3/backup TAKEN AT 20020331234149 INTO wsdb REPLACE EXISTING db2_all <<+1< db2 RESTORE DATABASE wsdb FROM /dev3/backup
643
RESTORE DATABASE
TAKEN AT 20020331234427 INTO wsdb REPLACE EXISTING db2_all <<+2< db2 RESTORE DATABASE wsdb FROM /dev3/backup TAKEN AT 20020331234828 INTO wsdb REPLACE EXISTING db2_all <<+3< db2 RESTORE DATABASE wsdb FROM /dev3/backup TAKEN AT 20020331235235 INTO wsdb REPLACE EXISTING
El programa de utilidad db2_all emite el mandato de restauracin a cada una de las particiones de base de datos especificadas. A continuacin se proporciona un escenario tpico de restauracin redirigida para una base de datos cuyo alias es MYDB: 1. Emita un mandato RESTORE DATABASE con la opcin REDIRECT.
db2 restore db mydb replace existing redirect
Despus de que se haya completado satisfactoriamente el paso 1, y antes de completarse el paso 3, se puede terminar anormalmente la restauracin emitiendo:
db2 restore db mydb abort
2. Emita un mandato SET TABLESPACE CONTAINERS para cada espacio de tabla cuyos contenedores deban redefinirse. Por ejemplo:
db2 set tablespace containers for 5 using (file f:\ts3con1 20000, file f:\ts3con2 20000)
Para verificar que los contenedores de la base de datos restaurada son los especificados en este paso, emita el mandato LIST TABLESPACE CONTAINERS. 3. Despus de que los pasos 1 y 2 se hayan completado satisfactoriamente, emita:
db2 restore db mydb continue
Es el paso final de la operacin de restauracin redirigida. 4. Si falla el paso 3, o si se ha terminado anormalmente la operacin de restauracin, la restauracin redirigida se puede reiniciar, empezando en el paso 1. A continuacin se proporciona un ejemplo de estrategia de copia de seguridad incremental semanal para una base de datos recuperable. Incluye una operacin de copia de seguridad de base de datos completa semanal, una operacin de copia de seguridad no acumulativa (delta) diaria y una operacin de copia de seguridad acumulativa (incremental) de mitad de semana:
644
Command Reference
RESTORE DATABASE
(Dom) (Lun) (Mar) (Mi) (Jue) (Vie) (Sb) backup backup backup backup backup backup backup db db db db db db db mydb mydb mydb mydb mydb mydb mydb use tsm online incremental online incremental online incremental online incremental online incremental online incremental delta use delta use use tsm delta use delta use use tsm tsm tsm tsm tsm
Para una restauracin de base de datos automtica de las imgenes creadas el viernes por la maana, emita:
restore db mydb incremental automatic taken at (Vie)
Para una restauracin de base de datos manual de las imgenes creadas el viernes por la maana, emita:
restore restore restore restore restore db db db db db mydb mydb mydb mydb mydb incremental incremental incremental incremental incremental taken taken taken taken taken at at at at at (Vie) (Dom) (Mi) (Jue) (Vie)
Notas de uso: Cualquier mandato RESTORE DATABASE con el formato db2 restore db <nombre> realizar una restauracin de base de datos completa, sin tener en cuenta si la imagen que se est restaurando es una imagen de base de datos o una imagen de espacio de tabla. Cualquier mandato RESTORE DATABASE con el formato db2 restore db <nombre> tablespace realizar una restauracin de espacio de tabla de los espacios de tabla que se encuentren en la imagen. Cualquier mandato RESTORE DATABASE en el que se proporcione una lista de espacios de tabla realizar una restauracin de los espacios de tabla que se listen explcitamente. A continuacin de la restauracin de la copia de seguridad en lnea, debe realizar un recuperacin en avance. Informacin relacionada: v Mandato BACKUP DATABASE en la pgina 216 v Mandato ROLLFORWARD DATABASE en la pgina 647 v db2move - Mandato Herramienta de movimiento de base de datos en la pgina 110
645
REWIND TAPE Mandato REWIND TAPE

Al ejecutarse en sistemas operativos basados en Windows NT, DB2 da soporte a las operaciones de copia de seguridad y restauracin en dispositivos de cinta de modalidad continua. Utilice este mandato para el rebobinado de la cinta. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
REWIND TAPE ON dispositivo
Parmetros del mandato: ON dispositivo Especifica un nombre de dispositivo de cinta vlido. El valor por omisin es \\.\TAPE0. Informacin relacionada: v Mandato INITIALIZE TAPE en la pgina 425 v Mandato SET TAPE POSITION en la pgina 678
646
Command Reference
ROLLFORWARD DATABASE Mandato ROLLFORWARD DATABASE

Recupera una base de datos aplicando las transacciones registradas en los archivos de anotaciones cronolgicas de base de datos. Se invoca despus de haber restaurado una base de datos o una imagen de copia de seguridad de espacio de tabla, o si la base de datos ha dejado fuera de lnea algn espacio de tabla debido a un error de soporte de almacenamiento. La base de datos debe ser recuperable (es decir, tienen que haberse habilitado los parmetros de configuracin de base de datos logretain y/o userexit) para poder recuperar en avance la base de datos. mbito: En un entorno de base de datos particionado, este mandato slo puede invocarse desde la particin de catlogo. Una operacin de avance de base de datos o de espacio de tabla hasta un punto horario especificado afecta a todas las particiones que se listan en el archivo db2nodes.cfg. Una operacin de avance de base de datos o de espacio de tabla hasta el final de las anotaciones cronolgicas afecta a las particiones que se hayan especificado. Si no se ha especificado ninguna particin, afecta a todas las particiones listadas en el archivo db2nodes.cfg; si la recuperacin en avance no es necesaria en una particin determinada, dicha particin se pasar por alto. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna. Este mandato establece una conexin de base de datos. Sintaxis del mandato:
ROLLFORWARD DATABASE DB alias-basedatos USER nombreusuario USING contrasea
647
ROLLFORWARD DATABASE
TO horaiso
USING LOCAL TIME ON ALL DBPARTITIONNUMS AND COMPLETE END OF LOGS AND STOP Clusula En particin de base de datos COMPLETE STOP Clusula En particin de base de datos CANCEL QUERY STATUS USING LOCAL TIME TABLESPACE ONLINE , ( nombre-espaciotabla ) ONLINE OVERFLOW LOG PATH ( directorio-anotcron , NORETRIEVE Clusula Desbordamiento anot. cronol. )
RECOVER DROPPED TABLE id-tabla-eliminada TO directorio-exportacin
Clusula En particin de base de datos:

ON Clusula En lista de particiones de base de datos ALL DBPARTITIONNUMS EXCEPT Clusula En lista de particiones de base de datos
Clusula En lista de particiones de base de datos:

, DBPARTITIONNUM DBPARTITIONNUMS ) ( nmero1-particin-bd TO nmero2-particin-bd
Clusula Desbordamiento anot. cronol.:

, directorio-anotcron ON DBPARTITIONNUM nmero1-particin-bd
Parmetros del mandato: DATABASE alias-base-datos Alias de la base de datos que debe recuperarse en avance. USER nombreusuario Nombre de usuario bajo el cual la base de datos debe recuperarse en avance.
648
Command Reference
USING contrasea Contrasea utilizada para autentificar el nombre de usuario. Si se omite la contrasea, se solicitar al usuario que la entre. TO horaiso Punto horario en el que deben recuperarse en avance todas las transacciones comprometidas (incluida la transaccin comprometida precisamente en ese momento, as como todas las transacciones comprometidas anteriormente). Este valor se especifica como indicacin de fecha y hora, una serie de caracteres de 7 partes que identifica una fecha y hora combinadas, El formato es aaaa-mm-dd-hh.mm.ss.nnnnnn (ao, mes, da, hora, minutos, segundos, microsegundos), expresado en Hora universal coordinada (UTC). UTC ayuda a evitar que la misma indicacin de fecha y hora est asociada con distintas anotaciones cronolgicas (debido a un cambio de horario asociado con el horario de verano, por ejemplo). La indicacin de fecha y hora en una imagen de copia de seguridad se base en la hora local en la que se ha iniciado la operacin de copia de seguridad. El registro especial CURRENT TIMEZONE especifica la diferencia entre UTC y la hora local en el servidor de la aplicacin. La diferencia se representa mediante una duracin (un nmero decimal en el cual los dos primeros dgitos representan el nmero de horas, los dos dgitos siguientes representan el nmero de minutos y los dos ltimos dgitos representan el nmero de segundos). La resta entre CURRENT TIMEZONE y una hora local convierte la hora local en UTC. USING LOCAL TIME Permite al usuario el avance hasta un punto horario que es la hora local del usuario en vez de la hora GMT. Esto facilita a los usuarios el avance hasta un punto horario especfico en sus mquinas locales y elimina potenciales errores de usuario causados por la conversin de la hora local a la hora GMT. Notas: 1. Si el usuario especifica una hora local para el avance, todos los mensajes devueltos al usuario estarn tambin en la hora local. Tenga en cuenta que todas las horas se convertirn en el servidor, y si es MPP, en la particin de base de datos de catlogo. 2. La serie de indicacin de la hora se convierte a GMT en el servidor, de manera que la hora es local para la zona horaria del servidor, no del cliente. Si el cliente est en una
649
zona horaria y el servidor en otra, debe utilizarse la hora local del servidor. Esto es diferente de la opcin de la hora local del Centro de control, que es local para el cliente. 3. Si la serie de indicacin de la hora est prxima al cambio de hora del reloj a causa del horario de verano, es importante saber si la hora de detencin es anterior o posterior al cambio de hora y especificarlo correctamente. END OF LOGS Especifica que deben aplicarse todas las transacciones comprometidas de todos los archivos de anotaciones cronolgicas de archivador en lnea que se listan en el parmetro de configuracin de base de datos logpath. ALL DBPARTITIONNUMS Especifica que las transacciones deben avanzar en todas las particiones especificadas en el archivo db2nodes.cfg. ste es el valor por omisin si no se especifica una clusula de particin de base de datos. EXCEPT Especifica que las transacciones deben avanzar en todas las particiones especificadas en el archivo db2nodes.cfg, excepto las especificadas en la lista de particiones de base de datos. ON DBPARTITIONNUM / ON DBPARTITIONNUMS Avanzar la base de datos en un conjunto de particiones de base de datos. nmero1-particin-bd Especifica un nmero de particin de base de datos en la lista de particiones de base de datos. nmero2-particin-bd Especifica el segundo nmero de particin de base de datos, de manera que todas las particiones desde nmero1-particin-bd hasta nmero2-particin-bd inclusive se incluyen en la lista de particiones de base de datos. COMPLETE / STOP Detiene el avance de los registros de anotaciones cronolgicas y completa el proceso de recuperacin en avance retrotrayendo las transacciones incompletas y desactivando el estado de pendiente de recuperacin en avance de la base de datos. Esto permite el acceso a la base de datos o a los espacios de tabla que se estn avanzando. Estas palabras clave son equivalentes; especifique una u otra, pero no ambas. La palabra clave AND permite la especificacin de varias operaciones a la vez; por ejemplo, db2 rollforward db sample to end of logs and complete.
650
Command Reference
Nota: Cuando se avanzan espacios de tabla hasta un punto horario, los espacios de tabla se pasan a estado de pendiente de copia de seguridad. CANCEL Cancela la operacin de recuperacin en avance. Esto deja la base de datos o uno o ms espacios de tabla de todas las particiones en los que se ha iniciado la recuperacin en avance en estado de pendiente de restauracin: v Si no est en proceso una operacin de avance de base de datos (es decir, la base de datos est en estado de pendiente de avance), esta opcin cambia la base de datos a estado de pendiente de restauracin. v Si no est en proceso una operacin de avance de espacio de tabla (es decir, los espacios de tabla estn en estado de pendiente de avance), debe especificarse una lista de espacios de tabla. Todos los espacios de tabla se cambian a estado de pendiente de restauracin. v Si est en proceso una operacin de avance de espacio de tabla (es decir, como mnimo un espacio de tabla est en estado de avance en proceso), todos los espacios de tabla que estn en estado de avance en proceso cambian a estado de pendiente de restauracin. Si se especifica una lista de espacios de tabla, debe incluir todos los espacios de tabla que estn en estado de avance en proceso. Todos los espacios de tabla de la lista se cambian a estado de pendiente de restauracin. v Si se avanza hasta un punto horario, se ignorar cualquier nombre de espacio de tabla pasado y todos los espacios de tabla que estn en estado de avance en proceso se cambian a estado de pendiente de restauracin. v Si se avanza hasta el final de las anotaciones cronolgicas con una lista de espacios de tabla, tan solo los espacios de tabla de la lista se cambian a estado de pendiente de restauracin. Esta opcin no se puede utilizar para cancelar una operacin de avance mientras se est ejecutando. Esta opcin slo se puede utilizar para cancelar una operacin de avance que est en proceso, pero que no se est ejecutando en ese momento. Una operacin de avance puede estar en proceso y no ejecutarse si: v Ha terminado anormalmente. v No se ha especificado la opcin STOP. v Un error ha causado que fallara. Algunos errores, como por ejemplo el avanzar en una operacin de carga no recuperable, pueden pasar un espacio de tabla a un estado de pendiente de restauracin.
651
Nota: Utilice esta opcin con precaucin y slo si la operacin de avance que est en proceso no se puede completar debido a que algunos de los espacios de tabla que se han cambiado a estado de pendiente de avance o a estado de pendiente de restauracin. Si tiene dudas, utilice el mandato LIST TABLESPACES para identificar los espacios de tabla que estn en estado de avance en proceso o en estado de pendiente de avance. QUERY STATUS Lista los archivos de anotaciones cronolgicas que el gestor de bases de datos ha avanzado, el siguiente archivo archivador y la indicacin de fecha y hora (en CUT) de la ltima transaccin comprometida desde que ha empezado el proceso de avance. En un entorno de base de datos particionado, esta informacin de estado se devuelve para cada particin. La informacin devuelta contiene los campos siguientes: Nmero de particin de base de datos Estado de avance El estado puede ser: pendiente de avance de base de datos o espacio de tabla, avance en proceso de base de datos o espacio de tabla, avance de base de datos o espacio de tabla procesando STOP o no pendiente. Siguiente archivo anotacin a leer Serie que contiene el nombre del siguiente archivo de anotaciones cronolgicas necesario. En un entorno de base de datos particionada, utilice esta informacin si el programa de utilidad rollforward falla con un cdigo de retorno que indica que falta un archivo de anotaciones cronolgicas o que se ha producido una discrepancia de informacin de anotacin cronolgica. Archivos de anotaciones procesados Serie que contiene los nombres de los archivos de anotaciones cronolgicas procesados que ya no se necesitan para la recuperacin y que se pueden eliminar del directorio. Si, por ejemplo, si la transaccin ms antigua no comprometida se inicia en el archivo de anotaciones cronolgicas x, el rango de archivos de anotaciones cronolgicas obsoletos no incluir x; el rango finaliza en x - 1. ltima transaccin comprometida Serie que contiene una indicacin de fecha y hora en formato ISO (aaaa-mm-dd-hh.mm.ss). Esta indicacin de fecha y hora marca la ltima transaccin comprometida despus de la finalizacin de la recuperacin en avance. La indicacin de
652
Command Reference
fecha y hora se aplica a la base de datos. Para la recuperacin en avance de espacios de tabla, es la indicacin de fecha y hora de la ltima transaccin comprometida en la base de datos. Nota: QUERY STATUS es el valor por omisin si se omiten las clusulas TO, STOP, COMPLETE o CANCEL. Si se especifica TO, STOP o COMPLETE, esta informacin de estado se visualizar si el mandato se ha completado satisfactoriamente. Si se han especificado espacios de tabla individuales, se ignoran; la peticin de estado no se aplica nicamente a los espacios de tabla especificados. TABLESPACE Esta palabra clave se especifica para la recuperacin en avance de nivel de espacio de tabla. nombre-espaciotabla Obligatorio para la recuperacin en avance de nivel de espacio de tabla a un punto horario. Permite especificar un subconjunto de espacios de tabla para una recuperacin en avance hasta el final de las anotaciones cronolgicas. En un entorno de base de datos particionado, cada espacio de tabla de la lista no tiene que existir en cada particin que se est avanzando. Si existe, debe estar en el estado correcto. ONLINE Esta palabra clave se especifica para permitir que la recuperacin en avance de nivel de espacio de tabla se realice en lnea. Esto significa que se permite a otros agentes conectarse mientras la recuperacin en avance est en proceso. OVERFLOW LOG PATH directorio-anotcron Especifica una va de acceso de anotaciones cronolgicas alternativa en la que se deben buscar las anotaciones cronolgicas archivadas durante la recuperacin. Utilice este parmetro si se han movido archivos de anotaciones cronolgicas a una ubicacin distinta de la que se especifica en el parmetro de configuracin de base de datos logpath. En un entorno de base de datos particionado, es la va de acceso de anotacin cronolgica de desbordamiento por omisin (completamente calificada) para todas las particiones. Se puede especificar una va de acceso de anotacin cronolgica de desbordamiento relativa para bases de datos de una sola particin. Nota: El parmetro de mandato OVERFLOW LOG PATH grabar encima del valor (si hay alguno) del parmetro de configuracin de base de datos OVERFLOWLOGPATH.
653
directorio-anotcron ON DBPARTITIONNUM En un entorno de base de datos particionado, permite que una va de acceso de anotacin cronolgica diferente altere temporalmente la va de acceso de anotacin cronolgica de desbordamiento por omisin para una particin especfica. NORETRIEVE Permite al usuario controlar qu archivos de anotaciones cronolgicas se avanzarn en la mquina de reserva, al permitir que el usuario inhabilite la recuperacin de las anotaciones cronolgicas archivadas. Las ventajas de esta accin son las siguientes: v Al controlar el avance de los archivos de anotaciones cronolgicas, puede asegurarse que la mquina de reserva estar X horas por detrs de la mquina de produccin, para evitar que el usuario afecte a ambos sistemas. v Si el sistema de reserva no tiene acceso al archivo archivador (por ejemplo, si TSM es el archivo archivador, slo permite a la mquina original recuperar los archivos) v Tambin cabe la posibilidad de que, mientras el sistema de produccin est archivando un archivo, el sistema de reserva est recuperando ese mismo archivo y, en tal caso, se podra obtener un archivo de anotaciones cronolgicas incompleto. Noretrieve debera solucionar este problema. RECOVER DROPPED TABLE id-tabla-eliminada Recupera una tabla eliminada durante la operacin de recuperacin en avance. El ID de tabla puede obtenerse utilizando el mandato LIST HISTORY. TO directorio-exportacin Especifica un directorio en el que deben grabarse los archivos que contienen los datos de tabla. El directorio debe ser accesible a todas las particiones de base de datos. Ejemplos: Ejemplo 1 El mandato ROLLFORWARD DATABASE permite especificar varias operaciones a la vez, cada una de ellas separada mediante la palabra clave AND. Por ejemplo, para realizar la recuperacin en avance hasta el final de las anotaciones cronolgicas y completa, los mandatos independientes:
db2 rollforward db sample to end of logs db2 rollforward db sample complete
pueden combinarse del modo siguiente:

db2 rollforward db sample to end of logs and complete
654
Command Reference
Aunque los dos son equivalentes, se recomienda que estas operaciones se realicen en dos pasos. Es importante verificar que la operacin en avance haya progresado tal como se esperaba, antes de detenerla y posiblemente saltarse anotaciones cronolgicas. Esto es especialmente importante si se encuentra una anotacin cronolgica anmala durante la recuperacin en avance y esta anotacin cronolgica anmala se interpreta como el final de las anotaciones cronolgicas. En estos casos, puede utilizarse una copia de seguridad no daada de dicha anotacin cronolgica para continuar la operacin en avance a travs de ms anotaciones cronolgicas. Ejemplo 2 Avanzar hasta el final de las anotaciones cronolgicas (se han restaurado dos espacios de tabla):
db2 rollforward db sample to end of logs db2 rollforward db sample to end of logs and stop
Estas dos sentencias son equivalentes. No se necesita ni AND STOP ni AND COMPLETE para la recuperacin en avance de espacio de tabla hasta el final de las anotaciones cronolgicas. Los nombres de espacios de tabla no son necesarios. Si no se especifican, se incluirn todos los espacios de tabla que necesiten recuperacin en avance. Si slo debe recuperarse en avance un subconjunto de estos espacios de tabla, es necesario especificar sus nombres. Ejemplo 3 Despus de que se hayan restaurado tres espacios de tabla, avance uno hasta el final de las anotaciones cronolgicas y los otros dos hasta un punto horario, realizando ambas operaciones en lnea:
db2 rollforward db sample to end of logs tablespace(TBS1) online db2 rollforward db sample to 1998-04-03-14.21.56.245378 and stop tablespace(TBS2, TBS3) online
Tenga en cuenta que las dos operaciones de avance no se pueden ejecutar simultneamente. El segundo mandato slo se puede emitir despus de que la primera operacin de avance se haya completado satisfactoriamente. Ejemplo 4 Despus de restaurar la base de datos, recuperar en avance en un punto horario, utilizando OVERFLOW LOG PATH para especificar el directorio donde la salida de usuario guarda las anotaciones cronolgicas archivadas:
db2 rollforward db sample to 1998-04-03-14.21.56.245378 and stop overflow log path (/logs)
655
Ejemplo 5 (MPP) Hay tres particiones de base de datos: 0, 1 y 2. El espacio de tabla TBS1 est definido en todas las particiones y el espacio de tabla TBS2 est definido en las particiones 0 y 2. Despus de restaurar la base de datos en la particin de base de datos 1 y TBS1 en las particiones de base de datos 0 y 2, avance la base de datos en la particin de base de datos 1:
db2 rollforward db sample to end of logs and stop
Esto devuelve el aviso SQL1271 (La base de datos se ha recuperado, pero uno o ms espacios de tabla estn fuera de lnea en la(s) particin(es) de base de datos 0 y 2.).
db2 rollforward db sample to end of logs
Esto avanza TBS1 en las particiones de base de datos 0 y 2. En este caso, la clusula TABLESPACE(TBS1) es opcional. Ejemplo 6 (MPP) Despus de restaurar el espacio de tabla TBS1 solamente en las particiones de base de datos 0 y 2, avance TBS1 en las particiones de base de datos 0 y 2:
db2 rollforward db sample to end of logs
La particin de base de datos 1 se pasa por alto.

db2 rollforward db sample to end of logs tablespace(TBS1)
Esto falla porque TBS1 no est preparado para la recuperacin en avance en la particin de base de datos 1. Devuelve el mensaje SQL4906N.
db2 rollforward db sample to end of logs on dbpartitionnums (0, 2) tablespace(TBS1)
Esto se realiza satisfactoriamente.

db2 rollforward db sample to 1998-04-03-14.21.56.245378 and stop tablespace(TBS1)
Esto falla porque TBS1 no est preparado para la recuperacin en avance en la particin de base de datos 1; todas las partes se deben avanzar juntas. Nota: Con el avance de espacio de tabla a un punto horario, no se acepta la clusula de particin de base de datos. La operacin de avance debe tener lugar en todas las particiones de base de datos en las que reside el espacio de tabla. Despus de restaurar TBS1 en la particin de base de datos 1:
656
Command Reference
db2 rollforward db sample to 1998-04-03-14.21.56.245378 and stop tablespace(TBS1)
Esto se realiza satisfactoriamente. Ejemplo 7 (entorno de base de datos particionado) Despus de restaurar un espacio de tabla en todas las particiones de base de datos, avanzar hasta PIT2, pero no especificar AND STOP. La operacin de avance todava est en proceso. Cancelar y recuperar en avance hasta PIT1:
db2 rollforward db sample to pit2 tablespace(TBS1) db2 rollforward db sample cancel tablespace(TBS1) ** restaurar TBS1 en todas las particiones de base de datos ** db2 rollforward db sample to pit1 tablespace(TBS1) db2 rollforward db sample stop tablespace(TBS1)
Ejemplo 8 (MPP) Recuperar en avance un espacio de tabla que reside en ocho particiones de base de datos (3 a 10) listadas en el archivo db2nodes.cfg:
db2 rollforward database dwtest to end of logs tablespace (tssprodt)
Esta operacin hasta el final de las anotaciones cronolgicas (no en un punto horario) se realiza satisfactoriamente. No es necesario especifiar las particiones de base de datos en las que reside el espacio de tabla. El programa de utilidad toma por omisin el archivo db2nodes.cfg. Ejemplo 9 (entorno de base de datos particionado) Recuperar en avance seis espacios de tabla pequeos que residen en un grupo de particiones de base de datos de una sola particin (en la particin de base de datos 6):
db2 rollforward database dwtest to end of logs on dbpartitionnum (6) tablespace(tsstore, tssbuyer, tsstime, tsswhse, tsslscat, tssvendor)
Esta operacin hasta el final de las anotaciones cronolgicas (no en un punto horario) se realiza satisfactoriamente. Notas de uso: Si se restaura desde una imagen que se ha creado durante una operacin de copia de seguridad en lnea, el punto horario especificado para la operacin de avance debe ser posterior a la hora en que ha finalizado la operacin de copia de seguridad en lnea. Si la operacin de avance se detiene antes de
657
llegar a este punto, la base de datos queda en estado de pendiente de avance. Si un espacio de tabla est en proceso de avance, queda en estado de avance en proceso. Si uno o ms espacios de tabla se estn avanzando hasta un punto horario, la operacin de avance debe continuar como mnimo hasta el tiempo mnimo de recuperacin, que es la ltima actualizacin a los catlogos del sistema para este espacio de tabla o sus tablas. El tiempo mnimo de recuperacin (en Hora Universal Coordinada o UTC) para un espacio de tabla puede recuperarse utilizando el mandato LIST TABLESPACES SHOW DETAIL. Puede que la recuperacin en avance de bases de datos requiera una recuperacin de carga utilizando dispositivos de cinta. Si se solicita otra cinta, el usuario puede responder con alguna de las opciones siguientes: c Continuar. Continuar utilizando el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando se ha montado una cinta nueva) Terminacin de dispositivo. Dejar de utilizar el dispositivo que ha generado el mensaje de aviso (por ejemplo, cuando no hay ms cintas) Terminar. Terminar todos los dispositivos.
d t
Si el programa de utilidad rollforward no encuentra la siguiente anotacin cronolgica que necesita, el nombre de anotacin cronolgica se devuelve en SQLCA y la recuperacin en avance se detiene. Si no hay disponibles ms anotaciones cronolgicas, utilice la opcin STOP para terminar la recuperacin en avance. Las transacciones incompletas se retrotraen para asegurarse de que la base de datos o el espacio de tabla queda en un estado coherente. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. v La palabra clave NODES puede sustituirse por DBPARTITIONNUMS. Informacin relacionada: v Mandato BACKUP DATABASE en la pgina 216 v Mandato RESTORE DATABASE en la pgina 636
658
Command Reference
RUNSTATS Mandato RUNSTATS

Actualiza las estadsticas acerca de las caractersticas fsicas de una tabla y de los ndices asociados. Estas caractersticas incluyen el nmeros de registros, el nmero de pginas y el promedio de longitud de registro. El optimizador utiliza estas estadsticas al determinar las vas de acceso a los datos. Este programa de utilidad deber llamarse cuando se hayan hecho muchas actualizaciones a una tabla o despus de reorganizar una tabla. mbito: Este mandato puede emitirse desde cualquier particin de base de datos del archivo db2nodes.cfg. Puede utilizarse para actualizar los catlogos en la particin de base de datos de catlogo. El mandato rene estadsticas para una tabla en la particin de base de datos desde la que se invoca. Si la tabla no existe en esa particin de base de datos, se selecciona la primera particin de base de datos del grupo de particiones de base de datos. Autorizacin: Una de las siguientes: v v v v v v sysadm sysctrl sysmaint dbadm Privilegio CONTROL en la tabla Autorizacin LOAD
Un usuario no necesita ningn privilegio explcito para utilizar este mandato en ninguna tabla temporal global declarada que exista en su conexin. Conexin necesaria: Base de datos Sintaxis del mandato:
RUNSTATS ON TABLE nombre tabla Opciones de objeto de tabla
659
RUNSTATS
ALLOW WRITE ACCESS ALLOW READ ACCESS
Opciones de objeto de tabla:

FOR clusula-ndice Clusula estadist. columna AND Clusula-ndice
Clusula de ndice:
, INDEXES INDEX nombre ndice ALL
DETAILED SAMPLED
Clusula de estadsticas de columna:

ON ON Clusula de Cols Clusula de distribucin Clusula de Cols
Clusula de distribucin:
WITH DISTRIBUTION Clusula En Cols Dist
Opciones Dist por omisin
Clusula En cols:
ON ALL COLUMNS , ON ALL COLUMNS AND KEY ON KEY COLUMNS COLUMNS ( Opcin de columna )
660
Command Reference
RUNSTATS
Clusula En Cols Dist:
ON ALL COLUMNS , ON ALL COLUMNS AND KEY ON KEY COLUMNS COLUMNS ( Opcin de columna Opcin de frecuencia Opcin de cuantil )
Opcin de Dist por omisin:
DEFAULT
Opcin de frecuencia Opcin de cuantil
Opcin de frecuencia:
NUM_FREQVALUES entero
Opcin de cuantil:
NUM_QUANTILES entero
Opcin de columna:
nombre columna LIKE STATISTICS , ( nombre columna )
Parmetros del mandato: nombre-tabla Identifica la tabla en la que se deben reunir las estadsticas. Debe ser una tabla descrita en el catlogo y no debe ser una vista ni una tabla de Jerarqua. Para las tablas de tipo, nombre-tabla debe ser el nombre de la tabla raz de la jerarqua de tablas. Debe utilizarse el nombre totalmente calificado o el alias con el formato: esquema.nombre-tabla. El esquema es el nombre de usuario con el que se ha creado la tabla. nombre-ndice Identifica un ndice existente definido en la tabla. Debe utilizarse el nombre totalmente calificado con el formato: esquema.nombre-ndice. FOR INDEXES Rene y actualiza las estadsticas nicamente para los ndices. Si en la tabla no se han recogido previamente estadsticas de tabla, tambin se
661
RUNSTATS
renen las estadsticas bsicas de tabla. Estas estadsticas bsicas no incluyen ninguna estadstica de distribucin. AND INDEXES Rene y actualiza las estadsticas para la tabla y para los ndices. DETAILED Calcula las estadsticas de ndice ampliadas. Son las estadsticas CLUSTERFACTOR y PAGE_FETCH_PAIRS, que se renen para ndices relativamente grandes. SAMPLED Esta opcin, cuando se utiliza con la opcin DETAILED, permite que RUNSTATS use una tcnica de muestreo de CPU al compilar las estadsticas de ndice ampliadas. Si no se especifica la opcin, se examinar cada entrada del ndice para calcular las estadsticas de ndice ampliadas. ON ALL COLUMNS La recogida de estadsticas puede realizarse en algunas columnas, pero no en otras. Columnas tales como LONG VARCHAR o CLOB no son elegibles. Si se desea reunir estadsticas sobre todas las columnas elegibles, se puede utilizar la clusula ON ALL COLUMNS. Las columnas pueden especificarse para la coleccin de estadsticas bsicas (clusula-en-cols) o conjuntamente con la clusula WITH DISTRIBUTION (clusula-en-cols-dist). La especificacin ON ALL COLUMNS es la opcin por omisin si no se especifica ninguna de las clusulas especficas de columnas. Si se especifica en clusula-on-cols, slo se reunirn estadsticas de columna bsicas, a menos que se elijan columnas especficas como parte de la clusula WITH DISTRIBUTION. De estas columnas especificadas como parte de la clusula WITH DISTRIBUTION se reunirn tambin estadsticas bsicas y de distribucin. Si se especifica WITH DISTRIBUTION ON ALL COLUMNS, se renen estadsticas bsicas y de distribucin para todas las columnas elegibles. Cualquier dato que se especifique en clusula-en-cols es redundante y, por lo tanto, no es necesario. ON COLUMNS Esta clusula permite especificar al usuario una lista de columnas para la que se reunirn estadsticas. Si especifica un grupo de columnas, se reunir el nmero de valores diferenciados para el grupo. Se borrarn las estadsticas para las columnas que no se listen. Esta clusula puede utilizarse en clusula-en-cols y en clusula-en-cols-dist.
662
Command Reference
RUNSTATS
Nota: Actualmente la recogida de estadsticas de distribucin para un grupo de columnas no est soportada. ON KEY COLUMNS En lugar de listar columnas especficas, se puede elegir reunir estadsticas en columnas que componen todos los ndices definidos en la tabla. Se supone que las columnas crticas de las consultas tambin son las que se utilizan para crear ndices en la tabla. Si no hay ningn ndice en la tabla, es como si fuese una lista vaca y no se reunirn estadsticas de columna. Se pueden utilizar en clusula-en-cols o clusula-en-cols-dist. Es redundante en clusula-en-cols si se especifica en ambas clusulas, ya que se utiliza la clusula WITH DISTRIBUTION para especificar la coleccin de estadsticas bsicas y de distribucin. nombre-columna nombre-columna debe ser el nombre de una columna de la tabla. Si se especifica el nombre de una columna inelegible para la recogida de estadsticas, tal como una columna inexistente o un nombre de columna mal escrito, se devolver el error (-205). Se pueden especificar dos listas de columnas, una sin distribucin y una con distribucin. Si se especifica la columna en la lista que no est asociada a la clusula WITH DISTRIBUTION, slo se reunirn las estadsticas bsicas de columna. Si la columna aparece en ambas listas, se reunirn estadsticas de distribucin (a menos que NUM_FREQVALUES y NUM_QUANTILES se establezcan en el valor cero). NUM_FREQVALUES Define el nmero mximo de valores de frecuencia que se van a reunir. Se puede especificar para una columna individual en la clusula ON COLUMNS. Si el valor no se especifica para una columna individual, el valor de lmite de frecuencia se seleccionar del valor especificado en la clusula DEFAULT. Si all tampoco se especifica, el nmero mximo de valores de frecuencia que se han de reunir ser el establecido en el parmetro de configuracin de base de datos NUM_FREQVALUES. NUM_QUANTILES Define el nmero mximo de valores de cuantil de distribucin que se van a reunir. Se puede especificar para una columna individual en la clusula ON COLUMNS. Si el valor no se especifica para una columna individual, el valor de lmite de cuantil se tomar del valor especificado en la clusula DEFAULT. Si all tampoco se especifica, el nmero mximo de valores de cuantil que se han de reunir ser el establecido en el parmetro de configuracin de base de datos NUM_QUANTILES.
663
RUNSTATS
WITH DISTRIBUTION Esta clusula especifica que deben reunirse estadsticas tanto bsicas como de distribucin en las columnas. Si no se especifica la clusula ON COLUMNS, se renen estadsticas de distribucin en todas las columnas de la tabla (excluidas las columnas inelegibles, tales como CLOB y LONG VARCHAR). Si se especifica la clusula ON COLUMNS, slo se renen estadsticas de distribucin en la lista de columnas proporcionada (excluidas las inelegibles para la recogida de estadsticas). Si no se especifica la clusula, slo se reunirn estadsticas bsicas. Nota: Actualmente, la recogida de estadsticas de distribucin en grupos de columnas no est soportada; las estadsticas de distribucin no se reunirn cuando se especifiquen grupos de columnas en la clusula WITH DISTRIBUTION ON COLUMNS. DEFAULT Si se especifican los lmites DEFAULT NUM_FREQVALUES y/o NUM_QUANTILES, se utilizarn para determinar con qu frecuencia se intentar la recogida de estadsticas de frecuencia y/o de cuantil para las columnas, si stas no se han especificado para la columna individual de la clusula ON COLUMNS. Si no se ha especificado la clusula DEFAULT, los valores utilizados sern los de los parmetros de configuracin de base de datos correspondientes. LIKE STATISTICS Cuando se especifica esta opcin, se renen estadsticas de columna adicionales. Estas estadsticas son SUB_COUNT y SUB_DELIM_LENGTH de SYSSTAT.COLUMNS. Se renen slo para las columnas de serie y el optimizador de consulta las utiliza para mejorar las estimaciones de selectividad para predicados del tipo columna LIKE %xyz y columna LIKE %xyz% ALLOW WRITE ACCESS Especifica que otros usuarios pueden leer y grabar en la tabla mientras se estn calculando las estadsticas. ALLOW READ ACCESS Especifica que otros usuarios pueden tener acceso de slo lectura a la tabla mientras se estn calculando las estadsticas. Nota: En una base de datos particionada, el mandato RUNSTATS rene las estadsticas en un solo nodo. Si la particin de base de datos desde la que se ejecuta el mandato RUNSTATS tiene una particin de la tabla, el mandato se ejecutar en esa particin de base de datos. De lo contrario,
664
Command Reference
RUNSTATS
el mandato se ejecutar en la primera particin de base de datos del grupo de las particiones de base de datos entre las que est particionada la tabla. Notas de uso: Notas: 1. Se recomienda la ejecucin del mandato RUNSTATS: v En aquellas tablas que se han modificado de forma considerable (por ejemplo, si se ha realizado un gran nmero de actualizaciones, si se ha insertado o suprimido una cantidad significativa de datos, o si se ha realizado LOAD sin la opcin de estadsticas durante LOAD) v En las tablas que se han reorganizado (utilizando REORG, REDISTRIBUTE DATABASE PARTITION GROUP) v Cuando se ha creado un ndice nuevo. v Antes de vincular aplicaciones cuyo rendimiento sea importante. v Al cambiar la cantidad de captacin previa 2. Las opciones elegidas deben depender de la tabla y la aplicacin especficas. En general: v Sin la tabla es muy importante en las consultas importantes, es relativamente pequea o no cambia demasiado y no hay mucha actividad en el propio sistema, puede que valga la pena el esfuerzo de reunir estadsticas con la mayor cantidad posible de detalles. v Si el tiempo para reunir estadsticas est limitado, la tabla es relativamente grande y/o cambia mucho, puede ser preferible la ejecucin de RUNSTATS limitada al conjunto de las columnas que se utilizan en los predicados. De esta manera, se podr ejecutar ms a menudo el mandato RUNSTATS. v Si el tiempo para reunir estadsticas es muy limitado y el esfuerzo de adaptar el mandato RUNSTATS en una tabla segn la base de la tabla es un problema importante, estudie la posibilidad de reunir estadsticas slo para las columnas KEY. Se supone que el ndice contiene el conjunto de columnas importantes para la tabla y es ms probable que aparezca en predicados. v Si hay muchos ndices en la tabla y la informacin DETAILED (ampliada) en los ndices puede mejorar los planes de acceso, estudie la opcin SAMPLED para reducir el tiempo necesario para reunir estadsticas. Independientemente de si se utiliza o no la opcin SAMPLED, se necesita tiempo para reunir estadsticas detalladas sobre los ndices. No rena estas estadsticas a menos que est seguro de que sern tiles para las consultas.
665
RUNSTATS
v Si hay alguna desviacin en ciertas columnas y predicados del tipo columna = constante, puede ser preferible especificar un valor mayor de NUM_FREQVALUES para esa columna v Rena estadsticas de distribucin para todas las columnas que se utilizan en predicados de igualdad y para las que puede haber una desviacin en la distribucin de los valores. v Para las columnas que tienen predicados de rango (por ejemplo columna >= constante, columna BETWEEN constante1 AND constante2) o del tipo columna LIKE %xyz, puede ser preferible especificar un valor mayor de NUM_QUANTILES. v Si el espacio de almacenamiento es motivo de preocupacin y no puede disponer de mucho tiempo para reunir las estadsticas, no especifique valores elevados de NUM_FREQVALUES o NUM_QUANTILES para las columnas que no se utilicen en predicados. v Tenga en cuenta que, si se solicitan estadsticas de ndice, y no se han ejecutado nunca estadsticas en la tabla que contiene el ndice, se calculan las estadsticas tanto en la tabla como en los ndices. 3. Despus de haber ejecutado el mandato, tenga en cuenta lo siguiente: v Debe emitirse un COMMIT para liberar los bloqueos. v Para permitir que se generen planes de acceso nuevos, los paquetes que hacen referencia a la tabla de destino deben volverse a vincular. v La ejecucin del mandato en partes de la tabla puede producir incoherencias como resultado de la actividad en la tabla desde que se emiti el mandato por ltima vez. En este caso, se devuelve un mensaje de aviso. Emitir RUNSTATS en la tabla slo puede hacer que las estadsticas a nivel de tabla y de ndice sean incoherentes. Por ejemplo, podra reunir estadsticas a nivel de ndice en una tabla y, posteriormente, suprimir un nmero significativo de filas de la tabla. Si, a continuacin, slo emite RUNSTATS en la tabla, la cardinalidad de la tabla puede ser menor que FIRSTKEYCARD, lo que es una incoherencia. De la misma manera, si rene estadsticas en un ndice nuevo al crearlo, las estadsticas a nivel de tabla pueden ser incoherentes. 4. En la clusula En cols dist de la sintaxis del mandato, los parmetros Opcin de frecuencia y Opcin de cuantil no estn soportados actualmente para grupos (GROUPS) de columnas. Estas opciones estn soportadas para columnas individuales. Ejemplos: Reunir estadsticas slo sobre la tabla, sobre todas las columnas sin estadsticas de distribucin:
RUNSTATS ON TABLE db2user.employee
666
Command Reference
RUNSTATS
Reunir estadsticas slo sobre la tabla, en las columnas empid y empname con estadsticas de distribucin:
RUNSTATS ON TABLE db2user.employee WITH DISTRIBUTION ON COLUMNS (empid, empname)
Reunir estadsticas slo sobre la tabla, sobre todas las columnas con estadsticas de distribucin que utilizan un nmero especfico de lmite de frecuencias para la tabla mientras se selecciona NUM_QUANTILES del valor de configuracin:
RUNSTATS ON TABLE db2user.employee WITH DISTRIBUTION DEFAULT NUM_FREQVALUES 50
Reunir estadsticas en un conjunto de ndices:

RUNSTATS ON TABLE db2user.employee for indexes db2user.empl1, db2user empl2
Reunir slo estadsticas bsicas sobre todos los ndices:

RUNSTATS ON TABLE db2user.employee FOR INDEXES ALL
Rena estadsticas bsicas sobre la tabla y todos los ndices utilizando muestras para la recogida de estadsticas de ndice detalladas:
RUNSTATS ON TABLE db2user.employee AND SAMPLED DETAILED INDEXES ALL
Reunir estadsticas sobre la tabla, con estadsticas de distribucin en las columnas empid, empname y empdept y los dos ndices Xempid y Xempname: Los lmites de las estadsticas de distribucin se establecen de forma individual para empdept, mientras que las otras dos columnas utilizan un valor por omisin comn:
RUNSTATS ON TABLE db2user.employee WITH DISTRIBUTION ON COLUMNS (empid, empname, empdept NUM_FREQVALUES 50 NUM_QUANTILES 100) DEFAULT NUM_FREQVALUES 5 NUM_QUANTILES 10 AND INDEXES Xempid, Xempname
Reunir estadsticas sobre todas las columnas utilizadas en ndices y sobre todos los ndices:
RUNSTATS ON TABLE db2user.employee ON KEY COLUMNS AND INDEXES ALL
Reunir estadsticas sobre todos los ndices y todas las columnas sin distribucin, salvo una columna. Supongamos que T1 contiene las columnas c1, c2, ...., c8
RUNSTATS ON TABLE db2user.T1 WITH DISTRIBUTION ON COLUMNS (c1, c2, c3 NUM_FREQVALUES 20 NUM_QUANTILES 40, c4, c5, c6, c7, c8) DEFAULT NUM_FREQVALUES 0, NUM_QUANTILES 0 AND INDEXES ALL
667
RUNSTATS
RUNSTATS ON TABLE db2user.T1 WITH DISTRIBUTION ON COLUMNS (c3 NUM_FREQVALUES 20 NUM_QUANTILES 40) AND INDEXES ALL
Reunir estadsticas sobre la tabla T1 para las columnas individuales c1 y c5, as como sobre las combinaciones de columnas (c2, c3) y (c2, c4). La cardinalidad de mltiples columnas es muy til para el optimizador de consultas cuando hace una estimacin de los factores de filtro para predicados en las columnas en que se correlacionan los datos.
RUNSTATS ON TABLE db2user.T1 ON COLUMNS (c1, (c2, c3), (c2, c4), c5)
Reunir estadsticas sobre la tabla T1 para las columnas individuales c1 y c2. Para la columna c1, rena tambin las estadsticas de predicado LIKE.
RUNSTATS ON TABLE db2user.T1 ON COLUMNS (c1 LIKE STATISTICS, c2)
668
Command Reference
SET CLIENT Mandato SET CLIENT

Especifica valores de conexin para el proceso de fondo. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
SET CLIENT CONNECT 1 2 DISCONNECT EXPLICIT CONDITIONAL AUTOMATIC
MAX_NETBIOS_CONNECTIONS
valor
SQLRULES
DB2 STD
SYNCPOINT
ONEPHASE TWOPHASE NONE
CONNECT_DBPARTITIONNUM
nmero-particin-bd CATALOG_DBPARTITIONNUM
ATTACH_DBPARTITIONNUM
nmero-particin-bd
Parmetros del mandato: CONNECT 1 2 Especifica que una sentencia CONNECT debe procesarse como un CONNECT de tipo 1. Especifica que una sentencia CONNECT debe procesarse como un CONNECT de tipo 2.
669
SET CLIENT
DISCONNECT EXPLICIT Especifica que slo las conexiones de base de datos que la sentencia RELEASE ha marcado explcitamente para liberarse deben desconectarse al comprometerse. CONDITIONAL Especifica que las conexiones de base de datos que se han marcado RELEASE o que no tienen cursores WITH HOLD abiertos deben desconectarse al comprometerse. AUTOMATIC Especifica que todas las conexiones de base de datos deben desconectarse al comprometerse. MAX_NETBIOS_CONNECTIONS valor Especifica el nmero mximo de conexiones simultneas que se pueden realizar en una aplicacin utilizando un adaptador NetBIOS. El valor mximo es 254. Este parmetro debe establecerse antes de que se efecte la primera conexin NetBIOS. Se ignoran los cambios posteriores a la primera conexin. SQLRULES DB2 STD Especifica que un CONNECT de tipo 2 debe procesarse de acuerdo con las normas de DB2. Especifica que un CONNECT de tipo 2 debe procesarse de acuerdo con las normas Estndares (STD) basadas en ISO/ANS SQL92.
SYNCPOINT Especifica el modo en que se van a coordinar las operaciones de compromiso o retrotraccin en las conexiones de mltiples bases de datos. ONEPHASE Especifica que no se ha de utilizar ningn gestor de transacciones (TM) para realizar un compromiso de dos fases. Se deber utilizar un compromiso de una fase para comprometer el trabajo efectuado por cada base de datos en las transacciones de mltiples bases de datos. TWOPHASE Especifica que se necesita el TM para coordinar los compromisos de dos fases entre las bases de datos que soportan este protocolo. NONE Especifica que no se debe utilizar ningn TM para realizar un
670
Command Reference
SET CLIENT
compromiso de dos fases y no impone ningn actualizador nico, lector mltiple. Se enva un COMMIT a cada base de datos participante. La aplicacin es responsable de la recuperacin si falla alguno de los compromisos. CONNECT_DBPARTITIONNUM (slo entorno de bases de datos particionado) nmero-particin-bd Especifica la particin de base de datos en el que se debe realizar una conexin. Un valor entre cero y 999, inclusive. Altera temporalmente el valor de la variable de entorno DB2NODE. CATALOG_DBPARTITIONNUM La especificacin de este valor permite al cliente conectarse a la particin de base de datos de catlogo de la base de datos sin conocer la identidad de esa particin de base de datos en avance. ATTACH_DBPARTITIONNUM nmero-particin-bd (slo entorno de bases de datos particionado) Especifica la particin de base de datos en el que se debe realizar una conexin. Un valor entre cero y 999, inclusive. Altera temporalmente el valor de la variable de entorno DB2NODE. Por ejemplo, si se han definido las particiones de base de datos 1, 2 y 3, el cliente slo necesita poder acceder a una de estas particiones de base de datos. Si slo se ha catalogado la particin de base de datos 1 que contiene bases de datos y se establece este parmetro en 3, el siguiente intento de conexin producir una conexin en la particin de base de datos 3. Ejemplos: Para establecer valores especficos:
db2 set client connect 2 disconnect automatic sqlrules std syncpoint twophase
Para volver a cambiar SQLRULES a DB2, pero mantener los dems valores:
db2 set client sqlrules db2
Nota: Los valores de conexin vuelven a los valores por omisin despus de emitir el mandato TERMINATE. Notas de uso: SET CLIENT no se puede emitir si hay una o ms conexiones activas.
671
SET CLIENT
Si SET CLIENT es satisfactorio, las conexiones en las unidades de trabajo subsiguientes utilizarn los valores de conexin especificados. Si SET CLIENT no es satisfactorio, los valores de conexin del proceso de fondo no se modificarn. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave CONNECT_NODE puede sustituirse por CONNECT_DBPARTITIONNUM. v La palabra clave CATALOG_NODE puede sustituirse por CATALOG_DBPARTITIONNUM. v La palabra clave ATTACH_NODE puede sustituirse por ATTACH_DBPARTITIONNUM. Informacin relacionada: v Mandato TERMINATE en la pgina 691 v Mandato QUERY CLIENT en la pgina 572
672
Command Reference
SET RUNTIME DEGREE Mandato SET RUNTIME DEGREE

Establece el grado mximo de tiempo de ejecucin de paralelismo entre particiones para sentencias de SQL para aplicaciones activas especificadas. mbito: Este mandato afecta a todas las particiones de base de datos que se listan en el archivo $HOME/sqllib/db2nodes.cfg. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Instancia. Para cambiar el grado mximo de tiempo de ejecucin de paralelismo entre particiones en un servidor remoto, primero es necesario conectarse a dicho servidor. Si no existe ninguna conexin, el mandato SET RUNTIME DEGREE fallar. Sintaxis del mandato:
SET RUNTIME DEGREE FOR ALL , ( manejador-aplicaciones ) TO grado
Parmetros del mandato: FOR ALL El grado especificado se aplicar a todas las aplicaciones.
manejador-aplicaciones Especifica el agente al que se aplica el nuevo grado. Liste los valores mediante el mandato LIST APPLICATIONS. TO grado Grado mximo de tiempo de ejecucin de paralelismo entre particiones.
673
SET RUNTIME DEGREE

Ejemplos: El ejemplo siguiente establece en 4 el grado mximo de tiempo de ejecucin de paralelismo para dos usuarios, con valores de manejador-aplicaciones de 41408 y 55458:
db2 SET RUNTIME DEGREE FOR ( 41408, 55458 ) TO 4
Notas de uso: Este mandato proporciona un mecanismo para modificar el grado mximo de paralelismo para las aplicaciones activas. Se puede utilizar para alterar temporalmente el valor que se ha determinado en el tiempo de compilacin de la sentencia de SQL. El grado de tiempo de ejecucin de paralelismo entre particiones especifica el nmero mximo de operaciones paralelas que se utilizarn cuando se ejecute la sentencia. El grado de paralelismo entre particiones para una sentencia de SQL puede especificarse en el tiempo de compilacin de la sentencia utilizando el registro especial CURRENT DEGREE o la opcin de vinculacin degree. El grado mximo de tiempo de ejecucin de paralelismo entre particiones para una aplicacin activa puede especificarse utilizando el mandato SET RUNTIME DEGREE. El parmetro de configuracin max_querydegree del gestor de bases de datos especifica el grado mximo de tiempo de ejecucin para cualquier sentencia de SQL que se ejecute en esta instancia del gestor de bases de datos. El grado real de tiempo de ejecucin ser el valor ms bajo de los siguientes: v parmetro de configuracin max_querydegree v grado de tiempo de ejecucin de la aplicacin v grado de compilacin de la sentencia de SQL. Informacin relacionada: v Mandato LIST APPLICATIONS en la pgina 435
674
Command Reference
SET TABLESPACE CONTAINERS Mandato SET TABLESPACE CONTAINERS

Una restauracin redirigida es una restauracin en la que el conjunto de contenedores de espacios de tabla para la base de datos restaurada es diferente del conjunto de contenedores para la base de datos original en el momento en que se hizo la copia de seguridad. Este mandato permite aadir, cambiar o eliminar contenedores de espacios de tabla para una base de datos que se debe restaurar. Por ejemplo, si uno o ms contenedores quedan inaccesibles por cualquier razn, la restauracin fallar si no se redirige a contenedores diferentes. Nota: No se permite una restauracin redirigida cuando se utiliza un programa de salida de usuario para realizar la restauracin. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Base de datos Sintaxis del mandato:
SET TABLESPACE CONTAINERS FOR id-espaciotabla
USING REPLAY IGNORE ROLLFORWARD CONTAINER OPERATIONS
, ( PATH , serie-contenedor )
FILE DEVICE
serie-contenedor
nmero-de-pginas
Parmetros del mandato: FOR id-espaciotabla Entero que representa de forma exclusiva un espacio de tabla utilizado por la base de datos que se est restaurando.
675
SET TABLESPACE CONTAINERS

REPLAY ROLLFORWARD CONTAINER OPERATIONS Especifica que cualquier operacin ALTER TABLESPACE emitida para este espacio de tabla desde que se hizo la copia de seguridad de la base de datos debe volverse a realizar durante una subsiguiente recuperacin en avance de la base de datos. IGNORE ROLLFORWARD CONTAINER OPERATIONS Especifica que las operaciones ALTER TABLESPACE en la anotacin cronolgica deben ignorarse al realizar una recuperacin en avance. USING PATH serie-contenedor Para un espacio de tabla SMS, identifica uno o ms contenedores que pertenecern al espacio de tabla y en los que se almacenarn los datos del espacio de tabla. Es un nombre de directorio absoluto o relativo. Si el nombre de directorio no es absoluto, ser relativo respecto al directorio de base de datos. La serie no puede tener ms de 240 bytes de longitud. USING FILE/DEVICE serie-contenedor nmero-de-pginas Para un espacio de tabla DMS, identifica uno o ms contenedores que pertenecern al espacio de tabla y en los que se almacenarn los datos del espacio de tabla. Se especifican el tipo de contenedor (FILE o DEVICE) y su tamao (en pginas de 4 KB). Se puede especificar una combinacin de contenedores de archivo y de dispositivo. La serie no puede tener ms de 254 bytes de longitud. Para un contenedor de archivo, la serie debe ser un nombre de archivo absoluto o relativo. Si el nombre de archivo no es absoluto, ser relativo al directorio de base de datos. Para un contenedor de dispositivo, la serie debe ser un nombre de dispositivo. El dispositivo ya debe existir. Ejemplos: Consulte el ejemplo de RESTORE DATABASE. Notas de uso: Una copia de seguridad de una base de datos, o uno o ms espacios de tabla, conserva un registro de todos los contenedores de espacios de tabla que estn siendo utilizados por los espacios de tabla de los que se est realizando una copia de seguridad. Durante una restauracin, se comprueban todos los contenedores listados en la copia de seguridad para ver si existen y son accesibles actualmente. Si uno o ms de los contenedores no es accesible por cualquier razn, la restauracin fallar. Para permitir una restauracin en un caso de este tipo, se soporta la redireccin de los contenedores de espacios de tabla durante la restauracin. Este soporte incluye la adicin, el cambio o la
676
Command Reference
SET TABLESPACE CONTAINERS

eliminacin de contenedores de espacios de tabla. Es este mandato el que permite al usuario aadir, cambiar o eliminar dichos contenedores. Informacin relacionada: v Mandato BACKUP DATABASE en la pgina 216 v Mandato RESTORE DATABASE en la pgina 636 v Mandato ROLLFORWARD DATABASE en la pgina 647
677
SET TAPE POSITION Mandato SET TAPE POSITION

Al ejecutarse en sistemas operativos basados en Windows NT, DB2 da soporte a las operaciones de copia de seguridad y restauracin en dispositivos de cinta de modalidad continua. Utilice este mandato para las posiciones de la cinta. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
SET TAPE POSITION ON dispositivo TO posicin
Parmetros del mandato: ON dispositivo Especifica un nombre de dispositivo de cinta vlido. El valor por omisin es \\.\TAPE0. TO posicin Especifica la marca en la que debe colocarse la cinta. DB2 para Windows NT/2000 graba una marca de cinta despus de cada imagen de copia de seguridad. Un valor de 1 especifica la primera posicin, 2 especifica la segunda posicin, etc. Si la cinta se coloca en la marca de cinta 1, por ejemplo, el archivo 2 queda colocado para restaurarse. Informacin relacionada: v Mandato INITIALIZE TAPE en la pgina 425 v Mandato REWIND TAPE en la pgina 646
678
Command Reference
SET TAPE POSITION Mandato SET WRITE

El mandato SET WRITE permite a un usuario suspender las grabaciones de E/S o reanudar las grabaciones de E/S para una base de datos. El uso habitual de este mandato es para dividir una base de datos reflejada. Este tipo de reflejo se consigue mediante un sistema de almacenamiento en disco. Este nuevo estado, SUSPEND_WRITE, es visible desde el Supervisor de instantneas. Todos los espacios de tabla deben estar en un estado NORMAL para que el mandato se ejecute de forma satisfactoria. Si algn espacio de tabla est en un estado distinto del NORMAL, el mandato fallar. Autorizacin: Este mandato slo afecta al nodo en el que se ejecuta. La autorizacin de este mandato requiere que el emisor tenga uno de los privilegios siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna. Sintaxis del mandato:
SET WRITE SUSPEND RESUME FOR DATABASE DB
Parmetros del mandato: SUSPEND La suspensin de las grabaciones de E/S pondr todos los espacios de tabla en un nuevo estado SUSPEND_WRITE. Este mandato tambin suspende las grabaciones en los registros. Todas las operaciones de base de datos, aparte de la restauracin y copia de seguridad en lnea, deben funcionar normalmente mientras las grabaciones de base de datos estn suspendidas. Sin embargo, es posible que algunas operaciones esperen mientras intentan desechar pginas sucias de la agrupacin de almacenamientos intermedios o de los almacenamientos intermedios de registros a los registros. Estas operaciones reanudarn el funcionamiento habitual una vez que se reanuden las grabaciones de base de datos. RESUME La reanudacin de las grabacin de E/S eliminar el estado
679
SET TAPE POSITION

SUSPEND_WRITE de todos los espacios de tabla y har los espacios de tabla disponibles para la actualizacin. Notas de uso: Se deben reanudar las grabaciones de base de datos desde la misma conexin para la que se suspendieron.
680
Command Reference
START DATABASE MANAGER Mandato START DATABASE MANAGER

Inicia los procesos de fondo de la instancia actual de gestor de bases de datos en una sola particin de base de datos o en todas las particiones de base de datos definidas en un entorno de base de datos particionado. Este mandato no es vlido en un cliente. mbito: En un entorno de bases de datos particionado, este mandato afecta a todas las particiones de base de datos que aparecen listadas en el archivo db2nodes.cfg, a menos que se utilice el parmetro dbpartitionnum. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Nota: La opcin de inicio ADD DBPARTITIONNUM necesita autorizacin sysadm o sysctrl. Conexin necesaria: Ninguna Sintaxis del mandato:
START DATABASE MANAGER DB MANAGER DBM PROFILE perfil
db2start
DBPARTITIONNUM
nmero-particin-bd
opciones de inicio
opciones de inicio:
ADD DBPARTITIONNUM Opciones de add dbpartitionnum STANDALONE RESTART opciones de restart
681
START DATABASE MANAGER

Opciones de add dbpartitionnum:
HOSTNAME nombresistpral PORT puerto-lgico COMPUTER nombre-sistema
USER
nombreusuario
PASSWORD
contrasea
NETNAME
nombrered
LIKE DBPARTITIONNUM nmero-particin-bd WITHOUT TABLESPACES
opciones de restart:
HOSTNAME nombresistpral PORT puerto-lgico NETNAME nombrered
Parmetros del mandato: Nota: Todos los parmetros siguientes slo son vlidos en un entorno MPP. PROFILE perfil Especifica el nombre del archivo de perfil que se debe ejecutar en cada particin de base de datos para definir el entorno DB2. Este archivo se ejecuta antes de que se inicien las particiones de base de datos. El archivo de perfil debe residir en el directorio sqllib del propietario de la instancia. Nota: No todas las variables de entorno del archivo de perfil se definen necesariamente en la sesin de usuario. DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos que se ha de iniciar. Si no se especifica ninguna otra opcin, se realiza un arranque normal en esta particin de base de datos. Los valores vlidos son de 0 a 999 inclusive. Si no se especifica ADD DBPARTITIONNUM, el valor ya debe existir en el archivo db2nodes.cfg del propietario de la instancia. Si no se especifica ningn nmero de particin de base de datos, se iniciarn todas las particiones de base de datos definidas en el archivo de configuracin. ADD DBPARTITIONNUM Especifica que la nueva particin de base de datos se aade al archivo db2nodes.cfg del propietario de la instancia con los valores nombresistpral y puerto-lgico. Asegrese de que la combinacin de nombresistpral y puerto-lgico sea exclusiva.
682
Command Reference

El programa de utilidad de particin de base de datos se ejecuta internamente para crear todas las bases de datos existentes en la particin de base de datos que se aade. Despus de aadir una particin de base de datos, el archivo db2nodes.cfg no se actualiza con la nueva particin de base de datos hasta que se emite db2stop. La particin de base de datos no forma parte del sistema MPP hasta el siguiente db2start a continuacin de db2stop. Nota: Cuando se crean las particiones de base de datos en el nodo nuevo, sus parmetros de configuracin se establecen en el valor por omisin. HOSTNAME nombresistpral Con ADD DBPARTITIONNUM, especifica el nombre de sistema principal que se ha de aadir al archivo db2nodes.cfg. PORT puerto-lgico Con ADD DBPARTITIONNUM, especifica el puerto lgico que se ha de aadir al archivo db2nodes.cfg. Los valores vlidos son de 0 a 999. COMPUTER nombre-sistema Nombre de sistema para la mquina en la que se crea la nueva particin de base de datos. Este parmetro es obligatorio en Windows NT, pero se ignora en otros sistemas operativos. USER nombreusuario Nombre de usuario para la cuenta en la nueva particin de base de datos. Este parmetro es obligatorio en Windows NT, pero se ignora en otros sistemas operativos. PASSWORD contrasea Contrasea para la cuenta en la nueva particin de base de datos. Este parmetro es obligatorio en Windows NT, pero se ignora en otros sistemas operativos. NETNAME nombrered Especifica el nombrered que se debe aadir al archivo db2nodes.cfg. Si no se especifica, este parmetro toma por omisin el valor especificado para nombresistpral. LIKE DBPARTITIONNUM nmero-particin-bd Especifica que los contenedores para los espacios de tabla temporales del sistema sern los mismos que los contenedores del nmero-particin-bd para cada base de datos de la instancia. La particin de base de datos especificada debe ser una particin de base de datos que ya est en el archivo db2nodes.cfg.
683

WITHOUT TABLESPACES Especifica que no se crean contenedores para los espacios de tabla temporales de sistema para ninguna de las bases de datos. Para poder utilizar la base de datos, primero se debe utilizar la sentencia ALTER TABLESPACE para aadir contenedores de espacios de tabla temporales de sistema a cada base de datos. STANDALONE Especifica que la particin de base de datos ha de iniciarse en modalidad autnoma. FCM no intenta establecer una conexin con ninguna otra particin de base de datos. Esta opcin se utiliza al aadir una particin de base de datos. RESTART Inicia el gestor de bases de datos despus de una anomala. Otras particiones de base de datos siguen operando y esta particin de base de datos intenta conectarse a las dems. Si no se especifica el parmetro nombresistpral ni el parmetro puerto-lgico, el gestor de bases de datos se reinicia utilizando los valores nombresistpral y puerto-lgico especificados en db2nodes.cfg. Si se especifica uno de estos parmetros, los nuevos valores se envan a las otras particiones de base de datos al establecer una conexin. El archivo db2nodes.cfg se actualiza con esta informacin. HOSTNAME nombresistpral Con RESTART, especifica el nombre de sistema principal que se ha de utilizar para alterar temporalmente el que se encuentra en el archivo de configuracin de particin de base de datos. PORT puerto-lgico Con RESTART, especifica el nmero de puerto lgico que se ha de utilizar para alterar temporalmente el que se encuentra en el archivo de configuracin de particin de base de datos. Si no se especifica, este parmetro toma por omisin el valor puerto-lgico que corresponde al valor de nm en el archivo db2nodes.cfg. Los valores vlidos son de 0 a 999. NETNAME nombrered Especifica el nombrered para alterar temporalmente el especificado en el archivo db2nodes.cfg. Si no se especifica, este parmetro toma por omisin el valor nombrered que corresponde al valor de nmero-particin-bd del archivo db2nodes.cfg.
684
Command Reference

Ejemplos: A continuacin se muestra un ejemplo de salida de db2start emitida en un sistema de tres particiones de base de datos con las particiones de base de datos 10, 20 y 30:
07-04-1997 10:33:05 10 0 SQL1063N El proceso DB2START ha sido satisfactorio. 07-04-1997 10:33:07 20 0 SQL1063N El proceso DB2START ha sido satisfactorio. 07-04-1997 10:33:07 30 0 SQL1063N El proceso DB2START ha sido satisfactorio. SQL1063N El proceso DB2START ha sido satisfactorio.
Notas de uso: No es necesario emitir este mandato en un nodo cliente. Se proporciona por compatibilidad con los clientes anteriores, pero no tiene ningn efecto en el gestor de bases de datos. Una vez iniciada, la instancia del gestor de bases de datos se ejecuta hasta que el usuario la detiene, incluso aunque hayan finalizado todos los programas de aplicacin que la estaban utilizando. Si el gestor de bases de datos se inicia satisfactoriamente, se enva un mensaje de realizacin satisfactoria al dispositivo de salida estndar. Si se produce un error, el proceso se detiene y se enva un mensaje de error al dispositivo de salida estndar. En un entorno de bases de datos particionado, los mensajes se devuelven en la particin de base de datos que ha emitido el mandato START DATABASE MANAGER. Si no se especifica ningn parmetro en un entorno de bases de datos particionado, el gestor de bases de datos se inicia en todos los nodos paralelos utilizando los parmetros especificados en el archivo de configuracin de particin de base de datos. Si un mandato START DATABASE MANAGER est en proceso, asegrese de que las particiones de base de datos aplicables se hayan iniciado antes de emitir una peticin a la base de datos. El archivo db2cshrc no se soporta y no se puede utilizar para definir el entorno. En las plataformas UNIX, el mandato START DATABASE MANAGER soporta las seales SIGINT y SIGALRM. La seal SIGINT se emite si se pulsa CONTROL+C. La seal SIGALRM se emite si se alcanza el valor especificado para el parmetro de configuracin del gestor de bases de datos start_stop_time. Si se produce cualquiera de las dos seales, se interrumpen todos los arranques en proceso y se devuelve un mensaje (SQL1044N para SIGINT y SQL6037N para SIGALRM) desde cada particin de base de datos
685

interrumpida al archivo de registro de errores $HOME/sqllib/log/db2start. indicacinhora.log. Las particiones de base de datos que ya se han iniciado no se ven afectadas. Si se pulsa CONTROL+C en una particin de base de datos que se est iniciando, debe emitirse db2stop en esa particin de base de datos antes de intentar volver a iniciarla. En el sistema operativo Windows NT, ni el mandato db2start ni el mandato NET START devuelven avisos si algn subsistema de comunicaciones no se ha podido iniciar. El gestor de bases de datos de un entorno Windows NT se implementa como un servicio NT y no devuelve ningn error si el servicio se inicia satisfactoriamente. Asegrese de examinar el Registro de sucesos de NT o el archivo DB2DIAG.LOG para buscar los errores que pueden haberse producido durante la ejecucin de db2start. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave LIKE NODE puede sustituirse por LIKE DBPARTITIONNUM. v La palabra clave ADDNODE puede sustituirse por ADD DBPARTITIONNUM. v La palabra clave NODENUM puede sustituirse por DBPARTITIONNUM. Informacin relacionada: v Mandato STOP DATABASE MANAGER en la pgina 687 v Mandato ADD DBPARTITIONNUM en la pgina 205
686
Command Reference
STOP DATABASE MANAGER Mandato STOP DATABASE MANAGER

Detiene la instancia actual del gestor de bases de datos. A no ser que se detenga explcitamente, el gestor de bases de datos contina estando activo. Este mandato no detiene la instancia del gestor de bases de datos si hay aplicaciones conectadas a las bases de datos. Si no hay conexiones de bases de datos, pero hay conexiones de instancia, fuerza las conexiones de instancia y detiene el gestor de bases de datos. Este mandato tambin desactiva las activaciones de base de datos pendientes antes de detener el gestor de bases de datos. En un sistema de bases de datos particionado, este mandato detiene la instancia actual del gestor de bases de datos en una particin de base de datos o en todas las particiones de base de datos. Cuando detiene el gestor de bases de datos en todas las particiones de base de datos, utiliza el archivo de configuracin db2nodes.cfg para obtener informacin acerca de cada particin de base de datos. Este mandato tambin se puede utilizar para eliminar una particin de base de datos del archivo db2nodes.cfg (slo sistemas de bases de datos particionados). Este mandato no es vlido en un cliente. mbito: Por omisin y en un entorno de bases de datos particionado, este mandato afecta a todas las particiones de base de datos que estn listadas en el archivo db2nodes.cfg. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Ninguna
687
STOP DATABASE MANAGER

STOP DATABASE MANAGER DB MANAGER DBM PROFILE perfil
db2stop
DBPARTITIONNUM nmero-particin-bd DROP DBPARTITIONNUM nmero-particin-bd FORCE DBPARTITIONNUM nmero-particin-bd
Parmetros del mandato: PROFILE perfil slo sistemas de bases de datos particionados. Especifica el nombre del archivo de perfil que se ha ejecutado durante el arranque para definir el entorno DB2 para las particiones de bases de datos que se han iniciado. Si se especific un perfil para el mandato START DATABASE MANAGER, aqu debe especificarse el mismo perfil. El archivo de perfil debe residir en el directorio sqllib del propietario de la instancia. DBPARTITIONNUM nmero-particin-bd slo sistemas de bases de datos particionados. Especifica la particin de base de datos que se ha de detener. Los valores vlidos son de 0 a 999 inclusive y deben estar en el archivo db2nodes.cfg. Si no se especifica ningn nmero de particin de base de datos, se detienen todas las particiones de base de datos del archivo de configuracin. DROP DBPARTITIONNUM nmero-particin-bd slo sistemas de bases de datos particionados. Especifica la particin de base de datos que se ha de eliminar del archivo db2nodes.cfg. Antes de utilizar este parmetro, ejecute el mandato DROP DBPARTITIONNUM VERIFY para asegurarse de que no haya datos de usuario en esta particin de base de datos. Cuando se especifica esta opcin, se detienen todas las particiones de base de datos del archivo db2nodes.cfg. FORCE Especifica el uso de FORCE APPLICATION ALL al detener el gestor de bases de datos en cada particin de base de datos. DBPARTITIONNUM nmero-particin-bd slo sistemas de bases de datos particionados. Especifica la particin de base de datos que se debe detener despus de que se haya forzado la detencin de todas las aplicaciones de dicha particin de base de
688
Command Reference

datos. Si se utiliza la opcin FORCE sin este parmetro, se fuerzan todas las aplicaciones de todas las particiones de base de datos antes de que se detengan todas las particiones de base de datos. Ejemplos: A continuacin se muestra un ejemplo de una salida de db2stop emitida en un sistema de tres particiones con las particiones de base de datos 10, 20 y 30:
07-04-1997 10:32:53 10 0 SQL1064N El 07-04-1997 10:32:54 20 0 SQL1064N El 07-04-1997 10:32:55 30 0 SQL1064N El SQL1064N El proceso DB2STOP ha sido proceso DB2STOP ha sido satisfactorio. proceso DB2STOP ha sido satisfactorio. proceso DB2STOP ha sido satisfactorio. satisfactorio.
Notas de uso: No es necesario emitir este mandato en un nodo cliente. Se proporciona por compatibilidad con los clientes anteriores, pero no tiene ningn efecto en el gestor de bases de datos. Una vez iniciada, la instancia del gestor de bases de datos se ejecuta hasta que el usuario la detiene, incluso aunque hayan finalizado todos los programas de aplicacin que la estaban utilizando. Si se detiene el gestor de bases de datos, se enva un mensaje de realizacin satisfactoria al dispositivo de salida estndar. Si se produce un error, el proceso se detiene y se enva un mensaje de error al dispositivo de salida estndar. Si no se puede detener el gestor de bases de datos porque los programas de aplicacin siguen conectados todava a bases de datos, utilice el mandato FORCE APPLICATION para desconectar primero todos los usuarios, o vuelva a emitir el mandato STOP DATABASE MANAGER con la opcin FORCE. La informacin siguiente slo se aplica a entornos de bases de datos particionados: v Si no se especifica ningn parmetro, el gestor de bases de datos se detiene en cada particin de base de datos listada en el archivo de configuracin. El archivo db2diag.log puede contener mensajes para indicar que otras particiones de base de datos se estn cerrando. v Las particiones de base de datos que se aadan al sistema de base de datos particionado desde que se emiti el mandato STOP DATABASE MANAGER anterior, se actualizarn en el archivo db2nodes.cfg. v En las plataformas UNIX, este mandato soporta la seal SIGALRM, que se emite si se alcanza el valor especificado para el parmetro de configuracin del gestor de bases de datos start_stop_time. Si se produce esta seal, se
689

interrumpen todas las detenciones en proceso y se devuelve el mensaje SQL6037N desde cada particin de base de datos interrumpida al archivo de registro de errores $HOME/sqllib/log/db2stop. indicacinhora.log. Las particiones de base de datos que ya se han detenido no se ven afectadas. v El archivo db2cshrc no se soporta y no se puede especificar como valor para el parmetro PROFILE. Atencin: El mandato kill de UNIX no se debe utilizar para terminar el gestor de bases de datos, porque finaliza bruscamente los procesos del gestor de bases de datos sin terminacin controlada ni proceso de borrado. Informacin relacionada: v Mandato FORCE APPLICATION en la pgina 333 v Mandato START DATABASE MANAGER en la pgina 681 v Mandato DEACTIVATE DATABASE en la pgina 298 v Mandato DROP DBPARTITIONNUM VERIFY en la pgina 317
690
Command Reference
TERMINATE Mandato TERMINATE

Termina explcitamente el proceso de fondo del procesador de lnea de mandatos. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
TERMINATE
Parmetros del mandato: Ninguno Notas de uso: Si una aplicacin est conectada con una base de datos o un proceso est en medio de una unidad de trabajo, TERMINATE hace que se pierda la conexin con la base de datos. Entonces se realiza un compromiso interno. Aunque tanto TERMINATE como CONNECT RESET interrumpen la conexin con una base de datos, slo TERMINATE produce la terminacin del proceso de fondo. Se recomienda que se emita TERMINATE antes de ejecutar el mandato db2stop. Esto impide que el proceso de fondo mantenga una conexin a una instancia de gestor de bases de datos que ya no est disponible. Los procesos de fondo de los sistemas MPP tambin deben terminarse cuando se actualiza la variable de entorno DB2NODE en la sesin. Esta variable de entorno se utiliza para especificar el nmero de particin de base de datos coordinadora en una configuracin MPP de mltiples nodos lgicos.
691
UNCATALOG DATABASE Mandato UNCATALOG DATABASE

Suprime una entrada de base de datos del directorio de bases de datos del sistema. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
UNCATALOG DATABASE DB alias-base-datos
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos que se debe descatalogar. Notas de uso: Slo se pueden descatalogar las entradas del directorio de bases de datos del sistema. Las entradas del directorio de bases de datos locales pueden suprimirse utilizando el mandato DROP DATABASE. Para volver a catalogar la base de datos en la instancia, utilice el mandato CATALOG DATABASE. Para listar las bases de datos catalogadas en un nodo, utilice el mandato LIST DATABASE DIRECTORY. El tipo de autentificacin de una base de datos, utilizado al comunicarse con un servidor de nivel inferior, puede cambiarse descatalogando primero la base de datos y catalogndola luego otra vez con un tipo diferente. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. Vea la informacin para el parmetro de configuracin dir_cache en el mandato GET DATABASE MANAGER CONFIGURATION. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de
692
Command Reference
UNCATALOG DATABASE
los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no entrar en vigor hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) la base de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato CATALOG DATABASE en la pgina 250 v Mandato DROP DATABASE en la pgina 309 v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato LIST DATABASE DIRECTORY en la pgina 440 v Mandato TERMINATE en la pgina 691
693
UNCATALOG DCS DATABASE Mandato UNCATALOG DCS DATABASE

Suprime una entrada del directorio de Servicios de conexin de bases de datos (DCS). Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
UNCATALOG DCS DATABASE DB alias-base-datos
Parmetros del mandato: DATABASE alias-base-datos Especifica el alias de la base de datos DCS que se debe descatalogar. Notas de uso: Las bases de datos DCS tambin se catalogan en el directorio de bases de datos del sistema como bases de datos remotas y se pueden descatalogarse utilizando el mandato UNCATALOG DATABASE. Para volver a catalogar una base de datos del directorio DCS, utilice el mandato CATALOG DCS DATABASE. Para listar las bases de datos DCS catalogadas en un nodo, utilice el mandato LIST DCS DIRECTORY. Nota: Si se ha habilitado la colocacin en antememoria de directorio, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. Vea la informacin proporcionada para el parmetro de configuracin dir_cache en la salida del mandato GET DATABASE MANAGER CONFIGURATION. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin.
694
Command Reference
UNCATALOG DCS DATABASE

Para renovar la antememoria de directorio de CLP, utilice el mandato TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) la base de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela. Informacin relacionada: v Mandato CATALOG DCS DATABASE en la pgina 255 v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato TERMINATE en la pgina 691 v Mandato UNCATALOG DATABASE en la pgina 692 v Mandato LIST DCS DIRECTORY en la pgina 453
695
UNCATALOG LDAP DATABASE Mandato UNCATALOG LDAP DATABASE

Se utiliza para eliminar la base de datos del registro de Lightweight Directory Access Protocol (LDAP). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
UNCATALOG LDAP DATABASE DB aliasbd
USER
Parmetros del mandato: DATABASE aliasbd Especifica el alias de la base de datos LDAP que se debe descatalogar. USER nombreusuario Especifica el nombre distinguido (DN) LDAP del usuario. El DN LDAP de usuario debe tener suficiente autorizacin para suprimir el objeto del directorio LDAP. Si no se especifica el DN LDAP del usuario, se utilizarn las credenciales del usuario de conexin actual. PASSWORD contrasea Contrasea de cuenta. Notas de uso: Cuando se elimina una base de datos, se elimina de LDAP el objeto de base de datos. La base de datos tambin se elimina automticamente del registro de LDAP cuando el servidor de base de datos que gestiona la base de datos se elimina del registro de LDAP. Sin embargo, puede que sea necesario descatalogar manualmente la base de datos de LDAP si: v El servidor de base de datos no soporta LDAP. El administrador debe descatalogar manualmente cada base de datos de LDAP despus de eliminar la base de datos.
696
Command Reference
UNCATALOG LDAP DATABASE

v Durante DROP DATABASE el objeto de base de datos no se puede eliminar de LDAP (porque no se puede acceder a LDAP). En este caso, la base de datos se elimina de todas formas de la mquina local, pero la entrada existente en LDAP no se suprime. Informacin relacionada: v Mandato CATALOG LDAP DATABASE en la pgina 258 v Mandato CATALOG LDAP NODE en la pgina 262 v Mandato UNCATALOG LDAP NODE en la pgina 698
697
UNCATALOG LDAP NODE Mandato UNCATALOG LDAP NODE

Descataloga una entrada de nodo de Lightweight Directory Access Protocol (LDAP). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
UNCATALOG LDAP NODE nombrenodo
USER
Parmetros del mandato: NODE nombrenodo Especifica el nombre del nodo que se debe descatalogar. USER nombreusuario Especifica el nombre distinguido (DN) LDAP del usuario. El DN LDAP de usuario debe tener suficiente autorizacin para suprimir el objeto del directorio LDAP. Si no se especifica el DN LDAP del usuario, se utilizarn las credenciales del usuario de conexin actual. PASSWORD contrasea Contrasea de cuenta. Notas de uso: El nodo LDAP se descataloga automticamente cuando el servidor DB2 se elimina del registro de LDAP. Informacin relacionada: v Mandato CATALOG LDAP DATABASE en la pgina 258 v Mandato UNCATALOG LDAP DATABASE en la pgina 696 v Mandato CATALOG LDAP NODE en la pgina 262
698
Command Reference
UNCATALOG NODE Mandato UNCATALOG NODE

Suprime una entrada del directorio de nodos. Autorizacin: Una de las siguientes: v sysadm v sysctrl Conexin necesaria: Ninguna. Las operaciones de directorio slo afectan al directorio local. Sintaxis del mandato:
UNCATALOG NODE nombrenodo
Parmetros del mandato: NODE nombrenodo Especifica la entrada de nodo que se est descatalogando. Notas de uso: UNCATALOG NODE se puede ejecutar en cualquier tipo de nodo, pero slo se ve afectado el directorio local, incluso si hay una conexin a una instancia remota o una instancia local diferente. Nota: Si la colocacin en antememoria de directorio est habilitada, los archivos de directorios de bases de datos, nodos y DCS se almacenarn en la antememoria. La antememoria de directorio de una aplicacin se crea durante la primera bsqueda de directorio. Dado que la antememoria slo se renueva cuando la aplicacin modifica alguno de los archivos de directorio, los cambios de directorio efectuados por otras aplicaciones pueden no ser efectivos hasta que se haya reiniciado la aplicacin. Para renovar la antememoria de directorio de CLP, utilice TERMINATE. Para renovar la antememoria compartida de DB2, detenga (db2stop) y, a continuacin, reinicie (db2start) la base de datos. Para renovar la antememoria de directorio para otra aplicacin, detenga dicha aplicacin y, a continuacin, reinciela.
699
UNCATALOG NODE
Informacin relacionada: v Mandato CATALOG APPC NODE en la pgina 244 v Mandato CATALOG TCP/IP NODE en la pgina 274 v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato TERMINATE en la pgina 691 v Mandato CATALOG NETBIOS NODE en la pgina 270 v Mandato CATALOG LOCAL NODE en la pgina 264 v Mandato CATALOG APPN NODE en la pgina 247 v Mandato CATALOG NAMED PIPE NODE en la pgina 267
700
Command Reference
UNCATALOG ODBC DATA SOURCE Mandato UNCATALOG ODBC DATA SOURCE

Descataloga una fuente de datos ODBC de usuario o de sistema. Una fuente de datos, en terminologa de ODBC (Open Database Connectivity Conectividad de bases de datos abiertas), es un nombre definido por el usuario para una base de datos especfica. Dicho nombre se utiliza para acceder a la base de datos a travs de ODBC. En Windows, se pueden descatalogar fuentes de datos de usuario o de sistema. Una fuente de datos de usuario slo est visible para el usuario que la ha catalogado, mientras que una fuente de datos de sistema est visible para todos los dems usuarios y todos ellos la pueden utilizar. Este mandato slo est disponible en Windows. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
USER UNCATALOG SYSTEM ODBC DATA SOURCE nombre-fuente-datos
Parmetros del mandato: USER Descataloga una fuente de datos de usuario. Es el valor por omisin si no se especifica ninguna palabra clave. SYSTEM Descataloga una fuente de datos de sistema. ODBC DATA SOURCE nombre-fuente-datos Especifica el nombre de la fuente de datos que se debe descatalogar. La longitud mxima es de 32 caracteres. Informacin relacionada: v Mandato CATALOG ODBC DATA SOURCE en la pgina 273 v Mandato LIST ODBC DATA SOURCES en la pgina 468
701
UNQUIESCE Mandato UNQUIESCE

Restaura el acceso de usuario a las instancias o las bases de datos que se han inmovilizado para mantenimiento u otras razones. UNQUIESCE restaura el acceso de usuario sin necesitar la conclusin y el reinicio de la base de datos. A menos que se designe especficamente, ningn usuario salvo Sysadm, Sysmaint y Sysctrl tiene acceso a una base de datos mientras est inmovilizada. Por consiguiente, es necesario realizar UNQUIESCE para restaurar el acceso general a una base de datos inmovilizada. mbito: UNQUIESCE DB nombre-basedatos restaura el acceso de los usuarios a todos los objetos de la base de datos inmovilizada nombre-basedatos. UNQUIESCE INSTANCE nombre-instancia restaura el acceso de los usuarios a la instancia y las bases de datos de la instancia nombre-instancia. Para detener la instancia y eliminar su inmovilizacin y la de todas sus bases de datos, emita el mandato db2stop. Al detener y reiniciar DB2 se eliminar la inmovilizacin de todas las instancias y bases de datos. Autorizacin: Una de las siguientes: v sysadm v sysctrl v Privilegio CONTROL en la tabla. Sintaxis del mandato:
UNQUIESCE DB nombre-bd INSTANCE nombre-instancia
Conexin necesaria: Base de datos Parmetros del mandato: DB nombre-bd Elimine la inmovilizacin de la base de datos nombre-bd. El acceso de usuarios se restaurar en todos los objetos de la base de datos. INSTANCE nombre-instancia Se restaura el acceso a la instancia nombre-instancia y las bases de datos de la instancia.
702
Command Reference
UNQUIESCE
Ejemplos: Eliminacin de la inmovilizacin de una base de datos
db2 unquiesce db nombrebd
Este mandato eliminar la inmovilizacin de la base de datos que se haya inmovilizado anteriormente.
703
UPDATE ADMIN CONFIGURATION Mandato UPDATE ADMIN CONFIGURATION

Modifica entradas especficas en el archivo de configuracin del Servidor de administracin DB2 (DAS). El DAS es una herramienta administrativa especial que permite la administracin remota de servidores DB2. Al instalar el DAS, se almacena una copia en blanco del archivo de configuracin en cada particin fsica. Debe crear entradas en cada copia. Puede especificar los siguientes parmetros de configuracin de DAS que se utilizarn la prxima vez que inicie el DAS: v Nombre del sistema servidor DB2 - db2system v Nombre de grupo de autorizacin de administracin de DAS dasadm_group v Modalidad de planificador - sched_enable v Instancia de base de datos de catlogo de herramientas - toolscat_inst v Base de datos de catlogo de herramientas - toolscat_db v Esquema de base de datos de catlogo de herramientas - toolscat_schema v Ejecutar tareas caducadas - exec_exp_task v ID de usuario de planificador - sched_userid v DAS de tipo de autentificacin - authentication Los siguientes parmetros de configuracin de DAS pueden especificarse originalmente y luego modificarse mientras el DAS est en lnea: v Modalidad de Discovery de DAS - discover v Servidor SMTP - smtp_server v Va de instalacin de Java Development Kit de DAS - jdk_path v Ubicacin de lista de contactos -contact_host v Pgina de cdigos de DAS - das_codepage v Territorio de DAS - das_territory Para obtener ms informacin sobre estos parmetros, vea las descripciones individuales de los parmetros. mbito: Emita este mandato desde cada nodo administrativo para especificar o cambiar los valores de parmetros correspondientes a ese nodo. Autorizacin: dasadm
704
Command Reference
UPDATE ADMIN CONFIGURATION

Conexin necesaria: Nodo. Para actualizar la configuracin de DAS para un sistema remoto, utilice la opcin FOR NODE con el nombre del nodo administrativo. Sintaxis del mandato:
UPDATE ADMIN
CONFIGURATION CONFIG CFG
USING
valor palabraclave-config
FOR NODE
Parmetros del mandato: USING valor palabraclave-config Especifica el parmetro de configuracin de administracin que se debe actualizar. FOR NODE Entre el nombre de un nodo administrativo para actualizar los parmetros de configuracin de DAS en el mismo. USER nombreusuario USING contrasea Si la conexin al nodo administrativo requiere una autorizacin de nombre de usuario y contrasea, entre esta informacin. Notas de uso: Para ver o imprimir una lista de los parmetros de configuracin del DAS, utilice GET ADMIN CONFIGURATION. Para restablecer los parmetros de configuracin del DAS a los valores por omisin recomendados del DAS, utilice RESET ADMIN CONFIGURATION. Para obtener ms informacin sobre los parmetros de configuracin del DAS, vea las descripciones individuales de los parmetros. El momento en que los parmetros de configuracin entren en vigor depender de si se cambia un parmetro de configuracin estndar o uno de los parmetros que se pueden restablecer en lnea. Los valores de los parmetros de configuracin estndar se restablecen al ejecutar el mandato db2admin. Si se produce un error, el archivo de configuracin del DAS no se modifica.
705
UPDATE ADMIN CONFIGURATION

El archivo de configuracin del DAS no se puede actualizar si la suma de comprobacin no es vlida. Esto puede producirse si se edita manualmente el archivo de configuracin del DAS sin utilizar el mandato adecuado. Si ocurre esto, debe eliminar y volver a crear el DAS para restablecer su archivo de configuracin. Informacin relacionada: v Mandato GET ADMIN CONFIGURATION en la pgina 335 v Mandato RESET ADMIN CONFIGURATION en la pgina 623
706
Command Reference
UPDATE ALERT CONFIGURATION Mandato UPDATE ALERT CONFIGURATION

Actualiza los valores de configuracin de alerta para los indicadores de salud. Autorizacin: Una de las siguientes: v sysadm v sysmaint v sysctrl Conexin necesaria: Instancia. No se necesita una conexin explcita. Sintaxis del mandato:
UPDATE ALERT CONFIGURATION CONFIG CFG FOR DATABASE MANAGER DB MANAGER DBM DATABASES CONTAINERS TABLESPACES DATABASE TABLESPACE nombre CONTAINER nombre FOR id-espaciotabla USING nombre indicador salud
ON alias basedatos
, SET nombre parmetro valor , , UPDATE ACTION SCRIPT nombre-va TASK nombre , DELETE ACTION SCRIPT nombre-va TASK nombre , ADD ACTION SCRIPT nombre-va <Aadir detalles de script> TASK nombre ON WARNING ALARM ATTENTION estado USER nombreusuario USING contrasea ON nombresistpral ON WARNING ALARM ATTENTION estado ON WARNING ALARM ATTENTION estado SET nombre parmetro valor
Aadir detalles de script:

TYPE DB2 STATEMENT TERMINATION CHARACTER carcter STMT TERM CHAR TERM CHAR OPERATING SYSTEM OS COMMAND LINE PARAMETERS parms PARMS WORKING DIRECTORY nombre-va
Parmetros del mandato: DATABASE MANAGER Actualiza valores de alerta para el gestor de bases de datos.
707
UPDATE ALERT CONFIGURATION

DATABASES Actualiza valores de alerta para todas las bases de datos gestionadas por el gestor de bases de datos. stos son los valores que se aplican a todas las bases de datos que no tienen valores personalizados. Los valores personalizados se definen mediante la clusula DATABASE ON alias basedatos. CONTAINERS Actualiza valores de alerta para todos los contenedores de espacio de tabla gestionados por el gestor de bases de datos. stos son los valores que se aplican a todos los contenedores de espacio de tabla que no tienen valores personalizados. Los valores personalizados se definen utilizando la clusula CONTAINER nombre ON alias basedatos. TABLESPACES Actualiza valores de alerta para todos los espacios de tabla gestionados por el gestor de bases de datos. stos son los valores que se aplican a todos los espacios de tabla que no tienen valores personalizados. Los valores personalizados se definen utilizando la clusula TABLESPACE nombre ON alias basedatos. DATABASE ON alias basedatos Actualiza los valores de alerta para la base de datos especificada utilizando la clusula ON alias basedatos. Si esta base de datos tiene valores personalizados, stos alteran temporalmente los valores para todas las bases de datos para la instancia, que se especifica mediante el parmetro DATABASES. CONTAINER nombre FOR ID espaciotabla ON alias basedatos Actualiza los valores de alerta para el contenedor de espacio de tabla denominado nombre, para el espacio de tabla especificado utilizando la clusula FOR ID espaciotabla, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este contenedor de espacio de tabla tiene valores personalizados, stos alteran temporalmente los valores para todos los contenedores de espacio de tabla para la base de datos, que se especifica mediante el parmetro CONTAINERS. TABLESPACE nombre ON alias basedatos Actualiza los valores de alerta para el espacio de tabla denominado nombre, en la base de datos especificada utilizando la clusula ON alias basedatos. Si este espacio de tabla tiene valores personalizados, stos alteran temporalmente los valores para todos los espacios de tabla para la base de datos, que se especifica mediante el parmetro TABLESPACES. USING nombre indicador salud Especifica el conjunto de indicadores de salud para los que se
708
Command Reference

actualizar la configuracin de alerta. Los nombres de indicador de salud se componen de un identificador de objeto de dos letras, seguido de un nombre que describe lo que mide el indicador. Por ejemplo:
db.sort_privmem_util
SET nombre-parmetro valor Actualiza el elemento de configuracin de alerta, nombre-parmetro, del indicador de salud al valor especificado. nombre-parmetro debe ser uno de los siguientes: v ALARM v WARNING v SENSITIVITY v ACTIONSENABLED v THRESHOLDSCHECKED UPDATE ACTION SCRIPT nombre-va ON [WARNING | ALARM | ATTENTION estado] Especifica que los atributos de script del script predefinido con el nombre de va de acceso absoluta nombre-va se actualizar segn la clusula siguiente: SET nombre-parmetro valor Actualiza el atributo de script, nombre-parmetro, al valor especificado. nombre-parmetro debe ser uno de los siguientes: v SCRIPTTYPE v WORKINGDIR v TERMCHAR v CMDLINEPARMS v USERID v PASSWORD v SYSTEM UPDATE ACTION TASK nombre ON [WARNING | ALARM | ATTENTION estado] Especifica que los atributos de tarea de la tarea con el nombre nombre se actualizar segn la clusula siguiente: SET nombre-parmetro valor Actualiza el atributo de tarea, nombre-parmetro, al valor especificado. nombre-parmetro debe ser uno de los siguientes: v USERID v PASSWORD v SYSTEM
709

DELETE ACTION SCRIPT nombre-va ON [WARNING | ALARM | ATTENTION estado] Elimina el script de accin con el nombre de va de acceso absoluta nombre-va de los scripts de accin de alerta. DELETE ACTION TASK nombre ON [WARNING | ALARM | ATTENTION estado] Elimina la tarea de accin denominada nombre de la lista de tareas de accin de alerta. ADD ACTION SCRIPT nombre-va ON [WARNING | ALARM | ATTENTION estado] Especifica que ha de aadirse un nuevo script de accin con el nombre de va de acceso absoluta nombre-va, cuyos atributos se proporcionan segn lo siguiente: TYPE Un script de accin debe ser un script de Mandato de DB2 o un script del sistema operativo: v DB2 v OPERATING SYSTEM Si es un script de Mandato de DB2, la clusula siguiente permite especificar opcionalmente el carcter, carcter, que se utiliza en el script para terminar las sentencias:
STATEMENT TERMINATION CHARACTER ;
Si es un script de sistema operativo, la clusula siguiente permite especificar opcionalmente los parmetros de lnea de mandatos, parms, que se pasaran al script con la invocacin: COMMAND LINE PARAMETERS parms WORKING DIRECTORY nombre-va Especifica el nombre de va de acceso, nombre-va, del directorio en el que se ejecutar el script. USER nombreusuario USING contrasea Especifica la cuenta de usuario, nombreusuario, y la contrasea asociada, contrasea, con los que se ejecutar el script. ADD ACTION TASK nombre ON [WARNING | ALARM | ATTENTION estado] Especifica que una nueva tarea, denominada nombre, ha de aadirse para ejecutarse en (ON) la condicin indicada ON [WARNING | ALARM | ATTENTION estado] Especifica la condicin en que se ejecutar la accin. Para los HI basados en el umbral, es WARNING o ALARM. Para los HI basados en el estado, ser un estado numrico tal como est documentado en
710
Command Reference

una tabla que se ha de proporcionar para cada HI basado en el estado (o sea, estados de espacio de tabla).
711
UPDATE CLI CONFIGURATION Mandato UPDATE CLI CONFIGURATION

Actualiza el contenido de una seccin especificada del archivo db2cli.ini. El archivo db2cli.ini se utiliza como archivo de configuracin de interfaz de nivel de llamada (CLI) de DB2. Contiene varias palabras clave y valores que se pueden utilizar para modificar el comportamiento de la CLI de DB2 y de las aplicaciones que la utilizan. El archivo est dividido en secciones, cada una de las cuales corresponde a un nombre de alias de base de datos. Autorizacin: sysadm Conexin necesaria: Ninguna Sintaxis del mandato:
UPDATE CLI CONFIGURATION CONFIG CFG AT GLOBAL USER LEVEL
FOR SECTION
nombre-seccin USING
valor palabraclave
Parmetros del mandato: FOR SECTION nombre-seccin Nombre de la seccin cuyas palabras clave deben actualizarse. Si la seccin especificada no existe, se crea una seccin nueva. AT GLOBAL LEVEL Especifica que se debe actualizar el parmetro de configuracin de CLI a nivel global. Nota: Este parmetro slo es aplicable cuando el soporte de LDAP est habilitado. AT USER LEVEL Especifica que se debe actualizar el parmetro de configuracin de CLI a nivel de usuario. Nota: Si el soporte LDAP est habilitado, este valor ser coherente cuando se inicie la sesin en mquinas distintas con el mismo
712
Command Reference
UPDATE CLI CONFIGURATION

ID de usuario LDAP. Si el soporte LDAP no est habilitado, este valor slo ser coherente cuando se inicie la sesin en la misma mquina con el mismo ID de usuario de sistema operativo. USING valor palabraclave Especifica el parmetro de CLI/ODBC que se debe actualizar. Notas de uso: El nombre de seccin y las palabras clave que se especifican en este mandato no son sensibles a las maysculas y minsculas. Sin embargo, los valores de palabra clave son sensibles a las maysculas y minsculas. Si un valor de palabra clave es una serie que contiene comillas simples o espacios en blanco intercalados, la serie entera deber delimitarse mediante comillas dobles. Por ejemplo:
db2 update cli cfg for section tstcli1x using TableType "TABLE,VIEW,SYSTEM TABLE"
Cuando se especifican las palabras clave AT USERLEVEL, los parmetros de configuracin de CLI para la seccin especificada slo se actualizan para el usuario actual; de lo contrario, se actualizan para todos los usuarios de la mquina local. La configuracin de CLI a nivel de usuario se mantiene en el directorio LDAP y se almacena en la antememoria de la mquina local. Al leer la configuracin de CLI, DB2 lee siempre en la antememoria. La antememoria se renueva cuando: v El usuario actualiza la configuracin de CLI. v El usuario fuerza explcitamente una renovacin de la configuracin de CLI utilizando el mandato REFRESH LDAP. En un entorno LDAP, los usuarios pueden configurar un conjunto de valores CLI por omisin para una base de datos catalogada en el directorio LDAP. Cuando se aade una base de datos LDAP catalogada como DSN (Nombre de fuente de datos), utilizando el CCA (Asistente de configuracin de cliente) o el programa de utilidad de configuracin ODBC, se configurarn los valores CLI por omisin, si existen en el directorio LDAP, para dicho DSN en la mquina local. Se deber especificar la clusula AT GLOBAL LEVEL para configurar un parmetro de CLI como valor por omisin. Informacin relacionada: v Mandato GET CLI CONFIGURATION en la pgina 342 v Mandato REFRESH LDAP en la pgina 596
713
UPDATE COMMAND OPTIONS Mandato UPDATE COMMAND OPTIONS

Establece una o ms opciones de mandato durante una sesin interactiva o desde un archivo de entrada de proceso por lotes. Los valores revierten a los valores por omisin del sistema (o a los valores de DB2OPTIONS que prevalecen sobre los valores por omisin del sistema) cuando finaliza la sesin interactiva o el archivo de entrada de proceso por lotes. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
UPDATE COMMAND OPTIONS USING
letra-opcin
ON valor OFF
Parmetros del mandato: USING letra-opcin Se pueden establecer las letras-opcin siguientes: a c e l n o p r s v w z Visualizar SQLCA Comprometer automticamente sentencias de SQL Visualizar SQLCODE/SQLSTATE Anotar cronolgicamente los mandatos en un archivo histrico Eliminar carcter de nueva lnea Visualizar en salida estndar Visualizar indicador interactivo de DB2 Guardar informe de salida en un archivo Detener ejecucin en error de mandato Hacer eco de mandato actual Mostrar mensajes de aviso de sentencia de SQL Redirigir toda la salida a un archivo.
ON valor Las opciones e, l, r y z necesitan un valor si se activan. Para la opcin
714
Command Reference
UPDATE COMMAND OPTIONS

e, valor puede ser c para visualizar el mensaje SQLCODE o s para visualizar el mensaje SQLSTATE. Para las opciones l, r yz, valor representa el nombre que se debe utilizar para el archivo histrico o el archivo de informe. Ninguna otra opcin acepta un valor. Notas de uso: Estos valores prevalecen sobre los valores por omisin del sistema, los valores de DB2OPTIONS y las opciones especificadas utilizando distintivos de opciones de la lnea de mandatos. La opcin de entrada de archivo (-f) y la opcin de terminacin de sentencia (-t) no se pueden actualizar utilizando este mandato. Para ver los valores de opcin actuales, utilice el mandato LIST COMMAND OPTIONS. Informacin relacionada: v Mandato LIST COMMAND OPTIONS en la pgina 438
715
UPDATE CONTACT Mandato UPDATE CONTACT

Actualiza los atributos de un contacto definido en el sistema local. Un contacto es un usuario al que el Planificador y el Supervisor de salud envan mensajes. Para crear un contacto, utilice el mandato ADD CONTACT. Autorizacin: Ninguna. Conexin necesaria: Ninguna. Sintaxis del mandato:
, UPDATE CONTACT nombre USING palabraclave valor
Parmetros del mandato: CONTACT nombre Nombre del contacto que se actualizar. USING palabraclave valor Especifica el parmetro de contacto que hay que actualizar (palabraclave) y el valor con el que se establecer (valor). El conjunto vlido de palabras clave es: ADDRESS Direccin de correo electrnico que utiliza el servidor SMTP para enviar la notificacin. TYPE Si la direccin corresponde a una direccin de correo electrnico o a un buscapersonas.
MAXPAGELEN Nmero mximo de caracteres que el buscapersonas puede aceptar. DESCRIPTION Texto descriptivo del contacto. Tiene una longitud mxima de 128 caracteres.
716
Command Reference
UPDATE CONTACTGROUP Mandato UPDATE CONTACTGROUP

Actualiza los atributos de un grupo de contactos definido en el sistema local. Un grupo de contactos es una lista de direcciones a los que el Planificador y el Supervisor de salud deben enviar notificaciones. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
UPDATE CONTACTGROUP nombre
, ADD DROP CONTACT GROUP nombre DESCRIPTION nueva descripcin
Parmetros del mandato: CONTACTGROUP nombre Nombre del grupo de contactos que se actualizar. ADD CONTACT nombre Especifica el nombre del nuevo contacto que se aadir al grupo. No es necesario que defina un contacto con el mandato ADD CONTACT antes de aadirlo a un grupo. DROP CONTACT nombre Especifica el nombre de un contacto del grupo que se eliminar del grupo. ADD GROUP nombre Especifica el nombre del nuevo grupo de contactos que se aadir al grupo. DROP GROUP nombre Especifica el nombre de un grupo de contactos que se eliminar del grupo. DESCRIPTION nueva descripcin Opcional. Texto descriptivo nuevo del grupo de contactos.
717
UPDATE DATABASE CONFIGURATION Mandato UPDATE DATABASE CONFIGURATION

Modifica entradas individuales de un archivo de configuracin de base de datos especfico. En cada nodo en el que se ha creado la base de datos reside un archivo de configuracin de base de datos. mbito: Este mandato slo afecta al nodo en el que se ejecuta. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. Una conexin explcita no es necesaria, pero se recomienda una conexin con la base de datos cuando la base de datos est activa. Si la base de datos est listada como remota, se establece una conexin de instancia al nodo remoto durante el tiempo que dura el mandato. Para cambiar un parmetro en lnea, debe estar conectado a la base de datos. Sintaxis del mandato:
UPDATE DATABASE DB CONFIGURATION CONFIG CFG FOR alias-base-datos
IMMEDIATE USING valor palabraclave-config DEFERRED
Parmetros del mandato: DEFERRED Efecte los cambios slo en el archivo de configuracin, de forma que los cambios entren en vigor la prxima vez que reactive la base de datos.
718
Command Reference
UPDATE DATABASE CONFIGURATION

FOR alias-base-datos Especifica el alias de la base de datos cuya configuracin debe actualizarse. No es necesario especificar el alias de base de datos cuando ya se ha establecido una conexin de base de datos. IMMEDIATE Efecte los cambios inmediatamente, mientras se est ejecutando la base de datos. IMMEDIATE es la accin por omisin, pero necesita una conexin de base de datos para entrar en vigor. USING valor palabraclave-config Especifica el parmetro de configuracin de base de datos que se debe actualizar. Notas de uso: Para ver o imprimir una lista de los parmetros de configuracin de base de datos, utilice el mandato GET DATABASE CONFIGURATION. Para establecer los parmetros de configuracin de base de datos en los valores por omisin recomendados del gestor de bases de datos, utilice el mandato RESET DATABASE CONFIGURATION. Para obtener ms informacin acerca de los parmetros de configuracin de DB2 y los valores disponibles para cada tipo de nodo de base de datos, vea las descripciones individuales de los parmetros de configuracin. Los valores de estos parmetros difieren para cada tipo de nodo de base de datos configurado (servidor, cliente o servidor con clientes remotos). No todos los parmetros pueden actualizarse. Algunos cambios en el archivo de configuracin de base de datos slo entran en vigor despus de haberse cargado en la memoria. Para que esto pueda producirse, todas las aplicaciones deben desconectarse de la base de datos. Para obtener ms informacin sobre qu parmetros son configurables en lnea y cules no lo son, vea la lista de resumen de parmetros de configuracin. Por ejemplo, para cambiar el parmetro en lnea de configuracin de base de datos sortheap para la base de datos sales, entre los siguientes mandatos:
db2 connect to sales db2 update db cfg using sortheap 1000 db2 connect reset
Si se produce un error, el archivo de configuracin de base de datos no se modifica. El archivo de configuracin de base de datos no se puede actualizar si la suma de comprobacin no es vlida. Esto puede producirse si se
719
UPDATE DATABASE CONFIGURATION

modifica el archivo de configuracin de base de datos sin utilizar el mandato apropiado. Si sucede esto, se deber restaurar la base de datos para restablecer el archivo de configuracin de la misma. Tareas relacionadas: v Configuring DB2 with configuration parameters del manual Administration Guide: Performance Informacin relacionada: v Mandato GET DATABASE CONFIGURATION en la pgina 349 v Mandato RESET DATABASE CONFIGURATION en la pgina 627 v Configuration parameters summary del manual Administration Guide: Performance
720
Command Reference
UPDATE DATABASE MANAGER CONFIGURATION Mandato UPDATE DATABASE MANAGER CONFIGURATION

Modifica entradas individuales del archivo de configuracin del gestor de bases de datos. Autorizacin: sysadm Conexin necesaria: Ninguna o instancia. Para efectuar operaciones de configuracin DBM locales no se necesita una conexin de instancia, pero dicha conexin es necesaria para efectuar operaciones de configuracin DBM remotas. Para actualizar la configuracin del gestor de bases de datos para una instancia remota, es necesario conectarse primero a dicha instancia. Para actualizar en lnea un parmetro de configuracin, tambin es necesario conectarse primero a la instancia. Sintaxis del mandato:
UPDATE DATABASE MANAGER DB MANAGER DBM CONFIGURATION CONFIG CFG
IMMEDIATE USING valor palabraclave-config DEFERRED
Parmetros del mandato: DEFERRED Efecte los cambios slo en el archivo de configuracin, de forma que los cambios entren en vigor cuando se reinicie la instancia. IMMEDIATE Efecte los cambios ahora, dinmicamente, mientras se ejecuta la instancia. IMMEDIATE es el valor por omisin, pero necesita una conexin de instancia para entrar en vigor. USING valor palabraclave-config Especifica el parmetro de configuracin del gestor de bases de datos que se debe actualizar. Para obtener una lista de parmetros de configuracin, consulte el resumen de parmetros de configuracin.
721
UPDATE DATABASE MANAGER CONFIGURATION

Notas de uso: Para ver o imprimir una lista de los parmetros de configuracin de gestor de bases de datos, utilice el mandato GET DATABASE MANAGER CONFIGURATION. Para restablecer los parmetros de configuracin del gestor de bases de datos a los valores por omisin recomendados del gestor de bases de datos, utilice el mandato RESET DATABASE MANAGER CONFIGURATION. Para obtener ms informacin acerca de los parmetros de configuracin del gestor de bases de datos y los valores de estos parmetros que son adecuados para cada tipo de nodo de base de datos configurado (servidor, cliente o servidor con clientes remotos), vea las descripciones de los parmetros de configuracin individuales. No todos los parmetros pueden actualizarse. Algunos cambios en el archivo de configuracin del gestor de bases de datos slo entran en vigor despus de haberse cargado en la memoria. Para obtener ms informacin sobre qu parmetros son configurables en lnea y cules no lo son, vea el resumen de parmetros de configuracin. Los parmetros de configuracin de servidor que no se restablecen inmediatamente, se restablecen durante la ejecucin de db2start. Para un parmetro de configuracin de cliente, los parmetros se restablecen la vez siguiente que se reinicia la aplicacin. Si el cliente es el procesador de lnea de mandatos, es necesario invocar TERMINATE. Por ejemplo, para cambiar el parmetro en lnea de configuracin del gestor de bases de datos DIAGLEVEL para la instancia eastern del gestor de bases de datos, entre el mandato siguiente:
db2 attach to eastern db2 update dbm cfg using DIAGLEVEL 1 db2 detach
Si se produce un error, el archivo de configuracin del gestor de bases de datos no se modifica. El archivo de configuracin del gestor de bases de datos no se puede actualizar si la suma de comprobacin no es vlida. Esto puede producirse si edita el archivo de configuracin del gestor de bases de datos y no utiliza el mandato adecuado. Si la suma de comprobacin no es vlida, debe volver a instalar el gestor de bases de datos para restablecer el archivo de configuracin del gestor de bases de datos. Cuando se actualizan los parmetros de configuracin del gestor de bases de datos SVCENAME, NNAME o TPNAME para la instancia actual, si se ha habilitado el soporte de LDAP y hay un servidor LDAP registrado para esta instancia, el servidor LDAP se actualizar con el valor o los valores nuevos.
722
Command Reference
UPDATE DATABASE MANAGER CONFIGURATION

Tareas relacionadas: v Configuring DB2 with configuration parameters del manual Administration Guide: Performance Informacin relacionada: v Mandato GET DATABASE MANAGER CONFIGURATION en la pgina 354 v Mandato RESET DATABASE MANAGER CONFIGURATION en la pgina 629 v Mandato TERMINATE en la pgina 691 v Configuration parameters summary del manual Administration Guide: Performance
723
UPDATE HEALTH NOTIFICATION CONTACT LIST Mandato UPDATE HEALTH NOTIFICATION CONTACT LIST
Actualiza la lista de contactos de notificacin para las alertas de salud emitidas por una instancia. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia. No se necesita una conexin explcita. Sintaxis del mandato:
UPDATE HEALTH NOTIFICATION CONTACT NOTIFICATION LIST
, ADD DROP CONTACT GROUP nombre
Parmetros del mandato: ADD GROUP nombre Aade un nuevo grupo de contactos a los que se notificar la salud de la instancia. ADD CONTACT nombre Aade un nuevo contacto al que se notificar la salud de la instancia. DROP GROUP nombre Elimina el grupo de contactos de la lista de contactos a los que se notificar la salud de la instancia. DROP CONTACT nombre Elimina el contacto de la lista de contactos a los que se notificar la salud de la instancia.
724
Command Reference
UPDATE HISTORY FILE Mandato UPDATE HISTORY FILE

Actualiza la ubicacin, el tipo de dispositivo o el comentario en una entrada de archivo histrico. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint v dbadm Conexin necesaria: Base de datos Sintaxis del mandato:
UPDATE HISTORY FOR parte-objeto LOCATION ubicacin-nueva COMMENT comentario-nuevo WITH
DEVICE TYPE tipo-dispositivo-nuevo
Parmetros del mandato: FOR parte-objeto Especifica el identificador para la imagen de copia o de copia de seguridad. Es una indicacin de fecha y hora con un nmero de secuencia opcional de 001 a 999. LOCATION ubicacin-nueva Especifica la ubicacin fsica nueva de una imagen de copia de seguridad. La interpretacin de este parmetro depende del tipo de dispositivo. DEVICE TYPE tipo-dispositivo-nuevo Especifica un tipo de dispositivo nuevo para almacenar la imagen de copia de seguridad. Los tipos de dispositivo vlidos son: D K T A U Disco Disquete Cinta TSM Salida de usuario
725
UPDATE HISTORY FILE

P N X Q O rea de interconexin de memoria Dispositivo nulo XBSA Sentencia de SQL Otro
COMMENT comentario-nuevo Especifica un comentario nuevo para describir la entrada. Ejemplos: Para actualizar la entrada del archivo histrico para la copia de seguridad entera de la base de datos realizada el 13 de abril de 1997 a las 10:00 a.m., entre:
db2 update history for 19970413100000001 with location /backup/dbbackup.1 device type d
Notas de uso: El propsito principal del archivo histrico de la base de datos es registrar informacin, pero los datos contenidos en el histrico son utilizados directamente por operaciones de restauracin automtica. Durante cualquier restauracin donde se especifique la opcin AUTOMATIC, el programa de restauracin utilizar y har referencia al histrico de imgenes de copia de seguridad y a sus ubicaciones para realizar la peticin de restauracin automtica. Si se va a utilizar la funcin de restauracin automtica y se ha cambiado la ubicacin de las imgenes de copia de seguridad desde que se crearon, se recomienda que el registro del histrico de la base de datos para estas imgenes se actualice para reflejar la ubicacin actual. Si la ubicacin de las imgenes de copia de seguridad en el histrico de la base de datos no est actualizado, la restauracin automtica no podr ubicar las imgenes de copia de seguridad, pero todava se pueden utilizar satisfactoriamente los mandatos de restauracin manual. Informacin relacionada: v Mandato PRUNE HISTORY/LOGFILE en la pgina 568
726
Command Reference
UPDATE LDAP NODE Mandato UPDATE LDAP NODE

Actualiza la informacin de protocolo asociada con una entrada de nodo que representa el servidor DB2 en LDAP (Lightweight Directory Access Protocol). Este mandato slo est disponible en Windows, AIX y Solaris. Autorizacin: Ninguna Conexin necesaria: Ninguna Sintaxis del mandato:
UPDATE LDAP NODE nombrenodo HOSTNAME nombresistpral
SVCENAME
nombservicio
NNAME
nombre-n
NETWORK
id_red
PARTNERLU
lu_asociada
TPNAME
nombrept
MODE
modalidad
SECURITY
NONE SAME PROGRAM
LANADDRESS
direcc_lan
CHGPWDLU
lu_cambio_contrasea
WITH
comentarios
USER
Parmetros del mandato: NODE nombrenodo Especifica el nombre de nodo al actualizar un servidor DB2 remoto. El nombre de nodo es el valor especificado al registrar el servidor DB2 en LDAP. HOSTNAME nombresistpral Especifica el nombre de sistema principal TCP/IP (o la direccin IP). SVCENAME nombservicio Especifica el nombre de servicio o el nmero de puerto TCP/IP.
727
UPDATE LDAP NODE

NNAME nombre-n Especifica el nombre de estacin de trabajo NETBIOS. Nota: NETBIOS no se soporta en los sistemas operativos AIX y Solaris; sin embargo, este protocolo puede actualizarse para un servidor remoto utilizando un sistema operativo como Windows NT. NETWORK id_red Especifica el ID de red APPN. PARTNERLU lu_asociada Especifica el nombre de LU asociada APPN para la mquina servidor DB2. TPNAME nombrept Especifica el nombre de programa de transacciones APPN. MODE modalidad Especifica el nombre de modalidad APPN. SECURITY Especifica el nivel de seguridad APPN. Los valores vlidos son: NONE Especifica que no se debe incluir ninguna informacin de seguridad en la peticin de asignacin enviada al servidor. ste es el tipo de seguridad por omisin para el servidor DB2 UDB. SAME Especifica que se debe incluir un nombre de usuario en la peticin de asignacin enviada al servidor, junto con un indicador de que el nombre del usuario ya se ha verificado. El servidor debe estar configurado para aceptar seguridad que ya se ha verificado. PROGRAM Especifica que se deben incluir un nombre de usuario y una contrasea en la peticin de asignacin enviada al servidor. ste es el tipo de seguridad por omisin para servidores de bases de datos de sistema principal como DB2 para OS/390 o z/OS, o DB2 para iSeries. LANADDRESS direccin_lan Especifica la direccin de adaptador de red APPN. CHGPWDLU lu_cambio_contrasea Especifica el nombre de la LU asociada que se debe utilizar al cambiar la contrasea para un servidor de bases de datos de sistema principal.
728
Command Reference
UPDATE LDAP NODE

WITH comentarios Describe el servidor DB2. Se puede entrar cualquier comentario que ayude a describir el servidor registrado en el directorio de red. La longitud mxima es de 30 caracteres. No se permite ningn retorno de carro o carcter de salto de lnea. El texto de comentario debe escribirse entre comillas dobles. USER nombreusuario Especifica el nombre distinguido (DN) LDAP del usuario. El DN LDAP de usuario debe tener suficiente autorizacin para crear y actualizar el objeto del directorio LDAP. Si no se especifica el DN LDAP del usuario, se utilizarn las credenciales del usuario de conexin actual. PASSWORD contrasea Contrasea de cuenta. Informacin relacionada: v Mandato REGISTER en la pgina 598 v Mandato DEREGISTER en la pgina 300
729
UPDATE MONITOR SWITCHES Mandato UPDATE MONITOR SWITCHES

Activa o desactiva uno o ms conmutadores de registro de supervisor de bases de datos. Cuando se inicia el gestor de bases de datos, los valores de los seis conmutadores se determinan mediante el parmetro de configuracin dft_mon de gestor de bases de datos. El supervisor de bases de datos siempre registra un conjunto base de informacin. Los usuarios que necesitan informacin adicional a la bsica pueden activar los conmutadores apropiados, pero con un coste en el rendimiento del sistema. La cantidad de informacin en la salida del mandato GET SNAPSHOT refleja qu conmutadores estn activados, si hay alguno. Autorizacin: Una de las siguientes: v sysadm v sysctrl v sysmaint Conexin necesaria: Instancia o base de datos: v Si no existe ninguna conexin a una instancia ni ninguna conexin a una base de datos, se crear una conexin de instancia por omisin. v Si existe una conexin a una instancia y una conexin a una base de datos, se utilizar la conexin a la instancia. Para actualizar los conmutadores de supervisor en una instancia remota (o una instancia local diferente), es necesario conectarse primero a dicha instancia. Sintaxis del mandato:
UPDATE MONITOR SWITCHES USING
nombre-conmutador
ON OFF
730
Command Reference
UPDATE MONITOR SWITCHES

Parmetros del mandato: USING nombre-conmutador Estn disponibles los nombres de conmutador siguientes: BUFFERPOOL Informacin de actividad de agrupacin de almacenamientos intermedios LOCK SORT Informacin de bloqueos Informacin de clasificacin
STATEMENT Informacin de sentencia de SQL TABLE Informacin de actividad de tabla
TIMESTAMP Supervisin de la informacin de indicacin de la hora UOW Informacin de unidad de trabajo.
AT DBPARTITIONNUM nmero-particin-bd Especifica la particin de base de datos para la que ha de visualizarse el estado de los conmutadores de supervisor. GLOBAL Devuelve un resultado total para todas las particiones de base de datos de un sistema de base de datos particionado. Notas de uso: El gestor de bases de datos slo rene informacin despus de que se haya activado un conmutador. Los conmutadores permanecen establecidos hasta que se emite db2stop o termina la aplicacin que ha emitido el mandato UPDATE MONITOR SWITCHES. Para borrar la informacin relacionada con un conmutador determinado, desactive el conmutador y, a continuacin, actvelo. La actualizacin de conmutadores en una aplicacin no afecta a las otras aplicaciones. Para ver los valores de conmutador, utilice el mandato GET MONITOR SWITCHES. Compatibilidades: Para la compatibilidad con versiones anteriores a la Versin 8: v La palabra clave NODE puede sustituirse por DBPARTITIONNUM. Informacin relacionada:
731
UPDATE MONITOR SWITCHES

v Mandato GET SNAPSHOT en la pgina 374 v Mandato GET MONITOR SWITCHES en la pgina 367
732
Command Reference
Captulo 4. Utilizacin de sentencias de SQL de la lnea de mandatos

Esta seccin proporciona informacin sobre la utilizacin de sentencias de Lenguaje de Consulta Estructurada (SQL) desde la lnea de mandatos. Estas sentencias pueden ejecutarse directamente desde un indicador de mandatos de sistema operativo y se pueden utilizar para definir y manipular informacin almacenada en una tabla, un ndice o una vista de base de datos del mismo modo que si se escribieran los mandatos en un programa de aplicacin. Se puede aadir, suprimir o actualizar informacin y se pueden generar informes a partir del contenido de las tablas. Todas las sentencias de SQL que se pueden ejecutar mediante el procesador de la lnea de mandatos se listan en la columna CLP de la Tabla 9 en la pgina 738. La sintaxis de todas las sentencias de SQL, tanto si se ejecutan desde la lnea de mandatos como si se incorporan en un programa fuente, se describen en la publicacin SQL Reference . La sintaxis de muchas sentencias de SQL incorporadas y sentencias de SQL CLP es idntica. Sin embargo, las variables de sistema principal, los marcadores de parmetro, los nombres de descriptor y los nombres de sentencia slo son aplicables al SQL incorporado. La sintaxis de CALL, CLOSE, CONNECT, DECLARE CURSOR, FETCH, OPEN y SELECT depende de si estas sentencias estn incorporadas o se ejecuten mediante el CLP. A continuacin se proporciona la sintaxis CLP de estas sentencias: CALL
CALL nombre-procedimiento ( , expresin ? nulo )
CLOSE
CLOSE nombre-cursor
733
Utilizacin de sentencias de SQL de lnea de mandatos

CONNECT
CONNECT TO nombre-servidor bloque-bloqueo RESET (1) autorizacin autorizacin
autorizacin:
USER nombre-autorizacin
USING
contrasea NEW contrasea CONFIRM contrasea
CHANGE PASSWORD
bloque-bloqueo:
IN SHARE MODE IN EXCLUSIVE MODE ON SINGLE NODE
Notas: 1 Este formato slo es vlido si se ha habilitado la conexin implcita.
DECLARE CURSOR
DECLARE nombre-cursor CURSOR WITH HOLD FOR sentencia-seleccin
FETCH
FETCH FROM nombre-cursor
FOR LOB
ALL n COLUMN COLUMNS
ROW ROWS ALL
INTO nombre-archivo
APPEND NEW OVERWRITE
734
Command Reference

OPEN
OPEN nombre-cursor
SELECT
seleccin completa:
subseleccin (seleccin completa) clusula-values
UNION UNION ALL EXCEPT EXCEPT ALL INTERSECT INTERSECT ALL
subseleccin (seleccin completa) clusula-values
subseleccin:
clusula-select clusula-from
clusula-where
clusula-group-by
clusula-having
clusula-select:
ALL SELECT DISTINCT * , expresin AS nombre-columna nombre-tabla.* nombre-vista.* nombre-correlacin.*
clusula-values:
, VALUES expresin-fila
expresin-fila:
735

expresin NULL , ( expresin NULL )
Notas: 1. Cuando se emite CALL: v Debe utilizarse una expresin para cada parmetro IN o INOUT del procedimiento. Para un parmetro INOUT, la expresin debe ser un solo valor de literal. v Debe utilizarse un signo de cierre de interrogacin (?) para cada parmetro OUT del procedimiento. v El proceso almacenado debe estar catalogado. Si se llama a un procedimiento no catalogado, se devuelve un mensaje de error SQL0440N. 2. La versin CLP de CONNECT permite al usuario cambiar la contrasea, utilizando los parmetros siguientes: NEW contrasea Especifica la contrasea nueva que se debe asignar al nombre de usuario. Las contraseas pueden tener hasta 18 caracteres de longitud. El sistema en el que se cambiar la contrasea depende del modo en que se haya configurado la autentificacin de usuario. CONFIRM contrasea Serie que debe ser idntica a la contrasea nueva. Este parmetro se utiliza para detectar errores de entrada. CHANGE PASSWORD Si se especifica esta opcin, se solicita al usuario la contrasea actual, una contrasea nueva y la confirmacin de la contrasea nueva. Las contraseas no se visualizan al entrarse. 3. Cuando se emite FETCH o SELECT mediante el procesador de lnea de mandatos, se visualizan nmeros decimales y de coma flotante con el delimitador decimal del territorio, es decir, un punto (.) en EE.UU., Canad y el Reino Unido y una coma (,) en la mayora de pases restantes. Sin embargo, cuando se emiten sentencias INSERT, UPDATE, CALL y otras sentencias de SQL mediante el procesador de lnea de mandatos para actualizar tablas, se deber utilizar un punto como delimitador decimal, incluso en pases que utilizan una coma para dicha finalidad. 4. Cuando se emite FETCH o SELECT mediante el procesador de lnea de mandatos, los valores nulos se visualizan normalmente como un guin (-). Para bases de datos configuradas con DFT_SQLMATHWARN YES, las
736
Command Reference

expresiones que producen un error aritmtico se procesan como valores nulos. Los nulos de errores aritmticos de este tipo se visualizan como un signo ms (+). Por ejemplo, cree y llene la tabla t1 del modo siguiente:
create table t1 (i1 int , i2 int); insert into t1 values (1,1),(2,0),(3,null);
La sentencia: select i1/i2 from t1 genera el siguiente resultado:

1 --+ 3 registros seleccionados
5. Se ha aadido una opcin LOB nueva a FETCH. Si se especifica la clusula LOB, slo se capta la fila siguiente: v Cada valor de columna LOB se capta en un archivo con el nombre nombre-archivo.xxx, donde nombre-archivo se especifica en la clusula LOB y xxx es una extensin de archivo de 001 a 999 (001 es la primera columna LOB de la lista de seleccin de la sentencia DECLARE CURSOR correspondiente, 002 es la segunda columna LOB y 999 es la columna nmero 999). El nmero mximo de columnas LOB que se pueden captar en archivos es de 999. v Los nombres de los archivos que contienen los datos se visualizan en las columnas LOB. 6. Cuando se emite SELECT mediante el procesador de la lnea de mandatos para consultar tablas que contienen columnas LOB, todas las columnas se truncan a 8 KB en la salida. 7. El procesador de la lnea de mandatos visualiza las columnas BLOB en representacin hexadecimal. 8. Las sentencias de SQL que contienen referencias a columnas de tipo estructurado no se pueden emitir si no est disponible una funcin de transformacin apropiada. Cambie el modo en que el CLP visualiza los datos (al consultar bases de datos utilizando sentencias de SQL mediante el CLP) volviendo a vincular los archivos de vinculacin CLP para la base de datos que se est consultando. Por ejemplo, para visualizar la fecha y la hora en formato ISO, realice lo siguiente: 1. Cree un archivo de texto que contenga los nombres de los archivos de vinculacin CLP. Este archivo se utiliza como el archivo de lista para vincular mltiples archivos con un mandato BIND. En este ejemplo el archivo se llama clp.lst y su contenido es:
737

db2clpcs.bnd db2clprr.bnd db2clpur.bnd db2clprs.bnd db2clpns.bnd + + + +
2. Conctese a la base de datos. 3. Emita el mandato siguiente:

db2 bind @clp.lst collection nullid datetime iso Tabla 9. Sentencias de SQL (DB2 Universal Database) Sentencia de SQL Dinmico1 Procesador Interfaz de nivel de llamada3 (CLI) de lnea de mandatos (CLP) Proc. SQL
ALLOCATE CURSOR sentencia de asignacin ASSOCIATE LOCATORS ALTER { BUFFERPOOL, NICKNAME,9 NODEGROUP, SERVER,9 TABLE, TABLESPACE, USER MAPPING,9 TYPE, VIEW } BEGIN DECLARE SECTION2 CALL sentencia CASE CLOSE COMMENT ON COMMIT SQL compuesto (Intercalado) sentencia compuesta CONNECT (Tipo 1) X SQLBrowseConnect(), SQLConnect(), SQLDriverConnect() SQLBrowseConnect(), SQLConnect(), SQLDriverConnect() X X X X X SQLCloseCursor(), SQLFreeStmt() X SQLEndTran(), SQLTransact() X4 X X X X X X
X X X
X X X X X
CONNECT (Tipo 2)
738
Command Reference

Tabla 9. Sentencias de SQL (DB2 Universal Database) (continuacin) Sentencia de SQL Dinmico1 Procesador Interfaz de nivel de llamada3 (CLI) de lnea de mandatos (CLP) X X X Proc. SQL
CREATE { ALIAS, BUFFERPOOL, DISTINCT TYPE, EVENT MONITOR, FUNCTION, FUNCTION MAPPING,9 INDEX, INDEX EXTENSION, METHOD, NICKNAME,9 NODEGROUP, PROCEDURE, SCHEMA, SERVER, TABLE, TABLESPACE, TRANSFORM, TYPE MAPPING,9 TRIGGER, USER MAPPING,9 TYPE, VIEW, WRAPPER9 } DECLARE CURSOR2 DECLARE GLOBAL TEMPORARY TABLE DELETE DESCRIBE
8
X10
X X X X X X
SQLAllocStmt() X X SQLColAttributes(), SQLDescribeCol(), SQLDescribeParam()6 SQLDisconnect() X SQLExecute() SQLExecDirect()
X X X
DISCONNECT DROP END DECLARE SECTION2 EXECUTE EXECUTE IMMEDIATE EXPLAIN FETCH FLUSH EVENT MONITOR sentencia FOR FREE LOCATOR GET DIAGNOSTICS sentencia GOTO GRANT X X X X
X X
X10
X X X
X X X
SQLExtendedFetch(), SQLFetch(), X SQLFetchScroll() X X X

4
X X X
739

Tabla 9. Sentencias de SQL (DB2 Universal Database) (continuacin) Sentencia de SQL Dinmico1 Procesador Interfaz de nivel de llamada3 (CLI) de lnea de mandatos (CLP) Proc. SQL
sentencia IF INCLUDE INSERT ITERATE sentencia LEAVE LOCK TABLE sentencia LOOP OPEN PREPARE REFRESH TABLE RELEASE RELEASE SAVEPOINT RENAME TABLE RENAME TABLESPACE sentencia REPEAT sentencia RESIGNAL sentencia RETURN REVOKE ROLLBACK SAVEPOINT sentencia-seleccin SELECT INTO SET CONNECTION SET CURRENT DEFAULT TRANSFORM GROUP SET CURRENT DEGREE SET CURRENT EXPLAIN MODE SET CURRENT EXPLAIN SNAPSHOT X X X X X X X X X SQLSetConnection() X X X, SQLSetConnectAttr() X, SQLSetConnectAttr() X X X X X X X X X SQLEndTran(), SQLTransact() X X X X X X X X X X X X X X X SQLExecute(), SQLExecDirect() SQLPrepare() X X X X
2
X X X X X X X
X X
X X X
X X X X
X X X X
740
Command Reference

SET CURRENT PACKAGESET SET CURRENT QUERY OPTIMIZATION SET CURRENT REFRESH AGE SET EVENT MONITOR STATE SET INTEGRITY SET PASSTHRU SET PATH SET SCHEMA SET SERVER OPTION
9 5 9
X X X X X X X X X
X X X X X X X X X
X X X X X X X X X
X X X
X X X X X X
SET variable-transicin sentencia SIGNAL SIGNAL SQLSTATE UPDATE VALUES INTO WHENEVER
2 5
X X
X X
X X X X
sentencia WHILE
741

Notas: 1. Puede codificar todas las sentencias de esta lista como SQL esttico, pero slo las marcadas con X como SQL dinmico. 2. No puede ejecutar esta sentencia. 3. Una X indica que puede ejecutar esta sentencia utilizando SQLExecDirect() o SQLPrepare() y SQLExecute(). Si existe una funcin CLI de DB2 equivalente, se lista el nombre de funcin. 4. Aunque esta sentencia no es dinmica, con CLI de DB2 puede especificar esta sentencia al llamar a SQLExecDirect() o SQLPrepare() and SQLExecute(). 5. Slo puede utilizar esto en sentencias CREATE TRIGGER. 6. Slo puede utilizar la sentencia DESCRIBE de SQL para describir salida, mientras que con CLI de DB2 tambin puede describir entrada (utilizando la funcin SQLDescribeParam()). 7. Slo puede utilizar la sentencia FETCH de SQL para captar una fila a la vez en una direccin, mientras que con las funciones de CLI de DB2 SQLExtendedFetch() y SQLFetchScroll(), puede captar en matrices. Adems, puede buscar y cargar en cualquier direccin y en cualquier posicin del conjunto de resultados. 8. La sentencia DESCRIBE de SQL tiene una sintaxis diferente de la del mandato DESCRIBE de CLP. 9. Esta sentencia slo recibe soporte para servidores de bases de datos federados. 10. Los procedimientos SQL slo pueden emitir las sentencias CREATE y DROP para ndices, tablas y vistas.
742
Command Reference
Apndice A. Lectura de los diagramas de sintaxis

Un diagrama de sintaxis muestra cmo se debe especificar un mandato para que el sistema operativo pueda interpretar correctamente lo que se escribe. Los diagramas de sintaxis se leen de izquierda a derecha y de arriba a abajo siguiendo la lnea horizontal (la ruta principal). Si la lnea finaliza con una punta de flecha, la sintaxis del mandato contina y la lnea siguiente empieza con una punta de flecha. El final de la sintaxis del mandato se marca con una barra vertical. Al escribir informacin de un diagrama de sintaxis, asegrese de incluir la puntuacin, por ejemplo comillas o signos de igual. Los parmetros se clasifican como palabras clave o variables: v Las palabras clave representan constantes y se muestran en letras maysculas; sin embargo, en el indicador de mandatos, las palabras clave pueden entrarse en maysculas, en minsculas o en maysculas y minsculas combinadas. Un nombre de mandato es un ejemplo de palabra clave. v Las variables representan nombres o valores proporcionados por el usuario y se muestran en letras minsculas; sin embargo, en el indicador de mandatos, las variables pueden entrarse en maysculas, en minsculas o en maysculas y minsculas combinadas, a no ser que se establezcan explcitamente restricciones de maysculas y minsculas. Un nombre de archivo es un ejemplo de variable. Un parmetro puede ser una combinacin de palabra clave y variable. Los parmetros necesarios se visualizan en la ruta principal:
MANDATO parmetro necesario
Los parmetros opcionales se visualizan debajo de la ruta principal:

MANDATO parmetro opcional
743
Lectura de los diagramas de sintaxis

El valor por omisin de un parmetro se visualiza encima de la ruta:
MANDATO PARMOPC VALOR1 VALOR2 VALOR3 VALOR4
Una pila de parmetros, con el primer parmetro visualizado en la ruta principal, indica que se debe seleccionar uno de los parmetros:
MANDATO opcin necesaria1 opcin necesaria2
Una pila de parmetros, con el primer parmetro visualizado debajo de la ruta principal, indica que se puede seleccionar uno de los parmetros:
MANDATO opcin_opcional1 opcin_opcional2
Una flecha que vuelve a la izquierda, por encima de la ruta, indica que los elementos se pueden repetir de acuerdo con los convenios siguientes: v Si la flecha no se interrumpe, el elemento puede repetirse en una lista con los elementos separados mediante espacios en blanco:
MANDATO
parmetro repetible
v Si la flecha contiene una coma, el elemento se puede repetir en una lista con los elementos separados mediante comas:
, MANDATO parmetro_repetible
Los elementos de las pilas de parmetros pueden repetirse de acuerdo con los convenios de pila para los parmetros necesarios y opcionales descritos anteriormente. Algunos diagramas de sintaxis contienen pilas de parmetros dentro de otras pilas de parmetros. Los elementos de las pilas slo se pueden repetir de acuerdo con los convenios descritos anteriormente. Es decir, si una pila interna no tiene una flecha de repeticin encima, pero una pila externa s la tiene, slo se puede elegir un parmetro de la pila interna y combinarse con
744
Command Reference

cualquier parmetro de la pila externa, y dicha combinacin se puede repetir. Por ejemplo, el diagrama siguiente muestra que se puede combinar el parmetro opcin2a con el parmetro opcin2 y luego repetir dicha combinacin otra vez (opcin2 ms opcin2a):
MANDATO parmetro opcin1 parmetro opcin2 parmetro opcin2a parmetro opcin2b parmetro opcin2c
parmetro opcin3
Algunos mandatos van precedidos de un parmetro de va de acceso opcional:

MANDATO vaacceso
Si no se proporciona este parmetro, el sistema busca el mandato en el directorio actual. Si no puede encontrar el mandato, el sistema contina buscando el mandato en todos los directorios de las vas de acceso listadas en el .profile. Algunos mandatos tienen variantes sintcticas que son funcionalmente equivalentes:
FORMATO1 MANDATO FORMATO2 MANDATO
Apndice A. Lectura de los diagramas de sintaxis
745
746
Command Reference
Apndice B. Convenios de denominacin

Esta seccin proporciona informacin acerca de los convenios que se aplican al denominar los objetos del gestor de bases de datos, por ejemplo las bases de datos y las tablas, y los ID de autentificacin. v Las series de caracteres que representan nombres de objetos del gestor de bases de datos pueden contener cualquiera de los caracteres siguientes: a-z, A-Z, 0-9, @, # y $. v El primer carcter de la serie debe ser un carcter alfabtico, @, # o $; no puede ser un nmero o las secuencias de letras SYS, DBM o IBM. v A no ser que se indique lo contrario, los nombres pueden entrarse en letras minsculas; sin embargo, el gestor de bases de datos los procesa como si fueran maysculas. La excepcin a esto son las series de caracteres que representan nombres bajo la arquitectura de red de sistemas (SNA). Muchos valores, por ejemplo nombres de unidad lgica (lu_asociada y lu_local), son sensibles a las maysculas y minsculas. El nombre debe entrarse exactamente igual que aparece en las definiciones SNA que corresponden a esos trminos. v Un nombre de base de datos o un alias de base de datos es una serie de caracteres exclusiva que contiene de una a ocho letras o de uno a ocho nmeros o caracteres de teclado del conjunto descrito anteriormente. Las bases de datos se catalogan en el sistema y en los directorios de bases de datos locales por sus alias en un campo y por su nombre original en otro. Para la mayora de las funciones, el gestor de bases de datos utiliza el nombre entrado en el campo de alias de los directorios de bases de datos. (CHANGE DATABASE COMMENT y CREATE DATABASE, donde se debe especificar una va de acceso de directorio, son excepciones). v El nombre o el nombre de alias de una tabla o una vista es un identificador SQL que es una serie de caracteres exclusiva de 1 a 128 caracteres de longitud. Los nombres de columna pueden tener de 1 a 30 caracteres de longitud. Un nombre de tabla totalmente calificado consta de esquema.nombretabla. El esquema es el ID de usuario exclusivo bajo el que se ha creado la tabla. El nombre de esquema para una tabla declarada temporal debe ser SESSION. v Los ID de autentificacin no pueden tener ms de 30 caracteres en Sistemas operativos Windows de 32 bits y de 8 caracteres en todos los dems sistemas operativos. v Los ID de grupo no pueden tener ms de 8 caracteres de longitud. v Los alias locales para nodos remotos que deben catalogarse en el directorio de nodos no pueden tener ms de ocho caracteres de longitud.
747
748
Command Reference
Apndice C. Informacin tcnica sobre DB2 Universal Database

Visin general de la informacin tcnica de DB2 Universal Database
La informacin tcnica de DB2 Universal Database puede obtenerse en los formatos siguientes: v Manuales (formatos PDF y copia impresa) v Un rbol de temas (formato HTML) v Herramientas de ayuda para DB2 (formato HTML) v Programas de ejemplo (formato HTML) v Ayuda de lnea de mandatos v Guas de aprendizaje Esta seccin es una visin general de la informacin tcnica que se proporciona y del modo en que se puede acceder a ella.
FixPaks para la documentacin de DB2

IBM puede poner peridicamente a disposicin del usuario FixPaks de documentacin. Los FixPaks de documentacin permiten actualizar la informacin que se instal desde el CD de documentacin HTML de DB2 a medida que aparece nueva informacin. Nota: Si instala los FixPaks de documentacin, la documentacin HTML contendr informacin ms reciente que los manuales de DB2 en formato PDF en lnea o impresos.
Categoras de la informacin tcnica de DB2

La informacin tcnica de DB2 se clasifica por categoras con las cabeceras siguientes: v Informacin bsica de DB2 v Informacin de administracin v v v v v v v Informacin para el desarrollo de aplicaciones Informacin de Inteligencia empresarial Informacin de DB2 Connect Informacin de iniciacin Informacin de aprendizaje Informacin sobre componentes opcionales Notas del release
749
Las tablas siguientes describen, para cada manual de la biblioteca de DB2, la informacin necesaria para solicitar la copia impresa, imprimir o ver el PDF o localizar el directorio de HTML de dicho manual. En el Centro de publicaciones de IBM de la direccin www.ibm.com/shop/publications/order se encuentra disponible una descripcin completa de cada uno de los manuales de la biblioteca de DB2. El directorio de instalacin del CD de documentacin HTML es diferente para cada categora de informacin:
vaaccesocdhtml/doc/htmlcd/%L/categora
donde: v vaaccesocdhtml es el directorio donde est instalado el CD de HTML. v %L es el identificador de idioma. Por ejemplo, es_ES. v categora es el identificador de categora. Por ejemplo, core para la informacin bsica de DB2. En la columna de nombre de archivo PDF de las tablas siguientes, el carcter situado en la sexta posicin del nombre de archivo indica la versin de idioma de un manual. Por ejemplo, el nombre de archivo db2d1e80 identifica la versin inglesa del manual Administration Guide: Planning y el nombre de archivo db2d1g80 identifica la versin alemana del mismo manual. En la sexta posicin de los nombres de archivo se utilizan las letras siguientes para indicar el idioma del manual:
Idioma Alemn Blgaro Checo Chino simplificado Chino tradicional Coreano Croata Dans Eslovaco Esloveno Espaol Finlands Francs Griego Holands Hngaro Ingls Italiano Japons Identificador g u x c t k 9 d 7 l z y f a q h e i j
750
Command Reference
Noruego Polaco Portugus de Brasil Portugus Rumano Ruso Sueco Turco rabe
n p b v 8 r s m w
Sin nmero de documento indica que el manual slo est disponible en lnea y no tiene una versin impresa. Informacin bsica de DB2 La informacin de esta categora incluye temas de DB2 que son fundamentales para todos los usuarios de DB2. Encontrar til la informacin de esta categora tanto si es programador o administrador de bases de datos como si trabaja con DB2 Connect, DB2 Warehouse Manager u otros productos DB2. El directorio de instalacin de esta categora es doc/htmlcd/%L/core.
Tabla 10. Informacin bsica de DB2 Nombre IBM DB2 Universal Database Consulta de mandatos IBM DB2 Universal Database Glosario IBM DB2 Universal Database Master Index Nmero de documento SC10-3725 Sin nmero de documento SC09-4839 Nombre de archivo PDF db2n0x80 db2t0x80 db2w0x80 db2m1x80
IBM DB2 Universal Database GC10-3728 Consulta de mensajes, Volumen 1 GC10-3729 IBM DB2 Universal Database Consulta de mensajes, Volumen 2 IBM DB2 Universal Database Novedades SC10-3734
db2m2x80
db2q0x80
Informacin de administracin La informacin de esta categora incluye los temas necesarios para disear, implementar y mantener de forma efectiva bases de datos de DB2, depsitos de datos y sistemas federados.
751
El directorio de instalacin de esta categora es doc/htmlcd/%L/admin.

Tabla 11. Informacin de administracin Nombre IBM DB2 Universal Database Administration Guide: Planning IBM DB2 Universal Database Administration Guide: Implementation IBM DB2 Universal Database Administration Guide: Performance IBM DB2 Universal Database Administrative API Reference Nmero de documento SC09-4822 Nombre de archivo PDF db2d1x80
SC09-4820
db2d2x80
SC09-4821
db2d3x80
SC09-4824
db2b0x80 db2dmx80
IBM DB2 Universal Database SC09-4830 Data Movement Utilities Guide and Reference IBM DB2 Universal Database Data Recovery and High Availability Guide and Reference IBM DB2 Universal Database Data Warehouse Center Administration Guide IBM DB2 Universal Database Federated Systems Guide SC09-4831
db2hax80
SC27-1123
db2ddx80
GC27-1224
db2fpx80 db2atx80
SC10-3732 IBM DB2 Universal Database Gua de las herramientas de la GUI para la administracin y el desarrollo IBM DB2 Universal Database SC27-1121 Replication Guide and Reference IBM DB2 Instalacin y administracin de un entorno de satlites IBM DB2 Universal Database Consulta de SQL, Volumen 1 IBM DB2 Universal Database Consulta de SQL, Volumen 2 IBM DB2 Universal Database System Monitor Guide and Reference GC10-3770
db2e0x80 db2dsx80
SC10-3730 SC10-3731 SC09-4847
db2s1x80 db2s2x80 db2f0x80
752
Command Reference
Informacin para el desarrollo de aplicaciones La informacin de esta categora es de especial inters para los programadores de aplicaciones o programadores que trabajan con DB2. Encontrar informacin acerca de los lenguajes y compiladores soportados, as como la documentacin necesaria para acceder a DB2 utilizando las diversas interfaces de programacin soportadas, por ejemplo SQL incorporado, ODBC, JDBC, SQLj y CLI. Si visualiza esta informacin en lnea en HTML, tambin podr acceder a un conjunto de programas de DB2 de ejemplo en HTML. El directorio de instalacin de esta categora es doc/htmlcd/%L/ad.
Tabla 12. Informacin para el desarrollo de aplicaciones Nombre IBM DB2 Universal Database Gua de desarrollo de aplicaciones: Creacin y ejecucin de aplicaciones IBM DB2 Universal Database Gua de desarrollo de aplicaciones: Programacin de aplicaciones de cliente IBM DB2 Universal Database Gua de desarrollo de aplicaciones: Programacin de aplicaciones de servidor IBM DB2 Universal Database Call Level Interface Guide and Reference, Volume 1 IBM DB2 Universal Database Call Level Interface Guide and Reference, Volume 2 IBM DB2 Universal Database Data Warehouse Center Application Integration Guide Nmero de documento SC10-3733 Nombre de archivo PDF db2axx80
SC10-3723
db2a1x80
SC10-3724
db2a2x80
SC09-4849
db2l1x80
SC09-4850
db2l2x80
SC27-1124
db2adx80
IBM DB2 XML Extender SC10-3750 Administracin y programacin
db2sxx80
753
Informacin de inteligencia empresarial La informacin de esta categora describe cmo utilizar los componentes que mejoran las posibilidades de anlisis y de depsito de datos de DB2 Universal Database. El directorio de instalacin de esta categora es doc/htmlcd/%L/wareh.
Tabla 13. Informacin de Inteligencia empresarial Nombre IBM DB2 Warehouse Manager Information Catalog Center Administration Guide IBM DB2 Warehouse Manager Gua de instalacin Nmero de documento SC27-1125 Nombre de archivo PDF db2dix80
GC10-3746
db2idx80
Informacin de DB2 Connect La informacin de esta categora describe cmo acceder a los datos de sistema principal o de iSeries utilizando DB2 Connect Enterprise Edition o DB2 Connect Personal Edition. El directorio de instalacin de esta categora es doc/htmlcd/%L/conn.
Tabla 14. Informacin de DB2 Connect Nombre APPC, CPI-C, and SNA Sense Codes IBM Connectivity Supplement IBM DB2 Connect Gua rpida de iniciacin para DB2 Enterprise Edition IBM DB2 Connect Quick Beginnings for DB2 Connect Personal Edition IBM DB2 Connect Users Guide Nmero de documento Sin nmero de documento Sin nmero de documento GC10-3774 Nombre de archivo PDF db2apx80 db2h1x80 db2c6x80
GC09-4834
db2c1x80
SC09-4835
db2c0x80
754
Command Reference
Informacin de iniciacin La informacin de esta categora es til cuando se van a instalar y configurar servidores, clientes y otros productos de DB2. El directorio de instalacin de esta categora es doc/htmlcd/%L/start.
Tabla 15. Informacin de iniciacin Nombre IBM DB2 Universal Database Gua rpida de iniciacin para clientes de DB2 IBM DB2 Universal Database Gua rpida de iniciacin para servidores de DB2 IBM DB2 Universal Database Gua rpida de iniciacin para DB2 Personal Edition IBM DB2 Universal Database Suplemento de instalacin y configuracin IBM DB2 Universal Database Gua rpida de iniciacin para DB2 Data Links Manager Nmero de documento GC10-3775 Nombre de archivo PDF db2itx80
GC10-3773
db2isx80
GC10-3771
db2i1x80
GC10-3772
db2iyx80
GC10-3726
db2z6x80
Informacin de aprendizaje La informacin de aprendizaje presenta las caractersticas de DB2 y explica cmo realizar diversas tareas. El directorio de instalacin de esta categora es doc/htmlcd/%L/tutr.
Tabla 16. Informacin de aprendizaje Nombre Gua de aprendizaje de Inteligencia empresarial: Introduccin al depsito de datos Gua de aprendizaje de Inteligencia empresarial: Lecciones ampliadas sobre el depsito de datos Development Center Tutorial for Video Online using Microsoft Visual Basic Nmero de documento Sin nmero de documento Nombre de archivo PDF db2tux80
Sin nmero de documento
db2tax80
Sin nmero de documento
db2tdx80
755
Tabla 16. Informacin de aprendizaje (continuacin) Nombre Information Catalog Center Tutorial Gua de aprendizaje de Video Central para e-business Gua de aprendizaje de Visual Explain Nmero de documento Sin nmero de documento Sin nmero de documento Sin nmero de documento Nombre de archivo PDF db2aix80 db2twx80 db2tvx80
Informacin sobre componentes opcionales La informacin de esta categora describe cmo trabajar con los componentes opcionales de DB2. El directorio de instalacin de esta categora es doc/htmlcd/%L/opt.
Tabla 17. Informacin sobre componentes opcionales Nombre IBM DB2 Life Sciences Data Connect Gua de planificacin, instalacin y configuracin Nmero de documento SC10-3747 Nombre de archivo PDF db2lsx80
IBM DB2 Spatial Extender SC10-3755 Gua del usuario y de consulta IBM DB2 Universal Database Data Links Manager Administration Guide and Reference SC27-1221
db2sbx80 db2z0x80
IBM DB2 Universal Database SH10-9305 Net Search Extender Gua de administracin y programacin Nota: El HTML para este documento no se instala desde el CD de documentacin HTML.
N/D
Notas del release Las notas del release proporcionan informacin adicional especfica del release y nivel de FixPak del producto. Tambin proporcionan resmenes de las actualizaciones de la documentacin que se han incorporado en cada release y FixPak.
756
Command Reference
Tabla 18. Notas del release Nombre Notas del release de DB2 Notas de instalacin de DB2 Nmero de documento Ver nota. Slo disponible en el CD-ROM del producto. Nombre de archivo PDF Ver nota. Slo disponible en el CD-ROM del producto.
Nota: La versin HTML de las notas del release est disponible en el Centro de informacin y en los CD-ROM del producto. Para ver el archivo ASCII en plataformas basadas en UNIX, consulte el archivo Release.Notes. Este archivo se encuentra en el directorio DB2DIR/Readme/%L, donde %L representa el nombre de entorno nacional y DB2DIR representa: v /usr/opt/db2_08_01 en AIX v /opt/IBM/db2/V8.1 en todos los dems sistemas operativos UNIX Tareas relacionadas: v Impresin de manuales de DB2 desde archivos PDF en la pgina 757 v Solicitud de manuales de DB2 impresos en la pgina 758 v Acceso a la ayuda en lnea en la pgina 759 v Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin en la pgina 763 v Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2 en la pgina 765
Impresin de manuales de DB2 desde archivos PDF

Puede imprimir los manuales de DB2 desde los archivos PDF del CD de documentacin PDF de DB2. Mediante la utilizacin de Adobe Acrobat Reader, puede imprimir el manual entero o un rango especfico de pginas. Prerrequisitos: Asegrese de tener Adobe Acrobat Reader. Est disponible en el sitio Web de Adobe en www.adobe.com Procedimiento: Para imprimir un manual de DB2 desde un archivo PDF:
757
1. Inserte el CD de documentacin PDF de DB2. En sistemas operativos UNIX, monte el CD de documentacin PDF de DB2. Consulte el manual Iniciacin rpida para obtener detalles sobre cmo montar un CD en sistemas operativos UNIX. 2. Inicie Adobe Acrobat Reader. 3. Abra un archivo PDF desde una de las ubicaciones siguientes: v En sistemas operativos Windows: x:\doc\idioma, donde x representa la letra de unidad del CD-ROM e idioma representa el cdigo de territorio de dos caracteres que representa el idioma (por ejemplo, EN para ingls). v En sistemas operativos UNIX: /cdrom/doc/%L del CD-ROM, donde /cdrom representa el punto de montaje del CD-ROM y %L representa el entorno nacional deseado. Tareas relacionadas: v Solicitud de manuales de DB2 impresos en la pgina 758 v Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin en la pgina 763 v Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2 en la pgina 765 Informacin relacionada: v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Solicitud de manuales de DB2 impresos

Procedimiento: Para solicitar manuales impresos: v Pngase en contacto con el distribuidor autorizado o representante de mrketing de IBM. Para encontrar un representante local de IBM, consulte el directorio mundial de contactos de IBM en la pgina Web www.ibm.com/planetwide v Llame al telfono 1-800-879-2755, si est en los EE.UU. o al 1-800-IBM-4YOU, si est en Canad. v Visite el Centro de publicaciones de IBM en www.ibm.com/shop/publications/order Tambin puede obtener manuales de DB2 impresos si solicita los Doc Pack para el producto DB2 a su distribuidor de IBM. Los Doc Pack son
758
Command Reference
subconjuntos de los manuales de la biblioteca de DB2 seleccionados con el objeto de ayudar al usuario a empezar a utilizar el producto DB2 que ha adquirido. Los manuales de los Doc Pack son los mismos que los que se encuentran en formato PDF en el CD de documentacin PDF de DB2 y presentan el mismo contenido que la documentacin que se encuentra en el CD de documentacin HTML de DB2. Tareas relacionadas: v Impresin de manuales de DB2 desde archivos PDF en la pgina 757 v Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador en la pgina 761 v Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2 en la pgina 765 Informacin relacionada: v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Acceso a la ayuda en lnea

La ayuda en lnea que viene con todos los componentes de DB2 est disponible en tres tipos: v Ayuda de ventana y de cuaderno v Ayuda de lnea de mandatos v Ayuda de sentencia de SQL La ayuda de ventana y de cuaderno explica las tareas que se pueden realizar en una ventana o un cuaderno y describe los controles. Esta ayuda tiene dos tipos: v Ayuda accesible desde el botn Ayuda v Ventanas emergentes de informacin El botn Ayuda proporciona acceso a la informacin de visin general y de prerrequisitos. Las ventanas emergentes de informacin describen los controles de la ventana o del cuaderno. La ayuda de ventana y de cuaderno est disponible en los centros y componentes de DB2 que tienen interfaces de usuario. La ayuda de lnea de mandatos incluye ayuda de mandatos y ayuda de mensajes. La ayuda de mandatos explica la sintaxis de los mandatos del procesador de lnea de mandatos. La ayuda de mensajes describe la causa de un mensaje de error y describe la accin que se debe realizar en respuesta al error.
759
La ayuda de sentencia de SQL incluye la ayuda de SQL y la ayuda de SQLSTATE. DB2 devuelve un valor de SQLSTATE para las condiciones que pueden ser el resultado de una sentencia de SQL. La ayuda de SQLSTATE explica la sintaxis de las sentencias de SQL (cdigos de clase y estados de SQL). Nota: Para los sistemas operativos UNIX no hay ayuda de SQL disponible. Procedimiento: Para acceder a la ayuda en lnea: v Para la ayuda de ventana y cuaderno, pulse Ayuda o pulse dicho control y, a continuacin, pulse F1. Si se selecciona el recuadro de seleccin Visualizar automticamente ventanas emergentes de informacin en la pgina General del cuaderno Valores de herramientas, tambin podr ver la ventana emergente de informacin para un control determinado manteniendo el cursor del ratn sobre el control. v Para la ayuda de lnea de mandatos, abra el procesador de lnea de mandatos y entre: Para la ayuda de mandatos:
? mandato
donde mandato representa una palabra clave o el mandato completo. Por ejemplo, ? catalog visualiza la ayuda para todos los mandatos CATALOG, mientras que ? catalog database visualiza la ayuda para el mandato CATALOG DATABASE. v Para la ayuda de mensajes:
? XXXnnnnn
donde XXXnnnnn representa un identificador de mensaje vlido. Por ejemplo, ? SQL30081 visualiza la ayuda acerca del mensaje SQL30081. v Para la ayuda de sentencia de SQL, abra el procesador de lnea de mandatos y entre:
? sqlstate o ? cdigo de clase
donde sqlstate representa un estado de SQL vlido de cinco dgitos y cdigo de clase representa los dos primeros dgitos del estado de SQL. Por ejemplo, ? 08003 visualiza la ayuda para el estado de SQL 08003, mientras que ? 08 visualiza la ayuda para el cdigo de clase 08. Tareas relacionadas:
760
Command Reference
v Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador en la pgina 761 v Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2 en la pgina 765
Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador

Si accede al Centro de informacin de DB2 desde un navegador podr acceder a la informacin que necesita para obtener el mximo provecho de DB2 Universal Database y DB2 Connect. El Centro de informacin de DB2 tambin documenta las caractersticas y los componentes principales de DB2, entre ellos, la duplicacin, el almacenamiento de datos, los metadatos y DB2 Extenders. El Centro de informacin de DB2 al que se accede desde un navegador se compone de los siguientes elementos principales: rbol de navegacin El rbol de navegacin est ubicado en el marco izquierdo de la ventana del navegador. El rbol se expande y se contrae para mostrar y ocultar los temas, el glosario y el ndice maestro del Centro de informacin de DB2. Barra de herramientas de navegacin La barra de herramientas de navegacin est ubicada en el marco superior derecho de la ventana del navegador. La barra de herramientas de navegacin contiene botones que permiten realizar bsquedas en el Centro de informacin de DB2, ocultar el rbol de navegacin y buscar el tema visualizado actualmente en el rbol de navegacin. Marco de contenido El marco de contenido est ubicado en el marco inferior derecho de la ventana del navegador. El marco de contenido visualiza los temas del Centro de informacin de DB2 cuando se pulsa un enlace en el rbol de navegacin, se pulsa un resultado de bsqueda o se sigue un enlace desde otro tema o desde el ndice maestro. Prerrequisitos: Para acceder al Centro de informacin de DB2 desde un navegador, deber utilizar uno de los navegadores siguientes: v Microsoft Explorer, versin 5 o posterior v Netscape Navigator, versin 6.1 o posterior Restricciones:
761
El Centro de informacin de DB2 slo contiene los conjuntos de temas que se elige instalar desde el CD de documentacin HTML de DB2. Si el navegador Web devuelve un error Archivo no encontrado cuando se intenta seguir un enlace a un tema, habr que instalar uno o varios conjuntos de temas adicionales del CD de documentacin HTML de DB2. Procedimiento: Para encontrar un tema buscndolo mediante palabras clave: 1. 2. En la barra de herramientas de navegacin, pulse Buscar. En el campo de entrada de texto superior de la ventana Buscar, escriba uno o ms trminos relacionados con el rea de inters, y pulse Buscar. Se visualiza una lista de temas clasificados por exactitud en el campo Resultados. La clasificacin numrica junto al acierto proporciona una indicacin de la importancia de la coincidencia (los nmeros ms altos indican resultados coincidentes ms importantes).
La entrada de ms trminos aumentar la precisin de la consulta al mismo tiempo que reducir el nmero de temas devueltos. 3. En el campo Resultados, pulse el ttulo del tema que desea leer. El tema se visualiza en el marco de contenido. Para buscar un tema en el rbol de navegacin: 1. En el rbol de navegacin, pulse el icono de libro de la categora de temas relacionados con el rea de inters. Se visualiza una lista de subcategoras bajo el icono. 2. Contine pulsando los iconos de libro hasta que encuentre la categora que contiene los temas en los que est interesado. Las categoras que enlazan con temas visualizan el ttulo de categora como un enlace subrayado al mover el cursor sobre el ttulo de categora. El rbol de navegacin identifica los temas con un icono de pgina. 3. Pulse el enlace al tema. El tema se visualiza en el marco de contenido.
Para buscar un tema o un trmino en el ndice maestro: 1. En el rbol de navegacin, pulse la categora ndice. La categora se expande para visualizar una lista de enlaces ordenados alfabticamente en el rbol de navegacin. 2. En el rbol de navegacin, pulse el enlace correspondiente al primer carcter del trmino relacionado con el tema en el que est interesado. En el marco de contenido se visualiza una lista de trminos con dicho carcter inicial. Los trminos que tienen varias entradas de ndice se identifican mediante un icono de libro.
762
Command Reference
3.
Pulse el icono de libro correspondiente al trmino en el que est interesado. Se visualiza una lista de subtrminos y temas debajo del trmino que ha pulsado. Los temas se identifican mediante iconos de pgina con un ttulo subrayado. 4. Pulse el ttulo del tema que satisface sus necesidades. El tema se visualiza en el marco de contenido. Conceptos relacionados: v Accesibilidad en la pgina 771 v Acceso al Centro de informacin de DB2 desde un navegador en la pgina 773 Tareas relacionadas: v Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin en la pgina 763 v Actualizacin de la documentacin HTML instalada en la mquina en la pgina 766 v Resolucin de problemas de bsqueda de documentacin de DB2 con Netscape 4.x en la pgina 768 v Bsqueda en la documentacin de DB2 en la pgina 769 Informacin relacionada: v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin
El Centro de informacin de DB2 proporciona acceso rpido a la informacin de productos de DB2 y est disponible en todos los sistemas operativos para los que estn disponibles las herramientas de administracin de DB2. El Centro de informacin de DB2 al que se accede desde las herramientas proporciona seis tipos de informacin. Tareas Tareas clave que puede realizar mediante DB2. Conceptos Conceptos clave para DB2. Consulta Informacin de consulta de DB2, tal como palabras clave, mandatos y las API.
763
Resolucin de problemas Mensajes de error e informacin para ayudarle con los problemas comunes de DB2. Ejemplos Enlaces a listados HTML de los programas de ejemplo proporcionados con DB2. Guas de aprendizaje Ayuda con instrucciones diseada para ayudarle a conocer una caracterstica de DB2. Prerrequisitos: Algunos enlaces del Centro de informacin de DB2 apuntan a sitios Web de Internet. Para visualizar el contenido de estos enlaces, primero tendr que conectarse a Internet. Procedimiento: Para buscar informacin del producto accediendo al Centro de informacin de DB2 desde las herramientas: 1. Inicie el Centro de informacin de DB2, de uno de los modos siguientes: v Desde las herramientas de administracin grficas, pulse el icono Centro de informacin de la barra de herramientas. Tambin lo puede seleccionar desde el men Ayuda. v En la lnea de mandatos, entre db2ic. 2. Pulse la pestaa del tipo de informacin relacionado con la informacin que est buscando. 3. Navegue por el rbol y pulse el tema en el que est interesado. El Centro de informacin lanzar un navegador Web para visualizar la informacin. 4. Para buscar informacin sin examinar las listas, pulse el icono Buscar situado a la derecha de la lista. Una vez que el Centro de informacin haya lanzado un navegador para visualizar la informacin, podr realizar una bsqueda de texto completo pulsando el icono Buscar en la barra de herramientas de navegacin. Conceptos relacionados: v Accesibilidad en la pgina 771 v Acceso al Centro de informacin de DB2 desde un navegador en la pgina 773 Tareas relacionadas:
764
Command Reference
v Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador en la pgina 761 v Bsqueda en la documentacin de DB2 en la pgina 769
Cmo ver documentacin tcnica en lnea directamente desde el CD de documentacin HTML de DB2
Todos los temas HTML que se pueden instalar desde el CD de documentacin HTML de DB2 tambin se pueden leer directamente del CD. Por consiguiente, puede ver la documentacin sin tener que instalarla. Restricciones: Dado que la ayuda de Herramientas se instala desde el CD del producto DB2 y no desde el CD de documentacin HTML de DB2, deber instalar el producto DB2 para poder ver la ayuda. Procedimiento: 1. Inserte el CD de documentacin HTML de DB2. En los sistemas operativos UNIX, monte el CD de documentacin HTML de DB2. Consulte el manual Iniciacin rpida para obtener informacin ms detallada sobre cmo montar un CD en sistemas operativos UNIX. 2. Inicie el navegador HTML y abra el archivo apropiado: v Para sistemas operativos Windows:
e:\archivos de programa\IBM\SQLLIB\doc\htmlcd\%L\index.htm
donde e representa la unidad de CD-ROM y %L es el entorno nacional de la documentacin que desea utilizar, por ejemplo es_ES para el espaol. v Para sistemas operativos UNIX:
/cdrom/archivos de programa/IBM/SQLLIB/doc/htmlcd/%L/index.htm
donde /cdrom/ representa el lugar en el que est montado el CD y %L es el entorno nacional de la documentacin que desea utilizar, por ejemplo es_Es para el espaol. Tareas relacionadas: v Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador en la pgina 761 v Copia de archivos desde el CD de documentacin HTML de DB2 en un servidor Web en la pgina 767 Informacin relacionada:
765
v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Actualizacin de la documentacin HTML instalada en la mquina

Ahora es posible actualizar el cdigo HTML instalado desde el CD de documentacin HTML de DB2 cuando IBM pone las actualizaciones a disposicin de los usuarios. Esta tarea puede realizarse de una de las dos maneras siguientes: v Utilizando el Centro de informacin (si tiene instaladas las herramientas de GUI de administracin de DB2). v Bajando y aplicando un FixPak de documentacin HTML de DB2. Nota: Esto NO actualizar el cdigo de DB2; slo actualizar la documentacin HTML instalada desde el CD de documentacin HTML de DB2. Procedimiento: Si desea utilizar el Centro de informacin para actualizar la documentacin local: 1. Inicie el Centro de informacin de DB2, de uno de los modos siguientes: v Desde las herramientas de administracin grficas, pulse el icono Centro de informacin de la barra de herramientas. Tambin lo puede seleccionar desde el men Ayuda. v En la lnea de mandatos, entre db2ic. 2. Asegrese de que la mquina tiene acceso a la Internet externa; el actualizador bajar el FixPak de documentacin ms reciente del servidor IBM si es necesario. 3. Seleccione Centro de informacin > Actualizar documentacin local en el men para iniciar la actualizacin. 4. Proporcione la informacin de proxy (si es necesaria) para conectarse a la Internet externa. El Centro de informacin bajar y aplicar el FixPak de documentacin ms reciente, si hay alguno disponible. Para bajar y aplicar manualmente el FixPak de documentacin: 1. Asegrese de que la mquina est conectada a Internet. 2. Abra la pgina de soporte de DB2 en el navegador Web, en la siguiente direccin: www.ibm.com/software/data/db2/udb/winos2unix/support. 3. Siga el enlace correspondiente a la Versin 8 y busque el enlace FixPaks de documentacin.
766
Command Reference
4. Determine si la versin de la documentacin local est anticuada, comparando el nivel de FixPak de documentacin con el nivel de documentacin que tiene instalado. Esta documentacin actual de la mquina est en el nivel siguiente: DB2 v8.1 GA. 5. Si se encuentra disponible una versin ms reciente de la documentacin, baje el FixPak aplicable al sistema operativo. Existe un FixPak para todas las plataformas Windows y un FixPak para todas las plataformas UNIX. 6. Aplique el FixPak: v Para sistemas operativos Windows: el FixPak de documentacin es un archivo zip de autoextraccin. Coloque el FixPak de documentacin que ha bajado en un directorio vaco y ejectelo. Crear un mandato setup que puede ejecutar para instalar el FixPak de documentacin. v Para sistemas operativos UNIX: el FixPak de documentacin es un archivo tar.Z comprimido. Descomprima y desempaquete el archivo mediante tar. Crear un directorio denominado delta_install con un script denominado installdocfix. Ejecute este script para instalar el FixPak de documentacin. Tareas relacionadas: v Copia de archivos desde el CD de documentacin HTML de DB2 en un servidor Web en la pgina 767 Informacin relacionada: v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Copia de archivos desde el CD de documentacin HTML de DB2 en un servidor Web

La biblioteca de informacin de DB2 entera se entrega al usuario en el CD de documentacin HTML de DB2 y se puede instalar en un servidor Web para acceder ms fcilmente a ella. Simplemente copie en el servidor Web la documentacin para los idiomas que desee. Nota: Puede encontrarse con un rendimiento bajo si accede a la documentacin HTML desde un servidor Web mediante una conexin de baja velocidad. Procedimiento: Para copiar archivos desde el CD de documentacin HTML de DB2 en un servidor Web, utilice la va de acceso origen apropiada: v Para sistemas operativos Windows:
E:\archivos de programa\IBM\SQLLIB\doc\htmlcd\%L\*.*
767
donde E representa la unidad de CD-ROM y %L representa el identificador de idioma. v Para sistemas operativos UNIX:
/cdrom/archivos de programa/IBM/SQLLIB/doc/htmlcd/%L/*.*
donde cdrom representa el punto de montaje para la unidad de CD-ROM y %L representa el identificador de idioma Tareas relacionadas: v Bsqueda en la documentacin de DB2 en la pgina 769 Informacin relacionada: v Idiomas, entornos locales y pginas de cdigos soportados por DB2 del manual Gua rpida de iniciacin para servidores de DB2 v Visin general de la informacin tcnica de DB2 Universal Database en la pgina 749
Resolucin de problemas de bsqueda de documentacin de DB2 con Netscape 4.x

La mayora de los problemas de bsqueda estn relacionados con el soporte Java proporcionado por los navegadores web. Esta tarea describe soluciones provisionales posibles. Procedimiento: Un problema comn con Netscape 4.x implica la ausencia o la colocacin errnea de una clase de seguridad. Intente la solucin provisional siguiente, especialmente si ve la lnea siguiente en la consola Java del navegador:
Cannot find class java/security/InvalidParameterException
v En sistemas operativos Windows: Desde el CD de documentacin HTML de DB2, copie el archivo x:archivos de programa\IBM\SQLLIB\doc\htmlcd\entorno_nacional\InvalidParameterException.class proporcionado en el directorio java\classes\java\security\ relativo a la instalacin del navegador Netscape, donde x representa la letra de unidad de CD-ROM y entorno_nacional representa el nombre del entorno nacional deseado. Nota: Puede que tenga que crear la estructura de subdirectorios java\security\. v En sistemas operativos UNIX: Desde el CD de documentacin HTML de DB2, copie el archivo /cdrom/archivos de
768
Command Reference
programa/IBM/SQLLIB/doc/htmlcd/entorno_nacional/InvalidParameterException.cla proporcionado en el directorio java/classes/java/security/ relativo a la instalacin del navegador Netscape, donde cdrom representa el punto de montaje del CD-ROM y entorno_nacional representa el nombre del entorno nacional deseado. Nota: Puede que tenga que crear la estructura de subdirectorios java/security/. Si el navegador Netscape sigue sin visualizar la ventana de entrada de bsqueda, intente lo siguiente: v Detenga todas las instancias de los navegadores Netscape para asegurarse de que no hay ningn cdigo de Netscape en ejecucin en la mquina. A continuacin, abra una instancia nueva del navegador Netscape e intente iniciar la bsqueda otra vez. v Depure la antememoria del navegador. v Pruebe una versin diferente de Netscape o un navegador diferente. Tareas relacionadas: v Bsqueda en la documentacin de DB2 en la pgina 769
Bsqueda en la documentacin de DB2

Puede efectuar bsquedas en la biblioteca de documentacin de DB2 para encontrar la informacin que necesita. Al pulsar el icono de bsqueda de la barra de herramientas de navegacin del Centro de informacin de DB2 (al que se accede desde un navegador), se abre una ventana emergente. La bsqueda pueda tardar un minuto en cargarse, en funcin de la velocidad del sistema y de la red. Prerrequisitos: Necesita Netscape 6.1 o posterior, o bien Internet Explorer 5 o posterior de Microsoft. Asegrese de que el soporte Java del navegador est habilitado. Restricciones: Al utilizar la bsqueda de documentacin se aplican las restricciones siguientes: v La bsqueda no distingue entre maysculas y minsculas. v No se soportan las bsquedas booleanas. v No se da soporte a bsquedas mediante caracteres comodn o parciales. Una bsqueda de java* (o java) slo buscar la serie literal java* (o java) y no encontrar, por ejemplo, javadoc.
769
Procedimiento: Si desea realizar bsquedas en la documentacin de DB2: 1. En la barra de herramientas de navegacin, pulse el icono Buscar. 2. En el campo de entrada de texto superior de la ventana Buscar, escriba uno o varios trminos (separados por un espacio) relacionados con el rea de inters y pulse Buscar. Se visualiza una lista de temas clasificados por exactitud en el campo Resultados. La clasificacin numrica junto al acierto proporciona una indicacin de la importancia de la coincidencia (los nmeros ms altos indican resultados coincidentes ms importantes). La entrada de ms trminos aumentar la precisin de la consulta al mismo tiempo que reducir el nmero de temas devueltos. 3. En la lista Resultados, pulse el ttulo del tema que desea leer. El tema se visualiza en el marco de contenido del Centro de informacin de DB2. Nota: Cuando se realiza una bsqueda, el primer resultado (clasificacin ms alta) se carga automticamente en el marco del navegador. Para ver el contenido de otros resultados de la bsqueda, pulse el resultado en la lista de resultados. Tareas relacionadas: v Resolucin de problemas de bsqueda de documentacin de DB2 con Netscape 4.x en la pgina 768
Informacin en lnea de resolucin de problemas de DB2

En el release de DB2 UDB Versin 8, ya no hay una Gua para la resolucin de problemas. La informacin de resolucin de problemas que antes estaba contenida en esta gua se ha integrado en las publicaciones de DB2. De este modo, podemos proporcionar la informacin ms actualizada posible. Para buscar informacin sobre los programas de utilidad y las funciones para la resolucin de problemas de DB2, acceda el Centro de informacin de DB2 desde cualquiera de las herramientas. Consulte el sitio de soporte en lnea de DB2 si tiene problemas y desea obtener ayuda para encontrar las causas y las soluciones posibles. El sitio de soporte contiene una gran base de datos de publicaciones, notas tcnicas, registros APAR (problema de producto), FixPaks y otros recursos de DB2 que se actualiza constantemente. Puede utilizar el sitio de soporte para buscar en esta base de conocimiento y encontrar posibles soluciones a los problemas. Acceda al sitio de Soporte en lnea en la direccin www.ibm.com/software/data/db2/udb/winos2unix/support o pulsando el botn Soporte en lnea en el Centro de informacin de DB2. En este sitio,
770
Command Reference
ahora tambin se encuentra disponible informacin que cambia frecuentemente, por ejemplo el listado de cdigos de error internos de DB2. Conceptos relacionados: v Acceso al Centro de informacin de DB2 desde un navegador en la pgina 773 Tareas relacionadas: v Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin en la pgina 763
Accesibilidad
Las caractersticas de accesibilidad ayudan a los usuarios con discapacidades fsicas, por ejemplo movilidad o visin limitada, a utilizar los productos de software satisfactoriamente. En DB2 Universal Database Versin 8, las caractersticas de accesibilidad principales son las siguientes: v DB2 permite trabajar con todas las caractersticas utilizando el teclado en lugar del ratn. Consulte Entrada de teclado y navegacin. v DB2 permite personalizar el tamao y el color de los fonts. Consulte Pantalla accesible en la pgina 772. v DB2 permite recibir seales de alerta visuales o sonoras. Consulte Seales de alerta alternativas en la pgina 772. v DB2 soporta las aplicaciones de accesibilidad que utilizan la API de accesibilidad de Java. Consulte Compatibilidad con tecnologas de asistencia en la pgina 772. v DB2 viene con documentacin que se proporciona en un formato accesible. Consulte Documentacin accesible en la pgina 772.
Entrada de teclado y navegacin

Entrada de teclado Puede trabajar con las Herramientas de DB2 utilizando slo el teclado. Puede utilizar teclas o combinaciones de teclas para llevar a cabo la mayora de las operaciones que tambin se pueden realizar con el ratn. Foco del teclado En sistemas basados en UNIX, la posicin del foco del teclado est resaltada, lo que indica qu rea de la ventana est activa y dnde sern efectivas las pulsaciones.
771
Pantalla accesible
Las Herramientas de DB2 tienen caractersticas que amplan la interfaz de usuario y mejoran la accesibilidad para los usuarios con visin reducida. Estas mejoras de la accesibilidad incluyen soporte para propiedades de font personalizables. Valores de font Las Herramientas de DB2 permiten seleccionar el color, el tamao y el font para el texto de los mens y las ventanas de dilogo, utilizando el cuaderno Valores de herramientas. No dependencia del color No es necesario distinguir los colores para utilizar cualquiera de las funciones de este producto.
Seales de alerta alternativas

Puede especificar si desea recibir las alertas a travs de seales visuales o sonoras, utilizando el cuaderno Valores de herramientas.
Compatibilidad con tecnologas de asistencia

La interfaz de las Herramientas de DB2 soporta la API de accesibilidad de Java que permite el uso de lectores de pantalla y otras tecnologas de asistencia utilizadas por las personas discapacitadas.
Documentacin accesible
La documentacin para la familia de productos DB2 est disponible en formato HTML. Esto permite ver la documentacin de acuerdo con las preferencias de pantalla establecidas en el navegador. Tambin permite utilizar lectores de pantalla y otras tecnologas de asistencia.
Guas de aprendizaje de DB2

Las guas de aprendizaje de DB2 ayudan a conocer los diversos aspectos de DB2 Universal Database. Las guas de aprendizaje proporcionan ejercicios con instrucciones paso a paso en las reas de desarrollo de aplicaciones, ajuste del rendimiento de las consultas de SQL, trabajo con depsitos de datos, gestin de metadatos y desarrollo de servicios Web utilizando DB2. Antes de empezar: Para poder acceder a estas guas de aprendizaje utilizando los enlaces que figuran abajo, deber instalar las guas de aprendizaje desde el CD de documentacin HTML de DB2.
772
Command Reference
Si no desea instalar las guas de aprendizaje, puede ver las versiones HTML de las mismas directamente desde el CD de documentacin HTML de DB2. En el CD de documentacin PDF de DB2 tambin se encuentran disponibles versiones PDF de estas guas de aprendizaje. Algunos ejercicios de las guas de aprendizaje utilizan datos o cdigo de ejemplo. Consulte cada gua de aprendizaje individual para obtener una descripcin de los prerrequisitos para las tareas especficas. Guas de aprendizaje de DB2 Universal Database: Si ha instalado las guas de aprendizaje desde el CD de documentacin HTML de DB2, puede pulsar el ttulo de una gua de aprendizaje de la lista que se indica a continuacin para ver dicha gua. Gua de aprendizaje de Inteligencia empresarial: Introduccin al Centro de depsito de datos Realizar tareas de introduccin de depsito de datos utilizando el Centro de depsito de datos. Gua de aprendizaje de Inteligencia empresarial: Lecciones ampliadas sobre el depsito de datos Realizar tareas avanzadas de depsito de datos utilizando el Centro de depsito de datos. Gua de aprendizaje del Centro de desarrollo para Video Online utilizando Microsoft Visual Basic Crear diversos componentes de una aplicacin utilizando la Macro automtica del Centro de desarrollo para Microsoft Visual Basic. Gua de aprendizaje del Centro de catlogos de informacin Crear y gestionar un catlogo de informacin para localizar y usar metadatos utilizando el Centro de catlogos de informacin. Gua de aprendizaje de Video Central para e-business Desarrollar y desplegar una aplicacin avanzada de Servicios Web DB2 utilizando productos WebSphere. Gua de aprendizaje de Visual Explain Analizar, optimizar y ajustar sentencias de SQL para obtener un mejor rendimiento al utilizar Visual Explain.
Acceso al Centro de informacin de DB2 desde un navegador

El Centro de informacin de DB2 proporciona acceso a toda la informacin que necesita para obtener el mximo provecho de DB2 Universal Database y DB2 Connect en su empresa. El Centro de informacin de DB2 tambin documenta las caractersticas y los componentes principales de DB2,
773
incluyendo la duplicacin, el depsito de datos, el Centro de catlogos de informacin, Life Sciences Data Connect y DB2 Extenders. El Centro de informacin de DB2 al que se accede desde un navegador presenta las caractersticas siguientes si se visualiza en Netscape Navigator 6.1 o posterior o bien Microsoft Internet Explorer 5 o posterior. Algunas caractersticas requieren que se habilite el soporte de Java o JavaScript: Documentacin actualizada con regularidad Mantenga los temas actualizados bajando el cdigo HTML actualizado. Bsqueda Busque todos los temas instalados en la estacin de trabajo pulsando Buscar en la barra de herramientas de navegacin. rbol de navegacin integrado Localice cualquier tema de la biblioteca de DB2 desde un solo rbol de navegacin. El rbol de navegacin est organizado por tipo de informacin, como se indica a continuacin: v Las tareas proporcionan instrucciones paso a paso sobre cmo lograr un objetivo. v Los conceptos proporcionan una visin general de un tema. v Los temas de consulta proporcionan informacin detallada sobre un tema, incluyendo la sintaxis de sentencias y mandatos, la ayuda de mensajes y los requisitos. ndice maestro Acceda a la informacin instalada desde el CD de documentacin HTML de DB2 desde el ndice maestro. El ndice est organizado en orden alfabtico por trminos del ndice. Glosario maestro El glosario maestro define los trminos utilizados en el Centro de informacin de DB2. El glosario est organizado en orden alfabtico por trminos del glosario. Tareas relacionadas: v Bsqueda de temas mediante el acceso al Centro de informacin de DB2 desde un navegador en la pgina 761 v Bsqueda de informacin de productos mediante el acceso al Centro de informacin de DB2 desde las herramientas de administracin en la pgina 763 v Actualizacin de la documentacin HTML instalada en la mquina en la pgina 766
774
Command Reference
Apndice D. Avisos
Es posible que IBM no comercialice en todos los pases algunos productos, servicios o caractersticas descritos en este manual. Consulte al representante local de IBM para obtener informacin sobre los productos y servicios que actualmente pueden adquirirse en su zona. Cualquier referencia a un producto, programa o servicio de IBM no pretende afirmar ni implicar que slo se pueda utilizar dicho producto, programa o servicio de IBM. En su lugar se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no vulnere ninguno de los derechos de propiedad intelectual de IBM. Sin embargo, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. IBM puede tener patentes o solicitudes de patentes en tramitacin que afecten al tema tratado en este documento. La posesin de este documento no confiere ninguna licencia sobre dichas patentes. Puede realizar consultas sobre licencias escribiendo a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 EE.UU. Para realizar consultas sobre licencias referentes a informacin de doble byte (DBCS), puede ponerse en contacto con el Departamento de Propiedad Intelectual de IBM de su pas/regin o escribir a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokio 106, Japn El prrafo siguiente no es aplicable al Reino Unido ni a ningn pas/regin en donde tales disposiciones sean incompatibles con la legislacin local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIN TAL CUAL, SIN GARANTA DE NINGUNA CLASE, NI EXPLCITA NI IMPLCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTAS IMPLCITAS DE NO VULNERACIN DE DERECHOS, COMERCIALIZACIN O IDONEIDAD PARA UN FIN DETERMINADO. Algunos estados no permiten la exclusin de garantas expresas o implcitas en determinadas transacciones, por lo que es posible que esta declaracin no sea aplicable en su caso.
775
Esta publicacin puede contener inexactitudes tcnicas o errores tipogrficos. Peridicamente se efectan cambios en la informacin aqu contenida; dichos cambios se incorporarn a las nuevas ediciones de la publicacin. IBM puede efectuar, en cualquier momento y sin previo aviso, mejoras y cambios en los productos y programas descritos en esta publicacin. Las referencias hechas en esta publicacin a sitios Web que no son de IBM se proporcionan slo para la comodidad del usuario y no constituyen un aval de esos sitios Web. La informacin contenida en esos sitios Web no forma parte de la informacin del presente producto IBM y el usuario es responsable de la utilizacin de dichos sitios Web. IBM puede utilizar o distribuir cualquier informacin que se le facilite de la manera que considere adecuada, sin contraer por ello ninguna obligacin con el remitente. Los licenciatarios de este programa que deseen obtener informacin sobre l con el fin de habilitar: (i) el intercambio de informacin entre programas creados de forma independiente y otros programas (incluido ste) y (ii) el uso mutuo de la informacin intercambiada, deben ponerse en contacto con: IBM Canada Limited Office of the Lab Director 8200 Warden Avenue Markham, Ontario L6G 1C7 CANAD Dicha informacin puede estar disponible, sujeta a los trminos y condiciones apropiados, incluido en algunos casos el pago de una tarifa. El programa bajo licencia descrito en este documento y todo el material bajo licencia asociado a l, los proporciona IBM segn los trminos del Acuerdo de Cliente de IBM, el Acuerdo Internacional de Programas Bajo Licencia de IBM o cualquier acuerdo equivalente entre el usuario e IBM. Los datos de rendimiento contenidos en este documento se obtuvieron en un entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos pueden variar significativamente. Algunas mediciones pueden haberse realizado en sistemas experimentales y no es seguro que estas mediciones sean las mismas en los sistemas disponibles comercialmente. Adems, algunas mediciones pueden haberse calculado mediante extrapolacin. Los resultados reales pueden variar. Los usuarios del presente manual deben verificar los datos aplicables para su entorno especfico. La informacin referente a productos que no son de IBM se ha obtenido de los proveedores de esos productos, de sus anuncios publicados o de otras
776
Command Reference
fuentes disponibles pblicamente. IBM no ha probado esos productos y no puede confirmar la exactitud del rendimiento, la compatibilidad ni ninguna otra afirmacin referente a productos que no son de IBM. Las preguntas sobre las prestaciones de productos que no son de IBM deben dirigirse a los proveedores de esos productos. Todas las declaraciones de intenciones de IBM estn sujetas a cambio o cancelacin sin previo aviso, y slo representan objetivos. Este manual puede contener ejemplos de datos e informes que se utilizan en operaciones comerciales diarias. Para ilustrarlos de la forma ms completa posible, los ejemplos incluyen nombres de personas, empresas, marcas y productos. Todos estos nombres son ficticios y cualquier similitud con nombres y direcciones utilizados por una empresa real es totalmente fortuita. LICENCIA DE COPYRIGHT: Este manual puede contener programas de aplicaciones de ejemplo escritos en lenguaje fuente, que muestran tcnicas de programacin en diversas plataformas operativas. Puede copiar, modificar y distribuir estos programas de ejemplo como desee, sin pago alguno a IBM, con la intencin de desarrollar, utilizar, comercializar o distribuir programas de aplicaciones de acuerdo con la interfaz de programacin de aplicaciones correspondiente a la plataforma operativa para la que estn escritos los programas de ejemplo. Estos ejemplos no se han probado exhaustivamente bajo todas las condiciones. Por lo tanto, IBM no puede asegurar ni implicar la fiabilidad, utilidad o funcin de estos programas. Cada copia o parte de estos programas de ejemplo o cualquier trabajo derivado debe incluir una nota de copyright como la siguiente: (nombre de la empresa) (ao). Partes de este cdigo proceden de programas de ejemplo de IBM Corp. Copyright IBM Corp. _entre el o los aos_. Reservados todos los derechos.
Apndice D. Avisos
777
Marcas registradas
Los trminos siguientes son marcas registradas de International Business Machines Corporation en los EE.UU. y/o en otros pases y se han utilizado como mnimo en uno de los documentos de la biblioteca de documentacin de DB2 UDB.
ACF/VTAM AISPO AIX AIXwindows AnyNet APPN AS/400 BookManager C Set++ C/370 CICS Database 2 DataHub DataJoiner DataPropagator DataRefresher DB2 DB2 Connect DB2 Extenders DB2 OLAP Server DB2 Universal Database Distributed Relational Database Architecture DRDA eServer Extended Services FFST First Failure Support Technology IBM IMS IMS/ESA iSeries LAN Distance MVS MVS/ESA MVS/XA Net.Data NetView OS/390 OS/400 PowerPC pSeries QBIC QMF RACF RISC System/6000 RS/6000 S/370 SP SQL/400 SQL/DS System/370 System/390 SystemView Tivoli VisualAge VM/ESA VSE/ESA VTAM WebExplorer WebSphere WIN-OS/2 z/OS zSeries
Los trminos siguientes son marcas registradas de otras empresas y se han utilizado como mnimo en uno de los documentos de la biblioteca de documentacin de DB2 UDB: Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los EE.UU. y/o en otros pases.
778
Command Reference
Intel y Pentium son marcas registradas de Intel Corporation en los EE.UU. y/o en otros pases. Java y todas las marcas registradas basadas en Java son marcas registradas de Sun Microsystems, Inc. en los EE.UU. y/o en otros pases. UNIX es marca registrada de The Open Group en los EE.UU. y/o en otros pases. Otros nombres de empresas, productos o servicios, pueden ser marcas registradas o marcas de servicio de otras empresas.
Apndice D. Avisos
779
780
Command Reference
Apndice E. Cmo ponerse en contacto con IBM

En los EE.UU., puede ponerse en contacto con IBM llamando a uno de los siguientes nmeros: v 1-800-237-5511 para servicio al cliente v 1-888-426-4343 para obtener informacin sobre las opciones de servicio tcnico disponibles v 1-800-IBM-4YOU (426-4968) para mrketing y ventas de DB2 En Canad, puede ponerse en contacto con IBM llamando a uno de los siguientes nmeros: v 1-800-IBM-SERV (1-800-426-7378) para servicio al cliente v 1-800-465-9600 para obtener informacin sobre las opciones de servicio tcnico disponibles v 1-800-IBM-4YOU (1-800-426-4968) para mrketing y ventas de DB2 Para localizar una oficina de IBM en su pas o regin, consulte IBM Directory of Worldwide Contacts en el sitio Web www.ibm.com/planetwide
Informacin sobre productos

La informacin relacionada con productos DB2 Universal Database se encuentra disponible por telfono o a travs de la World Wide Web en el sitio www.ibm.com/software/data/db2/udb Este sitio contiene la informacin ms reciente sobre la biblioteca tcnica, pedidos de manuales, descargas de clientes, grupos de noticias, FixPacks, novedades y enlaces con recursos de la Web. Si vive en los EE.UU., puede llamar a uno de los nmeros siguientes: v 1-800-IBM-CALL (1-800-426-2255) para solicitar productos u obtener informacin general. v 1-800-879-2755 para solicitar publicaciones. Para obtener informacin sobre cmo ponerse en contacto con IBM desde fuera de los EE.UU., vaya a la pgina IBM Worldwide en el sitio www.ibm.com/planetwide
781
782
Command Reference
ndice
Caracteres Especiales
\, carcter de continuacin de lnea 191 !, mandato de shell 179 APPC (Advanced Program-to-Program Communication) nodo descatalogar 699 ARCHIVE LOG, mandato 208 archivos binarios denominar para salida 170 archivos temporales LOAD, mandato 481 ASC, tipo de archivo de importacin 398 Asesor de ndices DB2 14 Asesor de ndices DB2, mandato 14 ATTACH, mandato 211 AUTOCONFIGURE, mandato 213 Autostart DAS, mandato 3 bases de datos (continuacin) exportar tabla a un archivo 322 importar archivo a tabla 398 informacin 374 migracin 533 recuperacin en avance 647 recuperar 647 reiniciar 633 reorganizar 612 restaurar (reconstruir) 636 supervisor restablecer 631 suprimir, asegurando la recuperacin con archivos de anotaciones cronolgicas 309 binarynumerics, modificador de tipo de archivo 481 BIND, mandato 222 bindfile, opcin de precompilacin 537 blocking, opcin de precompilacin/vinculacin 222, 537 bloqueos restablecer el mximo al valor por omisin 627 Buscar nmero de secuencia de anotacin cronolgica, mandato 67 bsqueda de documentacin de DB2 utilizando Netscape 4.x 768
A
Abrir ventana de mandatos de DB2, mandato 46 accesibilidad caractersticas 771 acceso a bases de datos iniciar el gestor de bases de datos 191 action, opcin de precompilacin/vinculacin 222, 537 ACTIVATE DATABASE, mandato 197 Actualizar instancias, mandato 95 Actualizar valores de columna generados, mandato 72 ADD CONTACT, mandato 200 ADD CONTACTGROUP, mandato 202 ADD DATALINKS MANAGER, mandato 203 ADD DBPARTITIONNUM, mandato 205 administracin, configuracin archivo 335 ejemplo 335 restablecer al valor por omisin 623 valores de parmetros de red 704 almacenamiento fsico 603 Analizador de sucesos, mandato 59 anotaciones cronolgicas listar durante avance 647 anyorder, modificador de tipo de archivo 481 Aadir servidor de particiones de base de datos a una instancia, mandato 126 API de servicio de copia de seguridad (XBSA) 216
B
BACKUP DATABASE, mandato 216 base de datos conexin, visin general 191 conexin implcita 191 base de datos, configuracin actualizacin 718 ejemplo 349 restablecer al valor por omisin 627 valores de parmetros de red 718 bases de datos archivo histrico de copia de seguridad 568 cambiar comentarios en directorio 278 cargar archivo en tabla 481 catalogar 250 comprobar autorizaciones 340 eliminar 309 eliminar entradas (descatalogar) 692 eliminar entradas DCS de sistema principal 694 entrada de directorio indirecta 440 entrada de directorio inicial 440 entrada de directorio remota 440 estadsticas 659
C
CALL, sentencia ejecutar mediante el CLP 733, 736 Cambiar configuracin de servidor de particiones de base de datos, mandato 124 campo de transaccin dudosa 460 carcter de continuacin de lnea procesador de lnea de mandatos 191 caracteres especiales, permitidos en mandatos de CLP 195 Cargador automtico, mandato 19 cargar archivo en tabla de base de datos 481
783
cargar (continuacin) modificadores de tipo de archivo para 481 CATALOG APPC NODE, mandato 244 CATALOG APPN NODE, mandato 247 CATALOG DATABASE, mandato sintaxis 250 CATALOG DCS DATABASE, mandato 255 CATALOG LDAP DATABASE, mandato 258 CATALOG LDAP NODE, mandato 262 CATALOG LOCAL NODE, mandato 264 CATALOG NAMED PIPE NODE, mandato 267 CATALOG NETBIOS NODE, mandato 270 CATALOG ODBC DATA SOURCE, mandato 273 CATALOG TCP/IP NODE, mandato 274 catalogar base de datos de sistema principal 255 bases de datos 250 CCSIDG, opcin de precompilacin/vinculacin 222, 537 CCSIDM, opcin de precompilacin/vinculacin 222, 537 CCSIDS, opcin de precompilacin/vinculacin 222, 537 Centro de control iniciar 30 Centro de informacin de DB2 773 clusulas WHERE resolver smbolos ambiguos, sentencia SELECT 195 CLI, configuracin 342 CLI interactiva de DB2, mandato 45 CLIPKG, opcin de precompilacin/vinculacin 222 CLOSE, sentencia ejecutar mediante el CLP 733 CLP (procesador de lnea de mandatos) salir 580 terminar 691
cnulreqd, opcin de precompilacin/vinculacin 222, 537 coldel, modificador de tipo de archivo cargar 481 exportar 322 importar 398 collection, opcin de precompilacin/vinculacin 222, 537 compound, modificador de tipo de archivo 398 Comprobar copia de seguridad, mandato 37 Comprobar secuencia de imgenes de restauracin incremental, mandato 42 conexin implcita acceso a bases de datos 191 configuracin por omisin admin, restablecer a 623 base de datos, restablecer a 627 configuraciones administracin ejemplo 335 restablecer al valor por omisin 623 base de datos actualizacin 718 ejemplo 349 restablecer al valor por omisin 627 CLI, ejemplo 342 gestor de bases de datos, ejemplo 354 Configurar entorno de LDAP, mandato 97 Configurar programa de utilidad Failover de Windows, mandato 116 connect, opcin de precompilacin 537 CONNECT, sentencia ejecutar mediante el CLP 734 Consulta de anotacin cronolgica de rutina de gobierno de DB2, mandato 76 continuacin de lnea, carcter procesador de lnea de mandatos 191 contraseas cambiar mediante CONNECT 736
contraseas (continuacin) cambio con mandato ATTACH 211 convenios de denominacin objetos de gestor de bases de datos 747 copia de seguridad en cinta 216 Crear base de datos de ejemplo, mandato 151 Crear instancia, mandato 83 Crear un servidor de administracin DB2, mandato 4 CREATE DATABASE, mandato 283 CREATE TOOLS CATALOG, mandato 295
CH
CHANGE DATABASE COMMENT, mandato 278 CHANGE ISOLATION LEVEL, mandato 280 chardel, modificador de tipo de archivo cargar 481 exportar 322 importar 398 charsub, opcin de precompilacin/vinculacin 222, 537
D
DAS (Servidor de administracin DB2) configuracin 335 crear 7 eliminar 7 dasauto, mandato 3 dascrt, mandato 4 dasdrop, mandato 5 dasmigr, mandato 6 dateformat, modificador de tipo de archivo 398, 481 datesiso 322 datesiso, modificador de tipo de archivo 398, 481 DATETIME, opcin de precompilacin/vinculacin 222, 537 datos fragmentacin, eliminar, mediante reorganizacin de tabla 603 db2 CMD, descripcin 179 mandato, sintaxis 179
784
Command Reference
DB2 Connect conexiones soportadas 255 db2_recon_aid, mandato 146 db2admin, mandato 7 db2adutl, mandato 9 db2advis 14 db2atld, mandato 19 db2audit, mandato 18 db2batch, mandato 20 db2bfd, mandato 27 db2cap, mandato 28 db2cc, mandato 30 db2cfexp, mandato 32 db2cfimp, mandato 34 db2cidmg, mandato 35 db2ckbkp, mandato 37 db2ckmig, mandato 41 db2ckrst, mandato 42 db2cli, mandato 45 db2cmd, mandato 46 db2dclgn, mandato 53 db2drdat, mandato 56 db2empfa, mandato 58 db2eva, mandato 59 db2evmon, mandato 61 db2evtbl, mandato 63 db2exfmt, mandato 65 db2expln, mandato 66 db2flsn, mandato 67 db2fm, mandato 69 db2gncol, mandato 72 db2gov, mandato 74 db2govlg, mandato 76 db2hc, mandato 78 db2icrt, mandato 83 db2idrop, mandato 86 db2ilist, mandato 87 db2imigr, mandato 88 db2inidb, mandato 90 db2inspf, mandato 92 db2isetup, mandato 93 db2iupdt, mandato 95 db2ldcfg, mandato 97 db2level, mandato 99 db2licm, mandato 100 db2logsforrfwd, mandato 102 db2look, mandato 103 db2move, mandato 110 db2mscs, mandato 116 db2mtrk, mandato 121 db2ncrt, mandato 126 db2nchg, mandato 124 db2ndrop, mandato 129 DB2OPTIONS variable de entorno 181
db2osconf, mandato 131 db2perfc, mandato 135 db2perfi, mandato 137 db2perfr, mandato 138 db2profc, mandato 140 db2profp, mandato 142 db2rbind, mandato 144 db2relocatedb, mandato 150 db2sampl, mandato 151 db2set, mandato 153 db2setup, mandato 157 db2sql92, mandato 159 db2start, mandato 163, 681 db2stop, mandato 164, 687 db2support, mandato 165 db2sync, mandato 168 db2tbst, mandato 169 db2trc, mandato 170 db2uiddl, mandato 174 db2undgp, mandato 173 db2untag, mandato 176 DEACTIVATE DATABASE, mandato 298 dec, opcin de precompilacin/vinculacin 222, 537 decdel, opcin de precompilacin/vinculacin 222, 537 DECLARE CURSOR, sentencia ejecutar mediante el CLP 734 decplusblank, modificador de tipo de archivo 322, 398, 481 decpt, modificador de tipo de archivo 322, 398, 481 deferred_prepare, opcin de precompilacin 537 degree, opcin de precompilacin/vinculacin 222, 537 delprioritychar, modificador de tipo de archivo 398, 481 denominacin, convenios de objetos de gestor de bases de datos 747 DEREGISTER, mandato 300 descatalogar directorio de bases de datos del sistema 692 entradas de base de datos 692 entradas de base de datos DCS de sistema principal 694
desconectar procesos frontal y de fondo del procesador de lnea de mandatos 691 DESCRIBE, mandato 302 desvo de datos redistribucin de datos en grupo de particiones de base de datos 591 DETACH, mandato 306 detener DB2 db2stop, mandato 164 Detener DB2, mandato 164 diagramas de sintaxis leer 743 directorio de bases de datos del sistema descatalogar 692 directorios base de datos cambiar comentarios 278 base de datos del sistema, eliminar 692 descatalogar 692 nodo eliminacin de entradas 699 Servicios de conexin de base de datos (DCS), descatalogar entradas 694 suprimir entradas 699 directorios de bases de datos cambiar comentarios 278 contenido de ejemplo 440 descripcin 440 directorios de nodo eliminacin de entradas 699 disconnect, opcin de precompilacin 537 dldel, modificador de tipo de archivo 322, 398, 481 DROP CONTACT, mandato 307 DROP CONTACTGROUP, mandato 308 DROP DATABASE, mandato 309 DROP DATALINKS MANAGER, mandato 312 DROP DBPARTITIONNUM VERIFY, mandato 317 DROP TOOLS CATALOG, mandato 319 dumpfile, modificador de tipo de archivo 481
ndice
785
DYNAMICRULES, opcin de precompilacin/vinculacin 222, 537
E
ECHO, mandato 321 Eliminar instancia, mandato 86 Eliminar servidor de particiones de base de datos de una instancia, mandato 129 Eliminar un servidor de administracin DB2, mandato 5 en lnea ayuda, acceso a 759 esquemas en bases de datos nuevas 283 estabilidad de lectura (RS) cambiar 280 estabilidad del cursor (CS) cambiar 280 estaciones de trabajo remotas catalogar bases de datos 250 descatalogar de estacin de trabajo local 699 eliminar entradas de catlogo para base de datos de 692 estadsticas base de datos 659 gestor de bases de datos 374 reorganizar ndices 612 REORGCHK 612 explain, opcin de vinculacin 222, 537 explsnap, opcin de precompilacin/vinculacin 222, 537 EXPORT, mandato 322 exportar archivos de tablas de base de datos 322 consideraciones sobre DB2 Data Links Manager 322 modificadores de tipo de archivo para 322
font true type requisito para DB2 CLP 196 FORCE APPLICATION, mandato 333 forcein, modificador de tipo de archivo 398, 481 Formatear resultados de inspeccin, mandato 92 formatos de archivo exportar tabla a un archivo 322 importar archivo a tabla 398 funcpath, opcin de precompilacin/vinculacin 222, 537
G
Generador de declaraciones, mandato 53 Generar definiciones de tabla de destino del supervisor de sucesos, mandato 63 generatedignore, modificador de tipo de archivo 398, 481 generatedmissing, modificador de tipo de archivo 398, 481 generatedoverride, modificador de tipo de archivo 481 generic, opcin de precompilacin/vinculacin 222, 537 gestor de bases de datos acceder desde el indicador de mandatos 1 conmutadores de supervisor 358, 367 detener 687 estadsticas 374 iniciar 681 instancias de 366 mandatos del sistema 1 gestor de bases de datos, configuracin archivo de ejemplo 354 GET DATABASE MANAGER CONFIGURATION, mandato 354 GET ADMIN CONFIGURATION, mandato 335 GET ALERT CONFIGURATION, mandato 337 GET AUTHORIZATIONS, mandato 340 GET CLI CONFIGURATION, mandato 342
GET CONNECTION STATE, mandato 345 GET CONTACTGROUP, mandato 346 GET CONTACTGROUPS, mandato 347 GET CONTACTS, mandato 348 GET DATABASE CONFIGURATION, mandato 349 GET DATABASE MANAGER CONFIGURATION, mandato 354 GET DATABASE MANAGER MONITOR SWITCHES, mandato 358 GET DESCRIPTION FOR HEALTH INDICATOR, mandato 361 GET HEALTH NOTIFICATION CONTACT LIST, mandato 363 GET HEALTH SNAPSHOT, mandato 364 GET INSTANCE, mandato 366 GET MONITOR SWITCHES, mandato 367 GET RECOMMENDATIONS mandato 370 GET ROUTINE, mandato 372 GET SNAPSHOT, mandato 374 efecto en UPDATE MONITOR SWITCHES 730 grant, opcin de vinculacin 222 grantgroup, opcin de vinculacin 222 grantuser, opcin de vinculacin 222 Guas de Aprendizaje 772 Guas de Aprendizaje de DB2 772
H
Habilitar asignacin de archivos multipginas, mandato 58 HELP, mandato 396 Herramienta de administrador del recurso de auditora, mandato 18 Herramienta de anlisis de problemas y recoleccin del entorno, mandato 165 Herramienta de banco de pruebas, mandato 20 Herramienta de descripcin de archivo de vinculacin, mandato 27 Herramienta de explicacin de SQL de DB2, mandato 66
F
fastparse, modificador de tipo de archivo 481 federated, opcin de precompilacin/vinculacin 222, 537 FETCH, sentencia ejecutar mediante el CLP 734
786
Command Reference
Herramienta de exportacin de configuracin de conectividad, mandato 32 Herramienta de extraccin de DDL y de estadsticas de DB2, mandato 103 Herramienta de formato de tabla de explicacin, mandato 65 Herramienta de gestin de licencias, mandato 100 Herramienta de importacin de configuracin de conectividad, mandato 34 herramienta de movimiento de base de datos, mandato 110 Herramienta de productividad del supervisor de sucesos, mandato 61 Herramienta de registro de supervisor de rendimiento, mandato 138 Herramienta de vinculacin de paquetes estticos CLI/ODBC, mandato 28
I
ID de usuario autorizacin 340 identityignore 398 identityignore, modificador de tipo de archivo 481 identitymissing, modificador de tipo de archivo 398, 481 identityoverride, modificador de tipo de archivo 481 idiomas de nico byte ver caracteres nacionales desde DB2 CLP 196 imgenes de TSM archivadas 9 implieddecimal, modificador de tipo de archivo 398, 481 IMPORT, mandato 398 importar datos 398 Impresora de perfiles SQLj de DB2, mandato 142 indexfreespace, modificador de tipo de archivo 481 indexixf, modificador de tipo de archivo 398 indexschema, modificador de tipo de archivo 398 ndices estadsticas 659 reorganizar 612
inhabilidad 771 Inicializar una base de datos duplicada, mandato 90 iniciar DB2 db2start, mandato 163 Iniciar Centro de control, mandato 30 Iniciar centro de salud, mandato 78 Iniciar DB2, mandato 163 Iniciar interfaz de creacin de instancia, mandato 93 Iniciar sincronizador de DB2, mandato 168 INITIALIZE TAPE, mandato 425 inmovilizacin ficticia 576 inmovilizacin ficticia 576 insert, opcin de precompilacin/vinculacin 222, 537 INSPECT, mandato 427 Instalar DB2, mandato 157 integridad de los datos mantener, con niveles de aislamiento 280 IPX/SPX, nodo descatalogar 699 isolation, opcin de precompilacin/vinculacin 222, 537
K
keepblanks, modificador de tipo de archivo 398, 481
LIST DATABASE PARTITION GROUPS, mandato 444 LIST DATALINKS MANAGERS, mandato 447 LIST DBPARTITIONNUMS, mandato 448 LIST DCS APPLICATIONS, mandato 449 LIST DCS DIRECTORY, mandato 453 LIST DRDA INDOUBT TRANSACTIONS, mandato 455 LIST HISTORY, mandato 457 LIST INDOUBT TRANSACTIONS, mandato 460 LIST NODE DIRECTORY, mandato 465 LIST ODBC DATA SOURCES, mandato 468 LIST PACKAGES, mandato 470 LIST PACKAGES/TABLES, mandato 470 LIST TABLES, mandato 470 LIST TABLESPACE CONTAINERS, mandato 473 LIST TABLESPACES, mandato 475 Listar instancias, mandato 87 LOAD, mandato 481 LOAD QUERY, mandato 529 lobsinfile, modificador de tipo de archivo 322, 398, 481 longerror, opcin de precompilacin 537
M
mandato de herramienta de premigracin de base de datos 41 mandato de procesador de sentencia de SQL compatible con SQL92 159 mandato de rastreo DRDA 56 Mandato Listar registros necesarios para recuperacin en avance 102 mandatos ACTIVATE DATABASE 197 ADD CONTACT 200 ADD CONTACTGROUP 202 ADD DATALINKS MANAGER 203 ADD DBPARTITIONNUM 205 ARCHIVE LOG 208 ATTACH 211 AUTOCONFIGURE 213 BACKUP DATABASE 216 BIND 222
L
langlevel, opcin de precompilacin 537 lectura repetible (RR) cambiar 280 lecturas no comprometidas (UR) cambiar 280 level, opcin de precompilacin 537 Liberar identificador de contenedor, mandato 176 LIST ACTIVE DATABASES, mandato 433 LIST APPLICATIONS, mandato 435 LIST COMMAND OPTIONS, mandato 438 LIST DATABASE DIRECTORY, mandato 440
ndice
787
mandatos (continuacin) CATALOG APPC NODE 244 CATALOG APPN NODE 247 CATALOG DATABASE 250 CATALOG DCS DATABASE 255 CATALOG LDAP DATABASE 258 CATALOG LDAP NODE 262 CATALOG LOCAL NODE 264 CATALOG NAMED PIPE NODE 267 CATALOG NETBIOS NODE 270 CATALOG ODBC DATA SOURCE 273 CATALOG TCP/IP NODE 274 CREATE DATABASE 283 CREATE TOOLS CATALOG 295 CHANGE DATABASE COMMENT 278 CHANGE ISOLATION LEVEL 280 dasauto 3 dascrt 4 dasdrop 5 dasmigr 6 db2_recon_aid 146 db2admin 7 db2adutl 9 db2advis 14 db2atld 19 db2audit 18 db2batch 20 db2bfd 27 db2cap 28 db2cc 30 db2cfexp 32 db2cfimp 34 db2cidmg 35 db2ckbkp 37 db2ckmig 41 db2ckrst 42 db2cli 45 db2cmd 46 db2dclgn 53 db2drdat 56 db2empfa 58 db2eva 59 db2evmon 61 db2evtbl 63 db2exfmt 65 db2expln 66 db2flsn 67 db2fm 69
mandatos (continuacin) db2gncol 72 db2gov 74 db2govlg 76 db2hc 78 db2icrt 83 db2idrop 86 db2ilist 87 db2imigr 88 db2inidb 90 db2inspf 92 db2isetup 93 db2iupdt 95 db2ldcfg 97 db2level 99 db2licm 100 db2logsforrfwd 102 db2look 103 db2move 110 db2mscs 116 db2mtrk 121 db2ncrt 126 db2nchg 124 db2ndrop 129 db2osconf 131 db2perfc 135 db2perfi 137 db2perfr 138 db2profc 140 db2profp 142 db2rbind 144 db2relocatedb 150 db2sampl 151 db2set 153 db2setup 157 db2sql92 159 db2start 163 db2stop 164 db2support 165 db2sync 168 db2tbst 169 db2trc 170 db2uiddl 174 db2undgp 173 db2untag 176 DEACTIVATE DATABASE 298 DEREGISTER 300 DESCRIBE 302 DETACH 306 DROP CONTACT 307 DROP CONTACTGROUP 308 DROP DATABASE 309 DROP DATALINKS MANAGER 312
mandatos (continuacin) DROP DBPARTITIONNUM VERIFY 317 DROP TOOLS CATALOG 319 ECHO 321 EXPORT 322 FORCE APPLICATION 333 GET ADMIN CONFIGURATION 335 GET ALERT CONFIGURATION 337 GET AUTHORIZATIONS 340 GET CLI CONFIGURATION 342 GET CONNECTION STATE 345 GET CONTACTGROUP 346 GET CONTACTGROUPS 347 GET CONTACTS 348 GET DATABASE CONFIGURATION 349 GET DATABASE MANAGER CONFIGURATION 354 GET DATABASE MANAGER MONITOR SWITCHES 358 GET DESCRIPTION FOR HEALTH INDICATOR 361 GET HEALTH NOTIFICATION CONTACT LIST 363 GET HEALTH SNAPSHOT 364 GET INSTANCE 366 GET MONITOR SWITCHES 367 GET RECOMMENDATIONS 370 GET ROUTINE 372 GET SNAPSHOT 374 HELP 396 IMPORT 398 INITIALIZE TAPE 425 INSPECT 427 LIST ACTIVE DATABASES 433 LIST APPLICATIONS 435 LIST COMMAND OPTIONS 438 LIST DATABASE DIRECTORY 440 LIST DATABASE PARTITION GROUPS 444 LIST DATALINKS MANAGERS 447 LIST DBPARTITIONNUMS 448 LIST DCS APPLICATIONS 449 LIST DCS DIRECTORY 453 LIST DRDA INDOUBT TRANSACTIONS 455 LIST HISTORY 457
788
Command Reference
mandatos (continuacin) LIST INDOUBT TRANSACTIONS 460 LIST NODE DIRECTORY 465 LIST ODBC DATA SOURCES 468 LIST PACKAGES/TABLES 470 LIST TABLESPACE CONTAINERS 473 LIST TABLESPACES 475 LOAD 481 LOAD QUERY 529 MIGRATE DATABASE 533 PING 535 PRECOMPILE 537 PRUNE HISTORY/LOGFILE 568 PUT ROUTINE 570 QUERY CLIENT 572 QUIESCE 573 QUIESCE TABLESPACES FOR TABLE 576 QUIT 580 REBIND 581 RECONCILE 585 REDISTRIBUTE DATABASE PARTITION GROUP 591 REFRESH LDAP 596 REGISTER 598 REORG INDEXES/TABLE 603 REORGCHK 612 RESET ADMIN CONFIGURATION 623 RESET ALERT CONFIGURATION 625 RESET DATABASE CONFIGURATION 627 RESET DATABASE MANAGER CONFIGURATION 629 RESET MONITOR 631 RESTART DATABASE 633 RESTORE DATABASE 636 REWIND TAPE 646 ROLLFORWARD DATABASE 647 RUNSTATS 659 SET CLIENT 669 SET RUNTIME DEGREE 673 SET TABLESPACE CONTAINERS 675 SET TAPE POSITION 678 SET WRITE 679 START DATABASE MANAGER 681
mandatos (continuacin) STOP DATABASE MANAGER 687 TERMINATE 691 UNCATALOG DATABASE 692 UNCATALOG DCS DATABASE 694 UNCATALOG LDAP DATABASE 696 UNCATALOG LDAP NODE 698 UNCATALOG NODE 699 UNCATALOG ODBC DATA SOURCE 701 UNQUIESCE 702 UPDATE ADMIN CONFIGURATION 704 UPDATE ALERT CONFIGURATION 707 UPDATE CLI CONFIGURATION 712 UPDATE COMMAND OPTIONS 714 UPDATE CONTACT 716 UPDATE CONTACTGROUP 717 UPDATE DATABASE CONFIGURATION 718 UPDATE DATABASE MANAGER CONFIGURATION 721 UPDATE HEALTH NOTIFICATION CONTACT LIST 724 UPDATE HISTORY FILE 725 UPDATE LDAP NODE 727 UPDATE MONITOR SWITCHES 730 mandatos del sistema visin general 1 manuales impresos, pedido 758 mensajes de error archivo de configuracin de base de datos 349 eliminar bases de datos remotas 309 suma de comprobacin no vlida, archivo de configuracin de base de datos 627, 718 suma de comprobacin no vlida, archivo de configuracin de gestor de bases de datos 623 messages, opcin de precompilacin/vinculacin 222, 537
metacaracteres 195 Migracin de base de datos remota, mandato 35 Migrar el servidor de administracin DB2, mandato 6 Migrar instancia, mandato 88 MIGRATE DATABASE, mandato 533 modificador de tipo de archivo de pgina de cdigos 481 modificadores tipo de archivo EXPORT, mandato 322 IMPORT, mandato 398 LOAD, mandato 481 modificadores de tipo de archivo IMPORT, mandato 398 LOAD, mandato 481 programa de utilidad EXPORT 322 Mostrar nivel de servicio de DB2, mandato 99 mover datos entre bases de datos 398
N
NetBIOS, nodo descatalogar 699 ningn compromiso (NC) 280 niveles de aislamiento CHANGE ISOLATION LEVEL, mandato 280 nochecklengths, modificador de tipo de archivo 398, 481 nodefaults, modificador de tipo de archivo 398 nodos SOCKS 274 nodoubledel, modificador de tipo de archivo 322, 398, 481 noeofchar, modificador de tipo de archivo 398, 481 noheader, modificador de tipo de archivo 481 nolinemacro, opcin de precompilacin 537 norowwarnings, modificador de tipo de archivo 481 notypeid, modificador de tipo de archivo 398 nullindchar, modificador de tipo de archivo 398, 481
ndice
789
O
Obtener estado de espacio de tabla, mandato 169 OPEN, sentencia ejecutar mediante el CLP 735 optimizacin REORG INDEXES/TABLE, mandato 603 optlevel, opcin de precompilacin 537 output, opcin de precompilacin 537 owner, opcin de precompilacin/vinculacin 222, 537
P
packages, opcin de precompilacin 537 packeddecimal, modificador de tipo de archivo 481 pagefreespace, modificador de tipo de archivo 481 pginas de cdigos EXPORT, mandato 322 IMPORT, mandato 398 palabras clave sintaxis 743 paquetes volver a crear 581 parmetros sintaxis 743 pedido de manuales de DB2 758 Personalizador de perfiles SQLj de DB2, mandato 140 PING, mandato 535 PRECOMPILE, mandato 537 PREP, mandato 537 Preparar conversin de ndices exclusivos a semntica de V5, mandato 174 preprocessor, opcin de precompilacin 537 privilegios base de datos otorgados durante la creacin 283 directos 340 indirectos 340 informe 340 procesador de lnea de mandatos (CLP) acceder a ayuda 180 acceder a bases de datos mediante 179
procesador de lnea de mandatos (CLP) (continuacin) descripcin 179 invocar 179 mandato de shell 179 modalidad de entrada interactiva 179 modalidad de mandato 179 modalidad de proceso por lotes 179 opciones 181 salir 179, 580 terminar 179, 691 utilizar 190 programa de utilidad de carga archivos temporales 481 Programa de utilidad de registro de contadores de rendimiento, mandato 137 Programa de utilidad para valores de parmetro de kernel, mandato 131 PRUNE HISTORY/LOGFILE, mandato 568 PUT ROUTINE, mandato 570
Q
qualifier, opcin de precompilacin/vinculacin 222, 537 QUERY CLIENT, mandato 572 queryopt, opcin de precompilacin/vinculacin 222, 537 QUIESCE, mandato 573 QUIESCE TABLESPACES FOR TABLE, mandato 576 QUIT, mandato 580
R
Rastreador de memoria, mandato 121 Rastreo, mandato 170 rastreos activacin 170 REBIND, mandato 581 reclen, modificador de tipo de archivo 398 cargar 481 RECONCILE, mandato 585 Reconciliar varias tablas, mandato 146 recuperacin base de datos 636 en avance 647
recuperacin (continuacin) sin avance 636 redirigir salida 195 REDISTRIBUTE DATABASE PARTITION GROUP, mandato 591 REFRESH LDAP, mandato 596 REGISTER, mandato 598 Registro de perfiles de DB2, mandato 153 release, opcin de precompilacin/vinculacin 222, 537 rendimiento mejorar mediante reorganizacin de tablas 603 REORGCHK, mandato 612 REORG TABLE, mandato 603 REORGCHK, mandato 612 RESET ADMIN CONFIGURATION, mandato 623 RESET ALERT CONFIGURATION, mandato 625 RESET DATABASE CONFIGURATION, mandato 627 RESET DATABASE MANAGER CONFIGURATION, mandato 629 RESET MONITOR, mandato 631 resolucin de problemas bsqueda de documentacin de DB2 768 informacin en lnea 770 Restablecer valores de rendimiento de base de datos, mandato 135 RESTART DATABASE, mandato 633 restaurar versiones anteriores de bases de datos DB2 636 RESTORE DATABASE, mandato 636 Reubicar base de datos, mandato 150 Revocar privilegio de ejecucin, mandato 173 REWIND TAPE, mandato 646 ROLLFORWARD DATABASE, mandato 647 RUNSTATS, mandato sintaxis 659 Rutina de gobierno de DB2, mandato 74
790
Command Reference
S
SELECT, sentencia ejecutar mediante el CLP 735 en mandato EXPORT 322 resolver smbolos ambiguos, clusula WHERE 195 sensibilidad a maysculas y minsculas en convenios de denominacin 747 mandatos 194 sentencia CONNECT conexin a bases de datos 191 Sentencias de SQL acceder a ayuda 180 seal SIGALRM iniciar el gestor de bases de datos 681 seal SIGINT iniciar el gestor de bases de datos 681 serie NULL, establecer espacios en blanco 191 Servicios de conexin de bases de datos (DCS), directorio eliminacin de entradas 694 servidor de administracin configuracin 335 crear 7 eliminar 7 Servidor de administracin DB2 (DAS) crear 7 eliminar 7 Servidor de administracin DB2, mandato 7 SET CLIENT, mandato 669 SET RUNTIME DEGREE, mandato 673 SET TABLESPACE CONTAINERS, mandato 675 SET TAPE POSITION, mandato 678 SET WRITE, mandato 679 sintaxis para sentencias de SQL del procesador de la lnea de mandatos 733 para variables del sistema principal no soportadas en procesador de lnea de mandatos 195 sintaxis de mandato interpretar 743 sistemas principales catalogar bases de datos 255
sistemas principales (continuacin) conexiones soportadas por DB2 Connect 255 eliminar entradas de catlogo DCS 694 SOCKS, nodo parmetro 274 SQL, sentencias de ejecutar mediante el CLP 733 SQL, valor NULL representacin de procesador de lnea de mandatos 195 sqlca, opcin de precompilacin 537 sqlerror, opcin de precompilacin/vinculacin 222, 537 sqlflag, opcin de precompilacin 537 sqlrules, opcin de precompilacin 537 sqlwarn, opcin de precompilacin/vinculacin 222, 537 START DATABASE MANAGER, mandato 681 STOP DATABASE MANAGER, mandato 687 strdel, opcin de precompilacin/vinculacin 222, 537 striptblanks, modificador de tipo de archivo 398, 481 striptnulls, modificador de tipo de archivo 398, 481 subtableconvert, modificador de tipo de archivo 481 supervisin bases de datos 358, 367 Supervisor de anomalas de DB2, mandato 69 supervisor de bases de datos descripcin 730 supervisor de sistema de bases de datos GET DATABASE MANAGER MONITOR SWITCHES, mandato 358 GET MONITOR SWITCHES, mandato 367 GET SNAPSHOT 374 RESET MONITOR, mandato 631 UPDATE MONITOR SWITCHES, mandato 730
syncpoint, opcin de precompilacin 537
T
tablas cargar archivos en 481 estadsticas descripcin 659 exportar a archivos 322 importar archivos 398 reorganizacin determinar si es necesaria 612 REORG INDEXES/TABLE, mandato 603 target, opcin de precompilacin 537 TCP/IP, nodo descatalogar 699 terminacin anormal 633 normal 687 proceso de fondo del procesador de lnea de mandatos 691 terminacin anormal 633 TERMINATE, mandato 691 text, opcin de precompilacin/vinculacin 222, 537 timeformat, modificador de tipo de archivo 398, 481 timestampformat, modificador de tipo de archivo 398, 481 totalfreespace, modificador de tipo de archivo 481 Trabajar con imgenes de TSM archivadas, mandato 9 transform group, opcin de precompilacin/vinculacin 222, 537 TSO acceder a texto de ayuda 180
U
UNCATALOG DATABASE, mandato 692 UNCATALOG DCS DATABASE, mandato 694 UNCATALOG LDAP DATABASE, mandato 696 UNCATALOG LDAP NODE, mandato 698 UNCATALOG NODE, mandato 699
ndice
791
UNCATALOG ODBC DATA SOURCE, mandato 701 UNQUIESCE, mandato 702 UPDATE ADMIN CONFIGURATION, mandato 704 UPDATE ALERT CONFIGURATION, mandato 707 UPDATE CLI CONFIGURATION, mandato 712 UPDATE COMMAND OPTIONS, mandato 714 UPDATE CONTACT, mandato 716 UPDATE CONTACTGROUP, mandato 717 UPDATE DATABASE CONFIGURATION, mandato 718 UPDATE DATABASE MANAGER CONFIGURATION, mandato 721 UPDATE HEALTH NOTIFICATION CONTACT LIST, mandato 724 UPDATE HISTORY FILE, mandato 725 UPDATE LDAP NODE, mandato 727 UPDATE MONITOR SWITCHES, mandato 730 usedefaults, modificador de tipo de archivo 398, 481 utilizar al importar archivos PC/IXF 398
variables de entorno (continuacin) leer de archivo de entrada (-f), opcin 184 mostrar datos SQLCA (-a), opcin 183 mostrar mensajes de aviso (-w), opcin 188 opcin suprimir impresin de cabeceras de columna (-x) 188 salida verbosa (-v), opcin 188 visualizar indicador interactivo de DB2 (-p), opcin 186 visualizar salida (-o), opcin 186 visualizar SQLCODE/SQLSTATE (-e), opcin 184 variables del sistema principal no soportadas en procesador de lnea de mandatos 195 version, opcin de precompilacin 537 va de acceso, optimizacin 659 vinculacin errores 283 esquema creado implcitamente 222, 537 volcar un rastreo en archivo 170 Volver a vincular todos los paquetes, mandato 144
W
wchartype, opcin de precompilacin 537
V
validate, opcin de precompilacin/vinculacin 222, 537 variables sintaxis 743 variables de entorno anotar cronolgicamente mandatos en archivo histrico (-l), opcin 185 carcter de terminacin de sentencia (-t), opcin 188 compromiso automtico (-c), opcin 183 DB2OPTIONS 181 detener ejecucin en error de mandato (-s), opcin 187 eliminar carcter de lnea nueva (-n), opcin 185 guardar en archivo de informe (-r), opcin 187 guardar toda la salida en archivo (-z), opcin 188
X
XBSA (API de servicios de copia de seguridad) 216
Z
zoned decimal, modificador de tipo de archivo 481
792
Command Reference
Nmero Pieza: CT18RES
Printed in Denmark by IBM Danmark A/S
SC10-3725-00
(1P) P/N: CT18RES

DB 2 N 0 Z 80

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

DB 2 N 0 Z 80

Încărcat de

Drepturi de autor:

Formate disponibile

IBM DB2 Universal Database

IBM DB2 Universal Database

102 103 110 116 121 124 126

. 179 . 181 . 189 . 190 . 191 . 191 . 194

165 168 169 170

. 749 . 749 749 . 749

Acerca de este manual

Quin debe utilizar este manual

Cmo est estructurado este manual

Copyright IBM Corp. 1993-2002

Captulo 1. Mandatos del sistema

Cmo estn organizadas las descripciones de los mandatos

Mandatos del sistema

Captulo 1. Mandatos del sistema

Captulo 1. Mandatos del sistema

db2admin - Servidor de administracin DB2 db2admin -Mandato Servidor de administracin DB2

db2admin - Servidor de administracin DB2

LOADCOPY LOGS BETWEEN ns1 VERIFY TABLESPACE FULL

NONINCREMENTAL INCREMENTAL DELTA DBPARTITIONNUM

Parmetros del mandato: QUERY Consulta objetos DB2 en el servidor TSM.

Captulo 1. Mandatos del sistema

db2adutl - Trabajar con imgenes TSM archivadas

db2adutl - Trabajar con imgenes TSM archivadas

db2adutl - Trabajar con imgenes TSM archivadas

db2adutl - Trabajar con imgenes TSM archivadas

Captulo 1. Mandatos del sistema

db2advis - Asesor de ndices DB2 db2advis -Mandato Asesor de ndices DB2

db2advis - Asesor de ndices DB2

db2advis - Asesor de ndices DB2

Espere un intervalo de tiempo apropiado. 2. Emita

db2advis - Asesor de ndices DB2

Captulo 1. Mandatos del sistema

db2atld - Autoloader db2atld -Mandato Cargador automtico

Captulo 1. Mandatos del sistema

db2batch - Herramienta Benchmark db2batch -Mandato Herramienta de banco de pruebas

db2batch - Herramienta Benchmark

Captulo 1. Mandatos del sistema

db2batch - Herramienta Benchmark

db2batch - Herramienta Benchmark

Captulo 1. Mandatos del sistema

db2batch - Herramienta Benchmark

db2batch - Herramienta Benchmark

db2batch - Herramienta Benchmark

espec-archivo Nombre del archivo de vinculacin cuyo contenido debe visualizarse.

Captulo 1. Mandatos del sistema

db2cap - Herramienta de vinculacin de paquetes estticos CLI/ODBC

Captulo 1. Mandatos del sistema

db2cc - Iniciar el Centro de control db2cc -Mandato Iniciar el Centro de control

-tcomms Limita el rastreo a los sucesos de comunicaciones.

db2cc - Iniciar el Centro de control

Captulo 1. Mandatos del sistema

db2cfexp - Herramienta de exportacin de configuracin de conectividad

Captulo 1. Mandatos del sistema

Captulo 1. Mandatos del sistema

db2cidmg - Migracin de base de datos remota

db2ckbkp - Comprobar copia de seguridad db2ckbkp - Mandato Comprobar copia de seguridad

Captulo 1. Mandatos del sistema

db2ckbkp - Comprobar copia de seguridad

Ejemplo 2 (en plataformas Windows)

db2ckbkp - Comprobar copia de seguridad

Captulo 1. Mandatos del sistema

db2ckbkp - Comprobar copia de seguridad

Captulo 1. Mandatos del sistema