DB2 CommandRef v.10.5

IBM DB2 10.5para Linux, UNIX y Windows

Consulta de mandatos

SC11-8362-00

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 1429.

Nota de edicin

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 solicitar publicaciones en lnea, vaya a IBM Publications Center en http://www.ibm.com/shop/publications/order

v Para encontrar al representante local de IBM que le corresponde, vaya a la seccin Worlwide Contacts de IBMDirectory en http://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, est otorgando a IBM el derecho no exclusivo de utilizar o distribuir lainformacin de cualquier forma que considere adecuada sin incurrir por ello a ninguna obligacin para con usted.

Copyright IBM Corporation 1993, 2013.

ContenidoAcerca de este manual . . . . . . . . ixQuin debe utilizar este manual . . . . . . . ixCmo esta 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 . . . . . . . . . . . . 34Tipos de consolas de CLPPlus . . . . . . . . 36

Modalidad de ventana y soporte de caracteresUTF-8 . . . . . . . . . . . . . . . 38Establecimiento del font en modalidad deventana de CLPPlus . . . . . . . . . . 38Establecimiento del color de font en lamodalidad de ventana de CLPPlus . . . . . 39Establecimiento del color de fondo en lamodalidad de ventana de CLPPlus . . . . . 39

Alias de DSN en CLPPlus . . . . . . . . . 40Palabras clave de db2dsdriver.cfg soportadas . . . 42Autentificacin de Kerberos en CLPPlus . . . . . 43Autentificacin SERVER_ENCRYPT en CLPPlus . . 44Soporte de LDAP en CLPPlus . . . . . . . . 46Ejecucin de un archivo script en CLPPlus . . . . 50Interrupcin y omisin de mandatos de CLPPlus . . 51Comentarios en CLPPlus . . . . . . . . . . 52Caracteres de escape en CLPPlus . . . . . . . 53Vinculacin de variables en CLPPlus . . . . . . 55Variables de entorno y shell en CLPPlus . . . . . 59Mandatos de DB2 soportados por CLPPlus . . . . 60

CREATE DATABASE en CLPPlus . . . . . . 62Restricciones de CLPPlus . . . . . . . . . . 63Consejos y sugerencias para la resolucin deproblemas de CLPPlus . . . . . . . . . . 64

Rastreos y anotacin cronolgica de registro deCLPPlus . . . . . . . . . . . . . . 65

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

Captulo 5. Mandatos CLP . . . . . . 71ACTIVATE DATABASE . . . . . . . . . . 72ADD CONTACT . . . . . . . . . . . . 74ADD CONTACTGROUP . . . . . . . . . . 76ADD DBPARTITIONNUM . . . . . . . . . 77ADD XMLSCHEMA DOCUMENT . . . . . . 80ARCHIVE LOG . . . . . . . . . . . . . 82ATTACH . . . . . . . . . . . . . . . 85AUTOCONFIGURE . . . . . . . . . . . 87BACKUP DATABASE . . . . . . . . . . . 90BIND . . . . . . . . . . . . . . . . 101CATALOG DATABASE . . . . . . . . . . 124CATALOG DCS DATABASE . . . . . . . . 128CATALOG LDAP DATABASE. . . . . . . . 130CATALOG LDAP NODE . . . . . . . . . 133CATALOG LOCAL NODE . . . . . . . . . 134CATALOG NAMED PIPE NODE. . . . . . . 136CATALOG ODBC DATA SOURCE . . . . . . 138CATALOG TCPIP/TCPIP4/TCPIP6 NODE . . . 140CHANGE DATABASE COMMENT . . . . . . 144CHANGE ISOLATION LEVEL . . . . . . . 146COMPLETE XMLSCHEMA . . . . . . . . 148CREATE DATABASE . . . . . . . . . . . 149CREATE TOOLS CATALOG . . . . . . . . 169DEACTIVATE DATABASE . . . . . . . . . 172DECOMPOSE XML DOCUMENT . . . . . . 174DECOMPOSE XML DOCUMENTS . . . . . . 176DEREGISTER . . . . . . . . . . . . . 180DESCRIBE . . . . . . . . . . . . . . 181DETACH . . . . . . . . . . . . . . . 191DROP CONTACT . . . . . . . . . . . . 192DROP CONTACTGROUP . . . . . . . . . 193DROP DATABASE . . . . . . . . . . . 194DROP DBPARTITIONNUM VERIFY. . . . . . 196DROP TOOLS CATALOG . . . . . . . . . 197ECHO. . . . . . . . . . . . . . . . 199EDIT . . . . . . . . . . . . . . . . 200EXPORT . . . . . . . . . . . . . . . 201FORCE APPLICATION . . . . . . . . . . 213GET ADMIN CONFIGURATION. . . . . . . 215GET ALERT CONFIGURATION . . . . . . . 217GET CLI CONFIGURATION . . . . . . . . 223GET CONNECTION STATE . . . . . . . . 225GET CONTACTGROUP . . . . . . . . . . 226GET CONTACTGROUPS . . . . . . . . . 227GET CONTACTS . . . . . . . . . . . . 228GET DATABASE CONFIGURATION . . . . . 229GET DATABASE MANAGER CONFIGURATION 241

Copyright IBM Corp. 1993, 2013 iii

