db2commandref-db2n0z972

IBM DB2 9.7para Linux, UNIX y Windows

Consulta de mandatosActualizado en septiembre de 2010

Versin 9 Release 7

SC11-3914-02

NotaAntes de utilizar esta informacin y el producto al que da soporte, lea la informacin general contenida en el apartadoApndice D, Avisos, en la pgina 1247.

Nota de edicin

Este manual es la traduccin del original en ingls IBM DB2 9.7 for Linux, UNIX, and Windows Version 9 Release 7Command Reference Updated September, 2010 (SC27-2439-02).

Este documento contiene informacin propiedad de IBM. Se proporciona segn un acuerdo de licencia y estprotegido por la ley de la propiedad intelectual. La informacin contenida en esta publicacin no incluye ningunagaranta de producto, por lo que ninguna declaracin proporcionada en este manual deber interpretarse como tal.

Puede realizar pedidos de publicaciones de IBM en lnea o a travs del representante de IBM de su localidad.v Para realizar pedidos en lnea, 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 enva informacin a IBM, otorga a IBM un derecho no exclusivo a utilizar o distribuir dicha informacin enla forma en que IBM considere adecuada, sin contraer por ello ninguna obligacin con el remitente.

Copyright IBM Corporation 1993, 2010.

ContenidoAcerca de este manual . . . . . . . . ixQuin debe utilizar este manual . . . . . . . ixCmo est estructurado este manual . . . . . . ixConvenios de resaltado . . . . . . . . . . . x

Cmo leer los diagramas de sintaxis . . xi

Captulo 1. Procesador de lnea demandatos (CLP) . . . . . . . . . . . 1Funciones del procesador de lnea de mandatos . . 2db2 - Invocacin del procesador de lnea demandatos . . . . . . . . . . . . . . . 9Opciones del procesador de lnea de mandatos . . 11Cdigos de retorno del procesador de lnea demandatos . . . . . . . . . . . . . . . 20Invocar ayuda de mandatos desde el procesador delnea de mandatos . . . . . . . . . . . . 21Invocar ayuda de mensajes desde el procesador delnea de mandatos . . . . . . . . . . . . 21

Captulo 2. Utilizacin de sentencias deSQL y XQuery de lnea de mandatos . . 23

Captulo 3. Command Line ProcessorPlus (CLPPlus) . . . . . . . . . . . 31Instalacin de CLPPlus en clientes de servidor dedatos de IBM existentes . . . . . . . . . . 31Inicio de CLPPlus . . . . . . . . . . . . 32Mandato CLPPLUS . . . . . . . . . . . . 33Tipos de consola de CLPPlus . . . . . . . . 35Conexin con alias de DSN en CLPPlus . . . . . 36Conexin con alias de DSN mediante laautentificacin de Kerberos en CLPPlus . . . . . 37Ejecucin de un archivo script en CLPPlus . . . . 38Vinculacin de variables en CLPPlus . . . . . . 40Rastreos y anotacin cronolgica de registro deCLPPlus . . . . . . . . . . . . . . . 41Mandatos de DB2 soportados por CLPPlus . . . . 42Restricciones de CLPPlus . . . . . . . . . . 42Consejos y sugerencias para la resolucin deproblemas de CLPPlus . . . . . . . . . . 43

Captulo 4. Cmo leer la ayuda desintaxis de mandatos . . . . . . . . 45

Captulo 5. mandatos CLP . . . . . . 49ACTIVATE DATABASE . . . . . . . . . . 50ADD CONTACT . . . . . . . . . . . . 52ADD CONTACTGROUP . . . . . . . . . . 54ADD DBPARTITIONNUM . . . . . . . . . 55ADD XMLSCHEMA DOCUMENT . . . . . . 58ARCHIVE LOG . . . . . . . . . . . . . 60ATTACH . . . . . . . . . . . . . . . 63

AUTOCONFIGURE . . . . . . . . . . . 65BACKUP DATABASE . . . . . . . . . . . 68BIND . . . . . . . . . . . . . . . . 78CATALOG DATABASE . . . . . . . . . . 99CATALOG DCS DATABASE . . . . . . . . 103CATALOG LDAP DATABASE. . . . . . . . 105CATALOG LDAP NODE . . . . . . . . . 108CATALOG LOCAL NODE . . . . . . . . . 109CATALOG NAMED PIPE NODE . . . . . . . 111CATALOG ODBC DATA SOURCE . . . . . . 113CATALOG TCPIP/TCPIP4/TCPIP6 NODE . . . 115CHANGE DATABASE COMMENT . . . . . . 119CHANGE ISOLATION LEVEL . . . . . . . 121COMPLETE XMLSCHEMA . . . . . . . . 123CREATE DATABASE . . . . . . . . . . . 124CREATE TOOLS CATALOG . . . . . . . . 145DEACTIVATE DATABASE . . . . . . . . . 148DECOMPOSE XML DOCUMENT . . . . . . 150DECOMPOSE XML DOCUMENTS . . . . . . 152DEREGISTER . . . . . . . . . . . . . 156DESCRIBE . . . . . . . . . . . . . . 157DETACH . . . . . . . . . . . . . . . 167DROP CONTACT . . . . . . . . . . . . 168DROP CONTACTGROUP . . . . . . . . . 169DROP DATABASE . . . . . . . . . . . 170DROP DBPARTITIONNUM VERIFY. . . . . . 172DROP TOOLS CATALOG . . . . . . . . . 173ECHO. . . . . . . . . . . . . . . . 175EDIT . . . . . . . . . . . . . . . . 176EXPORT . . . . . . . . . . . . . . . 177FORCE APPLICATION . . . . . . . . . . 190GET ADMIN CONFIGURATION. . . . . . . 192GET ALERT CONFIGURATION . . . . . . . 194GET CLI CONFIGURATION . . . . . . . . 200GET CONNECTION STATE . . . . . . . . 202GET CONTACTGROUP . . . . . . . . . . 203GET CONTACTGROUPS . . . . . . . . . 204GET CONTACTS . . . . . . . . . . . . 205GET DATABASE CONFIGURATION . . . . . 206GET DATABASE MANAGER CONFIGURATION 213GET DATABASE MANAGER MONITORSWITCHES . . . . . . . . . . . . . . 219GET DESCRIPTION FOR HEALTH INDICATOR 222GET HEALTH NOTIFICATION CONTACT LIST 224GET HEALTH SNAPSHOT. . . . . . . . . 225GET INSTANCE . . . . . . . . . . . . 228GET MONITOR SWITCHES . . . . . . . . 229GET RECOMMENDATIONS FOR HEALTHINDICATOR. . . . . . . . . . . . . . 232GET ROUTINE . . . . . . . . . . . . . 236GET SNAPSHOT . . . . . . . . . . . . 238HELP . . . . . . . . . . . . . . . . 254HISTORY. . . . . . . . . . . . . . . 255IMPORT . . . . . . . . . . . . . . . 256INITIALIZE TAPE. . . . . . . . . . . . 287INSPECT . . . . . . . . . . . . . . . 288

Copyright IBM Corp. 1993, 2010 iii

LIST ACTIVE DATABASES. . . . . . . . . 296LIST APPLICATIONS . . . . . . . . . . 298LIST COMMAND OPTIONS . . . . . . . . 300LIST DATABASE DIRECTORY . . . . . . . 301LIST DATABASE PARTITION GROUPS . . . . 305LIST DBPARTITIONNUMS. . . . . . . . . 307LIST DCS APPLICATIONS . . . . . . . . . 308LIST DCS DIRECTORY . . . . . . . . . . 310LIST DRDA INDOUBT TRANSACTIONS . . . . 312LIST HISTORY . . . . . . . . . . . . . 314LIST INDOUBT TRANSACTIONS . . . . . . 319LIST NODE DIRECTORY . . . . . . . . . 322LIST ODBC DATA SOURCES . . . . . . . . 325LIST PACKAGES/TABLES . . . . . . . . . 326LIST TABLESPACE CONTAINERS . . . . . . 329LIST TABLESPACES . . . . . . . . . . . 331LIST UTILITIES . . . . . . . . . . . . 348LOAD. . . . . . . . . . . . . . . . 350LOAD QUERY . . . . . . . . . . . . . 397MIGRATE DATABASE . . . . . . . . . . 403PING . . . . . . . . . . . . . . . . 404PRECOMPILE . . . . . . . . . . . . . 406PRUNE HISTORY/LOGFILE . . . . . . . . 435PUT ROUTINE. . . . . . . . . . . . . 437QUERY CLIENT . . . . . . . . . . . . 439QUIESCE. . . . . . . . . . . . . . . 440QUIESCE TABLESPACES FOR TABLE . . . . . 444QUIT . . . . . . . . . . . . . . . . 447REBIND . . . . . . . . . . . . . . . 448RECOVER DATABASE . . . . . . . . . . 452REDISTRIBUTE DATABASE PARTITION GROUP 459REFRESH LDAP . . . . . . . . . . . . 471REGISTER . . . . . . . . . . . . . . 473REGISTER XMLSCHEMA . . . . . . . . . 476REGISTER XSROBJECT . . . . . . . . . . 478REORG INDEXES/TABLE . . . . . . . . . 480REORGCHK . . . . . . . . . . . . . 498RESET ADMIN CONFIGURATION . . . . . . 510RESET ALERT CONFIGURATION . . . . . . 512RESET DATABASE CONFIGURATION. . . . . 514RESET DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 516RESET MONITOR. . . . . . . . . . . . 518RESTART DATABASE . . . . . . . . . . 520RESTORE DATABASE . . . . . . . . . . 522REWIND TAPE . . . . . . . . . . . . 544ROLLFORWARD DATABASE . . . . . . . . 545RUNCMD . . . . . . . . . . . . . . 557RUNSTATS . . . . . . . . . . . . . . 558SET CLIENT . . . . . . . . . . . . . 574SET RUNTIME DEGREE . . . . . . . . . 577SET SERVEROUTPUT . . . . . . . . . . 579SET TABLESPACE CONTAINERS . . . . . . 581SET TAPE POSITION . . . . . . . . . . 584SET UTIL_IMPACT_PRIORITY . . . . . . . 585SET WORKLOAD . . . . . . . . . . . . 588SET WRITE . . . . . . . . . . . . . . 589START DATABASE MANAGER . . . . . . . 591START HADR . . . . . . . . . . . . . 600STOP DATABASE MANAGER . . . . . . . 603STOP HADR . . . . . . . . . . . . . 606

