db2 para linux,unix ywindowspublic.dhe.ibm.com/ps/products/db2/info/vr97/pdf/es_es/db2comm… ·...

DB2para Linux, UNIX y Windows

Consulta de mandatosActualizado en julio de 2012

Versión 9 Release 7

SC11-3914-03

��

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información general contenida en el apartadoApéndice D, “Avisos”, en la página 1305.

Nota de edición

Este manual es la traducción del original en inglés DB2 for Linux, UNIX, and Windows Version 9 Release 7 CommandReference Updated July, 2012 (SC27-2439-03).

Este documento contiene información propiedad de IBM. Se proporciona según un acuerdo de licencia y estáprotegido por la ley de la propiedad intelectual. La información contenida en esta publicación no incluye ningunagarantía de producto, por lo que ninguna declaración proporcionada en este manual deberá interpretarse como tal.

Puede realizar pedidos de publicaciones de IBM en línea o a través del representante de IBM de su localidad.v Para realizar pedidos en línea, vaya a IBM Publications Center ubicado en el sitio web www.ibm.com/shop/

publications/order

v Para encontrar al representante de IBM de su localidad, vaya al IBM Directory of Worldwide Contacts en el sitioweb www.ibm.com/planetwide

Para realizar pedidos de publicaciones de DB2 desde DB2 Marketing and Sales, en los EE.UU. o en Canadá, llameal 1-800-IBM-4YOU (426-4968).

Cuando envía información a IBM, otorga a IBM un derecho no exclusivo a utilizar o distribuir dicha información enla forma en que IBM considere adecuada, sin contraer por ello ninguna obligación con el remitente.

© Copyright IBM Corporation 1993, 2012.

Contenido

Acerca de este manual . . . . . . . . ixQuién debe utilizar este manual . . . . . . . ixCómo esta estructurado este manual . . . . . . ixConvenios de resaltado . . . . . . . . . . . x

Cómo leer los diagramas de sintaxis . . xi

Capítulo 1. Procesador de línea demandatos (CLP) . . . . . . . . . . . 1Funciones del procesador de línea de mandatos . . 2db2 - Invocación del procesador de línea demandatos . . . . . . . . . . . . . . . 9Opciones del procesador de línea de mandatos . . 11Códigos de retorno del procesador de línea demandatos . . . . . . . . . . . . . . . 20Invocar ayuda de mandatos desde el procesador delínea de mandatos . . . . . . . . . . . . 21Invocar ayuda de mensajes desde el procesador delínea de mandatos . . . . . . . . . . . . 21

Capítulo 2. Utilización de sentencias deSQL y XQuery de línea de mandatos . . 23

Capítulo 3. Command Line ProcessorPlus (CLPPlus) . . . . . . . . . . . 31Instalación de CLPPlus en clientes de servidor dedatos de IBM existentes . . . . . . . . . . 31Inicio de CLPPlus . . . . . . . . . . . . 32Mandato CLPPLUS . . . . . . . . . . . . 33Tipos de consola de CLPPlus . . . . . . . . 35Modalidad de ventana y soporte de caracteresUTF-8 . . . . . . . . . . . . . . . . 37Alias de DSN en CLPPlus . . . . . . . . . 37Autentificación de Kerberos en CLPPlus . . . . . 39Autentificación SERVER_ENCRYPT en CLPPlus . . 40Soporte de LDAP en CLPPlus . . . . . . . . 42CREATE DATABASE en CLPPlus . . . . . . . 46Ejecución de un archivo script en CLPPlus . . . . 47Interrupción y omisión de mandatos de CLPPlus . . 49Comentarios en CLPPlus . . . . . . . . . . 50Caracteres de escape en CLPPlus . . . . . . . 51Vinculación de variables en CLPPlus . . . . . . 53Variables de entorno y shell en CLPPlus . . . . . 57Rastreos y anotación cronológica de registro deCLPPlus . . . . . . . . . . . . . . . 58Mandatos de DB2 soportados por CLPPlus . . . . 59Restricciones de CLPPlus . . . . . . . . . . 59Consejos y sugerencias para la resolución deproblemas de CLPPlus . . . . . . . . . . 61

Capítulo 4. Cómo leer la ayuda desintaxis de mandatos . . . . . . . . 63

Capítulo 5. mandatos CLP . . . . . . 67ACTIVATE DATABASE . . . . . . . . . . 68ADD CONTACT . . . . . . . . . . . . 70ADD CONTACTGROUP . . . . . . . . . . 72ADD DBPARTITIONNUM . . . . . . . . . 73ADD XMLSCHEMA DOCUMENT . . . . . . 76ARCHIVE LOG . . . . . . . . . . . . . 78ATTACH . . . . . . . . . . . . . . . 81AUTOCONFIGURE . . . . . . . . . . . 83BACKUP DATABASE . . . . . . . . . . . 86BIND . . . . . . . . . . . . . . . . 97CATALOG DATABASE . . . . . . . . . . 119CATALOG DCS DATABASE . . . . . . . . 123CATALOG LDAP DATABASE . . . . . . . . 125CATALOG LDAP NODE . . . . . . . . . 128CATALOG LOCAL NODE . . . . . . . . . 129CATALOG NAMED PIPE NODE. . . . . . . 131CATALOG ODBC DATA SOURCE . . . . . . 133CATALOG TCPIP/TCPIP4/TCPIP6 NODE . . . 135CHANGE DATABASE COMMENT . . . . . . 139CHANGE ISOLATION LEVEL . . . . . . . 141COMPLETE XMLSCHEMA . . . . . . . . 143CREATE DATABASE . . . . . . . . . . . 144CREATE TOOLS CATALOG . . . . . . . . 164DEACTIVATE DATABASE . . . . . . . . . 167DECOMPOSE XML DOCUMENT . . . . . . 169DECOMPOSE XML DOCUMENTS . . . . . . 171DEREGISTER . . . . . . . . . . . . . 175DESCRIBE . . . . . . . . . . . . . . 176DETACH . . . . . . . . . . . . . . . 186DROP CONTACT . . . . . . . . . . . . 187DROP CONTACTGROUP . . . . . . . . . 188DROP DATABASE . . . . . . . . . . . 189DROP DBPARTITIONNUM VERIFY. . . . . . 191DROP TOOLS CATALOG . . . . . . . . . 192ECHO . . . . . . . . . . . . . . . . 194EDIT . . . . . . . . . . . . . . . . 195EXPORT . . . . . . . . . . . . . . . 196FORCE APPLICATION . . . . . . . . . . 209GET ADMIN CONFIGURATION . . . . . . . 211GET ALERT CONFIGURATION . . . . . . . 213GET CLI CONFIGURATION . . . . . . . . 219GET CONNECTION STATE . . . . . . . . 221GET CONTACTGROUP . . . . . . . . . . 222GET CONTACTGROUPS . . . . . . . . . 223GET CONTACTS . . . . . . . . . . . . 224GET DATABASE CONFIGURATION . . . . . 225GET DATABASE MANAGER CONFIGURATION 232GET DATABASE MANAGER MONITORSWITCHES . . . . . . . . . . . . . . 238GET DESCRIPTION FOR HEALTH INDICATOR 241GET HEALTH NOTIFICATION CONTACT LIST 243GET HEALTH SNAPSHOT. . . . . . . . . 244GET INSTANCE . . . . . . . . . . . . 247GET MONITOR SWITCHES . . . . . . . . 248

© Copyright IBM Corp. 1993, 2012 iii

GET RECOMMENDATIONS FOR HEALTHINDICATOR. . . . . . . . . . . . . . 251GET ROUTINE . . . . . . . . . . . . . 255GET SNAPSHOT . . . . . . . . . . . . 257HELP . . . . . . . . . . . . . . . . 273HISTORY. . . . . . . . . . . . . . . 274IMPORT . . . . . . . . . . . . . . . 275INITIALIZE TAPE. . . . . . . . . . . . 306INSPECT . . . . . . . . . . . . . . . 307LIST ACTIVE DATABASES. . . . . . . . . 315LIST APPLICATIONS . . . . . . . . . . 317LIST COMMAND OPTIONS . . . . . . . . 319LIST DATABASE DIRECTORY . . . . . . . 320LIST DATABASE PARTITION GROUPS . . . . 324LIST DBPARTITIONNUMS. . . . . . . . . 326LIST DCS APPLICATIONS . . . . . . . . . 327LIST DCS DIRECTORY . . . . . . . . . . 329LIST DRDA INDOUBT TRANSACTIONS . . . . 331LIST HISTORY . . . . . . . . . . . . . 333LIST INDOUBT TRANSACTIONS . . . . . . 337LIST NODE DIRECTORY . . . . . . . . . 340LIST ODBC DATA SOURCES . . . . . . . . 343LIST PACKAGES/TABLES . . . . . . . . . 344LIST TABLESPACE CONTAINERS . . . . . . 347LIST TABLESPACES . . . . . . . . . . . 349LIST UTILITIES . . . . . . . . . . . . 354LOAD . . . . . . . . . . . . . . . . 356LOAD QUERY . . . . . . . . . . . . . 405MIGRATE DATABASE . . . . . . . . . . 411PING . . . . . . . . . . . . . . . . 412PRECOMPILE . . . . . . . . . . . . . 414PRUNE HISTORY/LOGFILE . . . . . . . . 443PUT ROUTINE . . . . . . . . . . . . . 445QUERY CLIENT . . . . . . . . . . . . 447QUIESCE. . . . . . . . . . . . . . . 448QUIESCE TABLESPACES FOR TABLE . . . . . 452QUIT . . . . . . . . . . . . . . . . 455REBIND . . . . . . . . . . . . . . . 456RECOVER DATABASE . . . . . . . . . . 461REDISTRIBUTE DATABASE PARTITION GROUP 468REFRESH LDAP . . . . . . . . . . . . 479REGISTER . . . . . . . . . . . . . . 481REGISTER XMLSCHEMA . . . . . . . . . 484REGISTER XSROBJECT . . . . . . . . . . 486REORG INDEXES/TABLE . . . . . . . . . 488REORGCHK . . . . . . . . . . . . . 506RESET ADMIN CONFIGURATION . . . . . . 518RESET ALERT CONFIGURATION . . . . . . 520RESET DATABASE CONFIGURATION. . . . . 522RESET DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 524RESET MONITOR. . . . . . . . . . . . 526RESTART DATABASE . . . . . . . . . . 528RESTORE DATABASE . . . . . . . . . . 530REWIND TAPE . . . . . . . . . . . . 552ROLLFORWARD DATABASE . . . . . . . . 553RUNCMD . . . . . . . . . . . . . . 565RUNSTATS . . . . . . . . . . . . . . 566SET CLIENT . . . . . . . . . . . . . 582SET RUNTIME DEGREE . . . . . . . . . 585SET SERVEROUTPUT . . . . . . . . . . 587