GET DATABASE MANAGER MONITORSWITCHES . . . . . . . . . . . . . . 250GET DESCRIPTION FOR HEALTH INDICATOR 253GET HEALTH NOTIFICATION CONTACT LIST 255GET HEALTH SNAPSHOT. . . . . . . . . 256GET INSTANCE . . . . . . . . . . . . 260GET MONITOR SWITCHES . . . . . . . . 261GET RECOMMENDATIONS FOR HEALTHINDICATOR. . . . . . . . . . . . . . 264GET ROUTINE . . . . . . . . . . . . . 268HELP . . . . . . . . . . . . . . . . 270HELP . . . . . . . . . . . . . . . . 271HISTORY. . . . . . . . . . . . . . . 272IMPORT . . . . . . . . . . . . . . . 273INGEST . . . . . . . . . . . . . . . 306INITIALIZE TAPE. . . . . . . . . . . . 354INSPECT . . . . . . . . . . . . . . . 355LIST ACTIVE DATABASES. . . . . . . . . 363LIST APPLICATIONS . . . . . . . . . . 365LIST COMMAND OPTIONS . . . . . . . . 368LIST DATABASE DIRECTORY . . . . . . . 369LIST DATABASE PARTITION GROUPS . . . . 373LIST DBPARTITIONNUMS. . . . . . . . . 375LIST DCS APPLICATIONS . . . . . . . . . 376LIST DCS DIRECTORY . . . . . . . . . . 378LIST DRDA INDOUBT TRANSACTIONS . . . . 380LIST HISTORY . . . . . . . . . . . . . 382LIST INDOUBT TRANSACTIONS . . . . . . 388LIST NODE DIRECTORY . . . . . . . . . 391LIST ODBC DATA SOURCES . . . . . . . . 394LIST PACKAGES/TABLES . . . . . . . . . 395LIST TABLESPACE CONTAINERS . . . . . . 398LIST TABLESPACES . . . . . . . . . . . 400LIST UTILITIES . . . . . . . . . . . . 405LOAD. . . . . . . . . . . . . . . . 407LOAD QUERY . . . . . . . . . . . . . 458MIGRATE DATABASE . . . . . . . . . . 464PING . . . . . . . . . . . . . . . . 465PRECOMPILE . . . . . . . . . . . . . 467PRUNE HISTORY/LOGFILE . . . . . . . . 497PUT ROUTINE. . . . . . . . . . . . . 500QUERY CLIENT . . . . . . . . . . . . 502QUIESCE. . . . . . . . . . . . . . . 503QUIESCE TABLESPACES FOR TABLE . . . . . 507QUIT . . . . . . . . . . . . . . . . 510REBIND . . . . . . . . . . . . . . . 511RECOVER DATABASE . . . . . . . . . . 516REDISTRIBUTE DATABASE PARTITION GROUP 523REFRESH LDAP . . . . . . . . . . . . 532REGISTER . . . . . . . . . . . . . . 534REGISTER XMLSCHEMA . . . . . . . . . 537REGISTER XSROBJECT . . . . . . . . . . 539REORG INDEXES/TABLE . . . . . . . . . 541REORGCHK . . . . . . . . . . . . . 563RESET ADMIN CONFIGURATION . . . . . . 576RESET ALERT CONFIGURATION . . . . . . 578RESET DATABASE CONFIGURATION. . . . . 580RESET DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 582RESET MONITOR. . . . . . . . . . . . 584RESTART DATABASE . . . . . . . . . . 586

RESTORE DATABASE . . . . . . . . . . 589REWIND TAPE . . . . . . . . . . . . 614ROLLFORWARD DATABASE . . . . . . . . 615RUNCMD . . . . . . . . . . . . . . 627RUNSTATS . . . . . . . . . . . . . . 628SET CLIENT . . . . . . . . . . . . . 646SET RUNTIME DEGREE . . . . . . . . . 649SET SERVEROUTPUT . . . . . . . . . . 651SET TABLESPACE CONTAINERS . . . . . . 653SET TAPE POSITION . . . . . . . . . . 656SET UTIL_IMPACT_PRIORITY . . . . . . . 657SET WORKLOAD . . . . . . . . . . . . 660SET WRITE . . . . . . . . . . . . . . 661START DATABASE MANAGER . . . . . . . 664START HADR . . . . . . . . . . . . . 673STOP DATABASE MANAGER . . . . . . . 676STOP HADR . . . . . . . . . . . . . 680TAKEOVER HADR . . . . . . . . . . . 682TERMINATE . . . . . . . . . . . . . 689UNCATALOG DATABASE . . . . . . . . . 690UNCATALOG DCS DATABASE . . . . . . . 692UNCATALOG LDAP DATABASE . . . . . . 693UNCATALOG LDAP NODE . . . . . . . . 694UNCATALOG NODE . . . . . . . . . . 695UNCATALOG ODBC DATA SOURCE . . . . . 696UNQUIESCE . . . . . . . . . . . . . 697UPDATE ADMIN CONFIGURATION . . . . . 699UPDATE ALERT CONFIGURATION . . . . . 702UPDATE ALTERNATE SERVER FOR DATABASE 707UPDATE ALTERNATE SERVER FOR LDAPDATABASE . . . . . . . . . . . . . . 709UPDATE CLI CONFIGURATION . . . . . . 710UPDATE COMMAND OPTIONS. . . . . . . 712UPDATE CONTACT . . . . . . . . . . . 714UPDATE CONTACTGROUP . . . . . . . . 715UPDATE DATABASE CONFIGURATION . . . . 716UPDATE DATABASE MANAGERCONFIGURATION . . . . . . . . . . . 720UPDATE HEALTH NOTIFICATION CONTACTLIST . . . . . . . . . . . . . . . . 723UPDATE HISTORY . . . . . . . . . . . 724UPDATE LDAP NODE . . . . . . . . . . 727UPDATE MONITOR SWITCHES . . . . . . . 729UPDATE XMLSCHEMA. . . . . . . . . . 732UPGRADE DATABASE . . . . . . . . . . 733