TAKEOVER HADR . . . . . . . . . . . 608TERMINATE . . . . . . . . . . . . . 612UNCATALOG DATABASE . . . . . . . . . 613UNCATALOG DCS DATABASE . . . . . . . 615UNCATALOG LDAP DATABASE . . . . . . 616UNCATALOG LDAP NODE . . . . . . . . 617UNCATALOG NODE . . . . . . . . . . 618UNCATALOG ODBC DATA SOURCE . . . . . 619UNQUIESCE . . . . . . . . . . . . . 620UPDATE ADMIN CONFIGURATION . . . . . 622UPDATE ALERT CONFIGURATION . . . . . 624UPDATE ALTERNATE SERVER FOR DATABASE 629UPDATE ALTERNATE SERVER FOR LDAPDATABASE . . . . . . . . . . . . . . 631UPDATE CLI CONFIGURATION . . . . . . 632UPDATE COMMAND OPTIONS. . . . . . . 634UPDATE CONTACT . . . . . . . . . . . 636UPDATE CONTACTGROUP . . . . . . . . 637UPDATE DATABASE CONFIGURATION . . . . 638UPDATE DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 642UPDATE HEALTH NOTIFICATION CONTACTLIST . . . . . . . . . . . . . . . . 644UPDATE HISTORY . . . . . . . . . . . 645UPDATE LDAP NODE . . . . . . . . . . 648UPDATE MONITOR SWITCHES . . . . . . . 650UPDATE XMLSCHEMA. . . . . . . . . . 652UPGRADE DATABASE . . . . . . . . . . 654

Captulo 6. Mandatos de CLPPlus . . 657Mandato . . . . . . . . . . . . . . . 658Mandato / . . . . . . . . . . . . . . 659Mandato @ . . . . . . . . . . . . . . 660Mandato @@ . . . . . . . . . . . . . 661Mandato ACCEPT. . . . . . . . . . . . 662Mandato APPEND . . . . . . . . . . . 664Mandato BREAK . . . . . . . . . . . . 665Mandato BTITLE . . . . . . . . . . . . 666Mandato CHANGE . . . . . . . . . . . 668Mandato CLEAR . . . . . . . . . . . . 670Mandato COLUMN . . . . . . . . . . . 672Mandato COMPUTE . . . . . . . . . . . 676Mandato CONNECT . . . . . . . . . . . 678Mandato COPY . . . . . . . . . . . . 680Mandato DEFINE . . . . . . . . . . . . 682Mandato DEL . . . . . . . . . . . . . 683Mandato DESCRIBE . . . . . . . . . . . 685Mandato DISCONNECT. . . . . . . . . . 686Mandato EDIT . . . . . . . . . . . . . 687Mandato EXECUTE . . . . . . . . . . . 688Mandato EXIT . . . . . . . . . . . . . 691Mandato GET . . . . . . . . . . . . . 692Mandato HELP. . . . . . . . . . . . . 693Mandato HOST . . . . . . . . . . . . 694Mandato INPUT . . . . . . . . . . . . 695Mandato LIST . . . . . . . . . . . . . 696Mandato PAUSE . . . . . . . . . . . . 697Mandato PRINT . . . . . . . . . . . . 698Mandato PROMPT . . . . . . . . . . . 699Mandato QUIT . . . . . . . . . . . . . 700Mandato REMARK . . . . . . . . . . . 701

iv Consulta de mandatos

Mandato REPFOOTER . . . . . . . . . . 702Mandato REPHEADER . . . . . . . . . . 704Mandato RUN . . . . . . . . . . . . . 706Mandato SAVE . . . . . . . . . . . . . 707Mandato SET . . . . . . . . . . . . . 708Mandato SPOOL . . . . . . . . . . . . 715Mandato SHOW . . . . . . . . . . . . 716Mandato START . . . . . . . . . . . . 717Mandato TTITLE . . . . . . . . . . . . 718Mandato UNDEFINE. . . . . . . . . . . 720

Captulo 7. Mandatos del sistema. . . 721dasauto - Iniciar automticamente el Servidor deadministracin de DB2 . . . . . . . . . . 722dascrt - Crear un Servidor de administracin deDB2 . . . . . . . . . . . . . . . . 723dasdrop - Eliminar un servidor de administracinde DB2 . . . . . . . . . . . . . . . 724dasmigr - Migrar el Servidor de administracin deDB2 . . . . . . . . . . . . . . . . 725dasupdt - Actualizar DAS . . . . . . . . . 727db2_deinstall - Desinstalar productos,caractersticas o idiomas de base de datos DB2 . . 729db2_install - Instalar el producto de base de datosDB2 . . . . . . . . . . . . . . . . 732db2_local_ps - Estado de procesos de DB2 paraLinux/UNIX . . . . . . . . . . . . . 735db2addicons - Crear entradas del men principalpara las herramientas de DB2 . . . . . . . . 737db2admin - Servidor de administracin de DB2 738db2adutl - Gestin de objetos DB2 en TSM . . . 740db2advis - Asesor de diseo de DB2. . . . . . 748db2audit - Herramienta de administrador delrecurso de comprobacin . . . . . . . . . 756db2batch - Herramienta de evaluacin . . . . . 766db2acsutil - Gestionar objetos de copia deseguridad selectiva de DB2 . . . . . . . . . 776db2bfd - Herramienta de descripcin de archivo devinculacin . . . . . . . . . . . . . . 780db2ca - Iniciar el Asistente de configuracin . . . 781db2caem - Herramienta de captura de datos desupervisor de sucesos de actividad . . . . . . 782db2cap - Herramienta de vinculacin de paquetesestticos CLI/ODBC . . . . . . . . . . . 786db2cat - Anlisis del catlogo del sistema . . . . 788db2cc - Iniciar el Centro de control . . . . . . 791db2cfexp - Herramienta de exportacin deconfiguracin de conectividad . . . . . . . . 793db2cfimp - Herramienta de importacin deconfiguracin de conectividad . . . . . . . . 795db2chglibpath - Modificar la va de acceso debsqueda de biblioteca en tiempo de ejecucinincorporada . . . . . . . . . . . . . . 796db2chgpath - Cambiar va de acceso de tiempo deejecucin incorporada . . . . . . . . . . 799db2ckbkp - Comprobar copia de seguridad . . . 801db2ckmig - Premigracin de la base de datos. . . 805db2ckrst - Comprobar secuencia de imgenes derestauracin incremental. . . . . . . . . . 806db2ckupgrade - Comprobar base de datos paraactualizacin . . . . . . . . . . . . . 808

db2cli - CLI interactiva de DB2 . . . . . . . 812db2cmd - Abrir ventana de mandatos de DB2 . . 815db2cptsa - Instalar o actualizar scripts HA de DB2 816db2dart - Herramienta de informes y anlisis debase de datos . . . . . . . . . . . . . 818db2daslevel - Mostrar nivel de DAS . . . . . . 823db2dclgn - Generador de declaraciones . . . . . 824db2diag - Herramienta de anlisis de anotacionescronolgicas db2diag . . . . . . . . . . . 827db2drdat - Rastreo DRDA . . . . . . . . . 844db2drvmp - Correlacin de unidades de base dedatos DB2 . . . . . . . . . . . . . . 846db2empfa - Habilitar asignacin de archivos demltiples pginas . . . . . . . . . . . . 848db2envar.bat - Establecer entorno de la ventana demandatos actual . . . . . . . . . . . . 849db2eva - Analizador de sucesos . . . . . . . 850db2evmon - Herramienta de productividad delsupervisor de sucesos . . . . . . . . . . 852db2evtbl - Generar definiciones de tabla de destinodel supervisor de sucesos . . . . . . . . . 854db2exfmt - Formato de la tabla de Explain . . . 856db2exmig - Migrar tablas de Explain . . . . . 859db2expln - Explicacin de SQL y XQuery . . . . 860db2extsec - Establecer permisos para objetos DB2 869db2flsn - Buscar nmero de secuencia deanotaciones cronolgicas . . . . . . . . . 871db2fm - Supervisor de anomalas de DB2 . . . . 873db2fmcu - Controlador de supervisor de anomalasde DB2 . . . . . . . . . . . . . . . 875db2fodc - Recopilacin de datos de primeraaparicin de DB2 . . . . . . . . . . . . 877db2fopt - Especificar parmetros para utilizarloscon el optimizador de consultas . . . . . . . 883db2fs - Primeros pasos . . . . . . . . . . 886db2gcf - Controlar instancia de DB2 . . . . . . 887db2gov - DB2 Governor . . . . . . . . . . 890db2govlg - Consulta de anotacin cronolgica deDB2 Governor . . . . . . . . . . . . . 892db2gpmap - Obtener correlacin de distribucin 893db2has - Recopilador de datos del servicio deasesor de salud de DB2 . . . . . . . . . . 895