SET TABLESPACE CONTAINERS . . . . . . 589SET TAPE POSITION . . . . . . . . . . 592SET UTIL_IMPACT_PRIORITY . . . . . . . 593SET WORKLOAD . . . . . . . . . . . . 596SET WRITE . . . . . . . . . . . . . . 597START DATABASE MANAGER . . . . . . . 599START HADR . . . . . . . . . . . . . 608STOP DATABASE MANAGER . . . . . . . 611STOP HADR . . . . . . . . . . . . . 614TAKEOVER HADR . . . . . . . . . . . 616TERMINATE . . . . . . . . . . . . . 621UNCATALOG DATABASE . . . . . . . . . 622UNCATALOG DCS DATABASE . . . . . . . 624UNCATALOG LDAP DATABASE . . . . . . 625UNCATALOG LDAP NODE . . . . . . . . 626UNCATALOG NODE . . . . . . . . . . 627UNCATALOG ODBC DATA SOURCE . . . . . 628UNQUIESCE . . . . . . . . . . . . . 629UPDATE ADMIN CONFIGURATION . . . . . 631UPDATE ALERT CONFIGURATION . . . . . 633UPDATE ALTERNATE SERVER FOR DATABASE 638UPDATE ALTERNATE SERVER FOR LDAPDATABASE . . . . . . . . . . . . . . 640UPDATE CLI CONFIGURATION . . . . . . 641UPDATE COMMAND OPTIONS. . . . . . . 643UPDATE CONTACT . . . . . . . . . . . 645UPDATE CONTACTGROUP . . . . . . . . 646UPDATE DATABASE CONFIGURATION . . . . 647UPDATE DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 651UPDATE HEALTH NOTIFICATION CONTACTLIST . . . . . . . . . . . . . . . . 654UPDATE HISTORY . . . . . . . . . . . 655UPDATE LDAP NODE . . . . . . . . . . 658UPDATE MONITOR SWITCHES . . . . . . . 660UPDATE XMLSCHEMA. . . . . . . . . . 662UPGRADE DATABASE . . . . . . . . . . 664

Capítulo 6. Mandatos de CLPPlus . . 667. . . . . . . . . . . . . . . . . . . 668! . . . . . . . . . . . . . . . . . . 669Mandato / . . . . . . . . . . . . . . 670Mandato @ . . . . . . . . . . . . . . 671Mandato @@ . . . . . . . . . . . . . 672Mandato ACCEPT. . . . . . . . . . . . 673Mandato APPEND . . . . . . . . . . . 675Mandato BREAK . . . . . . . . . . . . 676Mandato BTITLE . . . . . . . . . . . . 677Mandato CHANGE . . . . . . . . . . . 679Mandato CLEAR . . . . . . . . . . . . 682Mandato COLUMN . . . . . . . . . . . 684Mandato COMPUTE . . . . . . . . . . . 689Mandato CONNECT . . . . . . . . . . . 691Mandato COPY . . . . . . . . . . . . 693Mandato DEFINE . . . . . . . . . . . . 695Mandato DEL . . . . . . . . . . . . . 696Mandato DESCRIBE . . . . . . . . . . . 698Mandato DISCONNECT. . . . . . . . . . 703Mandato EDIT . . . . . . . . . . . . . 704Mandato EXECUTE . . . . . . . . . . . 705Mandato EXIT . . . . . . . . . . . . . 708

iv Consulta de mandatos

EXPLAIN PLAN . . . . . . . . . . . . 710Mandato GET . . . . . . . . . . . . . 712Mandato HELP. . . . . . . . . . . . . 713Mandato HOST . . . . . . . . . . . . 714Mandato IMPORT de CLPPlus . . . . . . . 715Mandato INPUT . . . . . . . . . . . . 717Mandato LIST . . . . . . . . . . . . . 718Mandato PAUSE . . . . . . . . . . . . 720Mandato PRINT . . . . . . . . . . . . 721Mandato PROMPT . . . . . . . . . . . 722Mandato QUIT . . . . . . . . . . . . . 723Mandato REMARK . . . . . . . . . . . 724REORGCHK . . . . . . . . . . . . . 725Mandato REPFOOTER . . . . . . . . . . 727Mandato REPHEADER . . . . . . . . . . 729Mandato RUN . . . . . . . . . . . . . 731Mandato SAVE . . . . . . . . . . . . . 732Mandato SET . . . . . . . . . . . . . 733Mandato SPOOL . . . . . . . . . . . . 741Mandato SHOW . . . . . . . . . . . . 742Mandato START . . . . . . . . . . . . 743Mandato TTITLE . . . . . . . . . . . . 744Mandato UNDEFINE. . . . . . . . . . . 746WHENEVER OSERROR . . . . . . . . . . 747WHENEVER SQLERROR . . . . . . . . . 749

Capítulo 7. Mandatos del sistema. . . 753dasauto - Iniciar automáticamente el Servidor deadministración de DB2 . . . . . . . . . . 754dascrt - Crear un Servidor de administración deDB2 . . . . . . . . . . . . . . . . 755dasdrop - Eliminar un servidor de administraciónde DB2 . . . . . . . . . . . . . . . 756dasmigr - Migrar el Servidor de administración deDB2 . . . . . . . . . . . . . . . . 757dasupdt - Actualizar DAS . . . . . . . . . 759db2_deinstall - Desinstalar productos,características o idiomas de base de datos DB2 . . 761db2_install - Instalar el producto de base de datosDB2 . . . . . . . . . . . . . . . . 764db2_local_ps - Estado de procesos de DB2 paraLinux/UNIX . . . . . . . . . . . . . 767db2acsutil - Gestionar objetos de copia deseguridad selectiva de DB2 . . . . . . . . . 769db2addicons - Crear entradas del menú principalpara las herramientas de DB2 . . . . . . . . 773db2admin - Servidor de administración de DB2 774db2adutl - Gestión de objetos DB2 en TSM . . . 776db2advis - Asesor de diseño de DB2. . . . . . 786db2audit - Herramienta de administrador delrecurso de comprobación . . . . . . . . . 794db2batch - Herramienta de evaluación . . . . . 804db2bfd - Herramienta de descripción de archivo devinculación . . . . . . . . . . . . . . 814db2ca - Iniciar el Asistente de configuración . . . 815db2caem - Herramienta de captura de datos desupervisor de sucesos de actividad . . . . . . 816db2cap - Herramienta de vinculación de paquetesestáticos de CLI/ODBC . . . . . . . . . . 820db2cat - Análisis del catálogo del sistema . . . . 822db2cc - Iniciar el Centro de control . . . . . . 825

db2cfexp - Herramienta de exportación deconfiguración de conectividad . . . . . . . . 827db2cfimp - Herramienta de importación deconfiguración de conectividad . . . . . . . . 829db2chglibpath - Modificar la vía de acceso debúsqueda de biblioteca en tiempo de ejecuciónincorporada . . . . . . . . . . . . . . 830db2chgpath - Cambiar vía de acceso de tiempo deejecución incorporada . . . . . . . . . . 833db2ckbkp - Comprobar copia de seguridad . . . 835Mandato db2cklog - Comprobar los archivos deanotaciones cronológicas de archivado . . . . . 839db2ckmig - Premigración de la base de datos. . . 842db2ckrst - Comprobar secuencia de imágenes derestauración incremental. . . . . . . . . . 843db2ckupgrade - Comprobar base de datos paraactualización . . . . . . . . . . . . . 845db2cli - CLI . . . . . . . . . . . . . . 849db2cmd - Abrir ventana de mandatos de DB2 . . 864db2cptsa - Instalar o actualizar scripts HA de DB2 865db2dart - Herramienta de informes y análisis debase de datos . . . . . . . . . . . . . 867db2daslevel - Mostrar nivel de DAS . . . . . . 874db2dclgn - Generador de declaraciones . . . . . 875db2diag - Herramienta de análisis de anotacionescronológicas db2diag . . . . . . . . . . . 878db2drdat - Rastreo DRDA . . . . . . . . . 896db2drvmp - Correlación de unidades de base dedatos DB2 . . . . . . . . . . . . . . 898db2empfa - Habilitar asignación de archivos demúltiples páginas . . . . . . . . . . . . 900db2envar.bat - Establecer entorno de la ventana demandatos actual . . . . . . . . . . . . 901db2eva - Analizador de sucesos . . . . . . . 902db2evmon - Herramienta de productividad delsupervisor de sucesos . . . . . . . . . . 904db2evtbl - Generar definiciones de tabla de destinodel supervisor de sucesos . . . . . . . . . 906db2exfmt - Formato de la tabla de Explain . . . 908db2exmig - Migrar tablas de Explain . . . . . 911db2expln - Explicación de SQL y XQuery . . . . 912db2extsec - Establecer permisos para objetos DB2 922db2flsn - Buscar número de secuencia deanotaciones cronológicas . . . . . . . . . 924db2fm - Supervisor de anomalías de DB2 . . . . 926db2fmcu - Controlador de supervisor de anomalíasde DB2 . . . . . . . . . . . . . . . 928db2fodc - Recopilación de datos de primeraaparición de DB2 . . . . . . . . . . . . 930db2fopt - Especificar parámetros para eloptimizador de consultas . . . . . . . . . 941db2fs - Primeros pasos . . . . . . . . . . 944db2gcf - Controlar instancia de DB2 . . . . . . 945db2gov - DB2 Governor . . . . . . . . . . 948db2govlg - Consulta de anotación cronológica deDB2 Governor . . . . . . . . . . . . . 951db2gpmap - Obtener correlación de distribución 952db2hc - Iniciar el Centro de salud . . . . . . 954db2iauto - Iniciar instancia automáticamente . . . 955db2iclus - Servidor de clústeres de Microsoft . . . 956db2icrt - Crear instancia . . . . . . . . . . 959

Contenido v