Captulo 6. Mandatos de CLPPlus . . 735. . . . . . . . . . . . . . . . . . . 736! . . . . . . . . . . . . . . . . . . 737/ . . . . . . . . . . . . . . . . . 738@ . . . . . . . . . . . . . . . . . 739@@ . . . . . . . . . . . . . . . . . 740ACCEPT . . . . . . . . . . . . . . . 741APPEND . . . . . . . . . . . . . . . 744BREAK . . . . . . . . . . . . . . . 745BTITLE . . . . . . . . . . . . . . . 746CHANGE . . . . . . . . . . . . . . 748CLEAR . . . . . . . . . . . . . . . 751COLUMN . . . . . . . . . . . . . . 753COMPUTE . . . . . . . . . . . . . . 758CONNECT . . . . . . . . . . . . . . 760

iv Consulta de mandatos

COPY . . . . . . . . . . . . . . . . 763DEFINE . . . . . . . . . . . . . . . 766DEL . . . . . . . . . . . . . . . . 767DESCRIBE . . . . . . . . . . . . . . 769DISCONNECT . . . . . . . . . . . . . 774EDIT . . . . . . . . . . . . . . . . 775EXECUTE . . . . . . . . . . . . . . 776EXIT . . . . . . . . . . . . . . . . 779EXPLAIN PLAN . . . . . . . . . . . . 781GET . . . . . . . . . . . . . . . . 782HELP . . . . . . . . . . . . . . . . 783HOST . . . . . . . . . . . . . . . . 784Mandato IMPORT de CLPPlus . . . . . . . 785INPUT . . . . . . . . . . . . . . . 787LIST . . . . . . . . . . . . . . . . 788PAUSE . . . . . . . . . . . . . . . 790PRINT. . . . . . . . . . . . . . . . 791PROMPT . . . . . . . . . . . . . . . 792QUIT . . . . . . . . . . . . . . . . 793REMARK. . . . . . . . . . . . . . . 794REORGCHK . . . . . . . . . . . . . 795REPFOOTER . . . . . . . . . . . . . 797REPHEADER . . . . . . . . . . . . . 799RUN . . . . . . . . . . . . . . . . 801SAVE . . . . . . . . . . . . . . . . 802SET. . . . . . . . . . . . . . . . . 803SPOOL . . . . . . . . . . . . . . . 813SHOW . . . . . . . . . . . . . . . 814Mandato START . . . . . . . . . . . . 815TTITLE . . . . . . . . . . . . . . . 816UNDEFINE . . . . . . . . . . . . . . 818WHENEVER OSERROR . . . . . . . . . . 819WHENEVER SQLERROR . . . . . . . . . 821

Captulo 7. Mandatos del sistema. . . 825dasauto - Iniciar automticamente un servidor deadministracin de DB2 . . . . . . . . . . 826dascrt - Crear un Servidor de administracin deDB2 . . . . . . . . . . . . . . . . 827dasdrop - Eliminar un servidor de administracinde DB2 . . . . . . . . . . . . . . . 829dasmigr - Migrar el Servidor de administracin deDB2 . . . . . . . . . . . . . . . . 830dasupdt - Actualizar DAS . . . . . . . . . 832db2_deinstall - Desinstalar productos,caractersticas o idiomas de base de datos DB2 . . 834db2_install - Instalar el producto de base de datosDB2 . . . . . . . . . . . . . . . . 838db2_local_ps - Estado de procesos de DB2 paraLinux/UNIX . . . . . . . . . . . . . 842db2acsutil - Gestionar objetos de copia deseguridad selectiva de DB2 . . . . . . . . . 844db2addicons - Crear entradas del men principalpara las herramientas de DB2 . . . . . . . . 848db2admin - Servidor de administracin de DB2 849db2adutl - Gestin de objetos DB2 en TSM . . . 851db2advis - Asesor de diseo de DB2. . . . . . 861db2audit - Herramienta de administrador delrecurso de auditora . . . . . . . . . . . 868db2batch - Herramienta de evaluacin . . . . . 878