Archivo de recursos db2has de ejemplo(db2has.res) . . . . . . . . . . . . . 902

db2hc - Iniciar el Centro de salud . . . . . . 904db2iauto - Iniciar instancia automticamente . . . 905db2iclus - Servidor de clsteres de Microsoft . . . 906db2icrt - Crear instancia . . . . . . . . . . 909db2idrop - Eliminar instancia . . . . . . . . 914db2IdentifyType1 - Herramienta de identificacinde ndices de tipo 1 . . . . . . . . . . . 917db2ilist - Listar instancias . . . . . . . . . 920db2imigr - Migrar instancia . . . . . . . . 921db2inidb - Inicializar una base de datos duplicada 923db2inspf - Formatear resultados de inspeccin . . 925db2iprune - Reducir el tamao de la imagen deinstalacin . . . . . . . . . . . . . . 926db2isetup - Iniciar interfaz de creacin deinstancias. . . . . . . . . . . . . . . 928db2iupdt - Actualizar instancias . . . . . . . 930db2iupgrade - Actualizar instancia . . . . . . 934

Contenido v

db2jdbcbind - Programa de utilidad vinculador depaquetes de JDBC de DB2 . . . . . . . . . 938db2ldcfg - Configurar entorno de LDAP . . . . 940db2level - Mostrar nivel de servicio de DB2 . . . 941db2licm - Herramienta de gestin de licencias . . 942db2listvolumes - Visualizar los GUID para todoslos volmenes de disco . . . . . . . . . . 945db2logsforrfwd - Listar anotaciones cronolgicasnecesarias para recuperacin en avance. . . . . 946db2look - Herramienta de extraccin de DDL y deestadsticas de DB2 . . . . . . . . . . . 947db2ls - Listar productos y caractersticas de DB2 958db2move - Herramienta de movimiento de base dedatos . . . . . . . . . . . . . . . . 961db2mqlsn - MQ Listener. . . . . . . . . . 971db2mscs - Configurar programa de utilidadFailover de Windows . . . . . . . . . . . 975db2mtrk - Rastreador de memoria . . . . . . 979db2nchg - Cambiar configuracin de servidor departiciones de base de datos . . . . . . . . 984db2ncrt - Aadir servidor de particiones de base dedatos a una instancia . . . . . . . . . . . 986db2ndrop - Descartar servidor de particiones debase de datos de una instancia . . . . . . . 988db2nrcfg - Herramienta de configuracin deinstalacin no root. . . . . . . . . . . . 989db2rfe - Habilitar caractersticas root parainstalacin no root. . . . . . . . . . . . 990db2nrupdt - Actualizacin de instancia deinstalacin no root. . . . . . . . . . . . 992db2nrupgrade - Actualizar una instancia no root 993db2osconf - Programa de utilidad para los valoresde parmetro de kernel . . . . . . . . . . 994db2pd - Supervisar y resolver problemas de basede datos DB2 . . . . . . . . . . . . . 997db2pdcfg - Configurar la base de datos DB2 decara al comportamiento de la determinacin deproblemas . . . . . . . . . . . . . . 1075db2perfc - Restablecer valores de rendimiento debase de datos . . . . . . . . . . . . . 1081db2perfi - Programa de utilidad de registro decontadores de rendimiento . . . . . . . . 1083db2perfr - Herramienta de registro de supervisorde rendimiento . . . . . . . . . . . . 1084db2rbind - Volver a vincular todos los paquetes 1085db2relocatedb - Reubicar base de datos . . . . 1087db2rfpen - Restablecer estado pendiente deavance . . . . . . . . . . . . . . . 1093db2rmicons - Eliminar las herramientas de DB2del men principal . . . . . . . . . . . 1094db2rspgn - Generador de archivos de respuestas 1095db2sampl - Crear base de datos de ejemplo . . . 1096db2schex - Ampliacin de esquema de ActiveDirectory . . . . . . . . . . . . . . 1099db2set - Registro de perfiles de DB2 . . . . . 1101db2setup - Instalar DB2 . . . . . . . . . 1104db2sqljbind - Vinculador de perfiles de SQLJ . . 1106db2sqljcustomize - Personalizador de perfiles deSQLJ . . . . . . . . . . . . . . . . 1112db2sqljprint - Impresora de perfiles de SQLJ. . . 1125db2start - Iniciar DB2 . . . . . . . . . . 1126

db2stat - Estado de procesos de DB2 paraWindows . . . . . . . . . . . . . . 1127db2stop - Detener DB2 . . . . . . . . . . 1128db2support - Herramienta de anlisis deproblemas y recoleccin del entorno . . . . . 1129db2swtch - Conmutar copia de DB2 por omisin ycopia de interfaz de cliente de base de datos . . 1140db2sync - Iniciar el sincronizador de DB2 . . . 1142db2systray - Iniciar la bandeja del sistema DB2 1143db2tapemgr - Gestionar archivos de anotacionescronolgicas en cinta . . . . . . . . . . 1145db2tbst - Obtener estado de espacio de tablas 1148db2tdbmgr - Migrar base de datos de catlogo deherramientas . . . . . . . . . . . . . 1149db2top - Herramienta de supervisin de DB2 . . 1150db2trc - Rastrear . . . . . . . . . . . . 1155db2unins - Desinstalar productos, caractersticas oidiomas de base de datos DB2 . . . . . . . 1167db2untag - Liberar identificador de contenedor 1169Mandato db2updv97 - Actualizar la base de datosal fixpack de la Versin 9.7 . . . . . . . . 1170db2updserv - Mostrar actualizaciones delproducto . . . . . . . . . . . . . . 1172db2val - Herramienta de validacin de copia deDB2 . . . . . . . . . . . . . . . . 1173db2xdbmig - Migrar objetos XSR . . . . . . 1175db2xprt - Formatear archivo de deteccin deexcepcin . . . . . . . . . . . . . . 1176disable_MQFunctions - Inhabilitar funciones deWebSphere MQ . . . . . . . . . . . . 1177doce_deinstall - Desinstalar el Centro deinformacin de DB2 . . . . . . . . . . . 1178doce_install - Instalar el Centro de informacin deDB2 . . . . . . . . . . . . . . . . 1180enable_MQFunctions - Habilitar funciones deWebSphere MQ . . . . . . . . . . . . 1182Mandato installDSDriver - Extraer componentesde Data Server Driver . . . . . . . . . . 1185installFixPack - Actualizar productos de base dedatos DB2 instalados . . . . . . . . . . 1186setup - Instalar DB2 . . . . . . . . . . . 1190sqlj - Traductor de SQLJ . . . . . . . . . 1192

Captulo 8. Mandatos de DB2 TextSearch . . . . . . . . . . . . . . 1197db2ts ALTER INDEX . . . . . . . . . . 1198db2ts CLEANUP FOR TEXT . . . . . . . . 1203db2ts CLEAR COMMAND LOCKS. . . . . . 1204db2ts CLEAR EVENTS FOR INDEX . . . . . 1206db2ts CREATE INDEX . . . . . . . . . . 1208db2ts DISABLE DATABASE FOR TEXT . . . . 1215db2ts DROP INDEX . . . . . . . . . . . 1218db2ts ENABLE DATABASE FOR TEXT . . . . 1220db2ts HELP . . . . . . . . . . . . . 1222db2ts START FOR TEXT . . . . . . . . . 1224db2ts STOP FOR TEXT . . . . . . . . . . 1225db2ts UPDATE INDEX . . . . . . . . . . 1226

Apndice A. Convenios dedenominacin . . . . . . . . . . 1229

vi Consulta de mandatos

Convenios de denominacin . . . . . . . . 1230

Apndice B. Modificadores ydelimitadores de tipo de archivo . . 1231Modificadores de tipo de archivo para losprogramas de utilidad de exportacin,importacin y carga . . . . . . . . . . . 1232Consideraciones sobre los delimitadores paramover datos . . . . . . . . . . . . . 1233

Apndice C. Visin general de lainformacin tcnica de DB2 . . . . 1235Biblioteca tcnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 1236Pedido de manuales de DB2 en copia impresa 1238Visualizacin de la ayuda para estados de SQLdesde el procesador de lnea de mandatos . . . 1239

Acceso a diferentes versiones del Centro deinformacin de DB2 . . . . . . . . . . . 1240Visualizacin de temas en su idioma preferido enel Centro de informacin de DB2 . . . . . . 1240Actualizacin del Centro de informacin de DB2instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1241Actualizacin manual del Centro de informacinde DB2 instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1242Guas de aprendizaje de DB2 . . . . . . . . 1244Informacin de resolucin de problemas de DB2 1244Trminos y condiciones . . . . . . . . . 1245

Apndice D. Avisos . . . . . . . . 1247

ndice . . . . . . . . . . . . . . 1251

Contenido vii

viii Consulta de mandatos

Acerca de este manualEste manual proporciona informacin acerca del uso de mandatos del sistema y delprocesador de la lnea de mandatos (CLP) IBM DB2 para ejecutar funcionesadministrativas de bases de datos.

Quin debe utilizar este manualSe supone que el lector tiene conocimientos de administracin de bases de datos yconoce el Lenguaje de Consulta Estructurada (SQL).

Cmo est estructurado este manualEste manual proporciona la informacin de consulta necesaria para utilizar losmandatos de CLP, del sistema y de DB2 Text Search.

Las principales reas temticas tratadas en los captulos de este manual son lassiguientes:

Utilizacin del procesador de lnea de mandatos (CLP)

v El captulo 1, Procesador de la lnea de mandatos (CLP), explica cmoinvocar y utilizar el procesador de lnea de mandatos y describe lasopciones del CLP.