db2idrop - Eliminar instancia . . . . . . . . 964db2IdentifyType1 - Herramienta de identificaciónde índices de tipo 1 . . . . . . . . . . . 967db2ilist - Listar instancias . . . . . . . . . 970db2imigr - Migrar instancia . . . . . . . . 971db2inidb - Inicializar una base de datos duplicada 973db2inspf - Formatear resultados de inspección . . 976db2iprune - Reducir el tamaño de la imagen deinstalación . . . . . . . . . . . . . . 977db2isetup - Iniciar interfaz de creación deinstancias. . . . . . . . . . . . . . . 979db2iupdt - Actualizar instancias . . . . . . . 981db2iupgrade - Actualizar instancia . . . . . . 985db2jdbcbind - Programa de utilidad vinculador depaquetes de JDBC de DB2 . . . . . . . . . 989db2ldcfg - Configurar entorno de LDAP . . . . 991db2level - Mostrar nivel de servicio de DB2 . . . 992db2licm - Herramienta de gestión de licencias . . 993db2listvolumes - Visualizar los GUID para todoslos volúmenes de disco . . . . . . . . . . 996db2logsforrfwd - Listar anotaciones cronológicasnecesarias para recuperación en avance. . . . . 997db2look - Herramienta de extracción de DDL y deestadísticas de DB2 . . . . . . . . . . . 998db2ls - Listar productos y características de DB2 1011db2move - Herramienta de movimiento de basede datos. . . . . . . . . . . . . . . 1014db2mqlsn - MQ Listener . . . . . . . . . 1024db2mscs - Configurar programa de utilidadFailover de Windows . . . . . . . . . . 1028db2mtrk - Rastreador de memoria . . . . . . 1032db2nchg - Cambiar configuración de servidor departiciones de base de datos . . . . . . . . 1037db2ncrt - Añadir servidor de particiones de basede datos a una instancia . . . . . . . . . 1039db2ndrop - Descartar servidor de particiones debase de datos de una instancia . . . . . . . 1041db2nrcfg - Herramienta de configuración deinstalación no root . . . . . . . . . . . 1042db2nrupdt - Actualización de instancia deinstalación no root . . . . . . . . . . . 1043db2nrupgrade - Actualizar una instancia no root 1044db2osconf - Programa de utilidad para los valoresde parámetro de kernel. . . . . . . . . . 1045db2pd - Supervisar y resolver problemas de basede datos DB2 . . . . . . . . . . . . . 1048db2pdcfg - Configurar la base de datos DB2 decara al comportamiento de la determinación deproblemas . . . . . . . . . . . . . . 1137db2perfc - Restablecer valores de rendimiento debase de datos . . . . . . . . . . . . . 1144db2perfi - Programa de utilidad de registro decontadores de rendimiento . . . . . . . . 1146db2perfr - Herramienta de registro de supervisorde rendimiento . . . . . . . . . . . . 1147db2rbind - Volver a vincular todos los paquetes 1148db2relocatedb - Reubicar base de datos . . . . 1150db2rfe - Habilitar características root parainstalación no root . . . . . . . . . . . 1157db2rfpen - Restablecer estado pendiente deavance . . . . . . . . . . . . . . . 1159

db2rmicons - Eliminar las herramientas de DB2del menú principal . . . . . . . . . . . 1160db2rspgn - Generador de archivos de respuestas 1161db2sampl - Crear base de datos de ejemplo . . . 1162db2schex - Ampliación de esquema de ActiveDirectory . . . . . . . . . . . . . . 1165db2set - Registro de perfiles de DB2 . . . . . 1167db2setup - Instalar DB2 . . . . . . . . . 1171db2snapcore - Mandato DB2 snapcore para Linuxy Solaris . . . . . . . . . . . . . . . 1173db2start - Iniciar DB2 . . . . . . . . . . 1175db2stat - Estado de procesos de DB2 paraWindows . . . . . . . . . . . . . . 1176db2stop - Detener DB2 . . . . . . . . . . 1177db2support - Herramienta de análisis deproblemas y recolección del entorno . . . . . 1178db2swtch - Conmutar copia de DB2 por omisión ycopia de interfaz de cliente de base de datos . . 1193db2sync - Iniciar el sincronizador de DB2 . . . 1195db2systray - Iniciar la bandeja del sistema DB2 1196db2tapemgr - Gestionar archivos de anotacionescronológicas en cinta . . . . . . . . . . 1198db2tbst - Obtener estado de espacio de tablas 1201db2tdbmgr - Migrar base de datos de catálogo deherramientas . . . . . . . . . . . . . 1202db2top - Herramienta de supervisión de DB2 1203db2trc - Rastrear . . . . . . . . . . . . 1208db2trcoff - Opciones de rastreo desactivado paradb2trc . . . . . . . . . . . . . . . 1222db2trcon - Opciones de rastreo activado paradb2trc . . . . . . . . . . . . . . . 1223db2unins - Desinstalar productos, características oidiomas de base de datos DB2 . . . . . . . 1225db2untag - Liberar identificador de contenedor 1227db2updserv - Mostrar actualizaciones delproducto . . . . . . . . . . . . . . 1228db2updv97 - Actualizar la base de datos alfixpack de la Versión 9.7 . . . . . . . . . 1229db2val - Herramienta de validación de copia deDB2 . . . . . . . . . . . . . . . . 1231db2xdbmig - Migrar objetos XSR . . . . . . 1233db2xprt - Formatear archivo de detección deexcepción . . . . . . . . . . . . . . 1234disable_MQFunctions - Inhabilitar funciones deWebSphere MQ . . . . . . . . . . . . 1235doce_deinstall - Desinstalar el Centro deinformación de DB2 . . . . . . . . . . . 1236doce_install - Instalar el Centro de información deDB2 . . . . . . . . . . . . . . . . 1238enable_MQFunctions - Habilitar funciones deWebSphere MQ . . . . . . . . . . . . 1240installDSDriver - Extraer componentes de IBMData Server Driver . . . . . . . . . . . 1243installFixPack - Actualizar productos de base dedatos DB2 instalados . . . . . . . . . . 1245setup - Instalar DB2 . . . . . . . . . . . 1250

Capítulo 8. Mandatos de DB2 TextSearch . . . . . . . . . . . . . . 1253db2ts ALTER INDEX . . . . . . . . . . 1254db2ts CLEANUP FOR TEXT . . . . . . . . 1259

vi Consulta de mandatos

db2ts CLEAR COMMAND LOCKS. . . . . . 1260db2ts CLEAR EVENTS FOR INDEX . . . . . 1262db2ts CREATE INDEX . . . . . . . . . . 1264db2ts DISABLE DATABASE FOR TEXT . . . . 1271db2ts DROP INDEX . . . . . . . . . . . 1274db2ts ENABLE DATABASE FOR TEXT . . . . 1276db2ts HELP . . . . . . . . . . . . . 1278db2ts START FOR TEXT . . . . . . . . . 1280db2ts STOP FOR TEXT . . . . . . . . . . 1281db2ts UPDATE INDEX . . . . . . . . . . 1282

Apéndice A. Convenios dedenominación . . . . . . . . . . 1287Convenios de denominación . . . . . . . . 1288

Apéndice B. Modificadores ydelimitadores de tipo de archivo . . 1289Modificadores de tipo de archivo para losprogramas de utilidad de exportación,importación y carga . . . . . . . . . . . 1290Consideraciones sobre los delimitadores paramover datos . . . . . . . . . . . . . 1291

Apéndice C. Visión general de lainformación técnica de DB2 . . . . 1293

Biblioteca técnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 1294Pedido de manuales de DB2 en copia impresa 1296Visualización de la ayuda para estados de SQLdesde el procesador de línea de mandatos . . . 1297Acceso a diferentes versiones del Centro deinformación de DB2 . . . . . . . . . . . 1298Visualización de temas en su idioma preferido enel Centro de información de DB2 . . . . . . 1298Actualización del Centro de información de DB2instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1299Actualización manual del Centro de informaciónde DB2 instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1300Guías de aprendizaje de DB2 . . . . . . . . 1302Información de resolución de problemas de DB2 1303Términos y condiciones . . . . . . . . . 1303

Apéndice D. Avisos . . . . . . . . 1305

Índice . . . . . . . . . . . . . . 1309

Contenido vii

viii Consulta de mandatos

Acerca de este manual

Este manual proporciona información acerca del uso de mandatos del sistema y delprocesador de la línea de mandatos (CLP) IBM® DB2 para ejecutar funcionesadministrativas de bases de datos.

Quién debe utilizar este manualSe supone que el lector tiene conocimientos de administración de bases de datos yconoce el Lenguaje de Consulta Estructurada (SQL).

Cómo esta estructurado este manualEste manual proporciona la información de consulta necesaria para utilizar losmandatos de CLP, del sistema y de DB2 Text Search.

Las principales áreas temáticas tratadas en los capítulos de este manual son lassiguientes:

Utilización del procesador de línea de mandatos (CLP)

v El capítulo 1, “Procesador de la línea de mandatos (CLP),” explica cómoinvocar y utilizar el procesador de línea de mandatos y describe lasopciones del CLP.

v El capítulo 2, “Utilización de las sentencias de SQL y SQuery de la líneade mandatos” proporciona información sobre cómo utilizar lassentencias de SQL desde la línea de mandatos.

Uso de Command Line Processor Plus (CLPPlus)

v En el capítulo 3, “Command Line Processor Plus (CLPPlus)”, se describecómo instalar, invocar y utilizar la interfaz de Command Line ProcessorPlus.

Ayuda para el uso de mandatos

v En el capítulo 4, “Cómo leer la ayuda de sintaxis de mandatos”, sedescribe cómo invocar las pantallas de ayuda de los mandatos y explicalas convenciones sintácticas de la pantalla de ayuda que se utilizan.

mandatos CLP

v En el capítulo 5, “Mandatos CLP”, se describen todos los mandatos delgestor de bases de datos en orden alfabético.

Mandatos de CLPPlus

v En el capítulo 6, “Mandatos de CLPPlus”, se listan alfabéticamente y sedescriben todos los mandatos que se pueden utilizar en la interfaz deCLPPlus.

Mandatos del sistema

v En el capítulo 7, “Mandatos del sistema”, se describen todos losmandatos, en orden alfabético, que pueden especificarse en un indicadorde mandatos del sistema operativo o en un script de shell para accederal gestor de bases de datos.

Mandatos de DB2 Text Search

© Copyright IBM Corp. 1993, 2012 ix

v En el capítulo 8, “Mandatos de DB2 Text Search”, se describen todos losmandatos de Text Search, en orden alfabético, que pueden especificarseen un indicador de mandatos del sistema operativo con el prefijo db2ts.

Apéndices

v El Apéndice A, “Convenios de denominación” describe los conveniosutilizados para denominar los objetos como, por ejemplo, las bases dedatos y las tablas.

v El Apéndice B, “Modificadores y delimitadores de tipo de archivo”describe los modificadores de tipo de archivo para los programas deutilidad de carga, importación y exportación. Además, también seincluyen consideraciones de los delimitadores para mover los datos.

Convenios de resaltadoEn este manual se utilizan los siguientes convenios de resaltado.

Negrita Indica mandatos, palabras clave y otros elementos cuyos nombres hapredefinido el sistema. Los mandatos escritos en mayúsculas son mandatosdel CLP, mientras que los mandatos escritos en minúsculas son mandatosdel sistema.

Cursiva Indica uno de los siguientes:

v Nombres o valores (variables) que el usuario debe proporcionarv Énfasis generalv La introducción de un término nuevov Una referencia a otra fuente de información

Monoespaciado Indica uno de los siguientes:

v Archivos y directoriosv Información que el usuario debe escribir en una solicitud de mandatos o

en una ventana

v Ejemplos de valores de datos concretosv Ejemplo de texto similares a la forma en que es posible que el sistema los

visualice

v Ejemplos de mensajes de textov Ejemplos de código de programación

Cómo esta estructurado este manual

x Consulta de mandatos

Cómo leer los diagramas de sintaxis

La sintaxis se describe con la estructura definida de la forma siguiente:

Lea los diagramas de sintaxis de izquierda a derecha y de arriba a abajo, siguiendola vía de acceso de la línea.

El símbolo ??--- indica el principio de un diagrama de sintaxis.

El símbolo ---? indica que la sintaxis continúa en la línea siguiente.

El símbolo ?--- indica que la sintaxis continúa de la línea anterior.

El símbolo --?? indica el final de un diagrama de sintaxis.