db2bfd - Herramienta de descripcin de archivo devinculacin . . . . . . . . . . . . . . 888db2caem - Herramienta de captura de datos desupervisor de sucesos de actividad . . . . . . 889db2cap - Herramienta de vinculacin de paquetesestticos de CLI/ODBC . . . . . . . . . . 893db2cat - Anlisis del catlogo del sistema . . . . 895db2cfexp - Herramienta de exportacin deconfiguracin de conectividad . . . . . . . . 898db2cfimp - Herramienta de importacin deconfiguracin de conectividad . . . . . . . . 900db2chglibpath - Modificar la va de acceso debsqueda de biblioteca en tiempo de ejecucinincorporada . . . . . . . . . . . . . . 901db2chgpath - Cambiar va de acceso de tiempo deejecucin incorporada . . . . . . . . . . 904db2ckbkp - Comprobar copia de seguridad . . . 906db2cklog - Comprobar la validez de los archivos deanotaciones cronolgicas. . . . . . . . . . 911db2ckrst - Comprobar secuencia de imgenes derestauracin incremental. . . . . . . . . . 914db2ckupgrade - Comprobar base de datos paraactualizacin . . . . . . . . . . . . . 916Mandato db2cli - interactiva de DB2 CLI . . . . 919db2cmd - Abrir ventana de mandatos de DB2 . . 938db2convert: conversin de las tablas organizadopor filas en tablas organizado por columnas . . . 939db2cptsa - Instalar o actualizar scripts HA de DB2 943db2dart - Herramienta de informes y anlisis debase de datos . . . . . . . . . . . . . 945db2daslevel - Mostrar nivel de DAS . . . . . . 954db2dclgn - Generador de declaraciones . . . . . 955db2diag - Herramienta de anlisis de anotacionescronolgicas db2diag . . . . . . . . . . . 958db2drdat - Rastreo de DRDA . . . . . . . . 976db2drvmp - Correlacin de unidades de base dedatos DB2 . . . . . . . . . . . . . . 978db2empfa - Habilitar asignacin de archivos demltiples pginas . . . . . . . . . . . . 980db2envar.bat - Establecer entorno de la ventana demandatos actual . . . . . . . . . . . . 981db2evmon - Herramienta de productividad delsupervisor de sucesos . . . . . . . . . . 982db2evtbl - Generar definiciones de tabla de destinodel supervisor de sucesos . . . . . . . . . 984db2exfmt - Formato de la tabla de Explain . . . 986db2exmig - Migrar tablas de Explain . . . . . 991db2expln - Explicacin de SQL y XQuery . . . . 992db2extsec - Establecer permisos para objetos DB2 1002db2flsn - Buscar nmero de secuencia deanotaciones cronolgicas . . . . . . . . . 1004db2fm - Supervisor de anomalas de DB2 . . . 1010db2fmcu - Controlador de supervisor deanomalas de DB2 . . . . . . . . . . . 1012db2fodc - Recopilacin de datos de primeraaparicin de DB2 . . . . . . . . . . . . 1014db2fopt - Especificar parmetros del optimizadorde consultas . . . . . . . . . . . . . 1027db2fs - Primeros pasos . . . . . . . . . . 1029db2gcf - Controlar instancia de DB2 . . . . . 1030db2gov - DB2 Governor . . . . . . . . . 1033

Contenido v

db2govlg - Consulta de anotacin cronolgica deDB2 Governor. . . . . . . . . . . . . 1036db2gpmap - Obtener correlacin de distribucin 1037db2iauto - Iniciar instancia automticamente . . 1039Mandato db2iclus - Servidor de clsteres deMicrosoft . . . . . . . . . . . . . . 1040db2icrt - Crear instancia . . . . . . . . . 1043db2idrop - Eliminar instancia. . . . . . . . 1053db2ilist - Listar instancias . . . . . . . . . 1056db2inidb - Inicializar una base de datos duplicada 1057db2inspf - Formatear resultados de inspeccin 1060db2iprune - Reducir el tamao de la imagen deinstalacin . . . . . . . . . . . . . . 1061db2isetup - Iniciar interfaz de creacin deinstancias . . . . . . . . . . . . . . 1063db2iupdt - Actualizar instancias . . . . . . . 1065db2iupgrade - Actualizar instancia . . . . . . 1075Mandato db2jdbcbind - Vinculador de paquetesde JDBC de DB2 . . . . . . . . . . . . 1079db2ldcfg - Configurar entorno de LDAP . . . . 1081Mandato db2level - Mostrar nivel de servicio deDB2 . . . . . . . . . . . . . . . . 1082db2licm - Herramienta de gestin de licencias 1083db2listvolumes - Visualizar los GUID para todoslos volmenes de disco. . . . . . . . . . 1086db2logsForRfwd - Listar anotaciones cronolgicasnecesarias para recuperacin en avance . . . . 1087db2look - Herramienta de extraccin de DDL y deestadsticas de DB2 . . . . . . . . . . . 1088db2ls - Listar productos y caractersticas de DB2 1101db2move - Herramienta de movimiento de basede datos . . . . . . . . . . . . . . . 1104Mandato db2mqlsn - MQListener . . . . . . 1114db2mscs - Configurar programa de utilidad deconmutacin por error de Windows . . . . . 1118db2mtrk - Rastreador de memoria . . . . . . 1122db2nchg - Cambiar configuracin de servidor departiciones de base de datos . . . . . . . . 1127db2ncrt - Aadir servidor de particiones de basede datos a una instancia . . . . . . . . . 1129db2ndrop - Descartar servidor de particiones debase de datos de una instancia . . . . . . . 1131db2nrcfg - Herramienta de configuracin deinstalacin no root . . . . . . . . . . . 1133db2nrupdt - Actualizacin de instancia deinstalacin no root . . . . . . . . . . . 1134db2nrupgrade - Actualizar una instancia no root 1135db2osconf - Programa de utilidad para los valoresde parmetro de kernel. . . . . . . . . . 1137db2pd - Supervisar y resolver problemas de basede datos DB2 . . . . . . . . . . . . . 1140db2pdcfg - Configurar la base de datos DB2 decara al comportamiento de la determinacin deproblemas . . . . . . . . . . . . . . 1246db2perfc - Restablecer valores de rendimiento debase de datos . . . . . . . . . . . . . 1253db2perfi - Programa de utilidad de registro decontadores de rendimiento . . . . . . . . 1255db2perfr - Herramienta de registro de supervisorde rendimiento . . . . . . . . . . . . 1256