v El captulo 2, Utilizacin de las sentencias de SQL y SQuery de la lneade mandatos proporciona informacin sobre cmo utilizar lassentencias de SQL desde la lnea de mandatos.

Uso de Command Line Processor Plus (CLPPlus)

v En el captulo 3, Command Line Processor Plus (CLPPlus), se describecmo instalar, invocar y utilizar la interfaz de Command Line ProcessorPlus.

Ayuda para el uso de mandatos

v En el captulo 4, Cmo leer la ayuda de sintaxis de mandatos, sedescribe cmo invocar las pantallas de ayuda de los mandatos y explicalas convenciones sintcticas de la pantalla de ayuda que se utilizan.

mandatos CLP

v En el captulo 5, Mandatos CLP, se describen todos los mandatos delgestor de bases de datos en orden alfabtico.

Mandatos de CLPPlus

v En el captulo 6, Mandatos de CLPPlus, se listan alfabticamente y sedescriben todos los mandatos que se pueden utilizar en la interfaz deCLPPlus.

Mandatos del sistema

v En el captulo 7, Mandatos del sistema, se describen todos losmandatos, en orden alfabtico, 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, 2010 ix

v En el captulo 8, Mandatos de DB2 Text Search, se describen todos losmandatos de Text Search, en orden alfabtico, que pueden especificarseen un indicador de mandatos del sistema operativo con el prefijo db2ts.

Apndices

v El Apndice A, Convenios de denominacin describe los conveniosutilizados para denominar los objetos como, por ejemplo, las bases dedatos y las tablas.

v El Apndice B, Modificadores y delimitadores de tipo de archivodescribe los modificadores de tipo de archivo para los programas deutilidad de carga, importacin y exportacin. Adems, tambin 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 maysculas son mandatosdel CLP, mientras que los mandatos escritos en minsculas son mandatosdel sistema.

Cursiva Indica uno de los siguientes:

v Nombres o valores (variables) que el usuario debe proporcionarv nfasis generalv La introduccin de un trmino nuevov Una referencia a otra fuente de informacin

Monoespaciado Indica uno de los siguientes:

v Archivos y directoriosv Informacin que se indica al usuario que escriba en un indicador demandatos o en una ventana

v Ejemplos de valores de datos concretosv Ejemplos de texto similar a lo que puede mostrar el sistemav Ejemplos de mensajes de textov Ejemplos de cdigo de programacin

Cmo est estructurado este manual

x Consulta de mandatos

Cmo leer los diagramas de sintaxisLa 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 va de acceso de la lnea.

El smbolo ??--- indica el principio de un diagrama de sintaxis.

El smbolo ---? indica que la sintaxis contina en la lnea siguiente.

El smbolo ?--- indica que la sintaxis contina de la lnea anterior.

El smbolo --?? indica el final de un diagrama de sintaxis.

Los fragmentos de sintaxis empiezan con el smbolo +--- y finalizan con el smbolo---.

Los elementos necesarios aparecen en la lnea horizontal (en la va de accesoprincipal).

elemento_necesario

Los elementos opcionales aparecen bajo la va de acceso principal.

elemento_necesarioelemento_opcional

Si un elemento opcional aparece sobre la va de acceso principal, ese elemento notiene ningn efecto en la ejecucin y slo se utiliza para posibilitar la lectura.

elemento_necesarioelemento_opcional

Si puede elegir entre dos o ms elementos, stos aparecen en una pila.

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

elemento_necesario opcin_necesaria1opcin_necesaria2

Si la eleccin de uno de los elementos es opcional, la pila entera aparece bajo la vade acceso principal.

elemento_necesarioopcin_opcional1opcin_opcional2

Copyright IBM Corp. 1993, 2010 xi

Si uno de los elementos es el valor por omisin, aparecer sobre la va de accesoprincipal y las opciones restantes se mostrarn debajo.

elemento_necesarioopcin_por_omisin

opcin_opcionalopcin_opcional

Una flecha que vuelve a la izquierda, sobre la lnea principal, indica un elementoque se puede repetir. En este caso, los elementos repetidos se deben separarmediante uno o ms espacios en blanco.

elemento_necesario elemento_repetible

Si la flecha de repeticin contiene una coma, debe separar los elementos repetidoscon una coma.

elemento_necesario

,

elemento_repetible

Una flecha de repeticin sobre una pila indica que puede realizar ms una eleccinen los elementos apilados o repetir una sola eleccin.

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

Si se muestran signos de puntuacin, parntesis, operadores aritmticos u otrossmbolos 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-parmetros representa elfragmento de sintaxis completo que est etiquetado bloque-parmetros:

elemento_necesario bloque-parmetros

bloque-parmetros:

parmetro1parmetro2 parmetro3

parmetro4

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

elemento_necesario elemento1 ? elemento2 ? elemento3 ? elemento4

Cmo leer los diagramas de sintaxis

xii Consulta de mandatos

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

elemento_necesario elemento1 elemento2 elemento3 elemento4elemento_necesario elemento1 elemento3 elemento2 elemento4


Cmo leer los diagramas de sintaxis xiii


xiv Consulta de mandatos

Captulo 1. Procesador de lnea de mandatos (CLP)

Copyright IBM Corp. 1993, 2010 1

Funciones del procesador de lnea de mandatosEl procesador de lnea de mandatos opera del modo siguiente:v El mandato de CLP (en cualquiera de los casos) se escribe en el indicador demandatos.

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.v A continuacin de la ejecucin del mandato, el control vuelve al indicador demandatos del sistema operativo y el usuario puede entrar ms mandatos.

v Cuando se llama al CLP con una opcin de entrada de archivo, se establecerautomticamente el registro especial CLIENT APPLNAME en CLPnombrearchivo.

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

Procesador de lnea de mandatos.

Determinados mandatos de CLP y sentencias de SQL requieren que la instancia deservidor se est ejecutando y que exista una conexin de base de datos. Conctesea una base de datos realizando una de las siguientes acciones:v Emita la sentencia de SQL:

db2 connect to basedatos

v Establezca una conexin implcita a la base de datos por omisin definida por lavariable de registro DB2DBDFT de DB2.

Si un mandato excede el lmite de caracteres permitido en el indicador demandatos, se puede utilizar una barra inclinada invertida (\) como carcter decontinuacin de lnea. Cuando el procesador de lnea de mandatos encuentra elcarcter de continuacin de lnea, lee la lnea siguiente y concatena los caracterescontenidos en ambas lneas. Como alternativa, puede utilizarse la opcin -t paraestablecer un carcter de terminacin de lnea distinto.

El procesador de lnea de mandatos reconoce una serie llamada NULL como unaserie nula. Los campos que se han establecido anteriormente a algn valor puedenestablecerse 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 lasmaysculas y minsculas. Un null en minsculas no se interpreta como una serienula, sino como una serie que contiene las letras null.

Personalizacin del procesador de lnea de mandatos

Es posible personalizar el indicador de entrada interactivo utilizando la variable deregistro DB2_CLPPROMPT. Esta variable de registro se puede establecer encualquier serie de una longitud mxima de 100 y puede contener los smbolos %i,%ia, %d, %da y %n. Estos smbolos se sustituirn por valores especficos durante laejecucin.

Funciones del procesador de lnea de mandatos

2 Consulta de mandatos

Tabla 1. Smbolos y valores durante la ejecucin de DB2_CLPPROMPTSmbolo DB2_CLPPROMPT Valor durante la ejecucin

%ia ID de autorizacin de la conexin de la instancia actual.

%i Alias local de la instancia conectada en la actualidad. Si noexiste ninguna conexin de instancia, ser el valor de lavariable de registro DB2INSTANCE. Slo en plataformasWindows, si la variable de registro DB2INSTANCE noest establecida, ser el valor de la variable de registroDB2INSTDEF.

%da ID de autorizacin de la conexin de base de datos actual.

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

%n Lnea nueva

v Si hay algn smbolo que no tenga asociado un valor durante el tiempo deejecucin, la serie vaca se sustituir por dicho smbolo.

v El indicador de entrada interactivo siempre presentar los ID de autorizacin,los nombres de las bases de datos y los nombres de las instancias en maysculaspara mantener la coherencia con la informacin de conexin que se muestra enel indicador.

v Si la variable de registro DB2_CLPPROMPT se cambia en la modalidadinteractiva del CLP, el valor nuevo de DB2_CLPPROMPT no tendr efecto hastaque se cierre y se vuelva a abrir la modalidad interactiva del CLP.

Se puede especificar el nmero de mandatos que se almacenarn en el historial demandatos mediante la variable de registro DB2_CLPHISTSIZE. El mandatoHISTORY le permite acceder al contenido del historial de mandatos que se ejecutaen una sesin de modalidad interactiva CLP.

Tambin puede especificar el editor que se abre al emitir el mandato EDITmediante la variable de registro DB2_CLP_EDITOR. Desde una sesin interactivaCLP, el mandato EDIT abre un editor cargado previamente con un mandatoespecificado por el usuario que luego se puede editar y ejecutar.

EjemplosSi DB2_CLPPROMPT se define como (%ia@%i, %da@%d), el indicador de entradatendr los valores siguientes:v Ninguna conexin de instancia y ninguna conexin de base de datos.DB2INSTANCE establecida en DB2. DB2DBDFT no establecida.(@DB2, @)

v (Windows) Ninguna conexin de instancia y ninguna conexin de base de datos.DB2INSTANCE y DB2DBDFT no estn establecidas. DB2INSTDEF establecidaen DB2.(@DB2, @)

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

v Conexin de instancia a la instancia "DB2" con el ID de autorizacin "keon14".DB2INSTANCE establecida en DB2. DB2DBDFT establecida en "SAMPLE".(KEON14@DB2, @SAMPLE)