Los fragmentos de sintaxis empiezan con el símbolo +--- y finalizan con el símbolo---¦.

Los elementos necesarios aparecen en la línea horizontal (en la vía de accesoprincipal).

�� elemento_necesario ��

Los elementos opcionales aparecen bajo la vía de acceso principal.

�� elemento_necesarioelemento_opcional

��

Si un elemento opcional aparece sobre la vía de acceso principal, ese elemento notiene ningún efecto en la ejecución y sólo se utiliza para posibilitar la lectura.

�� elemento_necesarioelemento_opcional

��

Si puede elegir entre dos o más elementos, éstos aparecen en una pila.

Si debe elegir uno de los elementos, un elemento de la pila aparece en la vía deacceso principal.

�� elemento_necesario opción_necesaria1opción_necesaria2

��

Si la elección de uno de los elementos es opcional, la pila entera aparece bajo la víade acceso principal.

�� elemento_necesarioopción_opcional1opción_opcional2

��

© Copyright IBM Corp. 1993, 2012 xi

Si uno de los elementos es el valor por omisión, aparecerá sobre la vía de accesoprincipal y las opciones restantes se mostrarán debajo.

�� elemento_necesarioopción_por_omisión

opción_opcionalopción_opcional

��

Una flecha que vuelve a la izquierda, sobre la línea principal, indica un elementoque se puede repetir. En este caso, los elementos repetidos se deben separarmediante uno o más espacios en blanco.

�� elemento_necesario � elemento_repetible ��

Si la flecha de repetición contiene una coma, debe separar los elementos repetidoscon una coma.

�� elemento_necesario �

,

elemento_repetible ��

Una flecha de repetición sobre una pila indica que puede realizar más una elecciónen los elementos apilados o repetir una sola elección.

Las palabras clave aparecen en mayúsculas (por ejemplo FROM). Se deben escribirexactamente tal como se muestran. Las variables aparecen en minúsculas (porejemplo nombre-columna). Representan nombres o valores proporcionados por elusuario en la sintaxis.

Si se muestran signos de puntuación, paréntesis, operadores aritméticos u otrossímbolos de este tipo, debe entrarlos como parte de la sintaxis.

A veces una variable individual representa un fragmento mayor de la sintaxis. Porejemplo, en el diagrama siguiente, la variable bloque-parámetros representa elfragmento de sintaxis completo que está etiquetado bloque-parámetros:

�� elemento_necesario bloque-parámetros ��

bloque-parámetros:

parámetro1parámetro2 parámetro3

parámetro4

Los segmentos adyacentes que aparecen entre “puntos” (?) se pueden especificaren cualquier secuencia.

�� elemento_necesario elemento1 ? elemento2 ? elemento3 ? elemento4 ��


xii Consulta de mandatos

El diagrama anterior muestra que elemento2 y elemento3 se pueden especificar encualquier orden. Son válidos los dos ejemplos siguientes:

elemento_necesario elemento1 elemento2 elemento3 elemento4elemento_necesario elemento1 elemento3 elemento2 elemento4


Cómo leer los diagramas de sintaxis xiii


xiv Consulta de mandatos

Capítulo 1. Procesador de línea de mandatos (CLP)

© Copyright IBM Corp. 1993, 2012 1

Funciones del procesador de línea de mandatos

El procesador de línea 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 envía al shell de mandato pulsando la tecla INTRO.v La salida se dirige automáticamente al dispositivo de salida estándar.v Se soportan las áreas de interconexión y la redirección.v Se informa al usuario acerca de la realización satisfactoria o no satisfactoria.v A continuación de la ejecución del mandato, el control vuelve al indicador de

mandatos del sistema operativo y el usuario puede entrar más mandatos.v Cuando se llama al CLP con una opción de entrada de archivo, se establecerá

automáticamente el registro especial CLIENT APPLNAME en CLPnombrearchivo.

Puede iniciar el procesador de línea de mandatos:v escribiendo el mandato db2 ov en los sistemas operativos Linux, pulse Menú principal y seleccione IBM DB2 >

Procesador de línea de mandatos.

Determinados mandatos de CLP y sentencias de SQL requieren que la instancia deservidor se esté ejecutando y que exista una conexión de base de datos. Conéctesea una base de datos realizando una de las siguientes acciones:v Emita la sentencia de SQL:

db2 connect to basedatos

v Establezca una conexión implícita a la base de datos por omisión definida por lavariable de registro DB2DBDFT de DB2.

Si un mandato excede el límite de caracteres permitido en el indicador demandatos, se puede utilizar una barra inclinada invertida (\) como carácter decontinuación de línea. Cuando el procesador de línea de mandatos encuentra elcarácter de continuación de línea, lee la línea siguiente y concatena los caracterescontenidos en ambas líneas. Como alternativa, puede utilizarse la opción -t paraestablecer un carácter de terminación de línea distinto.

El procesador de línea de mandatos reconoce una serie llamada NULL como unaserie nula. Los campos que se han establecido anteriormente a algún valor puedenestablecerse en NULL posteriormente. Por ejemplo,

db2 update database manager configuration using tm_database NULL

establece el campo tm_database en NULL. Esta operación es sensible a lasmayúsculas y minúsculas. Un null en minúsculas no se interpreta como una serienula, sino como una serie que contiene las letras null.

Personalización del procesador de línea de mandatos

Es posible personalizar el indicador de entrada interactivo utilizando la variable deregistro DB2_CLPPROMPT. Esta variable de registro se puede establecer en cualquierserie de una longitud máxima de 100 y puede contener los símbolos %i, %ia, %d,%da y %n. Estos símbolos se sustituirán por valores específicos durante laejecución.


2 Consulta de mandatos

Tabla 1. Símbolos y valores durante la ejecución de DB2_CLPPROMPT

Símbolo DB2_CLPPROMPT Valor durante la ejecución

%ia ID de autorización de la conexión de la instancia actual.

%i Alias local de la instancia conectada en la actualidad. Si noexiste ninguna conexión de instancia, será el valor de lavariable de registro DB2INSTANCE. Sólo en plataformasWindows, si la variable de registro DB2INSTANCE no estáestablecida, será el valor de la variable de registroDB2INSTDEF.

%da ID de autorización de la conexión de base de datos actual.

%d Alias local de la base de datos conectada en la actualidad.Si no existe ninguna conexión de base de datos, será elvalor de la variable de registro DB2DBDFT.

%n Línea nueva

v Si hay algún símbolo que no tenga asociado un valor durante el tiempo deejecución, la serie vacía se sustituirá por dicho símbolo.

v El indicador de entrada interactivo siempre presentará los ID de autorización,los nombres de las bases de datos y los nombres de las instancias en mayúsculaspara mantener la coherencia con la información de conexión que se muestra enel indicador.

v Si la variable de registro DB2_CLPPROMPT se cambia en la modalidad interactivadel CLP, el valor nuevo de DB2_CLPPROMPT no tendrá efecto hasta que se cierre yse vuelva a abrir la modalidad interactiva del CLP.

Se puede especificar el número de mandatos que se almacenarán en el historial demandatos mediante la variable de registro DB2_CLPHISTSIZE. El mandato HISTORY lepermite acceder al contenido del historial de mandatos que se ejecuta en unasesión de modalidad interactiva CLP.

También puede especificar el editor que se abre al emitir el mandato EDIT mediantela variable de registro DB2_CLP_EDITOR. Desde una sesión interactiva CLP, elmandato EDIT abre un editor cargado previamente con un mandato especificadopor el usuario que luego se puede editar y ejecutar.

Ejemplos

Si DB2_CLPPROMPT se define como (%ia@%i, %da@%d), el indicador de entrada tendrálos valores siguientes:v Ninguna conexión de instancia y ninguna conexión de base de datos.

DB2INSTANCE establecida en DB2. DB2DBDFT no establecida.(@DB2, @)

v (Windows) Ninguna conexión de instancia y ninguna conexión de base de datos.DB2INSTANCE y DB2DBDFT no están establecidas. DB2INSTDEF establecida en DB2.(@DB2, @)

v Ninguna conexión de instancia y ninguna conexión de base de datos.DB2INSTANCE establecida en DB2. DB2DBDFT establecida en "SAMPLE".(@DB2, @SAMPLE)

v Conexión de instancia a la instancia "DB2" con el ID de autorización "keon14".DB2INSTANCE establecida en DB2. DB2DBDFT establecida en "SAMPLE".(KEON14@DB2, @SAMPLE)


Capítulo 1. Procesador de línea de mandatos (CLP) 3

v Conexión de base de datos a la base de datos "sample" con el ID de autorización"horton7". DB2INSTANCE establecida en DB2. DB2DBDFT establecida en SAMPLE.(@DB2, HORTON7@SAMPLE)

v Conexión de instancia a la instancia "DB2" con el ID de autorización "keon14".Conexión de base de datos a la base de datos "sample" con el ID de autorización"horton7". DB2INSTANCE establecida en DB2. DB2DBDFT no establecida.(KEON14@DB2, HORTON7@SAMPLE)

Utilización del procesador de línea de mandatos en archivos demandatos

Las peticiones de CLP al gestor de bases de datos pueden incluirse en un archivode mandatos del script de shell. El ejemplo siguiente muestra cómo entrar lasentencia CREATE TABLE en un archivo de mandatos del script de shell:

db2 “create table mitabla (name VARCHAR(20), color CHAR(10))”

Para obtener más información sobre mandatos y archivos de mandatos, consulte elmanual del sistema operativo apropiado.

Diseño del procesador de línea de mandatos

El procesador de línea de mandatos consta de dos procesos: el proceso decomponente frontal (el mandato DB2), que actúa como interfaz de usuario, y elproceso de fondo (db2bp), que mantiene una conexión de base de datos.

Mantenimiento de conexiones a la base de datos

Cada vez que se invoca db2, se inicia un nuevo proceso de componente frontal. Elproceso de fondo lo inicia la primera invocación de db2 y puede terminarseexplícitamente con el mandato TERMINATE. Todos los procesos de componentefrontal con el mismo padre están atendidos por un solo proceso de fondo y, porconsiguiente, comparten una sola conexión a la base de datos.

Por ejemplo, las llamadas db2 siguientes desde el mismo indicador de mandatos desistema operativo producen procesos de componente frontal independientes quecomparten un único proceso de fondo, que mantiene una conexión a la base dedatos durante:v db2 ’connect to sample’,v db2 ’select * from org’,v . foo (donde foo es un script de shell que contiene mandatos DB2), yv db2 -tf myfile.clp

Las invocaciones siguientes desde el mismo indicador de sistema operativoproducen conexiones a la base de datos independientes porque cada una tiene unproceso padre diferenciado y, por consiguiente, un proceso de fondo diferenciado:v foov . foo &v foo &v sh foo

Comunicación entre los procesos de componente frontal y de fondo



El proceso de componente frontal y los procesos de fondo se comunican mediantetres colas de mensajes: una cola de peticiones, una cola de entrada y una cola desalida.

Variables de entorno