db2prereqcheck - Comprobar requisitos previosde la instalacin . . . . . . . . . . . . 1257db2rbind - Volver a vincular todos los paquetes 1259db2relocatedb - Reubicar base de datos . . . . 1261db2rfe - Habilitar caractersticas root parainstalaciones no root . . . . . . . . . . 1268db2rfpen - Restablecer estado pendiente deavance . . . . . . . . . . . . . . . 1270db2rmicons - Eliminar las herramientas de DB2del men principal . . . . . . . . . . . 1271db2rspgn - Generador de archivos de respuestas 1272db2sampl - Crear base de datos de ejemplo . . . 1273db2schex - Ampliacin de esquema de ActiveDirectory . . . . . . . . . . . . . . 1276db2set - Registro de perfiles de DB2 . . . . . 1278Mandato db2setup - Instalar productos de base dedatos DB2 . . . . . . . . . . . . . . 1283db2snapcore - DB2 snapcore para Linux y Solaris 1285db2start - Iniciar DB2 . . . . . . . . . . 1287db2stat - Estado de procesos de DB2 paraWindows . . . . . . . . . . . . . . 1288db2stop - Detener DB2 . . . . . . . . . . 1289db2support - Herramienta de anlisis deproblemas y recoleccin del entorno . . . . . 1290db2swtch - Conmutar copia de DB2 por omisin ycopia de interfaz de cliente de base de datos . . 1311db2sync - Iniciar el sincronizador de DB2 . . . 1313Mandato db2systray - Iniciar la bandeja delsistema DB2 . . . . . . . . . . . . . 1314db2tapemgr - Gestionar archivos de anotacionescronolgicas en cinta . . . . . . . . . . 1316db2tbst - Obtener estado de espacio de tablas 1320db2tdbmgr - Migrar base de datos de catlogo deherramientas . . . . . . . . . . . . . 1321db2top - Herramienta de supervisin de DB2 1322db2trc - Rastrear . . . . . . . . . . . . 1327db2trcoff - Opciones de rastrero desactivado paradb2trc . . . . . . . . . . . . . . . 1345db2trcon - Opciones de rastreo activado paradb2trc . . . . . . . . . . . . . . . 1346db2unins - Desinstalar productos, caractersticas oidiomas de base de datos DB2 . . . . . . . 1348db2untag - Liberar identificador de contenedor 1350db2updserv - Mostrar actualizaciones delproducto . . . . . . . . . . . . . . 1352db2val - Herramienta de validacin de copia deDB2 . . . . . . . . . . . . . . . . 1353db2xdbmig - Migrar objetos XSR . . . . . . 1355db2xprt - Formatear archivo de deteccin deexcepcin . . . . . . . . . . . . . . 1356Mandato disable_MQFunctions - Inhabilitarfunciones de WebSphere MQ . . . . . . . . 1357doce_deinstall - Desinstalar Centro deinformacin de DB2 . . . . . . . . . . . 1358doce_install - Instalar el Centro de informacin deDB2 . . . . . . . . . . . . . . . . 1360Mandato enable_MQFunctions - Habilitarfunciones de WebSphere MQ . . . . . . . . 1362installDSDriver - Extraer componentes de IBMData Server Driver . . . . . . . . . . . 1364

vi Consulta de mandatos

installFixPack - Actualizar productos de base dedatos DB2 instalados . . . . . . . . . . 1366setup - Instalar productos de base de datos DB2 1373

Captulo 8. Mandatos de DB2 TextSearch . . . . . . . . . . . . . . 1375db2ts ALTER INDEX . . . . . . . . . . 1376db2ts CLEANUP FOR TEXT . . . . . . . . 1382db2ts CLEAR COMMAND LOCKS. . . . . . 1383db2ts CLEAR EVENTS FOR TEXT . . . . . . 1385db2ts CREATE INDEX . . . . . . . . . . 1387db2ts DISABLE DATABASE FOR TEXT . . . . 1397db2ts DROP INDEX . . . . . . . . . . . 1399db2ts ENABLE DATABASE FOR TEXT . . . . 1401db2ts HELP . . . . . . . . . . . . . 1403db2ts START FOR TEXT . . . . . . . . . 1405db2ts STOP FOR TEXT . . . . . . . . . . 1407db2ts UPDATE INDEX . . . . . . . . . . 1409

Apndice A. Convenios dedenominacin . . . . . . . . . . 1415Convenios de denominacin . . . . . . . . 1416

Apndice B. Modificadores ydelimitadores de tipo de archivo . . 1419Modificadores de tipo de archivo para losprogramas de utilidad de exportacin,importacin y carga . . . . . . . . . . . 1420Consideraciones sobre los delimitadores paramover datos . . . . . . . . . . . . . 1421

Apndice C. Visin general de lainformacin tcnica de DB2 . . . . 1423Biblioteca tcnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 1424Visualizacin de la ayuda para estados de SQLdesde el procesador de lnea de mandatos . . . 1426Acceso a diferentes versiones del Centro deinformacin de DB2 . . . . . . . . . . . 1426Trminos y condiciones . . . . . . . . . 1427

Apndice D. Avisos . . . . . . . . 1429

ndice . . . . . . . . . . . . . . 1433

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 esta 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 En el captulo 1, Procesador de la lnea de mandatos (CLP), se explicacmo invocar y utilizar el procesador de lnea de mandatos y sedescriben las opciones del CLP.

v En el captulo 2, Utilizacin de sentencias de SQL y XQuery de lnea demandatos, se proporciona informacin sobre cmo utilizar sentencias deSQL desde la lnea de mandatos.