Captulo 1. Procesador de lnea de mandatos (CLP) 3

v Conexin de base de datos a la base de datos "sample" con el ID de autorizacin"horton7". DB2INSTANCE establecida en DB2. DB2DBDFT establecida enSAMPLE.(@DB2, HORTON7@SAMPLE)

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

Utilizacin del procesador de lnea 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 cmo 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 ms informacin sobre mandatos y archivos de mandatos, consulte elmanual del sistema operativo apropiado.

Diseo del procesador de lnea de mandatos

El procesador de lnea de mandatos consta de dos procesos: el proceso decomponente frontal (el mandato DB2), que acta como interfaz de usuario, y elproceso de fondo (db2bp), que mantiene una conexin 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 invocacin de db2 y puede terminarseexplcitamente con el mandato TERMINATE. Todos los procesos de componentefrontal con el mismo padre estn atendidos por un solo proceso de fondo y, porconsiguiente, comparten una sola conexin a la base de datos.

Por ejemplo, las llamadas db2 siguientes desde el mismo indicador de mandatosde sistema operativo producen procesos de componente frontal independientes quecomparten un nico proceso de fondo, que mantiene una conexin 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

Comunicacin 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 lacomunicacin entre los dos procesos:

Tabla 2. Variables de entornoVariable Mnimo Mximo Valor por omisin

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 lnea de mandatos, el proceso decomponente frontal comprueba si el proceso de fondo ya est activo. Siest activo, el proceso de componente frontal restablece la conexin 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 lacomprobacin otra vez. El proceso de componente frontal continarealizando la comprobacin el nmero de veces especificado por la variableDB2BQTRY, despus de lo cual, si el proceso de fondo an no est activo,excede el tiempo de espera y devuelve un mensaje de error.

DB2BQTRYFunciona junto con la variable DB2BQTIME y especifica el nmero deveces que el proceso de componente frontal intenta determinar si elproceso de fondo est activo.

Los valores de DB2BQTIME y DB2BQTRY pueden aumentar duranteperiodos punta para optimizar el tiempo de consulta.

DB2RQTIMEEl proceso de fondo, una vez iniciado, espera en la cola de peticiones unapeticin del componente frontal. Tambin 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 defondo a una peticin del proceso de componente frontal. Al final de estetiempo, si no hay ninguna peticin en la cola de peticiones, el proceso defondo comprueba si an existe el padre del proceso de componente frontaly termina, si ste no existe. De lo contrario, contina esperando en la colade peticiones.

DB2IQTIMECuando el proceso de fondo recibe una peticin del proceso decomponente frontal, enva un acuse de recibo al proceso de componentefrontal indicando que est preparado para recibir entrada a travs de lacola de entrada. Entonces el proceso de fondo espera en su cola deentrada. Tambin espera en la cola de entrada mientras se est ejecutandoun archivo de proceso por lotes (especificado con la opcin -f) y mientrasel usuario est en modalidad interactiva.



La variable DB2IQTIME especifica el tiempo que el proceso de fondoespera en la cola de entrada a que el proceso de componente frontal paselos mandatos. 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 contina esperando entrada delproceso de componente frontal.

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

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 continuacin, reiniciarse (emitiendo el mandato db2) paraheredar los valores modificados.

En el escenario siguiente se proporciona un ejemplo de cundo debe terminarse elproceso 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 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 an 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 autorizacin para utilizar las colas de mensajes del proceso defondo, porque necesita la autorizacin del usuario A, que ha creado dicho procesode fondo. Una sesin CLP debe terminar con un mandato TERMINATE antes queun usuario inicie una nueva sesin CLP utilizando la misma ventana de sistemaoperativo. Esto crea un proceso de fondo nuevo para cada usuario nuevo, evitandoproblemas de autorizacin 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 maysculas como en minsculas desde elindicador de mandatos. Sin embargo, los parmetros que son sensibles a lasmaysculas y minsculas en DB2 se deben entrar con las maysculas y minsculasexactas deseadas. Por ejemplo, la serie-comentario de la clusula WITH del mandatoCHANGE DATABASE COMMENT es un parmetro sensible a las maysculas yminsculas.

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 carcterde 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 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 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 lasalida. Por ejemplo, si se ha realizado una conexin a la base de datos SAMPLE, lapeticin siguiente consulta la tabla STAFF y enva la salida a un archivo llamadostaflist.txt del directorio misdatos:

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

Para entornos donde no est soportada la redireccin de la salida, se puedenutilizar opciones de CLP. Por ejemplo, la peticin puede escribirse como

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

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

El procesador de lnea de mandatos no es un lenguaje de programacin. Porejemplo, 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 datosvlido.

El procesador de lnea de mandatos representa los valores NULL de SQL comoguiones (-). Si la columna es numrica, el guin se coloca a la derecha de lacolumna. si la columna no es numrica, el guin est a la izquierda.

Para visualizar correctamente los caracteres nacionales para idiomas de un solobyte (SBCS) desde la ventana del procesador de lnea 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 lnea de mandatos no da soporte a caracteres de soporte deidiomas nacionales (NLS) en los nombres de va de acceso a archivo. Esto afectaespecialmente a mandatos como por ejemplo IMPORT, EXPORT y REGISTERXMLSCHEMA, donde aparecen con mayor frecuencia nombres problemticos deva de acceso a archivos.

Se da soporte a la conexin de la salida de un mandato del procesador de lnea demandatos para otro mandato del procesador de lnea de mandatos. Por ejemplo:db2 -x | db2 +p -tv. Este soporte tiene como nica limitacin eltamao del almacenamiento intermedio de la conexin. Los tamaos de losalmacenamientos intermedios de las conexiones no pueden configurarse. Si elprimer mandato excede el tamao de almacenamiento intermedio de la conexin,puede que el procesador de la lnea de mandatos se cuelgue o genere un error alintentar grabar la salida en el almacenamiento intermedio de la conexin. Si el



segundo mandato no es un mandato del procesador de lnea de mandatos, porejemplo, un mandato de shell de UNIX, el procesador no se colgar ni generarun error debido a la limitacin del tamao del almacenamiento intermedio de laconexin.



db2 - Invocacin del procesador de lnea de mandatosEl mandato db2 inicia el procesador de lnea de mandatos (CLP). El CLP se utilizapara ejecutar programas de utilidad de base de datos, sentencias de SQL y ayudaen 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 db2v Modalidad de proceso por lotes, que utiliza la opcin de entrada de archivo -f.

En sistemas operativos Windows, db2cmd abre la ventana de DB2 habilitada paraCLP e inicializa el entorno de lnea de mandatos de DB2. La emisin de estemandato equivale a pulsar el icono Ventana de mandatos de DB2.

QUIT detiene el procesador de lnea de mandatos. TERMINATE tambin detiene elprocesador de lnea 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).Tambin podra ser necesario emitir TERMINATE despus de haber cambiado losparmetros de configuracin de base de datos para que estos cambios entren envigor. Antes de terminar el CLP se debern 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-opcin mandato-db2sentencia-sql?

frasemensajesqlstatecdigo-clase

-- comentario

distintivo-opcinEspecifica un distintivo de opcin 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 lainformacin solicitada, visualiza la pantalla de ayuda general.

db2 - Invocacin del procesador de lnea de mandatos


? options solicita una descripcin y los valores actuales de las opciones deCLP. ? help solicita informacin sobre la lectura de los diagramas desintaxis de la ayuda en lnea.

? mensajeSolicita ayuda para un mensaje especificado por un SQLCODE vlido (porejemplo ? sql10007n).

? sqlstateSolicita ayuda para un mensaje especificado por un mensaje SQLSTATEvlido.

? cdigo-claseSolicita ayuda para un mensaje especificado por un cdigo-clase vlido.

-- comentarioEl procesador de lnea 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.

db2 - Invocacin del procesador de lnea de mandatos


Opciones del procesador de lnea de mandatosLas opciones de mandatos de CLP pueden especificarse estableciendo la variablede entorno del procesador de lnea de mandatos DB2OPTIONS (que debe estar enmaysculas), o con distintivos de lnea de mandatos.

Los usuarios pueden establecer opciones para una sesin entera utilizandoDB2OPTIONS.

Vea los valores actuales para los distintivos de opcin y el valor de DB2OPTIONSutilizando LIST COMMAND OPTIONS. Cambie un valor de opcin de lamodalidad de entrada interactiva o un archivo de mandato utilizando UPDATECOMMAND 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 3 resume los distintivos de opciones de CLP. Estas opciones puedenespecificarse en cualquier secuencia y combinacin. Para activar una opcin, pongaun signo menos (-) delante de la letra de opcin correspondiente. Para desactivaruna opcin, ponga un signo menos delante de la letra de opcin y otro signomenos despus de dicha letra o ponga como prefijo de la letra de opcin un signoms (+). Por ejemplo, -c activa la opcin de confirmacin automtica y -c- o +c ladesactiva. Estas letras de opciones no son sensibles a las maysculas y minsculas,es decir, -a y -A son equivalentes.

Tabla 3. Opciones de mandatos de CLPDistintivo deopcin Descripcin

Valor poromisin

-a Esta opcin indica al procesador de lnea de mandatos quevisualice datos SQLCA.

OFF

-c Esta opcin indica al procesador de lnea de mandatos queconfirme automticamente las sentencias de SQL.

ON

-d Esta opcin indica al procesador de lnea de mandatos querecupere y visualice las declaraciones XML de datos XML.

OFF

-e{c|s} Esta opcin indica al procesador de lnea de mandatos quevisualice SQLCODE o SQLSTATE. Estas opciones seexcluyen mutuamente.