Las variables de entorno siguientes ofrecen un medio para configurar lacomunicación entre los dos procesos:

Tabla 2. Variables de entorno

Variable Mínimo Máximo Valor por omisión

DB2BQTIME 1 segundo 5294967295 1 segundo

DB2BQTRY 0 intentos 5294967295 60 intentos

DB2RQTIME 1 segundo 5294967295 5 segundos

DB2IQTIME 1 segundo 5294967295 5 segundos

DB2BQTIMECuando se invoca el procesador de línea de mandatos, el proceso decomponente frontal comprueba si el proceso de fondo ya está activo. Siestá activo, el proceso de componente frontal restablece la conexión con elmismo. Si no está activo, el proceso de componente frontal lo activa.Entonces el proceso de componente frontal queda desocupado durante elperiodo de tiempo especificado por la variable DB2BQTIME y realiza lacomprobación otra vez. El proceso de componente frontal continúarealizando la comprobación el número de veces especificado por la variableDB2BQTRY, después de lo cual, si el proceso de fondo aún no está activo,excede el tiempo de espera y devuelve un mensaje de error.

DB2BQTRYFunciona junto con la variable DB2BQTIME y especifica el número de vecesque el proceso de componente frontal intenta determinar si el proceso defondo está activo.

Los valores de DB2BQTIME y DB2BQTRY pueden aumentar durante periodospunta para optimizar el tiempo de consulta.

DB2RQTIMEEl proceso de fondo, una vez iniciado, espera en la cola de peticiones unapetición del componente frontal. También espera en la cola de peticionesdurante el tiempo que transcurre entre las peticiones iniciadas desde elindicador de mandatos.

La variable DB2RQTIME especifica el tiempo que espera el proceso de fondoa una petición del proceso de componente frontal. Al final de este tiempo,si no hay ninguna petición en la cola de peticiones, el proceso de fondocomprueba si aún existe el padre del proceso de componente frontal ytermina, si éste no existe. De lo contrario, continúa esperando en la cola depeticiones.

DB2IQTIMECuando el proceso de fondo recibe una petición del proceso decomponente frontal, envía un acuse de recibo al proceso de componentefrontal indicando que está preparado para recibir entrada a través de lacola de entrada. Entonces el proceso de fondo espera en su cola deentrada. También espera en la cola de entrada mientras se está ejecutandoun archivo de proceso por lotes (especificado con la opción -f) y mientrasel usuario está en modalidad interactiva.



La variable DB2IQTIME especifica el tiempo que el proceso de fondo esperaen la cola de entrada a que el proceso de componente frontal pase losmandatos. Cuando este tiempo ha transcurrido, el proceso de fondocomprueba si el proceso de componente frontal está activo y vuelve aesperar en la cola de peticiones si el proceso de componente frontal ya noexiste. De lo contrario, el proceso de fondo continúa esperando entrada delproceso de componente frontal.

Para ver los valores de estas variables de entorno, utilice LIST COMMAND OPTIONS.

Las variables de entorno del programa de fondo heredan los valores establecidospor el proceso de componente frontal en el momento en que se inicia el proceso defondo. Sin embargo, si se cambian las variables de entorno del componente frontal,el proceso de fondo no heredará estos cambios. El proceso de fondo debeterminarse primero y, a continuación, reiniciarse (emitiendo el mandato db2) paraheredar los valores modificados.

En el escenario siguiente se proporciona un ejemplo de cuándo debe terminarse elproceso de fondo:1. El usuario A se conecta, emite algunos mandatos de CLP y, a continuación, 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 aún está activo cuando el usuario Bempieza a utilizar el CLP, porque el padre del proceso de componente frontal delusuario B (la ventana de sistema operativo desde la que se emiten los mandatos)está aún activo. El proceso de fondo intenta atender los nuevos mandatos emitidospor el usuario B; sin embargo, el proceso de componente frontal del usuario B notiene suficiente autorización para utilizar las colas de mensajes del proceso defondo, porque necesita la autorización del usuario A, que ha creado dicho procesode fondo. Una sesión CLP debe terminar con un mandato TERMINATE antes que unusuario inicie una nueva sesión CLP utilizando la misma ventana de sistemaoperativo. Esto crea un proceso de fondo nuevo para cada usuario nuevo, evitandoproblemas de autorización y estableciendo los valores correctos de las variables deentorno (por ejemplo DB2INSTANCE) en el proceso de fondo del nuevo usuario.

Notas de uso del CLP

Los mandatos se pueden entrar tanto en mayúsculas como en minúsculas desde elindicador de mandatos. Sin embargo, los parámetros que son sensibles a lasmayúsculas y minúsculas en DB2 se deben entrar con las mayúsculas y minúsculasexactas deseadas. Por ejemplo, la serie-comentario de la cláusula WITH del mandatoCHANGE DATABASE COMMENT es un parámetro sensible a las mayúsculas y minúsculas.

Se permiten identificadores delimitados en las sentencias de SQL.