Utilizacin CLPPLus (Command Line Processor Plus)

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, 2013 ix

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

Apndices

v En el apndice A, Convenios de denominacin, se describen losconvenios utilizados para denominar los objetos como, por ejemplo, lasbases de datos y las tablas.

v En el apndice B, Modificadores y delimitadores de tipo de archivo, sedescriben 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 estnpredefinidos por el sistema.Los mandatos escritos en maysculas sonmandatos del CLP, mientras que los mandatos escritos en minsculas sonmandatos del sistema.

Cursiva Indica uno de los elementos 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 elementos siguientes:

v Archivos y directoriosv Informacin que el usuario debe escribir en una solicitud de mandatos oen una ventana

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

v Ejemplos de mensajes de textov Ejemplos de cdigo de programacin

Cmo esta estructurado este manual

x Consulta de mandatos

Cmo leer los diagramas de sintaxisEn este tema se describe la estructura de los diagramas de la sintaxis de SQL.

Lea los diagramas de sintaxis de izquierda a derecha y de arriba a abajo, siguiendola va de acceso de la lnea.

El smbolo de punta de flecha doble a la derecha y lnea indica el inicio de undiagrama de sintaxis.

El smbolo de lnea y punta de flecha simple a la derecha indica que la sintaxisse contina en la siguiente lnea.

El smbolo de punta de flecha y lnea indica que la sintaxis contina de la lneaanterior.

El smbolo de lnea, punta de flecha a la derecha y punta de flecha a la izquierda indica el final de un diagrama de sintaxis.

Los fragmentos de sintaxis inician con el smbolo de barra vertical y lnea| yterminan con el smbolo de lnea y barra vertical |.

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.

Copyright IBM Corp. 1993, 2013 xi

elemento_necesarioopcin_opcional1opcin_opcional2

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 especificarlos 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

Cmo leer los diagramas de sintaxis

xii Consulta de mandatos

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

elemento_necesario elemento1 ? elemento2 ? elemento3 ? elemento4

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, 2013 1

Funciones del procesador de lnea de mandatosEn esta seccin se proporciona informacin acerca de las funciones del procesadorde lnea de mandatos.

El procesador de lnea de mandatos opera del modo siguiente:v El mandato de CLP (en cualquiera de los casos) se escribe en el indicador 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. Conctesecon 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 en cualquier

Funciones del procesador de lnea de mandatos

2 Consulta de mandatos

serie que tenga una longitud mxima de 100 caracteres y puede contener lossmbolos %i, %ia, %d, %da y %n. Estos smbolos se sustituirn por valoresespecficos en tiempo de ejecucin.

Tabla 1. Smbolos DB2_CLPPROMPT y valores en tiempo de ejecucinSmbolo DB2_CLPPROMPT Valor en tiempo de 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 no estestablecida, 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 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 nmero de mandatos que se almacenarn 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 unasesin de modalidad interactiva CLP.

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

EjemplosSi DB2_CLPPROMPT se define como (%ia@%i, %da@%d), el indicador de entrada tendrlos 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 establecida en DB2.(@DB2, @)

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


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

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)