OFF

-fnombrearchivo Esta opcin indica al procesador de lnea de mandatos quelea entrada de mandato de un archivo en lugar de hacerlode la entrada estndar.

OFF

-i Esta opcin indica al procesador de lnea de mandatos queimprima con estilo los datos XML con el sangradocorrecto. Esta opcin solamente afectar al conjunto deresultados de sentencias XQuery.

OFF

-lnombre-archivo

Esta opcin indica al procesador de lnea de mandatos queanote cronolgicamente los mandatos en un archivohistrico.

OFF

Opciones del procesador de lnea de mandatos


Tabla 3. Opciones de mandatos de CLP (continuacin)Distintivo deopcin Descripcin

Valor poromisin

-m Esta opcin indica al procesador de lnea de mandatos queimprima el nmero de filas afectadas paraINSERT/DELETE/UPDATE/MERGE.

OFF

-n Elimina el carcter de lnea nueva dentro de un solosmbolo delimitado. Si no se especifica esta opcin, elcarcter de lnea nueva se sustituye por un espacio. Estaopcin debe utilizarse con la opcin -t.

OFF

-o Esta opcin indica al procesador de lnea de mandatos quevisualice los datos de salida y los mensajes en la salidaestndar.

ON

-p Esta opcin indica al procesador de lnea de mandatos quevisualice un indicador del procesador de lnea demandatos cuando se est en modalidad de entradainteractiva.

ON

-q Esta opcin indica al procesador de lnea de mandatos queconserve los espacios en blanco y los saltos de lnea en lasseries delimitadas por comillas o apstrofos. Cuando laopcin q es ON, se ignora la opcin n.

OFF

-rnombrearchivo Esta opcin indica al procesador de lnea de mandatos quegrabe el informe generado por un mandato en un archivo.

OFF

-s Esta opcin indica al procesador de lnea de mandatos quedetenga la ejecucin si se producen errores mientras seejecutan mandatos en un archivo de proceso por lotes o enmodalidad interactiva.

OFF

-t Esta opcin indica al procesador de lnea de mandatos queutilice un punto y coma (;) como carcter de terminacinde sentencia.

OFF

-tdx o -tdxx Esta opcin indica al procesador de lnea de mandatos quedefina y utilice x o xx como carcter o caracteres determinacin de sentencia (1 o 2 caracteres de longitud).

OFF

-v Esta opcin indica al procesador de lnea de mandatos querepita en eco el texto del mandato en la salida estndar.

OFF

-w Esta opcin indica al procesador de lnea de mandatos quevisualice mensajes de aviso de FETCH/SELECT.

ON

-x Esta opcin indica al procesador de lnea de mandatos quedevuelva datos sin ninguna cabecera, incluidos losnombres de columna. Este distintivo no afectar a todoslos mandatos. Es aplicable a sentencias de SQL y algunosmandatos basados en sentencias de SQL tales como LISTTABLES.

OFF

-znombrearchivo Esta opcin indica al procesador de lnea de mandatos queredirija toda la salida a un archivo. Es similar a la opcin-r, pero incluye los mensajes o los cdigos de error con lasalida.

OFF

Ejemplo

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



establece los valores por omisin siguientes para la sesin:Visualizar SQLCA - offConfirmar automticamente - onVisualizar SQLCODE - offVisualizar salida - onVisualizar indicador - on

A continuacin se proporciona una descripcin detallada de estas opciones:

Opcin de visualizacin de datos SQLCA (-a):Visualiza datos SQLCA en la salida estndar despus 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 omisin para esta opcin de mandato es OFF (+a o -a-).

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

Opcin de confirmacin automtica (-c):Esta opcin especifica si cada mandato o sentencia debe tratarse de formaindependiente. Si se establece en ON (-c), cada mandato o sentencia seconfirma o se retrotrae automticamente. 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 el compromiso automtico desactivado 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 confirmacin automtica desactivadaOFF. Si est establecida en OFF (+c o -c-), se debe emitir COMMIT o ROLLBACKde forma explcita o se producirn una de estas acciones cuando se emitael siguiente mandato con confirmacin automtica habilitada (ON)(-c).

El valor por omisin para esta opcin de mandato es ON.

La opcin de confirmacin automtica no afecta a ninguna otra opcin delprocesador de lnea de mandatos.

Ejemplo: Examine el escenario siguiente:1. db2 create database test2. db2 connect to test3. 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 confirmacin automtica establecida en ON (valor por omisin), retrotraeno slo la sentencia del paso 4, sino tambin la del paso 3, porque laltima se ha emitido con la confirmacin automtica establecida en OFF. Elmandato:

db2 list tables

devuelve entonces una lista vaca.

Opcin de declaracin XML (-d):

La opcin -d indica al procesador de lnea de mandatos si debe recuperary visualizar las declaraciones XML de datos XML.



Si se establece en ON (-d), las declaraciones XML se recuperarn yvisualizarn. Si se establece en OFF (+d o -d-), las declaraciones XML no serecuperarn y visualizarn. El valor por omisin para esta opcin demandato es OFF.

La opcin de declaracin XML no afecta a ninguna otra opcin deprocesador de lnea de mandatos.

Opcin de visualizacin de SQLCODE/SQLSTATE (-e):La opcin -e{c|s} indica al procesador de lnea de mandatos que debemostrar el mensaje SQLCODE (-ec) o SQLSTATE (-es) en la salidaestndar. Las opciones -ec y -es no son vlidas en modalidad interactivade 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 deopciones para obtener detalles.

La opcin de visualizacin de SQLCODE/SQLSTATE no afecta a ningunaotra opcin del procesador de lnea de mandatos.

Ejemplo: Para recuperar SQLCODE del procesador de lnea de mandatosejecutando en AIX, entre:

sqlcode=`db2 -ec +o db2command`

Opcin de lectura del archivo de entrada (-f):La opcin -f nombrearchivo indica al procesador de lnea de mandatos quelea entrada de un archivo especificado, en lugar de hacerlo de la entradaestndar. Nombrearchivo es un nombre de archivo absoluto o relativo quepuede incluir la va de acceso de directorio al archivo. Si no se especifica lava de acceso de directorio, se utiliza el directorio actual.

Cuando se llama al CLP con una opcin de entrada de archivo, seestablecer automticamente el registro especial CLIENT APPLNAME enCLP nombrearchivo.

Cuando se combinan otras opciones con la opcin -f, la opcin -f debeespecificarse en ltimo lugar. Por ejemplo:

db2 -tvf nombrearchivo

Esta opcin no se puede cambiar desde la modalidad interactiva.

El valor por omisin para esta opcin de mandato es OFF (+f o -f-).

Los mandatos se procesan hasta que se emite el mandato QUIT oTERMINATE o se encuentra un cdigo de fin de archivo.

Si se especifican esta opcin y un mandato de base de datos, el procesadorde lnea de mandatos no procesa ningn mandato y se devuelve unmensaje de error.

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

Las lneas de los archivos de entrada que empiezan por (= se tratan comoel principio de un bloque de comentario. Las lneas que acaban por =)marcan el fin de un bloque de comentario. El bloque de lneas de entradaque empieza en (= y finaliza en =) se trata como un comentario continuopor parte del procesador de lnea de mandatos. Estn permitidos losespacios antes de (= y despus de =). Pueden jerarquizarse los



comentarios, y pueden utilizarse jerarquizados en las sentencias. El carcterde terminacin de mandato (;) no se puede utilizar despus de =).

Si se especifica la opcin -f nombrearchivo, se ignora la opcin -p.

La opcin de lectura del archivo de entrada no afecta a ninguna otraopcin del procesador de lnea de mandatos.

Opcin de impresin con estilo (-i):

La opcin -i indica al procesador de lnea de mandatos que imprima conestilo los datos XML con el sangrado correcto. Esta opcin solamenteafectar al conjunto de resultados de sentencias XQuery.

El valor por omisin para esta opcin de mandato es OFF (+i o -i-).

La opcin de impresin con estilo no afecta a ninguna otra opcin deprocesador de lnea de mandatos.

Opcin Anotar cronolgicamente mandatos en archivo histrico (-l):La opcin -l nombrearchivo indica al procesador de lnea de mandatos queanote cronolgicamente los mandatos en un archivo especificado. Estearchivo histrico contiene registros de los mandatos ejecutados y su estadode realizacin. Nombrearchivo es un nombre de archivo absoluto o relativoque puede incluir la va de acceso de directorio al archivo. Si no seespecifica la va de acceso de directorio, se utiliza el directorio actual. Si elarchivo especificado o el archivo por omisin ya existe, la nueva entradade anotacin cronolgica se aade a dicho archivo.

Cuando se combinan otras opciones con la opcin -l, la opcin -l debeespecificarse en ltimo lugar. Por ejemplo:

db2 -tvl nombrearchivo

El valor por omisin para esta opcin de mandato es OFF (+l o -l-).

La opcin de anotacin cronolgica de mandatos en archivo histrico noafecta a ninguna otra opcin del procesador de lnea de mandatos.

Opcin Visualizar el nmero de filas afectadas (-m):

La opcin -m indica al procesador de lnea de mandatos si debe imprimir ono el nmero de filas afectadas para INSERT, DELETE, UPDATE oMERGE.

Si se establece en ON (-m), se visualizar el nmero de filas afectadas parala sentencia de INSERT/DELETE/UPDATE/MERGE. Si se establece en OFF(+m o -m-), no se visualizar el nmero de filas afectadas. Para otrassentencias, se pasar por alto esta opcin. El valor por omisin para estaopcin de mandato es OFF.

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