Se permiten caracteres especiales o metacaracteres (por ejemplo $ & * ( ) ; < > ? \ '") en los mandatos CLP. Si se utilizan fuera de la modalidad interactiva del CLP ola modalidad de entrada de proceso por lotes de CLP, el shell del sistemaoperativo interpreta dichos caracteres. Es necesario utilizar comillas o un carácterde escape si el shell no debe realizar ninguna acción 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 from org wheredivision". 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 varían de una plataforma a otra. En el shell Korn de AIX,el ejemplo anterior puede volverse a escribir utilizando un carácter de escape (\),por ejemplo \*, \> o \'.

La mayoría de los entornos de sistema operativo permiten redirigir la entrada y lasalida. Por ejemplo, si se ha realizado una conexión a la base de datos SAMPLE, lapetición siguiente consulta la tabla STAFF y envía la salida a un archivo llamadostaflist.txt del directorio misdatos:

db2 "select * from staff" > mydata/staflist.txt

Para entornos donde no está soportada la redirección de la salida, se puedenutilizar opciones de CLP. Por ejemplo, la petición puede escribirse como

db2 -rmydata\staflist.txt "select * from staff"

db2 -z mydata\staflist.txt "select * from staff"

El procesador de línea de mandatos no es un lenguaje de programación. Porejemplo, no soporta variables de sistema principal, y la sentencia

db2 connect to :HostVar in share mode

es sintácticamente incorrecta, porque :HostVar no es un nombre de base de datosválido.

El procesador de línea de mandatos representa los valores NULL de SQL comoguiones (-). Si la columna es numérica, el guión se coloca a la derecha de lacolumna. si la columna no es numérica, el guión está a la izquierda.

Para visualizar correctamente los caracteres nacionales para idiomas de un solobyte (SBCS) desde la ventana del procesador de línea de mandatos de DB2, se debeseleccionar un font True Type. Por ejemplo, en un entorno Windows, abra elcuaderno de propiedades de la ventana de mandatos y seleccione un font comopor ejemplo Lucinda Console.

El procesador de línea de mandatos no da soporte a caracteres de soporte deidiomas nacionales (NLS) en los nombres de vía de acceso a archivo. Esto afectaespecialmente a mandatos como por ejemplo IMPORT, EXPORT y REGISTER XMLSCHEMA,donde aparecen con mayor frecuencia nombres problemáticos de vía de acceso aarchivos.

Se da soporte a la conexión de la salida de un mandato del procesador de línea demandatos para otro mandato del procesador de línea de mandatos. Por ejemplo:db2 -x | db2 +p -tv. Este soporte tiene como única limitación eltamaño del almacenamiento intermedio de la conexión. Los tamaños de losalmacenamientos intermedios de las conexiones no pueden configurarse. Si elprimer mandato excede el tamaño de almacenamiento intermedio de la conexión,puede que el procesador de la línea de mandatos se cuelgue o genere un error alintentar grabar la salida en el almacenamiento intermedio de la conexión. Si elsegundo mandato no es un mandato del procesador de línea de mandatos, porejemplo, un mandato de shell de UNIX, el procesador no se colgará ni generará unerror debido a la limitación del tamaño del almacenamiento intermedio de la



conexión.



db2 - Invocación del procesador de línea de mandatos

El mandato db2 inicia el procesador de línea de mandatos (CLP). El CLP se utilizapara ejecutar programas de utilidad de base de datos, sentencias de SQL y ayudaen línea. 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 db2v Modalidad de proceso por lotes, que utiliza la opción de entrada de archivo -f.

En sistemas operativos Windows, db2cmd abre la ventana de DB2 habilitada paraCLP e inicializa el entorno de línea de mandatos de DB2. La emisión de estemandato equivale a pulsar el icono Ventana de mandatos de DB2.

QUIT detiene el procesador de línea de mandatos. TERMINATE también detiene elprocesador de línea de mandatos, pero elimina el proceso de fondo asociado ylibera la memoria que se esté utilizando. Es recomendable que se emitaTERMINATE antes de cada mandato STOP DATABASE MANAGER (db2stop).También podría ser necesario emitir TERMINATE después de haber cambiado losparámetros de configuración de base de datos para que estos cambios entren envigor. Antes de terminar el CLP se deberán restablecer las conexiones existentes.

El mandato de shell (!) permite que los mandatos del sistema operativo se ejecutenen la modalidad interactiva o por lotes en sistemas basados en UNIX y en sistemasoperativos Windows (por ejemplo, !ls en UNIX, y !dir en sistemas operativosWindows).

Sintaxis del mandato

�� db2

�

distintivo-opción mandato-db2sentencia-sql?

frasemensajesqlstatecódigo-clase

-- comentario

��

distintivo-opciónEspecifica un distintivo de opción de CLP.

mandato-db2Especifica un mandato DB2.

sentencia-sqlEspecifica una sentencia de SQL.

? Solicita ayuda general de CLP.

? frase Solicita el texto de ayuda asociado con un mandato o un temaespecificado. Si el gestor de bases de datos no puede encontrar lainformación solicitada, visualiza la pantalla de ayuda general.



? options solicita una descripción y los valores actuales de las opciones deCLP. ? help solicita información sobre la lectura de los diagramas desintaxis de la ayuda en línea.

? mensajeSolicita ayuda para un mensaje especificado por un SQLCODE válido (porejemplo ? sql10007n).

? sqlstateSolicita ayuda para un mensaje especificado por un mensaje SQLSTATEválido.

? código-claseSolicita ayuda para un mensaje especificado por un código-clase válido.

-- comentarioEl procesador de línea de mandatos trata como un comentario la entradaque empieza con los caracteres de comentario ---

En cada caso, un espacio en blanco debe separar el interrogante (?) del nombre devariable.



Opciones del procesador de línea de mandatos

Las opciones de mandatos de CLP pueden especificarse estableciendo la variablede entorno del procesador de línea de mandatos DB2OPTIONS (que debe estar enmayúsculas), o con distintivos de línea de mandatos.

Los usuarios pueden establecer opciones para una sesión entera utilizandoDB2OPTIONS.

Vea los valores actuales para los distintivos de opción y el valor de DB2OPTIONSutilizando LIST COMMAND OPTIONS. Cambie un valor de opción de la modalidad deentrada interactiva o un archivo de mandato utilizando UPDATE COMMAND OPTIONS.

El procesador de línea de mandatos establece opciones en el orden siguiente:1. Configura las opciones por omisión.2. Lee DB2OPTIONS para alterar temporalmente los valores por omisión.3. Lee la línea de mandatos para alterar temporalmente DB2OPTIONS.4. Acepta entrada de UPDATE COMMAND OPTIONS como una alteración temporal final

interactiva.

La Tabla 3 resume los distintivos de opciones de CLP. Estas opciones puedenespecificarse en cualquier secuencia y combinación. Para activar una opción, pongaun signo menos (-) delante de la letra de opción correspondiente. Para desactivaruna opción, ponga un signo menos delante de la letra de opción y otro signomenos después de dicha letra o ponga como prefijo de la letra de opción un signomás (+). Por ejemplo, -c activa la opción de confirmación automática y -c- o +c ladesactiva. Estas letras de opciones no son sensibles a las mayúsculas y minúsculas,es decir, -a y -A son equivalentes.

Tabla 3. Opciones de mandatos de CLP

Distintivo deopción Descripción Valor por omisión

-a Esta opción indica al procesador de línea de mandatos que visualice datosSQLCA.

OFF

-c Esta opción indica al procesador de línea de mandatos que confirmeautomáticamente las sentencias de SQL.

ON

-d Esta opción indica al procesador de línea de mandatos que recupere yvisualice las declaraciones XML de datos XML.

OFF

-e{c|s} Esta opción indica al procesador de línea de mandatos que visualiceSQLCODE o SQLSTATE. Estas opciones se excluyen mutuamente.

OFF

-fnombrearchivo Esta opción indica al procesador de línea de mandatos que lea entrada demandato de un archivo en lugar de hacerlo de la entrada estándar.

OFF

-i Esta opción indica al procesador de línea de mandatos la ‘impresión conestilo’ de los datos XML con el sangrado correcto. Esta opción solamenteafectará al conjunto de resultados de sentencias XQuery.

OFF

-l nombrearchivo Esta opción indica al procesador de línea de mandatos que anotecronológicamente los mandatos en un archivo histórico.

OFF

-m Esta opción indica al procesador de línea de mandatos que imprima elnúmero de filas afectadas para INSERT/DELETE/UPDATE/MERGE.

OFF

-n Elimina el carácter de línea nueva dentro de un solo símbolo delimitado. Sino se especifica esta opción, el carácter de línea nueva se sustituye por unespacio. Esta opción debe utilizarse con la opción -t.

OFF



Tabla 3. Opciones de mandatos de CLP (continuación)

Distintivo deopción Descripción Valor por omisión

-o Esta opción indica al procesador de línea de mandatos que visualice losdatos de salida y los mensajes en la salida estándar.

ON

-p Esta opción indica al procesador de línea de mandatos que visualice unindicador del procesador de línea de mandatos cuando se esté enmodalidad de entrada interactiva.

ON

-q Esta opción indica al procesador de línea de mandatos que conserve losespacios en blanco y los saltos de línea en las series delimitadas porcomillas o apóstrofos. Cuando la opción q es ON, se ignora la opción n.

OFF

-rnombrearchivo Esta opción indica al procesador de línea de mandatos que grabe elinforme generado por un mandato en un archivo.

OFF

-s Esta opción indica al procesador de línea de mandatos que detenga laejecución si se producen errores mientras se ejecutan mandatos en unarchivo de proceso por lotes o en modalidad interactiva.

OFF

-t Esta opción indica al procesador de línea de mandatos que utilice un puntoy coma (;) como carácter de terminación de sentencia.

OFF

-tdx o -tdxx Esta opción indica al procesador de línea de mandatos que defina y utilicex o xx como carácter o caracteres de terminación de sentencia (1 o 2caracteres de longitud).

OFF

-v Esta opción indica al procesador de línea de mandatos que repita en eco eltexto del mandato en la salida estándar.

OFF

-w Esta opción indica al procesador de línea de mandatos que visualicemensajes de aviso de FETCH/SELECT.

ON

-x Esta opción indica al procesador de línea de mandatos que devuelva datossin ninguna cabecera, incluidos los nombres de columna. Este distintivo noafectará a todos los mandatos. Es aplicable a sentencias de SQL y algunosmandatos basados en sentencias de SQL tales como LIST TABLES.

OFF

-znombrearchivo Esta opción indica al procesador de línea de mandatos que redirija toda lasalida a un archivo. Es similar a la opción -r, pero incluye los mensajes olos códigos de error con la salida.

OFF

Ejemplo

El mandato de AIX:export DB2OPTIONS=’+a -c +ec -o -p’

establece los valores por omisión siguientes para la sesión:Visualizar SQLCA - offConfirmar automáticamente - onVisualizar SQLCODE - offVisualizar salida - onVisualizar indicador - on

A continuación se proporciona una descripción detallada de estas opciones:

Opción de visualización de datos SQLCA (-a):Visualiza datos SQLCA en la salida estándar después de ejecutar unmandato DB2 o una sentencia de SQL. Se visualizan los datos SQLCA enlugar de un mensaje de error o de éxito.

El valor por omisión para esta opción de mandato es OFF (+a o -a-).



Las opciones -o y -r afectan a la opción -a; consulte las descripciones deopciones para obtener detalles.

Opción de confirmación automática (-c):Esta opción especifica si cada mandato o sentencia debe tratarse de formaindependiente. Si se establece en ON (-c), cada mandato o sentencia seconfirma o se retrotrae automáticamente. Si el mandato o la sentencia seejecuta satisfactoriamente, se comprometen dicho mandato o dichasentencia y todos los mandatos y las sentencias satisfactorios que se hanemitido antes que éstos con la confirmación automática desactivada OFF (+co -c-). Sin embargo, si el mandato o la sentencia falla, se retrotraen dichomandato o dicha sentencia y todos los mandatos y todas las sentencias quese han emitido antes que éstos con la confirmación automática desactivadaOFF. Si está establecida en OFF (+c o -c-), se debe emitir COMMIT o ROLLBACKde forma explícita o se producirán una de estas acciones cuando se emitael siguiente mandato con confirmación automática habilitada (ON)(-c).

El valor por omisión para esta opción de mandato es ON.

La opción de confirmación automática no afecta a ninguna otra opción delprocesador de línea de mandatos.

Ejemplo: Examine el escenario siguiente:1. db2 create database test

2. db2 connect to test

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 una columnadenominada C2 en la tabla A. Dado que dicha sentencia se ha emitido conla confirmación automática establecida en ON (valor por omisión), retrotraeno sólo la sentencia del paso 4, sino también la del paso 3, porque laúltima se ha emitido con la confirmación automática establecida en OFF. Elmandato:

db2 list tables

devuelve entonces una lista vacía.

Opción de declaración XML (-d):

La opción -d indica al procesador de línea de mandatos si debe recuperary visualizar las declaraciones XML de datos XML.

Si se establece en ON (-d), las declaraciones XML se recuperarán yvisualizarán. Si se establece en OFF (+d o -d-), las declaraciones XML no serecuperarán y visualizarán. El valor por omisión para esta opción demandato es OFF.

La opción de declaración XML no afecta a ninguna otra opción deprocesador de línea de mandatos.

Opción de visualización de SQLCODE/SQLSTATE (-e):La opción -e{c|s} indica al procesador de línea de mandatos que debemostrar el mensaje SQLCODE (-ec) o SQLSTATE (-es) en la salidaestándar. Las opciones -ec y -es no son válidas en modalidad interactivade CLP.

El valor por omisión para esta opción de mandato es OFF (+e o -e-).

Las opciones -o y -r afectan a la opción -e; consulte las descripciones deopciones para obtener detalles.



La opción de visualización de SQLCODE/SQLSTATE no afecta a ningunaotra opción del procesador de línea de mandatos.

Ejemplo: Para recuperar SQLCODE del procesador de línea de mandatosejecutando en AIX, entre:

sqlcode=`db2 -ec +o db2–command`

Opción de lectura del archivo de entrada (-f):La opción -f nombrearchivo indica al procesador de línea de mandatos quelea entrada de un archivo especificado, en lugar de hacerlo de la entradaestándar. Nombrearchivo es un nombre de archivo absoluto o relativo quepuede incluir la vía de acceso de directorio al archivo. Si no se especifica lavía de acceso de directorio, se utiliza el directorio actual.

Cuando se llama al CLP con una opción de entrada de archivo, seestablecerá automáticamente el registro especial CLIENT APPLNAME enCLP nombrearchivo.

Cuando se combinan otras opciones con la opción -f, la opción -f debeespecificarse en último lugar. Por ejemplo:

db2 -tvf nombrearchivo

Cuando ejecuta un archivo de script CLP utilizando el mandato db2 -tvfnombrearchivo, el registro especial CLIENT APPLNAME se establece en CLPnombrearchivo. El siguiente mandato que ejecuta, restaura los registrosespeciales CLIENT APPLNAME y CLIENT ACCTNG en el valor antiguoanterior a la invocación del mandato db2 -tvf nombrearchivo. Si el siguientemandato que ejecuta es db2 terminate o si la última sentencia denombrearchivo es terminate, no se restaurarán los registros especiales. Estoresulta útil para supervisar qué trabajo de proceso por lotes se estáejecutando actualmente y para diferenciar la carga de trabajo de CPL. Estaopción no se puede cambiar desde la modalidad interactiva.

El valor por omisión para esta opción de mandato es OFF (+f o -f-).

Los mandatos se procesan hasta que se emite el mandato QUIT o TERMINATEo se encuentra un código de fin de archivo.

Si se especifican esta opción y un mandato de base de datos, el procesadorde línea de mandatos no procesa ningún mandato y se devuelve unmensaje de error.

El procesador de línea de mandatos trata como comentarios las líneas delarchivo de entrada que empiezan con los caracteres de comentario --. Loscaracteres de comentario deben ser los primeros caracteres distintos deespacios en blanco de una línea.

Las líneas de los archivos de entrada que empiezan por (= se tratan comoel principio de un bloque de comentario. Las líneas que acaban por =)marcan el fin de un bloque de comentario. El bloque de líneas de entradaque empieza en (= y finaliza en =) se trata como un comentario continuopor parte del procesador de línea de mandatos. Están permitidos losespacios antes de (= y después de =). Pueden jerarquizarse loscomentarios, y pueden utilizarse jerarquizados en las sentencias. El carácterde terminación de mandato (;) no se puede utilizar después de =).

Si se especifica la opción -f nombrearchivo, se ignora la opción -p.

La opción de lectura del archivo de entrada no afecta a ninguna otraopción del procesador de línea de mandatos.



Tenga en cuenta que el carácter de terminación por omisión es uno de loscaracteres de línea nueva a menos que se especifique lo contrario con laopción -t o el fin del archivo.

Opción de impresión con estilo (-i):

La opción -i indica al procesador de línea de mandatos la ‘impresión conestilo’ de los datos XML con el sangrado correcto. Esta opción solamenteafectará al conjunto de resultados de sentencias XQuery.