v Conexin de base de datos a la base de datos "sample" con el ID de autorizacin"horton7". DB2INSTANCE establecida en DB2. DB2DBDFT establecida en SAMPLE.(@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 mytable (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 componentefrontal. El proceso de fondo lo inicia la primera invocacin de db2 y puedeterminarse explcitamente con el mandato TERMINATE. Todos los procesos decomponente frontal con el mismo padre estn atendidos por un soloproceso de fondo y, por consiguiente, comparten una sola conexin a labase de datos.

Por ejemplo, las llamadas db2 siguientes desde el mismo indicador demandatos de sistema operativo producen procesos de componente frontalindependientes que comparten un nico proceso de fondo, que mantieneuna conexin a la base de datos durante:v db2 connect to sample,v db2 select * from org,v . test01 (donde test01 es un script de shell que contiene mandatosDB2 y

v db2 -tf myfile.clpLas invocaciones siguientes desde el mismo indicador de sistema operativoproducen conexiones a la base de datos independientes porque cada unatiene un proceso padre diferenciado y, por consiguiente, un proceso defondo diferenciado:v test01v . test01 &v test01 &v sh test01



Comunicacin entre los procesos de componente frontal y de fondo

El proceso de componente frontal y los procesos de fondo se comunicanmediante tres colas de mensajes: una cola de peticiones, una cola deentrada y una cola de salida.

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 procesode componente frontal comprueba si el proceso de fondo ya estactivo. Si est activo, el proceso de componente frontal restablece laconexin con el mismo. Si no est activo, el proceso decomponente frontal lo activa. Entonces el proceso de componentefrontal queda desocupado durante el perodo de tiempoespecificado por la variable DB2BQTIME y realiza la comprobacinotra vez. El proceso de componente frontal contina realizando lacomprobacin el nmero de veces especificado por la variableDB2BQTRY, despus de lo cual, si el proceso de fondo an no estactivo, 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 duranteperodos punta para optimizar el tiempo de consulta.

DB2RQTIMEEl proceso de fondo, una vez iniciado, espera en la cola depeticiones una peticin del componente frontal. Tambin espera enla cola de peticiones durante el tiempo que transcurre entre laspeticiones iniciadas desde el indicador de mandatos.

La variable DB2RQTIME especifica el tiempo que espera el proceso defondo a una peticin del proceso de componente frontal. Al finalde este tiempo, si no hay ninguna peticin en la cola de peticiones,el proceso de fondo comprueba si an existe el padre del procesode componente frontal y termina, si ste no existe. De lo contrario,contina esperando en la cola de peticiones.

DB2IQTIMECuando el proceso de fondo recibe una peticin del proceso decomponente frontal, enva un acuse de recibo al proceso decomponente frontal indicando que est preparado para recibirentrada a travs de la cola de entrada. Entonces el proceso defondo espera en su cola de entrada. Tambin espera en la cola de



entrada mientras se est ejecutando un archivo de proceso porlotes (especificado con la opcin -f) y mientras el usuario est enmodalidad interactiva.

La variable DB2IQTIME especifica el tiempo que el proceso de fondoespera en la cola de entrada a que el proceso de componentefrontal pase los mandatos. Cuando este tiempo ha transcurrido, elproceso de fondo comprueba si el proceso de componente frontalest activo y vuelve a esperar en la cola de peticiones si el procesode componente frontal ya no existe. De lo contrario, el proceso defondo contina esperando entrada del proceso de componentefrontal.

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

Las variables de entorno del programa de fondo heredan los valoresestablecidos por el proceso de componente frontal en el momento en quese inicia el proceso de fondo. Sin embargo, si se cambian las variables deentorno del componente frontal, el proceso de fondo no heredar estoscambios. El proceso de fondo debe terminarse primero y, a continuacin,reiniciarse (emitiendo el mandato db2) para heredar los valoresmodificados.

En el escenario siguiente se proporciona un ejemplo de cundo debeterminarse el proceso de fondo:1. El usuario A se conecta, emite algunos mandatos de CLP y, a

continuacin, se desconecta sin emitir TERMINATE.2. El usuario B se conecta utilizando la misma ventana.3. Cuando el usuario B emite determinados mandatos de CLP, stos fallan

con el mensaje DB21016 (error del sistema).

El proceso de fondo iniciado por el usuario A an est activo cuando elusuario B empieza a utilizar el CLP, porque el padre del proceso decomponente frontal del usuario B (la ventana de sistema operativo desde laque se emiten los mandatos) est an activo. El proceso de fondo intentaatender los nuevos mandatos emitidos por el usuario B; sin embargo, elproceso de componente frontal del usuario B no tiene suficienteautorizacin para utilizar las colas de mensajes del proceso de fondo,porque necesita la autorizacin del usuario A, que ha creado dicho procesode fondo. Una sesin CLP debe terminar con un mandato TERMINATE antesque un usuario inicie una nueva sesin CLP utilizando la misma ventanade sistema operativo. Esto crea un proceso de fondo nuevo para cadausuario nuevo, evitando problemas de autorizacin y estableciendo losvalores correctos de las variables de entorno (por ejemplo DB2INSTANCE) enel 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 para DB2 deben especificarse con las maysculas yminsculas exactas necesarias. Por ejemplo, la serie-comentario de la clusula WITHdel mandato CHANGE DATABASE COMMENT es un parmetro sensible a las maysculasy minsculas.

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 podra volverse a escribir utilizando un carcter de escape (\),como \*, \>, 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 del lenguaje 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 REGISTER XMLSCHEMA,donde aparecen con mayor frecuencia nombres problemticos de va de acceso aarchivos.

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 elsegundo mandato no es un mandato del procesador de lnea de mandatos, porejemplo, un mandato de shell de UNIX, el procesador no se colgar ni generar unerror 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. Se recomienda emitir un mandatoTERMINATE antes de cada mandato STOP DATABASE MANAGER (db2stop). Tambinpodra ser necesario emitir TERMINATE despus de haber cambiado los parmetrosde configuracin de base de datos para que estos cambios entren en vigor. Antesde 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 operativos basados en Linux yUNIX y en sistemas operativos Windows (!ls en sistemas operativos UNIX y !diren sistemas operativos Windows, por ejemplo).

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 tema

db2 - Invocacin del procesador de lnea de mandatos


especificado. Si el gestor de bases de datos no puede encontrar lainformacin solicitada, visualiza la pantalla de ayuda general.

? 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 la modalidad deentrada interactiva o un archivo de mandato utilizando UPDATE COMMAND OPTIONS.

El procesador de lnea de mandatos establece opciones en el orden siguiente:1. Configura las opciones por omisin.2. Lee DB2OPTIONS para alterar temporalmente los valores por omisin.3. Lee la lnea de mandatos para alterar temporalmente DB2OPTIONS.4. Acepta entrada de UPDATE COMMAND OPTIONS como una alteracin temporal final

interactiva.

La Tabla 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

-b Esta opcin indica al procesador de lnea de mandatos queha de crear automticamente los paquetes que faltan o queno son vlidos necesarios para ejecutar sentencias de SQL.

ON

-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 que'imprima con estilo' los datos XML con el sangradocorrecto. Esta opcin solamente afectar al conjunto deresultados de sentencias XQuery.

OFF

Opciones del procesador de lnea de mandatos


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

Valor poromisin

-lnombrearchivo

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

OFF

-m Esta opcin indica al procesador de lnea de mandatos queimprima el nmero de filas afectadas de las sentenciasINSERT, DELETE, UPDATE y 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 los mensajes de aviso FETCH y 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

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 vinculacin automtica (-b):A partir de DB2 V10.1 Fixpack 2 y posteriores, esta opcin crea lospaquetes que faltan o que no son vlidos para ejecutar sentencias de SQL.Si se establece en OFF (+b), el procesador de lnea de mandatos no intentarvolver a vincular el paquete cuando el servidor genere un error de paqueteno encontrado o un error de conflicto de indicacin de fecha y hora para elprocesador de lnea de mandatos.

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

Esta nueva opcin de lnea de mandatos tambin puede establecersemediante la variable de entorno DB2OPTIONS.

Utilice este escenario:# descartar explcitamente db2clpcs.bnd de una base de datosdb2 drop package NULLID.SQLC2J24...# la desactivacin de la vinculacin automtica (+b) dacomo resultado SQL0805N, pues db2clpcs.bnd se descarta ahoradb2 +b "create table a (c1 int)"

# vincular ahora explcitamente el archivo necesariodb2 bind db2clpcs.bnd

# ahora el mismo SQL se ejecutar correctamente,pues la vinculacin se realiza explcitamentedb2 +b "create table a (c1 int)"

# volver a descartar explcitamente db2clpcs.bndde una base de datosdb2 drop package NULLID.SQLC2J24...# la conservacin de la vinculacin por omisin (-b) da comoresultado la vinculacin automtica de los paquetes que faltan y la ejecucin de SQL ahora se realiza correctamente

db2 -b "create table a (c1 int)"-O-db2 "create table a (c1 int)"

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 confirman dicho mandato o dicha sentencia ytodos los mandatos y las sentencias satisfactorios que se han emitido antesque stos con la confirmacin automtica desactivada OFF (+c o -c-). Sinembargo, si el mandato o la sentencia falla, se retrotraen dicho mandato odicha sentencia y todos los mandatos y todas las sentencias que se hanemitido antes que stos con la confirmacin automtica desactivada OFF. Siest establecida en OFF (+c o -c-), se deben emitir sentencias COMMIT o



ROLLBACK de forma explcita o se producir una de estas accionescuando se emita el siguiente mandato con confirmacin automticahabilitada ON (-c).


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 ninguna 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 mandato-db2`

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

Cuando se ejecuta un archivo script CLP mediante el mandato db2 -tvfnombrearchivo, se establece el registro especial de CLIENT APPLNAME enCLP nombrearchivo. El siguiente mandato que ejecute, restablece losregistros especiales CLIENT APPLNAME y CLIENT ACCTNG en el valorque tena antes de emitir el mandato db2 -tvf nombrearchivo. Si el mandatosiguiente que se ejecuta es db2 terminate o el ltimo mandato denombrearchivo es TERMINATE, no se restablecern los registros especiales. Estaaccin resulta til para supervisar qu trabajo por lotes se est ejecutandoy para diferenciar la carga de trabajo CLP.

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 o TERMINATEo 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 loscomentarios, 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.

Tenga en cuenta que el carcter de terminacin por omisin es uno de loscaracteres de lnea nueva a menos que se especifique de otro modo con laopcin -t o el fin de archivo.

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 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 de las sentencias INSERT, DELETE,UPDATE o MERGE.

Si se establece en ON (-m), se visualizar el nmero de filas afectadas de lassentencias INSERT, DELETE, UPDATE o 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 accesode 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 puede establecerla opcin +r (o -r-) desde la lnea de mandatos para impedir que los datosde salida de una invocacin de mandato determinada se graben en elarchivo.

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 -s



hace 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

odb2 -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 da lugar a que el procesador de lnea de mandatos emita unmandato echo (para la salida estndar) para el texto del mandatoespecificado por el usuario antes de visualizar la salida, as como losmensajes de ese mandato. ECHO est exento de esta opcin.

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

La opcin -v no tiene ningn efecto si se especifica +o (o bien -o-).

La opcin de salida verbosa no afecta a ninguna opcin del procesador 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(sentencia FETCH o SELECT). Los avisos pueden aparecer durante variasfases de la ejecucin de la consulta, lo que puede dar como resultado quelos mensajes se visualicen antes, durante o tras la devolucin de los datos.Para asegurar que los datos devueltos no contienen texto de mensaje deaviso, 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 puede establecerla opcin +z (o -z-) desde la lnea de mandatos para impedir que los datosde salida de una invocacin de mandato determinada se graben en elarchivo.

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 mandatosEn esta seccin se proporciona informacin acerca de los cdigos de retorno delprocesador de lnea de mandatos.

Cuando 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 cmodo de retorno puede ser uno de los valores 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), la

Cdigos de retorno del procesador de lnea de mandatos


ejecucin de mandatos se detiene si se ha establecido la opcin -s (Detenerejecucin en error de mandato); de lo contrario, la ejecucin contina.

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.

Procedimiento

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, mientrasque ? catalog database visualiza ayuda solamente para el mandato CATALOGDATABASE.

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.

Procedimiento

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.

Cdigos de retorno del 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 sentencias pueden ejecutarse directamente desde un indicador de mandatosde sistema operativo y se pueden utilizar para definir y manipular informacinalmacenada en una tabla, un ndice o una vista de base de datos del mismo modoque si se escribieran los mandatos en un programa de aplicacin. Se puede aadir,suprimir o actualizar informacin y se pueden generar informes a partir delcontenido de las 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 dellenguaje 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. En la seccinsiguiente se proporciona la sintaxis CLP de estas sentencias:

CALL

CALL procedure-name

( ),

expresin?null

CLOSE

Copyright IBM Corp. 1993, 2013 23

CLOSE nombre-cursor

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 comp

Documents

DB2 CommandRef v.10.5