Opcin Eliminar carcter de lnea nueva (-n):Elimina el carcter de lnea nueva dentro de un solo smbolo delimitado. Sino se especifica esta opcin, el carcter de lnea nueva se sustituye por unespacio. Esta opcin no se puede cambiar desde la modalidad interactiva.

El valor por omisin para esta opcin de mandato es OFF (+n o -n-).

Esta opcin debe utilizarse con la opcin -t; consulte la descripcin de lasopciones para obtener detalles.



Opcin Visualizar salida (-o):La opcin -o indica al procesador de lnea de mandatos que enve losdatos de salida y los mensajes a la salida estndar.


Esta opcin no afecta a la informacin de arranque de modalidadinteractiva. Los datos de salida constan de la salida de informe de laejecucin del mandato especificado por el usuario y de datos SQLCA (si sesolicitan).

La opcin +o puede afectar a las opciones siguientes:v -r nombrearchivo: La informacin de arranque de modalidad interactivano se guarda.

v -e: Se visualiza SQLCODE o SQLSTATE en la salida estndar incluso sise especifica +o.

v -a: Ningn efecto si se especifica +o. Si se especifican -a, +o y-rnombrearchivo, la informacin 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 opcin de visualizacin de salida no afecta a ninguna otra opcin delprocesador de lnea de mandatos.

Opcin Visualizar indicador interactivo de DB2 (-p):La opcin -p indica al procesador de lnea de mandatos que visualice elindicador del procesador de lnea de mandatos cuando el usuario est enmodalidad interactiva.


La desactivacin del indicador es til cuando los mandatos se redirigen alprocesador de lnea de mandatos. Por ejemplo, un archivo que contienemandatos de CLP podra ejecutarse emitiendo:

db2 +p < miarchivo.clp

La opcin -p se ignora si se especifica la opcin -f nombrearchivo.

La opcin de visualizacin de indicador interactivo de DB2 no afecta aninguna otra opcin del procesador de lnea de mandatos.

Opcin de conservacin de espacios en blanco y saltos de lnea (-q):

La opcin -q indica al procesador de lnea de mandatos que conserve losespacios en blanco y los saltos de lnea en las series delimitadas porcomillas o apstrofos.

El valor por omisin para esta opcin de mandato es OFF (+q o -q-).

Si la opcin -q es ON, se ignora la opcin -n.

Opcin Guardar en archivo de informe (-r):La opcin -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 desplazara fuera de la pantalla. No segraban mensajes o cdigos de error en el archivo. Nombrearchivo es unnombre 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, seutiliza el directorio actual. Las entradas de informe nuevas se aaden alarchivo.

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 -r nombrearchivo se establece en DB2OPTIONS, el usuario puedeestablecer la opcin +r (o -r-) desde la lnea de mandatos para impedirque los datos de salida de una invocacin de mandato determinada segraben en el archivo.

La opcin de guardar en archivo de informe no afecta a ninguna otraopcin del procesador de lnea de mandatos.

Opcin Detener ejecucin 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 opcin -shace que el procesador de lnea de mandatos detenga la ejecucin y grabemensajes de error en la salida estndar.

El valor por omisin para esta opcin de mandato es OFF (+s o -s-). Estevalor hace que el procesador de lnea de mandatos visualice mensajes deerror, contine la ejecucin de los mandatos restantes y detenga laejecucin slo si se produce un error del sistema (cdigo de retorno 8).

La tabla siguiente resume este comportamiento:

Tabla 4. Cdigos de retorno de CLP y ejecucin de mandatoCdigo de retorno Opcin -s establecida Opcin +s establecida

0 (satisfactorio) contina la ejecucin contina la ejecucin

1 (0 filas seleccionadas) contina la ejecucin contina la ejecucin

2 (aviso) contina la ejecucin contina la ejecucin

4 (error de DB2 o SQL) se detiene la ejecucin contina la ejecucin

8 (Error del sistema) se detiene la ejecucin se detiene la ejecucin

Opciones de carcter de terminacin de sentencia (-t y -tdx o -tdxx):La opcin -t indica al procesador de lnea de mandatos que utilice unpunto y coma (;) como carcter de terminacin de sentencia e inhabilita elcarcter de continuacin de lnea de barra inclinada invertida (\). Estaopcin no se puede cambiar desde la modalidad interactiva.

El valor por omisin para esta opcin de mandato es OFF (+t o -t-).

Nota: Si utiliza el CLP para emitir sentencias de XQuery, es mejor elegirun carcter de terminacin 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 tambin terminan con un punto y coma.

Para definir caracteres de terminacin de 1 o 2 caracteres de longitud,utilice -td seguido del carcter o caracteres elegidos. Por ejemplo, -td%%establece %% como carcter de terminacin de sentencia. Otra posibilidad esutilizar la directiva --#SET TERMINATOR en un archivo de entrada paraestablecer los caracteres de terminacin 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 omisin para esta opcin de mandato es OFF.

El carcter o los caracteres de terminacin no se pueden utilizar paraconcatenar varias sentencias desde la lnea de mandatos, dado que lascomprobaciones de smbolo de terminacin slo se realizan en el ltimocarcter o los dos ltimos caracteres distintos de espacio en blanco de cadalnea de entrada.

Las opciones de carcter de terminacin de sentencia no afectan a ningunaotra opcin del 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 devisualizar la salida as como los mensajes de dicho mandato. ECHO estexento 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 delnea de mandatos.

Opcin Mostrar mensajes de aviso (-w):La opcin -w indica al procesador de lnea 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 laejecucin de la consulta, lo que puede dar como resultado que los mensajesse visualicen antes, durante o tras la devolucin de los datos. Paraasegurar que los datos devueltos no contienen texto de mensaje de aviso,puede utilizarse este distintivo.


Opcin Suprimir impresin de cabeceras de columna (-x):La opcin -x indica al procesador de lnea 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 omisin para esta opcin de mandato es OFF.

Opcin Guardar toda la salida en archivo (-z):La opcin -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 desplazara fuera de la pantalla. Es similara la opcin -r; sin embargo, en este caso tambin se graban en el archivomensajes, cdigos de error y ms informacin de salida. Nombrearchivo esun nombre de archivo absoluto o relativo que puede incluir la va deacceso de directorio al archivo. Si no se especifica la va de acceso dedirectorio, se utiliza el directorio actual. Las entradas de informe nuevas seaaden 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 -z nombrearchivo se establece en DB2OPTIONS, el usuario puedeestablecer la opcin +z (o -z-) desde la lnea de mandatos para impedirque los datos de salida de una invocacin de mandato determinada segraben en el archivo.

La opcin de guardar toda la salida en archivo no afecta a ninguna otraopcin del procesador de lnea de mandatos.



Cdigos de retorno del procesador de lnea de mandatosCuando el procesador de lnea de mandatos termina de procesar un mandato ouna sentencia de SQL, devuelve un cdigo de retorno (o de salida). Estos cdigosson transparentes para los usuarios que ejecutan funciones CLP desde la lnea 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 continuacin, inspecciona elcdigo de retorno del CLP:

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

El cdigo de retorno puede ser uno de los siguientes:

CdigoDescripcin

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 lnea de mandatos

El procesador de lnea de mandatos no proporciona ningn cdigo de retornomientras un usuario est ejecutando sentencias desde la modalidad interactiva omientras se est leyendo entrada en un archivo (utilizando la opcin -f).

Un cdigo de retorno slo queda disponible despus de que el usuario haya salidode la modalidad interactiva o cuando ha finalizado el proceso de un archivo deentrada. En estos casos, el cdigo de retorno es el OR lgico de los cdigos 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 producencdigos de retorno de 0, 1 y 2, se devolver un cdigo de retorno de 3 despus deque el usuario haya salido de la modalidad interactiva. No se devuelven loscdigos individuales 0, 1 y 2. El cdigo de retorno 3 indica al usuario que duranteel proceso en modalidad interactiva, uno o ms mandatos han devuelto un 1 y unoo ms mandatos han devuelto un 2.

Un SQLCODE negativo devuelto por un mandato DB2 o una sentencia de SQLproduce un cdigo de retorno de 4. Un cdigo de retorno de 8 slo se produce siel procesador de lnea de mandatos encuentra un error del sistema.

Si se emiten mandatos desde un archivo de entrada o en modalidad interactiva yel procesador de lnea de mandatos experimenta un error del sistema (cdigo deretorno 8), se detiene inmediatamente la ejecucin de mandatos. Si uno o msmandatos DB2 o sentencias de SQL terminan en error (cdigo de retorno 4), laejecucin de mandatos se detiene si se ha establecido la opcin -s (Detenerejecucin en error de mandato); de lo contrario, la ejecucin contina.

Cdigos de retorno del procesador de lnea de mandatos


Invocar ayuda de mandatos desde el procesador de lnea de mandatosLa ayuda de mandatos explica la sintaxis de mandatos en el procesador de lneade mandatos.

Para invocar la ayuda de mandatos, abra el procesador de lnea 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 lnea de mandatosLa ayuda de mensajes describe la causa de un mensaje y describe cualquier accinque deber tomar como respuesta al error.

Para invocar la ayuda de mensajes, abra el procesador de lnea de mandatos yespecifique:

? XXXnnnnn

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

Invocar ayuda de mandatos desde el procesador de lnea de mandatos


Invocar ayuda de mensajes desde el procesador de lnea de mandatos


Captulo 2. Utilizacin de sentencias de SQL y XQuery delnea de mandatos