El valor por omisión para esta opción de mandato es OFF (+i o -i-).

La opción de impresión con estilo no afecta a ninguna otra opción deprocesador de línea de mandatos.

Opción Anotar cronológicamente mandatos en archivo histórico (-l):La opción -l nombrearchivo indica al procesador de línea de mandatos queanote cronológicamente los mandatos en un archivo especificado. Estearchivo histórico contiene registros de los mandatos ejecutados y su estadode realización. Nombrearchivo es un nombre de archivo absoluto o relativoque puede incluir la vía de acceso de directorio al archivo. Si no seespecifica la vía de acceso de directorio, se utiliza el directorio actual. Si elarchivo especificado o el archivo por omisión ya existe, la nueva entradade anotación cronológica se añade a dicho archivo.

Cuando se combinan otras opciones con la opción -l, la opción -l debeespecificarse en último lugar. Por ejemplo:

db2 -tvl nombrearchivo

El valor por omisión para esta opción de mandato es OFF (+l o -l-).

La opción de anotación cronológica de mandatos en archivo histórico noafecta a ninguna otra opción del procesador de línea de mandatos.

Opción Visualizar el número de filas afectadas (-m):

La opción -m indica al procesador de línea de mandatos si debe imprimir ono el número de filas afectadas para INSERT, DELETE, UPDATE o MERGE.

Si se establece en ON (-m), se visualizará el número de filas afectadas parala sentencia de INSERT/DELETE/UPDATE/MERGE. Si se establece en OFF (+m o-m-), no se visualizará el número de filas afectadas. Para otras sentencias,se pasará por alto esta opción. El valor por omisión para esta opción demandato es OFF.

Las opciones -o y -r afectan a la opción -m; consulte las descripciones deopciones para obtener detalles.

Opción Eliminar carácter de línea nueva (-n):Elimina el carácter de línea nueva dentro de un solo símbolo delimitado. Sino se especifica esta opción, el carácter de línea nueva se sustituye por unespacio. Esta opción no se puede cambiar desde la modalidad interactiva.

El valor por omisión para esta opción de mandato es OFF (+n o -n-).

Esta opción debe utilizarse con la opción -t; consulte la descripción de lasopciones para obtener detalles.

Opción Visualizar salida (-o):La opción -o indica al procesador de línea de mandatos que envíe losdatos de salida y los mensajes a la salida estándar.




Esta opción no afecta a la información de arranque de modalidadinteractiva. Los datos de salida constan de la salida de informe de laejecución del mandato especificado por el usuario y de datos SQLCA (si sesolicitan).

La opción +o puede afectar a las opciones siguientes:v -r nombrearchivo: La información de arranque de modalidad interactiva

no se guarda.v -e: Se visualiza SQLCODE o SQLSTATE en la salida estándar incluso si

se especifica +o.v -a: Ningún efecto si se especifica +o. Si se especifican -a, +o y

-rnombrearchivo, la información SQLCA se graba en un archivo.

Si se especifican ambas opciones -o y -e, se visualizan en la pantalla losdatos y el SQLCODE o el SQLSTATE.

Si se especifican ambas opciones -o y -v, se visualizan los datos y el textode cada mandato emitido se repite en eco en la pantalla.

La opción de visualización de salida no afecta a ninguna otra opción delprocesador de línea de mandatos.

Opción Visualizar indicador interactivo de DB2 (-p):La opción -p indica al procesador de línea de mandatos que visualice elindicador del procesador de línea de mandatos cuando el usuario está enmodalidad interactiva.


La desactivación del indicador es útil cuando los mandatos se redirigen alprocesador de línea de mandatos. Por ejemplo, un archivo que contienemandatos de CLP podría ejecutarse emitiendo:

db2 +p < miarchivo.clp

La opción -p se ignora si se especifica la opción -f nombrearchivo.

La opción de visualización de indicador interactivo de DB2 no afecta aninguna otra opción del procesador de línea de mandatos.

Opción de conservación de espacios en blanco y saltos de línea (-q):

La opción -q indica al procesador de línea de mandatos que conserve losespacios en blanco y los saltos de línea en las series delimitadas porcomillas o apóstrofos.

El valor por omisión para esta opción de mandato es OFF (+q o -q-).

Si la opción -q es ON, se ignora la opción -n.

Opción Guardar en archivo de informe (-r):La opción -r nombrearchivo hace que los datos de salida generados por unmandato se graben en un archivo especificado y es útil para capturar uninforme que, de lo contrario, se desplazaría fuera de la pantalla. No segraban mensajes o códigos de error en el archivo. Nombrearchivo es unnombre de archivo absoluto o relativo que puede incluir la vía de accesode directorio al archivo. Si no se especifica la vía de acceso de directorio, seutiliza el directorio actual. Las entradas de informe nuevas se añaden alarchivo.

El valor por omisión para esta opción de mandato es OFF (+r o -r-).

Si se especifica la opción -a, los datos SQLCA se graban en el archivo.



La opción -r no afecta a la opción -e. Si se especifica la opción -e,SQLCODE o SQLSTATE se graba en la salida estándar, no en un archivo.

Si -r nombrearchivo se establece en DB2OPTIONS, el usuario puedeestablecer la opción +r (o -r-) desde la línea de mandatos para impedirque los datos de salida de una invocación de mandato determinada segraben en el archivo.

La opción de guardar en archivo de informe no afecta a ninguna otraopción del procesador de línea de mandatos.

Opción Detener ejecución en error de mandato (-s):Cuando se emiten mandatos en modalidad interactiva o desde un archivode entrada y se producen errores de sintaxis o de mandato, la opción -shace que el procesador de línea de mandatos detenga la ejecución y grabemensajes de error en la salida estándar.

El valor por omisión para esta opción de mandato es OFF (+s o -s-). Estevalor hace que el procesador de línea de mandatos visualice mensajes deerror, continúe la ejecución de los mandatos restantes y detenga laejecución sólo si se produce un error del sistema (código de retorno 8).

La tabla siguiente resume este comportamiento:

Tabla 4. Códigos de retorno de CLP y ejecución de mandato

Código de retorno Opción -s establecida Opción +s establecida

0 (satisfactorio) continúa la ejecución continúa la ejecución

1 (0 filas seleccionadas) continúa la ejecución continúa la ejecución

2 (aviso) continúa la ejecución continúa la ejecución

4 (error de DB2 o SQL) se detiene la ejecución continúa la ejecución

8 (Error del sistema) se detiene la ejecución se detiene la ejecución

Opciones de carácter de terminación de sentencia (-t y -tdx o -tdxx):La opción -t indica al procesador de línea de mandatos que utilice unpunto y coma (;) como carácter de terminación de sentencia e inhabilita elcarácter de continuación de línea de barra inclinada invertida (\). Estaopción no se puede cambiar desde la modalidad interactiva.

El valor por omisión para esta opción de mandato es OFF (+t o -t-).

Nota: Si utiliza el CLP para emitir sentencias de XQuery, es mejor elegirun carácter de terminación distinto del punto y coma. Esto asegura que lassentencias o las consultas que utilizan declaraciones de espacio de nombresno se interpreten incorrectamente, porque las declaraciones de espacio denombres también terminan con un punto y coma.

Para definir caracteres de terminación de 1 o 2 caracteres de longitud,utilice -td seguido del carácter o caracteres elegidos. Por ejemplo, -td%%establece %% como carácter de terminación de sentencia. Otra posibilidad esutilizar la directiva --#SET TERMINATOR en un archivo de entrada paraestablecer los caracteres de terminación de sentencia. Por ejemplo:db2 -td%% -f file1.txt

o biendb2 -f file2.txt

donde file2.txt contiene lo siguiente como primera sentencia del archivo:



--#SET TERMINATOR %%

El valor por omisión para esta opción de mandato es OFF.

El carácter o los caracteres de terminación no se pueden utilizar paraconcatenar varias sentencias desde la línea de mandatos, dado que lascomprobaciones de símbolo de terminación sólo se realizan en el últimocarácter o los dos últimos caracteres distintos de espacio en blanco de cadalínea de entrada.

Las opciones de carácter de terminación de sentencia no afectan a ningunaotra opción del procesador de línea de mandatos.

Opción Salida verbosa (-v):La opción -v hace que el procesador de línea de mandatos repita en eco(en la salida estándar) el texto de mandato entrado por el usuario antes devisualizar la salida así como los mensajes de dicho mandato. ECHO estáexento de esta opción.

El valor por omisión para esta opción de mandato es OFF (+v o -v-).

La opción -v no tiene ningún efecto si se especifica +o (o bien -o-).

La opción de salida verbosa no afecta a ninguna opción del procesador delínea de mandatos.

Opción Mostrar mensajes de aviso (-w):La opción -w indica al procesador de línea de mandatos si debe visualizaro no mensajes de aviso que puedan aparecer durante una consulta(FETCH/SELECT). Los avisos pueden aparecer durante varias fases de laejecución de la consulta, lo que puede dar como resultado que los mensajesse visualicen antes, durante o tras la devolución de los datos. Paraasegurar que los datos devueltos no contienen texto de mensaje de aviso,puede utilizarse este distintivo.


Opción Suprimir impresión de cabeceras de columna (-x):La opción -x indica al procesador de línea de mandatos que devuelvadatos sin ninguna cabecera, incluidos los nombres de columna. Estedistintivo no afectará a todos los mandatos. Es aplicable a sentencias deSQL y algunos mandatos basados en sentencias de SQL tales como LISTTABLES.

El valor por omisión para esta opción de mandato es OFF.

Opción Guardar toda la salida en archivo (-z):La opción -z nombrearchivo hace que toda la salida generada por unmandato se grabe en un archivo especificado y es útil para capturar uninforme que, de lo contrario, se desplazaría fuera de la pantalla. Es similara la opción -r; sin embargo, en este caso también se graban en el archivomensajes, códigos de error y más información de salida. Nombrearchivo esun nombre de archivo absoluto o relativo que puede incluir la vía deacceso de directorio al archivo. Si no se especifica la vía de acceso dedirectorio, se utiliza el directorio actual. Las entradas de informe nuevas seañaden al archivo.

El valor por omisión para esta opción de mandato es OFF (+z o -z-).

Si se especifica la opción -a, los datos SQLCA se graban en el archivo.

La opción -z no afecta a la opción -e. Si se especifica la opción -e,SQLCODE o SQLSTATE se graba en la salida estándar, no en un archivo.



Si -z nombrearchivo se establece en DB2OPTIONS, el usuario puedeestablecer la opción +z (o -z-) desde la línea de mandatos para impedirque los datos de salida de una invocación de mandato determinada segraben en el archivo.

La opción de guardar toda la salida en archivo no afecta a ninguna otraopción del procesador de línea de mandatos.



Códigos de retorno del procesador de línea de mandatos

Cuando el procesador de línea de mandatos termina de procesar un mandato ouna sentencia de SQL, devuelve un código de retorno (o de salida). Estos códigosson transparentes para los usuarios que ejecutan funciones CLP desde la línea demandatos, pero se pueden recuperar cuando dichas funciones se ejecutan desde unscript de shell.

Por ejemplo, el siguiente script del shell Bourne ejecuta el mandato GETDATABASE MANAGER CONFIGURATION y, a continuación, inspecciona elcódigo de retorno del CLP:

db2 get database manager configurationif [ "$?" = "0" ]then echo "OK!"fi

El código de retorno puede ser uno de los siguientes:

CódigoDescripción

0 El mandato DB2 o la sentencia de SQL se ha ejecutado satisfactoriamente

1 La sentencia SELECT o FETCH no ha devuelto filas

2 Aviso de mandato DB2 o de sentencia de SQL

4 Error de mandato DB2 o de sentencia de SQL

8 Error de sistema del Procesador de línea de mandatos

El procesador de línea de mandatos no proporciona ningún código de retornomientras un usuario está ejecutando sentencias desde la modalidad interactiva omientras se está leyendo entrada en un archivo (utilizando la opción -f).

Un código de retorno sólo queda disponible después de que el usuario haya salidode la modalidad interactiva o cuando ha finalizado el proceso de un archivo deentrada. En estos casos, el código de retorno es el OR lógico de los códigos deretorno diferenciados devueltos desde los mandatos o las sentencias individualesque se han ejecutado hasta ese momento.

Por ejemplo, si un usuario en modalidad interactiva emite mandatos que producencódigos de retorno de 0, 1 y 2, se devolverá un código de retorno de 3 después deque el usuario haya salido de la modalidad interactiva. No se devuelven loscódigos individuales 0, 1 y 2. El código de retorno 3 indica al usuario que duranteel proceso en modalidad interactiva, uno o más mandatos han devuelto un 1 y unoo más mandatos han devuelto un 2.

Un SQLCODE negativo devuelto por un mandato DB2 o una sentencia de SQLproduce un código de retorno de 4. Un código de retorno de 8 sólo se produce siel procesador de línea de mandatos encuentra un error del sistema.

Si se emiten mandatos desde un archivo de entrada o en modalidad interactiva yel procesador de línea de mandatos experimenta un error del sistema (código deretorno 8), se detiene inmediatamente la ejecución de mandatos. Si uno o másmandatos DB2 o sentencias de SQL terminan en error (código de retorno 4), laejecución de mandatos se detiene si se ha establecido la opción -s (Detenerejecución en error de mandato); de lo contrario, la ejecución continúa.

Códigos de retorno del procesador de línea de mandatos


Invocar ayuda de mandatos desde el procesador de línea de mandatosLa ayuda de mandatos explica la sintaxis de mandatos en el procesador de líneade mandatos.

Procedimiento

Para invocar la ayuda de mandatos, abra el procesador de línea de mandatos yespecifique:

? mandato

donde mandato representa una palabra clave o todo el mandato.Por ejemplo, ? catalog visualiza ayuda para todos los mandatos CATALOG,mientras que ? catalog database visualiza ayuda solamente para el mandatoCATALOG DATABASE.

Invocar ayuda de mensajes desde el procesador de línea de mandatosLa ayuda de mensajes describe la causa de un mensaje y describe cualquier acciónque deberá tomar como respuesta al error.

Procedimiento

Para invocar la ayuda de mensajes, abra el procesador de línea de mandatos yespecifique:

? XXXnnnnn

donde XXXnnnnn representa un identificador de mensaje válido.Por ejemplo, ? SQL30081 visualiza ayuda sobre el mensaje SQL30081.

Invocar ayuda de mandatos desde el procesador de línea de mandatos


Invocar ayuda de mensajes desde el procesador de línea de mandatos


Capítulo 2. Utilización de sentencias de SQL y XQuery delínea de mandatos

Esta sección proporciona información sobre la utilización de sentencias de Lenguajede Consulta Estructurada (SQL) desde la línea de mandatos. Estas sentenciaspueden ejecutarse directamente desde un indicador de mandatos de sistemaoperativo y se pueden utilizar para definir y manipular información almacenadaen una tabla, un índice o una vista de base de datos del mismo modo que si seescribieran los mandatos en un programa de aplicación. Se puede añadir, suprimiro actualizar información y se pueden generar informes a partir del contenido delas tablas.

Puede utilizar sentencias de SQL desde la línea de mandatos y puede utilizar unprocedimiento almacenado (SYSPROC.ADMIN_CMD()) para ejecutar algunosmandatos del CLP mediante SQL. Para obtener más información sobre cómoutilizar este procedimiento almacenado, consulte las rutinas administrativas deSQL.

Para emitir sentencias XQuery en CLP, anteponga como prefijo a las sentencias lapalabra clave XQUERY.

Nota: Si utiliza el CLP para emitir sentencias de XQuery, es mejor elegir uncarácter de terminación distinto del punto y coma (opción -t). Esto asegura que lassentencias o las consultas que utilizan declaraciones de espacio de nombres no seinterpreten incorrectamente, porque las declaraciones de espacio de nombrestambién terminan con un punto y coma.

Todas las sentencias de SQL que se pueden ejecutar mediante el procesador delínea de mandatos se listan en la columna CLP de la Tabla 5 en la página 27. Lasintaxis de todas las sentencias de SQL, tanto si se ejecutan desde la línea demandatos como si se incorporan en un programa fuente, se describen en lapublicación Consulta de SQL. La sintaxis de muchas sentencias de SQLincorporadas y sentencias de SQL CLP es idéntica. Sin embargo, las variables desistema principal, los marcadores de parámetro, los nombres de descriptor y losnombres de sentencia sólo son aplicables al SQL incorporado. La sintaxis de CALL,CLOSE, CONNECT, DECLARE CURSOR, FETCH y OPEN depende de si estassentencias estén incorporadas o se ejecuten mediante el CLP. A continuación seproporciona la sintaxis CLP de estas sentencias:

CALL

�� CALL procedure-name

�

( ),

expresión?null

��

CLOSE

�� CLOSE nombre-cursor ��

© Copyright IBM Corp. 1993, 2012 23

CONNECT

�� CONNECT �

�TO nombre-servidor

bloque-bloqueo autorizaciónRESET

(1)autorización

��

autorización:

USER nombre-autorización �

�USING contraseña

NEW contraseña CONFIRM contraseñaCHANGE PASSWORD

bloque-bloqueo:

IN SHARE MODE

IN EXCLUSIVE MODEON SINGLE NODE

Notas:

1 Este formato sólo es válido si se ha habilitado la conexión implícita.

DECLARE CURSOR

�� DECLARE nombre-cursor CURSORWITH HOLD

�

�DATABASE nombrebd

USER usuario USING contraseña

�

� FOR sentencia-selectXQUERY sentencia-xquery

��

FETCH

�� FETCH nombre-cursorFROM

�

Utilización de sentencias de SQL y XQuery de línea de mandatos


�FOR ALL ROW

n ROWSLOB COLUMN ALL INTO nombrearchivo APPEND

COLUMNS NEWOVERWRITE

��

OPEN

�� OPEN nombre-cursor ��

Nota:

1. Cuando se emite CALL:v Debe utilizarse una expresión para cada parámetro IN o INOUT del

procedimiento. Para un parámetro INOUT, la expresión debe ser un solovalor de literal. Los parámetros INOUT XML deben ser NULL (si se puedenanular) o estar en el siguiente formato: XMLPARSE(DOCUMENT serie).Observe que la serie del argumento para XMLPARSE debe ser un literal deserie y estar sujeto al registro especial CURRENT IMPLICIT XMLPARSEOPTION. No puede ser una expresión.

v Debe utilizarse un signo de cierre de interrogación (?) para cada parámetroOUT del procedimiento.

v El proceso almacenado debe estar catalogado. Si se llama a unprocedimiento no catalogado, se devuelve el mensaje de error SQL0440N.

El siguiente script de CLP crea un procedimiento denominado PROC4después de crear una tabla con una columna de XML C1. Utiliza tresparámetros XML: IN (PARM1), INOUT (PARM2) y OUT (PARM3) y devuelveun conjunto de resultados con datos XML.CREATE TABLE TAB4(C1 XML)CREATE PROCEDURE PROC4(IN PARM1 XML, INOUT PARM2 XML, OUT PARM3 XML)LANGUAGE SQLBEGIN

DECLARE STMT CLOB(1M) DEFAULT ’’;DECLARE C1 CURSOR WITH RETURN FOR S1;SET STMT = ’SELECT C1 FROM TAB4’;

/* INSERT PARM1 */INSERT INTO TAB4 VALUES(PARM1);

/* MANIPULATE PARM2 */

/* SET PARM3 AND INSERT */SET PARM3 = XMLPARSE(DOCUMENT ’333’);INSERT INTO TAB4 VALUES(PARM3);

/* RETURN A RESULT SET WITH XML DATA */PREPARE S1 FROM STMT;OPEN C1;

END

Para invocar el procedimiento PROC4 desde el procesador de línea demandatos, emita una sentencia CALL:CALL PROC4(XMLPARSE(DOCUMENT ’111’), XMLPARSE(DOCUMENT ’222’), ?)

2. La versión CLP de CONNECT permite al usuario cambiar la contraseña,utilizando los parámetros siguientes:

Utilización de sentencias de SQL y XQuery de línea de mandatos

Capítulo 2. Sentencias de SQL y XQuery de línea de mandatos 25

NEW contraseñaEspecifica la contraseña nueva que se debe asignar al nombre deusuario. Las contraseñas pueden tener hasta 18 caracteres de longitud.El sistema en el que se cambiará la contraseña depende del modo enque se haya configurado la autentificación de usuario.

CONFIRM contraseñaSerie que debe ser idéntica a la contraseña nueva. Este parámetro seutiliza para detectar errores de entrada.

CHANGE PASSWORDSi se especifica esta opción, se solicita al usuario la contraseña actual,una contraseña nueva y la confirmación de la contraseña nueva. Lascontraseñas no se visualizan al entrarse.

3. La cláusula DATABASE de la sentencia DECLARE CURSOR sólo es aplicable cuandoel cursor va a utilizarse para una carga posterior a la operación del cursor.

4. Para utilizar la sentencia DECLARE CURSOR con una sentencia XQuery, losusuarios deben preceder explícitamente la sentencia XQuery con la palabraclave XQUERY.

5. Cuando se emite FETCH mediante el procesador de línea de mandatos, sevisualizan números decimales y de coma flotante con el delimitador decimaldel territorio, es decir, un punto (.) en EE.UU., Canadá y el Reino Unido; unacoma (,) en la mayoría de los países y regiones restantes. Sin embargo, cuandose emiten sentencias INSERT, UPDATE, CALL y otras sentencias de SQLmediante el procesador de línea de mandatos para actualizar tablas, se deberáutilizar un punto como delimitador decimal, incluso en países y regiones queutilizan una coma para dicha finalidad.

6. Cuando se emite FETCH mediante el procesador de línea de mandatos, losvalores nu

db2 para linux,unix ywindowspublic.dhe.ibm.com/ps/products/db2/info/vr97/pdf/es_es/db2comm… ·...

Documents