Esta seccin proporciona informacin sobre la utilizacin de sentencias de Lenguajede Consulta Estructurada (SQL) desde la lnea de mandatos. Estas sentenciaspueden ejecutarse directamente desde un indicador de mandatos de sistemaoperativo y se pueden utilizar para definir y manipular informacin almacenadaen una tabla, un ndice o una vista de base de datos del mismo modo que si seescribieran los mandatos en un programa de aplicacin. Se puede aadir, suprimiro actualizar informacin y se pueden generar informes a partir del contenido delas tablas.

Puede utilizar sentencias de SQL desde la lnea de mandatos y puede utilizar unprocedimiento almacenado (SYSPROC.ADMIN_CMD()) para ejecutar algunosmandatos del CLP mediante SQL. Para obtener ms informacin sobre cmoutilizar 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 uncarcter de terminacin distinto del punto y coma (opcin -t). Esto asegura que lassentencias o las consultas que utilizan declaraciones de espacio de nombres no seinterpreten incorrectamente, porque las declaraciones de espacio de nombrestambin terminan con un punto y coma.

Todas las sentencias de SQL que se pueden ejecutar mediante el procesador delnea de mandatos se listan en la columna CLP de la Tabla 5 en la pgina 27. Lasintaxis de todas las sentencias de SQL, tanto si se ejecutan desde la lnea demandatos como si se incorporan en un programa fuente, se describen en lapublicacin Consulta de SQL. La sintaxis de muchas sentencias de SQLincorporadas y sentencias de SQL CLP es idntica. Sin embargo, las variables desistema principal, los marcadores de parmetro, los nombres de descriptor y losnombres de sentencia slo son aplicables al SQL incorporado. La sintaxis de CALL,CLOSE, CONNECT, DECLARE CURSOR, FETCH y OPEN depende de si estassentencias estn incorporadas o se ejecuten mediante el CLP. A continuacin seproporciona la sintaxis CLP de estas sentencias:

CALL

CALL procedure-name

( ),

expresin?null

CLOSE

CLOSE nombre-cursor

Copyright IBM Corp. 1993, 2010 23

CONNECT

CONNECT

TO nombre-servidor

bloque-bloqueo autorizacinRESET

(1)autorizacin

autorizacin:

USER nombre-autorizacin

USING contrasea

NEW contrasea CONFIRM contraseaCHANGE PASSWORD

bloque-bloqueo:

IN SHARE MODE

IN EXCLUSIVE MODEON SINGLE NODE

Notas:

1 Este formato slo es vlido si se ha habilitado la conexin implcita.

DECLARE CURSOR

DECLARE nombre-cursor CURSORWITH HOLD

DATABASE nombrebd

USER usuario USING contrasea

FOR sentencia-selectXQUERY sentencia-xquery

FETCH

FETCH nombre-cursorFROM

Utilizacin de sentencias de SQL y XQuery de lnea de mandatos


FOR ALL ROW

n ROWSLOB COLUMN ALL INTO nombre-archivo APPEND

COLUMNS NEWOVERWRITE

OPEN

OPEN nombre-cursor

Nota:

1. Cuando se emite CALL:v Debe utilizarse una expresin para cada parmetro IN o INOUT delprocedimiento. Para un parmetro INOUT, la expresin debe ser un solovalor de literal. Los parmetros 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 expresin.

v Debe utilizarse un signo de cierre de interrogacin (?) para cada parmetroOUT 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 PROC4despus de crear una tabla con una columna de XML C1. Utiliza tresparmetros 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 lnea demandatos, emita una sentencia CALL:CALL PROC4(XMLPARSE(DOCUMENT 111), XMLPARSE(DOCUMENT 222), ?)

2. La versin CLP de CONNECT permite al usuario cambiar la contrasea,utilizando los parmetros siguientes:


Captulo 2. Sentencias de SQL y XQuery de lnea de mandatos 25

NEW contraseaEspecifica la contrasea nueva que se debe asignar al nombre deusuario. Las contraseas pueden tener hasta 18 caracteres de longitud.El sistema en el que se cambiar la contrasea depende del modo enque se haya configurado la autentificacin de usuario.

CONFIRM contraseaSerie que debe ser idntica a la contrasea nueva. Este parmetro seutiliza para detectar errores de entrada.

CHANGE PASSWORDSi se especifica esta opcin, se solicita al usuario la contrasea actual,una contrasea nueva y la confirmacin de la contrasea nueva. Lascontraseas no se visualizan al entrarse.

3. La clusula DATABASE de la sentencia DECLARE CURSOR slo es aplicable cuandoel cursor va a utilizarse para una carga posterior a la operacin del cursor.

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

5. Cuando se emite FETCH mediante el procesador de lnea de mandatos, sevisualizan nmeros 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 mayora de los pases y regiones restantes. Sin embargo, cuandose emiten sentencias INSERT, UPDATE, CALL y otras sentencias de SQLmediante el procesador de lnea de mandatos para actualizar tablas, se deberutilizar un punto como delimitador decimal, incluso en pases y regiones queutilizan una coma para dicha finalidad.

6. Cuando se emite FETCH mediante el procesador de lnea de mandatos, losvalores nulos se visualizan normalmente como un guin (-). Para bases dedatos configuradas con DFT_SQLMATHWARN YES, las expresiones queproducen un error aritmtico se procesan como valores nulos. Los nulos deerrores 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---

1+-

3 registros seleccionados

7. Se ha aadido una opcin LOB nueva a FETCH. Si se especifica la clusulaLOB, slo se capta la fila siguiente:v Cuando se emite SELECT desde el procesador de lnea de mandatos paraconsultar tablas que contienen columnas LOB, todas las columnas setruncan a 8KB en la salida.

v Cada valor de columna LOB se capta en un archivo con el nombrenombre-archivo.xxx, donde nombre-archivo se especifica en la clusula LOB yxxx es una extensin de archivo de 001 a 999 (001 es la primera columnaLOB de la lista de seleccin de la sentencia DECLARE CURSORcorrespondiente, 002 es la segunda columna LOB y 999 es la columnanmero 999). El nmero mximo de columnas LOB que se pueden captaren archivos es de 999.



v Los nombres de los archivos que contienen los datos se visualizan en lascolumnas LOB.

8. El procesador de lnea de mandatos visualiza las columnas BLOB enrepresentacin hexadecimal.

9. Las sentencias de SQL que contienen referencias a columnas de tipoestructurado no se pueden emitir si no est disponible una funcin detransformacin apropiada.

10. Se ha eliminado el lmite de 64K impuesto por CLP para las sentencias deSQL y para los mandatos de CLP que contienen componentes de sentencias deSQL.

11. Los datos de XML, recuperados mediante SELECT, CALL o XQuery se truncana 4000 bytes en la salida.

Para cambiar el modo en que el CLP muestra los datos (al consultar bases de datosutilizando sentencias de SQL mediante el CLP), vuelva a vincular los archivos devinculacin CLP para la base de datos que se est consultando. Por ejemplo, paravisualizar 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 vincularmltiples archivos con un mandato BIND. En este ejemplo el archivo se llamaclp.lst y su contenido es:

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 5. Sentencias de SQL (DB2)

Sentencia de SQL Dinmico1

Procesadorde lnea demandatos(CLP) Interfaz de nivel de llamada3 (CLI) Proc. SQL

ALLOCATE CURSOR X

sentencia de asignacin X

ASSOCIATE LOCATORS X

ALTER { BUFFERPOOL,NICKNAME,9 NODEGROUP,SERVER,9 TABLE, TABLESPACE,USER MAPPING,9 TYPE, VIEW }

X X X

BEGIN DECLARE SECTION2

CALL X X X X

Sentencia CASE X

CLOSE X SQLCloseCursor(), SQLFreeStmt() X

COMMENT ON X X X X

COMMIT X X SQLEndTran(), SQLTransact() X

SQL compuesto (incorporado) X4

sentencia compuesta X


Captulo 2. Sentencias de SQL y XQuery de lnea de mandatos 27

Tabla 5. Sentencias de SQL (DB2) (continuacin)

Sentencia de SQL Dinmico1

Procesadorde lnea demandatos(CLP) Interfaz de nivel de llamada3 (CLI) Proc. SQL

CONNECT (Tipo 1) X SQLBrowseConnect(), SQLConnect(),SQLDriverConnect()

CONNECT (Tipo 2) X SQLBrowseConnect(), SQLConnect(),SQLDriverConnect()

CREATE { ALIAS, BUFFERPOOL,DISTINCT TYPE,EVENT MONITOR, FUNCTION,FUNCTION MAPPING9, GLOBALTEMPORARY TABLE, INDEX,INDEX EXTENSION, METHOD,NICKNAME,9 NODEGROUP,PROCEDURE, SCHEMA, SERVER,TABLE, TABLESPACE,TRANSFORM, TYPE MAPPING,9

TRIGGER, USER MAPPING,9 TYPE,VIEW, WRAPPER9 }

X X X X10

DECLARE CURSOR2 X SQLAllocStmt() X

DECLARE GLOBAL TEMPORARYTABLE

X X X X

DELETE X X X X

DESCRIBE8 X SQLColAttributes(),SQLDescribeCol(),SQLDescribeParam()6

DISCONNECT X SQLDisconnect()

DROP X X X X10

END DECLARE SECTION2

EXECUTE SQLExecute() X

EXECUTE IMMEDIATE SQLExecDirect() X

EXPLAIN X X X X

FETCH X SQLExtendedFetch(), SQLFetch(),SQLFetchScroll()

X

FLUSH EVENT MONITOR X X X

Sentencia FOR X

FREE LOCATOR X4 X

GET DIAGNOSTICS X

Sentencia GOTO X

GRANT X X X X

Sentencia IF X

INCLUDE2

INSERT X X X X

ITERATE X

Sentencia LEAV

db2commandref-db2n0z972

Documents